misc-utils/namei.1.adoc

   1 //po4a: entry man manual
   2 = namei(1)
   3 :doctype: manpage
   4 :man manual: User Commands
   5 :man source: util-linux {release-version}
   6 :page-layout: base
   7 :command: namei
   8
   9 == NAME
  10
  11 namei - follow a pathname until a terminal point is found
  12
  13 == SYNOPSIS
  14
  15 *namei* [options] _pathname_...
  16
  17 == DESCRIPTION
  18
  19 *namei* interprets its arguments as pathnames to any type of Unix file (symlinks, files, directories, and so forth). *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 following it, indenting the output to show the context.
  20
  21 This program is useful for finding "too many levels of symbolic links" problems.
  22
  23 For each line of output, *namei* uses the following characters to identify the file type found:
  24
  25 ....
  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 ....
  36
  37 *namei* prints an informative message when the maximum number of symbolic links this system can have has been exceeded.
  38
  39 == OPTIONS
  40
  41 *-l*, *--long*::
  42 Use the long listing format (same as *-m -o -v*).
  43
  44 *-m*, *--modes*::
  45 Show the mode bits of each file type in the style of *ls*(1), for example 'rwxr-xr-x'.
  46
  47 *-n*, *--nosymlinks*::
  48 Don't follow symlinks.
  49
  50 *-o*, *--owners*::
  51 Show owner and group name of each file.
  52
  53 *-v*, *--vertical*::
  54 Vertically align the modes and owners.
  55
  56 *-x*, *--mountpoints*::
  57 Show mountpoint directories with a 'D' rather than a 'd'.
  58
  59 *-Z*, *--context*::
  60 Show security context of the file or "?" if not available.
  61 The support for security contexts is optional and does not have to be compiled to the *namei* binary.
  62
  63 include::man-common/help-version.adoc[]
  64
  65 == BUGS
  66
  67 To be discovered.
  68
  69 == AUTHORS
  70
  71 The original *namei* program was written by mailto:rogers@amadeus.wr.tek.com[Roger Southwick].
  72
  73 The program was rewritten by Karel Zak mailto:kzak@redhat.com[Karel Zak].
  74
  75 == SEE ALSO
  76
  77 *ls*(1),
  78 *stat*(1),
  79 *symlink*(7)
  80
  81 include::man-common/bugreports.adoc[]
  82
  83 include::man-common/footer.adoc[]
  84
  85 ifdef::translation[]
  86 include::man-common/translation.adoc[]
  87 endif::[]