2004-11-03 13:51:07 +00:00
|
|
|
.\" Hey Emacs! This file is -*- nroff -*- source.
|
|
|
|
.\"
|
|
|
|
.\" Copyright (C) 1993 Rickard E. Faith <faith@cs.unc.edu>
|
2006-05-22 23:52:24 +00:00
|
|
|
.\" and Copyright (C) 1994 Andries E. Brouwer <aeb@cwi.nl>
|
2007-09-20 06:52:22 +00:00
|
|
|
.\" and Copyright (C) 2002, 2005 Michael Kerrisk <mtk.manpages@gmail.com>
|
2004-11-03 13:51:07 +00:00
|
|
|
.\"
|
|
|
|
.\" Permission is granted to make and distribute verbatim copies of this
|
|
|
|
.\" manual provided the copyright notice and this permission notice are
|
|
|
|
.\" preserved on all copies.
|
|
|
|
.\"
|
|
|
|
.\" Permission is granted to copy and distribute modified versions of this
|
|
|
|
.\" manual under the conditions for verbatim copying, provided that the
|
|
|
|
.\" entire resulting derived work is distributed under the terms of a
|
|
|
|
.\" permission notice identical to this one.
|
2007-04-12 22:42:49 +00:00
|
|
|
.\"
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" Since the Linux kernel and libraries are constantly changing, this
|
|
|
|
.\" manual page may be incorrect or out-of-date. The author(s) assume no
|
|
|
|
.\" responsibility for errors or omissions, or for damages resulting from
|
|
|
|
.\" the use of the information contained herein. The author(s) may not
|
|
|
|
.\" have taken the same level of care in the production of this manual,
|
|
|
|
.\" which is licensed free of charge, as they might when working
|
|
|
|
.\" professionally.
|
2007-04-12 22:42:49 +00:00
|
|
|
.\"
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" Formatted or processed versions of this manual, if unaccompanied by
|
|
|
|
.\" the source, must acknowledge the copyright and authors of this work.
|
|
|
|
.\"
|
|
|
|
.\" Modified 1996-11-04 by Eric S. Raymond <esr@thyrsus.com>
|
2007-09-20 06:52:22 +00:00
|
|
|
.\" Modified 2001-10-13 by Michael Kerrisk <mtk.manpages@gmail.com>
|
2007-06-08 09:56:56 +00:00
|
|
|
.\" Added note on historical behavior of MS_NOSUID
|
2007-09-20 06:52:22 +00:00
|
|
|
.\" Modified 2002-05-16 by Michael Kerrisk <mtk.manpages@gmail.com>
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" Extensive changes and additions
|
|
|
|
.\" Modified 2002-05-27 by aeb
|
2007-09-20 06:52:22 +00:00
|
|
|
.\" Modified 2002-06-11 by Michael Kerrisk <mtk.manpages@gmail.com>
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" Enhanced descriptions of MS_MOVE, MS_BIND, and MS_REMOUNT
|
2007-09-20 06:52:22 +00:00
|
|
|
.\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com>
|
2005-05-18 14:34:43 +00:00
|
|
|
.\" 2005-05-18, mtk, Added MNT_EXPIRE, plus a few other tidy-ups.
|
2008-10-06 12:07:03 +00:00
|
|
|
.\" 2008-10-06, mtk: move umount*() material into separate umount.2 page.
|
|
|
|
.\" 2008-10-06, mtk: Add discussion of namespaces.
|
2004-11-03 13:51:07 +00:00
|
|
|
.\"
|
2012-01-18 10:23:51 +00:00
|
|
|
.TH MOUNT 2 2012-01-18 "Linux" "Linux Programmer's Manual"
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH NAME
|
2008-10-06 11:09:26 +00:00
|
|
|
mount \- mount file system
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH SYNOPSIS
|
2006-04-25 06:09:55 +00:00
|
|
|
.nf
|
2004-11-03 13:51:07 +00:00
|
|
|
.B "#include <sys/mount.h>"
|
|
|
|
.sp
|
|
|
|
.BI "int mount(const char *" source ", const char *" target ,
|
2006-04-25 06:09:55 +00:00
|
|
|
.BI " const char *" filesystemtype ", unsigned long " mountflags ,
|
|
|
|
.BI " const void *" data );
|
|
|
|
.fi
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH DESCRIPTION
|
2005-10-19 06:54:38 +00:00
|
|
|
.BR mount ()
|
2008-03-19 07:26:08 +00:00
|
|
|
attaches the file system specified by
|
2004-11-03 13:51:07 +00:00
|
|
|
.I source
|
|
|
|
(which is often a device name, but can also be a directory name
|
|
|
|
or a dummy) to the directory specified by
|
|
|
|
.IR target .
|
|
|
|
|
|
|
|
Appropriate privilege (Linux: the
|
|
|
|
.B CAP_SYS_ADMIN
|
2008-10-06 11:09:26 +00:00
|
|
|
capability) is required to mount file systems.
|
2004-11-03 13:51:07 +00:00
|
|
|
|
2008-03-19 07:26:08 +00:00
|
|
|
Since Linux 2.4 a single file system can be visible at
|
2004-11-03 13:51:07 +00:00
|
|
|
multiple mount points, and multiple mounts can be stacked
|
|
|
|
on the same mount point.
|
|
|
|
.\" Multiple mounts on same mount point: since 2.3.99pre7.
|
|
|
|
|
|
|
|
Values for the
|
2007-09-20 16:26:31 +00:00
|
|
|
.I filesystemtype
|
2004-11-03 13:51:07 +00:00
|
|
|
argument supported by the kernel are listed in
|
|
|
|
.I /proc/filesystems
|
2008-10-06 11:19:51 +00:00
|
|
|
(like "minix", "ext2", "ext3", "jfs", "xfs", "reiserfs",
|
|
|
|
"msdos", "proc", "nfs", "iso9660" etc.).
|
2004-11-03 13:51:07 +00:00
|
|
|
Further types may become available when the appropriate modules
|
|
|
|
are loaded.
|
|
|
|
|
|
|
|
The
|
2007-09-20 16:26:31 +00:00
|
|
|
.I mountflags
|
2004-11-03 13:51:07 +00:00
|
|
|
argument may have the magic number 0xC0ED (\fBMS_MGC_VAL\fP)
|
|
|
|
in the top 16 bits (this was required in kernel versions prior to 2.4, but
|
|
|
|
is no longer required and ignored if specified),
|
2007-06-20 21:53:34 +00:00
|
|
|
and various mount flags (as defined in \fI<linux/fs.h>\fP for libc4 and libc5
|
|
|
|
and in \fI<sys/mount.h>\fP for glibc2) in the low order 16 bits:
|
ioctl_list.2, mount.2, select_tut.2, stat.2, getifaddrs.3, pthread_cleanup_push_defer_np.3, pthread_getcpuclockid.3, proc.5, bootparam.7: Global fix: s/sub-/sub/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "sub-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 17:36:10 +00:00
|
|
|
.\" FIXME 2.6.15 added flags for "shared subtree" functionality:
|
2006-04-25 06:57:00 +00:00
|
|
|
.\" MS_UNBINDABLE, MS_PRIVATE, MS_SHARED, MS_SLAVE
|
2006-02-08 09:44:13 +00:00
|
|
|
.\" These need to be documented on this page.
|
2008-04-18 17:00:53 +00:00
|
|
|
.\" See:
|
|
|
|
.\" Documentation/filesystems/sharedsubtree.txt
|
2008-04-25 06:57:43 +00:00
|
|
|
.\"
|
2008-04-18 17:00:53 +00:00
|
|
|
.\" http://lwn.net/Articles/159077/
|
2008-04-25 06:57:43 +00:00
|
|
|
.\"
|
2008-04-18 17:00:53 +00:00
|
|
|
.\" http://myweb.sudhaa.com:2022/~ram/sharedsubtree/paper/sharedsubtree.1.pdf
|
|
|
|
.\" Shared-Subtree Concept, Implementation, and Applications in Linux
|
|
|
|
.\" Al Viro viro@ftp.linux.org.uk
|
|
|
|
.\" Ram Pai linuxram@us.ibm.com
|
2008-04-25 06:57:43 +00:00
|
|
|
.\"
|
2008-04-18 17:00:53 +00:00
|
|
|
.\" http://foss.in/2005/slides/sharedsubtree1.pdf
|
|
|
|
.\" Shared Subtree Concept and Implementation in the Linux Kernel
|
|
|
|
.\" Ram Pai
|
|
|
|
.\"
|
2009-06-26 12:48:14 +00:00
|
|
|
.\" 2.6.25 Added MS_I_VERSION, which needs to be documented.
|
|
|
|
.\"
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
Changes.old, clone.2, execve.2, fcntl.2, futex.2, getitimer.2, getpriority.2, mmap.2, mount.2, mprotect.2, sched_setscheduler.2, select_tut.2, setuid.2, sigaltstack.2, vfork.2, div.3, fenv.3, fmod.3, memchr.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_getattr_np.3, queue.3, scanf.3, trunc.3, st.4, proc.5, services.5, utmp.5, bootparam.7, capabilities.7, feature_test_macros.7, futex.7, glob.7, man.7, netlink.7, unicode.7: Switch to American usage: "-wards" ==> "-ward"
American English uses "afterward" in preference to "afterwards",
and so on
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-26 05:34:47 +00:00
|
|
|
.BR MS_BIND " (Linux 2.4 onward)"
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" since 2.4.0-test9
|
|
|
|
Perform a bind mount, making a file or a directory subtree visible at
|
|
|
|
another point within a file system.
|
|
|
|
Bind mounts may cross file system boundaries and span
|
|
|
|
.BR chroot (2)
|
|
|
|
jails.
|
|
|
|
The
|
2008-07-09 11:37:44 +00:00
|
|
|
.IR filesystemtype
|
|
|
|
and
|
|
|
|
.IR data
|
2004-11-03 13:51:07 +00:00
|
|
|
arguments are ignored.
|
2008-07-09 11:37:44 +00:00
|
|
|
Up until Linux 2.6.26,
|
|
|
|
.I mountflags
|
|
|
|
was also ignored
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" with the exception of the "hidden" MS_REC mountflags bit
|
2008-09-29 09:00:36 +00:00
|
|
|
(the bind mount has the same mount options as
|
2008-07-09 11:37:44 +00:00
|
|
|
the underlying mount point).
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
2005-05-18 14:34:43 +00:00
|
|
|
.BR MS_DIRSYNC " (since Linux 2.5.19)"
|
2004-11-03 13:51:07 +00:00
|
|
|
Make directory changes on this file system synchronous.
|
|
|
|
(This property can be obtained for individual directories
|
|
|
|
or subtrees using
|
2007-10-14 18:33:54 +00:00
|
|
|
.BR chattr (1).)
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B MS_MANDLOCK
|
|
|
|
Permit mandatory locking on files in this file system.
|
|
|
|
(Mandatory locking must still be enabled on a per-file basis,
|
|
|
|
as described in
|
|
|
|
.BR fcntl (2).)
|
2006-03-23 02:13:08 +00:00
|
|
|
.\" FIXME Say more about MS_MOVE
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B MS_MOVE
|
|
|
|
Move a subtree.
|
|
|
|
.I source
|
|
|
|
specifies an existing mount point and
|
|
|
|
.I target
|
|
|
|
specifies the new location.
|
|
|
|
The move is atomic: at no point is the subtree unmounted.
|
|
|
|
The
|
|
|
|
.IR filesystemtype ", " mountflags ", and " data
|
|
|
|
arguments are ignored.
|
|
|
|
.TP
|
|
|
|
.B MS_NOATIME
|
|
|
|
Do not update access times for (all types of) files on this file system.
|
|
|
|
.TP
|
|
|
|
.B MS_NODEV
|
|
|
|
Do not allow access to devices (special files) on this file system.
|
|
|
|
.TP
|
|
|
|
.B MS_NODIRATIME
|
|
|
|
Do not update access times for directories on this file system.
|
2007-12-17 14:21:56 +00:00
|
|
|
This flag provides a subset of the functionality provided by
|
|
|
|
.BR MS_NOATIME ;
|
|
|
|
that is,
|
|
|
|
.BR MS_NOATIME
|
|
|
|
implies
|
|
|
|
.BR MS_NODIRATIME .
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B MS_NOEXEC
|
|
|
|
Do not allow programs to be executed from this file system.
|
|
|
|
.\" (Possibly useful for a file system that contains non-Linux executables.
|
2007-06-08 11:56:22 +00:00
|
|
|
.\" Often used as a security feature, e.g., to make sure that restricted
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" users cannot execute files uploaded using ftp or so.)
|
|
|
|
.TP
|
|
|
|
.B MS_NOSUID
|
2007-06-08 09:56:56 +00:00
|
|
|
Do not honor set-user-ID and set-group-ID bits when executing
|
2004-11-03 13:51:07 +00:00
|
|
|
programs from this file system.
|
2005-07-18 14:25:42 +00:00
|
|
|
.\" (This is a security feature to prevent users executing set-user-ID and
|
|
|
|
.\" set-group-ID programs from removable disk devices.)
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B MS_RDONLY
|
|
|
|
Mount file system read-only.
|
2006-04-25 06:55:21 +00:00
|
|
|
.\"
|
|
|
|
.\" FIXME Document MS_REC, available since 2.4.11.
|
2006-04-25 06:57:00 +00:00
|
|
|
.\" This flag has meaning in conjunction with MS_BIND and
|
ioctl_list.2, mount.2, select_tut.2, stat.2, getifaddrs.3, pthread_cleanup_push_defer_np.3, pthread_getcpuclockid.3, proc.5, bootparam.7: Global fix: s/sub-/sub/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "sub-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 17:36:10 +00:00
|
|
|
.\" also with the shared subtree flags.
|
2007-04-12 22:42:49 +00:00
|
|
|
.TP
|
2007-08-27 10:06:53 +00:00
|
|
|
.BR MS_RELATIME " (Since Linux 2.6.20)"
|
2007-02-10 17:37:00 +00:00
|
|
|
When a file on this file system is accessed,
|
2008-03-18 14:11:57 +00:00
|
|
|
only update the file's last access time (atime) if the current value
|
2008-09-18 12:30:37 +00:00
|
|
|
of atime is less than or equal to the file's last modification time (mtime)
|
2007-02-10 17:37:00 +00:00
|
|
|
or last status change time (ctime).
|
|
|
|
This option is useful for programs, such as
|
|
|
|
.BR mutt (1),
|
|
|
|
that need to know when a file has been read since it was last modified.
|
2009-06-26 05:53:25 +00:00
|
|
|
Since Linux 2.6.30, the kernel defaults to the behavior provided
|
|
|
|
by this flag (unless
|
|
|
|
.BR MS_NOATIME
|
|
|
|
was specified), and the
|
|
|
|
.B MS_STRICTATIME
|
|
|
|
flag is required to obtain traditional semantics.
|
|
|
|
In addition, since Linux 2.6.30,
|
|
|
|
the file's last access time is always updated if it
|
|
|
|
is more than 1 day old.
|
|
|
|
.\" Matthew Garrett notes in the patch that added this behavior
|
|
|
|
.\" that this lets utilities such as tmpreaper (which deletes
|
|
|
|
.\" files based on last acces time) work correctly.
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B MS_REMOUNT
|
2007-04-12 22:42:49 +00:00
|
|
|
Remount an existing mount.
|
2007-08-27 10:06:53 +00:00
|
|
|
This allows you to change the
|
2004-11-03 13:51:07 +00:00
|
|
|
.I mountflags
|
|
|
|
and
|
|
|
|
.I data
|
|
|
|
of an existing mount without having to unmount and remount the file system.
|
|
|
|
.I source
|
|
|
|
and
|
|
|
|
.I target
|
|
|
|
should be the same values specified in the initial
|
|
|
|
.BR mount ()
|
|
|
|
call;
|
|
|
|
.I filesystemtype
|
|
|
|
is ignored.
|
2006-04-25 09:32:44 +00:00
|
|
|
|
|
|
|
The following
|
2007-04-12 22:42:49 +00:00
|
|
|
.I mountflags
|
2006-04-25 09:32:44 +00:00
|
|
|
can be changed:
|
|
|
|
.BR MS_RDONLY ,
|
|
|
|
.BR MS_SYNCHRONOUS ,
|
|
|
|
.BR MS_MANDLOCK ;
|
|
|
|
before kernel 2.6.16, the following could also be changed:
|
2007-09-20 16:26:31 +00:00
|
|
|
.B MS_NOATIME
|
2006-04-25 09:32:44 +00:00
|
|
|
and
|
2006-08-03 02:40:44 +00:00
|
|
|
.BR MS_NODIRATIME ;
|
2008-04-17 14:59:13 +00:00
|
|
|
and, additionally, before kernel 2.4.10, the following could also be changed:
|
2006-04-25 09:32:44 +00:00
|
|
|
.BR MS_NOSUID ,
|
|
|
|
.BR MS_NODEV ,
|
|
|
|
.BR MS_NOEXEC .
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
2008-10-01 13:17:47 +00:00
|
|
|
.BR MS_SILENT " (since Linux 2.6.17)"
|
|
|
|
Suppress the display of certain
|
|
|
|
.RI ( printk ())
|
|
|
|
warning messages in the kernel log.
|
|
|
|
This flag supersedes the misnamed and obsolete
|
|
|
|
.BR MS_VERBOSE
|
|
|
|
flag (available since Linux 2.4.12), which has the same meaning.
|
|
|
|
.TP
|
2009-06-26 05:53:25 +00:00
|
|
|
.BR MS_STRICTATIME " (Since Linux 2.6.30)"
|
|
|
|
Always update the last access time (atime) when files on this
|
|
|
|
file system are accessed.
|
|
|
|
(This was the default behavior before Linux 2.6.30.)
|
|
|
|
Specifying this flag overrides the effect of setting the
|
|
|
|
.BR MS_NOATIME
|
|
|
|
and
|
|
|
|
.BR MS_RELATIME
|
|
|
|
flags.
|
|
|
|
.TP
|
2004-11-03 13:51:07 +00:00
|
|
|
.B MS_SYNCHRONOUS
|
|
|
|
Make writes on this file system synchronous (as though
|
|
|
|
the
|
2007-04-12 22:42:49 +00:00
|
|
|
.B O_SYNC
|
2004-11-03 13:51:07 +00:00
|
|
|
flag to
|
|
|
|
.BR open (2)
|
|
|
|
was specified for all file opens to this file system).
|
|
|
|
.PP
|
Changes.old, clone.2, execve.2, fcntl.2, futex.2, getitimer.2, getpriority.2, mmap.2, mount.2, mprotect.2, sched_setscheduler.2, select_tut.2, setuid.2, sigaltstack.2, vfork.2, div.3, fenv.3, fmod.3, memchr.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_getattr_np.3, queue.3, scanf.3, trunc.3, st.4, proc.5, services.5, utmp.5, bootparam.7, capabilities.7, feature_test_macros.7, futex.7, glob.7, man.7, netlink.7, unicode.7: Switch to American usage: "-wards" ==> "-ward"
American English uses "afterward" in preference to "afterwards",
and so on
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-26 05:34:47 +00:00
|
|
|
From Linux 2.4 onward, the
|
2004-11-03 13:51:07 +00:00
|
|
|
.BR MS_NODEV ", " MS_NOEXEC ", and " MS_NOSUID
|
2006-04-25 08:18:18 +00:00
|
|
|
flags are settable on a per-mount-point basis.
|
Changes.old, clone.2, execve.2, fcntl.2, futex.2, getitimer.2, getpriority.2, mmap.2, mount.2, mprotect.2, sched_setscheduler.2, select_tut.2, setuid.2, sigaltstack.2, vfork.2, div.3, fenv.3, fmod.3, memchr.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_getattr_np.3, queue.3, scanf.3, trunc.3, st.4, proc.5, services.5, utmp.5, bootparam.7, capabilities.7, feature_test_macros.7, futex.7, glob.7, man.7, netlink.7, unicode.7: Switch to American usage: "-wards" ==> "-ward"
American English uses "afterward" in preference to "afterwards",
and so on
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-26 05:34:47 +00:00
|
|
|
From kernel 2.6.16 onward,
|
2006-04-25 08:18:18 +00:00
|
|
|
.B MS_NOATIME
|
|
|
|
and
|
|
|
|
.B MS_NODIRATIME
|
|
|
|
are also settable on a per-mount-point basis.
|
2007-04-12 22:42:49 +00:00
|
|
|
The
|
|
|
|
.B MS_RELATIME
|
2007-02-10 17:37:00 +00:00
|
|
|
flag is also settable on a per-mount-point basis.
|
2004-11-03 13:51:07 +00:00
|
|
|
.PP
|
|
|
|
The
|
2007-09-20 16:26:31 +00:00
|
|
|
.I data
|
2004-11-03 13:51:07 +00:00
|
|
|
argument is interpreted by the different file systems.
|
|
|
|
Typically it is a string of comma-separated options
|
|
|
|
understood by this file system.
|
|
|
|
See
|
|
|
|
.BR mount (8)
|
|
|
|
for details of the options available for each filesystem type.
|
|
|
|
.SH "RETURN VALUE"
|
2007-04-12 22:42:49 +00:00
|
|
|
On success, zero is returned.
|
|
|
|
On error, \-1 is returned, and
|
2004-11-03 13:51:07 +00:00
|
|
|
.I errno
|
|
|
|
is set appropriately.
|
|
|
|
.SH ERRORS
|
|
|
|
The error values given below result from filesystem type independent
|
2007-04-12 22:42:49 +00:00
|
|
|
errors.
|
2010-10-10 16:31:12 +00:00
|
|
|
Each file-system type may have its own special errors and its
|
2007-04-12 22:42:49 +00:00
|
|
|
own special behavior.
|
|
|
|
See the kernel source code for details.
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B EACCES
|
2007-04-12 22:42:49 +00:00
|
|
|
A component of a path was not searchable.
|
|
|
|
(See also
|
2007-05-26 12:41:39 +00:00
|
|
|
.BR path_resolution (7).)
|
2010-10-10 16:31:12 +00:00
|
|
|
Or, mounting a read-only file system was attempted without giving the
|
2007-04-12 22:42:49 +00:00
|
|
|
.B MS_RDONLY
|
2005-05-18 14:34:43 +00:00
|
|
|
flag.
|
2004-11-03 13:51:07 +00:00
|
|
|
Or, the block device
|
|
|
|
.I source
|
2010-10-10 16:31:12 +00:00
|
|
|
is located on a file system mounted with the
|
2005-05-18 14:34:43 +00:00
|
|
|
.B MS_NODEV
|
|
|
|
option.
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" mtk: Probably: write permission is required for MS_BIND, with
|
|
|
|
.\" the error EPERM if not present; CAP_DAC_OVERRIDE is required.
|
|
|
|
.TP
|
|
|
|
.B EBUSY
|
|
|
|
.I source
|
2007-04-12 22:42:49 +00:00
|
|
|
is already mounted.
|
|
|
|
Or, it cannot be remounted read-only,
|
2004-11-03 13:51:07 +00:00
|
|
|
because it still holds files open for writing.
|
|
|
|
Or, it cannot be mounted on
|
|
|
|
.I target
|
|
|
|
because
|
|
|
|
.I target
|
2011-10-03 13:40:42 +00:00
|
|
|
is still busy (it is the working directory of some thread,
|
2004-11-03 13:51:07 +00:00
|
|
|
the mount point of another device, has open files, etc.).
|
|
|
|
.TP
|
|
|
|
.B EFAULT
|
|
|
|
One of the pointer arguments points outside the user address space.
|
|
|
|
.TP
|
|
|
|
.B EINVAL
|
|
|
|
.I source
|
|
|
|
had an invalid superblock.
|
2005-05-18 14:34:43 +00:00
|
|
|
Or, a remount
|
|
|
|
.RB ( MS_REMOUNT )
|
|
|
|
was attempted, but
|
2004-11-03 13:51:07 +00:00
|
|
|
.I source
|
|
|
|
was not already mounted on
|
|
|
|
.IR target .
|
2007-04-12 22:42:49 +00:00
|
|
|
Or, a move
|
2005-05-18 14:34:43 +00:00
|
|
|
.RB ( MS_MOVE )
|
|
|
|
was attempted, but
|
2004-11-03 13:51:07 +00:00
|
|
|
.I source
|
2008-06-09 15:49:35 +00:00
|
|
|
was not a mount point, or was \(aq/\(aq.
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B ELOOP
|
2008-10-06 09:49:27 +00:00
|
|
|
Too many links encountered during pathname resolution.
|
2004-11-03 13:51:07 +00:00
|
|
|
Or, a move was attempted, while
|
|
|
|
.I target
|
|
|
|
is a descendant of
|
|
|
|
.IR source .
|
|
|
|
.TP
|
|
|
|
.B EMFILE
|
|
|
|
(In case no block device is required:)
|
|
|
|
Table of dummy devices is full.
|
|
|
|
.TP
|
|
|
|
.B ENAMETOOLONG
|
2007-06-22 17:16:20 +00:00
|
|
|
A pathname was longer than
|
|
|
|
.BR MAXPATHLEN .
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B ENODEV
|
2006-06-08 17:59:39 +00:00
|
|
|
.I filesystemtype
|
2004-11-03 13:51:07 +00:00
|
|
|
not configured in the kernel.
|
|
|
|
.TP
|
|
|
|
.B ENOENT
|
|
|
|
A pathname was empty or had a nonexistent component.
|
|
|
|
.TP
|
|
|
|
.B ENOMEM
|
|
|
|
The kernel could not allocate a free page to copy filenames or data into.
|
|
|
|
.TP
|
|
|
|
.B ENOTBLK
|
|
|
|
.I source
|
|
|
|
is not a block device (and a device was required).
|
|
|
|
.TP
|
|
|
|
.B ENOTDIR
|
2008-10-06 11:09:26 +00:00
|
|
|
.IR target ,
|
|
|
|
or a prefix of
|
|
|
|
.IR source ,
|
|
|
|
is not a directory.
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.B ENXIO
|
|
|
|
The major number of the block device
|
|
|
|
.I source
|
|
|
|
is out of range.
|
|
|
|
.TP
|
|
|
|
.B EPERM
|
|
|
|
The caller does not have the required privileges.
|
2010-09-10 06:09:14 +00:00
|
|
|
.SH VERSIONS
|
|
|
|
The definitions of
|
|
|
|
.BR MS_DIRSYNC ,
|
|
|
|
.BR MS_MOVE ,
|
|
|
|
.BR MS_REC ,
|
|
|
|
.BR MS_RELATIME ,
|
|
|
|
and
|
|
|
|
.BR MS_STRICTATIME
|
|
|
|
were only added to glibc headers in version 2.12.
|
|
|
|
.\" FIXME: Definitions of the so-far-undocumented MS_UNBINDABLE, MS_PRIVATE,
|
|
|
|
.\" MS_SHARED, and MS_SLAVE were (also) only added to glibc headers in 2.12.
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH "CONFORMING TO"
|
2008-10-06 11:09:26 +00:00
|
|
|
This function is Linux-specific and should not be used in
|
2004-11-03 13:51:07 +00:00
|
|
|
programs intended to be portable.
|
2007-05-18 11:59:14 +00:00
|
|
|
.SH NOTES
|
2004-11-03 13:51:07 +00:00
|
|
|
The original
|
2007-09-20 16:26:31 +00:00
|
|
|
.B MS_SYNC
|
2007-06-22 17:16:20 +00:00
|
|
|
flag was renamed
|
2007-09-20 16:26:31 +00:00
|
|
|
.B MS_SYNCHRONOUS
|
2007-06-22 17:16:20 +00:00
|
|
|
in 1.1.69
|
|
|
|
when a different
|
2007-09-20 16:26:31 +00:00
|
|
|
.B MS_SYNC
|
2007-06-22 17:16:20 +00:00
|
|
|
was added to \fI<mman.h>\fP.
|
2004-11-03 13:51:07 +00:00
|
|
|
.LP
|
2005-07-18 14:25:42 +00:00
|
|
|
Before Linux 2.4 an attempt to execute a set-user-ID or set-group-ID program
|
2010-10-10 16:31:12 +00:00
|
|
|
on a file system mounted with
|
2004-11-03 13:51:07 +00:00
|
|
|
.B MS_NOSUID
|
|
|
|
would fail with
|
|
|
|
.BR EPERM .
|
2007-04-12 22:42:49 +00:00
|
|
|
Since Linux 2.4 the set-user-ID and set-group-ID bits are
|
2005-07-18 14:25:42 +00:00
|
|
|
just silently ignored in this case.
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" The change is in patch-2.4.0-prerelease.
|
2008-10-06 12:07:03 +00:00
|
|
|
.SS Per-process Namespaces
|
2008-11-19 19:23:47 +00:00
|
|
|
Starting with kernel 2.4.19, Linux provides
|
2008-11-20 16:04:07 +00:00
|
|
|
per-process mount namespaces.
|
|
|
|
A mount namespace is the set of file system mounts that
|
2008-11-19 19:23:47 +00:00
|
|
|
are visible to a process.
|
|
|
|
Mount-point namespaces can be (and usually are)
|
|
|
|
shared between multiple processes,
|
2008-10-06 12:07:03 +00:00
|
|
|
and changes to the namespace (i.e., mounts and unmounts) by one process
|
|
|
|
are visible to all other processes sharing the same namespace.
|
2009-09-27 07:26:29 +00:00
|
|
|
(The pre-2.4.19 Linux situation can be considered as one in which
|
|
|
|
a single namespace was shared by every process on the system.)
|
2008-10-06 12:07:03 +00:00
|
|
|
|
|
|
|
A child process created by
|
|
|
|
.BR fork (2)
|
2008-11-20 16:04:07 +00:00
|
|
|
shares its parent's mount namespace;
|
|
|
|
the mount namespace is preserved across an
|
2008-10-06 12:07:03 +00:00
|
|
|
.BR execve (2).
|
|
|
|
|
2008-11-20 16:04:07 +00:00
|
|
|
A process can obtain a private mount namespace if:
|
2008-10-06 12:07:03 +00:00
|
|
|
it was created using the
|
Changes, clone.2, mount.2, nanosleep.2, sigaltstack.2, statfs.2, timer_settime.2, ctime.3, fmemopen.3, nl_langinfo.3, posix_memalign.3, pthread_attr_init.3, pthread_setaffinity_np.3, pthread_setschedprio.3, pthread_testcancel.3, setjmp.3, sigwait.3, tty_ioctl.4, epoll.7, posixoptions.7, unix.7: Add section number to references to functions documented in other pages
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 07:07:28 +00:00
|
|
|
.BR clone (2)
|
2008-10-06 12:07:03 +00:00
|
|
|
.BR CLONE_NEWNS
|
|
|
|
flag,
|
|
|
|
in which case its new namespace is initialized to be a
|
|
|
|
.I copy
|
|
|
|
of the namespace of the process that called
|
Changes, clone.2, mount.2, nanosleep.2, sigaltstack.2, statfs.2, timer_settime.2, ctime.3, fmemopen.3, nl_langinfo.3, posix_memalign.3, pthread_attr_init.3, pthread_setaffinity_np.3, pthread_setschedprio.3, pthread_testcancel.3, setjmp.3, sigwait.3, tty_ioctl.4, epoll.7, posixoptions.7, unix.7: Add section number to references to functions documented in other pages
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 07:07:28 +00:00
|
|
|
.BR clone (2);
|
2008-10-06 12:07:03 +00:00
|
|
|
or it calls
|
|
|
|
.BR unshare (2)
|
2008-10-07 08:58:44 +00:00
|
|
|
with the
|
2008-10-06 12:07:03 +00:00
|
|
|
.BR CLONE_NEWNS
|
|
|
|
flag,
|
2008-11-20 16:04:07 +00:00
|
|
|
which causes the caller's mount namespace to obtain a private copy
|
2008-10-06 12:07:03 +00:00
|
|
|
of the namespace that it was previously sharing with other processes,
|
|
|
|
so that future mounts and unmounts by the caller are invisible
|
|
|
|
to other processes (except child processes that the caller
|
|
|
|
subsequently creates) and vice versa.
|
|
|
|
|
|
|
|
The Linux-specific
|
2010-05-22 03:32:46 +00:00
|
|
|
.I /proc/PID/mounts
|
2008-11-20 16:04:07 +00:00
|
|
|
file exposes the list of mount points in the mount
|
2008-11-19 19:23:47 +00:00
|
|
|
namespace of the process with the specified ID; see
|
2008-10-06 12:07:03 +00:00
|
|
|
.BR proc (5)
|
|
|
|
for details.
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH "SEE ALSO"
|
2008-10-06 11:09:26 +00:00
|
|
|
.BR umount (2),
|
2007-05-26 12:41:39 +00:00
|
|
|
.BR path_resolution (7),
|
2004-11-03 13:51:07 +00:00
|
|
|
.BR mount (8),
|
|
|
|
.BR umount (8)
|