man/vdir.1

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