diff options
Diffstat (limited to 'static/freebsd/man9/vm_map_protect.9 3.html')
| -rw-r--r-- | static/freebsd/man9/vm_map_protect.9 3.html | 105 |
1 files changed, 0 insertions, 105 deletions
diff --git a/static/freebsd/man9/vm_map_protect.9 3.html b/static/freebsd/man9/vm_map_protect.9 3.html deleted file mode 100644 index 843a69ed..00000000 --- a/static/freebsd/man9/vm_map_protect.9 3.html +++ /dev/null @@ -1,105 +0,0 @@ -<table class="head"> - <tr> - <td class="head-ltitle">VM_MAP_PROTECT(9)</td> - <td class="head-vol">Kernel Developer's Manual</td> - <td class="head-rtitle">VM_MAP_PROTECT(9)</td> - </tr> -</table> -<div class="manual-text"> -<section class="Sh"> -<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1> -<p class="Pp"><code class="Nm">vm_map_protect</code> — - <span class="Nd">apply protection bits to a virtual memory region</span></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1> -<p class="Pp"><code class="In">#include - <<a class="In">sys/param.h</a>></code> - <br/> - <code class="In">#include <<a class="In">vm/vm.h</a>></code> - <br/> - <code class="In">#include <<a class="In">vm/vm_map.h</a>></code></p> -<p class="Pp"><var class="Ft">int</var> - <br/> - <code class="Fn">vm_map_protect</code>(<var class="Fa">vm_map_t map</var>, - <var class="Fa">vm_offset_t start</var>, <var class="Fa">vm_offset_t - end</var>, <var class="Fa">vm_prot_t new_prot</var>, - <var class="Fa">vm_prot_t new_maxprot</var>, <var class="Fa">int - flags</var>);</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1> -<p class="Pp">The - <a class="permalink" href="#vm_map_protect"><code class="Fn" id="vm_map_protect">vm_map_protect</code></a>() - function sets the protection bits and maximum protection bits of the address - region bounded by <var class="Fa">start</var> and <var class="Fa">end</var> - within the map <var class="Fa">map</var>.</p> -<p class="Pp">If the <var class="Fa">flags</var> argument has the - <code class="Dv">VM_MAP_PROTECT_SET_PROT</code> bit set, then the effective - protection is set to <var class="Fa">new_prot</var>.</p> -<p class="Pp">If the <var class="Fa">flags</var> argument has the - <code class="Dv">VM_MAP_PROTECT_SET_MAXPROT</code> bit set, then the maximum - protection is set to <var class="Fa">new_maxprot</var>. Protection bits not - included into <var class="Fa">new_maxprot</var> will be cleared from - existing entries.</p> -<p class="Pp">The values specified by <var class="Fa">new_prot</var> and - <var class="Fa">new_maxprot</var> are not allowed to include any protection - bits that are not set in existing <var class="Va">max_protection</var> on - every entry within the range. The operation will fail if this condition is - violated. For instance, this prevents upgrading a shared mapping of a - read-only file from read-only to read-write.</p> -<p class="Pp">The specified range must not contain sub-maps.</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="IMPLEMENTATION_NOTES"><a class="permalink" href="#IMPLEMENTATION_NOTES">IMPLEMENTATION - NOTES</a></h1> -<p class="Pp">The function acquires a lock on the <var class="Fa">map</var> for - the duration, by calling <a class="Xr">vm_map_lock(9)</a>. Also, any - in-progress wiring operation on the map affecting the specified range will - cause <code class="Nm">vm_map_protect</code> to sleep, waiting for - completion.</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN - VALUES</a></h1> -<dl class="Bl-tag"> - <dt id="KERN_SUCCESS"><a class="permalink" href="#KERN_SUCCESS"><code class="Dv">KERN_SUCCESS</code></a></dt> - <dd>The specified protection bits were set successfully.</dd> - <dt id="KERN_INVALID_ARGUMENT"><a class="permalink" href="#KERN_INVALID_ARGUMENT"><code class="Dv">KERN_INVALID_ARGUMENT</code></a></dt> - <dd>A sub-map entry was encountered in the range,</dd> - <dt id="KERN_PROTECTION_FAILURE"><a class="permalink" href="#KERN_PROTECTION_FAILURE"><code class="Dv">KERN_PROTECTION_FAILURE</code></a></dt> - <dd>The value of <var class="Fa">new_prot</var> or - <var class="Fa">new_maxprot</var> exceed - <var class="Va">max_protection</var> for an entry within the range.</dd> - <dt id="KERN_PROTECTION_FAILURE~2"><a class="permalink" href="#KERN_PROTECTION_FAILURE~2"><code class="Dv">KERN_PROTECTION_FAILURE</code></a></dt> - <dd>The map does not allow simultaneous setting of write and execute - permissions, but <var class="Fa">new_prot</var> has both - <code class="Dv">VM_PROT_WRITE</code> and - <code class="Dv">VM_PROT_EXECUTE</code> set.</dd> - <dt id="KERN_RESOURCE_SHORTAGE"><a class="permalink" href="#KERN_RESOURCE_SHORTAGE"><code class="Dv">KERN_RESOURCE_SHORTAGE</code></a></dt> - <dd>A copy-on-write mapping is transitioned from read-only to read-write, and - not enough swap space is available to back the copied pages.</dd> - <dt id="KERN_OUT_OF_BOUNDS"><a class="permalink" href="#KERN_OUT_OF_BOUNDS"><code class="Dv">KERN_OUT_OF_BOUNDS</code></a></dt> - <dd>Both new protection and new maximum protection updates were requested, but - the specified <var class="Fa">new_prot</var> is not a subset of - <var class="Fa">new_maxprot</var>.</dd> -</dl> -</section> -<section class="Sh"> -<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE - ALSO</a></h1> -<p class="Pp"><a class="Xr">vm_map(9)</a></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1> -<p class="Pp">This manual page was written by <span class="An">Bruce M - Simpson</span> - <<a class="Mt" href="mailto:bms@spc.org">bms@spc.org</a>>.</p> -</section> -</div> -<table class="foot"> - <tr> - <td class="foot-date">January 23, 2021</td> - <td class="foot-os">FreeBSD 15.0</td> - </tr> -</table> |