diff options
Diffstat (limited to 'static/freebsd/man9/pmap_kextract.9 4.html')
| -rw-r--r-- | static/freebsd/man9/pmap_kextract.9 4.html | 83 |
1 files changed, 0 insertions, 83 deletions
diff --git a/static/freebsd/man9/pmap_kextract.9 4.html b/static/freebsd/man9/pmap_kextract.9 4.html deleted file mode 100644 index 7a829224..00000000 --- a/static/freebsd/man9/pmap_kextract.9 4.html +++ /dev/null @@ -1,83 +0,0 @@ -<table class="head"> - <tr> - <td class="head-ltitle">PMAP_KEXTRACT(9)</td> - <td class="head-vol">Kernel Developer's Manual</td> - <td class="head-rtitle">PMAP_KEXTRACT(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">pmap_kextract</code>, - <code class="Nm">vtophys</code> — <span class="Nd">extract a physical - address from the kernel page table</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/pmap.h</a>></code></p> -<p class="Pp"><var class="Ft">vm_paddr_t</var> - <br/> - <code class="Fn">pmap_kextract</code>(<var class="Fa">vm_offset_t - va</var>);</p> -<p class="Pp"><var class="Ft">vm_paddr_t</var> - <br/> - <code class="Fn">vtophys</code>(<var class="Fa">vm_offset_t va</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="#pmap_kextract"><code class="Fn" id="pmap_kextract">pmap_kextract</code></a>() - function retrieves the underlying physical memory address corresponding to - the given kernel virtual address <var class="Fa">va</var>. The caller is - responsible for ensuring that <var class="Fa">va</var> belongs to a valid - mapping in the kernel address space. The returned physical address is only - meaningful as long as the mapping remains stable, so the caller must also - have some knowledge or guarantee of the mapping's lifetime. For example, it - is invalid to call <code class="Fn">pmap_kextract</code>() with the address - of a malloc'd object while there is a possibility for that object to be - freed concurrently.</p> -<p class="Pp" id="pmap_kextract~2">Unlike <a class="Xr">pmap_extract(9)</a>, - <a class="permalink" href="#pmap_kextract~2"><code class="Fn">pmap_kextract</code></a>() - is safe to be called from any context; it has no internal locking or - sleep.</p> -<p class="Pp" id="vtophys"><a class="permalink" href="#vtophys"><code class="Fn">vtophys</code></a>() - is an alias for <code class="Fn">pmap_kextract</code>() and behaves - identically.</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN - VALUES</a></h1> -<p class="Pp">The <code class="Fn">pmap_kextract</code>() function returns the - physical address of memory mapped at the kernel virtual address - <var class="Fa">va</var>.</p> -<p class="Pp"><code class="Fn">pmap_kextract</code>() generally does not fail. - However, if supplied with an illegitimate value for - <var class="Fa">va</var>, the function may return zero, an invalid non-zero - value, or call <a class="Xr">panic(9)</a>.</p> -</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">pmap(9)</a>, <a class="Xr">pmap_extract(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">Mina - Galić</span> - <<a class="Mt" href="mailto:FreeBSD@igalic.co">FreeBSD@igalic.co</a>>, - based on the <a class="Xr">pmap_extract(9)</a> page 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">October 16, 2023</td> - <td class="foot-os">FreeBSD 15.0</td> - </tr> -</table> |