NFSSVC(2) BSD System Calls Manual NFSSVC(2)

NAME
     nnffssssvvcc - NFS services

SYNOPSIS
     ##iinncclluuddee <>
     ##iinncclluuddee <>

     int
     nnffssssvvcc(int flags, void *argstructp);

DESCRIPTION
     The nnffssssvvcc() function is used by the NFS server daemon to pass informa-
     tion into and out of the kernel and also to enter the kernel as a server
     daemon.  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.

     nnffssssvvcc() is called with the flag NFSSVCNFSD and a NULL argstructp to
     enter the kernel as an nfsd(8) daemon.  The NFSSVCNFSD action normally
     does not return until the NFS server is stopped.

     The nfsd(8) server daemon calls nnffssssvvcc() with the flag NFSSVCADDSOCK and
     a pointer to a

     struct nfsdargs {
             int     sock;           /* Socket to serve */
             caddrt name;           /* Client address for connection based sockets */
             int     namelen;        /* Length of name */
     };

     to pass a server side NFS socket into the kernel for servicing by the
     nfsd(8) daemons.

     The nfsd(8) server daemon calls nnffssssvvcc() with the flag NFSSVCEXPORT and
     a pointer to a

     struct nfsexportargs {
             uint32t                nxafsid;       /* export FS ID */
             uint32t                nxaexpid;      /* export ID */
             char                    *nxafspath;    /* export FS path */
             char                    *nxaexppath;   /* export sub-path */
             uint32t                nxaflags;      /* export arg flags */
             uint32t                nxanetcount;   /* #entries in exnets array */
             struct nfsexportnetargs *nxanets;   /* array of net args */
     };

     to pass exported file system information into the kernel.

RETURN VALUES
     Upon successful completion, a value of 0 is returned.  Otherwise, -1 is
     returned 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.

     [ENOMEM]           A memory allocation failure prevented the action from
                        completing.

     [EEXIST]           An attempt was made to add a UDP socket via the
                        NFSSVCADDSOCK action, but the UDP socket has already
                        been added.

SEE ALSO
     nfsd(8)

HISTORY     The nnffssssvvcc function first appeared in 4.4BSD.

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

BSD                             January 9, 2007                            BSD