vm_fault_prefault (9)

Leading comments

Copyright (c) 2003 Bruce M Simpson <bms@spc.org>
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in the
   documenta...

(The comments found at the beginning of the groff file "man9/vm_fault_prefault.9freebsd".)

NAME

vm_fault_prefault - cluster page faults into a process's address space

SYNOPSIS

In sys/param.h In vm/vm.h In vm/pmap.h Ft void Fn vm_fault_prefault pmap_t pmap vm_offset_t addra vm_map_entry_t entry

DESCRIPTION

The Fn vm_fault_prefault function provides a means of clustering pagefaults into a process's address space. It operates upon the physical map Fa pmap . The Fa entry argument specifies the entry to be prefaulted; the Fa addra argument specifies the beginning of the mapping in the process's virtual address space.

It is typically called by Fn vm_fault after the first page fault. It benefits the execve(2) system call by eliminating repetitive calls to Fn vm_fault , which would otherwise be made to bring the process's executable pages into physical memory.

IMPLEMENTATION NOTES

This is a machine-independent function which calls the machine-dependent pmap_is_prefaultable9 helper function to determine if a page may be prefaulted into physical memory.

SEE ALSO

execve(2), pmap_is_prefaultable9

AUTHORS

This manual page was written by An Bruce M Simpson Aq bms@spc.org .