1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.3.
2 .TH VDIR "1" "January 2016" "GNU coreutils 8.25" "User Commands"
4 vdir \- list directory contents
7 [\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
9 .\" Add any additional description here
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.
14 Mandatory arguments to long options are mandatory for short options too.
16 \fB\-a\fR, \fB\-\-all\fR
17 do not ignore entries starting with .
19 \fB\-A\fR, \fB\-\-almost\-all\fR
20 do not list implied . and ..
23 with \fB\-l\fR, print the author of each file
25 \fB\-b\fR, \fB\-\-escape\fR
26 print C\-style escapes for nongraphic characters
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
33 \fB\-B\fR, \fB\-\-ignore\-backups\fR
34 do not list implied entries ending with ~
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
43 list entries by columns
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
49 \fB\-d\fR, \fB\-\-directory\fR
50 list directories themselves, not their contents
52 \fB\-D\fR, \fB\-\-dired\fR
53 generate output designed for Emacs' dired mode
56 do not sort, enable \fB\-aU\fR, disable \fB\-ls\fR \fB\-\-color\fR
58 \fB\-F\fR, \fB\-\-classify\fR
59 append indicator (one of */=>@|) to entries
62 likewise, except do not append '*'
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
69 like \fB\-l\fR \fB\-\-time\-style\fR=\fI\,full\-iso\/\fR
72 like \fB\-l\fR, but do not list owner
74 \fB\-\-group\-directories\-first\fR
75 group directories before files;
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
80 \fB\-G\fR, \fB\-\-no\-group\fR
81 in a long listing, don't print group names
83 \fB\-h\fR, \fB\-\-human\-readable\fR
84 with \fB\-l\fR and/or \fB\-s\fR, print human readable sizes
88 likewise, but use powers of 1000 not 1024
90 \fB\-H\fR, \fB\-\-dereference\-command\-line\fR
91 follow symbolic links listed on the command line
93 \fB\-\-dereference\-command\-line\-symlink\-to\-dir\fR
94 follow each command line symbolic link
96 that points to a directory
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)
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)
107 \fB\-i\fR, \fB\-\-inode\fR
108 print the index number of each file
110 \fB\-I\fR, \fB\-\-ignore\fR=\fI\,PATTERN\/\fR
111 do not list implied entries matching shell PATTERN
113 \fB\-k\fR, \fB\-\-kibibytes\fR
114 default to 1024\-byte blocks for disk usage
117 use a long listing format
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
125 fill width with a comma separated list of entries
127 \fB\-n\fR, \fB\-\-numeric\-uid\-gid\fR
128 like \fB\-l\fR, but list numeric user and group IDs
130 \fB\-N\fR, \fB\-\-literal\fR
131 print raw entry names (don't treat e.g. control
132 characters specially)
135 like \fB\-l\fR, but do not list group information
137 \fB\-p\fR, \fB\-\-indicator\-style\fR=\fI\,slash\/\fR
138 append / indicator to directories
140 \fB\-q\fR, \fB\-\-hide\-control\-chars\fR
141 print ? instead of nongraphic characters
143 \fB\-\-show\-control\-chars\fR
144 show nongraphic characters as\-is (the default,
145 unless program is 'ls' and output is a terminal)
147 \fB\-Q\fR, \fB\-\-quote\-name\fR
148 enclose entry names in double quotes
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
155 \fB\-r\fR, \fB\-\-reverse\fR
156 reverse order while sorting
158 \fB\-R\fR, \fB\-\-recursive\fR
159 list subdirectories recursively
161 \fB\-s\fR, \fB\-\-size\fR
162 print the allocated size of each file, in blocks
165 sort by file size, largest first
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)
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)
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
187 sort by modification time, newest first
189 \fB\-T\fR, \fB\-\-tabsize\fR=\fI\,COLS\/\fR
190 assume tab stops at each COLS instead of 8
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
198 do not sort; list entries in directory order
201 natural sort of (version) numbers within text
203 \fB\-w\fR, \fB\-\-width\fR=\fI\,COLS\/\fR
204 set output width to COLS. 0 means no limit
207 list entries by lines instead of by columns
210 sort alphabetically by entry extension
212 \fB\-Z\fR, \fB\-\-context\fR
213 print any security context of each file
216 list one file per line. Avoid '\en' with \fB\-q\fR or \fB\-b\fR
219 display this help and exit
222 output version information and exit
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).
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.
237 if minor problems (e.g., cannot access subdirectory),
240 if serious trouble (e.g., cannot access command\-line argument).
242 Written by Richard M. Stallman and David MacKenzie.
244 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
246 Report vdir translation bugs to <http://translationproject.org/team/>
248 Copyright \(co 2016 Free Software Foundation, Inc.
249 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
251 This is free software: you are free to change and redistribute it.
252 There is NO WARRANTY, to the extent permitted by law.
254 Full documentation at: <http://www.gnu.org/software/coreutils/vdir>
256 or available locally via: info \(aq(coreutils) vdir invocation\(aq