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