0e2f509883
Although major() and minor() are not POSIX, we don't want to have macros there so we rely on their implementation by the target system.
99 lines
2.2 KiB
Groff
99 lines
2.2 KiB
Groff
.Dd March 27, 2015
|
|
.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.
|