VFS_MOUNT():

+ nameidata is a goner
  + document dlen (hi dsl!)
This commit is contained in:
pooka 2007-07-31 21:39:56 +00:00
parent a548cdc358
commit c7d9ec16a7
1 changed files with 22 additions and 18 deletions

View File

@ -1,4 +1,4 @@
.\" $NetBSD: vfsops.9,v 1.31 2007/06/20 16:35:52 pooka Exp $
.\" $NetBSD: vfsops.9,v 1.32 2007/07/31 21:39:56 pooka Exp $
.\"
.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -34,7 +34,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd June 20, 2007
.Dd July 31, 2007
.Dt VFSOPS 9
.Os
.Sh NAME
@ -57,8 +57,10 @@
.In sys/mount.h
.In sys/vnode.h
.Ft int
.Fn VFS_MOUNT "struct mount *mp" "const char *path" "void *data" \
"struct nameidata *ndp" "struct lwp *l"
.Fo VFS_MOUNT
.Fa "struct mount *mp" "const char *path" "void *data" "size_t *dlen"
.Fa "struct lwp *l"
.Fc
.Ft int
.Fn VFS_START "struct mount *mp" "int flags" "struct lwp *l"
.Ft int
@ -175,37 +177,39 @@ queried and modified using the
interface.
.Sh FUNCTIONS
.Bl -tag -width compact
.It Fn VFS_MOUNT "mp" "path" "data" "ndp" "l"
.It Fn VFS_MOUNT "mp" "path" "data" "dlen" "l"
Mount a file system specified by the mount structure
.Fa mp
on the mount point described by
.Fa path .
The argument
.Fa data
contains file system type specific data and is read into the kernel
using
.Xr copyin 9 .
contains file system type specific data, while the argument
.Fa dlen
points to a location specifying the length of the data.
The argument
.Fa ndp
contains the result of a
.Xr namei 9
call on the pathname of the mount point and
.Fa l
is the calling lwp.
.Pp
.Fn VFS_MOUNT
initialises the mount structure for the mounted file system.
This structure records mount-specific information for the file system and
records the list of vnodes associated with the file system.
This function is invoked both to mount new file systems and to change the
attributes of an existing file system.
If the MNT_UPDATE flag is set in
.Em mp-\*[Gt]mnt_flag
then the filesystem should update its internal state from the value of
.Em mp-\*[Gt]mnt_flag .
If the flag MNT_UPDATE is set in
.Em mp-\*[Gt]mnt_flag ,
the filesystem should update its state.
This can be used, for instance, to convert a read-only filesystem to
read-write.
If the MNT_UPDATE flag is not specified, then this is a newly
mounted filesystem.
The current attributes for a mounted file system can be fetched by
specifying
.Dv MNT_GETARGS .
If neither
.Dv MNT_UPDATE
or
.Dv MNT_GETARGS
are specified, a new file system will attempted to be mounted.
.It Fn VFS_START "mp" "flags" "l"
Make the file system specified by the mount structure
.Fa mp