VDIR(1)                          User Commands
VDIR(1)



NNAAMMEE
       vdir - list directory contents

SSYYNNOOPPSSIISS
       vvddiirr [_O_P_T_I_O_N]... [_F_I_L_E]...

DDEESSCCRRIIPPTTIIOONN
       List  information  about  the FILEs (the current
       directory by default).  Sort entries alphabetically
       if none of --ccffttuuvvSSUUXX nor
       ----ssoorrtt.

       Mandatory arguments to long options are  mandatory
       for  short  options too.

       --aa, ----aallll
              do not ignore entries starting with .

       --AA, ----aallmmoosstt--aallll
              do not list implied . and ..

       ----aauutthhoorr
              with --ll, print the author of each file

       --bb, ----eessccaappee
              print octal escapes for nongraphic characters

       ----bblloocckk--ssiizzee=_S_I_Z_E
              use SIZE-byte blocks

       --BB, ----iiggnnoorree--bbaacckkuuppss
              do not list implied entries ending with ~

       --cc     with --lltt: sort by, and show, ctime
       (time of last modification of
              file status information) with --ll: show ctime
              and  sort  by  name otherwise: sort by ctime

       --CC     list entries by columns

       ----ccoolloorr[=_W_H_E_N]
              control  whether  color is used to distinguish
              file types.  WHEN may be `never', `always', or
              `auto'

       --dd, ----ddiirreeccttoorryy
              list directory entries instead of contents,
              and do not  derefer‐ ence symbolic links

       --DD, ----ddiirreedd
              generate output designed for Emacs' dired mode

       --ff     do not sort, enable --aaUU, disable
       --llss ----ccoolloorr

       --FF, ----ccllaassssiiffyy
              append indicator (one of */=>@|) to entries

       ----ffiillee--ttyyppee
              likewise, except do not append `*'

       ----ffoorrmmaatt=_W_O_R_D
              across  --xx, commas --mm, horizontal
              --xx, long --ll, single-column --11,
              verbose --ll, vertical --CC

       ----ffuullll--ttiimmee
              like --ll
              ----ttiimmee--ssttyyllee=_f_u_l_l_-_i_s_o

       --gg     like --ll, but do not list owner

       ----ggrroouupp--ddiirreeccttoorriieess--ffiirrsstt
              group directories before files

       --GG, ----nnoo--ggrroouupp
              in a long listing, don't print group names

       --hh, ----hhuummaann--rreeaaddaabbllee
              with --ll, print sizes in human readable format
              (e.g., 1K 234M 2G)

       ----ssii   likewise, but use powers of 1000 not 1024

       --HH,
       ----ddeerreeffeerreennccee--ccoommmmaanndd--lliinnee
              follow symbolic links listed on the command line

       ----ddeerreeffeerreennccee--ccoommmmaanndd--lliinnee--ssyymmlliinnkk--ttoo--ddiirr
              follow each command line symbolic link that
              points to  a  direc‐ tory

       ----hhiiddee=_P_A_T_T_E_R_N
              do  not  list implied entries matching shell
              PATTERN (overridden by --aa or --AA)

       ----iinnddiiccaattoorr--ssttyyllee=_W_O_R_D
       append indicator with style WORD to entry names:
              none (default), slash (--pp),  file-type
              (----ffiillee--ttyyppee),  classify
              (--FF)

       --ii, ----iinnooddee
              print the index number of each file

       --II, ----iiggnnoorree=_P_A_T_T_E_R_N
              do not list implied entries matching shell
              PATTERN

       --kk     like
       ----bblloocckk--ssiizzee=_1_K

       --ll     use a long listing format

       --LL, ----ddeerreeffeerreennccee
              when showing file information for a symbolic
              link, show informa‐ tion for the file the
              link references rather than for  the  link itself

       --mm     fill width with a comma separated list
       of entries

       --nn,
       ----nnuummeerriicc--uuiidd--ggiidd
              like --ll, but list numeric user and group IDs

       --NN, ----lliitteerraall
              print  raw entry names (don't treat e.g. control
              characters spe‐ cially)

       --oo     like --ll, but do not list group
       information

       --pp,
       ----iinnddiiccaattoorr--ssttyyllee=_s_l_a_s_h
              append / indicator to directories

       --qq,
       ----hhiiddee--ccoonnttrrooll--cchhaarrss
              print ? instead of non graphic characters

       ----sshhooww--ccoonnttrrooll--cchhaarrss
              show non graphic characters as-is  (default
              unless  program  is `ls' and output is a
              terminal)

       --QQ, ----qquuoottee--nnaammee
              enclose entry names in double quotes

       ----qquuoottiinngg--ssttyyllee=_W_O_R_D
              use  quoting style WORD for entry names: literal,
              locale, shell, shell-always, c, escape

       --rr, ----rreevveerrssee
              reverse order while sorting

       --RR, ----rreeccuurrssiivvee
              list subdirectories recursively

       --ss, ----ssiizzee
              print the size of each file, in blocks

       --SS     sort by file size

       ----ssoorrtt=_W_O_R_D
              sort by WORD instead of name: none --UU,
              extension  --XX,  size  --SS, time --tt,
              version --vv

       ----ttiimmee=_W_O_R_D
              with  --ll,  show time as WORD instead
              of modification time: atime --uu, access
              --uu, use --uu, ctime --cc, or  status
              --cc;  use  specified time as sort key if
              ----ssoorrtt=_t_i_m_e

       ----ttiimmee--ssttyyllee=_S_T_Y_L_E
              with  --ll, show times using style STYLE:
              full-iso, long-iso, iso, locale, +FORMAT.
              FORMAT is interpreted like `date';  if  FORMAT
              is  FORMAT1<newline>FORMAT2, FORMAT1 applies to
              non-recent files and FORMAT2 to recent files;
              if STYLE is prefixed with `posix-', STYLE takes
              effect only outside the POSIX locale

       --tt     sort by modification time

       --TT, ----ttaabbssiizzee=_C_O_L_S
              assume tab stops at each COLS instead of 8

       --uu     with  --lltt:  sort  by, and show,
       access time with --ll: show access
              time and sort by name otherwise: sort by
              access time

       --UU     do not sort; list entries in directory order

       --vv     sort by version

       --ww, ----wwiiddtthh=_C_O_L_S
              assume screen width instead of current value

       --xx     list entries by lines instead of by columns

       --XX     sort alphabetically by entry extension

       --11     list one file per line

       ----hheellpp display this help and exit

       ----vveerrssiioonn
              output version information and exit

       SIZE may be (or may be an integer optionally followed
       by) one  of  fol‐ lowing: kB 1000, K 1024, MB
       1000*1000, M 1024*1024, and so on for G, T, P, E, Z, Y.

       By default, color is not used to distinguish
       types of files.   That  is equivalent to
       using ----ccoolloorr=_n_o_n_e.
       Using the ----ccoolloorr option without
       the optional WHEN argument is equivalent  to
       using  ----ccoolloorr=_a_l_w_a_y_s.
       With ----ccoolloorr=_a_u_t_o,  color  codes
       are output only if standard output is con‐ nected
       to a terminal (tty).  The  environment  variable
       LS_COLORS  can influence the colors, and can be set
       easily by the dircolors command.

       Exit status is 0 if OK, 1 if minor problems, 2 if
       serious trouble.

AAUUTTHHOORR
       Written by Richard Stallman and David MacKenzie.

RREEPPOORRTTIINNGG BBUUGGSS
       Report bugs to <bug-coreutils@gnu.org>.

CCOOPPYYRRIIGGHHTT
       Copyright © 2006 Free Software Foundation, Inc.
       This  is  free  software.   You may redistribute
       copies of it under the terms      of      the
       GNU      General       Public       License
       <http://www.gnu.org/licenses/gpl.html>.   There  is
       NO WARRANTY, to the extent permitted by law.

SSEEEE AALLSSOO
       The full documentation for vvddiirr is maintained
       as a Texinfo manual.   If the  iinnffoo  and
       vvddiirr  programs are properly installed at your
       site, the command

              iinnffoo vvddiirr

       should give you access to the complete manual.



vdir 6.7                         December 2006
VDIR(1)
