Blame


1 cfa37a7b 2004-04-10 devnull .TH LS 1
2 cfa37a7b 2004-04-10 devnull .SH NAME
3 cfa37a7b 2004-04-10 devnull ls, lc \- list contents of directory
4 cfa37a7b 2004-04-10 devnull .SH SYNOPSIS
5 cfa37a7b 2004-04-10 devnull .B ls
6 cfa37a7b 2004-04-10 devnull [
7 cfa37a7b 2004-04-10 devnull .B -dlmnpqrstuFQ
8 cfa37a7b 2004-04-10 devnull ]
9 cfa37a7b 2004-04-10 devnull .I name ...
10 cfa37a7b 2004-04-10 devnull .PP
11 cfa37a7b 2004-04-10 devnull .B lc
12 cfa37a7b 2004-04-10 devnull [
13 058b0118 2005-01-03 devnull .B -dlmnpqrstuFQ
14 cfa37a7b 2004-04-10 devnull ]
15 cfa37a7b 2004-04-10 devnull .I name ...
16 cfa37a7b 2004-04-10 devnull .SH DESCRIPTION
17 cfa37a7b 2004-04-10 devnull For each directory argument,
18 cfa37a7b 2004-04-10 devnull .I ls
19 cfa37a7b 2004-04-10 devnull lists the contents of the directory;
20 cfa37a7b 2004-04-10 devnull for each file argument,
21 cfa37a7b 2004-04-10 devnull .I ls
22 cfa37a7b 2004-04-10 devnull repeats its name and any other information requested.
23 cfa37a7b 2004-04-10 devnull When no argument is given, the current directory is listed.
24 cfa37a7b 2004-04-10 devnull By default, the output is sorted alphabetically by name.
25 cfa37a7b 2004-04-10 devnull .PP
26 cfa37a7b 2004-04-10 devnull .I Lc
27 cfa37a7b 2004-04-10 devnull is the same as
28 cfa37a7b 2004-04-10 devnull .IR ls ,
29 cfa37a7b 2004-04-10 devnull but sets the
30 cfa37a7b 2004-04-10 devnull .B -p
31 cfa37a7b 2004-04-10 devnull option and pipes the output through
32 d32deab1 2020-08-16 rsc .MR mc (1) .
33 cfa37a7b 2004-04-10 devnull .PP
34 cfa37a7b 2004-04-10 devnull There are a number of options:
35 cfa37a7b 2004-04-10 devnull .TP
36 cfa37a7b 2004-04-10 devnull .B -d
37 cfa37a7b 2004-04-10 devnull If argument is a directory, list it, not
38 cfa37a7b 2004-04-10 devnull its contents.
39 cfa37a7b 2004-04-10 devnull .TP
40 cfa37a7b 2004-04-10 devnull .B -l
41 cfa37a7b 2004-04-10 devnull List in long format, giving mode (see below), file system type
42 cfa37a7b 2004-04-10 devnull (e.g., for devices, the
43 cfa37a7b 2004-04-10 devnull .B #
44 cfa37a7b 2004-04-10 devnull code letter that names it; see
45 d32deab1 2020-08-16 rsc .MR intro (3) ),
46 cfa37a7b 2004-04-10 devnull the instance or subdevice number, owner, group,
47 cfa37a7b 2004-04-10 devnull size in bytes, and time of last modification
48 cfa37a7b 2004-04-10 devnull for each file.
49 cfa37a7b 2004-04-10 devnull .TP
50 cfa37a7b 2004-04-10 devnull .B -m
51 cfa37a7b 2004-04-10 devnull List the name of the user who most recently modified the file.
52 cfa37a7b 2004-04-10 devnull .TP
53 cfa37a7b 2004-04-10 devnull .B -n
54 cfa37a7b 2004-04-10 devnull Don't sort the listing.
55 cfa37a7b 2004-04-10 devnull .TP
56 cfa37a7b 2004-04-10 devnull .B -p
57 cfa37a7b 2004-04-10 devnull Print only the final path element of each file name.
58 cfa37a7b 2004-04-10 devnull .TP
59 cfa37a7b 2004-04-10 devnull .B -q
60 cfa37a7b 2004-04-10 devnull List the
61 cfa37a7b 2004-04-10 devnull .I qid
62 cfa37a7b 2004-04-10 devnull (see
63 d32deab1 2020-08-16 rsc .MR stat (3) )
64 cfa37a7b 2004-04-10 devnull of each file; the printed fields are in the order
65 cfa37a7b 2004-04-10 devnull path, version, and type.
66 cfa37a7b 2004-04-10 devnull .TP
67 cfa37a7b 2004-04-10 devnull .B -r
68 cfa37a7b 2004-04-10 devnull Reverse the order of sort.
69 cfa37a7b 2004-04-10 devnull .TP
70 cfa37a7b 2004-04-10 devnull .B -s
71 cfa37a7b 2004-04-10 devnull Give size in Kbytes for each entry.
72 cfa37a7b 2004-04-10 devnull .TP
73 cfa37a7b 2004-04-10 devnull .B -t
74 cfa37a7b 2004-04-10 devnull Sort by time modified (latest first) instead of
75 cfa37a7b 2004-04-10 devnull by name.
76 cfa37a7b 2004-04-10 devnull .TP
77 cfa37a7b 2004-04-10 devnull .B -u
78 cfa37a7b 2004-04-10 devnull Under
79 cfa37a7b 2004-04-10 devnull .B -t
80 cfa37a7b 2004-04-10 devnull sort by time of last access;
81 cfa37a7b 2004-04-10 devnull under
82 cfa37a7b 2004-04-10 devnull .B -l
83 cfa37a7b 2004-04-10 devnull print time of last access.
84 cfa37a7b 2004-04-10 devnull .TP
85 cfa37a7b 2004-04-10 devnull .B -F
86 cfa37a7b 2004-04-10 devnull Add the character
87 cfa37a7b 2004-04-10 devnull .B /
88 cfa37a7b 2004-04-10 devnull after all directory names
89 cfa37a7b 2004-04-10 devnull and the character
90 cfa37a7b 2004-04-10 devnull .B *
91 cfa37a7b 2004-04-10 devnull after all executable files.
92 cfa37a7b 2004-04-10 devnull .TP
93 cfa37a7b 2004-04-10 devnull .B -L
94 cfa37a7b 2004-04-10 devnull Print the character
95 cfa37a7b 2004-04-10 devnull .B t
96 cfa37a7b 2004-04-10 devnull before each file if it has the temporary flag set, and
97 cfa37a7b 2004-04-10 devnull .B -
98 cfa37a7b 2004-04-10 devnull otherwise.
99 cfa37a7b 2004-04-10 devnull .TP
100 cfa37a7b 2004-04-10 devnull .B -Q
101 cfa37a7b 2004-04-10 devnull By default, printed file names are quoted if they contain characters special to
102 d32deab1 2020-08-16 rsc .MR rc (1) .
103 cfa37a7b 2004-04-10 devnull The
104 cfa37a7b 2004-04-10 devnull .B -Q
105 cfa37a7b 2004-04-10 devnull flag disables this behavior.
106 cfa37a7b 2004-04-10 devnull .PP
107 cfa37a7b 2004-04-10 devnull The mode printed under the
108 cfa37a7b 2004-04-10 devnull .B -l
109 cfa37a7b 2004-04-10 devnull option contains 11 characters,
110 cfa37a7b 2004-04-10 devnull interpreted
111 cfa37a7b 2004-04-10 devnull as follows:
112 cfa37a7b 2004-04-10 devnull the first character is
113 cfa37a7b 2004-04-10 devnull .TP
114 8a750906 2005-02-08 devnull .B d
115 cfa37a7b 2004-04-10 devnull if the entry is a directory;
116 cfa37a7b 2004-04-10 devnull .TP
117 8a750906 2005-02-08 devnull .B a
118 cfa37a7b 2004-04-10 devnull if the entry is an append-only file;
119 cfa37a7b 2004-04-10 devnull .TP
120 8a750906 2005-02-08 devnull .B D
121 8a750906 2005-02-08 devnull if the entry is a Unix device;
122 8a750906 2005-02-08 devnull .TP
123 8a750906 2005-02-08 devnull .B L
124 8a750906 2005-02-08 devnull if the entry is a symbolic link;
125 8a750906 2005-02-08 devnull .TP
126 8a750906 2005-02-08 devnull .B P
127 8a750906 2005-02-08 devnull if the entry is a named pipe;
128 8a750906 2005-02-08 devnull .TP
129 8a750906 2005-02-08 devnull .B S
130 8a750906 2005-02-08 devnull if the entry is a socket;
131 8a750906 2005-02-08 devnull .TP
132 cfa37a7b 2004-04-10 devnull .B -
133 cfa37a7b 2004-04-10 devnull if the entry is a plain file.
134 cfa37a7b 2004-04-10 devnull .PD
135 cfa37a7b 2004-04-10 devnull .PP
136 cfa37a7b 2004-04-10 devnull The next letter is
137 cfa37a7b 2004-04-10 devnull .B l
138 cfa37a7b 2004-04-10 devnull if the file is exclusive access (one writer or reader at a time).
139 cfa37a7b 2004-04-10 devnull .PP
140 cfa37a7b 2004-04-10 devnull The last 9 characters are interpreted
141 cfa37a7b 2004-04-10 devnull as three sets of three bits each.
142 cfa37a7b 2004-04-10 devnull The first set refers to owner permissions;
143 cfa37a7b 2004-04-10 devnull the next to permissions to others in the same user-group;
144 cfa37a7b 2004-04-10 devnull and the last to all others.
145 cfa37a7b 2004-04-10 devnull Within each set the three characters indicate
146 cfa37a7b 2004-04-10 devnull permission respectively to read, to write, or to
147 cfa37a7b 2004-04-10 devnull execute the file as a program.
148 cfa37a7b 2004-04-10 devnull For a directory, `execute' permission is interpreted
149 cfa37a7b 2004-04-10 devnull to mean permission to search the directory
150 cfa37a7b 2004-04-10 devnull for a specified file.
151 cfa37a7b 2004-04-10 devnull The permissions are indicated as follows:
152 cfa37a7b 2004-04-10 devnull .TP 3
153 cfa37a7b 2004-04-10 devnull .B r
154 cfa37a7b 2004-04-10 devnull if the file is readable;
155 cfa37a7b 2004-04-10 devnull .PD 0
156 cfa37a7b 2004-04-10 devnull .TP 3
157 cfa37a7b 2004-04-10 devnull .B w
158 cfa37a7b 2004-04-10 devnull if the file is writable;
159 cfa37a7b 2004-04-10 devnull .TP 3
160 cfa37a7b 2004-04-10 devnull .B x
161 cfa37a7b 2004-04-10 devnull if the file is executable;
162 cfa37a7b 2004-04-10 devnull .TP 3
163 cfa37a7b 2004-04-10 devnull .B -
164 cfa37a7b 2004-04-10 devnull if none of the above permissions is granted.
165 cfa37a7b 2004-04-10 devnull .PD
166 cfa37a7b 2004-04-10 devnull .SH SOURCE
167 c3674de4 2005-01-11 devnull .B \*9/src/cmd/ls.c
168 cfa37a7b 2004-04-10 devnull .br
169 c3674de4 2005-01-11 devnull .B \*9/bin/lc
170 cfa37a7b 2004-04-10 devnull .SH SEE ALSO
171 d32deab1 2020-08-16 rsc .MR stat (3) ,
172 d32deab1 2020-08-16 rsc .MR mc (1)