dg_lock_reset(2)               DG/UX R4.11MU05              dg_lock_reset(2)


NAME
       dglockreset - reset remote file lock database, start lock reclaim
       grace period

SYNOPSIS
       int     dglockreset (grace)
       timet  grace;

   where:
       grace     The number of seconds in the grace period

DESCRIPTION
       The dglockreset system call removes all (remote) locks set by the
       network lock server.  It pends all lock requests, and denies all
       remote lock requests, for grace seconds in order to allow remote
       clients to reclaim their locks.

       The only process that uses this function is the network lock server,
       rpc.lockd.

ACCESS CONTROL
       The caller must have appropriate privilege.

       For systems supporting the DG/UX Capability Option, appropriate
       privilege is defined as having one or more specific capabilities
       enabled in the effective capability set of the calling process.  See
       capdefaults(5) for the default capability for this system call.

       On systems without the DG/UX Capability Option, appropriate privilege
       means that the process has an effective UID of root.  See the
       appropriateprivilege(5) man page for more information.

RETURN VALUE
       0      The dglockreset operation was successful.

       -1     An error occurred.  errno indicates the error.

DIAGNOSTICS
       Errno may be set to one of the following error codes:

       EPERM     Must have appropriate privilege to use this system call.

       EINVAL    The grace period is invalid.

SEE ALSO
       dglcntl(2), dglockwait(2), fcntl(2), lockf(3C),
       appropriateprivilege(5), fcntl(5).
       capdefaults(5).


Licensed material--property of copyright holder(s)