proc.5: Rework discussion of /proc/PIC/ns/* files

Rather than repeat the same text six times,
refactor it to occur in just one place.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2013-01-06 19:32:31 +01:00
parent f34f018219
commit 91935e7807
1 changed files with 35 additions and 84 deletions

View File

@ -858,108 +858,59 @@ supports being manipulated by
.BR setns (2).
For information about namespaces, see
.BR clone (2).
Bind mounting (see
.BR mount (2))
one of the files in this directory
to somewhere else in the filesystem keeps
the corresponding namespace of the process specified by
.I pid
alive even if all processes currently in the namespace terminate.
Opening one of the files in this directory returns a file handle for
the corresponding namespace of the process specified by
.IR pid .
As long as this file descriptor remains open,
the namespace will remain alive,
even if all processes in the namespace terminate.
The file descriptor can be passed to
.BR setns (2).
.TP
.IR /proc/[pid]/ns/ipc " (since Linux 3.0)"
Bind mounting this file (see
.BR mount (2))
to somewhere else in the filesystem keeps
the IPC namespace of the process specified by
.I pid
alive even if all processes currently in the namespace terminate.
This file is a handle for the IPC namespace of the process;
see the discussion under
.IR /proc/[pid]/ns/ .
Opening this file returns a file handle for the IPC namespace
of the process specified by
.IR pid .
As long as this file descriptor remains open,
the IPC namespace will remain alive,
even if all processes in the namespace terminate.
The file descriptor can be passed to
.BR setns (2).
.TP
.IR /proc/[pid]/ns/mnt " (since Linux 3.8)"
Bind mounting this file (see
.BR mount (2))
to somewhere else in the filesystem keeps
the mount namespace of the process specified by
.I pid
alive even if all processes currently in the namespace terminate.
This file is a handle for the mount namespace of the process;
see the discussion under
.IR /proc/[pid]/ns/ .
Opening this file returns a file handle for the mount namespace
of the process specified by
.IR pid .
As long as this file descriptor remains open,
the mount namespace will remain alive,
even if all processes in the namespace terminate.
The file descriptor can be passed to
.BR setns (2).
.TP
.IR /proc/[pid]/ns/net " (since Linux 3.0)"
Bind mounting this file (see
.BR mount (2))
to somewhere else in the filesystem keeps
the network namespace of the process specified by
.I pid
alive even if all processes in the namespace terminate.
This file is a handle for the network namespace of the process;
see the discussion under
.IR /proc/[pid]/ns/ .
Opening this file returns a file handle for the network namespace
of the process specified by
.IR pid .
As long as this file descriptor remains open,
the network namespace will remain alive,
even if all processes in the namespace terminate.
The file descriptor can be passed to
.BR setns (2).
.TP
.IR /proc/[pid]/ns/pid " (since Linux 3.8)"
Bind mounting this file (see
.BR mount (2))
to somewhere else in the filesystem keeps
the PID namespace of the process specified by
.I pid
alive even if all processes currently in the namespace terminate.
This file is a handle for the PID namespace of the process;
see the discussion under
.IR /proc/[pid]/ns/ .
Opening this file returns a file handle for the PID namespace
of the process specified by
.IR pid .
As long as this file descriptor remains open,
the PID namespace will remain alive,
even if all processes in the namespace terminate.
The file descriptor can be passed to
.BR setns (2).
.TP
.IR /proc/[pid]/ns/user " (since Linux 3.8)"
Bind mounting this file (see
.BR mount (2))
to somewhere else in the filesystem keeps
the user namespace of the process specified by
.I pid
alive even if all processes currently in the namespace terminate.
This file is a handle for the user namespace of the process;
see the discussion under
.IR /proc/[pid]/ns/ .
Opening this file returns a file handle for the user namespace
of the process specified by
.IR pid .
As long as this file descriptor remains open,
the user namespace will remain alive,
even if all processes in the namespace terminate.
The file descriptor can be passed to
.BR setns (2).
.TP
.IR /proc/[pid]/ns/uts " (since Linux 3.0)"
Bind mounting this file (see
.BR mount (2))
to somewhere else in the filesystem keeps
the UTS namespace of the process specified by
.I pid
alive even if all processes currently in the namespace terminate.
This file is a handle for the IPC namespace of the process;
see the discussion under
.IR /proc/[pid]/ns/ .
Opening this file returns a file handle for the UTS namespace
of the process specified by
.IR pid .
As long as this file descriptor remains open,
the UTS namespace will remain alive,
even if all processes in the namespace terminate.
The file descriptor can be passed to
.BR setns (2).
.TP
.IR /proc/[pid]/numa_maps " (since Linux 2.6.14)"