26 .\"
27 .\" The contents of this file are subject to the terms of the
28 .\" Common Development and Distribution License (the "License").
29 .\" You may not use this file except in compliance with the License.
30 .\"
31 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
32 .\" or http://www.opensolaris.org/os/licensing.
33 .\" See the License for the specific language governing permissions
34 .\" and limitations under the License.
35 .\"
36 .\" When distributing Covered Code, include this CDDL HEADER in each
37 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
38 .\" If applicable, add the following below this CDDL HEADER, with the
39 .\" fields enclosed by brackets "[]" replaced with your own identifying
40 .\" information: Portions Copyright [yyyy] [name of copyright owner]
41 .\"
42 .\"
43 .\" Copyright 1989 AT&T
44 .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
45 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
46 .\" Copyright 2014 Nexenta Systems, Inc. All Rights Reserved.
47 .\"
48 .TH LS 1 "Nov 24, 2014"
49 .SH NAME
50 ls \- list contents of directory
51 .SH SYNOPSIS
52 .LP
53 .nf
54 \fB/usr/bin/ls\fR [\fB-aAbcCdeEfFghHiklLmnopqrRsStuUwvVx1@\fR]
55 [\fB-/ c\fR | \fBv\fR] [\fB-% atime | crtime | ctime | mtime | all\fR]
56 [--block-size size] [--color[=\fIwhen\fR]] [--file-type]
57 [--si] [--time-style \fIstyle\fR] [\fIfile\fR]...
58 .fi
59
60 .LP
61 .nf
62 \fB/usr/xpg4/bin/ls\fR [\fB-aAbcCdeEfFghHiklLmnopqrRsStuUwvVx1@\fR]
63 [\fB-/ c\fR | \fBv\fR] [\fB-% atime | crtime | ctime | mtime | all\fR]
64 [--block-size size] [--color[=\fIwhen\fR]] [--file-type]
65 [--si] [--time-style \fIstyle\fR] [\fIfile\fR]...
66 .fi
67
68 .LP
1171 .na
1172 \fB\fB-m\fR\fR
1173 .ad
1174 .sp .6
1175 .RS 4n
1176 Streams output format. Files are listed across the page, separated by commas.
1177 .RE
1178
1179 .sp
1180 .ne 2
1181 .na
1182 \fB\fB-n\fR\fR
1183 .ad
1184 .br
1185 .na
1186 \fB\fB--numeric-uid-gid\fR\fR
1187 .ad
1188 .sp .6
1189 .RS 4n
1190 The same as \fB-l\fR, except that the owner's \fBUID\fR and group's \fBGID\fR
1191 numbers are printed, rather than the associated character strings.
1192 .RE
1193
1194 .sp
1195 .ne 2
1196 .na
1197 \fB\fB-o\fR\fR
1198 .ad
1199 .br
1200 .na
1201 \fB\fB--no-group\fR\fR
1202 .ad
1203 .sp .6
1204 .RS 4n
1205 The same as \fB-l\fR, except that the group is not printed.
1206 .RE
1207
1208 .sp
1209 .ne 2
1210 .na
1211 \fB\fB-p\fR\fR
2800 _
2801 Interface Stability Committed
2802 _
2803 Standard See below.
2804 .TE
2805
2806 .sp
2807 .LP
2808 For all options except \fB-A\fR, \fB-b\fR, \fB-e\fR, \fB-E,\fR \fB-h\fR,
2809 \fB-S\fR, U \fB-v\fR, \fB-V\fR, \fB-@\fR, \fB-/\fR, \fB-%\fR, \fB--all\fR,
2810 \fB--almost-all\fR, \fB--block-size\fR, \fB--classify\fR, \fB--color\fR,
2811 \fB--colour\fR, \fB--dereference\fR, \fB--dereference-command-line\fR,
2812 \fB--escape\fR, \fB--file-type\fR, \fB--full-time\fR, \fB--human-readable\fR,
2813 \fB--ignore-backups\fR, \fB--inode\fR, \fB--no-group\fR,
2814 \fB--numeric-uid-gid\fR, \fB--reverse\fR, \fB--recursive\fR, \fB--si\fR,
2815 \fB--size\fR, and \fB--time-style\fR, see \fBstandards\fR(5).
2816 .SH SEE ALSO
2817 .LP
2818 \fBchmod\fR(1), \fBcp\fR(1), \fBsetfacl\fR(1), \fBfgetattr\fR(3C),
2819 \fBstrftime\fR(3C), \fBterminfo\fR(4), \fBacl\fR(5), \fBattributes\fR(5),
2820 \fBenviron\fR(5), \fBfsattr\fR(5), \fBlargefile\fR(5), \fBstandards\fR(5)
2821 .SH NOTES
2822 .LP
2823 Unprintable characters in file names can confuse the columnar output options.
2824 .sp
2825 .LP
2826 The total block count is incorrect if there are hard links among the files.
2827 .sp
2828 .LP
2829 The sort order of \fBls\fR output is affected by the locale and can be
2830 overridden by the \fBLC_COLLATE\fR environment variable. For example, if
2831 \fBLC_COLLATE\fR equals \fBC\fR, dot files appear first, followed by names
2832 beginning with upper-case letters, then followed by names beginning with
2833 lower-case letters. But if \fBLC_COLLATE\fR equals \fBen_US.ISO8859-1\fR, then
2834 leading dots as well as case are ignored in determining the sort order.
|
26 .\"
27 .\" The contents of this file are subject to the terms of the
28 .\" Common Development and Distribution License (the "License").
29 .\" You may not use this file except in compliance with the License.
30 .\"
31 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
32 .\" or http://www.opensolaris.org/os/licensing.
33 .\" See the License for the specific language governing permissions
34 .\" and limitations under the License.
35 .\"
36 .\" When distributing Covered Code, include this CDDL HEADER in each
37 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
38 .\" If applicable, add the following below this CDDL HEADER, with the
39 .\" fields enclosed by brackets "[]" replaced with your own identifying
40 .\" information: Portions Copyright [yyyy] [name of copyright owner]
41 .\"
42 .\"
43 .\" Copyright 1989 AT&T
44 .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
45 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
46 .\" Copyright 2016 Nexenta Systems, Inc. All Rights Reserved.
47 .\"
48 .TH LS 1 "Jul 01, 2016"
49 .SH NAME
50 ls \- list contents of directory
51 .SH SYNOPSIS
52 .LP
53 .nf
54 \fB/usr/bin/ls\fR [\fB-aAbcCdeEfFghHiklLmnopqrRsStuUwvVx1@\fR]
55 [\fB-/ c\fR | \fBv\fR] [\fB-% atime | crtime | ctime | mtime | all\fR]
56 [--block-size size] [--color[=\fIwhen\fR]] [--file-type]
57 [--si] [--time-style \fIstyle\fR] [\fIfile\fR]...
58 .fi
59
60 .LP
61 .nf
62 \fB/usr/xpg4/bin/ls\fR [\fB-aAbcCdeEfFghHiklLmnopqrRsStuUwvVx1@\fR]
63 [\fB-/ c\fR | \fBv\fR] [\fB-% atime | crtime | ctime | mtime | all\fR]
64 [--block-size size] [--color[=\fIwhen\fR]] [--file-type]
65 [--si] [--time-style \fIstyle\fR] [\fIfile\fR]...
66 .fi
67
68 .LP
1171 .na
1172 \fB\fB-m\fR\fR
1173 .ad
1174 .sp .6
1175 .RS 4n
1176 Streams output format. Files are listed across the page, separated by commas.
1177 .RE
1178
1179 .sp
1180 .ne 2
1181 .na
1182 \fB\fB-n\fR\fR
1183 .ad
1184 .br
1185 .na
1186 \fB\fB--numeric-uid-gid\fR\fR
1187 .ad
1188 .sp .6
1189 .RS 4n
1190 The same as \fB-l\fR, except that the owner's \fBUID\fR and group's \fBGID\fR
1191 numbers are printed, rather than the associated character strings. Files for
1192 which owner and/or group is a Windows Security Identifier (\fBSID\fR), \fB-n\fR
1193 suppresses any lookups for the Windows Name string and prints only the raw SID.
1194 Moreover, a second instance of this flag (\fB-nn\fR) can be used to further
1195 suppress \fBidmapd\fR(1M) lookups of the file's owner and/or group SID, thus
1196 forcing \fBls\fR into printing the raw ephemeral numeric identifiers.
1197 .RE
1198
1199 .sp
1200 .ne 2
1201 .na
1202 \fB\fB-o\fR\fR
1203 .ad
1204 .br
1205 .na
1206 \fB\fB--no-group\fR\fR
1207 .ad
1208 .sp .6
1209 .RS 4n
1210 The same as \fB-l\fR, except that the group is not printed.
1211 .RE
1212
1213 .sp
1214 .ne 2
1215 .na
1216 \fB\fB-p\fR\fR
2805 _
2806 Interface Stability Committed
2807 _
2808 Standard See below.
2809 .TE
2810
2811 .sp
2812 .LP
2813 For all options except \fB-A\fR, \fB-b\fR, \fB-e\fR, \fB-E,\fR \fB-h\fR,
2814 \fB-S\fR, U \fB-v\fR, \fB-V\fR, \fB-@\fR, \fB-/\fR, \fB-%\fR, \fB--all\fR,
2815 \fB--almost-all\fR, \fB--block-size\fR, \fB--classify\fR, \fB--color\fR,
2816 \fB--colour\fR, \fB--dereference\fR, \fB--dereference-command-line\fR,
2817 \fB--escape\fR, \fB--file-type\fR, \fB--full-time\fR, \fB--human-readable\fR,
2818 \fB--ignore-backups\fR, \fB--inode\fR, \fB--no-group\fR,
2819 \fB--numeric-uid-gid\fR, \fB--reverse\fR, \fB--recursive\fR, \fB--si\fR,
2820 \fB--size\fR, and \fB--time-style\fR, see \fBstandards\fR(5).
2821 .SH SEE ALSO
2822 .LP
2823 \fBchmod\fR(1), \fBcp\fR(1), \fBsetfacl\fR(1), \fBfgetattr\fR(3C),
2824 \fBstrftime\fR(3C), \fBterminfo\fR(4), \fBacl\fR(5), \fBattributes\fR(5),
2825 \fBenviron\fR(5), \fBfsattr\fR(5), \fBlargefile\fR(5), \fBstandards\fR(5),
2826 \fBidmapd\fR(1M)
2827 .SH NOTES
2828 .LP
2829 Unprintable characters in file names can confuse the columnar output options.
2830 .sp
2831 .LP
2832 The total block count is incorrect if there are hard links among the files.
2833 .sp
2834 .LP
2835 The sort order of \fBls\fR output is affected by the locale and can be
2836 overridden by the \fBLC_COLLATE\fR environment variable. For example, if
2837 \fBLC_COLLATE\fR equals \fBC\fR, dot files appear first, followed by names
2838 beginning with upper-case letters, then followed by names beginning with
2839 lower-case letters. But if \fBLC_COLLATE\fR equals \fBen_US.ISO8859-1\fR, then
2840 leading dots as well as case are ignored in determining the sort order.
2841 .sp
2842 .LP
2843 For additional information regarding Windows Security Identifiers, consult
2844 Microsoft support document, \fIWell-known security identifiers in Windows
2845 operating systems\fR, which can be found at Microsoft's support site: https://support.microsoft.com/en-us/kb/243330/.
|