Import sources from 2011-03-30 iso image - sys/man

1 files changed, 44 insertions, 0 deletions

diff --git a/sys/man/1/ns b/sys/man/1/ns
new file mode 100755
index 000000000..b62398abc
--- /dev/null
+++ b/sys/man/1/ns
@@ -0,0 +1,44 @@
+.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.