]>
Commit | Line | Data |
---|---|---|
295b3979 | 1 | //po4a: entry man manual |
6d5b6948 MB |
2 | //// |
3 | Man page for the lsns command. | |
4 | Copyright 2015 Karel Zak <kzak@redhat.com> | |
5 | May be distributed under the GNU General Public License | |
6 | //// | |
7 | = lsns(8) | |
8 | :doctype: manpage | |
a09649ca | 9 | :man manual: System Administration |
6d5b6948 MB |
10 | :man source: util-linux {release-version} |
11 | :page-layout: base | |
12 | :command: lsns | |
13 | ||
14 | == NAME | |
15 | ||
16 | lsns - list namespaces | |
17 | ||
18 | == SYNOPSIS | |
19 | ||
4d297435 | 20 | *lsns* [options] _namespace_ |
6d5b6948 MB |
21 | |
22 | == DESCRIPTION | |
23 | ||
24 | *lsns* lists information about all the currently accessible namespaces or about the given _namespace_. The _namespace_ identifier is an inode number. | |
25 | ||
26 | 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. | |
27 | ||
28 | 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. | |
29 | ||
30 | 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_. | |
31 | ||
32 | == OPTIONS | |
33 | ||
34 | *-J*, *--json*:: | |
4eab78d3 | 35 | Use JSON output format. |
6d5b6948 MB |
36 | |
37 | *-l*, *--list*:: | |
4eab78d3 | 38 | Use list output format. |
6d5b6948 MB |
39 | |
40 | *-n*, *--noheadings*:: | |
4eab78d3 | 41 | Do not print a header line. |
6d5b6948 MB |
42 | |
43 | *-o*, *--output* _list_:: | |
4eab78d3 MB |
44 | Specify which output columns to print. Use *--help* to get a list of all supported columns. |
45 | + | |
46 | The default list of columns may be extended if _list_ is specified in the format **+**__list__ (e.g., *lsns -o +PATH*). | |
6d5b6948 MB |
47 | |
48 | *--output-all*:: | |
4eab78d3 | 49 | Output all available columns. |
6d5b6948 MB |
50 | |
51 | *-p*, *--task* _PID_:: | |
4eab78d3 | 52 | Display only the namespaces held by the process with this _PID_. |
6d5b6948 MB |
53 | |
54 | *-r*, *--raw*:: | |
4eab78d3 | 55 | Use the raw output format. |
6d5b6948 MB |
56 | |
57 | *-t*, *--type* _type_:: | |
4eab78d3 | 58 | 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. |
6d5b6948 MB |
59 | |
60 | *-u*, *--notruncate*:: | |
4eab78d3 | 61 | Do not truncate text in columns. |
6d5b6948 MB |
62 | |
63 | *-W*, *--nowrap*:: | |
4eab78d3 | 64 | Do not use multi-line text in columns. |
6d5b6948 MB |
65 | |
66 | *-V*, *--version*:: | |
4eab78d3 | 67 | Display version information and exit. |
6d5b6948 MB |
68 | |
69 | *-h*, *--help*:: | |
4eab78d3 | 70 | Display help text and exit. |
6d5b6948 MB |
71 | |
72 | == AUTHORS | |
73 | ||
74 | mailto:kzak@redhat.com[Karel Zak] | |
75 | ||
76 | == SEE ALSO | |
77 | ||
78 | *nsenter*(1), | |
79 | *unshare*(1), | |
80 | *clone*(2), | |
81 | *namespaces*(7) | |
82 | ||
83 | include::../man-common/bugreports.adoc[] | |
84 | ||
85 | include::../man-common/footer.adoc[] | |
86 | ||
87 | ifdef::translation[] | |
88 | include::../man-common/translation.adoc[] | |
89 | endif::[] |