manual/GNU_fileutils/original/man1/ls.1

   1 ." DO NOT MODIFY THIS FILE!  It was generated by help2man 1.5.1.2.
   2 .TH LS 1 "November 1998" "GNU fileutils 4.0" "FSF"
   3 .SH NAME
   4 ls \- list directory contents
   5 .SH SYNOPSIS
   6 .B ls
   7 [\fIOPTION\fR]... [\fIFILE\fR]...
   8 .SH DESCRIPTION
   9 .PP
  10 ." Add any additional description here
  11 .PP
  12 List information about the FILEs (the current directory by default).
  13 Sort entries alphabetically if none of \fB\-cftuSUX\fR nor \fB\-\-sort\fR.
  14 .TP
  15 \fB\-a\fR, \fB\-\-all\fR
  16 do not hide entries starting with .
  17 .TP
  18 \fB\-A\fR, \fB\-\-almost\-all\fR
  19 do not list implied . and ..
  20 .TP
  21 \fB\-b\fR, \fB\-\-escape\fR
  22 print octal escapes for nongraphic characters
  23 .TP
  24 \fB\-\-block\-size\fR=\fISIZE\fR
  25 use SIZE-byte blocks
  26 .TP
  27 \fB\-B\fR, \fB\-\-ignore\-backups\fR
  28 do not list implied entries ending with ~
  29 .TP
  30 \fB\-c\fR
  31 sort by change time; with \fB\-l\fR: show ctime
  32 .TP
  33 \fB\-C\fR
  34 list entries by columns
  35 .TP
  36 \fB\-\-color\fR[=\fIWHEN\fR]
  37 control whether color is used to distinguish file types.  WHEN may be `never', `always', or `auto'
  38 .TP
  39 \fB\-d\fR, \fB\-\-directory\fR
  40 list directory entries instead of contents
  41 .TP
  42 \fB\-D\fR, \fB\-\-dired\fR
  43 generate output designed for Emacs' dired mode
  44 .TP
  45 \fB\-f\fR
  46 do not sort, enable \fB\-aU\fR, disable \fB\-lst\fR
  47 .TP
  48 \fB\-F\fR, \fB\-\-classify\fR
  49 append indicator (one of */=@|) to entries
  50 .TP
  51 \fB\-\-format\fR=\fIWORD\fR
  52 across \fB\-x\fR, commas \fB\-m\fR, horizontal \fB\-x\fR, long \fB\-l\fR, single-column \fB\-1\fR, verbose \fB\-l\fR, vertical \fB\-C\fR
  53 .TP
  54 \fB\-\-full\-time\fR
  55 list both full date and full time
  56 .TP
  57 \fB\-g\fR
  58 (ignored)
  59 .TP
  60 \fB\-G\fR, \fB\-\-no\-group\fR
  61 inhibit display of group information
  62 .TP
  63 \fB\-h\fR, \fB\-\-human\-readable\fR
  64 print sizes in human readable format (e.g., 1K 234M 2G)
  65 .TP
  66 \fB\-H\fR, \fB\-\-si\fR
  67 likewise, but use powers of 1000 not 1024
  68 .TP
  69 \fB\-\-indicator\-style\fR=\fIWORD\fR
  70 append indicator with style WORD to entry names: none (default), classify (-F), file-type (-p)
  71 .TP
  72 \fB\-i\fR, \fB\-\-inode\fR
  73 print index number of each file
  74 .TP
  75 \fB\-I\fR, \fB\-\-ignore\fR=\fIPATTERN\fR
  76 do not list implied entries matching shell PATTERN
  77 .TP
  78 \fB\-k\fR, \fB\-\-kilobytes\fR
  79 like \fB\-\-block\-size\fR=\fI1024\fR
  80 .TP
  81 \fB\-l\fR
  82 use a long listing format
  83 .TP
  84 \fB\-L\fR, \fB\-\-dereference\fR
  85 list entries pointed to by symbolic links
  86 .TP
  87 \fB\-m\fR
  88 fill width with a comma separated list of entries
  89 .TP
  90 \fB\-n\fR, \fB\-\-numeric\-uid\-gid\fR
  91 list numeric UIDs and GIDs instead of names
  92 .TP
  93 \fB\-N\fR, \fB\-\-literal\fR
  94 print raw entry names (don't treat e.g. control characters specially)
  95 .TP
  96 \fB\-o\fR
  97 use long listing format without group info
  98 .TP
  99 \fB\-p\fR, \fB\-\-file\-type\fR
 100 append indicator (one of /=@|) to entries
 101 .TP
 102 \fB\-q\fR, \fB\-\-hide\-control\-chars\fR
 103 print ? instead of non graphic characters
 104 .TP
 105 \fB\-\-show\-control\-chars\fR
 106 show non graphic characters as-is (default)
 107 .TP
 108 \fB\-Q\fR, \fB\-\-quote\-name\fR
 109 enclose entry names in double quotes
 110 .TP
 111 \fB\-\-quoting\-style\fR=\fIWORD\fR
 112 use quoting style WORD for entry names: literal, shell, shell-always, c, escape
 113 .TP
 114 \fB\-r\fR, \fB\-\-reverse\fR
 115 reverse order while sorting
 116 .TP
 117 \fB\-R\fR, \fB\-\-recursive\fR
 118 list subdirectories recursively
 119 .TP
 120 \fB\-s\fR, \fB\-\-size\fR
 121 print size of each file, in blocks
 122 .TP
 123 \fB\-S\fR
 124 sort by file size
 125 .TP
 126 \fB\-\-sort\fR=\fIWORD\fR
 127 extension \fB\-X\fR, none \fB\-U\fR, size \fB\-S\fR, time \fB\-t\fR, version \fB\-v\fR status \fB\-c\fR, time \fB\-t\fR, atime \fB\-u\fR, access \fB\-u\fR, use \fB\-u\fR
 128 .TP
 129 \fB\-\-time\fR=\fIWORD\fR
 130 show time as WORD instead of modification time: atime, access, use, ctime or status; use specified time as sort key if \fB\-\-sort\fR=\fItime\fR
 131 .TP
 132 \fB\-t\fR
 133 sort by modification time
 134 .TP
 135 \fB\-T\fR, \fB\-\-tabsize\fR=\fICOLS\fR
 136 assume tab stops at each COLS instead of 8
 137 .TP
 138 \fB\-u\fR
 139 sort by last access time; with \fB\-l\fR: show atime
 140 .TP
 141 \fB\-U\fR
 142 do not sort; list entries in directory order
 143 .TP
 144 \fB\-v\fR
 145 sort by version
 146 .TP
 147 \fB\-w\fR, \fB\-\-width\fR=\fICOLS\fR
 148 assume screen width instead of current value
 149 .TP
 150 \fB\-x\fR
 151 list entries by lines instead of by columns
 152 .TP
 153 \fB\-X\fR
 154 sort alphabetically by entry extension
 155 .TP
 156 \fB\-1\fR
 157 list one file per line
 158 .TP
 159 \fB\-\-help\fR
 160 display this help and exit
 161 .TP
 162 \fB\-\-version\fR
 163 output version information and exit
 164 .PP
 165 By default, color is not used to distinguish types of files.  That is
 166 equivalent to using \fB\-\-color\fR=\fInone\fR.  Using the \fB\-\-color\fR option without the
 167 optional WHEN argument is equivalent to using \fB\-\-color\fR=\fIalways\fR.  With
 168 \fB\-\-color\fR=\fIauto\fR, color codes are output only if standard output is connected
 169 to a terminal (tty).
 170 .SH "REPORTING BUGS"
 171 Report bugs to <bug-fileutils@gnu.org>.
 172 .SH "SEE ALSO"
 173 The full documentation for
 174 .B ls
 175 is maintained as a Texinfo manual.  If the
 176 .B info
 177 and
 178 .B ls
 179 programs are properly installed at your site, the command
 180 .IP
 181 .B info ls
 182 .PP
 183 should give you access to the complete manual.