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 fBnamei
   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 a terminal
  17 point is found (a file, directory, char device, etc).
  18 If it finds a symbolic link, we show the link, and start
  19 following it, indenting the output to show the context.
  20 .PP
  21 This program is useful for finding a "too many levels of
  22 symbolic links" problems.
  23 .PP
  24 For each line output,
  25 .B namei
  26 outputs a the following characters to identify the file types found:
  27 .LP
  28 .nf
  29    f: = the pathname we are currently trying to resolve
  30     d = directory
  31     l = symbolic link (both the link and it's 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 a 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 Vertical align of modes and owners.
  55 .IP "\fB\-x, \-\-mountpoints\fP"
  56 Show mount point directories with a 'D', rather than a 'd'.
  57 .SH AUTHOR
  58 The original
  59 .B namei
  60 program was written by Roger Southwick <rogers@amadeus.wr.tek.com>.
  61
  62 The program was re-written by Karel Zak <kzak@redhat.com>.
  63 .SH BUGS
  64 To be discovered.
  65 .SH "SEE ALSO"
  66 .BR ls (1),
  67 .BR stat (1)
  68 .SH AVAILABILITY
  69 The namei command is part of the util-linux-ng package and is available from
  70 ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.