NFSCLNT(2) BSD System Calls Manual NFSCLNT(2)

NAME
     nnffssccllnntt - NFS client services

SYNOPSIS
     ##iinncclluuddee <>
     ##iinncclluuddee <>

     int
     nnffssccllnntt(int flags, void *argstructp);

DESCRIPTION
     The nnffssccllnntt() function is used by the NFS client daemons to pass informa-
     tion into and out of the kernel.  The flags argument consists of several
     bits that show what action is to be taken once in the kernel and the
     argstructp points to any corresponding data that the action may require.

     rpc.lockd(8) calls nnffssccllnntt() with the flag NFSCLNTLOCKDANS and a pointer
     to a

     struct lockdans {
             int             laversion;             /* lockdans version */
             int             laerrno;               /* return status */
             uint64t       laxid;                 /* unique message transaction ID */
             int             laflags;               /* answer flags */
             pidt           lapid;                 /* pid of lock requester/owner */
             offt           lastart;               /* lock starting offset */
             offt           lalen;                 /* lock length */
             int             lafhlen;              /* The file handle length. */
             uint8t        lafh[NFSV3MAXFHSIZE];/* The file handle. */
     };

     to pass the response to an NFS file locking request back into the kernel.

RETURN VALUES
     Upon successful completion, a value of 0 is returned.  Otherwise, -1 is
     returned and the global variable errno is set to specify the error.

EERRRROORRSS
     [EPERM]            The caller is not the super-user.

     [EINVAL]           The action specified by the flags argument was not
                        valid.

     [EFAULT]           argstructp points to an invalid address.

     [EPIPE]            The response doesn't match any currently-outstanding
                        lock request.

SEE ALSO
     rpc.lockd(8)

BUGS
     The nnffssccllnntt system call is designed specifically for the NFS client dae-
     mons and as such is specific to their requirements.  Several fields of
     the argument structures are assumed to be valid, such that nnffssccllnntt must
     be used with extreme care.

BSD                             January 9, 2007                            BSD