]>
Commit | Line | Data |
---|---|---|
232dc924 | 1 | .TH NAMEI 1 "June 2011" "util-linux" "User Commands" |
6dbe3af9 | 2 | .SH NAME |
232dc924 | 3 | namei \- follow a pathname until a terminal point is found |
6dbe3af9 | 4 | .SH SYNOPSIS |
ed5de10e | 5 | .B namei |
f49ccec2 BS |
6 | [options] |
7 | .IR pathname ... | |
6dbe3af9 | 8 | .SH DESCRIPTION |
d0bb6987 | 9 | .B namei |
7ab71099 | 10 | interprets its arguments as pathnames to any type |
3eca4291 | 11 | of Unix file (symlinks, files, directories, and so forth). |
d0bb6987 BS |
12 | .B namei |
13 | then follows each pathname until an endpoint | |
14 | is found (a file, a directory, a device node, etc). | |
15 | If it finds a symbolic link, it shows the link, and starts | |
6dbe3af9 KZ |
16 | following it, indenting the output to show the context. |
17 | .PP | |
d0bb6987 | 18 | This program is useful for finding "too many levels of |
6dbe3af9 KZ |
19 | symbolic links" problems. |
20 | .PP | |
d0bb6987 | 21 | For each line of output, |
3eca4291 | 22 | .B namei |
d0bb6987 | 23 | uses the following characters to identify the file type found: |
6dbe3af9 KZ |
24 | .LP |
25 | .nf | |
d0bb6987 | 26 | f: = the pathname currently being resolved |
6dbe3af9 | 27 | d = directory |
d0bb6987 | 28 | l = symbolic link (both the link and its contents are output) |
6dbe3af9 KZ |
29 | s = socket |
30 | b = block device | |
31 | c = character device | |
f062c8a6 | 32 | p = FIFO (named pipe) |
6dbe3af9 KZ |
33 | - = regular file |
34 | ? = an error of some kind | |
35 | .fi | |
36 | .PP | |
d0bb6987 | 37 | .B namei |
6dbe3af9 KZ |
38 | prints an informative message when |
39 | the maximum number of symbolic links this system can have has been exceeded. | |
40 | .SH OPTIONS | |
7ab71099 BS |
41 | .TP |
42 | .BR \-l , " \-\-long" | |
43 | Use the long listing format (same as \fB\-m \-o \-v\fR). | |
44 | .TP | |
45 | .BR \-m , " \-\-modes" | |
6dbe3af9 KZ |
46 | Show the mode bits of each file type in the style of ls(1), |
47 | for example 'rwxr-xr-x'. | |
7ab71099 BS |
48 | .TP |
49 | .BR \-n , " \-\-nosymlinks" | |
c84a633a | 50 | Don't follow symlinks. |
7ab71099 BS |
51 | .TP |
52 | .BR \-o , " \-\-owners" | |
53 | Show owner and group name of each file. | |
54 | .TP | |
55 | .BR \-v , " \-\-vertical" | |
d0bb6987 | 56 | Vertically align the modes and owners. |
7ab71099 BS |
57 | .TP |
58 | .BR \-x , " \-\-mountpoints" | |
d0bb6987 | 59 | Show mountpoint directories with a 'D' rather than a 'd'. |
7ab71099 BS |
60 | .TP |
61 | .BR \-V , " \-\-version" | |
b4362b6f | 62 | Display version information and exit. |
7ab71099 BS |
63 | .TP |
64 | .BR \-h , " \-\-help" | |
65 | Display help text and exit. | |
6dbe3af9 | 66 | .SH AUTHOR |
c84a633a KZ |
67 | The original |
68 | .B namei | |
69 | program was written by Roger Southwick <rogers@amadeus.wr.tek.com>. | |
7ab71099 BS |
70 | .sp |
71 | The program was rewritten by Karel Zak <kzak@redhat.com>. | |
6dbe3af9 KZ |
72 | .SH BUGS |
73 | To be discovered. | |
6dbe3af9 | 74 | .SH "SEE ALSO" |
3eca4291 | 75 | .BR ls (1), |
9a1f476c MK |
76 | .BR stat (1), |
77 | .BR symlink (7) | |
86d62711 | 78 | .SH AVAILABILITY |
601d12fb | 79 | The namei command is part of the util-linux package and is available from |
d673b74e | 80 | https://www.kernel.org/pub/linux/utils/util-linux/. |