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


NAME
       dglockkill - remove locks held by remote lock clients

SYNOPSIS
       #include <sys/fcntl.h>
       #include <sys/nfs.h>

       int   dglockkill (count, clientidlistptr)
       int   count;
       int * clientidlistptr;

   where:
       count               Count of client id's in the list
       clientidlistptr  A list of client id's to free

DESCRIPTION
       Remove all locks and lock requests owned by the client in
       clientlistptr.  count gives the number of entries in the list.

       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 dglockkill 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    Count is less than or equal to zero.

       ENOMEM    There is not enough memory to process the request.

       EFAULT    One of the arguments points outside of the process's
                 readable address space.

       EINTR     The process received a signal while processing the request.

       ENOLCK    The command can not be satisfied because there are no more
                 record locks available.

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


Licensed material--property of copyright holder(s)