From: Lubomir Rintel <lkundrak@v3.sk>
Date: Sun, 28 Dec 2014 20:23:37 +0000 (+0100)
Subject: unshare: add some examples
X-Git-Tag: v2.26-rc1~41
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=69a7761b957b70297ab10e6ace2c03facac721ce;p=thirdparty%2Futil-linux.git

unshare: add some examples

...and fix one typo.

Signed-off-by: Lubomir Rintel <lkundrak@v3.sk>
Signed-off-by: Karel Zak <kzak@redhat.com>
---

diff --git a/sys-utils/unshare.1 b/sys-utils/unshare.1
index ab0614efda..0ef43a1c96 100644
--- a/sys-utils/unshare.1
+++ b/sys-utils/unshare.1
@@ -103,6 +103,20 @@ Display version information and exit.
 .TP
 .BR \-h , " \-\-help"
 Display help text and exit.
+.SH EXAMPLES
+.TP
+.B # unshare --fork --pid --mount-proc readlink /proc/self
+.TQ
+1
+.br
+Establish a PID namespace, ensure we're PID 1 in it against newly mounted
+procfs instance.
+.TP
+.B $ unshare --map-root-user --user sh -c whoami
+.TQ
+root
+.br
+Establish a user namespace as an unprivileged user with a root user within it.
 .SH SEE ALSO
 .BR unshare (2),
 .BR clone (2),