From be779d181d79110a76814af5208117a7f75adbee Mon Sep 17 00:00:00 2001 From: Karel Zak Date: Wed, 2 Dec 2009 13:35:18 +0100 Subject: [PATCH] mount: move info about devices to the top of mount.8 Signed-off-by: Karel Zak --- mount/mount.8 | 226 +++++++++++++++++++++++++------------------------- 1 file changed, 113 insertions(+), 113 deletions(-) diff --git a/mount/mount.8 b/mount/mount.8 index 0d9f0f04..57b3571c 100644 --- a/mount/mount.8 +++ b/mount/mount.8 @@ -118,117 +118,6 @@ The option \-l adds the labels in this listing. See below. .RE -.B The bind mounts. -.RS -.\" In fact since 2.3.99. At first the syntax was mount -t bind. -Since Linux 2.4.0 it is possible to remount part of the -file hierarchy somewhere else. The call is -.RS -.br -.B mount --bind -.I olddir newdir -.RE -or shortoption -.RS -.br -.B mount -B -.I olddir newdir -.RE -or fstab entry is: -.RS -.br -.I /olddir -.I /newdir -.B none bind -.RE - -After this call the same contents is accessible in two places. -One can also remount a single file (on a single file). - -This call attaches only (part of) a single filesystem, not possible -submounts. The entire file hierarchy including submounts is attached -a second place using -.RS -.br -.B mount --rbind -.I olddir newdir -.RE -or shortoption -.RS -.br -.B mount -R -.I olddir newdir -.RE -.\" available since Linux 2.4.11. - -Note that the filesystem mount options will remain the same as those -on the original mount point, and cannot be changed by passing the -o -option along with --bind/--rbind. The mount options can be -changed by a separate remount command, for example: - -.RS -.br -.B mount --bind -.I olddir newdir -.br -.B mount -o remount,ro -.I newdir -.RE - -.RE - -.B The move operation. -.RS -Since Linux 2.5.1 it is possible to atomically move a mounted tree -to another place. The call is -.RS -.br -.B mount --move -.I olddir newdir -.RE -or shortoption -.RS -.br -.B mount -M -.I olddir newdir -.RE -This will cause the contents which previously appeared under olddir to be -accessed under newdir. The physical location of the files is not changed. -.RE - -.B The shared subtrees operations. -.RS -Since Linux 2.6.15 it is possible to mark a mount and its submounts as shared, -private, slave or unbindable. A shared mount provides ability to create mirrors -of that mount such that mounts and umounts within any of the mirrors propagate -to the other mirror. A slave mount receives propagation from its master, but -any not vice-versa. A private mount carries no propagation abilities. A -unbindable mount is a private mount which cannot cloned through a bind -operation. Detailed semantics is documented in Documentation/sharedsubtree.txt -file in the kernel source tree. - -.RS -.nf -.BI "mount --make-shared " mountpoint -.BI "mount --make-slave " mountpoint -.BI "mount --make-private " mountpoint -.BI "mount --make-unbindable " mountpoint -.fi -.RE - -The following commands allows one to recursively change the type of all the -mounts under a given mountpoint. - -.RS -.nf -.BI "mount --make-rshared " mountpoint -.BI "mount --make-rslave " mountpoint -.BI "mount --make-rprivate " mountpoint -.BI "mount --make-runbindable " mountpoint -.fi -.RE -.RE - .B The device indication. .RS Most devices are indicated by a file name (of a block special device), like @@ -329,8 +218,7 @@ by a symbolic link to and especially when you have very large numbers of mounts things will be much faster with that symlink, but some information is lost that way, and in particular -working with the loop device will be less convenient, -and using the "user" option will fail. +using the "user" option will fail. .RE .B The non-superuser mounts. @@ -385,6 +273,118 @@ option is similar, with the restriction that the user must be member of the group of the special file. .RE + +.B The bind mounts. +.RS +.\" In fact since 2.3.99. At first the syntax was mount -t bind. +Since Linux 2.4.0 it is possible to remount part of the +file hierarchy somewhere else. The call is +.RS +.br +.B mount --bind +.I olddir newdir +.RE +or shortoption +.RS +.br +.B mount -B +.I olddir newdir +.RE +or fstab entry is: +.RS +.br +.I /olddir +.I /newdir +.B none bind +.RE + +After this call the same contents is accessible in two places. +One can also remount a single file (on a single file). + +This call attaches only (part of) a single filesystem, not possible +submounts. The entire file hierarchy including submounts is attached +a second place using +.RS +.br +.B mount --rbind +.I olddir newdir +.RE +or shortoption +.RS +.br +.B mount -R +.I olddir newdir +.RE +.\" available since Linux 2.4.11. + +Note that the filesystem mount options will remain the same as those +on the original mount point, and cannot be changed by passing the -o +option along with --bind/--rbind. The mount options can be +changed by a separate remount command, for example: + +.RS +.br +.B mount --bind +.I olddir newdir +.br +.B mount -o remount,ro +.I newdir +.RE + +.RE + +.B The move operation. +.RS +Since Linux 2.5.1 it is possible to atomically move a mounted tree +to another place. The call is +.RS +.br +.B mount --move +.I olddir newdir +.RE +or shortoption +.RS +.br +.B mount -M +.I olddir newdir +.RE +This will cause the contents which previously appeared under olddir to be +accessed under newdir. The physical location of the files is not changed. +.RE + +.B The shared subtrees operations. +.RS +Since Linux 2.6.15 it is possible to mark a mount and its submounts as shared, +private, slave or unbindable. A shared mount provides ability to create mirrors +of that mount such that mounts and umounts within any of the mirrors propagate +to the other mirror. A slave mount receives propagation from its master, but +any not vice-versa. A private mount carries no propagation abilities. A +unbindable mount is a private mount which cannot cloned through a bind +operation. Detailed semantics is documented in Documentation/sharedsubtree.txt +file in the kernel source tree. + +.RS +.nf +.BI "mount --make-shared " mountpoint +.BI "mount --make-slave " mountpoint +.BI "mount --make-private " mountpoint +.BI "mount --make-unbindable " mountpoint +.fi +.RE + +The following commands allows one to recursively change the type of all the +mounts under a given mountpoint. + +.RS +.nf +.BI "mount --make-rshared " mountpoint +.BI "mount --make-rslave " mountpoint +.BI "mount --make-rprivate " mountpoint +.BI "mount --make-runbindable " mountpoint +.fi +.RE +.RE + .SH COMMAND LINE OPTIONS The full set of mount options used by an invocation of .B mount -- 2.39.5