summaryrefslogtreecommitdiffstats
path: root/misc-utils/namei.1
blob: 348a378940c8697d2b0fd15cbbac5e0b30aa573b (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
.\" 
.\" Version 1.4 of namei
.\"
.TH NAMEI 1 "Local"
.SH NAME
namei - follow a pathname until a terminal point is found
.SH SYNOPSIS
.B namei
.I [-mx]
.I pathname
.I "[ pathname ... ]"
.SH DESCRIPTION
.I Namei
uses its arguments as pathnames to any type
of Unix file (symlinks, files, directories, and so forth). 
.I Namei
then follows each pathname until a terminal 
point is found (a file, directory, char device, etc).
If it finds a symbolic link, we show the link, and start
following it, indenting the output to show the context.
.PP
This program is useful for finding a "too many levels of
symbolic links" problems.
.PP
For each line output,
.I namei
outputs a the following characters to identify the file types found:
.LP
.nf
   f: = the pathname we are currently trying to resolve
    d = directory
    l = symbolic link (both the link and it's contents are output)
    s = socket
    b = block device
    c = character device
    - = regular file
    ? = an error of some kind
.fi
.PP
.I Namei
prints an informative message when
the maximum number of symbolic links this system can have has been exceeded.
.SH OPTIONS
.TP 8
.B -x
Show mount point directories with a 'D', rather than a 'd'.
.TP 8
.B -m
Show the mode bits of each file type in the style of ls(1),
for example 'rwxr-xr-x'.
.SH AUTHOR
Roger Southwick  (rogers@amadeus.wr.tek.com)
.SH BUGS
To be discovered.
.SH CAVEATS
.I Namei
will follow an infinite loop of symbolic links forever.  To escape, use
SIGINT (usually ^C).
.SH "SEE ALSO"
ls(1), stat(1)