xref: /dflybsd-src/sys/kern/vfs_mount.c (revision 53e987cee557d989dbf172d8a3c2ade9ea6fc46f)

/*
 * Copyright (c) 2004 The DragonFly Project.  All rights reserved.
 *
 * This code is derived from software contributed to The DragonFly Project
 * by Matthew Dillon <dillon@backplane.com>
 *
 * 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 DragonFly Project 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 COPYRIGHT HOLDERS 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
 * COPYRIGHT HOLDERS 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.
 *
 * Copyright (c) 1989, 1993
 *	The Regents of the University of California.  All rights reserved.
 * (c) UNIX System Laboratories, Inc.
 * All or some portions of this file are derived from material licensed
 * to the University of California by American Telephone and Telegraph
 * Co. or Unix System Laboratories, Inc. and are reproduced herein with
 * the permission of UNIX System Laboratories, Inc.
 *
 * 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. All advertising materials mentioning features or use of this software
 *    must display the following acknowledgement:
 *	This product includes software developed by the University of
 *	California, Berkeley and its contributors.
 * 4. 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.
 *
 * $DragonFly: src/sys/kern/vfs_mount.c,v 1.10 2005/04/20 17:01:50 dillon Exp $
 */

/*
 * External virtual filesystem routines
 */
#include "opt_ddb.h"

#include <sys/param.h>
#include <sys/systm.h>
#include <sys/kernel.h>
#include <sys/malloc.h>
#include <sys/mount.h>
#include <sys/proc.h>
#include <sys/vnode.h>
#include <sys/buf.h>
#include <sys/eventhandler.h>
#include <sys/kthread.h>
#include <sys/sysctl.h>

#include <machine/limits.h>

#include <sys/buf2.h>
#include <sys/thread2.h>

#include <vm/vm.h>
#include <vm/vm_object.h>

struct mountscan_info {
	TAILQ_ENTRY(mountscan_info) msi_entry;
	int msi_how;
	struct mount *msi_node;
};

struct vmntvnodescan_info {
	TAILQ_ENTRY(vmntvnodescan_info) entry;
	struct vnode *vp;
};

static int vnlru_nowhere = 0;
SYSCTL_INT(_debug, OID_AUTO, vnlru_nowhere, CTLFLAG_RD,
	    &vnlru_nowhere, 0,
	    "Number of times the vnlru process ran without success");


static struct lwkt_token mntid_token;

static struct mntlist mountlist = TAILQ_HEAD_INITIALIZER(mountlist);
static TAILQ_HEAD(,mountscan_info) mountscan_list;
static struct lwkt_token mountlist_token;
static TAILQ_HEAD(,vmntvnodescan_info) mntvnodescan_list;
struct lwkt_token mntvnode_token;

/*
 * Called from vfsinit()
 */
void
vfs_mount_init(void)
{
	lwkt_token_init(&mountlist_token);
	lwkt_token_init(&mntvnode_token);
	lwkt_token_init(&mntid_token);
	TAILQ_INIT(&mountscan_list);
	TAILQ_INIT(&mntvnodescan_list);
}

/*
 * Support function called with mntvnode_token held to remove a vnode
 * from the mountlist.  We must update any list scans which are in progress.
 */
static void
vremovevnodemnt(struct vnode *vp)
{
        struct vmntvnodescan_info *info;

	TAILQ_FOREACH(info, &mntvnodescan_list, entry) {
		if (info->vp == vp)
			info->vp = TAILQ_NEXT(vp, v_nmntvnodes);
	}
	TAILQ_REMOVE(&vp->v_mount->mnt_nvnodelist, vp, v_nmntvnodes);
}

/*
 * Support function called with mntvnode_token held to move a vnode to
 * the end of the list.
 */
static void
vmovevnodetoend(struct mount *mp, struct vnode *vp)
{
	vremovevnodemnt(vp);
	TAILQ_INSERT_TAIL(&mp->mnt_nvnodelist, vp, v_nmntvnodes);
}


/*
 * Allocate a new vnode and associate it with a tag, mount point, and
 * operations vector.
 *
 * A VX locked and refd vnode is returned.  The caller should setup the
 * remaining fields and vx_put() or, if he wishes to leave a vref,
 * vx_unlock() the vnode.
 */
int
getnewvnode(enum vtagtype tag, struct mount *mp,
		struct vnode **vpp, int lktimeout, int lkflags)
{
	struct vnode *vp;

	KKASSERT(mp != NULL);

	vp = allocvnode(lktimeout, lkflags);
	vp->v_tag = tag;
	vp->v_data = NULL;

	/*
	 * By default the vnode is assigned the mount point's normal
	 * operations vector.
	 */
	vp->v_ops = &mp->mnt_vn_use_ops;

	/*
	 * Placing the vnode on the mount point's queue makes it visible.
	 * VNON prevents it from being messed with, however.
	 */
	insmntque(vp, mp);
	vfs_object_create(vp, curthread);

	/*
	 * A VX locked & refd vnode is returned.
	 */
	*vpp = vp;
	return (0);
}

/*
 * This function creates vnodes with special operations vectors.  The
 * mount point is optional.
 *
 * This routine is being phased out.
 */
int
getspecialvnode(enum vtagtype tag, struct mount *mp,
		struct vop_ops **ops_pp,
		struct vnode **vpp, int lktimeout, int lkflags)
{
	struct vnode *vp;

	vp = allocvnode(lktimeout, lkflags);
	vp->v_tag = tag;
	vp->v_data = NULL;
	vp->v_ops = ops_pp;

	/*
	 * Placing the vnode on the mount point's queue makes it visible.
	 * VNON prevents it from being messed with, however.
	 */
	insmntque(vp, mp);
	vfs_object_create(vp, curthread);

	/*
	 * A VX locked & refd vnode is returned.
	 */
	*vpp = vp;
	return (0);
}

/*
 * Interlock against an unmount, return 0 on success, non-zero on failure.
 *
 * The passed flag may be 0 or LK_NOWAIT and is only used if an unmount
 * is in-progress.
 *
 * If no unmount is in-progress LK_NOWAIT is ignored.  No other flag bits
 * are used.  A shared locked will be obtained and the filesystem will not
 * be unmountable until the lock is released.
 */
int
vfs_busy(struct mount *mp, int flags, struct thread *td)
{
	int lkflags;

	if (mp->mnt_kern_flag & MNTK_UNMOUNT) {
		if (flags & LK_NOWAIT)
			return (ENOENT);
		/* XXX not MP safe */
		mp->mnt_kern_flag |= MNTK_MWAIT;
		/*
		 * Since all busy locks are shared except the exclusive
		 * lock granted when unmounting, the only place that a
		 * wakeup needs to be done is at the release of the
		 * exclusive lock at the end of dounmount.
		 */
		tsleep((caddr_t)mp, 0, "vfs_busy", 0);
		return (ENOENT);
	}
	lkflags = LK_SHARED | LK_NOPAUSE;
	if (lockmgr(&mp->mnt_lock, lkflags, NULL, td))
		panic("vfs_busy: unexpected lock failure");
	return (0);
}

/*
 * Free a busy filesystem.
 */
void
vfs_unbusy(struct mount *mp, struct thread *td)
{
	lockmgr(&mp->mnt_lock, LK_RELEASE, NULL, td);
}

/*
 * Lookup a filesystem type, and if found allocate and initialize
 * a mount structure for it.
 *
 * Devname is usually updated by mount(8) after booting.
 */
int
vfs_rootmountalloc(char *fstypename, char *devname, struct mount **mpp)
{
	struct thread *td = curthread;	/* XXX */
	struct vfsconf *vfsp;
	struct mount *mp;

	if (fstypename == NULL)
		return (ENODEV);
	for (vfsp = vfsconf; vfsp; vfsp = vfsp->vfc_next) {
		if (!strcmp(vfsp->vfc_name, fstypename))
			break;
	}
	if (vfsp == NULL)
		return (ENODEV);
	mp = malloc(sizeof(struct mount), M_MOUNT, M_WAITOK);
	bzero((char *)mp, (u_long)sizeof(struct mount));
	lockinit(&mp->mnt_lock, 0, "vfslock", VLKTIMEOUT, LK_NOPAUSE);
	vfs_busy(mp, LK_NOWAIT, td);
	TAILQ_INIT(&mp->mnt_nvnodelist);
	TAILQ_INIT(&mp->mnt_reservedvnlist);
	TAILQ_INIT(&mp->mnt_jlist);
	mp->mnt_nvnodelistsize = 0;
	mp->mnt_vfc = vfsp;
	mp->mnt_op = vfsp->vfc_vfsops;
	mp->mnt_flag = MNT_RDONLY;
	mp->mnt_vnodecovered = NULLVP;
	vfsp->vfc_refcount++;
	mp->mnt_iosize_max = DFLTPHYS;
	mp->mnt_stat.f_type = vfsp->vfc_typenum;
	mp->mnt_flag |= vfsp->vfc_flags & MNT_VISFLAGMASK;
	strncpy(mp->mnt_stat.f_fstypename, vfsp->vfc_name, MFSNAMELEN);
	copystr(devname, mp->mnt_stat.f_mntfromname, MNAMELEN - 1, 0);
	*mpp = mp;
	return (0);
}

/*
 * Lookup a mount point by filesystem identifier.
 */
struct mount *
vfs_getvfs(fsid_t *fsid)
{
	struct mount *mp;
	lwkt_tokref ilock;

	lwkt_gettoken(&ilock, &mountlist_token);
	TAILQ_FOREACH(mp, &mountlist, mnt_list) {
		if (mp->mnt_stat.f_fsid.val[0] == fsid->val[0] &&
		    mp->mnt_stat.f_fsid.val[1] == fsid->val[1]) {
			break;
	    }
	}
	lwkt_reltoken(&ilock);
	return (mp);
}

/*
 * Get a new unique fsid.  Try to make its val[0] unique, since this value
 * will be used to create fake device numbers for stat().  Also try (but
 * not so hard) make its val[0] unique mod 2^16, since some emulators only
 * support 16-bit device numbers.  We end up with unique val[0]'s for the
 * first 2^16 calls and unique val[0]'s mod 2^16 for the first 2^8 calls.
 *
 * Keep in mind that several mounts may be running in parallel.  Starting
 * the search one past where the previous search terminated is both a
 * micro-optimization and a defense against returning the same fsid to
 * different mounts.
 */
void
vfs_getnewfsid(struct mount *mp)
{
	static u_int16_t mntid_base;
	lwkt_tokref ilock;
	fsid_t tfsid;
	int mtype;

	lwkt_gettoken(&ilock, &mntid_token);
	mtype = mp->mnt_vfc->vfc_typenum;
	tfsid.val[1] = mtype;
	mtype = (mtype & 0xFF) << 24;
	for (;;) {
		tfsid.val[0] = makeudev(255,
		    mtype | ((mntid_base & 0xFF00) << 8) | (mntid_base & 0xFF));
		mntid_base++;
		if (vfs_getvfs(&tfsid) == NULL)
			break;
	}
	mp->mnt_stat.f_fsid.val[0] = tfsid.val[0];
	mp->mnt_stat.f_fsid.val[1] = tfsid.val[1];
	lwkt_reltoken(&ilock);
}

/*
 * This routine is called when we have too many vnodes.  It attempts
 * to free <count> vnodes and will potentially free vnodes that still
 * have VM backing store (VM backing store is typically the cause
 * of a vnode blowout so we want to do this).  Therefore, this operation
 * is not considered cheap.
 *
 * A number of conditions may prevent a vnode from being reclaimed.
 * the buffer cache may have references on the vnode, a directory
 * vnode may still have references due to the namei cache representing
 * underlying files, or the vnode may be in active use.   It is not
 * desireable to reuse such vnodes.  These conditions may cause the
 * number of vnodes to reach some minimum value regardless of what
 * you set kern.maxvnodes to.  Do not set kern.maxvnodes too low.
 */

/*
 * This is a quick non-blocking check to determine if the vnode is a good
 * candidate for being (eventually) vgone()'d.  Returns 0 if the vnode is
 * not a good candidate, 1 if it is.
 *
 * vnodes marked VFREE are already on the free list, but may still need
 * to be recycled due to eating namecache resources and potentially blocking
 * the namecache directory chain and related vnodes from being freed.
 */
static __inline int
vmightfree(struct vnode *vp, int page_count)
{
	if (vp->v_flag & VRECLAIMED)
		return (0);
	if ((vp->v_flag & VFREE) && TAILQ_EMPTY(&vp->v_namecache))
		return (0);
	if (vp->v_usecount != 0)
		return (0);
	if (vp->v_object && vp->v_object->resident_page_count >= page_count)
		return (0);
	return (1);
}

/*
 * The vnode was found to be possibly vgone()able and the caller has locked it
 * (thus the usecount should be 1 now).  Determine if the vnode is actually
 * vgone()able, doing some cleanups in the process.  Returns 1 if the vnode
 * can be vgone()'d, 0 otherwise.
 *
 * Note that v_holdcnt may be non-zero because (A) this vnode is not a leaf
 * in the namecache topology and (B) this vnode has buffer cache bufs.
 * We cannot remove vnodes with non-leaf namecache associations.  We do a
 * tentitive leaf check prior to attempting to flush out any buffers but the
 * 'real' test when all is said in done is that v_holdcnt must become 0 for
 * the vnode to be freeable.
 *
 * We could theoretically just unconditionally flush when v_holdcnt != 0,
 * but flushing data associated with non-leaf nodes (which are always
 * directories), just throws it away for no benefit.  It is the buffer
 * cache's responsibility to choose buffers to recycle from the cached
 * data point of view.
 */
static int
visleaf(struct vnode *vp)
{
	struct namecache *ncp;

	TAILQ_FOREACH(ncp, &vp->v_namecache, nc_vnode) {
		if (!TAILQ_EMPTY(&ncp->nc_list))
			return(0);
	}
	return(1);
}

/*
 * Try to clean up the vnode to the point where it can be vgone()'d, returning
 * 0 if it cannot be vgone()'d (or already has been), 1 if it can.  Unlike
 * vmightfree() this routine may flush the vnode and block.  Vnodes marked
 * VFREE are still candidates for vgone()ing because they may hold namecache
 * resources and could be blocking the namecache directory hierarchy (and
 * related vnodes) from being freed.
 */
static int
vtrytomakegoneable(struct vnode *vp, int page_count)
{
	if (vp->v_flag & VRECLAIMED)
		return (0);
	if (vp->v_usecount != 1)
		return (0);
	if (vp->v_object && vp->v_object->resident_page_count >= page_count)
		return (0);
	if (vp->v_holdcnt && visleaf(vp)) {
		vinvalbuf(vp, V_SAVE, NULL, 0, 0);
#if 0	/* DEBUG */
		printf((vp->v_holdcnt ? "vrecycle: vp %p failed: %s\n" :
			"vrecycle: vp %p succeeded: %s\n"), vp,
			(TAILQ_FIRST(&vp->v_namecache) ?
			    TAILQ_FIRST(&vp->v_namecache)->nc_name : "?"));
#endif
	}
	return(vp->v_usecount == 1 && vp->v_holdcnt == 0);
}

/*
 * Reclaim up to 1/10 of the vnodes associated with a mount point.  Try
 * to avoid vnodes which have lots of resident pages (we are trying to free
 * vnodes, not memory).
 *
 * This routine is a callback from the mountlist scan.  The mount point
 * in question will be busied.
 */
static int
vlrureclaim(struct mount *mp, void *data)
{
	struct vnode *vp;
	lwkt_tokref ilock;
	int done;
	int trigger;
	int usevnodes;
	int count;
	int trigger_mult = vnlru_nowhere;

	/*
	 * Calculate the trigger point for the resident pages check.  The
	 * minimum trigger value is approximately the number of pages in
	 * the system divded by the number of vnodes.  However, due to
	 * various other system memory overheads unrelated to data caching
	 * it is a good idea to double the trigger (at least).
	 *
	 * trigger_mult starts at 0.  If the recycler is having problems
	 * finding enough freeable vnodes it will increase trigger_mult.
	 * This should not happen in normal operation, even on machines with
	 * low amounts of memory, but extraordinary memory use by the system
	 * verses the amount of cached data can trigger it.
	 */
	usevnodes = desiredvnodes;
	if (usevnodes <= 0)
		usevnodes = 1;
	trigger = vmstats.v_page_count * (trigger_mult + 2) / usevnodes;

	done = 0;
	lwkt_gettoken(&ilock, &mntvnode_token);
	count = mp->mnt_nvnodelistsize / 10 + 1;
	while (count && (vp = TAILQ_FIRST(&mp->mnt_nvnodelist)) != NULL) {
		/*
		 * __VNODESCAN__
		 *
		 * The VP will stick around while we hold mntvnode_token,
		 * at least until we block, so we can safely do an initial
		 * check, and then must check again after we lock the vnode.
		 */
		if (vp->v_type == VNON ||	/* XXX */
		    vp->v_type == VBAD ||	/* XXX */
		    !vmightfree(vp, trigger)	/* critical path opt */
		) {
			vmovevnodetoend(mp, vp);
			--count;
			continue;
		}

		/*
		 * VX get the candidate vnode.  If the VX get fails the
		 * vnode might still be on the mountlist.  Our loop depends
		 * on us at least cycling the vnode to the end of the
		 * mountlist.
		 */
		if (vx_get_nonblock(vp) != 0) {
			if (vp->v_mount == mp)
				vmovevnodetoend(mp, vp);
			--count;
			continue;
		}

		/*
		 * Since we blocked locking the vp, make sure it is still
		 * a candidate for reclamation.  That is, it has not already
		 * been reclaimed and only has our VX reference associated
		 * with it.
		 */
		if (vp->v_type == VNON ||	/* XXX */
		    vp->v_type == VBAD ||	/* XXX */
		    (vp->v_flag & VRECLAIMED) ||
		    vp->v_mount != mp ||
		    !vtrytomakegoneable(vp, trigger)	/* critical path opt */
		) {
			if (vp->v_mount == mp)
				vmovevnodetoend(mp, vp);
			--count;
			vx_put(vp);
			continue;
		}

		/*
		 * All right, we are good, move the vp to the end of the
		 * mountlist and clean it out.  The vget will have returned
		 * an error if the vnode was destroyed (VRECLAIMED set), so we
		 * do not have to check again.  The vput() will move the
		 * vnode to the free list if the vgone() was successful.
		 */
		KKASSERT(vp->v_mount == mp);
		vmovevnodetoend(mp, vp);
		vgone(vp);
		vx_put(vp);
		++done;
		--count;
	}
	lwkt_reltoken(&ilock);
	return (done);
}

/*
 * Attempt to recycle vnodes in a context that is always safe to block.
 * Calling vlrurecycle() from the bowels of file system code has some
 * interesting deadlock problems.
 */
static struct thread *vnlruthread;
static int vnlruproc_sig;

void
vnlru_proc_wait(void)
{
	if (vnlruproc_sig == 0) {
		vnlruproc_sig = 1;      /* avoid unnecessary wakeups */
		wakeup(vnlruthread);
	}
	tsleep(&vnlruproc_sig, 0, "vlruwk", hz);
}

static void
vnlru_proc(void)
{
	struct thread *td = curthread;
	int done;
	int s;

	EVENTHANDLER_REGISTER(shutdown_pre_sync, shutdown_kproc, td,
	    SHUTDOWN_PRI_FIRST);

	s = splbio();
	for (;;) {
		kproc_suspend_loop();
		if (numvnodes - freevnodes <= desiredvnodes * 9 / 10) {
			vnlruproc_sig = 0;
			wakeup(&vnlruproc_sig);
			tsleep(td, 0, "vlruwt", hz);
			continue;
		}
		cache_cleanneg(0);
		done = mountlist_scan(vlrureclaim, NULL, MNTSCAN_FORWARD);

		/*
		 * The vlrureclaim() call only processes 1/10 of the vnodes
		 * on each mount.  If we couldn't find any repeat the loop
		 * at least enough times to cover all available vnodes before
		 * we start sleeping.  Complain if the failure extends past
		 * 30 second, every 30 seconds.
		 */
		if (done == 0) {
			++vnlru_nowhere;
			if (vnlru_nowhere % 10 == 0)
				tsleep(td, 0, "vlrup", hz * 3);
			if (vnlru_nowhere % 100 == 0)
				printf("vnlru_proc: vnode recycler stopped working!\n");
			if (vnlru_nowhere == 1000)
				vnlru_nowhere = 900;
		} else {
			vnlru_nowhere = 0;
		}
	}
	splx(s);
}

/*
 * MOUNTLIST FUNCTIONS
 */

/*
 * mountlist_insert (MP SAFE)
 *
 * Add a new mount point to the mount list.
 */
void
mountlist_insert(struct mount *mp, int how)
{
	lwkt_tokref ilock;

	lwkt_gettoken(&ilock, &mountlist_token);
	if (how == MNTINS_FIRST)
	    TAILQ_INSERT_HEAD(&mountlist, mp, mnt_list);
	else
	    TAILQ_INSERT_TAIL(&mountlist, mp, mnt_list);
	lwkt_reltoken(&ilock);
}

/*
 * mountlist_interlock (MP SAFE)
 *
 * Execute the specified interlock function with the mountlist token
 * held.  The function will be called in a serialized fashion verses
 * other functions called through this mechanism.
 */
int
mountlist_interlock(int (*callback)(struct mount *), struct mount *mp)
{
	lwkt_tokref ilock;
	int error;

	lwkt_gettoken(&ilock, &mountlist_token);
	error = callback(mp);
	lwkt_reltoken(&ilock);
	return (error);
}

/*
 * mountlist_boot_getfirst (DURING BOOT ONLY)
 *
 * This function returns the first mount on the mountlist, which is
 * expected to be the root mount.  Since no interlocks are obtained
 * this function is only safe to use during booting.
 */

struct mount *
mountlist_boot_getfirst(void)
{
	return(TAILQ_FIRST(&mountlist));
}

/*
 * mountlist_remove (MP SAFE)
 *
 * Remove a node from the mountlist.  If this node is the next scan node
 * for any active mountlist scans, the active mountlist scan will be
 * adjusted to skip the node, thus allowing removals during mountlist
 * scans.
 */
void
mountlist_remove(struct mount *mp)
{
	struct mountscan_info *msi;
	lwkt_tokref ilock;

	lwkt_gettoken(&ilock, &mountlist_token);
	TAILQ_FOREACH(msi, &mountscan_list, msi_entry) {
		if (msi->msi_node == mp) {
			if (msi->msi_how & MNTSCAN_FORWARD)
				msi->msi_node = TAILQ_NEXT(mp, mnt_list);
			else
				msi->msi_node = TAILQ_PREV(mp, mntlist, mnt_list);
		}
	}
	TAILQ_REMOVE(&mountlist, mp, mnt_list);
	lwkt_reltoken(&ilock);
}

/*
 * mountlist_scan (MP SAFE)
 *
 * Safely scan the mount points on the mount list.  Unless otherwise
 * specified each mount point will be busied prior to the callback and
 * unbusied afterwords.  The callback may safely remove any mount point
 * without interfering with the scan.  If the current callback
 * mount is removed the scanner will not attempt to unbusy it.
 *
 * If a mount node cannot be busied it is silently skipped.
 *
 * The callback return value is aggregated and a total is returned.  A return
 * value of < 0 is not aggregated and will terminate the scan.
 *
 * MNTSCAN_FORWARD	- the mountlist is scanned in the forward direction
 * MNTSCAN_REVERSE	- the mountlist is scanned in reverse
 * MNTSCAN_NOBUSY	- the scanner will make the callback without busying
 *			  the mount node.
 */
int
mountlist_scan(int (*callback)(struct mount *, void *), void *data, int how)
{
	struct mountscan_info info;
	lwkt_tokref ilock;
	struct mount *mp;
	thread_t td;
	int count;
	int res;

	lwkt_gettoken(&ilock, &mountlist_token);

	info.msi_how = how;
	info.msi_node = NULL;	/* paranoia */
	TAILQ_INSERT_TAIL(&mountscan_list, &info, msi_entry);

	res = 0;
	td = curthread;

	if (how & MNTSCAN_FORWARD) {
		info.msi_node = TAILQ_FIRST(&mountlist);
		while ((mp = info.msi_node) != NULL) {
			if (how & MNTSCAN_NOBUSY) {
				count = callback(mp, data);
			} else if (vfs_busy(mp, LK_NOWAIT, td) == 0) {
				count = callback(mp, data);
				if (mp == info.msi_node)
					vfs_unbusy(mp, td);
			} else {
				count = 0;
			}
			if (count < 0)
				break;
			res += count;
			if (mp == info.msi_node)
				info.msi_node = TAILQ_NEXT(mp, mnt_list);
		}
	} else if (how & MNTSCAN_REVERSE) {
		info.msi_node = TAILQ_LAST(&mountlist, mntlist);
		while ((mp = info.msi_node) != NULL) {
			if (how & MNTSCAN_NOBUSY) {
				count = callback(mp, data);
			} else if (vfs_busy(mp, LK_NOWAIT, td) == 0) {
				count = callback(mp, data);
				if (mp == info.msi_node)
					vfs_unbusy(mp, td);
			} else {
				count = 0;
			}
			if (count < 0)
				break;
			res += count;
			if (mp == info.msi_node)
				info.msi_node = TAILQ_PREV(mp, mntlist, mnt_list);
		}
	}
	TAILQ_REMOVE(&mountscan_list, &info, msi_entry);
	lwkt_reltoken(&ilock);
	return(res);
}

/*
 * MOUNT RELATED VNODE FUNCTIONS
 */

static struct kproc_desc vnlru_kp = {
	"vnlru",
	vnlru_proc,
	&vnlruthread
};
SYSINIT(vnlru, SI_SUB_KTHREAD_UPDATE, SI_ORDER_FIRST, kproc_start, &vnlru_kp)

/*
 * Move a vnode from one mount queue to another.
 */
void
insmntque(struct vnode *vp, struct mount *mp)
{
	lwkt_tokref ilock;

	lwkt_gettoken(&ilock, &mntvnode_token);
	/*
	 * Delete from old mount point vnode list, if on one.
	 */
	if (vp->v_mount != NULL) {
		KASSERT(vp->v_mount->mnt_nvnodelistsize > 0,
			("bad mount point vnode list size"));
		vremovevnodemnt(vp);
		vp->v_mount->mnt_nvnodelistsize--;
	}
	/*
	 * Insert into list of vnodes for the new mount point, if available.
	 */
	if ((vp->v_mount = mp) == NULL) {
		lwkt_reltoken(&ilock);
		return;
	}
	TAILQ_INSERT_TAIL(&mp->mnt_nvnodelist, vp, v_nmntvnodes);
	mp->mnt_nvnodelistsize++;
	lwkt_reltoken(&ilock);
}


/*
 * Scan the vnodes under a mount point and issue appropriate callbacks.
 *
 * The fastfunc() callback is called with just the mountlist token held
 * (no vnode lock).  It may not block and the vnode may be undergoing
 * modifications while the caller is processing it.  The vnode will
 * not be entirely destroyed, however, due to the fact that the mountlist
 * token is held.  A return value < 0 skips to the next vnode without calling
 * the slowfunc(), a return value > 0 terminates the loop.
 *
 * The slowfunc() callback is called after the vnode has been successfully
 * locked based on passed flags.  The vnode is skipped if it gets rearranged
 * or destroyed while blocking on the lock.  A non-zero return value from
 * the slow function terminates the loop.  The slow function is allowed to
 * arbitrarily block.  The scanning code guarentees consistency of operation
 * even if the slow function deletes or moves the node, or blocks and some
 * other thread deletes or moves the node.
 */
int
vmntvnodescan(
    struct mount *mp,
    int flags,
    int (*fastfunc)(struct mount *mp, struct vnode *vp, void *data),
    int (*slowfunc)(struct mount *mp, struct vnode *vp, void *data),
    void *data
) {
	struct vmntvnodescan_info info;
	lwkt_tokref ilock;
	struct vnode *vp;
	int r = 0;
	int maxcount = 1000000;

	lwkt_gettoken(&ilock, &mntvnode_token);

	info.vp = TAILQ_FIRST(&mp->mnt_nvnodelist);
	TAILQ_INSERT_TAIL(&mntvnodescan_list, &info, entry);
	while ((vp = info.vp) != NULL) {
		if (--maxcount == 0)
			panic("maxcount reached during vmntvnodescan");

		if (vp->v_type == VNON)		/* visible but not ready */
			goto next;
		KKASSERT(vp->v_mount == mp);

		/*
		 * Quick test.  A negative return continues the loop without
		 * calling the slow test.  0 continues onto the slow test.
		 * A positive number aborts the loop.
		 */
		if (fastfunc) {
			if ((r = fastfunc(mp, vp, data)) < 0)
				goto next;
			if (r)
				break;
		}

		/*
		 * Get a vxlock on the vnode, retry if it has moved or isn't
		 * in the mountlist where we expect it.
		 */
		if (slowfunc) {
			int error;

			switch(flags) {
			case VMSC_GETVP:
				error = vget(vp, LK_EXCLUSIVE, curthread);
				break;
			case VMSC_GETVP|VMSC_NOWAIT:
				error = vget(vp, LK_EXCLUSIVE|LK_NOWAIT,
						curthread);
				break;
			case VMSC_GETVX:
				error = vx_get(vp);
				break;
			case VMSC_REFVP:
				vref(vp);
				/* fall through */
			default:
				error = 0;
				break;
			}
			if (error)
				goto next;
			/*
			 * Do not call the slow function if the vnode is
			 * invalid or if it was ripped out from under us
			 * while we (potentially) blocked.
			 */
			if (info.vp == vp && vp->v_type != VNON)
				r = slowfunc(mp, vp, data);

			/*
			 * Cleanup
			 */
			switch(flags) {
			case VMSC_GETVP:
			case VMSC_GETVP|VMSC_NOWAIT:
				vput(vp);
				break;
			case VMSC_GETVX:
				vx_put(vp);
				break;
			case VMSC_REFVP:
				vrele(vp);
				/* fall through */
			default:
				break;
			}
			if (r != 0)
				break;
		}

		/*
		 * Iterate.  If the vnode was ripped out from under us
		 * info.vp will already point to the next vnode, otherwise
		 * we have to obtain the next valid vnode ourselves.
		 */
next:
		if (info.vp == vp)
			info.vp = TAILQ_NEXT(vp, v_nmntvnodes);
	}
	TAILQ_REMOVE(&mntvnodescan_list, &info, entry);
	lwkt_reltoken(&ilock);
	return(r);
}

/*
 * Remove any vnodes in the vnode table belonging to mount point mp.
 *
 * If FORCECLOSE is not specified, there should not be any active ones,
 * return error if any are found (nb: this is a user error, not a
 * system error). If FORCECLOSE is specified, detach any active vnodes
 * that are found.
 *
 * If WRITECLOSE is set, only flush out regular file vnodes open for
 * writing.
 *
 * SKIPSYSTEM causes any vnodes marked VSYSTEM to be skipped.
 *
 * `rootrefs' specifies the base reference count for the root vnode
 * of this filesystem. The root vnode is considered busy if its
 * v_usecount exceeds this value. On a successful return, vflush()
 * will call vrele() on the root vnode exactly rootrefs times.
 * If the SKIPSYSTEM or WRITECLOSE flags are specified, rootrefs must
 * be zero.
 */
#ifdef DIAGNOSTIC
static int busyprt = 0;		/* print out busy vnodes */
SYSCTL_INT(_debug, OID_AUTO, busyprt, CTLFLAG_RW, &busyprt, 0, "");
#endif

static int vflush_scan(struct mount *mp, struct vnode *vp, void *data);

struct vflush_info {
	int flags;
	int busy;
	thread_t td;
};

int
vflush(struct mount *mp, int rootrefs, int flags)
{
	struct thread *td = curthread;	/* XXX */
	struct vnode *rootvp = NULL;
	int error;
	struct vflush_info vflush_info;

	if (rootrefs > 0) {
		KASSERT((flags & (SKIPSYSTEM | WRITECLOSE)) == 0,
		    ("vflush: bad args"));
		/*
		 * Get the filesystem root vnode. We can vput() it
		 * immediately, since with rootrefs > 0, it won't go away.
		 */
		if ((error = VFS_ROOT(mp, &rootvp)) != 0)
			return (error);
		vput(rootvp);
	}

	vflush_info.busy = 0;
	vflush_info.flags = flags;
	vflush_info.td = td;
	vmntvnodescan(mp, VMSC_GETVX, NULL, vflush_scan, &vflush_info);

	if (rootrefs > 0 && (flags & FORCECLOSE) == 0) {
		/*
		 * If just the root vnode is busy, and if its refcount
		 * is equal to `rootrefs', then go ahead and kill it.
		 */
		KASSERT(vflush_info.busy > 0, ("vflush: not busy"));
		KASSERT(rootvp->v_usecount >= rootrefs, ("vflush: rootrefs"));
		if (vflush_info.busy == 1 && rootvp->v_usecount == rootrefs) {
			if (vx_lock(rootvp) == 0) {
				vgone(rootvp);
				vx_unlock(rootvp);
				vflush_info.busy = 0;
			}
		}
	}
	if (vflush_info.busy)
		return (EBUSY);
	for (; rootrefs > 0; rootrefs--)
		vrele(rootvp);
	return (0);
}

/*
 * The scan callback is made with an VX locked vnode.
 */
static int
vflush_scan(struct mount *mp, struct vnode *vp, void *data)
{
	struct vflush_info *info = data;
	struct vattr vattr;

	/*
	 * Skip over a vnodes marked VSYSTEM.
	 */
	if ((info->flags & SKIPSYSTEM) && (vp->v_flag & VSYSTEM)) {
		return(0);
	}

	/*
	 * If WRITECLOSE is set, flush out unlinked but still open
	 * files (even if open only for reading) and regular file
	 * vnodes open for writing.
	 */
	if ((info->flags & WRITECLOSE) &&
	    (vp->v_type == VNON ||
	    (VOP_GETATTR(vp, &vattr, info->td) == 0 &&
	    vattr.va_nlink > 0)) &&
	    (vp->v_writecount == 0 || vp->v_type != VREG)) {
		return(0);
	}

	/*
	 * With v_usecount == 0, all we need to do is clear out the
	 * vnode data structures and we are done.
	 */
	if (vp->v_usecount == 1) {
		vgone(vp);
		return(0);
	}

	/*
	 * If FORCECLOSE is set, forcibly close the vnode. For block
	 * or character devices, revert to an anonymous device. For
	 * all other files, just kill them.
	 */
	if (info->flags & FORCECLOSE) {
		if (vp->v_type != VBLK && vp->v_type != VCHR) {
			vgone(vp);
		} else {
			vclean(vp, 0, info->td);
			vp->v_ops = &spec_vnode_vops;
			insmntque(vp, NULL);
		}
		return(0);
	}
#ifdef DIAGNOSTIC
	if (busyprt)
		vprint("vflush: busy vnode", vp);
#endif
	++info->busy;
	return(0);
}