original/man1/dir.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
   2 .TH DIR "1" "January 2016" "GNU coreutils 8.25" "User Commands"
   3 .SH NAME
   4 dir \- list directory contents
   5 .SH SYNOPSIS
   6 .B dir
   7 [\fI\,OPTION\/\fR]... [\fI\,FILE\/\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=\fI\,SIZE\/\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[=\fI\,WHEN\/\fR]
  46 colorize the output; WHEN can be 'always' (default
  47 if omitted), 'auto', or 'never'; more info below
  48 .TP
  49 \fB\-d\fR, \fB\-\-directory\fR
  50 list directories themselves, not their contents
  51 .TP
  52 \fB\-D\fR, \fB\-\-dired\fR
  53 generate output designed for Emacs' dired mode
  54 .TP
  55 \fB\-f\fR
  56 do not sort, enable \fB\-aU\fR, disable \fB\-ls\fR \fB\-\-color\fR
  57 .TP
  58 \fB\-F\fR, \fB\-\-classify\fR
  59 append indicator (one of */=>@|) to entries
  60 .TP
  61 \fB\-\-file\-type\fR
  62 likewise, except do not append '*'
  63 .TP
  64 \fB\-\-format\fR=\fI\,WORD\/\fR
  65 across \fB\-x\fR, commas \fB\-m\fR, horizontal \fB\-x\fR, long \fB\-l\fR,
  66 single\-column \fB\-1\fR, verbose \fB\-l\fR, vertical \fB\-C\fR
  67 .TP
  68 \fB\-\-full\-time\fR
  69 like \fB\-l\fR \fB\-\-time\-style\fR=\fI\,full\-iso\/\fR
  70 .TP
  71 \fB\-g\fR
  72 like \fB\-l\fR, but do not list owner
  73 .TP
  74 \fB\-\-group\-directories\-first\fR
  75 group directories before files;
  76 .IP
  77 can be augmented with a \fB\-\-sort\fR option, but any
  78 use of \fB\-\-sort\fR=\fI\,none\/\fR (\fB\-U\fR) disables grouping
  79 .TP
  80 \fB\-G\fR, \fB\-\-no\-group\fR
  81 in a long listing, don't print group names
  82 .TP
  83 \fB\-h\fR, \fB\-\-human\-readable\fR
  84 with \fB\-l\fR and/or \fB\-s\fR, print human readable sizes
  85 (e.g., 1K 234M 2G)
  86 .TP
  87 \fB\-\-si\fR
  88 likewise, but use powers of 1000 not 1024
  89 .TP
  90 \fB\-H\fR, \fB\-\-dereference\-command\-line\fR
  91 follow symbolic links listed on the command line
  92 .TP
  93 \fB\-\-dereference\-command\-line\-symlink\-to\-dir\fR
  94 follow each command line symbolic link
  95 .IP
  96 that points to a directory
  97 .TP
  98 \fB\-\-hide\fR=\fI\,PATTERN\/\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=\fI\,WORD\/\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=\fI\,PATTERN\/\fR
 111 do not list implied entries matching shell PATTERN
 112 .TP
 113 \fB\-k\fR, \fB\-\-kibibytes\fR
 114 default to 1024\-byte blocks for disk usage
 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=\fI\,slash\/\fR
 138 append / indicator to directories
 139 .TP
 140 \fB\-q\fR, \fB\-\-hide\-control\-chars\fR
 141 print ? instead of nongraphic characters
 142 .TP
 143 \fB\-\-show\-control\-chars\fR
 144 show nongraphic characters as\-is (the 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=\fI\,WORD\/\fR
 151 use quoting style WORD for entry names:
 152 literal, locale, shell, shell\-always,
 153 shell\-escape, shell\-escape\-always, c, escape
 154 .TP
 155 \fB\-r\fR, \fB\-\-reverse\fR
 156 reverse order while sorting
 157 .TP
 158 \fB\-R\fR, \fB\-\-recursive\fR
 159 list subdirectories recursively
 160 .TP
 161 \fB\-s\fR, \fB\-\-size\fR
 162 print the allocated size of each file, in blocks
 163 .TP
 164 \fB\-S\fR
 165 sort by file size, largest first
 166 .TP
 167 \fB\-\-sort\fR=\fI\,WORD\/\fR
 168 sort by WORD instead of name: none (\fB\-U\fR), size (\fB\-S\fR),
 169 time (\fB\-t\fR), version (\fB\-v\fR), extension (\fB\-X\fR)
 170 .TP
 171 \fB\-\-time\fR=\fI\,WORD\/\fR
 172 with \fB\-l\fR, show time as WORD instead of default
 173 modification time: atime or access or use (\fB\-u\fR);
 174 ctime or status (\fB\-c\fR); also use specified time
 175 as sort key if \fB\-\-sort\fR=\fI\,time\/\fR (newest first)
 176 .TP
 177 \fB\-\-time\-style\fR=\fI\,STYLE\/\fR
 178 with \fB\-l\fR, show times using style STYLE:
 179 full\-iso, long\-iso, iso, locale, or +FORMAT;
 180 FORMAT is interpreted like in 'date'; if FORMAT
 181 is FORMAT1<newline>FORMAT2, then FORMAT1 applies
 182 to non\-recent files and FORMAT2 to recent files;
 183 if STYLE is prefixed with 'posix\-', STYLE
 184 takes effect only outside the POSIX locale
 185 .TP
 186 \fB\-t\fR
 187 sort by modification time, newest first
 188 .TP
 189 \fB\-T\fR, \fB\-\-tabsize\fR=\fI\,COLS\/\fR
 190 assume tab stops at each COLS instead of 8
 191 .TP
 192 \fB\-u\fR
 193 with \fB\-lt\fR: sort by, and show, access time;
 194 with \fB\-l\fR: show access time and sort by name;
 195 otherwise: sort by access time, newest first
 196 .TP
 197 \fB\-U\fR
 198 do not sort; list entries in directory order
 199 .TP
 200 \fB\-v\fR
 201 natural sort of (version) numbers within text
 202 .TP
 203 \fB\-w\fR, \fB\-\-width\fR=\fI\,COLS\/\fR
 204 set output width to COLS.  0 means no limit
 205 .TP
 206 \fB\-x\fR
 207 list entries by lines instead of by columns
 208 .TP
 209 \fB\-X\fR
 210 sort alphabetically by entry extension
 211 .TP
 212 \fB\-Z\fR, \fB\-\-context\fR
 213 print any security context of each file
 214 .TP
 215 \fB\-1\fR
 216 list one file per line.  Avoid '\en' with \fB\-q\fR or \fB\-b\fR
 217 .TP
 218 \fB\-\-help\fR
 219 display this help and exit
 220 .TP
 221 \fB\-\-version\fR
 222 output version information and exit
 223 .PP
 224 The SIZE argument is an integer and optional unit (example: 10K is 10*1024).
 225 Units are K,M,G,T,P,E,Z,Y (powers of 1024) or KB,MB,... (powers of 1000).
 226 .PP
 227 Using color to distinguish file types is disabled both by default and
 228 with \fB\-\-color\fR=\fI\,never\/\fR.  With \fB\-\-color\fR=\fI\,auto\/\fR, ls emits color codes only when
 229 standard output is connected to a terminal.  The LS_COLORS environment
 230 variable can change the settings.  Use the dircolors command to set it.
 231 .SS "Exit status:"
 232 .TP
 233 0
 234 if OK,
 235 .TP
 236 1
 237 if minor problems (e.g., cannot access subdirectory),
 238 .TP
 239 2
 240 if serious trouble (e.g., cannot access command\-line argument).
 241 .SH AUTHOR
 242 Written by Richard M. Stallman and David MacKenzie.
 243 .SH "REPORTING BUGS"
 244 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
 245 .br
 246 Report dir translation bugs to <http://translationproject.org/team/>
 247 .SH COPYRIGHT
 248 Copyright \(co 2016 Free Software Foundation, Inc.
 249 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
 250 .br
 251 This is free software: you are free to change and redistribute it.
 252 There is NO WARRANTY, to the extent permitted by law.
 253 .SH "SEE ALSO"
 254 Full documentation at: <http://www.gnu.org/software/coreutils/dir>
 255 .br
 256 or available locally via: info \(aq(coreutils) dir invocation\(aq