misc-utils/namei.1

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