Attachment #56152 for bug #84765

View | Details | Raw Unified | Return to bug 84765
Collapse All | Expand All




.It Fl i
For each file, print the file's file serial number (inode number).
.It Fl k
This has the same effect as setting the environment variable
.Ev BLOCKSIZE
to 1024, except that it also nullifies any
.Fl h
options to its left.
.Ev BLOCKSIZE .
Note that
.Fl k
is mutually exclusive to
.Fl h ,
and later
.Fl k
will nullify earlier
.Fl h .
.It Fl l
(The lowercase letter
.Dq ell . )
List files in the long format, as described in the
.Sx The Long Format
subsection below.
.Fl s
option for the block size unit) for all the file
sizes is output on a line before the long listing.
.It Fl m
Stream output format; list files across the page, separated by commas.
.It Fl n

Reverse the order of the sort to get reverse
lexicographical order or the oldest entries first.
.It Fl s
Display the number of file system blocks used by each file.
Block sizes and directory totals are handled as decribed in
.Sx The Long Format
subsection below, except (for unknown reasons) the directory totals
are only output with multi-column outputs.
.Ev BLOCKSIZE
overrides the unit size of 512 bytes.
.It Fl t
Sort by time modified (most recently modified
first) before sorting the operands by lexicographical

month, day-of-month file was last modified,
hour file last modified, minute file last
modified, and the pathname.
In addition, for each directory whose contents are displayed, the total
number of 512-byte blocks used by the files in the directory is displayed
on a line by itself immediately before the information for the files in the
directory.
.Pp
If the modification time of the file is more than 6 months
in the past or future, then the year of the last modification

linked-to file is preceded by
.Dq Li -> .
.Pp
If a file is a directory (and
.Fl d
is not used), the listing of the directory's contents is preceeded
by a labeled total number of file system blocks used by the files
listed as the directory's contents (which may or may not include
.Pa \&.
and
.Pa ..
and other files which start with a dot, depending on other options).
.Pp
The default block size is 512 bytes.
It may be set with the
.Fl k
option or the
.Ev BLOCKSIZE
environment variable.
Output numbers of blocks will have been rounded up so the number of bytes
is at least as many as is used by the corresponding file system blocks
which might have a different size.
.Pp
The file mode printed under the
.Fl l
option consists of the

.Nm :
.Bl -tag -width ".Ev CLICOLOR_FORCE"
.It Ev BLOCKSIZE
If this is set, its value, rounded up to 512 or down to a
multiple of 512, will be used as the block size in bytes by the
.Fl l
and
.Fl s
options.
See
.Sx The Long Format
subsection for more information.
.It Ev CLICOLOR
Use
.Tn ANSI

.Sh BUGS
To maintain backward compatibility, the relationships between the many
options are quite complex.
.Pp
The exception mentioned in the
.Fl s
option description is probably a bug.

Return to bug 84765

Lines 176-204 Link Here

(-)ls.1 (-37 / +46 lines)
176	.It Fl i	176	.It Fl i
177	For each file, print the file's file serial number (inode number).	177	For each file, print the file's file serial number (inode number).
178	.It Fl k	178	.It Fl k
179	If the	179	This has the same effect as setting the environment variable
180	.Fl s	180	.Ev BLOCKSIZE
181	option is specified, print the file size allocation in kilobytes,	181	to 1024, except that it also nullifies any
182	not blocks.	182	.Fl h
183	This option overrides the environment variable	183	options to its left.
184	.Ev BLOCKSIZE .
185	Note that
186	.Fl k
187	is mutually exclusive to
188	.Fl h ,
189	and later
190	.Fl k
191	will nullify earlier
192	.Fl h .
193	.It Fl l	184	.It Fl l
194	(The lowercase letter	185	(The lowercase letter
195	.Dq ell . )	186	.Dq ell . )
196	List in long format.	187	List files in the long format, as described in the
197	(See below.)	188	.Sx The Long Format
198	A total sum (in blocks, see the	189	subsection below.
199	.Fl s
200	option for the block size unit) for all the file
201	sizes is output on a line before the long listing.
202	.It Fl m	190	.It Fl m
203	Stream output format; list files across the page, separated by commas.	191	Stream output format; list files across the page, separated by commas.
204	.It Fl n	192	.It Fl n
Lines 223-235 Link Here
223	Reverse the order of the sort to get reverse	211	Reverse the order of the sort to get reverse
224	lexicographical order or the oldest entries first.	212	lexicographical order or the oldest entries first.
225	.It Fl s	213	.It Fl s
226	Display the number of file system blocks actually used by each file, in units	214	Display the number of file system blocks used by each file.
227	of 512 bytes, where partial units are rounded up to the next integer value.	215	Block sizes and directory totals are handled as decribed in
228	A total sum for all the file	216	.Sx The Long Format
229	sizes is output on a line before the listing.	217	subsection below, except (for unknown reasons) the directory totals
230	The environment variable	218	are only output with multi-column outputs.
231	.Ev BLOCKSIZE
232	overrides the unit size of 512 bytes.
233	.It Fl t	219	.It Fl t
234	Sort by time modified (most recently modified	220	Sort by time modified (most recently modified
235	first) before sorting the operands by lexicographical	221	first) before sorting the operands by lexicographical
Lines 315-324 Link Here
315	month, day-of-month file was last modified,	301	month, day-of-month file was last modified,
316	hour file last modified, minute file last	302	hour file last modified, minute file last
317	modified, and the pathname.	303	modified, and the pathname.
318	In addition, for each directory whose contents are displayed, the total
319	number of 512-byte blocks used by the files in the directory is displayed
320	on a line by itself immediately before the information for the files in the
321	directory.
322	.Pp	304	.Pp
323	If the modification time of the file is more than 6 months	305	If the modification time of the file is more than 6 months
324	in the past or future, then the year of the last modification	306	in the past or future, then the year of the last modification
Lines 337-342 Link Here
337	linked-to file is preceded by	319	linked-to file is preceded by
338	.Dq Li -> .	320	.Dq Li -> .
339	.Pp	321	.Pp
		322	If a file is a directory (and
		323	.Fl d
		324	is not used), the listing of the directory's contents is preceeded
		325	by a labeled total number of file system blocks used by the files
		326	listed as the directory's contents (which may or may not include
		327	.Pa \&.
		328	and
		329	.Pa ..
		330	and other files which start with a dot, depending on other options).
		331	.Pp
		332	The default block size is 512 bytes.
		333	It may be set with the
		334	.Fl k
		335	option or the
		336	.Ev BLOCKSIZE
		337	environment variable.
		338	Output numbers of blocks will have been rounded up so the number of bytes
		339	is at least as many as is used by the corresponding file system blocks
		340	which might have a different size.
		341	.Pp
340	The file mode printed under the	342	The file mode printed under the
341	.Fl l	343	.Fl l
342	option consists of the	344	option consists of the
Lines 460-471 Link Here
460	.Nm :	462	.Nm :
461	.Bl -tag -width ".Ev CLICOLOR_FORCE"	463	.Bl -tag -width ".Ev CLICOLOR_FORCE"
462	.It Ev BLOCKSIZE	464	.It Ev BLOCKSIZE
463	If the environment variable	465	If this is set, its value, rounded up to 512 or down to a
464	.Ev BLOCKSIZE	466	multiple of 512, will be used as the block size in bytes by the
465	is set, the block counts	467	.Fl l
466	(see	468	and
467	.Fl s )	469	.Fl s
468	will be displayed in units of that size block.	470	options.
		471	See
		472	.Sx The Long Format
		473	subsection for more information.
469	.It Ev CLICOLOR	474	.It Ev CLICOLOR
470	Use	475	Use
471	.Tn ANSI	476	.Tn ANSI
Lines 675-677 Link Here
675	.Sh BUGS	680	.Sh BUGS
676	To maintain backward compatibility, the relationships between the many	681	To maintain backward compatibility, the relationships between the many
677	options are quite complex.	682	options are quite complex.
		683	.Pp
		684	The exception mentioned in the
		685	.Fl s
		686	option description is probably a bug.