projects / thirdparty / util-linux.git / blame
| 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. | |
| ade04bb8 MK |
66 | .SH BUGS |
| 67 | To be discovered. | |
| a8d0d330 | 68 | .SH AUTHORS |
| c84a633a KZ |
69 | The original |
| 70 | .B namei | |
| 71 | program was written by Roger Southwick <rogers@amadeus.wr.tek.com>. | |
| 7ab71099 BS |
72 | .sp |
| 73 | The program was rewritten by Karel Zak <kzak@redhat.com>. | |
| 5a829806 | 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/. |