.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.28..TH LS "1" "July 2002" "ls (fileutils) 4.1.10" "User Commands".SH NAMEls \- list directory contents.SH SYNOPSIS.B ls[\fIOPTION\fR]... [\fIFILE\fR]....SH DESCRIPTION.\" Add any additional description here.PPList information about the FILEs (the current directory by default).Sort entries alphabetically if none of \fB\-cftuSUX\fR nor \fB\-\-sort\fR..PPMandatory arguments to long options are mandatory for short options too..TP\fB\-a\fR, \fB\-\-all\fRdo not hide entries starting with ..TP\fB\-A\fR, \fB\-\-almost\-all\fRdo not list implied . and ...TP\fB\-\-author\fRprint the author of each file.TP\fB\-b\fR, \fB\-\-escape\fRprint octal escapes for nongraphic characters.TP\fB\-\-block\-size\fR=\fISIZE\fRuse SIZE-byte blocks.TP\fB\-B\fR, \fB\-\-ignore\-backups\fRdo not list implied entries ending with ~.TP\fB\-c\fRwith \fB\-lt\fR: sort by, and show, ctime (time of lastmodification of file status information)with \fB\-l\fR: show ctime and sort by nameotherwise: sort by ctime.TP\fB\-C\fRlist entries by columns.TP\fB\-\-color\fR[=\fIWHEN\fR]control whether color is used to distinguish filetypes.  WHEN may be `never', `always', or `auto'.TP\fB\-d\fR, \fB\-\-directory\fRlist directory entries instead of contents.TP\fB\-D\fR, \fB\-\-dired\fRgenerate output designed for Emacs' dired mode.TP\fB\-f\fRdo not sort, enable \fB\-aU\fR, disable \fB\-lst\fR.TP\fB\-F\fR, \fB\-\-classify\fRappend indicator (one of */=@|) to entries.TP\fB\-\-format\fR=\fIWORD\fRacross \fB\-x\fR, commas \fB\-m\fR, horizontal \fB\-x\fR, long \fB\-l\fR,single-column \fB\-1\fR, verbose \fB\-l\fR, vertical \fB\-C\fR.TP\fB\-\-full\-time\fRlike \fB\-l\fR \fB\-\-time\-style\fR=\fIfull\-iso\fR.TP\fB\-g\fRlike \fB\-l\fR, but do not list owner.TP\fB\-G\fR, \fB\-\-no\-group\fRinhibit display of group information.TP\fB\-h\fR, \fB\-\-human\-readable\fRprint sizes in human readable format (e.g., 1K 234M 2G).TP\fB\-\-si\fRlikewise, but use powers of 1000 not 1024.TP\fB\-H\fR, \fB\-\-dereference\-command\-line\fRfollow symbolic links on the command line.TP\fB\-\-indicator\-style\fR=\fIWORD\fR append indicator with style WORD to entry names:none (default), classify (-F), file-type (-p).TP\fB\-i\fR, \fB\-\-inode\fRprint index number of each file.TP\fB\-I\fR, \fB\-\-ignore\fR=\fIPATTERN\fRdo not list implied entries matching shell PATTERN.TP\fB\-k\fRlike \fB\-\-block\-size\fR=\fI1K\fR.TP\fB\-l\fRuse a long listing format.TP\fB\-L\fR, \fB\-\-dereference\fRwhen showing file information for a symboliclink, show information for the file the linkreferences rather than for the link itself.TP\fB\-m\fRfill width with a comma separated list of entries.TP\fB\-n\fR, \fB\-\-numeric\-uid\-gid\fRlike \fB\-l\fR, but list numeric UIDs and GIDs.TP\fB\-N\fR, \fB\-\-literal\fRprint raw entry names (don't treat e.g. controlcharacters specially).TP\fB\-o\fRlike \fB\-l\fR, but do not list group information.TP\fB\-p\fR, \fB\-\-file\-type\fRappend indicator (one of /=@|) to entries.TP\fB\-q\fR, \fB\-\-hide\-control\-chars\fRprint ? instead of non graphic characters.TP\fB\-\-show\-control\-chars\fRshow non graphic characters as-is (defaultunless program is `ls' and output is a terminal).TP\fB\-Q\fR, \fB\-\-quote\-name\fRenclose entry names in double quotes.TP\fB\-\-quoting\-style\fR=\fIWORD\fRuse quoting style WORD for entry names:literal, locale, shell, shell-always, c, escape.TP\fB\-r\fR, \fB\-\-reverse\fRreverse order while sorting.TP\fB\-R\fR, \fB\-\-recursive\fRlist subdirectories recursively.TP\fB\-s\fR, \fB\-\-size\fRprint size of each file, in blocks.TP\fB\-S\fRsort by file size.TP\fB\-\-sort\fR=\fIWORD\fRextension \fB\-X\fR, none \fB\-U\fR, size \fB\-S\fR, time \fB\-t\fR,version \fB\-v\fR.IPstatus \fB\-c\fR, time \fB\-t\fR, atime \fB\-u\fR, access \fB\-u\fR, use \fB\-u\fR.TP\fB\-\-time\fR=\fIWORD\fRshow time as WORD instead of modification time:atime, access, use, ctime or status; usespecified time as sort key if \fB\-\-sort\fR=\fItime\fR.TP\fB\-\-time\-style\fR=\fISTYLE\fRshow times using style STYLE:full-iso, long-iso, iso, locale, +FORMAT.IPFORMAT is interpreted like `date'; if FORMAT isFORMAT1<newline>FORMAT2, FORMAT1 applies tonon-recent files and FORMAT2 to recent files;if STYLE is prefixed with `posix-', STYLEtakes effect only outside the POSIX locale.TP\fB\-t\fRsort by modification time.TP\fB\-T\fR, \fB\-\-tabsize\fR=\fICOLS\fRassume tab stops at each COLS instead of 8.TP\fB\-u\fRwith \fB\-lt\fR: sort by, and show, access timewith \fB\-l\fR: show access time and sort by nameotherwise: sort by access time.TP\fB\-U\fRdo not sort; list entries in directory order.TP\fB\-v\fRsort by version.TP\fB\-w\fR, \fB\-\-width\fR=\fICOLS\fRassume screen width instead of current value.TP\fB\-x\fRlist entries by lines instead of by columns.TP\fB\-X\fRsort alphabetically by entry extension.TP\fB\-1\fRlist one file per line.TP\fB\-\-help\fRdisplay this help and exit.TP\fB\-\-version\fRoutput version information and exit.PPSIZE may be (or may be an integer optionally followed by) one of following:kB 1000, K 1024, MB 1,000,000, M 1,048,576, and so on for G, T, P, E, Z, Y..PPBy default, color is not used to distinguish types of files.  That isequivalent to using \fB\-\-color\fR=\fInone\fR.  Using the \fB\-\-color\fR option without theoptional WHEN argument is equivalent to using \fB\-\-color\fR=\fIalways\fR.  With\fB\-\-color\fR=\fIauto\fR, color codes are output only if standard output is connectedto a terminal (tty)..SH AUTHORWritten by Richard Stallman and David MacKenzie..SH "REPORTING BUGS"Report bugs to <bug-fileutils@gnu.org>..SH COPYRIGHTCopyright \(co 2002 Free Software Foundation, Inc..brThis is free software; see the source for copying conditions.  There is NOwarranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE..SH "SEE ALSO"The full documentation for.B lsis maintained as a Texinfo manual.  If the.B infoand.B lsprograms are properly installed at your site, the command.IP.B info ls.PPshould give you access to the complete manual.