summaryrefslogtreecommitdiff
path: root/usr/src/man/man2/mount.2
diff options
context:
space:
mode:
Diffstat (limited to 'usr/src/man/man2/mount.2')
-rw-r--r--usr/src/man/man2/mount.250
1 files changed, 1 insertions, 49 deletions
diff --git a/usr/src/man/man2/mount.2 b/usr/src/man/man2/mount.2
index 8eb7428e26..1e6aec0e18 100644
--- a/usr/src/man/man2/mount.2
+++ b/usr/src/man/man2/mount.2
@@ -3,7 +3,7 @@
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
-.TH mount 2 "26 Feb 2004" "SunOS 5.11" "System Calls"
+.TH MOUNT 2 "Feb 26, 2004"
.SH NAME
mount \- mount a file system
.SH SYNOPSIS
@@ -66,12 +66,10 @@ The \fImflag\fR argument is constructed by a bitwise-inclusive-OR of flags from
the following list, defined in <\fBsys/mount.h\fR>.
.sp
.ne 2
-.mk
.na
\fB\fBMS_DATA\fR\fR
.ad
.RS 16n
-.rt
The \fIdataptr\fR and \fIdatalen\fR arguments describe a block of file
system-specific binary data at address \fIdataptr\fR of length \fIdatalen\fR.
This is interpreted by file system-specific code within the operating system
@@ -82,24 +80,20 @@ type does not require this data, \fIdataptr\fR and \fIdatalen\fR should both be
.sp
.ne 2
-.mk
.na
\fB\fBMS_GLOBAL\fR\fR
.ad
.RS 16n
-.rt
Mount a file system globally if the system is configured and booted as part of
a cluster (see \fBclinfo\fR(1M)).
.RE
.sp
.ne 2
-.mk
.na
\fB\fBMS_NOSUID\fR\fR
.ad
.RS 16n
-.rt
Prevent programs that are marked set-user-\fBID\fR or set-group-\fBID\fR from
executing (see \fBchmod\fR(1)). It also causes \fBopen\fR(2) to return
\fBENXIO\fR when attempting to open block or character special files.
@@ -107,12 +101,10 @@ executing (see \fBchmod\fR(1)). It also causes \fBopen\fR(2) to return
.sp
.ne 2
-.mk
.na
\fB\fBMS_OPTIONSTR\fR\fR
.ad
.RS 16n
-.rt
The \fIoptptr\fR and \fIoptlen\fR arguments describe a character buffer at
address \fIoptptr\fR of size \fIoptlen\fR. When calling \fBmount()\fR, the
character buffer should contain a null-terminated string of options to be
@@ -132,12 +124,10 @@ be returned in the recognized options list that is returned.
.sp
.ne 2
-.mk
.na
\fB\fBMS_OVERLAY\fR\fR
.ad
.RS 16n
-.rt
Allow the file system to be mounted over an existing file system mounted on
\fIdir\fR, making the underlying file system inaccessible. If a mount is
attempted on a pre-existing mount point without setting this flag, the mount
@@ -146,12 +136,10 @@ will fail.
.sp
.ne 2
-.mk
.na
\fB\fBMS_RDONLY\fR\fR
.ad
.RS 16n
-.rt
Mount the file system for reading only. This flag should also be specified for
file systems that are incapable of writing (for example, CDROM). Without this
flag, writing is permitted according to individual file accessibility.
@@ -159,12 +147,10 @@ flag, writing is permitted according to individual file accessibility.
.sp
.ne 2
-.mk
.na
\fB\fBMS_REMOUNT\fR\fR
.ad
.RS 16n
-.rt
Remount a read-only file system as read-write.
.RE
@@ -179,12 +165,10 @@ returned and \fBerrno\fR is set to indicate the error.
The \fBmount()\fR function will fail if:
.sp
.ne 2
-.mk
.na
\fB\fBEACCES\fR\fR
.ad
.RS 16n
-.rt
The permission bits of the mount point do not permit read/write access or
search permission is denied on a component of the path prefix.
.sp
@@ -199,12 +183,10 @@ mounts or read-write access in the case of read/write mounts.
.sp
.ne 2
-.mk
.na
\fB\fBEBUSY\fR\fR
.ad
.RS 16n
-.rt
The \fIdir\fR argument is currently mounted on, is someone's current working
directory, or is otherwise busy; or the device associated with \fIspec\fR is
currently mounted.
@@ -212,48 +194,40 @@ currently mounted.
.sp
.ne 2
-.mk
.na
\fB\fBEFAULT\fR\fR
.ad
.RS 16n
-.rt
The \fIspec\fR, \fIdir\fR, \fIfstype\fR, \fIdataptr\fR, or \fIoptptr\fR
argument points outside the allocated address space of the process.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBEINVAL\fR\fR
.ad
.RS 16n
-.rt
The super block has an invalid magic number, the \fIfstype\fR is invalid, or
\fIdir\fR is not an absolute path.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBELOOP\fR\fR
.ad
.RS 16n
-.rt
Too many symbolic links were encountered in translating \fIspec\fR or
\fIdir\fR.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBENAMETOOLONG\fR\fR
.ad
.RS 16n
-.rt
The length of the \fIpath\fR argument exceeds \fIPATH_MAX\fR, or the length of
a \fIpath\fR component exceeds \fINAME_MAX\fR while \fB_POSIX_NO_TRUNC\fR is in
effect.
@@ -261,70 +235,58 @@ effect.
.sp
.ne 2
-.mk
.na
\fB\fBENOENT\fR\fR
.ad
.RS 16n
-.rt
None of the named files exists or is a null pathname.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBENOLINK\fR\fR
.ad
.RS 16n
-.rt
The \fIpath\fR argument points to a remote machine and the link to that machine
is no longer active.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBENOSPC\fR\fR
.ad
.RS 16n
-.rt
The file system state in the super-block is not \fBFsOKAY\fR and \fImflag\fR
requests write permission.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBENOTBLK\fR\fR
.ad
.RS 16n
-.rt
The \fIspec\fR argument is not a block special device.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBENOTDIR\fR\fR
.ad
.RS 16n
-.rt
The \fIdir\fR argument is not a directory, or a component of a path prefix is
not a directory.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBENOTSUP\fR\fR
.ad
.RS 16n
-.rt
A global mount is attempted (the \fBMS_GLOBAL\fR flag is set in \fImflag\fR) on
a machine which is not booted as a cluster; a local mount is attempted and
\fIdir\fR is within a globally mounted file system; or a remount was attempted
@@ -333,58 +295,48 @@ on a file system that does not support remounting.
.sp
.ne 2
-.mk
.na
\fB\fBENXIO\fR\fR
.ad
.RS 16n
-.rt
The device associated with \fIspec\fR does not exist.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBEOVERFLOW\fR\fR
.ad
.RS 16n
-.rt
The length of the option string to be returned in the \fIoptptr\fR argument
exceeds the size of the buffer specified by \fIoptlen\fR.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBEPERM\fR\fR
.ad
.RS 16n
-.rt
The {\fBPRIV_SYS_MOUNT\fR} privilege is not asserted in the effective set of
the calling process.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBEREMOTE\fR\fR
.ad
.RS 16n
-.rt
The \fIspec\fR argument is remote and cannot be mounted.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBEROFS\fR\fR
.ad
.RS 16n
-.rt
The \fIspec\fR argument is write protected and \fImflag\fR requests write
permission.
.RE