diff options
| author | Mikhail Gusarov | 2009-10-03 21:42:08 +0200 |
|---|---|---|
| committer | Karel Zak | 2009-10-06 12:45:42 +0200 |
| commit | 4205f1fda1ac32046125a2e0f3937b666186bfab (patch) | |
| tree | ad40e47ea3a9121b020a1b1d7e43e9795c0c406e /sys-utils/unshare.1 | |
| parent | fdformat: fix memory leak in verify_disk() (diff) | |
| download | kernel-qcow2-util-linux-4205f1fda1ac32046125a2e0f3937b666186bfab.tar.gz kernel-qcow2-util-linux-4205f1fda1ac32046125a2e0f3937b666186bfab.tar.xz kernel-qcow2-util-linux-4205f1fda1ac32046125a2e0f3937b666186bfab.zip | |
unshare: new command
New utility allows to run process with separate mount, UTC, IPC or
network namespaces.
[kzak@redhat.com: - some cosmetic changes in usage() and err() usage
- move "if BUILD_UNSHARE" to separate place in Makefile.am
- add unshare to .gitignore]
Signed-off-by: Mikhail Gusarov <dottedmag@dottedmag.net>
Signed-off-by: Karel Zak <kzak@redhat.com>
Diffstat (limited to 'sys-utils/unshare.1')
| -rw-r--r-- | sys-utils/unshare.1 | 58 |
1 files changed, 58 insertions, 0 deletions
diff --git a/sys-utils/unshare.1 b/sys-utils/unshare.1 new file mode 100644 index 000000000..31fcfde74 --- /dev/null +++ b/sys-utils/unshare.1 @@ -0,0 +1,58 @@ +.\" Process this file with +.\" groff -man -Tascii lscpu.1 +.\" +.TH UNSHARE 1 "OCTOBER 2008" Linux "User Manuals" +.SH NAME +unshare \- run program with some namespaces unshared from parent +.SH SYNOPSIS +.B unshare +.RI [ options ] +program +.RI [ arguments ] +.SH DESCRIPTION +Unshares specified namespaces from parent process and then executes specified +program. Unshareable namespaces are: +.TP +.BR "mount namespace" +mounting and unmounting filesystems will not affect rest of the system +(\fBCLONE_NEWNS\fP flag), +.TP +.BR "UTS namespace" +setting hostname, domainname will not affect rest of the system +(\fBCLONE_NEWUTS\fP flag), +.TP +.BR "IPC namespace" +process will have indpendent namespace for System V message queues, semaphore +sets and shared memory segments (\fBCLONE_NEWIPC\fP flag), +.TP +.BR "network namespace" +process will have independent IPv4 and IPv6 stacks, IP routing tables, firewall +rules, the \fI/proc/net\fP and \fI/sys/class/net\fP directory trees, sockets +etc. (\fBCLONE_NEWNET\fP flag). +.TP +See the clone(2) for exact semantics of the flags. +.SH OPTIONS +.TP +.BR \-h , " \-\-help" +Print a help message, +.TP +.BR \-m , " \-\-mount" +Unshare the mount namespace, +.TP +.BR \-u , " \-\-uts" +Unshare the UTC namespace, +.TP +.BR \-i , " \-\-ipc" +Unshare the IPC namespace, +.TP +.BR \-n , " \-\-net" +Unshare the network namespace. +.SH SEE ALSO +unshare(2), clone(2) +.SH BUGS +None known so far. +.SH AUTHOR +Mikhail Gusarov <dottedmag@dottedmag.net> +.SH AVAILABILITY +The unshare command is part of the util-linux-ng package and is available from +ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/. |