ls.1 - sbase - suckless unix tools
HTML git clone git://git.suckless.org/sbase
DIR Log
DIR Files
DIR Refs
DIR README
DIR LICENSE
---
ls.1 (2243B)
---
1 .Dd October 8, 2015
2 .Dt LS 1
3 .Os sbase
4 .Sh NAME
5 .Nm ls
6 .Nd list directory contents
7 .Sh SYNOPSIS
8 .Nm
9 .Op Fl iqr
10 .Op Fl ln
11 .Op Fl A | a
12 .Op Fl 1
13 .Op Fl h | F | p
14 .Op Fl H | L
15 .Op Fl R | d
16 .Op Fl S | f | t | U
17 .Op Fl c | u
18 .Op Ar file ...
19 .Sh DESCRIPTION
20 .Nm
21 lists each given file, and the contents of each given directory.
22 If no files are given the current directory is listed.
23 .Sh OPTIONS
24 .Bl -tag -width Ds
25 .It Fl A
26 List all entries except for '.' and '..'.
27 .It Fl a
28 Show hidden files (those beginning with '.').
29 .It Fl c
30 Use time file's status was last changed instead of last
31 modification time for sorting or printing.
32 .It Fl d
33 List directories themselves, not their contents.
34 .It Fl F
35 Append a file type indicator to all special files.
36 .It Fl f
37 Like
38 .Fl U
39 but turns on
40 .Fl a
41 and disables
42 .Fl r ,
43 .Fl S
44 and
45 .Fl t .
46 .It Fl H
47 List information about the targets of symbolic links specified on the command
48 line instead of the links themselves.
49 .It Fl h
50 Show filesizes in human\-readable format.
51 .It Fl i
52 Print the index number of each file.
53 .It Fl L
54 List information about the targets of symbolic links instead of the links
55 themselves.
56 .It Fl l
57 List detailed information about each file, including their type, permissions,
58 links, owner, group, size or major and minor numbers if the file is a
59 character/block device, and last file status/modification time.
60 .It Fl n
61 List detailed information about each file, including their type, permissions,
62 links, owner, group, size or major and minor numbers if the file is a
63 character/block device, and last file status/modification time, but with
64 numeric IDs.
65 .It Fl p
66 Append a file type indicator to directories.
67 .It Fl q
68 Replace non-printable characters in filenames with '?'.
69 .It Fl R
70 List directory content recursively.
71 The
72 .Fl 1
73 flag is set implicitly.
74 .It Fl r
75 Reverse the sort order.
76 .It Fl S
77 Sort files by size (in decreasing order).
78 .It Fl t
79 Sort files by last file status/modification time instead of by name.
80 .It Fl U
81 Keep the list unsorted.
82 .It Fl u
83 Use file's last access time instead of last modification time for
84 sorting or printing.
85 .El
86 .Sh SEE ALSO
87 .Xr stat 2
88 .Sh STANDARDS
89 POSIX.1-2013.
90 Except for the
91 .Op Fl Ckmpsx
92 flags.
93 .Pp
94 The
95 .Op Fl hU
96 flags are an extension to that specification.