Annotation of sys/nfs/nfs.h, Revision 1.1
1.1 ! nbrk 1: /* $OpenBSD: nfs.h,v 1.28 2007/01/16 17:52:18 thib Exp $ */
! 2: /* $NetBSD: nfs.h,v 1.10.4.1 1996/05/27 11:23:56 fvdl Exp $ */
! 3:
! 4: /*
! 5: * Copyright (c) 1989, 1993, 1995
! 6: * The Regents of the University of California. All rights reserved.
! 7: *
! 8: * This code is derived from software contributed to Berkeley by
! 9: * Rick Macklem at The University of Guelph.
! 10: *
! 11: * Redistribution and use in source and binary forms, with or without
! 12: * modification, are permitted provided that the following conditions
! 13: * are met:
! 14: * 1. Redistributions of source code must retain the above copyright
! 15: * notice, this list of conditions and the following disclaimer.
! 16: * 2. Redistributions in binary form must reproduce the above copyright
! 17: * notice, this list of conditions and the following disclaimer in the
! 18: * documentation and/or other materials provided with the distribution.
! 19: * 3. Neither the name of the University nor the names of its contributors
! 20: * may be used to endorse or promote products derived from this software
! 21: * without specific prior written permission.
! 22: *
! 23: * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
! 24: * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
! 25: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
! 26: * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
! 27: * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
! 28: * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
! 29: * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
! 30: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
! 31: * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
! 32: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
! 33: * SUCH DAMAGE.
! 34: *
! 35: * @(#)nfs.h 8.4 (Berkeley) 5/1/95
! 36: */
! 37:
! 38: #ifndef _NFS_NFS_H_
! 39: #define _NFS_NFS_H_
! 40:
! 41: /*
! 42: * Tunable constants for nfs
! 43: */
! 44:
! 45: #define NFS_MAXIOVEC 34
! 46: #define NFS_TICKINTVL 5 /* Desired time for a tick (msec) */
! 47: #define NFS_HZ (hz / nfs_ticks) /* Ticks/sec */
! 48: #define NFS_TIMEO (1 * NFS_HZ) /* Default timeout = 1 second */
! 49: #define NFS_MINTIMEO (1 * NFS_HZ) /* Min timeout to use */
! 50: #define NFS_MAXTIMEO (60 * NFS_HZ) /* Max timeout to backoff to */
! 51: #define NFS_MINIDEMTIMEO (5 * NFS_HZ) /* Min timeout for non-idempotent ops*/
! 52: #define NFS_TIMEOUTMUL 2 /* Timeout/Delay multiplier */
! 53: #define NFS_MAXREXMIT 100 /* Stop counting after this many */
! 54: #define NFS_MAXWINDOW 1024 /* Max number of outstanding requests */
! 55: #define NFS_RETRANS 10 /* Num of retrans for soft mounts */
! 56: #define NFS_MAXGRPS 16 /* Max. size of groups list */
! 57: #ifndef NFS_MINATTRTIMO
! 58: #define NFS_MINATTRTIMO 5 /* Attribute cache timeout in sec */
! 59: #endif
! 60: #ifndef NFS_MAXATTRTIMO
! 61: #define NFS_MAXATTRTIMO 60
! 62: #endif
! 63: #define NFS_WSIZE 8192 /* Def. write data size <= 8192 */
! 64: #define NFS_RSIZE 8192 /* Def. read data size <= 8192 */
! 65: #define NFS_READDIRSIZE 8192 /* Def. readdir size */
! 66: #define NFS_DEFRAHEAD 1 /* Def. read ahead # blocks */
! 67: #define NFS_MAXRAHEAD 4 /* Max. read ahead # blocks */
! 68: #define NFS_MAXUIDHASH 64 /* Max. # of hashed uid entries/mp */
! 69: #define NFS_MAXASYNCDAEMON 20 /* Max. number async_daemons runable */
! 70: #define NFS_MAXGATHERDELAY 100 /* Max. write gather delay (msec) */
! 71: #ifndef NFS_GATHERDELAY
! 72: #define NFS_GATHERDELAY 10 /* Default write gather delay (msec) */
! 73: #endif
! 74: /*
! 75: * Ideally, NFS_DIRBLKSIZ should be bigger, but I've seen servers with
! 76: * broken NFS/ethernet drivers that won't work with anything bigger (Linux..)
! 77: */
! 78: #define NFS_DIRBLKSIZ 1024 /* Must be a multiple of DIRBLKSIZ */
! 79: #define NFS_READDIRBLKSIZ 512 /* Size of read dir blocks. XXX */
! 80:
! 81: /*
! 82: * Oddballs
! 83: */
! 84: #define NMOD(a) ((a) % nfs_asyncdaemons)
! 85: #define NFS_CMPFH(n, f, s) \
! 86: ((n)->n_fhsize == (s) && !bcmp((caddr_t)(n)->n_fhp, (caddr_t)(f), (s)))
! 87: #define NFS_ISV3(v) (VFSTONFS((v)->v_mount)->nm_flag & NFSMNT_NFSV3)
! 88: #define NFS_SRVMAXDATA(n) \
! 89: (((n)->nd_flag & ND_NFSV3) ? (((n)->nd_nam2) ? \
! 90: NFS_MAXDGRAMDATA : NFS_MAXDATA) : NFS_V2MAXDATA)
! 91:
! 92: /*
! 93: * sys/malloc.h needs M_NFSDIROFF, M_NFSRVDESC and M_NFSBIGFH added.
! 94: * The VA_EXCLUSIVE flag should be added for va_vaflags and set for an
! 95: * exclusive create.
! 96: */
! 97: #ifndef M_NFSRVDESC
! 98: #define M_NFSRVDESC M_TEMP
! 99: #endif
! 100: #ifndef M_NFSDIROFF
! 101: #define M_NFSDIROFF M_TEMP
! 102: #endif
! 103: #ifndef M_NFSBIGFH
! 104: #define M_NFSBIGFH M_TEMP
! 105: #endif
! 106: #ifndef VA_EXCLUSIVE
! 107: #define VA_EXCLUSIVE 0
! 108: #endif
! 109:
! 110: /*
! 111: * The B_INVAFTERWRITE flag should be set to whatever is required by the
! 112: * buffer cache code to say "Invalidate the block after it is written back".
! 113: */
! 114: #define B_INVAFTERWRITE B_INVAL
! 115:
! 116: /*
! 117: * The IO_METASYNC flag should be implemented for local file systems.
! 118: * (Until then, it is nothin at all.)
! 119: */
! 120: #ifndef IO_METASYNC
! 121: #define IO_METASYNC 0
! 122: #endif
! 123:
! 124: /*
! 125: * Set the attribute timeout based on how recently the file has been modified.
! 126: */
! 127: #if 0 /* replaced by nfs_attrtimeo() in nfs_subs.c */
! 128: #define NFS_ATTRTIMEO(np) \
! 129: ((((np)->n_flag & NMODIFIED) || \
! 130: (time_second - (np)->n_mtime) / 10 < NFS_MINATTRTIMO) ? NFS_MINATTRTIMO : \
! 131: ((time_second - (np)->n_mtime) / 10 > NFS_MAXATTRTIMO ? NFS_MAXATTRTIMO : \
! 132: (time_second - (np)->n_mtime) / 10))
! 133: #endif
! 134:
! 135: /*
! 136: * Structures for the nfssvc(2) syscall. Not that anyone but nfsd and mount_nfs
! 137: * should ever try and use it.
! 138: */
! 139: struct nfsd_args {
! 140: int sock; /* Socket to serve */
! 141: caddr_t name; /* Client addr for connection based sockets */
! 142: int namelen; /* Length of name */
! 143: };
! 144:
! 145: struct nfsd_srvargs {
! 146: struct nfsd *nsd_nfsd; /* Pointer to in kernel nfsd struct */
! 147: uid_t nsd_uid; /* Effective uid mapped to cred */
! 148: u_int32_t nsd_haddr; /* IP address of client */
! 149: struct ucred nsd_cr; /* Cred. uid maps to */
! 150: int nsd_authlen; /* Length of auth string (ret) */
! 151: u_char *nsd_authstr; /* Auth string (ret) */
! 152: int nsd_verflen; /* and the verifier */
! 153: u_char *nsd_verfstr;
! 154: struct timeval nsd_timestamp; /* timestamp from verifier */
! 155: u_int32_t nsd_ttl; /* credential ttl (sec) */
! 156: NFSKERBKEY_T nsd_key; /* Session key */
! 157: };
! 158:
! 159: struct nfsd_cargs {
! 160: char *ncd_dirp; /* Mount dir path */
! 161: uid_t ncd_authuid; /* Effective uid */
! 162: int ncd_authtype; /* Type of authenticator */
! 163: u_int ncd_authlen; /* Length of authenticator string */
! 164: u_char *ncd_authstr; /* Authenticator string */
! 165: u_int ncd_verflen; /* and the verifier */
! 166: u_char *ncd_verfstr;
! 167: NFSKERBKEY_T ncd_key; /* Session key */
! 168: };
! 169:
! 170: /*
! 171: * Stats structure
! 172: */
! 173: struct nfsstats {
! 174: uint64_t attrcache_hits;
! 175: uint64_t attrcache_misses;
! 176: uint64_t lookupcache_hits;
! 177: uint64_t lookupcache_misses;
! 178: uint64_t direofcache_hits;
! 179: uint64_t direofcache_misses;
! 180: uint64_t biocache_reads;
! 181: uint64_t read_bios;
! 182: uint64_t read_physios;
! 183: uint64_t biocache_writes;
! 184: uint64_t write_bios;
! 185: uint64_t write_physios;
! 186: uint64_t biocache_readlinks;
! 187: uint64_t readlink_bios;
! 188: uint64_t biocache_readdirs;
! 189: uint64_t readdir_bios;
! 190: uint64_t rpccnt[NFS_NPROCS];
! 191: uint64_t rpcretries;
! 192: uint64_t srvrpccnt[NFS_NPROCS];
! 193: uint64_t srvrpc_errs;
! 194: uint64_t srv_errs;
! 195: uint64_t rpcrequests;
! 196: uint64_t rpctimeouts;
! 197: uint64_t rpcunexpected;
! 198: uint64_t rpcinvalid;
! 199: uint64_t srvcache_inproghits;
! 200: uint64_t srvcache_idemdonehits;
! 201: uint64_t srvcache_nonidemdonehits;
! 202: uint64_t srvcache_misses;
! 203: uint64_t srvnqnfs_leases;
! 204: uint64_t srvnqnfs_maxleases;
! 205: uint64_t srvnqnfs_getleases;
! 206: uint64_t srvvop_writes;
! 207: };
! 208:
! 209: /*
! 210: * Flags for nfssvc() system call.
! 211: */
! 212: #define NFSSVC_BIOD 0x002
! 213: #define NFSSVC_NFSD 0x004
! 214: #define NFSSVC_ADDSOCK 0x008
! 215: #define NFSSVC_AUTHIN 0x010
! 216: #define NFSSVC_GOTAUTH 0x040
! 217: #define NFSSVC_AUTHINFAIL 0x080
! 218: #define NFSSVC_MNTD 0x100
! 219:
! 220: /*
! 221: * fs.nfs sysctl(3) identifiers
! 222: */
! 223: #define NFS_NFSSTATS 1 /* struct: struct nfsstats */
! 224: #define NFS_NIOTHREADS 2 /* number of i/o threads */
! 225: #define NFS_MAXID 3
! 226:
! 227: #define FS_NFS_NAMES { \
! 228: { 0, 0 }, \
! 229: { "nfsstats", CTLTYPE_STRUCT }, \
! 230: { "iothreads", CTLTYPE_INT } \
! 231: }
! 232:
! 233: /*
! 234: * The set of signals the interrupt an I/O in progress for NFSMNT_INT mounts.
! 235: * What should be in this set is open to debate, but I believe that since
! 236: * I/O system calls on ufs are never interrupted by signals the set should
! 237: * be minimal. My reasoning is that many current programs that use signals
! 238: * such as SIGALRM will not expect file I/O system calls to be interrupted
! 239: * by them and break.
! 240: */
! 241: #ifdef _KERNEL
! 242: extern int nfs_niothreads;
! 243:
! 244: struct uio; struct buf; struct vattr; struct nameidata; /* XXX */
! 245:
! 246: #define NFSINT_SIGMASK (sigmask(SIGINT)|sigmask(SIGTERM)|sigmask(SIGKILL)| \
! 247: sigmask(SIGHUP)|sigmask(SIGQUIT))
! 248:
! 249: /*
! 250: * Socket errors ignored for connectionless sockets??
! 251: * For now, ignore them all
! 252: */
! 253: #define NFSIGNORE_SOERROR(s, e) \
! 254: ((e) != EINTR && (e) != ERESTART && (e) != EWOULDBLOCK && \
! 255: ((s) & PR_CONNREQUIRED) == 0)
! 256:
! 257: /*
! 258: * Nfs outstanding request list element
! 259: */
! 260: struct nfsreq {
! 261: TAILQ_ENTRY(nfsreq) r_chain;
! 262: struct mbuf *r_mreq;
! 263: struct mbuf *r_mrep;
! 264: struct mbuf *r_md;
! 265: caddr_t r_dpos;
! 266: struct nfsmount *r_nmp;
! 267: struct vnode *r_vp;
! 268: u_int32_t r_xid;
! 269: int r_flags; /* flags on request, see below */
! 270: int r_retry; /* max retransmission count */
! 271: int r_rexmit; /* current retrans count */
! 272: int r_timer; /* tick counter on reply */
! 273: int r_procnum; /* NFS procedure number */
! 274: int r_rtt; /* RTT for rpc */
! 275: struct proc *r_procp; /* Proc that did I/O system call */
! 276: };
! 277:
! 278: /*
! 279: * Queue head for nfsreq's
! 280: */
! 281: extern TAILQ_HEAD(nfsreqhead, nfsreq) nfs_reqq;
! 282:
! 283: /* Flag values for r_flags */
! 284: #define R_TIMING 0x01 /* timing request (in mntp) */
! 285: #define R_SENT 0x02 /* request has been sent */
! 286: #define R_SOFTTERM 0x04 /* soft mnt, too many retries */
! 287: #define R_INTR 0x08 /* intr mnt, signal pending */
! 288: #define R_SOCKERR 0x10 /* Fatal error on socket */
! 289: #define R_TPRINTFMSG 0x20 /* Did a tprintf msg. */
! 290: #define R_MUSTRESEND 0x40 /* Must resend request */
! 291: #define R_GETONEREP 0x80 /* Probe for one reply only */
! 292:
! 293: /*
! 294: * A list of nfssvc_sock structures is maintained with all the sockets
! 295: * that require service by the nfsd.
! 296: * The nfsuid structs hang off of the nfssvc_sock structs in both lru
! 297: * and uid hash lists.
! 298: */
! 299: #ifndef NFS_UIDHASHSIZ
! 300: #define NFS_UIDHASHSIZ 29 /* Tune the size of nfssvc_sock with this */
! 301: #endif
! 302: #define NUIDHASH(sock, uid) \
! 303: (&(sock)->ns_uidhashtbl[(uid) % NFS_UIDHASHSIZ])
! 304: #ifndef NFS_WDELAYHASHSIZ
! 305: #define NFS_WDELAYHASHSIZ 16 /* and with this */
! 306: #endif
! 307: #define NWDELAYHASH(sock, f) \
! 308: (&(sock)->ns_wdelayhashtbl[(*((u_int32_t *)(f))) % NFS_WDELAYHASHSIZ])
! 309: #ifndef NFS_MUIDHASHSIZ
! 310: #define NFS_MUIDHASHSIZ 67 /* Tune the size of nfsmount with this */
! 311: #endif
! 312: #define NMUIDHASH(nmp, uid) \
! 313: (&(nmp)->nm_uidhashtbl[(uid) % NFS_MUIDHASHSIZ])
! 314: #define NFSNOHASH(fhsum) \
! 315: (&nfsnodehashtbl[(fhsum) & nfsnodehash])
! 316:
! 317: /*
! 318: * Network address hash list element
! 319: */
! 320: union nethostaddr {
! 321: u_int32_t had_inetaddr;
! 322: struct mbuf *had_nam;
! 323: };
! 324:
! 325: struct nfsuid {
! 326: TAILQ_ENTRY(nfsuid) nu_lru; /* LRU chain */
! 327: LIST_ENTRY(nfsuid) nu_hash; /* Hash list */
! 328: int nu_flag; /* Flags */
! 329: union nethostaddr nu_haddr; /* Host addr. for dgram sockets */
! 330: struct ucred nu_cr; /* Cred uid mapped to */
! 331: int nu_expire; /* Expiry time (sec) */
! 332: struct timeval nu_timestamp; /* Kerb. timestamp */
! 333: u_int32_t nu_nickname; /* Nickname on server */
! 334: NFSKERBKEY_T nu_key; /* and session key */
! 335: };
! 336:
! 337: #define nu_inetaddr nu_haddr.had_inetaddr
! 338: #define nu_nam nu_haddr.had_nam
! 339: /* Bits for nu_flag */
! 340: #define NU_INETADDR 0x1
! 341: #define NU_NAM 0x2
! 342: #define NU_NETFAM(u) (((u)->nu_flag & NU_INETADDR) ? AF_INET : AF_ISO)
! 343:
! 344: struct nfssvc_sock {
! 345: TAILQ_ENTRY(nfssvc_sock) ns_chain; /* List of all nfssvc_sock's */
! 346: TAILQ_HEAD(, nfsuid) ns_uidlruhead;
! 347: struct file *ns_fp;
! 348: struct socket *ns_so;
! 349: struct mbuf *ns_nam;
! 350: struct mbuf *ns_raw;
! 351: struct mbuf *ns_rawend;
! 352: struct mbuf *ns_rec;
! 353: struct mbuf *ns_recend;
! 354: struct mbuf *ns_frag;
! 355: int ns_flag;
! 356: int ns_solock;
! 357: int ns_cc;
! 358: int ns_reclen;
! 359: int ns_numuids;
! 360: u_int32_t ns_sref;
! 361: LIST_HEAD(, nfsrv_descript) ns_tq; /* Write gather lists */
! 362: LIST_HEAD(, nfsuid) ns_uidhashtbl[NFS_UIDHASHSIZ];
! 363: LIST_HEAD(nfsrvw_delayhash, nfsrv_descript) ns_wdelayhashtbl[NFS_WDELAYHASHSIZ];
! 364: };
! 365:
! 366: /* Bits for "ns_flag" */
! 367: #define SLP_VALID 0x01
! 368: #define SLP_DOREC 0x02
! 369: #define SLP_NEEDQ 0x04
! 370: #define SLP_DISCONN 0x08
! 371: #define SLP_GETSTREAM 0x10
! 372: #define SLP_LASTFRAG 0x20
! 373: #define SLP_ALLFLAGS 0xff
! 374:
! 375: extern TAILQ_HEAD(nfssvc_sockhead, nfssvc_sock) nfssvc_sockhead;
! 376: extern int nfssvc_sockhead_flag;
! 377: #define SLP_INIT 0x01
! 378: #define SLP_WANTINIT 0x02
! 379:
! 380: /*
! 381: * One of these structures is allocated for each nfsd.
! 382: */
! 383: struct nfsd {
! 384: TAILQ_ENTRY(nfsd) nfsd_chain; /* List of all nfsd's */
! 385: int nfsd_flag; /* NFSD_ flags */
! 386: struct nfssvc_sock *nfsd_slp; /* Current socket */
! 387: int nfsd_authlen; /* Authenticator len */
! 388: u_char nfsd_authstr[RPCAUTH_MAXSIZ]; /* Authenticator data */
! 389: int nfsd_verflen; /* and the Verifier */
! 390: u_char nfsd_verfstr[RPCVERF_MAXSIZ];
! 391: struct proc *nfsd_procp; /* Proc ptr */
! 392: struct nfsrv_descript *nfsd_nd; /* Associated nfsrv_descript */
! 393: };
! 394:
! 395: /* Bits for "nfsd_flag" */
! 396: #define NFSD_WAITING 0x01
! 397: #define NFSD_REQINPROG 0x02
! 398: #define NFSD_NEEDAUTH 0x04
! 399: #define NFSD_AUTHFAIL 0x08
! 400:
! 401: /*
! 402: * This structure is used by the server for describing each request.
! 403: * Some fields are used only when write request gathering is performed.
! 404: */
! 405: struct nfsrv_descript {
! 406: u_quad_t nd_time; /* Write deadline (usec) */
! 407: off_t nd_off; /* Start byte offset */
! 408: off_t nd_eoff; /* and end byte offset */
! 409: LIST_ENTRY(nfsrv_descript) nd_hash; /* Hash list */
! 410: LIST_ENTRY(nfsrv_descript) nd_tq; /* and timer list */
! 411: LIST_HEAD(,nfsrv_descript) nd_coalesce; /* coalesced writes */
! 412: struct mbuf *nd_mrep; /* Request mbuf list */
! 413: struct mbuf *nd_md; /* Current dissect mbuf */
! 414: struct mbuf *nd_mreq; /* Reply mbuf list */
! 415: struct mbuf *nd_nam; /* and socket addr */
! 416: struct mbuf *nd_nam2; /* return socket addr */
! 417: caddr_t nd_dpos; /* Current dissect pos */
! 418: unsigned int nd_procnum; /* RPC # */
! 419: int nd_stable; /* storage type */
! 420: int nd_flag; /* nd_flag */
! 421: int nd_len; /* Length of this write */
! 422: int nd_repstat; /* Reply status */
! 423: u_int32_t nd_retxid; /* Reply xid */
! 424: struct timeval nd_starttime; /* Time RPC initiated */
! 425: fhandle_t nd_fh; /* File handle */
! 426: struct ucred nd_cr; /* Credentials */
! 427: };
! 428:
! 429: /* Bits for "nd_flag" */
! 430: #define ND_NFSV3 0x08
! 431: #define ND_KERBNICK 0x20
! 432: #define ND_KERBFULL 0x40
! 433: #define ND_KERBAUTH (ND_KERBNICK | ND_KERBFULL)
! 434:
! 435: extern struct pool nfsreqpl;
! 436: extern TAILQ_HEAD(nfsdhead, nfsd) nfsd_head;
! 437: extern int nfsd_head_flag;
! 438: #define NFSD_CHECKSLP 0x01
! 439:
! 440: /*
! 441: * These macros compare nfsrv_descript structures.
! 442: */
! 443: #define NFSW_CONTIG(o, n) \
! 444: ((o)->nd_eoff >= (n)->nd_off && \
! 445: !bcmp((caddr_t)&(o)->nd_fh, (caddr_t)&(n)->nd_fh, NFSX_V3FH))
! 446:
! 447: #define NFSW_SAMECRED(o, n) \
! 448: (((o)->nd_flag & ND_KERBAUTH) == ((n)->nd_flag & ND_KERBAUTH) && \
! 449: !bcmp((caddr_t)&(o)->nd_cr, (caddr_t)&(n)->nd_cr, \
! 450: sizeof (struct ucred)))
! 451:
! 452: #endif /* _KERNEL */
! 453: #endif /* _NFS_NFS_H */
CVSweb