D42458.id.diff
No OneTemporary
Actions

Size

1 KB

Referenced Files

None

Subscribers

None

D42458.id.diff
View Options

	diff --git a/share/man/man9/pmap_kextract.9 b/share/man/man9/pmap_kextract.9
	--- a/share/man/man9/pmap_kextract.9
	+++ b/share/man/man9/pmap_kextract.9
	@@ -31,9 +31,21 @@
	function retrieves the underlying physical memory address corresponding to the
	given kernel virtual address
	.Fa va .
	-The value of
	+The caller is responsible for ensuring that
	.Fa va
	-must belong to a valid mapping in the kernel address space.
	+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
	+.Fn pmap_kextract
	+with the address of a malloc'd object while there is a possibility for that
	+object to be freed concurrently.
	+.Pp
	+Unlike
	+.Xr pmap_extract 9 ,
	+.Fn pmap_kextract
	+is safe to be called from any context; it has no internal locking or sleep.
	.Pp
	.Fn vtophys
	is an alias for
	@@ -42,7 +54,7 @@
	.Sh RETURN VALUES
	The
	.Fn pmap_kextract
	-function returns the address of physical memory mapped at the kernel
	+function returns the physical address of memory mapped at the kernel
	virtual address
	.Fa va .
	.Pp