summaryrefslogtreecommitdiffstats
path: root/sys-utils/unshare.1
diff options
context:
space:
mode:
authorBenno Schulenberg2013-10-14 22:02:00 +0200
committerKarel Zak2013-10-15 10:28:31 +0200
commit87ec43b671d4d67d2f2afa16c5d6c6ab3fe6b768 (patch)
treec84fa3ad585232fc3e1b7765eadcb1ffab042bb0 /sys-utils/unshare.1
parentdocs: standardize the phrases for --help and --version in all man pages (diff)
downloadkernel-qcow2-util-linux-87ec43b671d4d67d2f2afa16c5d6c6ab3fe6b768.tar.gz
kernel-qcow2-util-linux-87ec43b671d4d67d2f2afa16c5d6c6ab3fe6b768.tar.xz
kernel-qcow2-util-linux-87ec43b671d4d67d2f2afa16c5d6c6ab3fe6b768.zip
docs: tweak wording and formatting of unshare and nsenter man pages
Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
Diffstat (limited to 'sys-utils/unshare.1')
-rw-r--r--sys-utils/unshare.116
1 files changed, 9 insertions, 7 deletions
diff --git a/sys-utils/unshare.1 b/sys-utils/unshare.1
index d88b07344..b78ace833 100644
--- a/sys-utils/unshare.1
+++ b/sys-utils/unshare.1
@@ -1,17 +1,18 @@
.\" Process this file with
.\" groff -man -Tascii lscpu.1
.\"
-.TH UNSHARE 1 "May 2013" "util-linux" "User Commands"
+.TH UNSHARE 1 "July 2013" "util-linux" "User Commands"
.SH NAME
unshare \- run program with some namespaces unshared from parent
.SH SYNOPSIS
.B unshare
-.RB [ options ]
+.RI [ options ]
.I program
.RI [ arguments ]
.SH DESCRIPTION
Unshares the indicated namespaces from the parent process and then executes
-the specified program. Unshareable namespaces are:
+the specified program. The namespaces to be unshared are indicated via
+options. Unshareable namespaces are:
.TP
.BR "mount namespace"
Mounting and unmounting filesystems will not affect the rest of the system
@@ -56,7 +57,8 @@ Unshare the mount namespace.
Unshare the network namespace.
.TP
.BR \-p , " \-\-pid"
-Unshare the pid namespace. See also \fB--fork\fP and \fB--mount-proc\fP options.
+Unshare the pid namespace.
+See also the \fB--fork\fP and \fB--mount-proc\fP options.
.TP
.BR \-u , " \-\-uts"
Unshare the UTS namespace.
@@ -65,10 +67,10 @@ Unshare the UTS namespace.
Unshare the user namespace.
.TP
.BR \-f , " \-\-fork"
-Fork the specified process as a child of unshare rather than running it
-directly. This is useful when creating a new pid namespace.
+Fork the specified \fIprogram\fR as a child process of \fBunshare\fR rather than
+running it directly. This is useful when creating a new pid namespace.
.TP
-.BR "\fB\-\-mount-proc\fR [=\fImountpoint\fP]"
+.BR \-\-mount-proc "[=\fImountpoint\fP]"
Just before running the program, mount the proc filesystem at the \fImountpoint\fP
(default is /proc). This is useful when creating a new pid namespace. It also
implies creating a new mount namespace since the /proc mount would otherwise