summaryrefslogtreecommitdiff
path: root/man/1/ns
diff options
context:
space:
mode:
Diffstat (limited to 'man/1/ns')
-rw-r--r--man/1/ns43
1 files changed, 43 insertions, 0 deletions
diff --git a/man/1/ns b/man/1/ns
new file mode 100644
index 00000000..e4a19d31
--- /dev/null
+++ b/man/1/ns
@@ -0,0 +1,43 @@
+.TH NS 1
+.SH NAME
+ns \- display current namespace
+.SH SYNOPSIS
+.B ns
+[
+.B -r
+] [
+.I pid
+]
+.SH DESCRIPTION
+.I Ns
+displays the construction of the namespace of the given
+.IR pid ,
+or its own (as inherited) by default.
+Based on the contents of
+.BI /prog/ pid /ns ,
+it prints on standard output a sequence of bind and mount commands
+(see
+.IR bind (1))
+that might reconstruct the same name space if executed.
+In practice, mounts of services such as
+.IR ftpfs (4)
+often refer to the names of pipe ends that are now inaccessible.
+Furthermore, if any file involved has been renamed since the
+mount or bind, the original name of the file is shown.
+.PP
+Mounts of file services on a network show the network address as
+given to
+.IR sys-dial (2)
+instead of the name of the data file for the connection; the
+.B -r
+option causes
+.I ns
+to show the raw file name instead.
+.SH SOURCE
+.B /appl/cmd/ns.b
+.SH "SEE ALSO"
+.IR bind (1),
+.IR prog (3),
+.IR namespace (4),
+.IR namespace (6)
+