]> git.ipfire.org Git - thirdparty/util-linux.git/blame - misc-utils/namei.1.adoc
Merge branch 'sed' of https://github.com/t-8ch/util-linux
[thirdparty/util-linux.git] / misc-utils / namei.1.adoc
CommitLineData
295b3979 1//po4a: entry man manual
6c64d12d
MB
2= namei(1)
3:doctype: manpage
4:man manual: User Commands
5:man source: util-linux {release-version}
6:page-layout: base
7:command: namei
8
9== NAME
10
11namei - follow a pathname until a terminal point is found
12
13== SYNOPSIS
14
15*namei* [options] _pathname_...
16
17== DESCRIPTION
18
19*namei* interprets its arguments as pathnames to any type of Unix file (symlinks, files, directories, and so forth). *namei* then follows each pathname until an endpoint is found (a file, a directory, a device node, etc). If it finds a symbolic link, it shows the link, and starts following it, indenting the output to show the context.
20
21This program is useful for finding "too many levels of symbolic links" problems.
22
23For each line of output, *namei* uses the following characters to identify the file type found:
24
25....
26 f: = the pathname currently being resolved
27 d = directory
28 l = symbolic link (both the link and its contents are output)
29 s = socket
30 b = block device
31 c = character device
32 p = FIFO (named pipe)
33 - = regular file
34 ? = an error of some kind
35....
36
37*namei* prints an informative message when the maximum number of symbolic links this system can have has been exceeded.
38
39== OPTIONS
40
41*-l*, *--long*::
2c646c80 42Use the long listing format (same as *-m -o -v*).
6c64d12d
MB
43
44*-m*, *--modes*::
2c646c80 45Show the mode bits of each file type in the style of *ls*(1), for example 'rwxr-xr-x'.
6c64d12d
MB
46
47*-n*, *--nosymlinks*::
2c646c80 48Don't follow symlinks.
6c64d12d
MB
49
50*-o*, *--owners*::
2c646c80 51Show owner and group name of each file.
6c64d12d
MB
52
53*-v*, *--vertical*::
2c646c80 54Vertically align the modes and owners.
6c64d12d
MB
55
56*-x*, *--mountpoints*::
2c646c80 57Show mountpoint directories with a 'D' rather than a 'd'.
6c64d12d 58
e928e8ed
KZ
59*-Z*, *--context*::
60Show security context of the file or "?" if not available.
2b53db33 61The support for security contexts is optional and does not have to be compiled to the *namei* binary.
e928e8ed 62
2b2d3172 63include::man-common/help-version.adoc[]
6c64d12d
MB
64
65== BUGS
66
67To be discovered.
68
69== AUTHORS
70
2c646c80 71The original *namei* program was written by mailto:rogers@amadeus.wr.tek.com[Roger Southwick].
6c64d12d 72
59993a27 73The program was rewritten by mailto:kzak@redhat.com[Karel Zak].
6c64d12d
MB
74
75== SEE ALSO
76
77*ls*(1),
78*stat*(1),
79*symlink*(7)
80
625e9c61 81include::man-common/bugreports.adoc[]
6c64d12d 82
625e9c61 83include::man-common/footer.adoc[]
6c64d12d
MB
84
85ifdef::translation[]
625e9c61 86include::man-common/translation.adoc[]
6c64d12d 87endif::[]