From eeac99af71e0d0366d8e3a8e5ef60a47e1bb346f Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Thu, 13 Apr 2006 04:01:47 +0000 Subject: (What information is listed): Document 'ls' type letters. --- doc/ChangeLog | 3 +++ doc/coreutils.texi | 35 +++++++++++++++++++++++++++++++++++ 2 files changed, 38 insertions(+) (limited to 'doc') diff --git a/doc/ChangeLog b/doc/ChangeLog index 51de34ac4..c06b3ef05 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -3,6 +3,9 @@ * coreutils.texi (expr invocation): expr exit status is 3 only for internal errors now; 2 is also for invalid values in expressions. + (What information is listed): Document 'ls' type letters. + Problem reported by Lincoln Martin. + 2006-04-09 Ori Avtalion * coreutils.texi (Top): Add 'hostid' to System context menu line. diff --git a/doc/coreutils.texi b/doc/coreutils.texi index a91b9e7d5..fd0129063 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -5772,10 +5772,42 @@ bytes, but this can be overridden (@pxref{Block size}). The @var{blocks} computed counts each hard link separately; this is arguably a deficiency. +The file type is one of the following characters: + +@table @samp +@item - +regular file +@item b +block special file +@item c +character special file +@item C +high performance (``contiguous data'') file +@item d +directory +@item D +door +@item l +symbolic link +@c @item m +@c multiplexed character special file (7th edition Unix; obsolete) +@item M +off-line (``migrated'') file (Cray DMF) +@item n +network special file (HP-UX) +@item p +FIFO (named pipe) +@item s +socket +@item ? +some other file type +@end table + @cindex permissions, output by @command{ls} The file mode bits listed are similar to symbolic mode specifications (@pxref{Symbolic Modes}). But @command{ls} combines multiple bits into the third character of each set of permissions as follows: + @table @samp @item s If the setuid or setgid bit and the corresponding executable bit @@ -6065,6 +6097,7 @@ like @option{-F}, except that executables are not marked. @opindex --indicator-style Append a character indicator with style @var{word} to entry names, as follows: + @table @samp @item none Do not append any character indicator; this is the default. @@ -6311,6 +6344,7 @@ in C. Use style @var{word} to quote file names and other strings that may contain arbitrary characters. The @var{word} should be one of the following: + @table @samp @item literal Output strings as-is; this is the same as the @option{-N} or @@ -6745,6 +6779,7 @@ heuristic and makes the corresponding output file sparse as well. Only regular files may be sparse. The @var{when} value can be one of the following: + @table @samp @item auto The default behavior: if the input file is sparse, attempt to make -- cgit v1.2.3-54-g00ecf