2009-07-22 04:29:04 -05:00
|
|
|
.\"
|
2006-12-06 17:25:32 -06:00
|
|
|
.\" Version 1.4 of namei
|
|
|
|
.\"
|
2011-08-18 15:18:34 -05:00
|
|
|
.TH NAMEI 1 "June 2011" "util-linux" "User Commands"
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH NAME
|
2011-08-18 15:18:34 -05:00
|
|
|
namei \- follow a pathname until a terminal point is found
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH SYNOPSIS
|
2010-01-10 15:01:26 -06:00
|
|
|
.B namei
|
2014-12-14 13:45:29 -06:00
|
|
|
[options]
|
|
|
|
.IR pathname ...
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH DESCRIPTION
|
2010-06-10 07:27:34 -05:00
|
|
|
.B namei
|
2006-12-06 17:25:32 -06:00
|
|
|
uses its arguments as pathnames to any type
|
2009-07-22 04:29:04 -05:00
|
|
|
of Unix file (symlinks, files, directories, and so forth).
|
2010-06-10 07:27:34 -05:00
|
|
|
.B 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
|
2006-12-06 17:25:32 -06:00
|
|
|
following it, indenting the output to show the context.
|
|
|
|
.PP
|
2010-06-10 07:27:34 -05:00
|
|
|
This program is useful for finding "too many levels of
|
2006-12-06 17:25:32 -06:00
|
|
|
symbolic links" problems.
|
|
|
|
.PP
|
2010-06-10 07:27:34 -05:00
|
|
|
For each line of output,
|
2009-07-22 04:29:04 -05:00
|
|
|
.B namei
|
2010-06-10 07:27:34 -05:00
|
|
|
uses the following characters to identify the file type found:
|
2006-12-06 17:25:32 -06:00
|
|
|
.LP
|
|
|
|
.nf
|
2010-06-10 07:27:34 -05:00
|
|
|
f: = the pathname currently being resolved
|
2006-12-06 17:25:32 -06:00
|
|
|
d = directory
|
2010-06-10 07:27:34 -05:00
|
|
|
l = symbolic link (both the link and its contents are output)
|
2006-12-06 17:25:32 -06:00
|
|
|
s = socket
|
|
|
|
b = block device
|
|
|
|
c = character device
|
2007-09-10 03:20:48 -05:00
|
|
|
p = FIFO (named pipe)
|
2006-12-06 17:25:32 -06:00
|
|
|
- = regular file
|
|
|
|
? = an error of some kind
|
|
|
|
.fi
|
|
|
|
.PP
|
2010-06-10 07:27:34 -05:00
|
|
|
.B namei
|
2006-12-06 17:25:32 -06:00
|
|
|
prints an informative message when
|
|
|
|
the maximum number of symbolic links this system can have has been exceeded.
|
|
|
|
.SH OPTIONS
|
2009-01-27 08:00:35 -06:00
|
|
|
.IP "\fB\-l, \-\-long\fP"
|
2010-06-10 07:27:34 -05:00
|
|
|
Use the long listing format (same as -m -o -v).
|
2008-10-30 04:19:39 -05:00
|
|
|
.IP "\fB\-m, \-\-modes\fP"
|
2006-12-06 17:25:32 -06:00
|
|
|
Show the mode bits of each file type in the style of ls(1),
|
|
|
|
for example 'rwxr-xr-x'.
|
2009-01-27 08:00:35 -06:00
|
|
|
.IP "\fB\-o, \-\-owners\fP"
|
|
|
|
Show owner and group name of each file.
|
2008-10-30 04:19:39 -05:00
|
|
|
.IP "\fB\-n, \-\-nosymlinks\fP"
|
|
|
|
Don't follow symlinks.
|
2009-01-27 07:48:32 -06:00
|
|
|
.IP "\fB\-v, \-\-vertical\fP"
|
2010-06-10 07:27:34 -05:00
|
|
|
Vertically align the modes and owners.
|
2009-01-27 08:00:35 -06:00
|
|
|
.IP "\fB\-x, \-\-mountpoints\fP"
|
2010-06-10 07:27:34 -05:00
|
|
|
Show mountpoint directories with a 'D' rather than a 'd'.
|
2011-06-11 08:07:10 -05:00
|
|
|
.IP "\fB\-h\fR, \fB\-\-help\fR"
|
2013-10-14 14:34:39 -05:00
|
|
|
Display help text and exit.
|
2011-06-11 08:07:10 -05:00
|
|
|
.IP "\fB\-V\fR, \fB\-\-version\fR"
|
2013-10-14 14:34:39 -05:00
|
|
|
Display version information and exit.
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH AUTHOR
|
2008-10-30 04:19:39 -05:00
|
|
|
The original
|
|
|
|
.B namei
|
|
|
|
program was written by Roger Southwick <rogers@amadeus.wr.tek.com>.
|
2009-01-27 08:00:35 -06:00
|
|
|
|
2008-10-30 04:19:39 -05:00
|
|
|
The program was re-written by Karel Zak <kzak@redhat.com>.
|
2006-12-06 17:25:32 -06:00
|
|
|
.SH BUGS
|
|
|
|
To be discovered.
|
|
|
|
.SH "SEE ALSO"
|
2009-07-22 04:29:04 -05:00
|
|
|
.BR ls (1),
|
|
|
|
.BR stat (1)
|
2007-07-02 18:17:04 -05:00
|
|
|
.SH AVAILABILITY
|
2010-11-30 04:41:59 -06:00
|
|
|
The namei command is part of the util-linux package and is available from
|
|
|
|
ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
|