summaryrefslogtreecommitdiffstats
path: root/sys-utils/lsns.8
blob: ad50a0698083c57bbc7a0533a7de5d336d1656bc (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
.\" Man page for the lslocks command.
.\" Copyright 2015 Karel Zak <kzak@redhat.com>
.\" May be distributed under the GNU General Public License

.TH LSNS 8 "December 2015" "util-linux" "System Administration"
.SH NAME
lsns \- list namespaces
.SH SYNOPSIS
.B lsns
[options]
.RB [
.I namespace
.RB ]

.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).
.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].

.SH OPTIONS
.TP
.BR \-J , " \-\-json"
Use JSON output format.
.TP
.BR \-l , " \-\-list"
Use list output format.
.TP
.BR \-n , " \-\-noheadings"
Do not print a header line.
.TP
.BR \-o , " \-\-output " \fIlist\fP
Specify which output columns to print.  Use
.B "--help"
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).
.TP
.BR \-p , " \-\-task " \fIpid\fP
Display only the namepsaces 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.
.TP
.BR \-u , " \-\-notruncate"
Do not truncate text in columns.
.TP
.BR \-V , " \-\-version"
Display version information and exit.
.TP
.BR \-h , " \-\-help"
Display help text and exit.

.SH AUTHORS
.nf
Karel Zak <kzak@redhat.com>
.fi

.SH "SEE ALSO"
.BR unshare (1),
.BR nsenter (1),
.BR clone (2)

.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/.