[src/trunk]: src/share/man/man9 Update the description of vfs_busy() and vfs_...

[hannken <hannken%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/2f8b20de6c39
branches:  trunk
changeset: 326914:2f8b20de6c39
user:      hannken <hannken%NetBSD.org@localhost>
date:      Sat Feb 22 10:05:54 2014 +0000

description:
Update the description of vfs_busy() and vfs_unbusy().

diffstat:

 share/man/man9/vfssubr.9 |  43 ++++++++++++++++++++++++++++++++-----------
 1 files changed, 32 insertions(+), 11 deletions(-)

diffs (76 lines):

diff -r 5e9b4ae84407 -r 2f8b20de6c39 share/man/man9/vfssubr.9
--- a/share/man/man9/vfssubr.9  Sat Feb 22 08:53:33 2014 +0000
+++ b/share/man/man9/vfssubr.9  Sat Feb 22 10:05:54 2014 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: vfssubr.9,v 1.20 2010/12/02 12:54:13 wiz Exp $
+.\"     $NetBSD: vfssubr.9,v 1.21 2014/02/22 10:05:54 hannken Exp $
 .\"
 .\" Copyright (c) 2003, 2005, 2006 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd May 9, 2009
+.Dd February 22, 2014
 .Dt VFSSUBR 9
 .Os
 .Sh NAME
@@ -74,9 +74,9 @@
 .Ft void
 .Fn vfs_unmountall  "struct lwp *l"
 .Ft int
-.Fn vfs_busy "struct mount *mp" "int flags" "struct simplelock *interlkp"
+.Fn vfs_busy "struct mount *mp" "struct mount **nextp"
 .Ft void
-.Fn vfs_unbusy "struct mount *mp"
+.Fn vfs_unbusy "struct mount *mp" "bool keepref" "struct mount **nextp"
 .Ft struct mount *
 .Fn vfs_mountalloc "struct vfsops *vfs" "struct vnode *vp"
 .Ft int
@@ -130,17 +130,38 @@
 Mount the root file system.
 .It Fn vfs_unmountall "l"
 Unmount all file systems.
-.It Fn vfs_busy "mp" "flags" "interlkp"
+.It Fn vfs_busy "mp" "nextp"
 Mark the mount point specified by
 .Fa mp
-as busy.
+as busy and get a reference to it.
 This function is used to synchronize access and to delay unmounting.
-The interlock specified by argument
-.Fa interlkp
-is not released on failure.
-.It Fn vfs_unbusy "mp"
-Free the busy file system specified by the mount structure
+The caller must hold a pre-existing reference to the mount.
+If
+.Fa nextp
+is not NULL, the caller must hold the
+.Em mountlist_lock
+and
+.Fa nextp
+will receive the next mount from mount list on error.
+The
+.Em mountlist_lock
+is released on return.
+.It Fn vfs_unbusy "mp" "keepref" "nextp"
+Undo a
+.Fn vfs_busy
+on the mount point specified by
 .Fa mp .
+If
+.Fa keepref
+is true, preserve the reference added by
+.Fn vfs_busy .
+If
+.Fa nextp
+is not NULL, the
+.Em mountlist_lock
+will be aquired and
+.Fa nextp
+will receive the next mount from mount list.
 .It Fn vfs_mountalloc "vfsops" "vp"
 Allocate and initialise a mount structure, setting
 .Em mnt_vnodecovered