remove_rlock(3N)                                           remove_rlock(3N)

NAME
     removerlock - delete remote lock entry

SYNOPSIS
     #include <rpc/types.h>

     #include <nfs/nfs.h>

     #include <nfs/nfssys.h>

     int removerlock(struct remotelock *rlock)

DESCRIPTION
     removerlock deletes the lock(s) specified by the rlock argument.

     For a description of struct remotelock see getrlent(3N).

     If rlock->rlu.ufile.fname is NULL and rlock->rlu.ufile.fh consists
     of other than null bytes, rlock->rlu.ufile.fh is used for locating
     the locked file. Otherwise if rlock->rlu.ufile.fname is not NULL,
     the specified value is used as the pathname of the locked file.

     If both fields are NULL or consist of null bytes, the rlock argument
     refers to any (exported) file.

     rlock->rlclient refers to "any" client host if rlock->rlclient is
     NULL.

     rlock->rlpid refers to any client process if rlock->rlpid is -1.

     Every lock in the given range (rlock->rlstart, rlock->rllen) is
     deleted. If rlock->rllen is 0 this means "until EOF".

     rlock->rltype and rlock->rlstate are not evaluated by the
     removerlock function.

     Remote locks in state BLOCKEDLOCK cannot be deleted by removerlock.

SEE ALSO
     getrlent(3N).















Page 1                       Reliant UNIX 5.44                Printed 11/98