summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPaul Eggert <eggert@cs.ucla.edu>2006-04-13 04:01:47 +0000
committerPaul Eggert <eggert@cs.ucla.edu>2006-04-13 04:01:47 +0000
commiteeac99af71e0d0366d8e3a8e5ef60a47e1bb346f (patch)
treef814a2fb86739fdae3763801ddda5f03fd68f5fe /doc
parente0637b5b68f149ad9fbaf238954ad79463eece5a (diff)
downloadcoreutils-eeac99af71e0d0366d8e3a8e5ef60a47e1bb346f.tar.xz
(What information is listed): Document 'ls' type letters.
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog3
-rw-r--r--doc/coreutils.texi35
2 files changed, 38 insertions, 0 deletions
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 <oavtal@bezeqint.net>
* 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