mlock(3C)


mlock -- lock pages in memory

Synopsis

   #include <sys/types.h> 
   #include <sys/mman.h> 
   

int mlock(void *addr, size_t len);

int munlock(void *addr, size_t len);

Description

munlock- unlock pages in memory

The function mlock uses the mappings established for the address range

   [addr, addr + len) 

to identify pages to be locked in memory. The effect of

mlock(addr, len)

is equivalent to

   memcntl(addr, len, MC_LOCK, 0, 0, 0) 

munlock removes locks established with mlock. The effect of

munlock(addr, len)

is equivalent to

   memcntl(addr, len, MC_UNLOCK, 0, 0, 0) 

Locks established with mlock are not inherited by a child process after a fork and are not nested.

Return values

Upon successful completion, the functions mlock and munlock return 0; otherwise, they return -1 and set errno to indicate the error.

References

fork(2), memcntl(2), mlockall(3C), mmap(2), plock(2), sysconf(3C)

Notices

Use of mlock and munlock requires that the user have appropriate privileges.
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.