summaryrefslogblamecommitdiff
path: root/nuttx/fs/nfs/nfs.h
blob: a5092e07aef5dac82a3af65e790d45d800a37f62 (plain) (tree)







































































































































































































































































































































































                                                                                 
/*
 * 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             (CLOCKS_PER_SEC / 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_MINIDEMTIMEO   (5 * NFS_HZ)  /* Min timeout for non-idempotent ops */
#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((void *)(n)->n_fhp, (void *)(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)

/*
 * sys/malloc.h needs M_NFSDIROFF, M_NFSRVDESC and M_NFSBIGFH added.
 */

#ifndef M_NFSRVDESC
#  define M_NFSRVDESC     M_TEMP
#endif
#ifndef M_NFSDIROFF
#  define M_NFSDIROFF     M_TEMP
#endif
#ifndef M_NFSBIGFH
#  define M_NFSBIGFH      M_TEMP
#endif

/*
 * 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 */
  void *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 */
  uint32_t nsd_haddr;         /* IP address of client */
  int nsd_authlen;            /* Length of auth string (ret) */
  unsigned char *nsd_authstr; /* Auth string (ret) */
  int nsd_verflen;            /* and the verifier */
  unsigned char *nsd_verfstr;
  struct timeval nsd_timestamp;       /* timestamp from verifier */
  uint32_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_BIOD     0x002
#define NFSSVC_NFSD     0x004
#define NFSSVC_ADDSOCK  0x008
#define NFSSVC_AUTHIN   0x010
#define NFSSVC_GOTAUTH  0x040
#define NFSSVC_AUTHINFAIL 0x080
#define NFSSVC_MNTD     0x100

/*
 * 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
{
  dq_entry_t r_chain;
  void *r_dpos;
  struct nfsmount *r_nmp;
  uint32_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 */
};

/* 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 */

extern TAILQ_HEAD(nfssvc_sockhead, nfssvc_sock) nfssvc_sockhead;
extern int nfssvc_sockhead_flag;

#define SLP_INIT        0x01/* NFS data undergoing initialization */
#define SLP_WANTINIT    0x02/* thread waiting on NFS initialization */

/*
 * 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 nfsrv_descript *nfsd_nd;        /* Associated nfsrv_descript */
};

/* Bits for "nfsd_flag" */

#define NFSD_WAITING    0x01
#define NFSD_REQINPROG  0x02
#define NFSD_NEEDAUTH   0x04
#define NFSD_AUTHFAIL   0x08

/*
 * This structure is used by the server for describing each request.
 */

struct nfsrv_descript
{
  unsigned int nd_procnum;       /* RPC # */
  int nd_flag;           /* nd_flag */
  int nd_repstat;        /* Reply status */
  u_int32_t nd_retxid;   /* Reply xid */
};

/* 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 */