ls.1 (2295B)
- .Dd 2015-10-08
- .Dt LS 1
- .Os sbase
- .Sh NAME
- .Nm ls
- .Nd list directory contents
- .Sh SYNOPSIS
- .Nm
- .Op Fl iqr
- .Op Fl ln
- .Op Fl A | a
- .Op Fl 1
- .Op Fl h | F | p
- .Op Fl H | L
- .Op Fl R | d
- .Op Fl S | f | t | U
- .Op Fl c | u
- .Op Ar file ...
- .Sh DESCRIPTION
- .Nm
- lists each given file, and the contents of each given directory.
- If no files are given the current directory is listed.
- .Sh OPTIONS
- .Bl -tag -width Ds
- .It Fl A
- List all entries except for '.' and '..'.
- .It Fl a
- Show hidden files (those beginning with '.').
- .It Fl c
- Use time file's status was last changed instead of last
- modification time for sorting or printing.
- .It Fl d
- List directories themselves, not their contents.
- .It Fl F
- Append a file type indicator to all special files.
- .It Fl f
- Like
- .Fl U
- but turns on
- .Fl a
- and disables
- .Fl r ,
- .Fl S
- and
- .Fl t .
- .It Fl H
- List information about the targets of symbolic links specified on the command
- line instead of the links themselves.
- .It Fl h
- Show filesizes in human\-readable format.
- .It Fl i
- Print the index number of each file.
- .It Fl L
- List information about the targets of symbolic links instead of the links
- themselves.
- .It Fl l
- List detailed information about each file, including their type, permissions,
- links, owner, group, size or major and minor numbers if the file is a
- character/block device, and last file status/modification time.
- .It Fl n
- List detailed information about each file, including their type, permissions,
- links, owner, group, size or major and minor numbers if the file is a
- character/block device, and last file status/modification time, but with
- numeric IDs.
- .It Fl p
- Append a file type indicator to directories.
- .It Fl q
- Replace non-printable characters in filenames with '?'.
- .It Fl R
- List directory content recursively.
- The
- .Fl 1
- flag is set implicitly.
- .It Fl r
- Reverse the sort order.
- .It Fl S
- Sort files by size (in decreasing order).
- .It Fl t
- Sort files by last file status/modification time instead of by name.
- .It Fl U
- Keep the list unsorted.
- .It Fl u
- Use file's last access time instead of last modification time for
- sorting or printing.
- .El
- .Sh SEE ALSO
- .Xr stat 2
- .Sh STANDARDS
- The
- .Nm
- utility is compliant with the
- .St -p1003.1-2013
- specification except from the
- .Op Fl Ckmpsx
- flags.
- .Pp
- The
- .Op Fl hU
- flags are an extension to that specification.