misc-utils/namei.1

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