]>
Commit | Line | Data |
---|---|---|
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 | ||
11 | namei - 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 | ||
21 | This program is useful for finding "too many levels of symbolic links" problems. | |
22 | ||
23 | For 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 | 42 | Use the long listing format (same as *-m -o -v*). |
6c64d12d MB |
43 | |
44 | *-m*, *--modes*:: | |
2c646c80 | 45 | Show 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 | 48 | Don't follow symlinks. |
6c64d12d MB |
49 | |
50 | *-o*, *--owners*:: | |
2c646c80 | 51 | Show owner and group name of each file. |
6c64d12d MB |
52 | |
53 | *-v*, *--vertical*:: | |
2c646c80 | 54 | Vertically align the modes and owners. |
6c64d12d MB |
55 | |
56 | *-x*, *--mountpoints*:: | |
2c646c80 | 57 | Show mountpoint directories with a 'D' rather than a 'd'. |
6c64d12d | 58 | |
e928e8ed KZ |
59 | *-Z*, *--context*:: |
60 | Show security context of the file or "?" if not available. | |
2b53db33 | 61 | The support for security contexts is optional and does not have to be compiled to the *namei* binary. |
e928e8ed | 62 | |
2b2d3172 | 63 | include::man-common/help-version.adoc[] |
6c64d12d MB |
64 | |
65 | == BUGS | |
66 | ||
67 | To be discovered. | |
68 | ||
69 | == AUTHORS | |
70 | ||
2c646c80 | 71 | The original *namei* program was written by mailto:rogers@amadeus.wr.tek.com[Roger Southwick]. |
6c64d12d | 72 | |
59993a27 | 73 | The 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 | 81 | include::man-common/bugreports.adoc[] |
6c64d12d | 82 | |
625e9c61 | 83 | include::man-common/footer.adoc[] |
6c64d12d MB |
84 | |
85 | ifdef::translation[] | |
625e9c61 | 86 | include::man-common/translation.adoc[] |
6c64d12d | 87 | endif::[] |