rev: be careful with close()

[thirdparty/util-linux.git] / sys-utils / lsns.8

diff --git a/sys-utils/lsns.8 b/sys-utils/lsns.8
index ad50a0698083c57bbc7a0533a7de5d336d1656bc..aba37266942515512a37a955729445a443fd4680 100644 (file)
--- a/sys-utils/lsns.8
+++ b/sys-utils/lsns.8
@@ -1,4 +1,4 @@
-.\" Man page for the lslocks command.
+.\" Man page for the lsns command.
 .\" Copyright 2015 Karel Zak <kzak@redhat.com>
 .\" May be distributed under the GNU General Public License
 
@@ -8,22 +8,30 @@ lsns \- list namespaces
 .SH SYNOPSIS
 .B lsns
 [options]
-.RB [
-.I namespace
-.RB ]
+.RI [ namespace ]
 
 .SH DESCRIPTION
 .B lsns
 lists information about all the currently accessible namespaces or about the
 given \fInamespace\fP.  The \fInamespace\fP identifier is an inode number.
 
-Note that lsns reads information directly from /proc filesystem and for
-non-root users it may returns incomplete information. The current 
-/proc filesystem may be unshared and affected by PID namespace (see \fBunshare --mount-proc\fP
-for more details).
+The default output is subject to change.  So whenever possible, you should
+avoid using default outputs in your scripts.  Always explicitly define expected
+columns by using the \fB\-\-output\fR option together with a columns list in
+environments where a stable output is required.
+
+\fBNSFS\fP column, printed when \fBnet\fP is specified for
+\fB\-\-type\fR option, is special; it uses multi-line cells.
+Use the option \fB\-\-nowrap\fR is for switching to "," separated single-line
+representation.
+
+Note that \fBlsns\fR reads information directly from the /proc filesystem and
+for non-root users it may return incomplete information.  The current /proc
+filesystem may be unshared and affected by a PID namespace
+(see \fBunshare \-\-mount\-proc\fP for more details).
 .B lsns
-is not able to see persistent namespaces without processes where the namespace 
-instance is hold by the bind mount to /proc/[pid]/ns/[type].
+is not able to see persistent namespaces without processes where the namespace
+instance is held by a bind mount to /proc/\fIpid\fR/ns/\fItype\fR.
 
 .SH OPTIONS
 .TP
@@ -37,27 +45,32 @@ Use list output format.
 Do not print a header line.
 .TP
 .BR \-o , " \-\-output " \fIlist\fP
-Specify which output columns to print.  Use
-.B "--help"
+Specify which output columns to print.  Use \fB\-\-help\fR
 to get a list of all supported columns.
 
 The default list of columns may be extended if \fIlist\fP is
-specified in the format \fI+list\fP (e.g. \fBlsns -o +PATH\fP).
+specified in the format \fB+\fIlist\fP (e.g. \fBlsns \-o +PATH\fP).
+.TP
+.B \-\-output\-all
+Output all available columns.
 .TP
 .BR \-p , " \-\-task " \fIpid\fP
-Display only the namepsaces held by the process with this \fIpid\fR.
+Display only the namespaces held by the process with this \fIpid\fR.
 .TP
 .BR \-r , " \-\-raw"
 Use the raw output format.
 .TP
 .BR \-t , " \-\-type " \fItype\fP
-Display specified \fItype\fP of the namespaces only. The supported types are
-\fBmnt\fP, \fBnet\fP, \fBipc\fP, \fBuser\fP, \fBpid\fP and \fButs\fP. This
-option may be given more than once.
+Display the specified \fItype\fP of namespaces only.  The supported types are
+\fBmnt\fP, \fBnet\fP, \fBipc\fP, \fBuser\fP, \fBpid\fP, \fButs\fP and
+\fBcgroup\fP.  This option may be given more than once.
 .TP
 .BR \-u , " \-\-notruncate"
 Do not truncate text in columns.
 .TP
+.BR \-W , " \-\-nowrap"
+Do not use multi-line text in columns.
+.TP
 .BR \-V , " \-\-version"
 Display version information and exit.
 .TP
@@ -70,10 +83,11 @@ Karel Zak <kzak@redhat.com>
 .fi
 
 .SH "SEE ALSO"
-.BR unshare (1),
 .BR nsenter (1),
-.BR clone (2)
+.BR unshare (1),
+.BR clone (2),
+.BR namespaces (7)
 
 .SH AVAILABILITY
 The lsns command is part of the util-linux package and is available from
-ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
+https://www.kernel.org/pub/linux/utils/util-linux/.