diff options
author | tjr <tjr@FreeBSD.org> | 2004-03-16 09:45:38 +0000 |
---|---|---|
committer | tjr <tjr@FreeBSD.org> | 2004-03-16 09:45:38 +0000 |
commit | 48661b2fa34872b8ba4b85490659dffdd64ca4eb (patch) | |
tree | 60b6afa6360a576f5604b261cb4bd93b2bbb0862 /lib/libc/sys/mount.2 | |
parent | 5fb6c2e59a903622a747f6f9f728dab4a8597747 (diff) | |
download | FreeBSD-src-48661b2fa34872b8ba4b85490659dffdd64ca4eb.zip FreeBSD-src-48661b2fa34872b8ba4b85490659dffdd64ca4eb.tar.gz |
Add fairly minimal documentation for the nmount() syscall.
Diffstat (limited to 'lib/libc/sys/mount.2')
-rw-r--r-- | lib/libc/sys/mount.2 | 36 |
1 files changed, 34 insertions, 2 deletions
diff --git a/lib/libc/sys/mount.2 b/lib/libc/sys/mount.2 index 58094f2..42a5bb1 100644 --- a/lib/libc/sys/mount.2 +++ b/lib/libc/sys/mount.2 @@ -32,11 +32,12 @@ .\" @(#)mount.2 8.3 (Berkeley) 5/24/95 .\" $FreeBSD$ .\" -.Dd September 8, 2003 +.Dd March 16, 2004 .Dt MOUNT 2 .Os .Sh NAME .Nm mount , +.Nm nmount , .Nm unmount .Nd mount or dismount a file system .Sh LIBRARY @@ -48,6 +49,9 @@ .Fn mount "const char *type" "const char *dir" "int flags" "void *data" .Ft int .Fn unmount "const char *dir" "int flags" +.In sys/uio.h +.Ft int +.Fn nmount "struct iovec *iov" "u_int niov" "int flags" .Sh DESCRIPTION The .Fn mount @@ -74,6 +78,32 @@ at the time of a successful mount are swept under the carpet so to speak, and are unavailable until the file system is unmounted. .Pp +The +.Fn nmount +system call behaves similarly to +.Fn mount , +except that the mount options (filesystem type name, device to mount, +mount-point name, etc.) are passed as an array of name-value pairs +in the array +.Fa iov , +containing +.Fa niov +elements. +The following options are required by all filesystems: +.Bl -item -offset indent -compact +.It +.Li fstype Ta filesystem type name (e.g. Dq Li procfs ) +.It +.Li fspath Ta mount point pathname (e.g. Dq Li /proc ) +.El +.Pp +Depending on the filesystem type, other options may be +recognized or required; +for example, most disk-based filesystems require a +.Dq Li from +option containing the pathname of a special device +in addition to the options listed above. +.Pp By default only the super-user may call the .Fn mount system call. @@ -204,7 +234,9 @@ The file system that has the specified file system ID will be unmounted. .Sh ERRORS The .Fn mount -system call will fail when one of the following occurs: +and +.Fn nmount +system calls will fail when one of the following occurs: .Bl -tag -width Er .It Bq Er EPERM The caller is neither the super-user nor the owner of |