mlockall(2) [hpux man page]

mlockall(2)							System Calls Manual						       mlockall(2)

NAME

       mlockall() - lock a process virtual address space in memory

SYNOPSIS

DESCRIPTION

       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 application, 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.
       Processes  owned  by  other users may have this privilege, depending on system configuration.  See privileges(5) for more information about
       privileged 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 ALSO

       setprivgrp(1M), getprivgrp(2), mlock(2), munlock(2), munlockall(2), plock(2), privileges(5).

STANDARDS CONFORMANCE

																       mlockall(2)

munlock(2)							System Calls Manual							munlock(2)

NAME

       munlock() - unlock a segment of the process virtual address space

SYNOPSIS

DESCRIPTION

       The  system  call  allows the calling process to unlock a segment of the process virtual address space that may have been previously locked
       with or Upon successful completion of the pages within the specified segment are subject to routine paging and/or swapping.

       addr must be a valid address in the process virtual address space.  addr+len must also be a valid address in the  process  virtual  address
       space.

       Pages  are unlocked at page boundaries that encompass the range from addr to addr+len.  If any address within the range is not a valid part
       of the process virtual address space, an error is returned and no unlocks are performed.  However, no error is  reported  for  valid  pages
       within the range that are not already locked, since their state at the completion of the call is as desired.

       Regardless  of how many times a process locks a page, a single or will unlock it.  An of a page within a range specified in an call results
       in only the range specified in the being unlocked.

       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.

       The effective user ID of the calling process must be that of a user with the privilege.

       Although  and  the family of functions may be used together in an application, 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.
       Processes  owned  by  other users may have this privilege, depending on system configuration.  See privileges(5) for more information about
       privileged 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:

	      One or more addresses in the specified range is not valid within
			     the process address space.

	      The	     parameter was zero.

	      The effective user ID of the calling process
			     is not that of a user with the privilege.

EXAMPLES

       The following call to unlocks the first 10 pages of the calling process address space:

SEE ALSO

       setprivgrp(1M), getprivgrp(2), mlock(2), mlockall(2), munlockall(2), plock(2), privileges(5).

STANDARDS CONFORMANCE

																	munlock(2)