original/man1/dir.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH DIR "1" "March 2012" "GNU coreutils 8.16" "User Commands"
   3 .SH NAME
   4 dir \- list directory contents
   5 .SH SYNOPSIS
   6 .B dir
   7 [\fIOPTION\fR]... [\fIFILE\fR]...
   8 .SH DESCRIPTION
   9 .\" Add any additional description here
  10 .PP
  11 List information about the FILEs (the current directory by default).
  12 Sort entries alphabetically if none of \fB\-cftuvSUX\fR nor \fB\-\-sort\fR is specified.
  13 .PP
  14 Mandatory arguments to long options are mandatory for short options too.
  15 .TP
  16 \fB\-a\fR, \fB\-\-all\fR
  17 do not ignore entries starting with .
  18 .TP
  19 \fB\-A\fR, \fB\-\-almost\-all\fR
  20 do not list implied . and ..
  21 .TP
  22 \fB\-\-author\fR
  23 with \fB\-l\fR, print the author of each file
  24 .TP
  25 \fB\-b\fR, \fB\-\-escape\fR
  26 print C\-style escapes for nongraphic characters
  27 .TP
  28 \fB\-\-block\-size\fR=\fISIZE\fR
  29 scale sizes by SIZE before printing them.  E.g.,
  30 \&'\-\-block\-size=M' prints sizes in units of
  31 1,048,576 bytes.  See SIZE format below.
  32 .TP
  33 \fB\-B\fR, \fB\-\-ignore\-backups\fR
  34 do not list implied entries ending with ~
  35 .TP
  36 \fB\-c\fR
  37 with \fB\-lt\fR: sort by, and show, ctime (time of last
  38 modification of file status information)
  39 with \fB\-l\fR: show ctime and sort by name
  40 otherwise: sort by ctime, newest first
  41 .TP
  42 \fB\-C\fR
  43 list entries by columns
  44 .TP
  45 \fB\-\-color\fR[=\fIWHEN\fR]
  46 colorize the output.  WHEN defaults to 'always'
  47 or can be 'never' or 'auto'.  More info below
  48 .TP
  49 \fB\-d\fR, \fB\-\-directory\fR
  50 list directory entries instead of contents,
  51 and do not dereference symbolic links
  52 .TP
  53 \fB\-D\fR, \fB\-\-dired\fR
  54 generate output designed for Emacs' dired mode
  55 .TP
  56 \fB\-f\fR
  57 do not sort, enable \fB\-aU\fR, disable \fB\-ls\fR \fB\-\-color\fR
  58 .TP
  59 \fB\-F\fR, \fB\-\-classify\fR
  60 append indicator (one of */=>@|) to entries
  61 .TP
  62 \fB\-\-file\-type\fR
  63 likewise, except do not append '*'
  64 .TP
  65 \fB\-\-format\fR=\fIWORD\fR
  66 across \fB\-x\fR, commas \fB\-m\fR, horizontal \fB\-x\fR, long \fB\-l\fR,
  67 single\-column \fB\-1\fR, verbose \fB\-l\fR, vertical \fB\-C\fR
  68 .TP
  69 \fB\-\-full\-time\fR
  70 like \fB\-l\fR \fB\-\-time\-style\fR=\fIfull\-iso\fR
  71 .TP
  72 \fB\-g\fR
  73 like \fB\-l\fR, but do not list owner
  74 .TP
  75 \fB\-\-group\-directories\-first\fR
  76 group directories before files.
  77 .IP
  78 augment with a \fB\-\-sort\fR option, but any
  79 use of \fB\-\-sort\fR=\fInone\fR (\fB\-U\fR) disables grouping
  80 .TP
  81 \fB\-G\fR, \fB\-\-no\-group\fR
  82 in a long listing, don't print group names
  83 .TP
  84 \fB\-h\fR, \fB\-\-human\-readable\fR
  85 with \fB\-l\fR, print sizes in human readable format
  86 (e.g., 1K 234M 2G)
  87 .TP
  88 \fB\-\-si\fR
  89 likewise, but use powers of 1000 not 1024
  90 .TP
  91 \fB\-H\fR, \fB\-\-dereference\-command\-line\fR
  92 follow symbolic links listed on the command line
  93 .TP
  94 \fB\-\-dereference\-command\-line\-symlink\-to\-dir\fR
  95 follow each command line symbolic link
  96 that points to a directory
  97 .TP
  98 \fB\-\-hide\fR=\fIPATTERN\fR
  99 do not list implied entries matching shell PATTERN
 100 (overridden by \fB\-a\fR or \fB\-A\fR)
 101 .TP
 102 \fB\-\-indicator\-style\fR=\fIWORD\fR
 103 append indicator with style WORD to entry names:
 104 none (default), slash (\fB\-p\fR),
 105 file\-type (\fB\-\-file\-type\fR), classify (\fB\-F\fR)
 106 .TP
 107 \fB\-i\fR, \fB\-\-inode\fR
 108 print the index number of each file
 109 .TP
 110 \fB\-I\fR, \fB\-\-ignore\fR=\fIPATTERN\fR
 111 do not list implied entries matching shell PATTERN
 112 .TP
 113 \fB\-k\fR, \fB\-\-kibibytes\fR
 114 use 1024\-byte blocks
 115 .TP
 116 \fB\-l\fR
 117 use a long listing format
 118 .TP
 119 \fB\-L\fR, \fB\-\-dereference\fR
 120 when showing file information for a symbolic
 121 link, show information for the file the link
 122 references rather than for the link itself
 123 .TP
 124 \fB\-m\fR
 125 fill width with a comma separated list of entries
 126 .TP
 127 \fB\-n\fR, \fB\-\-numeric\-uid\-gid\fR
 128 like \fB\-l\fR, but list numeric user and group IDs
 129 .TP
 130 \fB\-N\fR, \fB\-\-literal\fR
 131 print raw entry names (don't treat e.g. control
 132 characters specially)
 133 .TP
 134 \fB\-o\fR
 135 like \fB\-l\fR, but do not list group information
 136 .TP
 137 \fB\-p\fR, \fB\-\-indicator\-style\fR=\fIslash\fR
 138 append / indicator to directories
 139 .TP
 140 \fB\-q\fR, \fB\-\-hide\-control\-chars\fR
 141 print ? instead of non graphic characters
 142 .TP
 143 \fB\-\-show\-control\-chars\fR
 144 show non graphic characters as\-is (default
 145 unless program is 'ls' and output is a terminal)
 146 .TP
 147 \fB\-Q\fR, \fB\-\-quote\-name\fR
 148 enclose entry names in double quotes
 149 .TP
 150 \fB\-\-quoting\-style\fR=\fIWORD\fR
 151 use quoting style WORD for entry names:
 152 literal, locale, shell, shell\-always, c, escape
 153 .TP
 154 \fB\-r\fR, \fB\-\-reverse\fR
 155 reverse order while sorting
 156 .TP
 157 \fB\-R\fR, \fB\-\-recursive\fR
 158 list subdirectories recursively
 159 .TP
 160 \fB\-s\fR, \fB\-\-size\fR
 161 print the allocated size of each file, in blocks
 162 .TP
 163 \fB\-S\fR
 164 sort by file size
 165 .TP
 166 \fB\-\-sort\fR=\fIWORD\fR
 167 sort by WORD instead of name: none \fB\-U\fR,
 168 extension \fB\-X\fR, size \fB\-S\fR, time \fB\-t\fR, version \fB\-v\fR
 169 .TP
 170 \fB\-\-time\fR=\fIWORD\fR
 171 with \fB\-l\fR, show time as WORD instead of modification
 172 time: atime \fB\-u\fR, access \fB\-u\fR, use \fB\-u\fR, ctime \fB\-c\fR,
 173 or status \fB\-c\fR; use specified time as sort key
 174 if \fB\-\-sort\fR=\fItime\fR
 175 .TP
 176 \fB\-\-time\-style\fR=\fISTYLE\fR
 177 with \fB\-l\fR, show times using style STYLE:
 178 full\-iso, long\-iso, iso, locale, +FORMAT.
 179 FORMAT is interpreted like 'date'; if FORMAT is
 180 FORMAT1<newline>FORMAT2, FORMAT1 applies to
 181 non\-recent files and FORMAT2 to recent files;
 182 if STYLE is prefixed with 'posix\-', STYLE
 183 takes effect only outside the POSIX locale
 184 .TP
 185 \fB\-t\fR
 186 sort by modification time, newest first
 187 .TP
 188 \fB\-T\fR, \fB\-\-tabsize\fR=\fICOLS\fR
 189 assume tab stops at each COLS instead of 8
 190 .TP
 191 \fB\-u\fR
 192 with \fB\-lt\fR: sort by, and show, access time
 193 with \fB\-l\fR: show access time and sort by name
 194 otherwise: sort by access time
 195 .TP
 196 \fB\-U\fR
 197 do not sort; list entries in directory order
 198 .TP
 199 \fB\-v\fR
 200 natural sort of (version) numbers within text
 201 .TP
 202 \fB\-w\fR, \fB\-\-width\fR=\fICOLS\fR
 203 assume screen width instead of current value
 204 .TP
 205 \fB\-x\fR
 206 list entries by lines instead of by columns
 207 .TP
 208 \fB\-X\fR
 209 sort alphabetically by entry extension
 210 .TP
 211 \fB\-Z\fR, \fB\-\-context\fR
 212 print any SELinux security context of each file
 213 .TP
 214 \fB\-1\fR
 215 list one file per line
 216 .TP
 217 \fB\-\-help\fR
 218 display this help and exit
 219 .TP
 220 \fB\-\-version\fR
 221 output version information and exit
 222 .PP
 223 SIZE is an integer and optional unit (example: 10M is 10*1024*1024).  Units
 224 are K, M, G, T, P, E, Z, Y (powers of 1024) or KB, MB, ... (powers of 1000).
 225 .PP
 226 Using color to distinguish file types is disabled both by default and
 227 with \fB\-\-color\fR=\fInever\fR.  With \fB\-\-color\fR=\fIauto\fR, ls emits color codes only when
 228 standard output is connected to a terminal.  The LS_COLORS environment
 229 variable can change the settings.  Use the dircolors command to set it.
 230 .SS "Exit status:"
 231 .TP
 232 0
 233 if OK,
 234 .TP
 235 1
 236 if minor problems (e.g., cannot access subdirectory),
 237 .TP
 238 2
 239 if serious trouble (e.g., cannot access command\-line argument).
 240 .SH AUTHOR
 241 Written by Richard M. Stallman and David MacKenzie.
 242 .SH "REPORTING BUGS"
 243 Report dir bugs to bug\-coreutils@gnu.org
 244 .br
 245 GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
 246 .br
 247 General help using GNU software: <http://www.gnu.org/gethelp/>
 248 .br
 249 Report dir translation bugs to <http://translationproject.org/team/>
 250 .SH COPYRIGHT
 251 Copyright \(co 2012 Free Software Foundation, Inc.
 252 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
 253 .br
 254 This is free software: you are free to change and redistribute it.
 255 There is NO WARRANTY, to the extent permitted by law.
 256 .SH "SEE ALSO"
 257 The full documentation for
 258 .B dir
 259 is maintained as a Texinfo manual.  If the
 260 .B info
 261 and
 262 .B dir
 263 programs are properly installed at your site, the command
 264 .IP
 265 .B info coreutils \(aqdir invocation\(aq
 266 .PP
 267 should give you access to the complete manual.