src/namei/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 .I [-mx]
  10 .I pathname
  11 .I "[ pathname ... ]"
  12 .SH DESCRIPTION
  13 .I Namei
  14 uses its arguments as pathnames to any type
  15 of Unix file (symlinks, files, directories, and so forth).
  16 .I Namei
  17 then follows each pathname until a terminal
  18 point is found (a file, directory, char device, etc).
  19 If it finds a symbolic link, we show the link, and start
  20 following it, indenting the output to show the context.
  21 .PP
  22 This program is useful for finding a "too many levels of
  23 symbolic links" problems.
  24 .PP
  25 For each line output,
  26 .I namei
  27 outputs a the following characters to identify the file types found:
  28 .LP
  29 .nf
  30    f: = the pathname we are currently trying to resolve
  31     d = directory
  32     l = symbolic link (both the link and it's contents are output)
  33     s = socket
  34     b = block device
  35     c = character device
  36     - = regular file
  37     ? = an error of some kind
  38 .fi
  39 .PP
  40 .I 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 .TP 8
  45 .B -x
  46 Show mount point directories with a 'D', rather than a 'd'.
  47 .TP 8
  48 .B -m
  49 Show the mode bits of each file type in the style of ls(1),
  50 for example 'rwxr-xr-x'.
  51 .SH AUTHOR
  52 Roger Southwick  (rogers@amadeus.wr.tek.com)
  53 .SH BUGS
  54 To be discovered.
  55 .SH CAVEATS
  56 .I Namei
  57 will follow an infinite loop of symbolic links forever.  To escape, use
  58 SIGINT (usually ^C).
  59 .SH "SEE ALSO"
  60 ls(1), stat(1)