From 69a7761b957b70297ab10e6ace2c03facac721ce Mon Sep 17 00:00:00 2001
From: Lubomir Rintel
Date: Sun, 28 Dec 2014 21:23:37 +0100
Subject: unshare: add some examples

...and fix one typo.

Signed-off-by: Lubomir Rintel <lkundrak@v3.sk>
Signed-off-by: Karel Zak <kzak@redhat.com>
---
 sys-utils/unshare.1 | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

(limited to 'sys-utils/unshare.1')

diff --git a/sys-utils/unshare.1 b/sys-utils/unshare.1
index ab0614efd..0ef43a1c9 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),
-- 
cgit v1.2.3-55-g7522