Debian Codegraph @

upstream/debian-unstable/man1/vdir.1

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