diff options
-rw-r--r-- | sys-utils/nsenter.1 | 106 | ||||
-rw-r--r-- | sys-utils/unshare.1 | 54 |
2 files changed, 79 insertions, 81 deletions
diff --git a/sys-utils/nsenter.1 b/sys-utils/nsenter.1 index 47895753b..da22d0866 100644 --- a/sys-utils/nsenter.1 +++ b/sys-utils/nsenter.1 @@ -1,44 +1,45 @@ -.TH NSENTER 1 "January 2013" "util-linux" "User Commands" +.TH NSENTER 1 "May 2013" "util-linux" "User Commands" .SH NAME nsenter \- run program with namespaces of other processes .SH SYNOPSIS .B nsenter -.RI [ options ] -.RI [ program ] -.RI [ arguments ] +.RB [ options ] +.RI [ program +.RI [ arguments ]] .SH DESCRIPTION Enters the namespaces of one or more other processes and then executes the specified program. Enterable namespaces are: .TP .B mount namespace -mounting and unmounting filesystems will not affect rest of the system +Mounting and unmounting filesystems will not affect the rest of the system .RB ( CLONE_\:NEWNS -flag), except for filesystems which are explicitly marked as shared (by mount ---make-\:shared). See /proc\:/self\:/mountinfo for the shared flag. +flag), except for filesystems which are explicitly marked as shared (with +\fBmount --make-\:shared\fP; see \fI/proc\:/self\:/mountinfo\fP for the +\fBshared\fP flag). .TP .B UTS namespace -setting hostname, domainname will not affect rest of the system +Setting hostname or domainname will not affect the rest of the system. .RB ( CLONE_\:NEWUTS -flag). +flag) .TP .B IPC namespace -process will have independent namespace for System V message queues, semaphore -sets and shared memory segments +The process will have an independent namespace for System V message queues, +semaphore sets and shared memory segments. .RB ( CLONE_\:NEWIPC -flag). +flag) .TP .B network namespace -process will have independent IPv4 and IPv6 stacks, IP routing tables, firewall -rules, the +The process will have independent IPv4 and IPv6 stacks, IP routing tables, +firewall rules, the .I /proc\:/net and .I /sys\:/class\:/net -directory trees, sockets etc. +directory trees, sockets, etc. .RB ( CLONE_\:NEWNET -flag). +flag) .TP .B PID namespace -children will have a set of PID to process mappings separate from the +Children will have a set of PID to process mappings separate from the .B nsenter process .RB ( CLONE_\:NEWPID @@ -46,23 +47,18 @@ flag). .B nsenter will fork by default if changing the PID namespace, so that the new program and its children share the same PID namespace and are visible to each other. -If \-\-no\-fork is used, the new program will be exec'ed without forking. +If \fB\-\-no\-fork\fP is used, the new program will be exec'ed without forking. .TP .B user namespace -process will have distinct set of UIDs, GIDs and capabilities +The process will have a distinct set of UIDs, GIDs and capabilities. .RB ( CLONE_\:NEWUSER -flag). +flag) .TP -See the -.BR clone (2) -for exact semantics of the flags. +See \fBclone\fP(2) for the exact semantics of the flags. .TP -If program is not given, run ``${SHELL}'' (default: /bin\:/sh). +If \fIprogram\fP is not given, then ``${SHELL}'' is run (default: /bin\:/sh). .SH OPTIONS -Argument with square brakets, such as [\fIfile\fR], means optional argument. -Command line syntax to specify optional argument \-\-mount=/path\:/to\:/file. -Please notice the equals sign. .TP \fB\-t\fR, \fB\-\-target\fR \fIpid\fP Specify a target process to get contexts from. The paths to the contexts @@ -99,56 +95,56 @@ the working directory respectively .PD .RE .TP -\fB\-m\fR, \fB\-\-mount\fR [\fIfile\fR] -Enter the mount namespace. If no file is specified enter the mount namespace -of the target process. If file is specified enter the mount namespace +\fB\-m\fR, \fB\-\-mount\fR[=\fIfile\fR] +Enter the mount namespace. If no file is specified, enter the mount namespace +of the target process. If file is specified, enter the mount namespace specified by file. .TP -\fB\-u\fR, \fB\-\-uts\fR [\fIfile\fR] -Enter the UTS namespace. If no file is specified enter the UTS namespace of -the target process. If file is specified enter the UTS namespace specified by +\fB\-u\fR, \fB\-\-uts\fR[=\fIfile\fR] +Enter the UTS namespace. If no file is specified, enter the UTS namespace of +the target process. If file is specified, enter the UTS namespace specified by file. .TP -\fB\-i\fR, \fB\-\-ipc\fR [\fIfile\fR] -Enter the IPC namespace. If no file is specified enter the IPC namespace of -the target process. If file is specified enter the IPC namespace specified by +\fB\-i\fR, \fB\-\-ipc\fR[=\fIfile\fR] +Enter the IPC namespace. If no file is specified, enter the IPC namespace of +the target process. If file is specified, enter the IPC namespace specified by file. .TP -\fB\-n\fR, \fB\-\-net\fR [\fIfile\fR] -Enter the network namespace. If no file is specified enter the network -namespace of the target process. If file is specified enter the network +\fB\-n\fR, \fB\-\-net\fR[=\fIfile\fR] +Enter the network namespace. If no file is specified, enter the network +namespace of the target process. If file is specified, enter the network namespace specified by file. .TP -\fB\-p\fR, \fB\-\-pid\fR [\fIfile\fR] -Enter the PID namespace. If no file is specified enter the PID namespace of -the target process. If file is specified enter the PID namespace specified by +\fB\-p\fR, \fB\-\-pid\fR[=\fIfile\fR] +Enter the PID namespace. If no file is specified, enter the PID namespace of +the target process. If file is specified, enter the PID namespace specified by file. .TP -\fB\-U\fR, \fB\-\-user\fR [\fIfile\fR] -Enter the user namespace. If no file is specified enter the user namespace of -the target process. If file is specified enter the user namespace specified by +\fB\-U\fR, \fB\-\-user\fR[=\fIfile\fR] +Enter the user namespace. If no file is specified, enter the user namespace of +the target process. If file is specified, enter the user namespace specified by file. .TP -\fB\-r\fR, \fB\-\-root\fR [\fIdirectory\fR] -Set the root directory. If no directory is specified set the root directory to -the root directory of the target process. If directory is specified set the +\fB\-r\fR, \fB\-\-root\fR[=\fIdirectory\fR] +Set the root directory. If no directory is specified, set the root directory to +the root directory of the target process. If directory is specified, set the root directory to the specified directory. .TP -\fB\-w\fR, \fB\-\-wd\fR [\fIdirectory\fR] -Set the working directory. If no directory is specified set the working +\fB\-w\fR, \fB\-\-wd\fR[=\fIdirectory\fR] +Set the working directory. If no directory is specified, set the working directory to the working directory of the target process. If directory is -specified set the working directory to the specified directory. +specified, set the working directory to the specified directory. .TP \fB\-F\fR, \fB\-\-no-fork\fR -Do not fork before exec'ing the specified program. By default when entering a -pid namespace enter calls fork before calling exec so that the children will be -in the newly entered pid namespace. +Do not fork before exec'ing the specified program. By default, when entering a +PID namespace, \fBnsenter\fP calls \fBfork\fP before calling \fBexec\fP so that +any children will also be in the newly entered PID namespace. .TP \fB\-V\fR, \fB\-\-version\fR Display version information and exit. .TP \fB\-h\fR, \fB\-\-help\fR -Print a help message. +Display a help message and exit. .SH SEE ALSO .BR setns (2), .BR clone (2) diff --git a/sys-utils/unshare.1 b/sys-utils/unshare.1 index 58f2bb228..5503fafa0 100644 --- a/sys-utils/unshare.1 +++ b/sys-utils/unshare.1 @@ -1,57 +1,56 @@ .\" Process this file with .\" groff -man -Tascii lscpu.1 .\" -.TH UNSHARE 1 "January 2013" "util-linux" "User Commands" +.TH UNSHARE 1 "May 2013" "util-linux" "User Commands" .SH NAME unshare \- run program with some namespaces unshared from parent .SH SYNOPSIS .B unshare -.RI [ options ] -program +.RB [ options ] +.I program .RI [ arguments ] .SH DESCRIPTION -Unshares specified namespaces from parent process and then executes specified -program. Unshareable namespaces are: +Unshares the indicated namespaces from the parent process and then executes +the specified program. Unshareable namespaces are: .TP .BR "mount namespace" -mounting and unmounting filesystems will not affect rest of the system +Mounting and unmounting filesystems will not affect the rest of the system (\fBCLONE_NEWNS\fP flag), except for filesystems which are explicitly marked as -shared (by mount --make-shared). See /proc/self/mountinfo for the shared flags. +shared (with \fBmount --make-shared\fP; see \fI/proc/self/mountinfo\fP for the +\fBshared\fP flags). .TP .BR "UTS namespace" -setting hostname, domainname will not affect rest of the system -(\fBCLONE_NEWUTS\fP flag). +Setting hostname or domainname will not affect the rest of the system. +(\fBCLONE_NEWUTS\fP flag) .TP .BR "IPC namespace" -process will have independent namespace for System V message queues, semaphore -sets and shared memory segments (\fBCLONE_NEWIPC\fP flag). +The process will have an independent 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). +The 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 .BR "pid namespace" -children will have a distinct set of pid to process mappings than their parent. -(\fBCLONE_NEWPID\fP flag). +Children will have a distinct set of PID to process mappings from their parent. +(\fBCLONE_NEWPID\fP flag) .TP .BR "user namespace" -process will have distinct set of uids, gids and capabilities. (\fBCLONE_NEWUSER\fP flag). +The process will have a distinct set of UIDs, GIDs and capabilities. +(\fBCLONE_NEWUSER\fP flag) .TP -See the \fBclone\fR(2) for exact semantics of the flags. +See \fBclone\fR(2) for the 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 UTS namespace, +Display a help message and exit. .TP .BR \-i , " \-\-ipc" -Unshare the IPC namespace, +Unshare the IPC namespace. +.TP +.BR \-m , " \-\-mount" +Unshare the mount namespace. .TP .BR \-n , " \-\-net" Unshare the network namespace. @@ -59,6 +58,9 @@ Unshare the network namespace. .BR \-p , " \-\-pid" Unshare the pid namespace. .TP +.BR \-u , " \-\-uts" +Unshare the UTS namespace. +.TP .BR \-U , " \-\-user" Unshare the user namespace. .SH SEE ALSO |