man-pages/man8/lsns.8.html
2021-03-31 01:06:50 +01:00

154 lines
4.1 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of LSNS</TITLE>
</HEAD><BODY>
<H1>LSNS</H1>
Section: System Administration (8)<BR>Updated: December 2015<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
lsns - list namespaces
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>lsns</B>
[options]
[<I>namespace</I>]
<P>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>lsns</B>
lists information about all the currently accessible namespaces or about the
given <I>namespace</I>. The <I>namespace</I> identifier is an inode number.
<P>
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 <B>--output</B> option together with a columns list in
environments where a stable output is required.
<P>
<B>NSFS</B> column, printed when <B>net</B> is specified for
<B>--type</B> option, is special; it uses multi-line cells.
Use the option <B>--nowrap</B> is for switching to &quot;,&quot; separated single-line
representation.
<P>
Note that <B>lsns</B> 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 <B>unshare --mount-proc</B> for more details).
<B>lsns</B>
is not able to see persistent namespaces without processes where the namespace
instance is held by a bind mount to /proc/<I>pid</I>/ns/<I>type</I>.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-J</B>,<B> --json</B>
<DD>
Use JSON output format.
<DT id="2"><B>-l</B>,<B> --list</B>
<DD>
Use list output format.
<DT id="3"><B>-n</B>,<B> --noheadings</B>
<DD>
Do not print a header line.
<DT id="4"><B>-o</B>,<B> --output </B><I>list</I>
<DD>
Specify which output columns to print. Use <B>--help</B>
to get a list of all supported columns.
<P>
The default list of columns may be extended if <I>list</I> is
specified in the format <B>+</B><I>list</I> (e.g. <B>lsns -o +PATH</B>).
<DT id="5"><B>--output-all</B>
<DD>
Output all available columns.
<DT id="6"><B>-p</B>,<B> --task </B><I>pid</I>
<DD>
Display only the namespaces held by the process with this <I>pid</I>.
<DT id="7"><B>-r</B>,<B> --raw</B>
<DD>
Use the raw output format.
<DT id="8"><B>-t</B>,<B> --type </B><I>type</I>
<DD>
Display the specified <I>type</I> of namespaces only. The supported types are
<B>mnt</B>, <B>net</B>, <B>ipc</B>, <B>user</B>, <B>pid</B>, <B>uts</B> and
<B>cgroup</B>. This option may be given more than once.
<DT id="9"><B>-u</B>,<B> --notruncate</B>
<DD>
Do not truncate text in columns.
<DT id="10"><B>-W</B>,<B> --nowrap</B>
<DD>
Do not use multi-line text in columns.
<DT id="11"><B>-V</B>,<B> --version</B>
<DD>
Display version information and exit.
<DT id="12"><B>-h</B>,<B> --help</B>
<DD>
Display help text and exit.
<P>
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>AUTHORS</H2>
<PRE>
Karel Zak &lt;<A HREF="mailto:kzak@redhat.com">kzak@redhat.com</A>&gt;
</PRE>
<P>
<A NAME="lbAG">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+nsenter">nsenter</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+unshare">unshare</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?2+clone">clone</A></B>(2),
<B><A HREF="/cgi-bin/man/man2html?7+namespaces">namespaces</A></B>(7)
<P>
<A NAME="lbAH">&nbsp;</A>
<H2>AVAILABILITY</H2>
The lsns command is part of the util-linux package and is available from
<A HREF="https://www.kernel.org/pub/linux/utils/util-linux/.">https://www.kernel.org/pub/linux/utils/util-linux/.</A>
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="13"><A HREF="#lbAB">NAME</A><DD>
<DT id="14"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="15"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="16"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="17"><A HREF="#lbAF">AUTHORS</A><DD>
<DT id="18"><A HREF="#lbAG">SEE ALSO</A><DD>
<DT id="19"><A HREF="#lbAH">AVAILABILITY</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:13 GMT, March 31, 2021
</BODY>
</HTML>