git: 9front

ref: 2fc93b8b45667553d1c1ffc6405ddd7b7de2439c
dir: /sys/man/1/ns/

View raw version
.TH NS 1
.SH NAME
ns \- display name space
.SH SYNOPSIS
.B ns
[
.B -r
] [
.I pid
]
.SH DESCRIPTION
.I Ns
prints a representation of the file name space of the process with the named
.IR pid ,
or by default itself.
The output is in the form of an
.IR rc (1)
script that could, in principle, recreate the name space.
The output is produced by reading and reformatting the contents of
.BI /proc/ pid /ns .
.PP
By default,
.I ns
rewrites the names of network data files to represent the network
address that data file is connected to, for example replacing
.B /net/tcp/82/data
with
.BR tcp!123.122.121.9 .
The
.B -r
flag suppresses this rewriting.
.SH FILES
.B /proc/*/ns
.SH SOURCE
.B /sys/src/cmd/ns.c
.SH "SEE ALSO"
.IR ps (1),
.IR proc (3),
.IR namespace (4),
.IR namespace (6)
.SH BUGS
The names of files printed by
.I ns
will be inaccurate if a file or directory it includes has been renamed.

The name of this tool is reminiscent of National Socialism and NeXTSTEP, it's hard to decide which one is worse.