3 cfa37a7b 2004-04-10 devnull ls, lc \- list contents of directory
4 cfa37a7b 2004-04-10 devnull .SH SYNOPSIS
7 cfa37a7b 2004-04-10 devnull .B -dlmnpqrstuFQ
9 cfa37a7b 2004-04-10 devnull .I name ...
13 cfa37a7b 2004-04-10 devnull .B -dlmnqrstuFQ
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,
19 cfa37a7b 2004-04-10 devnull lists the contents of the directory;
20 cfa37a7b 2004-04-10 devnull for each file argument,
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.
27 cfa37a7b 2004-04-10 devnull is the same as
29 cfa37a7b 2004-04-10 devnull but sets the
31 cfa37a7b 2004-04-10 devnull option and pipes the output through
32 cfa37a7b 2004-04-10 devnull .IR mc (1).
34 cfa37a7b 2004-04-10 devnull There are a number of options:
37 cfa37a7b 2004-04-10 devnull If argument is a directory, list it, not
38 cfa37a7b 2004-04-10 devnull its contents.
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
44 cfa37a7b 2004-04-10 devnull code letter that names it; see
45 cfa37a7b 2004-04-10 devnull .IR 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.
51 cfa37a7b 2004-04-10 devnull List the name of the user who most recently modified the file.
54 cfa37a7b 2004-04-10 devnull Don't sort the listing.
57 cfa37a7b 2004-04-10 devnull Print only the final path element of each file name.
63 cfa37a7b 2004-04-10 devnull .IR stat (2))
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.
68 cfa37a7b 2004-04-10 devnull Reverse the order of sort.
71 cfa37a7b 2004-04-10 devnull Give size in Kbytes for each entry.
74 cfa37a7b 2004-04-10 devnull Sort by time modified (latest first) instead of
80 cfa37a7b 2004-04-10 devnull sort by time of last access;
83 cfa37a7b 2004-04-10 devnull print time of last access.
86 cfa37a7b 2004-04-10 devnull Add the character
88 cfa37a7b 2004-04-10 devnull after all directory names
89 cfa37a7b 2004-04-10 devnull and the character
91 cfa37a7b 2004-04-10 devnull after all executable files.
94 cfa37a7b 2004-04-10 devnull Print the character
96 cfa37a7b 2004-04-10 devnull before each file if it has the temporary flag set, and
98 cfa37a7b 2004-04-10 devnull otherwise.
101 cfa37a7b 2004-04-10 devnull By default, printed file names are quoted if they contain characters special to
102 cfa37a7b 2004-04-10 devnull .IR rc (1).
105 cfa37a7b 2004-04-10 devnull flag disables this behavior.
107 cfa37a7b 2004-04-10 devnull The mode printed under the
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
115 cfa37a7b 2004-04-10 devnull if the entry is a directory;
119 cfa37a7b 2004-04-10 devnull if the entry is an append-only file;
122 cfa37a7b 2004-04-10 devnull if the entry is a plain file.
125 cfa37a7b 2004-04-10 devnull The next letter is
127 cfa37a7b 2004-04-10 devnull if the file is exclusive access (one writer or reader at a time).
129 cfa37a7b 2004-04-10 devnull The last 9 characters are interpreted
130 cfa37a7b 2004-04-10 devnull as three sets of three bits each.
131 cfa37a7b 2004-04-10 devnull The first set refers to owner permissions;
132 cfa37a7b 2004-04-10 devnull the next to permissions to others in the same user-group;
133 cfa37a7b 2004-04-10 devnull and the last to all others.
134 cfa37a7b 2004-04-10 devnull Within each set the three characters indicate
135 cfa37a7b 2004-04-10 devnull permission respectively to read, to write, or to
136 cfa37a7b 2004-04-10 devnull execute the file as a program.
137 cfa37a7b 2004-04-10 devnull For a directory, `execute' permission is interpreted
138 cfa37a7b 2004-04-10 devnull to mean permission to search the directory
139 cfa37a7b 2004-04-10 devnull for a specified file.
140 cfa37a7b 2004-04-10 devnull The permissions are indicated as follows:
143 cfa37a7b 2004-04-10 devnull if the file is readable;
147 cfa37a7b 2004-04-10 devnull if the file is writable;
150 cfa37a7b 2004-04-10 devnull if the file is executable;
153 cfa37a7b 2004-04-10 devnull if none of the above permissions is granted.
155 cfa37a7b 2004-04-10 devnull .SH SOURCE
156 b5fdffee 2004-04-19 devnull .B /usr/local/plan9/src/cmd/ls.c
158 b5fdffee 2004-04-19 devnull .B /usr/local/plan9/bin/lc
159 cfa37a7b 2004-04-10 devnull .SH SEE ALSO
160 cfa37a7b 2004-04-10 devnull .IR stat (2)
161 cfa37a7b 2004-04-10 devnull .IR mc (1)
