root/sys/nfs/nfs.h
/*      $OpenBSD: nfs.h,v 1.54 2024/05/04 10:53:37 jsg Exp $    */
/*      $NetBSD: nfs.h,v 1.10.4.1 1996/05/27 11:23:56 fvdl Exp $        */

/*
 * Copyright (c) 1989, 1993, 1995
 *      The Regents of the University of California.  All rights reserved.
 *
 * This code is derived from software contributed to Berkeley by
 * Rick Macklem at The University of Guelph.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. Neither the name of the University nor the names of its contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 *      @(#)nfs.h       8.4 (Berkeley) 5/1/95
 */

#ifndef _NFS_NFS_H_
#define _NFS_NFS_H_

#define NFS_TICKINTVL   5               /* Desired time for a tick (msec) */
#define NFS_HZ          (hz / nfs_ticks) /* Ticks/sec */
#define NFS_TIMEO       (1 * NFS_HZ)    /* Default timeout = 1 second */
#define NFS_MINTIMEO    (1 * NFS_HZ)    /* Min timeout to use */
#define NFS_MAXTIMEO    (60 * NFS_HZ)   /* Max timeout to backoff to */
#define NFS_TIMEOUTMUL  2               /* Timeout/Delay multiplier */
#define NFS_MAXREXMIT   100             /* Stop counting after this many */
#define NFS_RETRANS     10              /* Num of retrans for soft mounts */
#define NFS_MAXGRPS     16              /* Max. size of groups list */
#define NFS_MINATTRTIMO 5               /* Attribute cache timeout in sec */
#define NFS_MAXATTRTIMO 60
#define NFS_WSIZE       8192            /* Def. write data size <= 8192 */
#define NFS_RSIZE       8192            /* Def. read data size <= 8192 */
#define NFS_READDIRSIZE 8192            /* Def. readdir size */
#define NFS_DEFRAHEAD   1               /* Def. read ahead # blocks */
#define NFS_MAXRAHEAD   4               /* Max. read ahead # blocks */
#define NFS_MAXASYNCDAEMON      20      /* Max. number async_daemons runable */

/*
 * Ideally, NFS_DIRBLKSIZ should be bigger, but I've seen servers with
 * broken NFS/ethernet drivers that won't work with anything bigger (Linux..)
 */
#define NFS_DIRBLKSIZ   1024            /* Must be a multiple of DIRBLKSIZ */
#define NFS_READDIRBLKSIZ       512     /* Size of read dir blocks. XXX */

/*
 * Oddballs
 */
#define NFS_CMPFH(n, f, s) \
        ((n)->n_fhsize == (s) && !bcmp((caddr_t)(n)->n_fhp, (caddr_t)(f), (s)))
#define NFS_ISV3(v)     (VFSTONFS((v)->v_mount)->nm_flag & NFSMNT_NFSV3)
#define NFS_SRVMAXDATA(n) \
                (((n)->nd_flag & ND_NFSV3) ? (((n)->nd_nam2) ? \
                 NFS_MAXDGRAMDATA : NFS_MAXDATA) : NFS_V2MAXDATA)

/*
 * The B_INVAFTERWRITE flag should be set to whatever is required by the
 * buffer cache code to say "Invalidate the block after it is written back".
 */
#define B_INVAFTERWRITE B_INVAL

/*
 * Structures for the nfssvc(2) syscall.
 * Not that anyone besides nfsd(8) should ever use it.
 */
struct nfsd_args {
        int     sock;           /* Socket to serve */
        caddr_t name;           /* Client addr for connection based sockets */
        int     namelen;        /* Length of name */
};

struct nfsd_srvargs {
        struct nfsd     *nsd_nfsd;      /* Pointer to in kernel nfsd struct */
        uid_t           nsd_uid;        /* Effective uid mapped to cred */
        u_int32_t       nsd_haddr;      /* IP address of client */
        struct xucred   nsd_cr;         /* Cred. uid maps to */
        int             nsd_authlen;    /* Length of auth string (ret) */
        u_char          *nsd_authstr;   /* Auth string (ret) */
        int             nsd_verflen;    /* and the verifier */
        u_char          *nsd_verfstr;
        struct timeval  nsd_timestamp;  /* timestamp from verifier */
        u_int32_t       nsd_ttl;        /* credential ttl (sec) */
};

/*
 * Stats structure
 */
struct nfsstats {
        uint64_t        attrcache_hits;
        uint64_t        attrcache_misses;
        uint64_t        lookupcache_hits;
        uint64_t        lookupcache_misses;
        uint64_t        direofcache_hits;
        uint64_t        direofcache_misses;
        uint64_t        biocache_reads;
        uint64_t        read_bios;
        uint64_t        read_physios;
        uint64_t        biocache_writes;
        uint64_t        write_bios;
        uint64_t        write_physios;
        uint64_t        biocache_readlinks;
        uint64_t        readlink_bios;
        uint64_t        biocache_readdirs;
        uint64_t        readdir_bios;
        uint64_t        rpccnt[NFS_NPROCS];
        uint64_t        rpcretries;
        uint64_t        srvrpccnt[NFS_NPROCS];
        uint64_t        srvrpc_errs;
        uint64_t        srv_errs;
        uint64_t        rpcrequests;
        uint64_t        rpctimeouts;
        uint64_t        rpcunexpected;
        uint64_t        rpcinvalid;
        uint64_t        srvcache_inproghits;
        uint64_t        srvcache_idemdonehits;
        uint64_t        srvcache_nonidemdonehits;
        uint64_t        srvcache_misses;
        uint64_t        forcedsync;
        uint64_t        srvnqnfs_leases;
        uint64_t        srvnqnfs_maxleases;
        uint64_t        srvnqnfs_getleases;
        uint64_t        srvvop_writes;
};

/*
 * Flags for nfssvc() system call.
 */
#define NFSSVC_NFSD     0x004
#define NFSSVC_ADDSOCK  0x008

/*
 * fs.nfs sysctl(3) identifiers
 */
#define NFS_NFSSTATS    1       /* struct: struct nfsstats */
#define NFS_NIOTHREADS  2       /* number of i/o threads */
#define NFS_MAXID       3

#define FS_NFS_NAMES { \
                        { 0, 0 }, \
                        { "nfsstats", CTLTYPE_STRUCT }, \
                        { "iothreads", CTLTYPE_INT } \
}

/*
 * The set of signals the interrupt an I/O in progress for NFSMNT_INT mounts.
 * What should be in this set is open to debate, but I believe that since
 * I/O system calls on ufs are never interrupted by signals the set should
 * be minimal. My reasoning is that many current programs that use signals
 * such as SIGALRM will not expect file I/O system calls to be interrupted
 * by them and break.
 */
#ifdef _KERNEL
extern int nfs_niothreads;

struct uio; struct buf; struct vattr; struct nameidata; /* XXX */

#define NFSINT_SIGMASK  (sigmask(SIGINT)|sigmask(SIGTERM)|sigmask(SIGKILL)| \
                         sigmask(SIGHUP)|sigmask(SIGQUIT))

/*
 * Socket errors ignored for connectionless sockets??
 * For now, ignore them all
 */
#define NFSIGNORE_SOERROR(s, e) \
                ((e) != EINTR && (e) != ERESTART && (e) != EWOULDBLOCK && \
                ((s) & PR_CONNREQUIRED) == 0)

/*
 * Nfs outstanding request list element
 */
struct nfsreq {
        TAILQ_ENTRY(nfsreq) r_chain;
        struct mbuf     *r_mreq;
        struct mbuf     *r_mrep;
        struct mbuf     *r_md;
        caddr_t         r_dpos;
        struct nfsmount *r_nmp;
        struct vnode    *r_vp;
        u_int32_t       r_xid;
        int             r_flags;        /* flags on request, see below */
        int             r_rexmit;       /* current retrans count */
        int             r_timer;        /* tick counter on reply */
        int             r_procnum;      /* NFS procedure number */
        int             r_rtt;          /* RTT for rpc */
        struct proc     *r_procp;       /* Proc that did I/O system call */
};

/* Flag values for r_flags */
#define R_TIMING        0x01            /* timing request (in mntp) */
#define R_SENT          0x02            /* request has been sent */
#define R_SOFTTERM      0x04            /* soft mnt, too many retries */
#define R_INTR          0x08            /* intr mnt, signal pending */
#define R_SOCKERR       0x10            /* Fatal error on socket */
#define R_TPRINTFMSG    0x20            /* Did a tprintf msg. */
#define R_MUSTRESEND    0x40            /* Must resend request */

/*
 * On fast networks, the estimator will try to reduce the
 * timeout lower than the latency of the server's disks,
 * which results in too many timeouts, so cap the lower
 * bound.
 */
#define NFS_MINRTO      (NFS_HZ >> 2)

/*
 * Keep the RTO from increasing to unreasonably large values
 * when a server is not responding.
 */
#define NFS_MAXRTO      (20 * NFS_HZ)

enum nfs_rto_timers {
        NFS_DEFAULT_TIMER,
        NFS_GETATTR_TIMER,
        NFS_LOOKUP_TIMER,
        NFS_READ_TIMER,
        NFS_WRITE_TIMER,
};
#define NFS_MAX_TIMER   (NFS_WRITE_TIMER)

#define NFS_INITRTT     (NFS_HZ << 3)

/*
 * Network address hash list element
 */
union nethostaddr {
        u_int32_t had_inetaddr;
        struct mbuf *had_nam;
};

struct nfssvc_sock {
        TAILQ_ENTRY(nfssvc_sock) ns_chain; /* List of all nfssvc_sock's */
        struct file     *ns_fp;         /* fp from the... */
        struct socket   *ns_so;         /* ...socket this struct wraps */
        struct mbuf     *ns_nam;        /* MT_SONAME of client */
        struct mbuf     *ns_raw;        /* head of unpeeked mbufs */
        struct mbuf     *ns_rawend;     /* tail of unpeeked mbufs */
        struct mbuf     *ns_rec;        /* queued RPC records */
        struct mbuf     *ns_recend;     /* last queued RPC record */
        struct mbuf     *ns_frag;       /* end of record fragment */
        int             ns_flag;        /* socket status flags */
        int             ns_solock;      /* lock for connected socket */
        int             ns_cc;          /* actual chars queued */
        int             ns_reclen;      /* length of first queued record */
        u_int32_t       ns_sref;        /* # of refs to this struct */
};

/* Bits for "ns_flag" */
#define SLP_VALID       0x01    /* connection is usable */
#define SLP_DOREC       0x02    /* receive operation required */
#define SLP_NEEDQ       0x04    /* connection has data to queue from socket */
#define SLP_DISCONN     0x08    /* connection is closed */
#define SLP_GETSTREAM   0x10    /* extracting RPC from TCP connection */
#define SLP_LASTFRAG    0x20    /* last fragment received on TCP connection */
#define SLP_ALLFLAGS    0xff    /* convenience */

/*
 * One of these structures is allocated for each nfsd.
 */
struct nfsd {
        TAILQ_ENTRY(nfsd) nfsd_chain;   /* List of all nfsd's */
        int             nfsd_flag;      /* NFSD_ flags */
        struct nfssvc_sock *nfsd_slp;   /* Current socket */
        struct proc     *nfsd_procp;    /* Proc ptr */
        struct nfsrv_descript *nfsd_nd; /* Associated nfsrv_descript */
};

/* Bits for "nfsd_flag" */
#define NFSD_WAITING    0x01
#define NFSD_REQINPROG  0x02

/*
 * This structure is used by the server for describing each request.
 */
struct nfsrv_descript {
        struct mbuf             *nd_mrep;       /* Request mbuf list */
        struct mbuf             *nd_md;         /* Current dissect mbuf */
        struct mbuf             *nd_nam;        /* and socket addr */
        struct mbuf             *nd_nam2;       /* return socket addr */
        caddr_t                 nd_dpos;        /* Current dissect pos */
        unsigned int            nd_procnum;     /* RPC # */
        int                     nd_flag;        /* nd_flag */
        int                     nd_repstat;     /* Reply status */
        u_int32_t               nd_retxid;      /* Reply xid */
        struct ucred            nd_cr;          /* Credentials */
};

/* Bits for "nd_flag" */
#define ND_NFSV3        0x08

extern struct pool nfsreqpl;
extern struct pool nfs_node_pool;
extern TAILQ_HEAD(nfsdhead, nfsd) nfsd_head;
extern int nfsd_head_flag;
#define NFSD_CHECKSLP   0x01

#endif  /* _KERNEL */
#endif /* _NFS_NFS_H */