| .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. |