| .\" 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/. |
