GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PMAP_EXTRACT_AND_HOLD (9)

NAME

pmap_extract, pmap_extract_and_hold - map a virtual address to a physical page

CONTENTS

Synopsis
Description
Implementation Notes
Return Values
See Also
Authors

SYNOPSIS


.In sys/param.h
.In vm/vm.h
.In vm/pmap.h vm_paddr_t pmap_extract pmap_t pmap vm_offset_t va vm_paddr_t pmap_extract_and_hold pmap_t pmap vm_offset_t va vm_prot_t prot

DESCRIPTION

The pmap_extract function maps a virtual address to a physical page. In certain situations, callers may use pmap_extract_and_hold instead, to ensure that the returned page is held.

The pmap_extract_and_hold function maps a virtual address to a physical page, and atomically holds the returned page for use by the caller, only if the mapping permits the given page protection.

IMPLEMENTATION NOTES

Currently, the page protection requested by the caller is not verified.

RETURN VALUES

The pmap_extract function will return the physical page address associated with the virtual address va inside the physical map pmap. If the mapping does not exist, or if the pmap parameter is NULL, then NULL will be returned.

The pmap_extract_and_hold function will return the physical page address associated with the virtual address va inside the physical map pmap. If the mapping does not exist, the result is a no-op, and NULL will be returned.

SEE ALSO

mutex(9), pmap(9)

AUTHORS


.An -nosplit The pmap_extract_and_hold function was implemented by
.An Alan L. Cox Aq alc@imimic.com . This manual page was written by
.An Bruce M Simpson Aq bms@spc.org .
Search for    or go to Top of page |  Section 9 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.