mlockall(2)mlockall(2)NAMEmlockall() - lock a process virtual address space in memory
SYNOPSISDESCRIPTION
The system call allows the calling process to lock its entire virtual
address space into memory, making it immune to all routine swapping.
flags may be one or both of the following:
Lock the current process virtual address space.
All addressable pages of the address space are
locked.
Lock any future additions to the process virtual address space.
Note that does not imply
or can be used to unlock all or a portion of the address space locked
with A single call to removes all locks from the process virtual
address space. An call results in only the specified pages being
unlocked.
Regardless of how many times a process locks a page, a single or will
unlock it.
When memory is shared by multiple processes and mlocks are applied to
the same physical page by multiple processes, a page remains locked
until the last lock is removed from that page.
Locks and applied with are not inherited by a child process.
The user must have the privilege.
Although and the family of functions may be used together in an appli‐
cation, each may affect the other in unexpected ways. This practice is
not recommended.
Security Restrictions
Some or all of the actions associated with this system call require the
privilege. Processes owned by the superuser have this privilege. Pro‐
cesses owned by other users may have this privilege, depending on sys‐
tem configuration. See privileges(5) for more information about privi‐
leged access on systems that support fine-grained privileges.
RETURN VALUE
returns the following values:
Successful completion.
Failure.
The requested operation is not performed. is set to
indicate the error.
ERRORS
If fails, is set to one of the following values:
The flags field did not contain either and/or
There is not enough lockable memory in the system
to satisfy the locking request.
The user does not have the
privilege.
EXAMPLES
The following call to locks the entire process virtual address space in
memory and ensures that any future additions to the address space will
also be locked in memory:
SEE ALSOsetprivgrp(1M), getprivgrp(2), mlock(2), munlock(2), munlockall(2),
plock(2), privileges(5).
STANDARDS CONFORMANCEmlockall(2)