hpux man page for datalock

datalock(3C)															      datalock(3C)

NAME
       datalock() - lock process into memory after allocating data and stack space

SYNOPSIS
DESCRIPTION
       allocates  at  least  datsiz bytes of data space and stsiz bytes of stack space, then locks the program in memory.  The data space is allo-
       cated by (see malloc(3C)).  After the program is locked, this space is released by (see malloc(3C)), making it  available  for  use.   This
       allows the calling program to use that much space dynamically without receiving the signal.

       The  effective  user  ID  of  the  calling  process  must  be  super-user or be a member of or have an effective group ID of a group having
       PRIV_MLOCK access to use this call (see setprivgrp(2) in getprivgrp(2)).

EXAMPLES
       The following call to allocates 4096 bytes of data space and 2048 bytes of stack space, then locks the process in memory:

RETURN VALUE
       returns -1 if cannot allocate enough memory or if returned an error (see plock(2)).

WARNINGS
       Multiple datalocks cannot be the same as one big one.

       Methods for calculating the required size are not yet well developed.

AUTHOR
       was developed by HP.

SEE ALSO
       getprivgrp(2), plock(2), thread_safety(5).

																      datalock(3C)