unshare(1)

1UNSHARE(1)                       User Manuals                       UNSHARE(1)
2
3
4

NAME

6       unshare - run program with some namespaces unshared from parent
7

SYNOPSIS

9       unshare [options] program [arguments]
10

DESCRIPTION

12       Unshares  specified  namespaces  from  parent process and then executes
13       specified program. Unshareable namespaces are:
14
15       mount namespace
16              mounting and unmounting filesystems will not affect rest of  the
17              system (CLONE_NEWNS flag),
18
19       UTS namespace
20              setting  hostname, domainname will not affect rest of the system
21              (CLONE_NEWUTS flag),
22
23       IPC namespace
24              process will have indpendent  namespace  for  System  V  message
25              queues,  semaphore sets and shared memory segments (CLONE_NEWIPC
26              flag),
27
28       network namespace
29              process will have independent IPv4 and IPv6 stacks,  IP  routing
30              tables,  firewall rules, the /proc/net and /sys/class/net direc‐
31              tory trees, sockets etc. (CLONE_NEWNET flag).
32
33       See the clone(2) for exact semantics of the flags.
34

OPTIONS

36       -h, --help
37              Print a help message,
38
39       -m, --mount
40              Unshare the mount namespace,
41
42       -u, --uts
43              Unshare the UTC namespace,
44
45       -i, --ipc
46              Unshare the IPC namespace,
47
48       -n, --net
49              Unshare the network namespace.
50

NOTES

52       The unshare command drops potential  privileges  before  executing  the
53       target program. This allows to setuid unshare.
54

BUGS

59       None known so far.
60

AUTHOR

62       Mikhail Gusarov <dottedmag@dottedmag.net>
63

AVAILABILITY

65       The  unshare command is part of the util-linux-ng package and is avail‐
66       able from ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.
67
68
69
70Linux                            OCTOBER 2008                       UNSHARE(1)