d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document that mlock() and munlock() can return EPERM if the

Browse Source 
caller is not the super-user.  Also document that we do not
currently support the per-process RLIMIT_MEMLOCK limit.

PR:		doc/11607
This commit is contained in:
mpp 1999-06-27 00:28:55 +00:00
parent 63d6f378d1
commit 5eb8f821ef
1 changed files with 9 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
lib/libc/sys/mlock.2
View File

@ -30,7 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)mlock.2 8.2 (Berkeley) 12/11/93
.\" $Id$
.\" $Id: mlock.2,v 1.4 1998/01/20 03:59:07 alex Exp $
.\"
.Dd June 2, 1993
.Dt MLOCK 2
@ -101,6 +101,8 @@ a system-wide ``wired pages'' limit and
the per-process
.Li RLIMIT_MEMLOCK
resource limit.
.Pp
These calls are only available to the super-user.
.Sh RETURN VALUES
A return value of 0 indicates that the call
succeeded and all pages in the range have either been locked or unlocked.
@ -113,6 +115,8 @@ is set to indicate the error.
.Fn Mlock
will fail if:
.Bl -tag -width Er
.It Bq Er EPERM
The caller is not the super-user.
.It Bq Er EINVAL
The address given is not page aligned or the length is negative.
.It Bq Er EAGAIN
@ -125,6 +129,8 @@ There was an error faulting/mapping a page.
.Fn Munlock
will fail if:
.Bl -tag -width Er
.It Bq Er EPERM
The caller is not the super-user.
.It Bq Er EINVAL
The address given is not page aligned or the length is negative.
.It Bq Er ENOMEM
@ -156,6 +162,8 @@ physical pages.
Hence a process with two distinct locked mappings of the same physical page
counts as 2 pages against the per-process limit and as only a single page
in the system limit.
The per-process resource limit is not currently supported.
.Sh HISTORY
The
.Fn mlock