lsns(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | AUTHORS | SEE ALSO | AVAILABILITY | COLOPHON


LSNS(8)                   System Administration                  LSNS(8)

NAME         top

       lsns - list namespaces

SYNOPSIS         top

       lsns [options] [namespace]

DESCRIPTION         top

       lsns lists information about all the currently accessible
       namespaces or about the given namespace.  The namespace
       identifier is an inode number.

       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 --output option
       together with a columns list in environments where a stable
       output is required.

       The NSFS column, printed when net is specified for the --type
       option, is special; it uses multi-line cells. Use the option
       --nowrap to switch to ","-separated single-line representation.

       Note that lsns 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 unshare --mount-proc for more
       details).  lsns is not able to see persistent namespaces without
       processes where the namespace instance is held by a bind mount to
       /proc/pid/ns/type.

OPTIONS         top

       -J, --json
              Use JSON output format.

       -l, --list
              Use list output format.

       -n, --noheadings
              Do not print a header line.

       -o, --output list
              Specify which output columns to print.  Use --help to get
              a list of all supported columns.

              The default list of columns may be extended if list is
              specified in the format +list (e.g., lsns -o +PATH).

       --output-all
              Output all available columns.

       -p, --task pid
              Display only the namespaces held by the process with this
              pid.

       -r, --raw
              Use the raw output format.

       -t, --type type
              Display the specified type of namespaces only.  The
              supported types are mnt, net, ipc, user, pid, uts, cgroup
              and time.  This option may be given more than once.

       -u, --notruncate
              Do not truncate text in columns.

       -W, --nowrap
              Do not use multi-line text in columns.

       -V, --version
              Display version information and exit.

       -h, --help
              Display help text and exit.

AUTHORS         top

       Karel Zak <kzak@redhat.com>

SEE ALSO         top

       nsenter(1), unshare(1), clone(2), namespaces(7)

AVAILABILITY         top

       The lsns command is part of the util-linux package and is
       available from
       https://www.kernel.org/pub/linux/utils/util-linux/.

COLOPHON         top

       This page is part of the util-linux (a random collection of Linux
       utilities) project.  Information about the project can be found
       at ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩.  If you
       have a bug report for this manual page, send it to
       util-linux@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository
       ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
       2021-03-21.  (At that time, the date of the most recent commit
       that was found in the repository was 2021-03-19.)  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to man-pages@man7.org

util-linux                    December 2015                      LSNS(8)

Pages that refer to this page: namespaces(7)