Manual pages: unshare.1: EXAMPLES: improve persistent mount namespace example
PATCH 1/10 Manual pages: unshare.1: EXAMPLES: improve persistent mount namespace example
The text describing the persistent mount namespace example is rather confused. Explain more clearly the purpose of making the parent directory a bind mount with private propagation. Also make a few other wording improvements.
--- sys-utils/unshare.1 | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-)
sys-utils/unshare.1 +10 -3
@@ -304,9 +304,16 @@ FOO .EE .in .PP -Establish a persistent mount namespace referenced by the bind mount -/root/namespaces/mnt. This example shows a portable solution, because it -makes sure that the bind mount is created on a shared filesystem. +The following commands +establish a persistent mount namespace referenced by the bind mount +.IR /root/namespaces/mnt . +In order to ensure that this bind mount does not get propagated +to other mount namespaces, +the parent directory +.RI ( /root/namespaces ) +is first made a bind mount with +.I private +propagation. .PP .in +4n .EX
Signature · 1 line
2.26.2
PATCH 2/10 Manual pages: unshare.1: typo fix
(Introduced in one of my earlier commits)
--- sys-utils/unshare.1 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
sys-utils/unshare.1 +1 -1
@@ -19,7 +19,7 @@ By default, a new namespace persists only as long as it has member processes. A new namespace can be made persistent even when it has no member processes by bind mounting /proc/\fIpid\fR/ns/\fItype\fR files to a filesystem path. -A namespace that has been made persistent in this was can subsequently +A namespace that has been made persistent in this way can subsequently be entered with .BR \%nsenter (1) even after the \fIprogram\fR terminates (except PID namespaces where
Signature · 1 line
2.26.2
PATCH 3/10 Manual pages: setpriv.1: Minor formatting and typo fixes
In reply to Michael Kerrisk (man-pages)These seem all "obviously correct", so I'm rolling them up into one patch.
--- sys-utils/setpriv.1 | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-)
sys-utils/setpriv.1 +14 -9
@@ -14,7 +14,7 @@ In comparison to .BR su (1) and .BR runuser (1), -.BR setpriv (1) +.BR setpriv neither uses PAM, nor does it prompt for a password. It is a simple, non-set-user-ID wrapper around .BR execve (2),
@@ -32,7 +32,8 @@ or similar tools shipped by other service managers. Clear supplementary groups. .TP .BR \-d , " \-\-dump" -Dump current privilege state. Can be specified more than once to show extra, +Dump the current privilege state. +Can be specified more than once to show extra, mostly useless, information. Incompatible with all other options. .TP .B \-\-groups \fIgroup\fR...
@@ -49,7 +50,7 @@ entries, which add or remove an entry respectively. \fIcap\fR can either be a human-readable name as seen in .BR capabilities (7) without the \fIcap_\fR prefix or of the format -.BI cap_N , +.BR cap_N , where \fIN\fR is the internal capability index used by Linux. .B +all and
@@ -97,11 +98,13 @@ and .I Documentation/\:prctl/\:no_\:new_\:privs.txt in the Linux kernel source. .sp -The no_new_privs bit is supported since Linux 3.5. +The +.I no_new_privs +bit is supported since Linux 3.5. .TP .BI \-\-rgid " gid\fR, " \-\-egid " gid\fR, " \-\-regid " gid" Set the real, effective, or both GIDs. The \fIgid\fR argument can be -given as textual group name. +given as a textual group name. .sp For safety, you must specify one of .BR \-\-clear\-groups ,
@@ -113,7 +116,7 @@ if you set any primary .TP .BI \-\-ruid " uid\fR, " \-\-euid " uid\fR, " \-\-reuid " uid" Set the real, effective, or both UIDs. The \fIuid\fR argument can be -given as textual login name. +given as a textual login name. .sp Setting a .I uid
@@ -148,7 +151,7 @@ credentials to remedy that situation. .BI \-\-selinux\-label " label" Request a particular SELinux transition (using a transition on exec, not dyntrans). This will fail and cause -.BR setpriv (1) +.BR setpriv to abort if SELinux is not in use, and the transition may be ignored or cause .BR execve (2) to fail at SELinux's whim. (In particular, this is unlikely to work in
@@ -160,7 +163,7 @@ This is similar to .BI \-\-apparmor\-profile " profile" Request a particular AppArmor profile (using a transition on exec). This will fail and cause -.BR setpriv (1) +.BR setpriv to abort if AppArmor is not in use, and the transition may be ignored or cause .BR execve (2) to fail at AppArmor's whim.
@@ -187,7 +190,9 @@ will not be run and will return with exit status 127. .PP Be careful with this tool \-\- it may have unexpected security consequences. -For example, setting no_new_privs and then execing a program that is +For example, setting +.I no_new_privs +and then execing a program that is SELinux\-confined (as this tool would do) may prevent the SELinux restrictions from taking effect. .SH EXAMPLES
Signature · 1 line
2.26.2
PATCH 4/10 Manual pages: mount.8, umount.8: Clarify that "namespace" means "mount namespace"
In reply to Michael Kerrisk (man-pages)There are various references to "namespaces" when it would be clearer to say "mount namespaces". Also, add references to the mount_namespaces(7) manual page.
--- sys-utils/mount.8 | 11 +++++++---- sys-utils/umount.8 | 11 +++++++---- 2 files changed, 14 insertions(+), 8 deletions(-)
sys-utils/mount.8 +7 -4
@@ -664,19 +664,21 @@ This is necessary for example when is on a read-only filesystem. .TP .BR \-N , " \-\-namespace " \fIns -Perform mount in namespace specified by \fIns\fR. +Perform mount in the mount namespace specified by \fIns\fR. \fIns\fR is either PID of process running in that namespace or special file representing that namespace. .sp .BR mount (8) -switches to the namespace when it reads /etc/fstab, writes /etc/mtab (or writes to /run/mount) and calls +switches to the mount namespace when it reads /etc/fstab, +writes /etc/mtab (or writes to /run/mount) and calls .BR mount (2) -system call, otherwise it runs in the original namespace. It means that the target namespace does not have +system call, otherwise it runs in the original mount namespace. +It means that the target namespace does not have to contain any libraries or another requirements necessary to execute .BR mount (2) command. .sp -See \fBnamespaces\fR(7) for more information. +See \fBmount_namespaces\fR(7) for more information. .TP .BR \-O , " \-\-test\-opts " \fIopts Limit the set of filesystems to which the
@@ -2680,6 +2682,7 @@ Karel Zak <[email protected]> .BR fstab (5), .BR nfs (5), .BR xfs (5), +.BR mount_namespaces (7) .BR e2label (8), .BR findmnt (8), .BR losetup (8),
sys-utils/umount.8 +7 -4
@@ -68,7 +68,8 @@ filesystems. This list of the filesystems may be replaced by \fB\-\-types\fR umount option. .TP .BR \-A , " \-\-all\-targets" -Unmount all mountpoints in the current namespace for the specified filesystem. +Unmount all mountpoints in the current mount namespace +for the specified filesystem. The filesystem can be specified by one of the mountpoints or the device name (or UUID, etc.). When this option is used together with \fB\-\-recursive\fR, then all nested mounts within the filesystem are recursively unmounted.
@@ -129,19 +130,20 @@ server or a network partition. Remounts of the share will not be possible. .TP .BR \-N , " \-\-namespace " \fIns -Perform umount in namespace specified by \fIns\fR. +Perform umount in the mount namespace specified by \fIns\fR. \fIns\fR is either PID of process running in that namespace or special file representing that namespace. .sp .BR umount (8) switches to the namespace when it reads /etc/fstab, writes /etc/mtab (or writes to /run/mount) and calls .BR umount (2) -system call, otherwise it runs in the original namespace. It means that the target namespace does not have +system call, otherwise it runs in the original namespace. +It means that the target mount namespace does not have to contain any libraries or another requirements necessary to execute .BR umount (2) command. .sp -See \fBnamespaces\fR(7) for more information. +See \fBmount_namespaces\fR(7) for more information. .TP .BR \-n , " \-\-no\-mtab" Unmount without writing in
@@ -278,6 +280,7 @@ command appeared in Version 6 AT&T UNIX. .SH SEE ALSO .BR umount (2), .BR losetup (8), +.BR mount_namespaces (7) .BR mount (8) .SH AVAILABILITY The umount command is part of the util-linux package and is available from
Signature · 1 line
2.26.2
PATCH 5/10 Manual pages: mount.8, umount.8: Consistently format pathnames with italic
In reply to Michael Kerrisk (man-pages)--- sys-utils/mount.8 | 163 ++++++++++++++++++++++++++++++++++----------- sys-utils/umount.8 | 31 ++++++--- 2 files changed, 146 insertions(+), 48 deletions(-)
sys-utils/mount.8 +123 -40
@@ -171,7 +171,9 @@ file. Tags are more readable, robust and portable. The .BR mount (8) command internally uses udev -symlinks, so the use of symlinks in /etc/fstab has no advantage over tags. +symlinks, so the use of symlinks in +.I /etc/fstab +has no advantage over tags. For more details see .BR libblkid (3).
@@ -284,10 +286,13 @@ are specified. For example, to mount device .sp .RE This default behaviour is possible to change by command line option -\fB\-\-options\-source\-force\fR to always read configuration from fstab. For -non-root users +\fB\-\-options\-source\-force\fR to always read configuration from +.IR fstab . +For non-root users .B mount -always read fstab configuration. +always read +.I fstab +configuration. .SS Non-superuser mounts Normally, only the superuser can mount filesystems.
@@ -310,7 +315,9 @@ using the command: .sp .RE Note that \fBmount\fR is very strict about non-root users and all paths -specified on command line are verified before fstab is parsed or a helper +specified on command line are verified before +.I fstab +is parsed or a helper program is executed. It's strongly recommended to use a valid mountpoint to specify filesystem, otherwise \fBmount\fR may fail. For example it's bad idea to use NFS or CIFS source on command line.
@@ -353,7 +360,9 @@ Remount part of the file hierarchy somewhere else. The call is: .I olddir newdir .RE -or by using this fstab entry: +or by using this +.I fstab +entry: .RS .br
@@ -583,14 +592,18 @@ keyword). The filesystems are mounted following their order in The mount command compares filesystem source, target (and fs root for bind mount or btrfs) to detect already mounted filesystems. The kernel table with already mounted filesystems is cached during \fBmount \-\-all\fR. It means -that all duplicated fstab entries will be mounted. +that all duplicated +.I fstab +entries will be mounted. .sp The option \fB\-\-all\fR is possible to use for remount operation too. In this case all filters (\fB\-t\fR and \fB\-O\fR) are applied to the table of already mounted filesystems. .sp Since version 2.35 is possible to use the command line option \fB\-o\fR to -alter mount options from fstab (see also \fB\-\-options\-mode\fR). +alter mount options from +.I fstab +(see also \fB\-\-options\-mode\fR). .sp Note that it is a bad practice to use \fBmount \-a\fR for .I fstab
@@ -602,7 +615,9 @@ in both places). See above, under \fBBind mounts\fR. .TP .BR \-c , " \-\-no\-canonicalize" Don't canonicalize paths. The mount command canonicalizes all paths -(from command line or fstab) by default. This option can be used +(from command line or +.IR fstab ) +by default. This option can be used together with the .B \-f flag for already canonicalized absolute paths. The option is designed for mount
@@ -633,7 +648,9 @@ flag to determine what the .B mount command is trying to do. It can also be used to add entries for devices that were mounted earlier with the \fB\-n\fR option. The \fB\-f\fR option -checks for an existing record in /etc/mtab and fails when the record already +checks for an existing record in +.I /etc/mtab +and fails when the record already exists (with a regular non-fake mount, this check is done by the kernel). .IP "\fB\-i, \-\-internal\-only\fP" Don't call the \fB/sbin/mount.\fIfilesystem\fR helper even if it exists.
@@ -669,8 +686,13 @@ Perform mount in the mount namespace specified by \fIns\fR. or special file representing that namespace. .sp .BR mount (8) -switches to the mount namespace when it reads /etc/fstab, -writes /etc/mtab (or writes to /run/mount) and calls +switches to the mount namespace when it reads +.IR /etc/fstab , +writes +.I /etc/mtab +(or writes to +.IR /run/mount ) +and calls .BR mount (2) system call, otherwise it runs in the original mount namespace. It means that the target namespace does not have
@@ -741,11 +763,17 @@ sections. .TP .BR "\-\-options\-mode " \fImode -Controls how to combine options from fstab/mtab with options from command line. +Controls how to combine options from +.IR fstab / mtab +with options from command line. \fImode\fR can be one of .BR ignore ", " append ", " prepend " or " replace . -For example \fBappend\fR means that options from fstab are appended to options from command line. -Default value is \fBprepend\fR -- it means command line options are evaluated after fstab options. +For example \fBappend\fR means that options from +.I fstab +are appended to options from command line. +Default value is \fBprepend\fR -- it means command line options are evaluated after +.I fstab +options. Note that the last option wins if there are conflicting ones. .TP
@@ -760,7 +788,9 @@ Default value is \fBfstab,mtab\fR. .TP .B \-\-options\-source\-force -Use options from fstab/mtab even if both \fIdevice\fR and \fIdir\fR are specified. +Use options from +.IR fstab / mtab +even if both \fIdevice\fR and \fIdir\fR are specified. .TP .BR \-R , " \-\-rbind"
@@ -797,30 +827,44 @@ explicitly define that the argument is the mount target. .TP .BI \-\-target\-prefix " directory" Prepend specified directory to all mount targets. This option allows to follow -fstab, but mount operations is done on another place, for example: +.IR fstab , +but mount operations is done on another place, for example: .RS .RS .sp .B "mount \-\-all \-\-target\-prefix /chroot \-o X\-mount.mkdir .sp .RE -mounts all from system fstab to /chroot, all missing muontpoint are created -(due to X-mount.mkdir). See also \fB\-\-fstab\fP to use an alternative fstab. +mounts all from system +.I fstab +to +.IR /chroot , +all missing muontpoint are created +(due to X-mount.mkdir). See also \fB\-\-fstab\fP to use an alternative +.IR fstab . .RE .TP .BR \-T , " \-\-fstab " \fIpath -Specifies an alternative fstab file. If \fIpath\fP is a directory then the files +Specifies an alternative +.I fstab +file. If \fIpath\fP is a directory then the files in the directory are sorted by .BR strverscmp (3); -files that start with "."\& or without an \&.fstab extension are ignored. The option +files that start with "."\& or without an +.I \&.fstab +extension are ignored. The option can be specified more than once. This option is mostly designed for initramfs or chroot scripts where additional configuration is specified beyond standard system configuration. .sp Note that \fBmount\fR(8) does not pass the option \fB\-\-fstab\fP to the -\fB/sbin/mount.\fItype\fR helpers, meaning that the alternative fstab files will be +\fB/sbin/mount.\fItype\fR helpers, meaning that the alternative +.I fstab +files will be invisible for the helpers. This is no problem for normal mounts, but user -(non-root) mounts always require fstab to verify the user's rights. +(non-root) mounts always require +.I fstab +to verify the user's rights. .TP .BR \-t , " \-\-types " \fIfstype The argument following the
@@ -958,7 +1002,9 @@ file. Some of these options could be enabled or disabled by default in the system kernel. To check the current setting see the options -in /proc/mounts. Note that filesystems also have per-filesystem +in +.IR /proc/mounts . +Note that filesystems also have per-filesystem specific default mount options (see for example \fBtune2fs \-l\fP output for extN filesystems).
@@ -1160,7 +1206,8 @@ possible for the kernel to default to or .B \%noatime but still allow userspace to override it. For more details about the default -system mount options see /proc/mounts. +system mount options see +.IR /proc/mounts . .TP .B nostrictatime Use the kernel's default behavior for inode access time updates.
@@ -1223,8 +1270,13 @@ The remount operation together with the flag has special semantic. See above, the subsection \fBBind mounts\fR. The remount functionality follows the standard way the mount command works -with options from fstab. This means that \fBmount\fR does not -read fstab (or mtab) only when both +with options from +.IR fstab . +This means that \fBmount\fR does not read +.I fstab +(or +.IR mtab ) +only when both .I device and .I dir
@@ -1235,16 +1287,23 @@ are specified. .in .sp After this call all old mount options are replaced and arbitrary stuff from -fstab (or mtab) is ignored, except the loop= option which is internally +.I fstab +(or +.IR mtab ) +is ignored, except the loop= option which is internally generated and maintained by the mount command. .sp .in +4 .B "mount \-o remount,rw /dir" .in .sp -After this call, mount reads fstab and merges these options with +After this call, mount reads +.I fstab +and merges these options with the options from the command line (\fB\-o\fR). -If no mountpoint is found in fstab, then a remount with unspecified source is +If no mountpoint is found in +.IR fstab , +then a remount with unspecified source is allowed. .sp mount(8) allows to use \fB\-\-all\fR to remount all already mounted filesystems
@@ -1256,7 +1315,11 @@ which match a specified filter (\fB\-O\fR and \fB\-t\fR). For example: .sp remounts all already mounted vfat filesystems in read-only mode. The each of the filesystems is remounted by "mount \-o remount,ro /dir" semantic. It means the -mount command reads fstab or mtab and merges these options with the options +mount command reads +.I fstab +or +.I mtab +and merges these options with the options from the command line. .TP .B ro
@@ -1272,8 +1335,14 @@ media with a limited number of write cycles .TP .B user Allow an ordinary user to mount the filesystem. -The name of the mounting user is written to the mtab file (or to the private -libmount file in /run/mount on systems without a regular mtab) so that this +The name of the mounting user is written to the +.I mtab +file (or to the private +libmount file in +.I /run/mount +on systems without a regular +.IR mtab ) +so that this same user can unmount the filesystem again. This option implies the options .BR noexec ", " nosuid ", and " nodev
@@ -1294,7 +1363,10 @@ This option implies the options .TP .B X-* All options prefixed with "X-" are interpreted as comments or as userspace -application-specific options. These options are not stored in the user space (e.g., mtab file), +application-specific options. +These options are not stored in the user space (e.g., +.I mtab +file), nor sent to the mount.\fItype\fR helpers nor to the .BR mount (2) system call. The suggested format is \fBX-\fIappname\fR.\fIoption\fR.
@@ -1309,7 +1381,9 @@ available (for example after a move mount operation or in unshared namespace). Note that before util-linux v2.30 the x-* options have not been maintained by libmount and stored in user space (functionality was the same as have X-* now), but due to growing number of use-cases (in initrd, systemd etc.) the -functionality have been extended to keep existing fstab configurations usable +functionality have been extended to keep existing +.I fstab +configurations usable without a change. .TP .BR X-mount.mkdir [ = \fImode\fR ]
@@ -2578,9 +2652,13 @@ comma-separated list as argument to the \fB\-o\fR option. .SH ENVIRONMENT .IP LIBMOUNT_FSTAB=<path> -overrides the default location of the fstab file (ignored for suid) +overrides the default location of the +.I fstab +file (ignored for suid) .IP LIBMOUNT_MTAB=<path> -overrides the default location of the mtab file (ignored for suid) +overrides the default location of the +.I mtab +file (ignored for suid) .IP LIBMOUNT_DEBUG=all enables libmount debug output .IP LIBBLKID_DEBUG=all
@@ -2597,7 +2675,8 @@ filesystem table libmount private runtime directory .TP .I /etc/mtab -table of mounted filesystems or symlink to /proc/mounts +table of mounted filesystems or symlink to +.I /proc/mounts .TP .I /etc/mtab\s+3~\s0 lock file (unused on systems with mtab symlink)
@@ -2643,8 +2722,12 @@ don't match on systems with a regular mtab file. The first file is based only o the mount command options, but the content of the second file also depends on the kernel and others settings (e.g.\& on a remote NFS server -- in certain cases the mount command may report unreliable information about an NFS mount point -and the /proc/mounts file usually contains more reliable information.) This is -another reason to replace the mtab file with a symlink to the +and the +.I /proc/mount +file usually contains more reliable information.) This is +another reason to replace the +.I mtab +file with a symlink to the .I /proc/mounts file. .PP
sys-utils/umount.8 +23 -8
@@ -62,7 +62,8 @@ issues. See \fB\-\-lazy\fR description below. .BR \-a , " \-\-all" All of the filesystems described in .I /proc/self/mountinfo -(or in deprecated /etc/mtab) +(or in deprecated +.IR /etc/mtab ) are unmounted, except the proc, devfs, devpts, sysfs, rpc_pipefs and nfsd filesystems. This list of the filesystems may be replaced by \fB\-\-types\fR umount option.
@@ -73,8 +74,11 @@ for the specified filesystem. The filesystem can be specified by one of the mountpoints or the device name (or UUID, etc.). When this option is used together with \fB\-\-recursive\fR, then all nested mounts within the filesystem are recursively unmounted. -This option is only supported on systems where /etc/mtab is a symlink -to /proc/mounts. +This option is only supported on systems where +.I /etc/mtab +is a symlink +to +.IR /proc/mounts . .TP .BR \-c , " \-\-no\-canonicalize" Do not canonicalize paths. The paths canonicalization is based on
@@ -135,7 +139,13 @@ Perform umount in the mount namespace specified by \fIns\fR. or special file representing that namespace. .sp .BR umount (8) -switches to the namespace when it reads /etc/fstab, writes /etc/mtab (or writes to /run/mount) and calls +switches to the namespace when it reads +.IR /etc/fstab , +writes +.IR /etc/mtab +(or writes to +.IR /run/mount ) +and calls .BR umount (2) system call, otherwise it runs in the original namespace. It means that the target mount namespace does not have
@@ -163,7 +173,9 @@ Suppress "not mounted" error messages. .BR \-R , " \-\-recursive" Recursively unmount each specified directory. Recursion for each directory will stop if any unmount operation in the chain fails for any reason. The relationship -between mountpoints is determined by /proc/self/mountinfo entries. The filesystem +between mountpoints is determined by +.I /proc/self/mountinfo +entries. The filesystem must be specified by mountpoint path; a recursive unmount by device name (or UUID) is unsupported. .TP
@@ -181,7 +193,8 @@ to indicate that no action should be taken for all of the mentioned types. Note that .B umount reads information about mounted filesystems from kernel (/proc/mounts) and -filesystem names may be different than filesystem names used in the /etc/fstab +filesystem names may be different than filesystem names used in the +.I /etc/fstab (e.g., "nfs4" vs. "nfs"). .TP .BR \-v , " \-\-verbose"
@@ -216,7 +229,8 @@ The .B umount command will automatically detach loop device previously initialized by .BR mount (8) -command independently of /etc/mtab. +command independently of +.IR /etc/mtab . In this case the device is initialized with "autoclear" flag (see .BR losetup (8)
@@ -266,7 +280,8 @@ enables libmount debug output .TP .I /etc/mtab table of mounted filesystems (deprecated and usually replaced by -symlink to /proc/mounts) +symlink to +.IR /proc/mounts ) .TP .I /etc/fstab table of known filesystems
Signature · 1 line
2.26.2
PATCH 6/10 Manual pages: mount.8: SEE ALSO: add some obvious references
In reply to Michael Kerrisk (man-pages)And correct sort order for "umount(8)" entry.
--- sys-utils/mount.8 | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-)
sys-utils/mount.8 +4 -1
@@ -2759,13 +2759,15 @@ Karel Zak <[email protected]> .fi .SH SEE ALSO .na +.BR lsblk (1), .BR mount (2), .BR umount (2), -.BR umount (8), +.BR fileystems (5), .BR fstab (5), .BR nfs (5), .BR xfs (5), .BR mount_namespaces (7) +.BR xattr (7) .BR e2label (8), .BR findmnt (8), .BR losetup (8),
@@ -2774,6 +2776,7 @@ Karel Zak <[email protected]> .BR nfsd (8), .BR swapon (8), .BR tune2fs (8), +.BR umount (8), .BR xfs_admin (8) .ad .SH AVAILABILITY
Signature · 1 line
2.26.2
PATCH 7/10 Manual pages: mount.8: Typo fix (remove an accidental paragraph break)
In reply to Michael Kerrisk (man-pages)--- sys-utils/mount.8 | 1 - 1 file changed, 1 deletion(-)
sys-utils/mount.8 +0 -1
@@ -1048,7 +1048,6 @@ The option is useful when mounting filesystems that do not support extended attributes, such as a floppy or hard disk formatted with VFAT, or systems that are not normally running under SELinux, such as an ext3 or ext4 formatted - disk from a non-SELinux workstation. You can also use .B context= on filesystems you do not trust, such as a floppy. It also helps in compatibility with
Signature · 1 line
2.26.2
PATCH 8/10 Manual pages: mount.8: Rewrite FILESYSTEM-SPECIFIC MOUNT OPTIONS intro
In reply to Michael Kerrisk (man-pages)Add a table listing other manual pages that describe mount options of some widely used filesystems. Additionally, rewrite the remaining text to be a bit easier to read.
--- sys-utils/mount.8 | 38 ++++++++++++++++++++++++++------------ 1 file changed, 26 insertions(+), 12 deletions(-)
sys-utils/mount.8 +26 -12
@@ -1396,23 +1396,37 @@ only for root users or when mount executed without suid permissions. The option is also supported as x-mount.mkdir, this notation is deprecated since v2.30. .SH FILESYSTEM-SPECIFIC MOUNT OPTIONS -You should consult the respective man page for the filesystem first. -If you want to know what options the ext4 filesystem supports, then check the -.BR ext4 (5) -man page. -If that doesn't exist, you can also check the corresponding mount page like -.BR mount.cifs (8). -Note that you might have to install the respective userland tools. -.sp +This section lists options that are specific to particular filesystems. +Where possible, you should first consult filesystem-specific manual pages +for details. +Some of those pages are listed in the following table. +.TS +lb lb +l l. +Filesystem(s) Manual page +btrfs \fBbtrfs\fP(5) +cifs \fBmount.cifs\fP(8) +ext2, ext3, ext4 \fBext4\fP(5) +fuse \fBfuse\fP(8) +nfs \fBnfs\fP(5) +tmpfs \fBtmpfs\fP(5) +xfs \fBxfs\fP(5) +.TE +.PP +Note that some of the pages listed above might be available only +after you install the respective userland tools. +.PP The following options apply only to certain filesystems. -We sort them by filesystem. They all follow the +We sort them by filesystem. +All options follow the .B \-o flag. -.sp +.PP What options are supported depends a bit on the running kernel. -More info may be found in the kernel source subdirectory +Further information may be available in fileystem-specific +files in the kernel source subdirectory .IR Documentation/filesystems . - +.\" .SS "Mount options for adfs" .TP \fBuid=\fP\,\fIvalue\fP and \fBgid=\fP\,\fIvalue\fP
Signature · 1 line
2.26.2
PATCH 9/10 Manual pages: umount.8: use "filesystem" consistently
In reply to Michael Kerrisk (man-pages)Currently, this page has a mix of "filesystem" and file system", with the former being predominant. Let's settle on one.
--- sys-utils/umount.8 | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-)
sys-utils/umount.8 +5 -5
@@ -24,7 +24,7 @@ .\" .TH UMOUNT 8 "July 2014" "util-linux" "System Administration" .SH NAME -umount \- unmount file systems +umount \- unmount filesystems .SH SYNOPSIS .B umount \-a .RB [ \-dflnrv ]
@@ -43,13 +43,13 @@ umount \- unmount file systems .SH DESCRIPTION The .B umount -command detaches the mentioned file system(s) from the file hierarchy. A -file system is specified by giving the directory where it has been -mounted. Giving the special device on which the file system lives may +command detaches the mentioned filesystem(s) from the file hierarchy. A +filesystem is specified by giving the directory where it has been +mounted. Giving the special device on which the filesystem lives may also work, but is obsolete, mainly because it will fail in case this device was mounted on more than one directory. .PP -Note that a file system cannot be unmounted when it is 'busy' - for +Note that a filesystem cannot be unmounted when it is 'busy' - for example, when there are open files on it, or when some process has its working directory there, or when a swap file on it is in use. The offending process could even be
Signature · 1 line
2.26.2
Karel Zak
maintainerQuoted 2 lines · Michael Kerrisk (man-pages)
sys-utils/unshare.1 | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-)
All 10 patches applied. Thanks!
Karel
Signature · 2 lines
Karel Zak <[email protected]> http://karelzak.blogspot.com
Hi Karel!
Quoted 5 lines · Karel Zak
Quoted 2 lines · Michael Kerrisk (man-pages)
sys-utils/unshare.1 | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-)All 10 patches applied. Thanks!
I just wanted to say Thank You to you for being such a busy maintainer! It's really refreshing to see how fast new patches are reviewed and applied for util-linux knowing that in other projects, reviews can take days or even weeks!
Kudos!
Adrian
Signature · 4 lines
.''`. John Paul Adrian Glaubitz : :' : Debian Developer - [email protected] `. `' Freie Universitaet Berlin - [email protected] `- GPG: 62FF 8A75 84E0 2956 9546 0006 7426 3B37 F5B5 F913
Karel Zak
maintainerQuoted 2 lines · John Paul Adrian Glaubitz
Quoted 1 line
All 10 patches applied. Thanks!
I just wanted to say Thank You to you for being such a busy maintainer! It's really
Thanks to Red Hat -- it's my fulltime job (together maintenance for RHEL/Fedora).
Quoted 2 lines
refreshing to see how fast new patches are reviewed and applied for util-linux knowing that in other projects, reviews can take days or even weeks!
Well, on github we have some pending issues/PR ...
Thanks for your feedback :-)
Karel
Signature · 2 lines
Karel Zak <[email protected]> http://karelzak.blogspot.com
Thanks, Karel!
Quoted 13 lines · Karel Zak
Quoted 2 lines · Michael Kerrisk (man-pages)
sys-utils/unshare.1 | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-)All 10 patches applied. Thanks!
Karel
--
Karel Zak <[email protected]>
http://karelzak.blogspot.com