Manual pages: mount.8, umount.8: Clarify that "namespace" means "mount namespace"

[thirdparty/util-linux.git] / sys-utils / umount.8

diff --git a/sys-utils/umount.8 b/sys-utils/umount.8
index b075467d58d83d16d0da3f26a2a9cba37ca15f1b..edcb6cc1f9117aa02c8f8309c3fea3e15c268b8a 100644 (file)
--- a/sys-utils/umount.8
+++ b/sys-utils/umount.8
@@ -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
@@ -190,7 +192,7 @@ Display version information and exit.
 .TP
 .BR \-h , " \-\-help"
 Display help text and exit.
-.SH "NON-SUPERUSER UMOUNTS"
+.SH NON-SUPERUSER UMOUNTS
 Normally, only the superuser can umount filesystems.
 However, when
 .I fstab
@@ -209,7 +211,7 @@ inadequate by internal libmount security rules.  It drops suid permissions
 and continue as regular non-root user. It allows to support use-cases where
 root permissions are not necessary (e.g., fuse filesystems, user namespaces,
 etc).
-.SH "LOOP DEVICE"
+.SH LOOP DEVICE
 The
 .B umount
 command will automatically detach loop device previously initialized by
@@ -253,6 +255,13 @@ to the \fB/sbin/umount.\fItype\fR helper independently of UID.
 .PP
 Note that \fI/etc/mtab\fR is currently deprecated and helper= and another
 userspace mount options are maintained by libmount.
+.SH ENVIRONMENT
+.IP LIBMOUNT_FSTAB=<path>
+overrides the default location of the fstab file (ignored for suid)
+.IP LIBMOUNT_MTAB=<path>
+overrides the default location of the mtab file (ignored for suid)
+.IP LIBMOUNT_DEBUG=all
+enables libmount debug output
 .SH FILES
 .TP
 .I /etc/mtab
@@ -264,21 +273,15 @@ table of known filesystems
 .TP
 .I /proc/self/mountinfo
 table of mounted filesystems generated by kernel.
-.SH ENVIRONMENT
-.IP LIBMOUNT_FSTAB=<path>
-overrides the default location of the fstab file (ignored for suid)
-.IP LIBMOUNT_MTAB=<path>
-overrides the default location of the mtab file (ignored for suid)
-.IP LIBMOUNT_DEBUG=all
-enables libmount debug output
-.SH "SEE ALSO"
-.BR umount (2),
-.BR losetup (8),
-.BR mount (8)
 .SH HISTORY
 A
 .B umount
 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
 .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/