setns.2: Edited in review comments from Eric Biederman

Reviewed-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2011-10-03 08:33:39 +02:00
parent 92dcb22063
commit 7aa166c58d
1 changed files with 10 additions and 8 deletions

View File

@ -3,7 +3,7 @@
.\"
.TH SETNS 2 2011-09-15 "Linux" "Linux Programmer's Manual"
.SH NAME
setns \- reassociate process with a namespace
setns \- reassociate thread with a namespace
.SH SYNOPSIS
.nf
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
@ -13,7 +13,7 @@ setns \- reassociate process with a namespace
.fi
.SH DESCRIPTION
Given a file descriptor referring to a namespace,
reassociate the calling process with that namespace.
reassociate the calling thread with that namespace.
The
.I fd
@ -23,7 +23,7 @@ directory; see
.BR proc (5)
for further information on
.IR /proc/[pid]/ns/ .
The calling process will be reassociated with the corresponding namespace,
The calling thread will be reassociated with the corresponding namespace,
subject to any constraints imposed by the
.I nstype
argument.
@ -31,7 +31,7 @@ argument.
The
.I nstype
argument specifies which type of namespace
the calling process may be reassociated with.
the calling thread may be reassociated with.
This argument can have one of the following values:
.TP
.BR 0
@ -79,13 +79,15 @@ is not a valid file descriptor.
.B EINVAL
.I fd
refers to a namespace whose type does not match that specified in
.IR nstype .
.IR nstype ,
or there is problem with reassociating the
the thread with the specified namespace.
.TP
.B ENOMEM
Cannot allocate sufficient memory to change the specified namespace.
.TP
.B EPERM
The calling process did not have the required privilege
The calling thread did not have the required privilege
.RB ( CAP_SYS_ADMIN )
for this operation.
.SH VERSIONS
@ -97,8 +99,8 @@ The
.BR setns ()
system call is Linux-specific.
.SH NOTES
Not all of the process attributes that can be shared when
a new process is created using
Not all of the attributes that can be shared when
a new thread is created using
.BR clone (2)
can be changed using
.BR setns ().