xref: /dragonfly/sys/sys/mount.h (revision 469fd606)
1 /*
2  * Copyright (c) 1989, 1991, 1993
3  *	The Regents of the University of California.  All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. Neither the name of the University nor the names of its contributors
14  *    may be used to endorse or promote products derived from this software
15  *    without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
21  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  *
29  *	@(#)mount.h	8.21 (Berkeley) 5/20/95
30  * $FreeBSD: src/sys/sys/mount.h,v 1.89.2.7 2003/04/04 20:35:57 tegge Exp $
31  */
32 
33 #ifndef _SYS_MOUNT_H_
34 #define _SYS_MOUNT_H_
35 
36 #include <sys/mplock2.h>
37 #include <sys/queue.h>
38 #include <sys/tree.h>
39 #include <sys/ucred.h>
40 
41 #ifndef _KERNEL
42 #if !defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE)
43 #include <sys/stat.h>
44 #endif /* !_POSIX_C_SOURCE */
45 #endif /* !_KERNEL */
46 
47 #if defined(_KERNEL) || defined(_KERNEL_STRUCTURES)
48 #ifndef _SYS_LOCK_H_
49 #include <sys/lock.h>
50 #endif
51 #ifndef _SYS_NAMECACHE_H_
52 #include <sys/namecache.h>
53 #endif
54 #ifndef _SYS_STATVFS_H_
55 #include <sys/statvfs.h>
56 #endif
57 #ifndef _SYS_THREAD_H_
58 #include <sys/thread.h>
59 #endif
60 #include <sys/vfs_quota.h>
61 #endif
62 
63 struct thread;
64 struct journal;
65 struct vop_ops;
66 struct vop_mountctl_args;
67 struct statvfs;
68 struct vmntvnodescan_info;
69 
70 typedef struct fsid { int32_t val[2]; } fsid_t;	/* file system id type */
71 
72 /*
73  * File identifier.  These are unique per filesystem on a single machine.
74  *
75  * fix_ext is also used by HAMMER.
76  */
77 #define	MAXFIDSZ	16
78 
79 struct fid {
80 	u_short		fid_len;		/* length of data in bytes */
81 	u_short		fid_ext;		/* extended data 	   */
82 	char		fid_data[MAXFIDSZ];	/* data (variable length) */
83 } __packed;
84 
85 /*
86  * file system statistics
87  */
88 
89 #define MFSNAMELEN	16	/* length of fs type name, including null */
90 #define	MNAMELEN	80	/* length of buffer for returned name */
91 
92 struct statfs {
93 	long	f_spare2;		/* placeholder */
94 	long	f_bsize;		/* fundamental file system block size */
95 	long	f_iosize;		/* optimal transfer block size */
96 	long	f_blocks;		/* total data blocks in file system */
97 	long	f_bfree;		/* free blocks in fs */
98 	long	f_bavail;		/* free blocks avail to non-superuser */
99 	long	f_files;		/* total file nodes in file system */
100 	long	f_ffree;		/* free file nodes in fs */
101 	fsid_t	f_fsid;			/* file system id */
102 	uid_t	f_owner;		/* user that mounted the filesystem */
103 	int	f_type;			/* type of filesystem */
104 	int	f_flags;		/* copy of mount exported flags */
105 	long    f_syncwrites;		/* count of sync writes since mount */
106 	long    f_asyncwrites;		/* count of async writes since mount */
107 	char	f_fstypename[MFSNAMELEN]; /* fs type name */
108 	char	f_mntonname[MNAMELEN];	/* directory on which mounted */
109 	long    f_syncreads;		/* count of sync reads since mount */
110 	long    f_asyncreads;		/* count of async reads since mount */
111 	short	f_spares1;		/* unused spare */
112 	char	f_mntfromname[MNAMELEN];/* mounted filesystem */
113 	short	f_spares2;		/* unused spare */
114 	long    f_spare[2];		/* unused spare */
115 };
116 
117 #if defined(_KERNEL) || defined(_KERNEL_STRUCTURES)
118 
119 /*
120  * bio_ops are associated with the mount structure and used in conjuction
121  * with the b_dep field in a buffer.  Currently softupdates and HAMMER
122  * utilize this field.
123  *
124  * All bio_ops callbacks must be MPSAFE and could be called without
125  * the mplock.
126  */
127 struct buf;
128 
129 struct bio_ops {
130 	TAILQ_ENTRY(bio_ops) entry;
131 	void	(*io_start) (struct buf *);
132 	void	(*io_complete) (struct buf *);
133 	void	(*io_deallocate) (struct buf *);
134 	int	(*io_fsync) (struct vnode *);
135 	int	(*io_sync) (struct mount *);
136 	void	(*io_movedeps) (struct buf *, struct buf *);
137 	int	(*io_countdeps) (struct buf *, int);
138 	int	(*io_checkread) (struct buf *);
139 	int	(*io_checkwrite) (struct buf *);
140 };
141 
142 #endif
143 
144 /*
145  * vfs quota accounting
146  *
147  * uids and gids often come in contiguous blocks; use a small linear
148  * array as the basic in-memory accounting allocation unit
149  */
150 #define ACCT_CHUNK_BITS	5
151 #define ACCT_CHUNK_NIDS	(1<<ACCT_CHUNK_BITS)
152 #define ACCT_CHUNK_MASK	(ACCT_CHUNK_NIDS - 1)
153 
154 struct ac_counters {
155 	uint64_t space;
156 	uint64_t limit;
157 };
158 
159 struct ac_unode {
160 	RB_ENTRY(ac_unode)	rb_entry;
161 	uid_t			left_bits;
162 	struct ac_counters	uid_chunk[ACCT_CHUNK_NIDS];
163 };
164 
165 struct ac_gnode {
166 	RB_ENTRY(ac_gnode)	rb_entry;
167 	gid_t			left_bits;
168 	struct ac_counters	gid_chunk[ACCT_CHUNK_NIDS];
169 };
170 
171 #if defined(_KERNEL) || defined(_KERNEL_STRUCTURES)
172 
173 struct vfs_acct {
174 	RB_HEAD(ac_utree,ac_unode)	ac_uroot;
175 	RB_HEAD(ac_gtree,ac_gnode)	ac_groot;
176 	uint64_t			ac_bytes;	/* total bytes used */
177 	uint64_t			ac_limit;
178 	struct spinlock			ac_spin;	/* protective spinlock */
179 };
180 
181 
182 /*
183  * Structure per mounted file system.  Each mounted file system has an
184  * array of operations and an instance record.  The file systems are
185  * put on a doubly linked list.
186  *
187  * NOTE: mnt_nvnodelist and mnt_reservedvnlist.  At the moment vnodes
188  * are linked into mnt_nvnodelist.  At some point in the near future the
189  * vnode list will be split into a 'dirty' and 'clean' list. mnt_nvnodelist
190  * will become the dirty list and mnt_reservedvnlist will become the 'clean'
191  * list.  Filesystem kld's syncing code should remain compatible since
192  * they only need to scan the dirty vnode list (nvnodelist -> dirtyvnodelist).
193  *
194  * NOTE: All VFSs must at least populate mnt_vn_ops or those VOP ops that
195  * only take namecache pointers will not be able to find their operations
196  * vector via namecache->nc_mount.
197  *
198  * MPSAFE NOTES: mnt_lock interlocks mounting and unmounting operations.
199  *
200  *		 mnt_token interlocks operations which adjust the mount
201  *		 structure and will also be held through VFS operations
202  *		 for VFSes not flagged MPSAFE.
203  *
204  *		 The VFS should pre-set VFCF_MPSAFE in the VFS_SET() to
205  *		 avoid use of the mplock during mounting.  This will also
206  *		 cause MNTK_ALL_MPSAFE to be set in mnt_kern_flags.  If the
207  *		 VFS does not set VFCF_MPSAFE then it can set individual
208  *		 MNTK_*_MPSAFE flags in mnt_kern_flags.
209  */
210 TAILQ_HEAD(vnodelst, vnode);
211 TAILQ_HEAD(journallst, journal);
212 
213 struct mount {
214 	TAILQ_ENTRY(mount) mnt_list;		/* mount list */
215 	struct vfsops	*mnt_op;		/* operations on fs */
216 	struct vfsconf	*mnt_vfc;		/* configuration info */
217 	u_int		mnt_namecache_gen;	/* ++ to clear negative hits */
218 	u_int		mnt_pbuf_count;		/* pbuf usage limit */
219 	struct vnode	*mnt_syncer;		/* syncer vnode */
220 	struct syncer_ctx *mnt_syncer_ctx;	/* syncer process context */
221 	struct vnodelst	mnt_nvnodelist;		/* list of vnodes this mount */
222 	TAILQ_HEAD(,vmntvnodescan_info) mnt_vnodescan_list;
223 	struct lock	mnt_lock;		/* mount structure lock */
224 	int		mnt_flag;		/* flags shared with user */
225 	int		mnt_kern_flag;		/* kernel only flags */
226 	int		mnt_maxsymlinklen;	/* max size of short symlink */
227 	struct statfs	mnt_stat;		/* cache of filesystem stats */
228 	struct statvfs	mnt_vstat;		/* extended stats */
229 	qaddr_t		mnt_data;		/* private data */
230 	time_t		mnt_time;		/* last time written*/
231 	u_int		mnt_iosize_max;		/* max IO request size */
232 	struct vnodelst	mnt_reservedvnlist;	/* (future) dirty vnode list */
233 	int		mnt_nvnodelistsize;	/* # of vnodes on this mount */
234 
235 	/*
236 	 * ops vectors have a fixed stacking order.  All primary calls run
237 	 * through mnt_vn_ops.  This field is typically assigned to
238 	 * mnt_vn_norm_ops.  If journaling has been enabled this field is
239 	 * usually assigned to mnt_vn_journal_ops.
240 	 */
241 	struct vop_ops	*mnt_vn_use_ops;	/* current ops set */
242 
243 	struct vop_ops	*mnt_vn_coherency_ops;	/* cache coherency ops */
244 	struct vop_ops	*mnt_vn_journal_ops;	/* journaling ops */
245 	struct vop_ops  *mnt_vn_norm_ops;	/* for use by the VFS */
246 	struct vop_ops	*mnt_vn_spec_ops;	/* for use by the VFS */
247 	struct vop_ops	*mnt_vn_fifo_ops;	/* for use by the VFS */
248 	struct nchandle mnt_ncmountpt;		/* mount point */
249 	struct nchandle mnt_ncmounton;		/* mounted on */
250 	char		mnt_pad[16];		/* (try to cache-align refs) */
251 	struct ucred	*mnt_cred;		/* for cr_prison */
252 	int		mnt_refs;		/* nchandle references */
253 	int		mnt_hold;		/* prevent kfree */
254 	struct lwkt_token mnt_token;		/* token lock if not MPSAFE */
255 	struct journallst mnt_jlist;		/* list of active journals */
256 	u_int8_t	*mnt_jbitmap;		/* streamid bitmap */
257 	int16_t		mnt_streamid;		/* last streamid */
258 
259 	struct bio_ops	*mnt_bioops;		/* BIO ops (hammer, softupd) */
260 
261 	struct vfs_acct	mnt_acct;		/* vfs space accounting */
262 	RB_ENTRY(mount)	mnt_node;		/* mnt_stat.f_fsid */
263 };
264 
265 #endif /* _KERNEL || _KERNEL_STRUCTURES */
266 
267 /*
268  * User specifiable flags.
269  */
270 #define	MNT_RDONLY	0x00000001	/* read only filesystem */
271 #define	MNT_SYNCHRONOUS	0x00000002	/* file system written synchronously */
272 #define	MNT_NOEXEC	0x00000004	/* can't exec from filesystem */
273 #define	MNT_NOSUID	0x00000008	/* don't honor setuid bits on fs */
274 #define	MNT_NODEV	0x00000010	/* don't interpret special files */
275 #define	MNT_AUTOMOUNTED	0x00000020	/* mounted by automountd(8) */
276 #define	MNT_ASYNC	0x00000040	/* file system written asynchronously */
277 #define	MNT_SUIDDIR	0x00100000	/* special handling of SUID on dirs */
278 #define	MNT_SOFTDEP	0x00200000	/* soft updates being done */
279 #define	MNT_NOSYMFOLLOW	0x00400000	/* do not follow symlinks */
280 #define	MNT_TRIM	0x01000000	/* Enable online FS trimming */
281 #define	MNT_NOATIME	0x10000000	/* disable update of file access time */
282 #define	MNT_NOCLUSTERR	0x40000000	/* disable cluster read */
283 #define	MNT_NOCLUSTERW	0x80000000	/* disable cluster write */
284 
285 /*
286  * NFS export related mount flags.
287  */
288 #define	MNT_EXRDONLY	0x00000080	/* exported read only */
289 #define	MNT_EXPORTED	0x00000100	/* file system is exported */
290 #define	MNT_DEFEXPORTED	0x00000200	/* exported to the world */
291 #define	MNT_EXPORTANON	0x00000400	/* use anon uid mapping for everyone */
292 #define	MNT_EXKERB	0x00000800	/* exported with Kerberos uid mapping */
293 #define	MNT_EXPUBLIC	0x20000000	/* public export (WebNFS) */
294 
295 /*
296  * Flags set by internal operations,
297  * but visible to the user.
298  * XXX some of these are not quite right.. (I've never seen the root flag set)
299  */
300 #define	MNT_LOCAL	0x00001000	/* filesystem is stored locally */
301 #define	MNT_QUOTA	0x00002000	/* quotas are enabled on filesystem */
302 #define	MNT_ROOTFS	0x00004000	/* identifies the root filesystem */
303 #define	MNT_USER	0x00008000	/* mounted by a user */
304 #define	MNT_IGNORE	0x00800000	/* do not show entry in df */
305 
306 /*
307  * Mask of flags that are visible to statfs()
308  * XXX I think that this could now become (~(MNT_CMDFLAGS))
309  * but the 'mount' program may need changing to handle this.
310  */
311 #define	MNT_VISFLAGMASK	(MNT_RDONLY	| MNT_SYNCHRONOUS | MNT_NOEXEC	| \
312 			MNT_NOSUID	| MNT_NODEV			| \
313 			MNT_ASYNC	| MNT_EXRDONLY	| MNT_EXPORTED	| \
314 			MNT_DEFEXPORTED	| MNT_EXPORTANON| MNT_EXKERB	| \
315 			MNT_LOCAL	| MNT_USER	| MNT_QUOTA	| \
316 			MNT_ROOTFS	| MNT_NOATIME	| MNT_NOCLUSTERR| \
317 			MNT_NOCLUSTERW	| MNT_SUIDDIR	| MNT_SOFTDEP	| \
318 			MNT_IGNORE	| MNT_NOSYMFOLLOW | MNT_EXPUBLIC| \
319 			MNT_TRIM	| MNT_AUTOMOUNTED)
320 /*
321  * External filesystem command modifier flags.
322  * Unmount can use the MNT_FORCE flag.
323  * XXX These are not STATES and really should be somewhere else.
324  */
325 #define	MNT_UPDATE	0x00010000	/* not a real mount, just an update */
326 #define	MNT_DELEXPORT	0x00020000	/* delete export host lists */
327 #define	MNT_RELOAD	0x00040000	/* reload filesystem data */
328 #define	MNT_FORCE	0x00080000	/* force unmount or readonly change */
329 #define MNT_CMDFLAGS	(MNT_UPDATE|MNT_DELEXPORT|MNT_RELOAD|MNT_FORCE)
330 /*
331  * Internal filesystem control flags stored in mnt_kern_flag.
332  *
333  * MNTK_UNMOUNT locks the mount entry so that name lookup cannot proceed
334  * past the mount point.  This keeps the subtree stable during mounts
335  * and unmounts.
336  *
337  * MNTK_UNMOUNTF permits filesystems to detect a forced unmount while
338  * dounmount() is still waiting to lock the mountpoint. This allows
339  * the filesystem to cancel operations that might otherwise deadlock
340  * with the unmount attempt (used by NFS).
341  *
342  * MNTK_NOSTKMNT prevents mounting another filesystem inside the flagged one.
343  */
344 #define MNTK_UNMOUNTF	0x00000001	/* forced unmount in progress */
345 #define MNTK_QUICKHALT	0x00008000	/* quick unmount on halt */
346 #define MNTK_MPSAFE	0x00010000	/* call vops without mnt_token lock */
347 #define MNTK_RD_MPSAFE	0x00020000	/* vop_read is MPSAFE */
348 #define MNTK_WR_MPSAFE	0x00040000	/* vop_write is MPSAFE */
349 #define MNTK_GA_MPSAFE	0x00080000	/* vop_getattr is MPSAFE */
350 #define MNTK_IN_MPSAFE	0x00100000	/* vop_inactive is MPSAFE */
351 #define MNTK_SG_MPSAFE	0x00200000	/* vop_strategy is MPSAFE */
352 #define MNTK_NCALIASED	0x00800000	/* namecached aliased */
353 #define MNTK_UNMOUNT	0x01000000	/* unmount in progress */
354 #define	MNTK_MWAIT	0x02000000	/* waiting for unmount to finish */
355 #define MNTK_WANTRDWR	0x04000000	/* upgrade to read/write requested */
356 #define MNTK_FSMID	0x08000000	/* getattr supports FSMIDs */
357 #define MNTK_NOSTKMNT	0x10000000	/* no stacked mount point allowed */
358 #define MNTK_NOMSYNC	0x20000000	/* used by tmpfs */
359 #define MNTK_THR_SYNC	0x40000000	/* fs sync thread requested */
360 #define MNTK_ST_MPSAFE	0x80000000	/* (mfs) vfs_start is MPSAFE */
361 
362 #define MNTK_ALL_MPSAFE	(MNTK_MPSAFE | MNTK_RD_MPSAFE | MNTK_WR_MPSAFE | \
363 			 MNTK_GA_MPSAFE | MNTK_IN_MPSAFE | MNTK_SG_MPSAFE | \
364 			 MNTK_ST_MPSAFE)
365 
366 /*
367  * mountlist_*() defines
368  */
369 #define MNTSCAN_FORWARD		0x0001
370 #define MNTSCAN_REVERSE		0x0002
371 #define MNTSCAN_NOBUSY		0x0004
372 #define MNTSCAN_NOUNLOCK	0x0008
373 
374 #define MNTINS_FIRST		0x0001
375 #define MNTINS_LAST		0x0002
376 
377 /*
378  * Sysctl CTL_VFS definitions.
379  *
380  * Second level identifier specifies which filesystem. Second level
381  * identifier VFS_VFSCONF returns information about all filesystems.
382  * Second level identifier VFS_GENERIC is non-terminal.
383  */
384 #define	VFS_VFSCONF		0	/* get configured filesystems */
385 #define	VFS_GENERIC		0	/* generic filesystem information */
386 /*
387  * Third level identifiers for VFS_GENERIC are given below; third
388  * level identifiers for specific filesystems are given in their
389  * mount specific header files.
390  */
391 #define VFS_MAXTYPENUM	1	/* int: highest defined filesystem type */
392 #define VFS_CONF	2	/* struct: vfsconf for filesystem given
393 				   as next argument */
394 
395 /*
396  * VFS MPLOCK helper.
397  *
398  * We have to cache the supplied mp because in certain situations
399  * the related vnode might go away across the use case (vop_strategy()).
400  */
401 #define VFS_MPLOCK_DECLARE	struct mount *xlock_mp
402 
403 #define VFS_MPLOCK(mp)		VFS_MPLOCK_FLAG(mp, MNTK_MPSAFE)
404 
405 #define VFS_MPLOCK_FLAG(mp, flag)					\
406 		do {							\
407 			if (mp->mnt_kern_flag & flag) {			\
408 				xlock_mp = NULL;			\
409 			} else {					\
410 				xlock_mp = (mp);			\
411 				get_mplock();	/* TEMPORARY */		\
412 				lwkt_gettoken(&xlock_mp->mnt_token);	\
413 			}						\
414 		} while(0)
415 
416 #define VFS_MPUNLOCK()						\
417 		do {							\
418 			if (xlock_mp) {					\
419 				lwkt_reltoken(&xlock_mp->mnt_token);	\
420 				rel_mplock();	/* TEMPORARY */		\
421 			}						\
422 		} while(0)
423 
424 /*
425  * Flags for various system call interfaces.
426  *
427  * waitfor flags to vfs_sync() and getfsstat()
428  */
429 #define MNT_WAIT	0x0001	/* synchronously wait for I/O to complete */
430 #define MNT_NOWAIT	0x0002	/* start all I/O, but do not wait for it */
431 #define MNT_LAZY	0x0004	/* be lazy and do not necessarily push it all */
432 
433 #define VOP_FSYNC_SYSCALL	0x0001	/* from system call */
434 
435 /*
436  * Generic file handle
437  */
438 struct fhandle {
439 	fsid_t	fh_fsid;	/* File system id of mount point */
440 	struct	fid fh_fid;	/* File sys specific id */
441 };
442 typedef struct fhandle	fhandle_t;
443 
444 /*
445  * Export arguments for local filesystem mount calls.
446  */
447 struct export_args {
448 	int	ex_flags;		/* export related flags */
449 	uid_t	ex_root;		/* mapping for root uid */
450 	struct	ucred ex_anon;		/* mapping for anonymous user */
451 	struct	sockaddr *ex_addr;	/* net address to which exported */
452 	int	ex_addrlen;		/* and the net address length */
453 	struct	sockaddr *ex_mask;	/* mask of valid bits in saddr */
454 	int	ex_masklen;		/* and the smask length */
455 	char	*ex_indexfile;		/* index file for WebNFS URLs */
456 };
457 
458 /*
459  * Structure holding information for a publicly exported filesystem
460  * (WebNFS). Currently the specs allow just for one such filesystem.
461  */
462 struct nfs_public {
463 	int		np_valid;	/* Do we hold valid information */
464 	fhandle_t	np_handle;	/* Filehandle for pub fs (internal) */
465 	struct mount	*np_mount;	/* Mountpoint of exported fs */
466 	char		*np_index;	/* Index file */
467 };
468 
469 /*
470  * Filesystem configuration information. One of these exists for each
471  * type of filesystem supported by the kernel. These are searched at
472  * mount time to identify the requested filesystem.
473  */
474 struct vfsconf {
475 	struct	vfsops *vfc_vfsops;	/* filesystem operations vector */
476 	char	vfc_name[MFSNAMELEN];	/* filesystem type name */
477 	int	vfc_typenum;		/* historic filesystem type number */
478 	int	vfc_refcount;		/* number mounted of this type */
479 	int	vfc_flags;		/* permanent flags */
480 	STAILQ_ENTRY(vfsconf) vfc_next;	/* next in list */
481 };
482 
483 struct ovfsconf {
484 	void	*vfc_vfsops;
485 	char	vfc_name[32];
486 	int	vfc_index;
487 	int	vfc_refcount;
488 	int	vfc_flags;
489 };
490 
491 /*
492  * NB: these flags refer to IMPLEMENTATION properties, not properties of
493  * any actual mounts; i.e., it does not make sense to change the flags.
494  */
495 #define	VFCF_STATIC	0x00010000	/* statically compiled into kernel */
496 #define	VFCF_NETWORK	0x00020000	/* may get data over the network */
497 #define	VFCF_READONLY	0x00040000	/* writes are not implemented */
498 #define VFCF_SYNTHETIC	0x00080000	/* data does not represent real files */
499 #define	VFCF_LOOPBACK	0x00100000	/* aliases some other mounted FS */
500 #define	VFCF_UNICODE	0x00200000	/* stores file names as Unicode*/
501 #define VFCF_MPSAFE	0x00400000	/* VFS is fully MPSAFE */
502 
503 /* vfsquery flags */
504 #define VQ_NOTRESP	0x0001	/* server down */
505 #define VQ_NEEDAUTH	0x0002	/* server bad auth */
506 #define VQ_LOWDISK	0x0004	/* we're low on space */
507 #define VQ_MOUNT	0x0008	/* new filesystem arrived */
508 #define VQ_UNMOUNT	0x0010	/* filesystem has left */
509 #define VQ_DEAD		0x0020	/* filesystem is dead, needs force unmount */
510 #define VQ_ASSIST	0x0040	/* filesystem needs assistance from external
511 				   program */
512 #define VQ_NOTRESPLOCK	0x0080	/* server lockd down */
513 #define VQ_FLAG0100	0x0100	/* placeholder */
514 #define VQ_FLAG0200	0x0200	/* placeholder */
515 #define VQ_FLAG0400	0x0400	/* placeholder */
516 #define VQ_FLAG0800	0x0800	/* placeholder */
517 #define VQ_FLAG1000	0x1000	/* placeholder */
518 #define VQ_FLAG2000	0x2000	/* placeholder */
519 #define VQ_FLAG4000	0x4000	/* placeholder */
520 #define VQ_FLAG8000	0x8000	/* placeholder */
521 
522 #ifdef _KERNEL
523 
524 #ifdef MALLOC_DECLARE
525 MALLOC_DECLARE(M_MOUNT);
526 #endif
527 extern int nfs_mount_type;	/* vfc_typenum for nfs, or -1 */
528 
529 struct vfsconf *vfsconf_find_by_name(const char *);
530 struct vfsconf *vfsconf_find_by_typenum(int);
531 int vfsconf_get_maxtypenum(void);
532 int vfsconf_each(int (*)(struct vfsconf *, void *), void *);
533 
534 #endif
535 
536 #if defined(_KERNEL) || defined(_KERNEL_STRUCTURES)
537 
538 TAILQ_HEAD(mntlist, mount);	/* struct mntlist */
539 
540 /*
541  * Operations supported on mounted file system.
542  */
543 struct nlookupdata;
544 struct nlookupdata;
545 struct mbuf;
546 
547 typedef int vfs_mount_t(struct mount *mp, char *path, caddr_t data,
548 				    struct ucred *cred);
549 typedef int vfs_start_t(struct mount *mp, int flags);
550 typedef int vfs_unmount_t(struct mount *mp, int mntflags);
551 typedef int vfs_root_t(struct mount *mp, struct vnode **vpp);
552 typedef int vfs_quotactl_t(struct mount *mp, int cmds, uid_t uid, caddr_t arg,
553 				    struct ucred *cred);
554 typedef int vfs_statfs_t(struct mount *mp, struct statfs *sbp,
555 				    struct ucred *cred);
556 typedef int vfs_statvfs_t(struct mount *mp, struct statvfs *sbp,
557 				    struct ucred *cred);
558 typedef int vfs_sync_t(struct mount *mp, int waitfor);
559 typedef int vfs_vget_t(struct mount *mp, struct vnode *dvp,
560 				    ino_t ino, struct vnode **vpp);
561 typedef int vfs_fhtovp_t(struct mount *mp, struct vnode *rootvp,
562 				    struct fid *fhp, struct vnode **vpp);
563 typedef int vfs_checkexp_t(struct mount *mp, struct sockaddr *nam,
564 				    int *extflagsp, struct ucred **credanonp);
565 typedef int vfs_vptofh_t(struct vnode *vp, struct fid *fhp);
566 typedef int vfs_init_t(struct vfsconf *);
567 typedef int vfs_uninit_t(struct vfsconf *);
568 typedef int vfs_extattrctl_t(struct mount *mp, int cmd, struct vnode *vp,
569 		    int attrnamespace, const char *attrname,
570 		    struct ucred *cred);
571 typedef int vfs_acinit_t(struct mount *mp);
572 typedef void vfs_acdone_t(struct mount *mp);
573 typedef void vfs_account_t(struct mount *mp,
574 			uid_t uid, gid_t gid, int64_t delta);
575 typedef void vfs_ncpgen_set_t(struct mount *mp, struct namecache *ncp);
576 typedef int vfs_ncpgen_test_t(struct mount *mp, struct namecache *ncp);
577 typedef int vfs_modifying_t(struct mount *mp);
578 
579 int vfs_mount(struct mount *mp, char *path, caddr_t data, struct ucred *cred);
580 int vfs_start(struct mount *mp, int flags);
581 int vfs_unmount(struct mount *mp, int mntflags);
582 int vfs_root(struct mount *mp, struct vnode **vpp);
583 int vfs_quotactl(struct mount *mp, int cmds, uid_t uid, caddr_t arg,
584 				struct ucred *cred);
585 int vfs_statfs(struct mount *mp, struct statfs *sbp, struct ucred *cred);
586 int vfs_statvfs(struct mount *mp, struct statvfs *sbp, struct ucred *cred);
587 int vfs_sync(struct mount *mp, int waitfor);
588 int vfs_vget(struct mount *mp, struct vnode *dvp,
589 				ino_t ino, struct vnode **vpp);
590 int vfs_fhtovp(struct mount *mp, struct vnode *rootvp,
591 				struct fid *fhp, struct vnode **vpp);
592 int vfs_checkexp(struct mount *mp, struct sockaddr *nam,
593 				int *extflagsp, struct ucred **credanonp);
594 int vfs_vptofh(struct vnode *vp, struct fid *fhp);
595 int vfs_init(struct vfsconf *vfc);
596 int vfs_uninit(struct vfsconf *vfc, struct vfsconf *vfsp);
597 int vfs_extattrctl(struct mount *mp, int cmd, struct vnode *vp,
598 		    int attrnamespace, const char *attrname,
599 		    struct ucred *cred);
600 int vfs_modifying(struct mount *mp);
601 
602 struct vfsops {
603 	long		vfs_flags;
604 	vfs_mount_t 	*vfs_mount;
605 	vfs_start_t 	*vfs_start;
606 	vfs_unmount_t 	*vfs_unmount;
607 	vfs_root_t   	*vfs_root;
608 	vfs_quotactl_t 	*vfs_quotactl;
609 	vfs_statfs_t 	*vfs_statfs;
610 	vfs_sync_t   	*vfs_sync;
611 	vfs_vget_t  	*vfs_vget;
612 	vfs_fhtovp_t 	*vfs_fhtovp;
613 	vfs_checkexp_t 	*vfs_checkexp;
614 	vfs_vptofh_t 	*vfs_vptofh;
615 	vfs_init_t  	*vfs_init;
616 	vfs_uninit_t 	*vfs_uninit;
617 	vfs_extattrctl_t *vfs_extattrctl;
618 	vfs_statvfs_t 	*vfs_statvfs;
619 	vfs_acinit_t	*vfs_acinit;
620 	vfs_acdone_t	*vfs_acdone;
621 	vfs_account_t	*vfs_account;
622 	vfs_ncpgen_set_t	*vfs_ncpgen_set;
623 	vfs_ncpgen_test_t	*vfs_ncpgen_test;
624 	vfs_modifying_t	*vfs_modifying;
625 };
626 
627 #define VFSOPSF_NOSYNCERTHR	0x00000001
628 
629 #define VFS_MOUNT(MP, PATH, DATA, CRED)		\
630 	vfs_mount(MP, PATH, DATA, CRED)
631 #define VFS_START(MP, FLAGS)			\
632 	vfs_start(MP, FLAGS)
633 #define VFS_UNMOUNT(MP, FORCE)			\
634 	vfs_unmount(MP, FORCE)
635 #define VFS_ROOT(MP, VPP)			\
636 	vfs_root(MP, VPP)
637 #define VFS_QUOTACTL(MP, C, U, A, CRED)		\
638 	vfs_quotactl(MP, C, U, A, CRED)
639 #define VFS_STATFS(MP, SBP, CRED)		\
640 	vfs_statfs(MP, SBP, CRED)
641 #define VFS_STATVFS(MP, SBP, CRED)		\
642 	vfs_statvfs(MP, SBP, CRED)
643 #define VFS_SYNC(MP, WAIT)			\
644 	vfs_sync(MP, WAIT)
645 #define VFS_VGET(MP, DVP, INO, VPP)		\
646 	vfs_vget(MP, DVP, INO, VPP)
647 #define VFS_FHTOVP(MP, ROOTVP, FIDP, VPP) 	\
648 	vfs_fhtovp(MP, ROOTVP, FIDP, VPP)
649 #define	VFS_VPTOFH(VP, FIDP)			\
650 	vfs_vptofh(VP, FIDP)
651 #define VFS_CHECKEXP(MP, NAM, EXFLG, CRED)	\
652 	vfs_checkexp(MP, NAM, EXFLG, CRED)
653 #define VFS_EXTATTRCTL(MP, C, FVP, NS, N, CRED)	\
654 	vfs_extattrctl(MP, C, FVP, NS, N, CRED)
655 #define VFS_ACCOUNT(MP, U, G, D) \
656 	if ((MP->mnt_op->vfs_account != NULL) && (D != 0)) \
657 		MP->mnt_op->vfs_account(MP, U, G, D);
658 #define VFS_ACINIT(MP, ERROR) \
659 	if (vfs_quota_enabled && MP->mnt_op->vfs_acinit != NULL) \
660 		ERROR = MP->mnt_op->vfs_acinit(MP);
661 #define VFS_ACDONE(MP) \
662 	if (vfs_quota_enabled && MP->mnt_op->vfs_acdone != NULL) \
663 		MP->mnt_op->vfs_acdone(MP);
664 #define VFS_NCPGEN_SET(MP, NCP) \
665 	MP->mnt_op->vfs_ncpgen_set(MP, NCP)
666 #define VFS_NCPGEN_TEST(MP, NCP) \
667 	MP->mnt_op->vfs_ncpgen_test(MP, NCP)
668 #define VFS_MODIFYING(MP) \
669 	MP->mnt_op->vfs_modifying(MP)
670 
671 #endif
672 
673 #ifdef _KERNEL
674 
675 #include <sys/module.h>
676 
677 #define VFS_SET(vfsops, fsname, flags) \
678 	static struct vfsconf fsname ## _vfsconf = {		\
679 		&vfsops,					\
680 		#fsname,					\
681 		-1,						\
682 		0,						\
683 		flags,						\
684 		{ NULL },					\
685 	};							\
686 	static moduledata_t fsname ## _mod = {			\
687 		#fsname,					\
688 		vfs_modevent,					\
689 		& fsname ## _vfsconf				\
690 	};							\
691 	DECLARE_MODULE(fsname, fsname ## _mod, SI_SUB_VFS, SI_ORDER_MIDDLE)
692 
693 #endif
694 
695 #if defined(_KERNEL) || defined(_KERNEL_STRUCTURES)
696 
697 #include <net/radix.h>
698 
699 #define	AF_MAX		36	/* XXX */
700 
701 /*
702  * Network address lookup element
703  */
704 struct netcred {
705 	struct	radix_node netc_rnodes[2];
706 	int	netc_exflags;
707 	struct	ucred netc_anon;
708 };
709 
710 /*
711  * Network export information
712  */
713 struct netexport {
714 	struct	netcred ne_defexported;		/* Default export */
715 	struct	radix_node_head *ne_inethead;	/* IPv4 radix */
716 	struct	radix_node_head *ne_inet6head;	/* IPv6 radix */
717 	struct	radix_node_head *ne_maskhead;	/* Shared mask radix */
718 };
719 #define NE_LOCK(nep)		lwkt_getpooltoken(nep)
720 #define NE_UNLOCK(nep)		lwkt_relpooltoken(nep)
721 #define NE_ASSERT_LOCKED(nep)	\
722     ASSERT_LWKT_TOKEN_HELD(lwkt_token_pool_lookup(nep))
723 
724 #endif
725 
726 #ifdef _KERNEL
727 /*
728  * exported vnode operations
729  */
730 void	mount_hold(struct mount *);
731 void	mount_drop(struct mount *);
732 int	dounmount (struct mount *, int, int);
733 int	vfs_setpublicfs			    /* set publicly exported fs */
734 	  (struct mount *, struct netexport *, const struct export_args *);
735 int	vfs_lock (struct mount *);         /* lock a vfs */
736 void	vfs_msync (struct mount *, int);
737 void	vfs_unlock (struct mount *);       /* unlock a vfs */
738 int	vfs_busy (struct mount *, int);
739 int	vfs_export			    /* process mount export info */
740 	  (struct mount *, struct netexport *, const struct export_args *);
741 struct	netcred *vfs_export_lookup	    /* lookup host in fs export list */
742 	  (struct mount *, struct netexport *, struct sockaddr *);
743 int	vfs_allocate_syncvnode (struct mount *);
744 void	vfs_getnewfsid (struct mount *);
745 void	vfs_setfsid(struct mount *mp, fsid_t *template);
746 cdev_t	vfs_getrootfsid (struct mount *);
747 struct	mount *vfs_getvfs (fsid_t *);      /* return vfs given fsid */
748 int	vfs_modevent (module_t, int, void *);
749 int	vfs_mountedon (struct vnode *);    /* is a vfs mounted on vp */
750 int	vfs_rootmountalloc (char *, char *, struct mount **);
751 void	vfs_unbusy (struct mount *);
752 void	vfs_unmountall (int halting);
753 int	vfs_register (struct vfsconf *);
754 int	vfs_unregister (struct vfsconf *);
755 extern	struct nfs_public nfs_pub;
756 
757 /*
758  * Declarations for these vfs default operations are located in
759  * kern/vfs_default.c, they should be used instead of making "dummy"
760  * functions or casting entries in the VFS op table to "enopnotsupp()".
761  */
762 vfs_start_t 	vfs_stdstart;
763 vfs_root_t  	vfs_stdroot;
764 vfs_quotactl_t 	vfs_stdquotactl;
765 vfs_statfs_t  	vfs_stdstatfs;
766 vfs_statvfs_t  	vfs_stdstatvfs;
767 vfs_sync_t   	vfs_stdsync;
768 vfs_sync_t   	vfs_stdnosync;
769 vfs_vget_t  	vfs_stdvget;
770 vfs_fhtovp_t 	vfs_stdfhtovp;
771 vfs_checkexp_t 	vfs_stdcheckexp;
772 vfs_vptofh_t 	vfs_stdvptofh;
773 vfs_init_t  	vfs_stdinit;
774 vfs_uninit_t 	vfs_stduninit;
775 vfs_extattrctl_t vfs_stdextattrctl;
776 vfs_acinit_t	vfs_stdac_init;
777 vfs_acdone_t	vfs_stdac_done;
778 vfs_account_t	vfs_stdaccount;
779 vfs_account_t	vfs_noaccount;
780 vfs_ncpgen_set_t	vfs_stdncpgen_set;
781 vfs_ncpgen_test_t	vfs_stdncpgen_test;
782 vfs_modifying_t	vfs_stdmodifying;
783 
784 struct vop_access_args;
785 int vop_helper_access(struct vop_access_args *ap, uid_t ino_uid, gid_t ino_gid,
786 			mode_t ino_mode, u_int32_t ino_flags);
787 int vop_helper_setattr_flags(u_int32_t *ino_flags, u_int32_t vaflags,
788 			uid_t uid, struct ucred *cred);
789 uid_t vop_helper_create_uid(struct mount *mp, mode_t dmode, uid_t duid,
790 			struct ucred *cred, mode_t *modep);
791 int vop_helper_chmod(struct vnode *vp, mode_t new_mode, struct ucred *cred,
792 			uid_t cur_uid, gid_t cur_gid, mode_t *cur_modep);
793 int vop_helper_chown(struct vnode *vp, uid_t new_uid, gid_t new_gid,
794 			struct ucred *cred,
795 			uid_t *cur_uidp, gid_t *cur_gidp, mode_t *cur_modep);
796 int vop_helper_read_shortcut(struct vop_read_args *ap);
797 
798 void	add_bio_ops(struct bio_ops *ops);
799 void	rem_bio_ops(struct bio_ops *ops);
800 
801 int     journal_mountctl(struct vop_mountctl_args *ap);
802 void	journal_remove_all_journals(struct mount *mp, int flags);
803 
804 void	mountlist_insert(struct mount *, int);
805 int	mountlist_interlock(int (*callback)(struct mount *), struct mount *);
806 struct mount *mountlist_boot_getfirst(void);
807 void	mountlist_remove(struct mount *mp);
808 int	mountlist_exists(struct mount *mp);
809 int	mountlist_scan(int (*callback)(struct mount *, void *), void *, int);
810 struct mount *mount_get_by_nc(struct namecache *ncp);
811 #else /* !_KERNEL */
812 
813 #include <sys/cdefs.h>
814 
815 __BEGIN_DECLS
816 int	fstatfs (int, struct statfs *);
817 int	getfh (const char *, fhandle_t *);
818 int	getfsstat (struct statfs *, long, int);
819 int	getmntinfo (struct statfs **, int);
820 int	getmntvinfo (struct statfs **, struct statvfs **, int);
821 int	mount (const char *, const char *, int, void *);
822 int	statfs (const char *, struct statfs *);
823 int	unmount (const char *, int);
824 int	fhopen (const struct fhandle *, int);
825 int	fhstat (const struct fhandle *, struct stat *);
826 int	fhstatfs (const struct fhandle *, struct statfs *);
827 
828 /* C library stuff */
829 void	endvfsent (void);
830 struct	ovfsconf *getvfsbyname (const char *);
831 struct	ovfsconf *getvfsbytype (int);
832 struct	ovfsconf *getvfsent (void);
833 #define	getvfsbyname	new_getvfsbyname
834 int	new_getvfsbyname (const char *, struct vfsconf *);
835 void	setvfsent (int);
836 int	vfsisloadable (const char *);
837 int	vfsload (const char *);
838 __END_DECLS
839 
840 #endif /* _KERNEL */
841 
842 #endif /* !_SYS_MOUNT_H_ */
843 
844