Print this page
NEX-1767 ls is unable to display SIDs
Reviewed by: Gordon Ross <gordon.ross@nexenta.com>
Reviewed by: Evan Layton <evan.layton@nexenta.com>
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1/ls.1
+++ new/usr/src/man/man1/ls.1
1 1 .\"
2 2 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for
3 3 .\" permission to reproduce portions of its copyrighted documentation.
4 4 .\" Original documentation from The Open Group can be obtained online at
5 5 .\" http://www.opengroup.org/bookstore/.
6 6 .\"
7 7 .\" The Institute of Electrical and Electronics Engineers and The Open
8 8 .\" Group, have given us permission to reprint portions of their
9 9 .\" documentation.
10 10 .\"
11 11 .\" In the following statement, the phrase ``this text'' refers to portions
12 12 .\" of the system documentation.
13 13 .\"
14 14 .\" Portions of this text are reprinted and reproduced in electronic form
15 15 .\" in the SunOS Reference Manual, from IEEE Std 1003.1, 2004 Edition,
16 16 .\" Standard for Information Technology -- Portable Operating System
17 17 .\" Interface (POSIX), The Open Group Base Specifications Issue 6,
18 18 .\" Copyright (C) 2001-2004 by the Institute of Electrical and Electronics
19 19 .\" Engineers, Inc and The Open Group. In the event of any discrepancy
20 20 .\" between these versions and the original IEEE and The Open Group
21 21 .\" Standard, the original IEEE and The Open Group Standard is the referee
22 22 .\" document. The original Standard can be obtained online at
23 23 .\" http://www.opengroup.org/unix/online.html.
24 24 .\"
25 25 .\" This notice shall appear on any product containing this material.
26 26 .\"
27 27 .\" The contents of this file are subject to the terms of the
28 28 .\" Common Development and Distribution License (the "License").
29 29 .\" You may not use this file except in compliance with the License.
30 30 .\"
31 31 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
32 32 .\" or http://www.opensolaris.org/os/licensing.
33 33 .\" See the License for the specific language governing permissions
34 34 .\" and limitations under the License.
35 35 .\"
|
↓ open down ↓ |
35 lines elided |
↑ open up ↑ |
36 36 .\" When distributing Covered Code, include this CDDL HEADER in each
37 37 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
38 38 .\" If applicable, add the following below this CDDL HEADER, with the
39 39 .\" fields enclosed by brackets "[]" replaced with your own identifying
40 40 .\" information: Portions Copyright [yyyy] [name of copyright owner]
41 41 .\"
42 42 .\"
43 43 .\" Copyright 1989 AT&T
44 44 .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
45 45 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
46 -.\" Copyright 2014 Nexenta Systems, Inc. All Rights Reserved.
46 +.\" Copyright 2016 Nexenta Systems, Inc. All Rights Reserved.
47 47 .\"
48 -.TH LS 1 "Nov 24, 2014"
48 +.TH LS 1 "Jul 01, 2016"
49 49 .SH NAME
50 50 ls \- list contents of directory
51 51 .SH SYNOPSIS
52 52 .LP
53 53 .nf
54 54 \fB/usr/bin/ls\fR [\fB-aAbcCdeEfFghHiklLmnopqrRsStuUwvVx1@\fR]
55 55 [\fB-/ c\fR | \fBv\fR] [\fB-% atime | crtime | ctime | mtime | all\fR]
56 56 [--block-size size] [--color[=\fIwhen\fR]] [--file-type]
57 57 [--si] [--time-style \fIstyle\fR] [\fIfile\fR]...
58 58 .fi
59 59
60 60 .LP
61 61 .nf
62 62 \fB/usr/xpg4/bin/ls\fR [\fB-aAbcCdeEfFghHiklLmnopqrRsStuUwvVx1@\fR]
63 63 [\fB-/ c\fR | \fBv\fR] [\fB-% atime | crtime | ctime | mtime | all\fR]
64 64 [--block-size size] [--color[=\fIwhen\fR]] [--file-type]
65 65 [--si] [--time-style \fIstyle\fR] [\fIfile\fR]...
66 66 .fi
67 67
68 68 .LP
69 69 .nf
70 70 \fB/usr/xpg6/bin/ls\fR [\fB-aAbcCdeEfFghHiklLmnopqrRsStuUwvVx1@\fR]
71 71 [\fB-/ c\fR | \fBv\fR] [\fB-% atime | crtime | ctime | mtime | all\fR]
72 72 [--block-size size] [--color[=\fIwhen\fR]] [--file-type]
73 73 [--si] [--time-style \fIstyle\fR] [\fIfile\fR]...
74 74 .fi
75 75
76 76 .SH DESCRIPTION
77 77 .LP
78 78 For each \fIfile\fR that is a directory, \fBls\fR lists the contents of the
79 79 directory. For each \fIfile\fR that is an ordinary file, \fBls\fR repeats its
80 80 name and any other information requested. The output is sorted alphabetically
81 81 by default. When no argument is given, the current directory (\fB\&.\fR) is
82 82 listed. When several arguments are given, the arguments are first sorted
83 83 appropriately, but file arguments appear before directories and their contents.
84 84 .sp
85 85 .LP
86 86 There are three major listing formats. The default format for output directed
87 87 to a terminal is multi\(micolumn with entries sorted down the columns. The
88 88 \fB-1\fR option allows single column output and \fB-m\fR enables stream output
89 89 format. In order to determine output formats for the \fB-C\fR, \fB-x\fR, and
90 90 \fB-m\fR options, \fBls\fR uses an environment variable, \fBCOLUMNS\fR, to
91 91 determine the number of character positions available on one output line. If
92 92 this variable is not set, the \fBterminfo\fR(4) database is used to determine
93 93 the number of columns, based on the environment variable, \fBTERM\fR. If this
94 94 information cannot be obtained, 80 columns are assumed. If the \fB-w\fR option
95 95 is used, the argument overrides any other column width.
96 96 .sp
97 97 .LP
98 98 The mode printed when the \fB-e\fR, \fB-E\fR, \fB-g\fR, \fB-l\fR, \fB-n\fR,
99 99 \fB-o\fR, \fB-v\fR, \fB-V\fR, or \fB-@\fR option is in effect consists of
100 100 eleven characters. The first character can be one of the following:
101 101 .sp
102 102 .ne 2
103 103 .na
104 104 \fB\fBd\fR\fR
105 105 .ad
106 106 .sp .6
107 107 .RS 4n
108 108 The entry is a directory.
109 109 .RE
110 110
111 111 .sp
112 112 .ne 2
113 113 .na
114 114 \fB\fBD\fR\fR
115 115 .ad
116 116 .sp .6
117 117 .RS 4n
118 118 The entry is a door.
119 119 .RE
120 120
121 121 .sp
122 122 .ne 2
123 123 .na
124 124 \fB\fBl\fR\fR
125 125 .ad
126 126 .sp .6
127 127 .RS 4n
128 128 The entry is a symbolic link.
129 129 .RE
130 130
131 131 .sp
132 132 .ne 2
133 133 .na
134 134 \fB\fBb\fR\fR
135 135 .ad
136 136 .sp .6
137 137 .RS 4n
138 138 The entry is a block special file.
139 139 .RE
140 140
141 141 .sp
142 142 .ne 2
143 143 .na
144 144 \fB\fBc\fR\fR
145 145 .ad
146 146 .sp .6
147 147 .RS 4n
148 148 The entry is a character special file.
149 149 .RE
150 150
151 151 .sp
152 152 .ne 2
153 153 .na
154 154 \fB\fBp\fR\fR
155 155 .ad
156 156 .sp .6
157 157 .RS 4n
158 158 The entry is a \fBFIFO\fR (or "named pipe") special file.
159 159 .RE
160 160
161 161 .sp
162 162 .ne 2
163 163 .na
164 164 \fB\fBP\fR\fR
165 165 .ad
166 166 .sp .6
167 167 .RS 4n
168 168 The entry is an event port.
169 169 .RE
170 170
171 171 .sp
172 172 .ne 2
173 173 .na
174 174 \fB\fBs\fR\fR
175 175 .ad
176 176 .sp .6
177 177 .RS 4n
178 178 The entry is an \fBAF_UNIX\fR address family socket.
179 179 .RE
180 180
181 181 .sp
182 182 .ne 2
183 183 .na
184 184 \fB\fB\(mi\fR\fR
185 185 .ad
186 186 .sp .6
187 187 .RS 4n
188 188 The entry is an ordinary file.
189 189 .RE
190 190
191 191 .sp
192 192 .LP
193 193 The next 9 characters are interpreted as three sets of three bits each. The
194 194 first set refers to the owner's permissions; the next to permissions of others
195 195 in the user-group of the file; and the last to all others. Within each set, the
196 196 three characters indicate permission to read, to write, and to execute the file
197 197 as a program, respectively. For a directory, \fBexecute\fR permission is
198 198 interpreted to mean permission to search the directory for a specified file.
199 199 The character after permissions is an ACL or extended attributes indicator.
200 200 This character is an \fB@\fR if extended attributes are associated with the
201 201 file and the \fB-@\fR option is in effect. Otherwise, this character is a plus
202 202 sign (\fB+\fR) character if a non-trivial ACL is associated with the file or a
203 203 space character if not.
204 204 .sp
205 205 .LP
206 206 If \fB-/\fR and/or \fB-%\fR are in effect, then the extended system attributes
207 207 are printed when filesystem supports extended system attributes. The display
208 208 looks as follows:
209 209 .sp
210 210 .in +2
211 211 .nf
212 212 $ls -/ c file
213 213 -rw-r--r-- 1 root root 0 May 10 14:17 file
214 214 {AHRSadim-u--}
215 215
216 216 $ls -/ v file
217 217 -rw-r--r-- 1 root root 0 May 10 14:17 file
218 218 {archive,hidden,readonly,system,\e
219 219 appendonly,nodump,immutable,av_modified,\e
220 220 noav_quarantined,nounlink,nooffline,\e
221 221 nosparse}
222 222
223 223 $ls -l -% all file
224 224 -rw-r--r-- 1 root root 0 May 10 14:17 file
225 225 timestamp: atime Jun 25 12:56:44 2007
226 226 timestamp: ctime May 10 14:20:23 2007
227 227 timestamp: mtime May 10 14:17:56 2007
228 228 timestamp: crtime May 10 14:17:56 2007
229 229 .fi
230 230 .in -2
231 231 .sp
232 232
233 233 .sp
234 234 .LP
235 235 See the option descriptions of the \fB-/\fR and \fB-%\fR option for details.
236 236 .sp
237 237 .LP
238 238 \fBls\fR \fB-l\fR (the long list) prints its output as follows for the POSIX
239 239 locale:
240 240 .sp
241 241 .in +2
242 242 .nf
243 243 -rwxrwxrwx+ 1 smith dev 10876 May 16 9:42 part2
244 244 .fi
245 245 .in -2
246 246 .sp
247 247
248 248 .sp
249 249 .LP
250 250 Reading from right to left, you see that the current directory holds one file,
251 251 named \fBpart2\fR. Next, the last time that file's contents were modified was
252 252 \fB9:42 A.M.\fR on \fBMay 16\fR. The file contains 10,876 characters, or bytes.
253 253 The owner of the file, or the user, belongs to the group \fBdev\fR (perhaps
254 254 indicating \fBdevelopment\fR), and his or her login name is \fBsmith\fR. The
255 255 number, in this case \fB1\fR, indicates the number of links to file \fBpart2\fR
256 256 (see \fBcp\fR(1)). The plus sign indicates that there is an \fBACL\fR
257 257 associated with the file. If the \fB-@\fR option has been specified, the
258 258 presence of extended attributes supersede the presence of an \fBACL\fR and the
259 259 plus sign is replaced with an 'at' sign (\fB@\fR). Finally, the dash and
260 260 letters tell you that user, group, and others have permissions to read, write,
261 261 and execute \fBpart2\fR.
262 262 .sp
263 263 .LP
264 264 The execute (\fBx\fR) symbol occupies the third position of the three-character
265 265 sequence. A \fB\(mi\fR in the third position would have indicated a denial of
266 266 execution permissions.
267 267 .sp
268 268 .LP
269 269 The permissions are indicated as follows:
270 270 .sp
271 271 .ne 2
272 272 .na
273 273 \fB\fBr\fR\fR
274 274 .ad
275 275 .sp .6
276 276 .RS 4n
277 277 The file is readable.
278 278 .RE
279 279
280 280 .sp
281 281 .ne 2
282 282 .na
283 283 \fB\fBw\fR\fR
284 284 .ad
285 285 .sp .6
286 286 .RS 4n
287 287 The file is writable.
288 288 .RE
289 289
290 290 .sp
291 291 .ne 2
292 292 .na
293 293 \fB\fBx\fR\fR
294 294 .ad
295 295 .sp .6
296 296 .RS 4n
297 297 The file is executable.
298 298 .RE
299 299
300 300 .sp
301 301 .ne 2
302 302 .na
303 303 \fB\fB\(mi\fR\fR
304 304 .ad
305 305 .sp .6
306 306 .RS 4n
307 307 The indicated permission is \fInot\fR granted.
308 308 .RE
309 309
310 310 .sp
311 311 .ne 2
312 312 .na
313 313 \fB\fBs\fR\fR
314 314 .ad
315 315 .sp .6
316 316 .RS 4n
317 317 The \fBs\fRet-user-ID or \fBs\fRet-group-ID bit is on, and the corresponding
318 318 user or group execution bit is also on.
319 319 .RE
320 320
321 321 .sp
322 322 .ne 2
323 323 .na
324 324 \fB\fBS\fR\fR
325 325 .ad
326 326 .sp .6
327 327 .RS 4n
328 328 Undefined bit-state (the set-user-ID or set-group-id bit is on and the user or
329 329 group execution bit is off). For group permissions, this applies only to
330 330 non-regular files.
331 331 .RE
332 332
333 333 .sp
334 334 .ne 2
335 335 .na
336 336 \fB\fBt\fR\fR
337 337 .ad
338 338 .sp .6
339 339 .RS 4n
340 340 The 1000 (octal) bit, or sticky bit, is on (see \fBchmod\fR(1)), and execution
341 341 is on.
342 342 .RE
343 343
344 344 .sp
345 345 .ne 2
346 346 .na
347 347 \fB\fBT\fR\fR
348 348 .ad
349 349 .sp .6
350 350 .RS 4n
351 351 The 1000 bit is turned on, and execution is off (undefined bit-state).
352 352 .RE
353 353
354 354 .SS "/usr/bin/ls"
355 355 .ne 2
356 356 .na
357 357 \fB\fBl\fR\fR
358 358 .ad
359 359 .sp .6
360 360 .RS 4n
361 361 Mandatory locking occurs during access (on a regular file, the set-group-ID bit
362 362 is on and the group execution bit is off).
363 363 .RE
364 364
365 365 .SS "/usr/xpg4/bin/ls and /usr/xpg6/bin/ls"
366 366 .ne 2
367 367 .na
368 368 \fB\fBL\fR\fR
369 369 .ad
370 370 .sp .6
371 371 .RS 4n
372 372 Mandatory locking occurs during access (on a regular file, the set-group-ID bit
373 373 is on and the group execution bit is off).
374 374 .RE
375 375
376 376 .sp
377 377 .LP
378 378 For user and group permissions, the third position is sometimes occupied by a
379 379 character other than \fBx\fR or \fB-\fR. \fBs\fR or \fBS\fR also can occupy
380 380 this position, referring to the state of the set-ID bit, whether it be the
381 381 user's or the group's. The ability to assume the same ID as the user during
382 382 execution is, for example, used during login when you begin as root but need to
383 383 assume the identity of the user you login as.
384 384 .sp
385 385 .LP
386 386 In the case of the sequence of group permissions, \fBl\fR can occupy the third
387 387 position. \fBl\fR refers to mandatory file and record locking. This permission
388 388 describes a file's ability to allow other files to lock its reading or writing
389 389 permissions during access.
390 390 .sp
391 391 .LP
392 392 For others permissions, the third position can be occupied by \fBt\fR or
393 393 \fBT\fR. These refer to the state of the sticky bit and execution permissions.
394 394 .SS "Color Output"
395 395 .LP
396 396 If color output is enabled, the environment variable LS_COLORS is checked. If
397 397 it exists, it's contents are used to control the colors used to display
398 398 filenames. If it is not set, a default list of colors is used. The format of
399 399 LS_COLORS is a colon separated list of attribute specifications. Each attribute
400 400 specification is of the format
401 401 .sp
402 402 .in +2
403 403 .nf
404 404 \fIfilespec\fR=\fIattr\fR[;\fIattr\fR..]
405 405 .fi
406 406 .in -2
407 407 .sp
408 408
409 409 .sp
410 410 .LP
411 411 \fIfilespec\fR is either of the form \fI*.SUFFIX\fR, for example, \fB*.jar\fR
412 412 or \fB*.Z\fR, or one of the following file types:
413 413 .sp
414 414 .ne 2
415 415 .na
416 416 \fB\fBno\fR\fR
417 417 .ad
418 418 .sp .6
419 419 .RS 4n
420 420 Normal file
421 421 .RE
422 422
423 423 .sp
424 424 .ne 2
425 425 .na
426 426 \fB\fBfi\fR\fR
427 427 .ad
428 428 .sp .6
429 429 .RS 4n
430 430 Regular file
431 431 .RE
432 432
433 433 .sp
434 434 .ne 2
435 435 .na
436 436 \fB\fBdi\fR\fR
437 437 .ad
438 438 .sp .6
439 439 .RS 4n
440 440 Directory
441 441 .RE
442 442
443 443 .sp
444 444 .ne 2
445 445 .na
446 446 \fB\fBln\fR\fR
447 447 .ad
448 448 .sp .6
449 449 .RS 4n
450 450 Symbolic link
451 451 .RE
452 452
453 453 .sp
454 454 .ne 2
455 455 .na
456 456 \fB\fBpi\fR\fR
457 457 .ad
458 458 .sp .6
459 459 .RS 4n
460 460 FIFO or named pipe
461 461 .RE
462 462
463 463 .sp
464 464 .ne 2
465 465 .na
466 466 \fB\fBso\fR\fR
467 467 .ad
468 468 .sp .6
469 469 .RS 4n
470 470 Socket
471 471 .RE
472 472
473 473 .sp
474 474 .ne 2
475 475 .na
476 476 \fB\fBdo\fR\fR
477 477 .ad
478 478 .sp .6
479 479 .RS 4n
480 480 Door file
481 481 .RE
482 482
483 483 .sp
484 484 .ne 2
485 485 .na
486 486 \fB\fBbd\fR\fR
487 487 .ad
488 488 .sp .6
489 489 .RS 4n
490 490 Block device
491 491 .RE
492 492
493 493 .sp
494 494 .ne 2
495 495 .na
496 496 \fB\fBcd\fR\fR
497 497 .ad
498 498 .sp .6
499 499 .RS 4n
500 500 Character device
501 501 .RE
502 502
503 503 .sp
504 504 .ne 2
505 505 .na
506 506 \fB\fBex\fR\fR
507 507 .ad
508 508 .sp .6
509 509 .RS 4n
510 510 Execute bit (either \fBuser\fR, \fBgroup\fR, or \fBother\fR) set
511 511 .RE
512 512
513 513 .sp
514 514 .ne 2
515 515 .na
516 516 \fB\fBpo\fR\fR
517 517 .ad
518 518 .sp .6
519 519 .RS 4n
520 520 Event port
521 521 .RE
522 522
523 523 .sp
524 524 .ne 2
525 525 .na
526 526 \fB\fBst\fR\fR
527 527 .ad
528 528 .sp .6
529 529 .RS 4n
530 530 Sticky bit set
531 531 .RE
532 532
533 533 .sp
534 534 .ne 2
535 535 .na
536 536 \fB\fBor\fR\fR
537 537 .ad
538 538 .sp .6
539 539 .RS 4n
540 540 Orphaned symlink
541 541 .RE
542 542
543 543 .sp
544 544 .ne 2
545 545 .na
546 546 \fB\fBsg\fR\fR
547 547 .ad
548 548 .sp .6
549 549 .RS 4n
550 550 \fBsetgid\fR binary
551 551 .RE
552 552
553 553 .sp
554 554 .ne 2
555 555 .na
556 556 \fB\fBsu\fR\fR
557 557 .ad
558 558 .sp .6
559 559 .RS 4n
560 560 \fBsetuid\fR binary
561 561 .RE
562 562
563 563 .sp
564 564 .ne 2
565 565 .na
566 566 \fB\fBow\fR\fR
567 567 .ad
568 568 .sp .6
569 569 .RS 4n
570 570 \fBworld\fR writable
571 571 .RE
572 572
573 573 .sp
574 574 .ne 2
575 575 .na
576 576 \fB\fBtw\fR\fR
577 577 .ad
578 578 .sp .6
579 579 .RS 4n
580 580 Sticky bit and \fBworld\fR writable
581 581 .RE
582 582
583 583 .sp
584 584 .LP
585 585 \fIattr\fR is a semicolon delimited list of color and display attributes which
586 586 are combined to determine the final output color. Any combination of \fIattr\fR
587 587 values can be specified. Possible \fIattr\fR values are:
588 588 .sp
589 589 .ne 2
590 590 .na
591 591 \fB\fB00\fR\fR
592 592 .ad
593 593 .sp .6
594 594 .RS 4n
595 595 All attributes off (default terminal color)
596 596 .RE
597 597
598 598 .sp
599 599 .ne 2
600 600 .na
601 601 \fB\fB01\fR\fR
602 602 .ad
603 603 .sp .6
604 604 .RS 4n
605 605 Display text in bold
606 606 .RE
607 607
608 608 .sp
609 609 .ne 2
610 610 .na
611 611 \fB\fB04\fR\fR
612 612 .ad
613 613 .sp .6
614 614 .RS 4n
615 615 Display text with an underscore
616 616 .RE
617 617
618 618 .sp
619 619 .ne 2
620 620 .na
621 621 \fB\fB05\fR\fR
622 622 .ad
623 623 .sp .6
624 624 .RS 4n
625 625 Display text in bold
626 626 .RE
627 627
628 628 .sp
629 629 .ne 2
630 630 .na
631 631 \fB\fB07\fR\fR
632 632 .ad
633 633 .sp .6
634 634 .RS 4n
635 635 Display text with foreground and background colors reversed
636 636 .RE
637 637
638 638 .sp
639 639 .ne 2
640 640 .na
641 641 \fB\fB08\fR\fR
642 642 .ad
643 643 .sp .6
644 644 .RS 4n
645 645 Display using concealed text.
646 646 .RE
647 647
648 648 .sp
649 649 .LP
650 650 One of the following values can be chosen. If multiple values are specified,
651 651 the last specified value is used.
652 652 .sp
653 653 .ne 2
654 654 .na
655 655 \fB\fB30\fR\fR
656 656 .ad
657 657 .sp .6
658 658 .RS 4n
659 659 Set foreground to \fBblack\fR.
660 660 .RE
661 661
662 662 .sp
663 663 .ne 2
664 664 .na
665 665 \fB\fB31\fR\fR
666 666 .ad
667 667 .sp .6
668 668 .RS 4n
669 669 Set foreground to \fBred\fR.
670 670 .RE
671 671
672 672 .sp
673 673 .ne 2
674 674 .na
675 675 \fB\fB32\fR\fR
676 676 .ad
677 677 .sp .6
678 678 .RS 4n
679 679 Set foreground to \fBgreen\fR.
680 680 .RE
681 681
682 682 .sp
683 683 .ne 2
684 684 .na
685 685 \fB\fB33\fR\fR
686 686 .ad
687 687 .sp .6
688 688 .RS 4n
689 689 Set foreground to \fByellow\fR.
690 690 .RE
691 691
692 692 .sp
693 693 .ne 2
694 694 .na
695 695 \fB\fB34\fR\fR
696 696 .ad
697 697 .sp .6
698 698 .RS 4n
699 699 Set foreground to \fBblue\fR.
700 700 .RE
701 701
702 702 .sp
703 703 .ne 2
704 704 .na
705 705 \fB\fB35\fR\fR
706 706 .ad
707 707 .sp .6
708 708 .RS 4n
709 709 Set foreground to \fBmagenta\fR (\fBpurple\fR).
710 710 .sp
711 711 Set foreground to \fB\fR.
712 712 .RE
713 713
714 714 .sp
715 715 .ne 2
716 716 .na
717 717 \fB\fB36\fR\fR
718 718 .ad
719 719 .sp .6
720 720 .RS 4n
721 721 Set foreground to \fBcyan\fR.
722 722 .RE
723 723
724 724 .sp
725 725 .ne 2
726 726 .na
727 727 \fB\fB37\fR\fR
728 728 .ad
729 729 .sp .6
730 730 .RS 4n
731 731 Set foreground to \fBwhite\fR.
732 732 .RE
733 733
734 734 .sp
735 735 .ne 2
736 736 .na
737 737 \fB\fB39\fR\fR
738 738 .ad
739 739 .sp .6
740 740 .RS 4n
741 741 Set foreground to default terminal color.
742 742 .RE
743 743
744 744 .sp
745 745 .LP
746 746 One of the following can be specified. If multiple values are specified, the
747 747 last value specified is used.
748 748 .sp
749 749 .ne 2
750 750 .na
751 751 \fB\fB40\fR\fR
752 752 .ad
753 753 .sp .6
754 754 .RS 4n
755 755 Set foreground to \fBblack\fR.
756 756 .RE
757 757
758 758 .sp
759 759 .ne 2
760 760 .na
761 761 \fB\fB41\fR\fR
762 762 .ad
763 763 .sp .6
764 764 .RS 4n
765 765 Set foreground to \fBred\fR.
766 766 .RE
767 767
768 768 .sp
769 769 .ne 2
770 770 .na
771 771 \fB\fB42\fR\fR
772 772 .ad
773 773 .sp .6
774 774 .RS 4n
775 775 Set foreground to \fBgreen\fR.
776 776 .RE
777 777
778 778 .sp
779 779 .ne 2
780 780 .na
781 781 \fB\fB43\fR\fR
782 782 .ad
783 783 .sp .6
784 784 .RS 4n
785 785 Set foreground to \fByellow\fR.
786 786 .RE
787 787
788 788 .sp
789 789 .ne 2
790 790 .na
791 791 \fB\fB44\fR\fR
792 792 .ad
793 793 .sp .6
794 794 .RS 4n
795 795 Set foreground to \fBblue\fR.
796 796 .RE
797 797
798 798 .sp
799 799 .ne 2
800 800 .na
801 801 \fB\fB45\fR\fR
802 802 .ad
803 803 .sp .6
804 804 .RS 4n
805 805 Set foreground to \fBmagenta\fR (\fBpurple\fR).
806 806 .RE
807 807
808 808 .sp
809 809 .ne 2
810 810 .na
811 811 \fB\fB46\fR\fR
812 812 .ad
813 813 .sp .6
814 814 .RS 4n
815 815 Set foreground to \fBcyan\fR.
816 816 .RE
817 817
818 818 .sp
819 819 .ne 2
820 820 .na
821 821 \fB\fB47\fR\fR
822 822 .ad
823 823 .sp .6
824 824 .RS 4n
825 825 Set foreground to \fBwhite\fR.
826 826 .RE
827 827
828 828 .sp
829 829 .ne 2
830 830 .na
831 831 \fB\fB49\fR\fR
832 832 .ad
833 833 .sp .6
834 834 .RS 4n
835 835 Set foreground to default terminal color.
836 836 .RE
837 837
838 838 .sp
839 839 .LP
840 840 On some terminals, setting the bold attribute causes the foreground colors to
841 841 be high-intensity, that is, brighter. In such cases the low-intensity yellow is
842 842 often displayed as a brown or orange color.
843 843 .sp
844 844 .LP
845 845 At least one attribute must be listed for a file specification.
846 846 .sp
847 847 .LP
848 848 The appropriate color codes are chosen by selecting the most specific match,
849 849 starting with the file suffixes and proceeding with the file types until a
850 850 match is found. The \fBno\fR (normal file) type matches any file.
851 851 .SH OPTIONS
852 852 .LP
853 853 The following options are supported:
854 854 .SS "/usr/bin/ls, /usr/xpg4/bin/ls, and /usr/xpg6/bin/ls"
855 855 .LP
856 856 The following options are supported for all three versions:
857 857 .sp
858 858 .ne 2
859 859 .na
860 860 \fB\fB-a\fR\fR
861 861 .ad
862 862 .br
863 863 .na
864 864 \fB\fB--all\fR\fR
865 865 .ad
866 866 .sp .6
867 867 .RS 4n
868 868 Lists all entries, including those that begin with a dot (\fB\&.\fR), which are
869 869 normally not listed.
870 870 .RE
871 871
872 872 .sp
873 873 .ne 2
874 874 .na
875 875 \fB\fB-A\fR\fR
876 876 .ad
877 877 .br
878 878 .na
879 879 \fB\fB--almost-all\fR\fR
880 880 .ad
881 881 .sp .6
882 882 .RS 4n
883 883 Lists all entries, including those that begin with a dot (\fB\&.\fR), with the
884 884 exception of the working directory (\fB\&.\fR) and the parent directory
885 885 (\fB\&..\fR).
886 886 .RE
887 887
888 888 .sp
889 889 .ne 2
890 890 .na
891 891 \fB\fB-b\fR\fR
892 892 .ad
893 893 .br
894 894 .na
895 895 \fB\fB--escape\fR\fR
896 896 .ad
897 897 .sp .6
898 898 .RS 4n
899 899 Forces printing of non-printable characters to be in the octal
900 900 \fB\e\fR\fIddd\fR notation.
901 901 .RE
902 902
903 903 .sp
904 904 .ne 2
905 905 .na
906 906 \fB\fB-B\fR\fR
907 907 .ad
908 908 .br
909 909 .na
910 910 \fB\fB--ignore-backups\fR\fR
911 911 .ad
912 912 .sp .6
913 913 .RS 4n
914 914 Do not display any files ending with a tilde (\fB~\fR).
915 915 .RE
916 916
917 917 .sp
918 918 .ne 2
919 919 .na
920 920 \fB\fB-c\fR\fR
921 921 .ad
922 922 .sp .6
923 923 .RS 4n
924 924 Uses time of last modification of the i-node (file created, mode changed, and
925 925 so forth) for sorting (\fB-t\fR) or printing (\fB-l\fR or \fB-n\fR).
926 926 .RE
927 927
928 928 .sp
929 929 .ne 2
930 930 .na
931 931 \fB\fB-C\fR\fR
932 932 .ad
933 933 .sp .6
934 934 .RS 4n
935 935 Multi-column output with entries sorted down the columns. This is the default
936 936 output format.
937 937 .RE
938 938
939 939 .sp
940 940 .ne 2
941 941 .na
942 942 \fB\fB-d\fR\fR
943 943 .ad
944 944 .sp .6
945 945 .RS 4n
946 946 If an argument is a directory, lists only its name (not its contents). Often
947 947 used with \fB-l\fR to get the status of a directory.
948 948 .RE
949 949
950 950 .sp
951 951 .ne 2
952 952 .na
953 953 \fB\fB-e\fR\fR
954 954 .ad
955 955 .sp .6
956 956 .RS 4n
957 957 The same as \fB-l\fR, except displays time to the second, and with one format
958 958 for all files regardless of age: \fImmm dd hh:mm:ss yyyy\fR.
959 959 .RE
960 960
961 961 .sp
962 962 .ne 2
963 963 .na
964 964 \fB\fB-E\fR\fR
965 965 .ad
966 966 .sp .6
967 967 .RS 4n
968 968 The same as \fB-l\fR, except displays time to the nanosecond and with one
969 969 format for all files regardless of age: \fIyyyy-mm-dd hh:mm:ss.nnnnnnnnn\fR
970 970 (ISO 8601:2000 format).
971 971 .sp
972 972 In addition, this option displays the offset from UTC in ISO 8601:2000 standard
973 973 format (+\fIhhmm\fR or -\fIhhmm\fR) or no characters if the offset is
974 974 indeterminable. The offset reflects the appropriate standard or alternate
975 975 offset in force at the file's displayed date and time, under the current
976 976 timezone.
977 977 .RE
978 978
979 979 .sp
980 980 .ne 2
981 981 .na
982 982 \fB\fB-f\fR\fR
983 983 .ad
984 984 .sp .6
985 985 .RS 4n
986 986 Forces each argument to be interpreted as a directory and list the name found
987 987 in each slot. This option turns off \fB-l\fR, \fB-t\fR, \fB-s\fR, \fB-S\fR, and
988 988 \fB-r\fR, and turns on \fB-a\fR. The order is the order in which entries appear
989 989 in the directory.
990 990 .RE
991 991
992 992 .sp
993 993 .ne 2
994 994 .na
995 995 \fB\fB-F\fR\fR
996 996 .ad
997 997 .br
998 998 .na
999 999 \fB\fB--classify\fR\fR
1000 1000 .ad
1001 1001 .sp .6
1002 1002 .RS 4n
1003 1003 Append a symbol after certain types of files to indicate the file type. The
1004 1004 following symbols are used:
1005 1005 .sp
1006 1006 .ne 2
1007 1007 .na
1008 1008 \fB\fB/\fR\fR
1009 1009 .ad
1010 1010 .sp .6
1011 1011 .RS 4n
1012 1012 Directory
1013 1013 .RE
1014 1014
1015 1015 .sp
1016 1016 .ne 2
1017 1017 .na
1018 1018 \fB\fB>\fR\fR
1019 1019 .ad
1020 1020 .sp .6
1021 1021 .RS 4n
1022 1022 Door file
1023 1023 .RE
1024 1024
1025 1025 .sp
1026 1026 .ne 2
1027 1027 .na
1028 1028 \fB\fB|\fR\fR
1029 1029 .ad
1030 1030 .sp .6
1031 1031 .RS 4n
1032 1032 Named pipe (\fBFIFO\fR)
1033 1033 .RE
1034 1034
1035 1035 .sp
1036 1036 .ne 2
1037 1037 .na
1038 1038 \fB\fB@\fR\fR
1039 1039 .ad
1040 1040 .sp .6
1041 1041 .RS 4n
1042 1042 Symbolic link
1043 1043 .RE
1044 1044
1045 1045 .sp
1046 1046 .ne 2
1047 1047 .na
1048 1048 \fB\fB=\fR\fR
1049 1049 .ad
1050 1050 .sp .6
1051 1051 .RS 4n
1052 1052 Socket
1053 1053 .RE
1054 1054
1055 1055 .sp
1056 1056 .ne 2
1057 1057 .na
1058 1058 \fB\fB*\fR\fR
1059 1059 .ad
1060 1060 .sp .6
1061 1061 .RS 4n
1062 1062 Executable
1063 1063 .RE
1064 1064
1065 1065 .RE
1066 1066
1067 1067 .sp
1068 1068 .ne 2
1069 1069 .na
1070 1070 \fB\fB-g\fR\fR
1071 1071 .ad
1072 1072 .sp .6
1073 1073 .RS 4n
1074 1074 The same as \fB-l\fR, except that the owner is not printed.
1075 1075 .RE
1076 1076
1077 1077 .sp
1078 1078 .ne 2
1079 1079 .na
1080 1080 \fB\fB-h\fR\fR
1081 1081 .ad
1082 1082 .br
1083 1083 .na
1084 1084 \fB\fB--human-readable\fR\fR
1085 1085 .ad
1086 1086 .sp .6
1087 1087 .RS 4n
1088 1088 All sizes are scaled to a human readable format, for example, \fB14K\fR,
1089 1089 \fB234M\fR, \fB2.7G\fR, or \fB3.0T\fR. Scaling is done by repetitively dividing
1090 1090 by \fB1024\fR. The last --si or -h option determines the divisor used.
1091 1091 .RE
1092 1092
1093 1093 .sp
1094 1094 .ne 2
1095 1095 .na
1096 1096 \fB\fB-H\fR\fR
1097 1097 .ad
1098 1098 .br
1099 1099 .na
1100 1100 \fB\fB--dereference-command-line\fR\fR
1101 1101 .ad
1102 1102 .sp .6
1103 1103 .RS 4n
1104 1104 If an argument is a symbolic link that references a directory, this option
1105 1105 evaluates the file information and file type of the directory that the link
1106 1106 references, rather than those of the link itself. However, the name of the link
1107 1107 is displayed, rather than the referenced directory.
1108 1108 .RE
1109 1109
1110 1110 .sp
1111 1111 .ne 2
1112 1112 .na
1113 1113 \fB\fB-i\fR\fR
1114 1114 .ad
1115 1115 .br
1116 1116 .na
1117 1117 \fB\fB--inode\fR\fR
1118 1118 .ad
1119 1119 .sp .6
1120 1120 .RS 4n
1121 1121 For each file, prints the i-node number in the first column of the report.
1122 1122 .RE
1123 1123
1124 1124 .sp
1125 1125 .ne 2
1126 1126 .na
1127 1127 \fB\fB-k\fR\fR
1128 1128 .ad
1129 1129 .sp .6
1130 1130 .RS 4n
1131 1131 All sizes are printed in kbytes. Equivalent to --block-size=1024.
1132 1132 .RE
1133 1133
1134 1134 .sp
1135 1135 .ne 2
1136 1136 .na
1137 1137 \fB\fB-l\fR\fR
1138 1138 .ad
1139 1139 .sp .6
1140 1140 .RS 4n
1141 1141 Lists in long format, giving mode, \fBACL\fR indication, number of links,
1142 1142 owner, group, size in bytes, and time of last modification for each file (see
1143 1143 above). If the file is a special file, the size field instead contains the
1144 1144 major and minor device numbers. If the time of last modification is greater
1145 1145 than six months ago, it is shown in the format `month date year' for the POSIX
1146 1146 locale. When the \fBLC_TIME\fR locale category is not set to the POSIX locale,
1147 1147 a different format of the time field can be used. Files modified within six
1148 1148 months show `month date time'. If the file is a symbolic link, the filename is
1149 1149 printed followed by "\fB\(->\fR" and the path name of the referenced file.
1150 1150 .RE
1151 1151
1152 1152 .sp
1153 1153 .ne 2
1154 1154 .na
1155 1155 \fB\fB-L\fR\fR
1156 1156 .ad
1157 1157 .br
1158 1158 .na
1159 1159 \fB\fB--dereference\fR\fR
1160 1160 .ad
1161 1161 .sp .6
1162 1162 .RS 4n
1163 1163 If an argument is a symbolic link, this option evaluates the file information
1164 1164 and file type of the file or directory that the link references, rather than
1165 1165 those of the link itself. However, the name of the link is displayed, rather
1166 1166 than the referenced file or directory.
1167 1167 .RE
1168 1168
1169 1169 .sp
1170 1170 .ne 2
1171 1171 .na
1172 1172 \fB\fB-m\fR\fR
1173 1173 .ad
1174 1174 .sp .6
1175 1175 .RS 4n
1176 1176 Streams output format. Files are listed across the page, separated by commas.
1177 1177 .RE
1178 1178
1179 1179 .sp
1180 1180 .ne 2
|
↓ open down ↓ |
1122 lines elided |
↑ open up ↑ |
1181 1181 .na
1182 1182 \fB\fB-n\fR\fR
1183 1183 .ad
1184 1184 .br
1185 1185 .na
1186 1186 \fB\fB--numeric-uid-gid\fR\fR
1187 1187 .ad
1188 1188 .sp .6
1189 1189 .RS 4n
1190 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.
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.
1192 1197 .RE
1193 1198
1194 1199 .sp
1195 1200 .ne 2
1196 1201 .na
1197 1202 \fB\fB-o\fR\fR
1198 1203 .ad
1199 1204 .br
1200 1205 .na
1201 1206 \fB\fB--no-group\fR\fR
1202 1207 .ad
1203 1208 .sp .6
1204 1209 .RS 4n
1205 1210 The same as \fB-l\fR, except that the group is not printed.
1206 1211 .RE
1207 1212
1208 1213 .sp
1209 1214 .ne 2
1210 1215 .na
1211 1216 \fB\fB-p\fR\fR
1212 1217 .ad
1213 1218 .sp .6
1214 1219 .RS 4n
1215 1220 Puts a slash (\fB/\fR) after each filename if the file is a directory.
1216 1221 .RE
1217 1222
1218 1223 .sp
1219 1224 .ne 2
1220 1225 .na
1221 1226 \fB\fB-q\fR\fR
1222 1227 .ad
1223 1228 .br
1224 1229 .na
1225 1230 \fB\fB--hide-control-chars\fR\fR
1226 1231 .ad
1227 1232 .sp .6
1228 1233 .RS 4n
1229 1234 Forces printing of non-printable characters in file names as the character
1230 1235 question mark (\fB?\fR).
1231 1236 .RE
1232 1237
1233 1238 .sp
1234 1239 .ne 2
1235 1240 .na
1236 1241 \fB\fB-r\fR\fR
1237 1242 .ad
1238 1243 .br
1239 1244 .na
1240 1245 \fB\fB--reverse\fR\fR
1241 1246 .ad
1242 1247 .sp .6
1243 1248 .RS 4n
1244 1249 Reverses the order of sort to get reverse alphabetic, oldest first, or smallest
1245 1250 file size first as appropriate.
1246 1251 .RE
1247 1252
1248 1253 .sp
1249 1254 .ne 2
1250 1255 .na
1251 1256 \fB\fB-R\fR\fR
1252 1257 .ad
1253 1258 .br
1254 1259 .na
1255 1260 \fB\fB--recursive\fR\fR
1256 1261 .ad
1257 1262 .sp .6
1258 1263 .RS 4n
1259 1264 Recursively lists subdirectories encountered.
1260 1265 .RE
1261 1266
1262 1267 .sp
1263 1268 .ne 2
1264 1269 .na
1265 1270 \fB\fB-s\fR\fR
1266 1271 .ad
1267 1272 .br
1268 1273 .na
1269 1274 \fB\fB--size\fR\fR
1270 1275 .ad
1271 1276 .sp .6
1272 1277 .RS 4n
1273 1278 Indicate the total number of file system blocks consumed by each file
1274 1279 displayed.
1275 1280 .RE
1276 1281
1277 1282 .sp
1278 1283 .ne 2
1279 1284 .na
1280 1285 \fB\fB-S\fR\fR
1281 1286 .ad
1282 1287 .sp .6
1283 1288 .RS 4n
1284 1289 Sort by file size (in decreasing order) and for files with the same size by
1285 1290 file name (in increasing alphabetic order) instead of just by name.
1286 1291 .RE
1287 1292
1288 1293 .sp
1289 1294 .ne 2
1290 1295 .na
1291 1296 \fB\fB-t\fR\fR
1292 1297 .ad
1293 1298 .sp .6
1294 1299 .RS 4n
1295 1300 Sorts by time stamp (latest first) instead of by name. The default is the last
1296 1301 modification time. See \fB-c\fR, \fB-u\fR and \fB-%\fR.
1297 1302 .RE
1298 1303
1299 1304 .sp
1300 1305 .ne 2
1301 1306 .na
1302 1307 \fB\fB-u\fR\fR
1303 1308 .ad
1304 1309 .sp .6
1305 1310 .RS 4n
1306 1311 Uses time of last access instead of last modification for sorting (with the
1307 1312 \fB-t\fR option) or printing (with the \fB-l\fR option).
1308 1313 .RE
1309 1314
1310 1315 .sp
1311 1316 .ne 2
1312 1317 .na
1313 1318 \fB\fB-U\fR\fR
1314 1319 .ad
1315 1320 .sp .6
1316 1321 .RS 4n
1317 1322 Output is unsorted.
1318 1323 .RE
1319 1324
1320 1325 .sp
1321 1326 .ne 2
1322 1327 .na
1323 1328 \fB\fB-v\fR\fR
1324 1329 .ad
1325 1330 .sp .6
1326 1331 .RS 4n
1327 1332 The same as \fB-l\fR, except that verbose ACL information is displayed as well
1328 1333 as the \fB-l\fR output. ACL information is displayed even if the file or
1329 1334 directory doesn't have an ACL.
1330 1335 .RE
1331 1336
1332 1337 .sp
1333 1338 .ne 2
1334 1339 .na
1335 1340 \fB\fB-V\fR\fR
1336 1341 .ad
1337 1342 .sp .6
1338 1343 .RS 4n
1339 1344 The same as \fB-l\fR, except that compact ACL information is displayed after
1340 1345 the \fB-l\fR output.
1341 1346 .sp
1342 1347 The \fB-V\fR option is only applicable to file systems that support NFSv4 ACLs,
1343 1348 such as the Solaris ZFS file system.
1344 1349 .sp
1345 1350 The format of the displayed ACL is as follows:
1346 1351 .sp
1347 1352 .in +2
1348 1353 .nf
1349 1354 \fIentry_type\fR : \fIpermissions\fR : \fIinheritance_flags\fR : \fIaccess_type\fR
1350 1355 .fi
1351 1356 .in -2
1352 1357 .sp
1353 1358
1354 1359 \fIentry_type\fR is displayed as one of the following:
1355 1360 .sp
1356 1361 .ne 2
1357 1362 .na
1358 1363 \fBuser:\fIusername\fR\fR
1359 1364 .ad
1360 1365 .sp .6
1361 1366 .RS 4n
1362 1367 Additional user access for \fIusername\fR.
1363 1368 .RE
1364 1369
1365 1370 .sp
1366 1371 .ne 2
1367 1372 .na
1368 1373 \fBgroup:\fIgroupname\fR\fR
1369 1374 .ad
1370 1375 .sp .6
1371 1376 .RS 4n
1372 1377 Additional group access for group \fIgroupname\fR.
1373 1378 .RE
1374 1379
1375 1380 .sp
1376 1381 .ne 2
1377 1382 .na
1378 1383 \fBowner@\fR
1379 1384 .ad
1380 1385 .sp .6
1381 1386 .RS 4n
1382 1387 File owner.
1383 1388 .RE
1384 1389
1385 1390 .sp
1386 1391 .ne 2
1387 1392 .na
1388 1393 \fBgroup@\fR
1389 1394 .ad
1390 1395 .sp .6
1391 1396 .RS 4n
1392 1397 File group owner.
1393 1398 .RE
1394 1399
1395 1400 .sp
1396 1401 .ne 2
1397 1402 .na
1398 1403 \fBeveryone@\fR
1399 1404 .ad
1400 1405 .sp .6
1401 1406 .RS 4n
1402 1407 Everyone access, including file owner and file group owner. This is not
1403 1408 equivalent to the POSIX other class.
1404 1409 .RE
1405 1410
1406 1411 The following permissions, supported by the NFSv4 ACL model, are displayed by
1407 1412 using the \fB-v\fR or \fB-V\fR options:
1408 1413 .sp
1409 1414 .ne 2
1410 1415 .na
1411 1416 \fBread_data (\fBr\fR)\fR
1412 1417 .ad
1413 1418 .sp .6
1414 1419 .RS 4n
1415 1420 Permission to read the data of a file.
1416 1421 .RE
1417 1422
1418 1423 .sp
1419 1424 .ne 2
1420 1425 .na
1421 1426 \fBlist_directory (\fBr\fR)\fR
1422 1427 .ad
1423 1428 .sp .6
1424 1429 .RS 4n
1425 1430 Permission to list the contents of a directory.
1426 1431 .RE
1427 1432
1428 1433 .sp
1429 1434 .ne 2
1430 1435 .na
1431 1436 \fBwrite_data (\fBw\fR)\fR
1432 1437 .ad
1433 1438 .sp .6
1434 1439 .RS 4n
1435 1440 Permission to modify a file's data. anywhere in the file's offset range.
1436 1441 .RE
1437 1442
1438 1443 .sp
1439 1444 .ne 2
1440 1445 .na
1441 1446 \fBadd_file (\fBw\fR)\fR
1442 1447 .ad
1443 1448 .sp .6
1444 1449 .RS 4n
1445 1450 Permission to add a new file to a directory.
1446 1451 .RE
1447 1452
1448 1453 .sp
1449 1454 .ne 2
1450 1455 .na
1451 1456 \fBappend_data (\fBp\fR)\fR
1452 1457 .ad
1453 1458 .sp .6
1454 1459 .RS 4n
1455 1460 The ability to modify a file's data, but only starting at EOF.
1456 1461 .RE
1457 1462
1458 1463 .sp
1459 1464 .ne 2
1460 1465 .na
1461 1466 \fBadd_subdirectory (\fBp\fR)\fR
1462 1467 .ad
1463 1468 .sp .6
1464 1469 .RS 4n
1465 1470 Permission to create a subdirectory to a directory.
1466 1471 .RE
1467 1472
1468 1473 .sp
1469 1474 .ne 2
1470 1475 .na
1471 1476 \fBread_xattr (\fBR\fR)\fR
1472 1477 .ad
1473 1478 .sp .6
1474 1479 .RS 4n
1475 1480 Ability to read the extended attributes of a file.
1476 1481 .RE
1477 1482
1478 1483 .sp
1479 1484 .ne 2
1480 1485 .na
1481 1486 \fBwrite_xattr (\fBW\fR)\fR
1482 1487 .ad
1483 1488 .sp .6
1484 1489 .RS 4n
1485 1490 Ability to create extended attributes or write to the extended attribute
1486 1491 directory.
1487 1492 .RE
1488 1493
1489 1494 .sp
1490 1495 .ne 2
1491 1496 .na
1492 1497 \fBexecute (\fBx\fR)\fR
1493 1498 .ad
1494 1499 .sp .6
1495 1500 .RS 4n
1496 1501 Permission to execute a file.
1497 1502 .RE
1498 1503
1499 1504 .sp
1500 1505 .ne 2
1501 1506 .na
1502 1507 \fBread_attributes (\fBa\fR)\fR
1503 1508 .ad
1504 1509 .sp .6
1505 1510 .RS 4n
1506 1511 The ability to read basic attributes (non-ACLs) of a file.
1507 1512 .RE
1508 1513
1509 1514 .sp
1510 1515 .ne 2
1511 1516 .na
1512 1517 \fBwrite_attributes (\fBA\fR)\fR
1513 1518 .ad
1514 1519 .sp .6
1515 1520 .RS 4n
1516 1521 Permission to change the times associated with a file or directory to an
1517 1522 arbitrary value.
1518 1523 .RE
1519 1524
1520 1525 .sp
1521 1526 .ne 2
1522 1527 .na
1523 1528 \fBdelete (\fBd\fR)\fR
1524 1529 .ad
1525 1530 .sp .6
1526 1531 .RS 4n
1527 1532 Permission to delete a file.
1528 1533 .RE
1529 1534
1530 1535 .sp
1531 1536 .ne 2
1532 1537 .na
1533 1538 \fBdelete_child (\fBD\fR)\fR
1534 1539 .ad
1535 1540 .sp .6
1536 1541 .RS 4n
1537 1542 Permission to delete a file within a directory.
1538 1543 .RE
1539 1544
1540 1545 .sp
1541 1546 .ne 2
1542 1547 .na
1543 1548 \fBread_acl (\fBc\fR)\fR
1544 1549 .ad
1545 1550 .sp .6
1546 1551 .RS 4n
1547 1552 Permission to read the ACL of a file.
1548 1553 .RE
1549 1554
1550 1555 .sp
1551 1556 .ne 2
1552 1557 .na
1553 1558 \fBwrite_acl (\fBC\fR)\fR
1554 1559 .ad
1555 1560 .sp .6
1556 1561 .RS 4n
1557 1562 Permission to write the ACL of a file.
1558 1563 .RE
1559 1564
1560 1565 .sp
1561 1566 .ne 2
1562 1567 .na
1563 1568 \fBwrite_owner (\fBo\fR)\fR
1564 1569 .ad
1565 1570 .sp .6
1566 1571 .RS 4n
1567 1572 Permission to change the owner of a file.
1568 1573 .RE
1569 1574
1570 1575 .sp
1571 1576 .ne 2
1572 1577 .na
1573 1578 \fBsynchronize (\fBs\fR)\fR
1574 1579 .ad
1575 1580 .sp .6
1576 1581 .RS 4n
1577 1582 Permission to access file locally at server with synchronize reads and writes.
1578 1583 .RE
1579 1584
1580 1585 .sp
1581 1586 .ne 2
1582 1587 .na
1583 1588 \fB\fB-\fR\fR
1584 1589 .ad
1585 1590 .sp .6
1586 1591 .RS 4n
1587 1592 No permission granted
1588 1593 .RE
1589 1594
1590 1595 The following inheritance flags, supported by the NFSv4 ACL model, are
1591 1596 displayed by using the \fB-v\fR or \fB-V\fR options:
1592 1597 .sp
1593 1598 .ne 2
1594 1599 .na
1595 1600 \fBfile_inherit (\fBf\fR)\fR
1596 1601 .ad
1597 1602 .sp .6
1598 1603 .RS 4n
1599 1604 Inherit to all newly created files.
1600 1605 .RE
1601 1606
1602 1607 .sp
1603 1608 .ne 2
1604 1609 .na
1605 1610 \fBdir_inherit (\fBd\fR)\fR
1606 1611 .ad
1607 1612 .sp .6
1608 1613 .RS 4n
1609 1614 Inherit to all newly created directories.
1610 1615 .RE
1611 1616
1612 1617 .sp
1613 1618 .ne 2
1614 1619 .na
1615 1620 \fBinherit_only (\fBi\fR)\fR
1616 1621 .ad
1617 1622 .sp .6
1618 1623 .RS 4n
1619 1624 When placed on a directory, do not apply to the directory, only to newly
1620 1625 created files and directories. This flag requires that either
1621 1626 \fBfile_inherit\fR and or \fBdir_inherit\fR is also specified.
1622 1627 .RE
1623 1628
1624 1629 .sp
1625 1630 .ne 2
1626 1631 .na
1627 1632 \fBno_propagate (\fBn\fR)\fR
1628 1633 .ad
1629 1634 .sp .6
1630 1635 .RS 4n
1631 1636 Indicates that ACL entries should be inherited to objects in a directory, but
1632 1637 inheritance should stop after descending one level. This flag is dependent upon
1633 1638 either \fBfile_inherit\fR and or \fBdir_inherit\fR also being specified.
1634 1639 .RE
1635 1640
1636 1641 .sp
1637 1642 .ne 2
1638 1643 .na
1639 1644 \fBsuccessful_access (\fBS\fR)\fR
1640 1645 .ad
1641 1646 .sp .6
1642 1647 .RS 4n
1643 1648 Indicates whether an alarm or audit record should be initiated upon successful
1644 1649 accesses. Used with audit/alarm ACE types.
1645 1650 .RE
1646 1651
1647 1652 .sp
1648 1653 .ne 2
1649 1654 .na
1650 1655 \fBfailed_access (\fBF\fR)\fR
1651 1656 .ad
1652 1657 .sp .6
1653 1658 .RS 4n
1654 1659 Indicates whether an alarm or audit record should be initiated when access
1655 1660 fails. Used with audit/alarm ACE types.
1656 1661 .RE
1657 1662
1658 1663 .sp
1659 1664 .ne 2
1660 1665 .na
1661 1666 \fBinherited (\fBI\fR)\fR
1662 1667 .ad
1663 1668 .sp .6
1664 1669 .RS 4n
1665 1670 ACE was inherited.
1666 1671 .RE
1667 1672
1668 1673 .sp
1669 1674 .ne 2
1670 1675 .na
1671 1676 \fB\fB-\fR\fR
1672 1677 .ad
1673 1678 .sp .6
1674 1679 .RS 4n
1675 1680 No permission granted.
1676 1681 .RE
1677 1682
1678 1683 \fIaccess_type\fR is displayed as one of the following types:
1679 1684 .sp
1680 1685 .ne 2
1681 1686 .na
1682 1687 \fBalarm\fR
1683 1688 .ad
1684 1689 .RS 9n
1685 1690 Permission field that specifies permissions that should trigger an alarm.
1686 1691 .RE
1687 1692
1688 1693 .sp
1689 1694 .ne 2
1690 1695 .na
1691 1696 \fBallow\fR
1692 1697 .ad
1693 1698 .RS 9n
1694 1699 Permission field that specifies allow permissions.
1695 1700 .RE
1696 1701
1697 1702 .sp
1698 1703 .ne 2
1699 1704 .na
1700 1705 \fBaudit\fR
1701 1706 .ad
1702 1707 .RS 9n
1703 1708 Permission field that specifies permissions that should be audited.
1704 1709 .RE
1705 1710
1706 1711 .sp
1707 1712 .ne 2
1708 1713 .na
1709 1714 \fBdeny\fR
1710 1715 .ad
1711 1716 .RS 9n
1712 1717 Permission field that specifies deny permissions.
1713 1718 .RE
1714 1719
1715 1720 For example:
1716 1721 .sp
1717 1722 .in +2
1718 1723 .nf
1719 1724 $ ls -dV /sandbox/dir.1
1720 1725 drwxr-xr-x+ 2 root root 2 Jan 17 15:09 dir.1
1721 1726 user:marks:r-------------:fd-----:allow
1722 1727 owner@:--------------:-------:deny
1723 1728 owner@:rwxp---A-W-Co-:-------:allow
1724 1729 group@:-w-p----------:-------:deny
1725 1730 group@:r-x-----------:-------:allow
1726 1731 everyone@:-w-p---A-W-Co-:-------:deny
1727 1732 everyone@:r-x---a-R-c--s:-------:allow
1728 1733 $
1729 1734 ||||||||||||||||:||||||+ inherited access
1730 1735 ||||||||||||||:||||||+ failed access
1731 1736 ||||||||||||||:|||||+--success access
1732 1737 ||||||||||||||:||||+-- no propagate
1733 1738 ||||||||||||||:|||+--- inherit only
1734 1739 ||||||||||||||:||+---- directory inherit
1735 1740 ||||||||||||||:|+----- file inherit
1736 1741 ||||||||||||||
1737 1742 ||||||||||||||+ sync
1738 1743 |||||||||||||+- change owner
1739 1744 ||||||||||||+-- write ACL
1740 1745 |||||||||||+--- read ACL
1741 1746 ||||||||||+---- write extended attributes
1742 1747 |||||||||+----- read extended attributes
1743 1748 ||||||||+------ write attributes
1744 1749 |||||||+------- read attributes
1745 1750 ||||||+-------- delete child
1746 1751 |||||+--------- delete
1747 1752 ||||+---------- append
1748 1753 |||+----------- execute
1749 1754 ||+------------ write data
1750 1755 |+------------- read data
1751 1756 .fi
1752 1757 .in -2
1753 1758 .sp
1754 1759
1755 1760 .RE
1756 1761
1757 1762 .sp
1758 1763 .ne 2
1759 1764 .na
1760 1765 \fB\fB-w\fR \fIcols\fR\fR
1761 1766 .ad
1762 1767 .br
1763 1768 .na
1764 1769 \fB\fB--width\fR \fIcols\fR\fR
1765 1770 .ad
1766 1771 .sp .6
1767 1772 .RS 4n
1768 1773 Multi-column output where the column width is forced to \fIcols\fR.
1769 1774 .RE
1770 1775
1771 1776 .sp
1772 1777 .ne 2
1773 1778 .na
1774 1779 \fB\fB-x\fR\fR
1775 1780 .ad
1776 1781 .sp .6
1777 1782 .RS 4n
1778 1783 Multi-column output with entries sorted across rather than down the page.
1779 1784 .RE
1780 1785
1781 1786 .sp
1782 1787 .ne 2
1783 1788 .na
1784 1789 \fB\fB-1\fR\fR
1785 1790 .ad
1786 1791 .sp .6
1787 1792 .RS 4n
1788 1793 Prints one entry per line of output.
1789 1794 .RE
1790 1795
1791 1796 .sp
1792 1797 .ne 2
1793 1798 .na
1794 1799 \fB\fB-@\fR\fR
1795 1800 .ad
1796 1801 .sp .6
1797 1802 .RS 4n
1798 1803 The same as \fB-l\fR, except that extended attribute information overrides
1799 1804 \fBACL\fR information. An \fB@\fR is displayed after the file permission bits
1800 1805 for files that have extended attributes.
1801 1806 .RE
1802 1807
1803 1808 .sp
1804 1809 .ne 2
1805 1810 .na
1806 1811 \fB\fB-/ c\fR | \fBv\fR\fR
1807 1812 .ad
1808 1813 .sp .6
1809 1814 .RS 4n
1810 1815 The same as \fB-l\fR, and in addition displays the extended system attributes
1811 1816 associated with the file when extended system attributes are fully supported by
1812 1817 the underlying file system. The option \fB-/\fR supports two option arguments
1813 1818 \fBc\fR (compact mode) and \fBv\fR (verbose mode).
1814 1819 .sp
1815 1820 .ne 2
1816 1821 .na
1817 1822 \fB\fBappendonly\fR\fR
1818 1823 .ad
1819 1824 .sp .6
1820 1825 .RS 4n
1821 1826 Allows a file to be modified only at offset \fBEOF\fR. Attempts to modify a
1822 1827 file at a location other than \fBEOF\fR fails with \fBEPERM\fR.
1823 1828 .RE
1824 1829
1825 1830 .sp
1826 1831 .ne 2
1827 1832 .na
1828 1833 \fB\fBarchive\fR\fR
1829 1834 .ad
1830 1835 .sp .6
1831 1836 .RS 4n
1832 1837 Indicates if a file has been modified since it was last backed up. Whenever the
1833 1838 modification time (\fBmtime\fR) of a file is changed the \fBarchive\fR
1834 1839 attribute is set.
1835 1840 .RE
1836 1841
1837 1842 .sp
1838 1843 .ne 2
1839 1844 .na
1840 1845 \fB\fBav_modified\fR\fR
1841 1846 .ad
1842 1847 .sp .6
1843 1848 .RS 4n
1844 1849 ZFS sets the anti-virus attribute which whenever a file's content or size
1845 1850 changes or when the file is renamed.
1846 1851 .RE
1847 1852
1848 1853 .sp
1849 1854 .ne 2
1850 1855 .na
1851 1856 \fB\fBav_quarantined\fR\fR
1852 1857 .ad
1853 1858 .sp .6
1854 1859 .RS 4n
1855 1860 Anti-virus software sets to mark a file as quarantined.
1856 1861 .RE
1857 1862
1858 1863 .sp
1859 1864 .ne 2
1860 1865 .na
1861 1866 \fB\fBcrtime\fR\fR
1862 1867 .ad
1863 1868 .sp .6
1864 1869 .RS 4n
1865 1870 Timestamp when a file is created.
1866 1871 .RE
1867 1872
1868 1873 .sp
1869 1874 .ne 2
1870 1875 .na
1871 1876 \fB\fBhidden\fR\fR
1872 1877 .ad
1873 1878 .sp .6
1874 1879 .RS 4n
1875 1880 Marks a file as hidden.
1876 1881 .RE
1877 1882
1878 1883 .sp
1879 1884 .ne 2
1880 1885 .na
1881 1886 \fB\fBimmutable\fR\fR
1882 1887 .ad
1883 1888 .sp .6
1884 1889 .RS 4n
1885 1890 Prevents the content of a file from being modified. Also prevents all metadata
1886 1891 changes, except for access time updates. When placed on a directory, prevents
1887 1892 the deletion and creation of files in the directories. Attempts to modify the
1888 1893 content of a file or directory marked as \fBimmutable\fR fail with \fBEPERM\fR.
1889 1894 Attempts to modify any attributes (with the exception of access time and, with
1890 1895 the proper privileges, the \fBimmutable\fR) of a file marked as \fBimmutable\fR
1891 1896 fails with \fBEPERM\fR.
1892 1897 .RE
1893 1898
1894 1899 .sp
1895 1900 .ne 2
1896 1901 .na
1897 1902 \fB\fBnodump\fR\fR
1898 1903 .ad
1899 1904 .sp .6
1900 1905 .RS 4n
1901 1906 Solaris systems have no special semantics for this attribute.
1902 1907 .RE
1903 1908
1904 1909 .sp
1905 1910 .ne 2
1906 1911 .na
1907 1912 \fB\fBnounlink\fR\fR
1908 1913 .ad
1909 1914 .sp .6
1910 1915 .RS 4n
1911 1916 Prevents a file from being deleted. On a directory, the attribute also prevents
1912 1917 any changes to the contents of the directory. That is, no files within the
1913 1918 directory can be removed or renamed. The \fBerrno\fR \fBEPERM\fR is returned
1914 1919 when attempting to unlink or rename files and directories that are marked as
1915 1920 \fBnounlink\fR.
1916 1921 .RE
1917 1922
1918 1923 .sp
1919 1924 .ne 2
1920 1925 .na
1921 1926 \fB\fBoffline\fR\fR
1922 1927 .ad
1923 1928 .sp .6
1924 1929 .RS 4n
1925 1930 Indicate that a file is offline. Solaris systems have no special semantics for
1926 1931 this attribute.
1927 1932 .RE
1928 1933
1929 1934 .sp
1930 1935 .ne 2
1931 1936 .na
1932 1937 \fB\fBreadonly\fR\fR
1933 1938 .ad
1934 1939 .sp .6
1935 1940 .RS 4n
1936 1941 Marks a file as \fBreadonly\fR. Once a file is marked as \fBreadonly\fR the
1937 1942 content data of the file cannot be modified. Other metadata for the file can
1938 1943 still be modified.
1939 1944 .RE
1940 1945
1941 1946 .sp
1942 1947 .ne 2
1943 1948 .na
1944 1949 \fB\fBsparse\fR\fR
1945 1950 .ad
1946 1951 .sp .6
1947 1952 .RS 4n
1948 1953 Indicate that a file can be interpreted as sparse. It does not indicate that
1949 1954 the file is actually sparse or not. The sparse attribute is cleared when the
1950 1955 file is truncated to zero length. Solaris systems have no other special
1951 1956 semantics for this attribute.
1952 1957 .RE
1953 1958
1954 1959 .sp
1955 1960 .ne 2
1956 1961 .na
1957 1962 \fB\fBsystem\fR\fR
1958 1963 .ad
1959 1964 .sp .6
1960 1965 .RS 4n
1961 1966 Solaris systems have no special semantics for this attribute.
1962 1967 .RE
1963 1968
1964 1969 .RE
1965 1970
1966 1971 .sp
1967 1972 .LP
1968 1973 The display characters used in compact mode (\fB-/ c\fR) are as follows:
1969 1974 .sp
1970 1975 .in +2
1971 1976 .nf
1972 1977 Attribute Name Display
1973 1978 archive A
1974 1979 hidden H
1975 1980 readonly R
1976 1981 system S
1977 1982 appendonly a
1978 1983 nodump d
1979 1984 immutable i
1980 1985 av_modified m
1981 1986 av_quarantined q
1982 1987 nounlink u
1983 1988 offline O
1984 1989 sparse s
1985 1990 .fi
1986 1991 .in -2
1987 1992 .sp
1988 1993
1989 1994 .sp
1990 1995 .LP
1991 1996 The display in verbose mode (\fB-/ v\fR) uses full attribute names when it is set and
1992 1997 the name prefixed by 'no' when it is not set.
1993 1998 .sp
1994 1999 .LP
1995 2000 The attribute name \fBcrtime\fR and all other timestamps are handled by the
1996 2001 option \fB-%\fR with the respective timestamp option arguments and also with
1997 2002 \fBall\fR option argument. The display positions are as follows: The display in
1998 2003 verbose mode (\fB-/ v\fR) uses full attribute names when it is set and the
1999 2004 name prefixed by \fBno\fR when it is not set. The attribute name \fBcrtime\fR
2000 2005 and all other timestamps are handled by the option \fB-%\fR with the respective
2001 2006 timestamp option arguments and also with \fBall\fR option argument.
2002 2007 .sp
2003 2008 .LP
2004 2009 The display positions are as follows:
2005 2010 .sp
2006 2011 .in +2
2007 2012 .nf
2008 2013 {||||||||||||}
2009 2014 |||||||||||+- s (sparse)
2010 2015 ||||||||||+-- O (offline)
2011 2016 |||||||||+--- u (nounlink)
2012 2017 ||||||||+---- q (av_quarantined)
2013 2018 |||||||+----- m (av_modified)
2014 2019 ||||||+------ i (immutable)
2015 2020 |||||+------- d (nodump)
2016 2021 ||||+-------- a (appendonly)
2017 2022 |||+--------- S (system)
2018 2023 ||+---------- R (readonly)
2019 2024 |+----------- H (hidden)
2020 2025 +------------ A (archive)
2021 2026 .fi
2022 2027 .in -2
2023 2028 .sp
2024 2029
2025 2030 .sp
2026 2031 .in +2
2027 2032 .nf
2028 2033 -% atime | crtime | ctime | mtime | all
2029 2034 .fi
2030 2035 .in -2
2031 2036 .sp
2032 2037
2033 2038 .sp
2034 2039 .ne 2
2035 2040 .na
2036 2041 \fB\fBatime\fR\fR
2037 2042 .ad
2038 2043 .sp .6
2039 2044 .RS 4n
2040 2045 Equivalent to \fB-u\fR.
2041 2046 .RE
2042 2047
2043 2048 .sp
2044 2049 .ne 2
2045 2050 .na
2046 2051 \fB\fBcrtime\fR\fR
2047 2052 .ad
2048 2053 .sp .6
2049 2054 .RS 4n
2050 2055 Uses the creation time of the file for sorting or printing.
2051 2056 .RE
2052 2057
2053 2058 .sp
2054 2059 .ne 2
2055 2060 .na
2056 2061 \fB\fBctime\fR\fR
2057 2062 .ad
2058 2063 .sp .6
2059 2064 .RS 4n
2060 2065 Equivalent to \fB-c\fR.
2061 2066 .RE
2062 2067
2063 2068 .sp
2064 2069 .ne 2
2065 2070 .na
2066 2071 \fB\fBmtime\fR\fR
2067 2072 .ad
2068 2073 .sp .6
2069 2074 .RS 4n
2070 2075 Uses the last modification time of the file contents for sorting or printing.
2071 2076 .RE
2072 2077
2073 2078 .sp
2074 2079 .LP
2075 2080 If extended system attributes are not supported or if the user does not have
2076 2081 \fBread\fR permission on the file or if the \fBcrtime\fR extended attribute is
2077 2082 not set, \fBcrtime\fR is treated as a synonym for \fBmtime\fR.
2078 2083 .sp
2079 2084 .LP
2080 2085 When option argument \fBall\fR is specified, all available timestamps are
2081 2086 printed which includes \fBatime\fR, \fBctime\fR, \fBmtime\fR and on the
2082 2087 extended system attribute supporting file systems, \fBcrtime\fR (create time).
2083 2088 The option \fB-% all\fR does not effect which timestamp is displayed in long
2084 2089 format and does not affect sorting.
2085 2090 .sp
2086 2091 .ne 2
2087 2092 .na
2088 2093 \fB\fB--block-size\fR \fIsize\fR\fR
2089 2094 .ad
2090 2095 .sp .6
2091 2096 .RS 4n
2092 2097 Display sizes in multiples of size. Size can be scaled by suffixing one of
2093 2098 \fBYyZzEePpTtGgMmKk\fR. Additionally, a \fBB\fR can be placed at the end to
2094 2099 indicate powers of 10 instead of 2. For example, . \fB10mB\fR means blocks of
2095 2100 \fB10000000\fR bytes while \fB10m\fR means blocks of \fB10*2^20 -- 10485760
2096 2101 --\fR bytes. This is mutually exclusive with the \fB-h\fR option.
2097 2102 .RE
2098 2103
2099 2104 .sp
2100 2105 .ne 2
2101 2106 .na
2102 2107 \fB\fB--color\fR \fB[=\fR\fIwhen\fR\fB]\fR\fR
2103 2108 .ad
2104 2109 .br
2105 2110 .na
2106 2111 \fB\fB--colour\fR\fB[=\fR\fIwhen\fR\fB]\fR\fR
2107 2112 .ad
2108 2113 .sp .6
2109 2114 .RS 4n
2110 2115 Display filenames using color on color-capable terminals. \fIwhen\fR is an
2111 2116 optional argument that determines when to display color output.
2112 2117 .sp
2113 2118 Possible values for \fIwhen\fR are:
2114 2119 .sp
2115 2120 .ne 2
2116 2121 .na
2117 2122 \fB\fBalways\fR\fR
2118 2123 .ad
2119 2124 .br
2120 2125 .na
2121 2126 \fB\fByes\fR\fR
2122 2127 .ad
2123 2128 .br
2124 2129 .na
2125 2130 \fB\fBforce\fR\fR
2126 2131 .ad
2127 2132 .sp .6
2128 2133 .RS 4n
2129 2134 Always use color.
2130 2135 .RE
2131 2136
2132 2137 .sp
2133 2138 .ne 2
2134 2139 .na
2135 2140 \fB\fBauto\fR\fR
2136 2141 .ad
2137 2142 .br
2138 2143 .na
2139 2144 \fB\fBtty\fR\fR
2140 2145 .ad
2141 2146 .br
2142 2147 .na
2143 2148 \fB\fBif-tty\fR\fR
2144 2149 .ad
2145 2150 .sp .6
2146 2151 .RS 4n
2147 2152 Use color if a terminal is present.
2148 2153 .RE
2149 2154
2150 2155 .sp
2151 2156 .ne 2
2152 2157 .na
2153 2158 \fB\fBno\fR\fR
2154 2159 .ad
2155 2160 .br
2156 2161 .na
2157 2162 \fB\fBnever\fR\fR
2158 2163 .ad
2159 2164 .br
2160 2165 .na
2161 2166 \fB\fBnone\fR\fR
2162 2167 .ad
2163 2168 .sp .6
2164 2169 .RS 4n
2165 2170 Never use color. This is the default
2166 2171 .RE
2167 2172
2168 2173 See \fBCOLOR OUTPUT\fR for information on how to control the output colors.
2169 2174 .RE
2170 2175
2171 2176 .sp
2172 2177 .ne 2
2173 2178 .na
2174 2179 \fB\fB--file-type\fR\fR
2175 2180 .ad
2176 2181 .sp .6
2177 2182 .RS 4n
2178 2183 Display a suffix after a file depending on it's type, similar to the \fB-F\fR
2179 2184 option, except \fB*\fR is not appended to executable files.
2180 2185 .RE
2181 2186
2182 2187 .sp
2183 2188 .ne 2
2184 2189 .na
2185 2190 \fB\fB-si\fR\fR
2186 2191 .ad
2187 2192 .br
2188 2193 .na
2189 2194 \fB\fB--\fR\fR
2190 2195 .ad
2191 2196 .sp .6
2192 2197 .RS 4n
2193 2198 Display human scaled sizes similar to the \fB-h\fR option, except values are
2194 2199 repeatedly divided by 1000 instead of 1024. The last option \fB--si\fR or
2195 2200 \fB-h\fR determines the divisor used.
2196 2201 .RE
2197 2202
2198 2203 .sp
2199 2204 .ne 2
2200 2205 .na
2201 2206 \fB\fB--time-style\fR style\fR
2202 2207 .ad
2203 2208 .sp .6
2204 2209 .RS 4n
2205 2210 Display times using the specified style. This does not effect the times
2206 2211 displayed for extended attributes (\fB-%\fR).
2207 2212 .sp
2208 2213 Possible values for \fIstyle\fR are:
2209 2214 .sp
2210 2215 .ne 2
2211 2216 .na
2212 2217 \fB\fBfull-iso\fR\fR
2213 2218 .ad
2214 2219 .sp .6
2215 2220 .RS 4n
2216 2221 Equivalent to \fB-E\fR.
2217 2222 .RE
2218 2223
2219 2224 .sp
2220 2225 .ne 2
2221 2226 .na
2222 2227 \fB\fBlong-iso\fR\fR
2223 2228 .ad
2224 2229 .sp .6
2225 2230 .RS 4n
2226 2231 Display in \fIYYYY-MM-DD HH:MM\fR for all files.
2227 2232 .RE
2228 2233
2229 2234 .sp
2230 2235 .ne 2
2231 2236 .na
2232 2237 \fB\fBiso\fR\fR
2233 2238 .ad
2234 2239 .sp .6
2235 2240 .RS 4n
2236 2241 Display older files using \fIYYYY-MM-DD\fR and newer files with \fIMM-DD
2237 2242 HH:MM\fR.
2238 2243 .RE
2239 2244
2240 2245 .sp
2241 2246 .ne 2
2242 2247 .na
2243 2248 \fB\fBlocale\fR\fR
2244 2249 .ad
2245 2250 .sp .6
2246 2251 .RS 4n
2247 2252 Use the default locale format for old and new files. This is the default.
2248 2253 .RE
2249 2254
2250 2255 .sp
2251 2256 .ne 2
2252 2257 .na
2253 2258 \fB\fB+FORMAT\fR\fR
2254 2259 .ad
2255 2260 .sp .6
2256 2261 .RS 4n
2257 2262 Use a custom format. Values are the same as described in \fBstrftime\fR(3C). If
2258 2263 a NEWLINE appears in the string, the first line is used for older files and the
2259 2264 second line is used for newer files. Otherwise, the given format is used for
2260 2265 all files.
2261 2266 .RE
2262 2267
2263 2268 .RE
2264 2269
2265 2270 .SS "/usr/bin/ls"
2266 2271 .ne 2
2267 2272 .na
2268 2273 \fB\fB-F\fR\fR
2269 2274 .ad
2270 2275 .sp .6
2271 2276 .RS 4n
2272 2277 Marks directories with a trailing slash (\fB/\fR), doors with a trailing
2273 2278 greater-than sign (\fB>\fR), executable files with a trailing asterisk
2274 2279 (\fB*\fR), \fBFIFO\fRs with a trailing vertical bar (\fB|\fR), symbolic links
2275 2280 with a trailing "at" sign (\fB@\fR), and \fBAF_UNIX\fR address family sockets
2276 2281 with a trailing equals sign (\fB=\fR). Follows \fBsymlinks\fR named as
2277 2282 operands.
2278 2283 .RE
2279 2284
2280 2285 .sp
2281 2286 .ne 2
2282 2287 .na
2283 2288 \fB\fB--file-type\fR\fR
2284 2289 .ad
2285 2290 .sp .6
2286 2291 .RS 4n
2287 2292 Marks entries as with \fB-F\fR with the exception of executable files.
2288 2293 Executable files are not marked. Follows symlinks named as operands.
2289 2294 .RE
2290 2295
2291 2296 .sp
2292 2297 .LP
2293 2298 Specifying more than one of the options in the following mutually exclusive
2294 2299 pairs is not considered an error: \fB-C\fR and \fB-l\fR (ell), \fB-m\fR and
2295 2300 \fB-l\fR (ell), \fB-x\fR and \fB-l\fR (ell), \fB-@\fR and \fB-l\fR (ell). The
2296 2301 \fB-l\fR option overrides the other option specified in each pair.
2297 2302 .sp
2298 2303 .LP
2299 2304 Specifying more than one of the options in the following mutually exclusive
2300 2305 groups is not considered an error: \fB-C\fR and \fB-1\fR (one), \fB-H\fR and
2301 2306 \fB-L\fR, \fB-c\fR and \fB-u\fR, and \fB-e\fR and \fB-E\fR, and \fB-t\fR and
2302 2307 \fB-S\fR. The last option specifying a specific timestamp (\fB-c\fR, \fB-u\fR,
2303 2308 \fB-% atime\fR , \fB-% crtime\fR, \fB-% ctime\fR, and \fB-% mtime\fR)
2304 2309 determines the timestamps used for sorting or in long format listings. The last
2305 2310 option \fB-t\fR, \fB-S\fR, or \fB-U\fR determines the sorting behavior.
2306 2311 .SS "/usr/xpg4/bin/ls"
2307 2312 .ne 2
2308 2313 .na
2309 2314 \fB\fB-F\fR\fR
2310 2315 .ad
2311 2316 .sp .6
2312 2317 .RS 4n
2313 2318 Marks directories with a trailing slash (\fB/\fR), doors with a trailing
2314 2319 greater-than sign (\fB>\fR), executable files with a trailing asterisk
2315 2320 (\fB*\fR), \fBFIFO\fRs with a trailing vertical bar (\fB|\fR), symbolic links
2316 2321 with a trailing "at" sign (\fB@\fR), and \fBAF_UNIX\fR address family sockets
2317 2322 with a trailing equals sign (\fB=\fR). Follows symlinks named as operands.
2318 2323 .RE
2319 2324
2320 2325 .sp
2321 2326 .ne 2
2322 2327 .na
2323 2328 \fB\fB--file-type\fR\fR
2324 2329 .ad
2325 2330 .sp .6
2326 2331 .RS 4n
2327 2332 Marks entries as with \fB-F\fR with the exception of executable files.
2328 2333 Executable files are not marked. Follows symlinks named as operands.
2329 2334 .RE
2330 2335
2331 2336 .sp
2332 2337 .LP
2333 2338 Specifying more than one of the options in the following groups of mutually
2334 2339 exclusive options is not considered an error: \fB-C\fR and \fB-l\fR (ell),
2335 2340 \fB-m\fR and \fB-l\fR (ell), \fB-x\fR and \fB-l\fR (ell), \fB-@\fR and \fB-l\fR
2336 2341 (ell), \fB-C\fR and \fB-1\fR (one), \fB-H\fR and \fB-L\fR, \fB-c\fR and
2337 2342 \fB-u\fR, \fB-e\fR and \fB-E\fR, \fB-t\fR and \fB-S\fR and \fB-U\fR. The last
2338 2343 option specifying a specific timestamp (\fB-c\fR, \fB-u\fR, \fB-% atime\fR ,
2339 2344 \fB-% crtime\fR, \fB-% ctime\fR, and \fB-% mtime\fR) determines the timestamps
2340 2345 used for sorting or in long format listings. The last \fB-t\fR, \fB-S\fR, or
2341 2346 \fB-U\fR option determines the sorting behavior.
2342 2347 .SS "/usr/xpg6/bin/ls"
2343 2348 .ne 2
2344 2349 .na
2345 2350 \fB\fB-F\fR\fR
2346 2351 .ad
2347 2352 .sp .6
2348 2353 .RS 4n
2349 2354 Marks directories with a trailing slash (\fB/\fR), doors with a trailing
2350 2355 greater-than sign (\fB>\fR), executable files with a trailing asterisk
2351 2356 (\fB*\fR), \fBFIFO\fRs with a trailing vertical bar (\fB|\fR), symbolic links
2352 2357 with a trailing "at" sign (\fB@\fR), and \fBAF_UNIX\fR address family sockets
2353 2358 with a trailing equals sign (\fB=\fR). Does not follow symlinks named as
2354 2359 operands unless the \fB-H\fR or \fB-L\fR option is specified.
2355 2360 .RE
2356 2361
2357 2362 .sp
2358 2363 .ne 2
2359 2364 .na
2360 2365 \fB\fB--file-type\fR\fR
2361 2366 .ad
2362 2367 .sp .6
2363 2368 .RS 4n
2364 2369 Marks entries as with \fB-F\fR with the exception of executable files.
2365 2370 Executable files are not marked. Does not follow symlinks named as operands
2366 2371 unless the \fB-H\fR or \fB-L\fR option is specified.
2367 2372 .RE
2368 2373
2369 2374 .sp
2370 2375 .LP
2371 2376 Specifying more than one of the options in the following mutually exclusive
2372 2377 pairs is not considered an error: \fB-C\fR and \fB-l\fR (ell), m and
2373 2378 \fB-l\fR(ell), \fB-x\fR and \fB-l\fR (ell), \fB-@\fR and \fB-l\fR (ell),
2374 2379 \fB-C\fR and \fB-1\fR (one), \fB-H\fR and -\fB-L\fR, \fB-c\fR and \fB-u\fR,
2375 2380 \fB-e\fR and \fB-E\fR, \fB-t\fR and \fB-S\fR and \fB-U\fR. The last option
2376 2381 specifying a specific timestamp (\fB-c\fR, \fB-u\fR, \fB-% atime\fR , \fB-%
2377 2382 crtime\fR, \fB-% ctime\fR, and \fB-% mtime\fR) determines the timestamps used
2378 2383 for sorting or in long format listings. The last \fB-t\fR, \fB-S\fR, or
2379 2384 \fB-U\fR option determines the sorting behavior.
2380 2385 .SH OPERANDS
2381 2386 .LP
2382 2387 The following operand is supported:
2383 2388 .sp
2384 2389 .ne 2
2385 2390 .na
2386 2391 \fB\fIfile\fR\fR
2387 2392 .ad
2388 2393 .sp .6
2389 2394 .RS 4n
2390 2395 A path name of a file to be written. If the file specified is not found, a
2391 2396 diagnostic message is output on standard error.
2392 2397 .RE
2393 2398
2394 2399 .SH USAGE
2395 2400 .LP
2396 2401 See \fBlargefile\fR(5) for the description of the behavior of \fBls\fR when
2397 2402 encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).
2398 2403 .SH EXAMPLES
2399 2404 .LP
2400 2405 \fBExample 1 \fRViewing File Permissions
2401 2406 .sp
2402 2407 .LP
2403 2408 The following example shows how to display detailed information about a file.
2404 2409
2405 2410 .sp
2406 2411 .in +2
2407 2412 .nf
2408 2413 % ls -l file.1
2409 2414 -rw-r--r-- 1 gozer staff 206663 Mar 14 10:15 file.1
2410 2415 .fi
2411 2416 .in -2
2412 2417 .sp
2413 2418
2414 2419 .sp
2415 2420 .LP
2416 2421 The permissions string above (\fB-rw-r--r--\fR) describes that the file owner
2417 2422 has read and write permissions, the owning group has read permissions, and
2418 2423 others have read permissions.
2419 2424
2420 2425 .sp
2421 2426 .LP
2422 2427 The following example shows how to display detailed information about a
2423 2428 directory.
2424 2429
2425 2430 .sp
2426 2431 .in +2
2427 2432 .nf
2428 2433 % ls -ld test.dir
2429 2434 drwxr-xr-x 2 gozer staff 2 Mar 14 10:17 test.dir
2430 2435 .fi
2431 2436 .in -2
2432 2437 .sp
2433 2438
2434 2439 .sp
2435 2440 .LP
2436 2441 The permissions string above (\fBdrwxr-xr-x\fR) describes that the directory
2437 2442 owner has read, write, and search permissions, the owning group has read and
2438 2443 search permissions, and others have read and search permissions.
2439 2444
2440 2445 .sp
2441 2446 .LP
2442 2447 Another example of listing file permissions is as follows:
2443 2448
2444 2449 .sp
2445 2450 .in +2
2446 2451 .nf
2447 2452 % ls -l file.2
2448 2453 -rw-rwl--- 1 gozer staff 206663 Mar 14 10:47 file.2
2449 2454 .fi
2450 2455 .in -2
2451 2456 .sp
2452 2457
2453 2458 .sp
2454 2459 .LP
2455 2460 The permissions string above (\fB-rw-rwl---\fR) describes that the file owner
2456 2461 has read and write permissions, the owning group has read and write
2457 2462 permissions, and the file can be locked during access.
2458 2463
2459 2464 .LP
2460 2465 \fBExample 2 \fRDisplaying ACL Information on Files and Directories
2461 2466 .sp
2462 2467 .LP
2463 2468 The following example shows how to display verbose ACL information on a ZFS
2464 2469 file.
2465 2470
2466 2471 .sp
2467 2472 .in +2
2468 2473 .nf
2469 2474 % ls -v file.1
2470 2475 -rw-r--r-- 1 marks staff 206663 Mar 14 10:15 file.1
2471 2476 0:owner@:execute:deny
2472 2477 1:owner@:read_data/write_data/append_data/write_xattr/write_attributes
2473 2478 /write_acl/write_owner:allow
2474 2479 2:group@:write_data/append_data/execute:deny
2475 2480 3:group@:read_data:allow
2476 2481 4:everyone@:write_data/append_data/write_xattr/execute/write_attributes
2477 2482 /write_acl/write_owner:deny
2478 2483 5:everyone@:read_data/read_xattr/read_attributes/read_acl/synchronize
2479 2484 :allow
2480 2485 .fi
2481 2486 .in -2
2482 2487 .sp
2483 2488
2484 2489 .sp
2485 2490 .LP
2486 2491 The following example shows how to display compact ACL information on a ZFS
2487 2492 directory.
2488 2493
2489 2494 .sp
2490 2495 .in +2
2491 2496 .nf
2492 2497 % ls -dV test.dir
2493 2498 drwxr-xr-x 2 marks staff 2 Mar 14 10:17 test.dir
2494 2499 owner@:--------------:------:deny
2495 2500 owner@:rwxp---A-W-Co-:------:allow
2496 2501 group@:-w-p----------:------:deny
2497 2502 group@:r-x-----------:------:allow
2498 2503 everyone@:-w-p---A-W-Co-:------:deny
2499 2504 everyone@:r-x---a-R-c--s:------:allow
2500 2505 .fi
2501 2506 .in -2
2502 2507 .sp
2503 2508
2504 2509 .sp
2505 2510 .LP
2506 2511 The following example illustrates the \fBls\fR \fB-v\fR behavior when listing
2507 2512 ACL information on a UFS file.
2508 2513
2509 2514 .sp
2510 2515 .in +2
2511 2516 .nf
2512 2517 $ ls -v file.3
2513 2518 -rw-r--r-- 1 root root 2703 Mar 14 10:59 file.3
2514 2519 0:user::rw-
2515 2520 1:group::r-- #effective:r--
2516 2521 2:mask:r--
2517 2522 3:other:r--
2518 2523 .fi
2519 2524 .in -2
2520 2525 .sp
2521 2526
2522 2527 .LP
2523 2528 \fBExample 3 \fRPrinting the Names of All Files
2524 2529 .sp
2525 2530 .LP
2526 2531 The following example prints the names of all files in the current directory,
2527 2532 including those that begin with a dot (\fB\&.\fR), which normally do not print:
2528 2533
2529 2534 .sp
2530 2535 .in +2
2531 2536 .nf
2532 2537 example% \fBls -a\fR
2533 2538 .fi
2534 2539 .in -2
2535 2540 .sp
2536 2541
2537 2542 .LP
2538 2543 \fBExample 4 \fRProviding File Information
2539 2544 .sp
2540 2545 .LP
2541 2546 The following example provides file information:
2542 2547
2543 2548 .sp
2544 2549 .in +2
2545 2550 .nf
2546 2551 example% ls -aisn
2547 2552 .fi
2548 2553 .in -2
2549 2554 .sp
2550 2555
2551 2556 .sp
2552 2557 .LP
2553 2558 This command provides information on \fBa\fRll files, including those that
2554 2559 begin with a dot (\fBa\fR), the \fBi\fR-number, the memory address of the
2555 2560 i-node associated with the file\(emprinted in the left-hand column (\fBi\fR);
2556 2561 the \fBs\fRize (in blocks) of the files, printed in the column to the right of
2557 2562 the i-numbers (\fBs\fR); finally, the report is displayed in the \fBn\fRumeric
2558 2563 version of the long list, printing the \fBUID\fR (instead of user name) and
2559 2564 \fBGID\fR (instead of group name) numbers associated with the files.
2560 2565
2561 2566 .sp
2562 2567 .LP
2563 2568 When the sizes of the files in a directory are listed, a total count of blocks,
2564 2569 including indirect blocks, is printed.
2565 2570
2566 2571 .LP
2567 2572 \fBExample 5 \fRProviding Extended System Attributes Information
2568 2573 .sp
2569 2574 .in +2
2570 2575 .nf
2571 2576 example% ls -/ c file (extended system attribute in compact mode)
2572 2577 -rw-r--r-- 1 root root 0 May 10 14:17 file
2573 2578 {AHRSadim-u--}
2574 2579 .fi
2575 2580 .in -2
2576 2581 .sp
2577 2582
2578 2583 .sp
2579 2584 .LP
2580 2585 In this example, \fBav_quarantined\fR, \fBoffline\fR, and \fBsparse\fR
2581 2586 are not set.
2582 2587 .sp
2583 2588 .in +2
2584 2589 .nf
2585 2590 example% ls -/ v file (extended system attribute in verbose mode)
2586 2591 -rw-r--r-- 1 root root 0 May 10 14:17 file
2587 2592 {archive,hidden,readonly,system,\e
2588 2593 appendonly,nodump,immutable,av_modified,\e
2589 2594 noav_quarantined,nounlink,nooffline,\e
2590 2595 nosparse}
2591 2596
2592 2597 example% ls -/ v file (no extended system attribute)
2593 2598 -rw-r--r-- 1 root staff 0 May 16 14:48 file
2594 2599 {}
2595 2600
2596 2601 example% ls -/ c file (extended system attribute
2597 2602 supported file system)
2598 2603
2599 2604 -rw-r--r-- 1 root staff 3 Jun 4 22:04 file
2600 2605 {A------m----}
2601 2606 .fi
2602 2607 .in -2
2603 2608 .sp
2604 2609
2605 2610 .sp
2606 2611 .LP
2607 2612 \fBarchive\fR and \fBav_modified\fR attributes are set by default on an
2608 2613 extended system attribute supported file.
2609 2614 .sp
2610 2615 .in +2
2611 2616 .nf
2612 2617 example% ls -/ c -%crtime file
2613 2618
2614 2619 -rw-r--r-- root root 0 May 10 14:17 file
2615 2620 {AHRSadim-u--}
2616 2621 .fi
2617 2622 .in -2
2618 2623 .sp
2619 2624
2620 2625 .sp
2621 2626 .LP
2622 2627 This example displays the timestamp as the creation time:
2623 2628 .sp
2624 2629 .in +2
2625 2630 .nf
2626 2631 example% ls -l -%all file
2627 2632 -rw-r--r-- 1 root root 0 May 10 14:17 file
2628 2633 timestamp: atime Jun 14 08:47:37 2007
2629 2634 timestamp: ctime May 10 14:20:23 2007
2630 2635 timestamp: mtime May 10 14:17:56 2007
2631 2636 timestamp: crtime May 10 14:17:56 2007
2632 2637
2633 2638 example% ls -%crtime -tl file*
2634 2639
2635 2640 -rw-r--r-- 1 foo staff 3 Jun 4 22:04 file1
2636 2641 -rw-r--r-- 1 root root 0 May 10 14:17 file
2637 2642 -rw-r--r-- 1 foo staff 0 May 9 13:49 file.1
2638 2643 .fi
2639 2644 .in -2
2640 2645 .sp
2641 2646
2642 2647 .sp
2643 2648 .LP
2644 2649 In this example the files are sorted by creation time.
2645 2650 .SH ENVIRONMENT VARIABLES
2646 2651 .LP
2647 2652 See \fBenviron\fR(5) for descriptions of the following environment variables
2648 2653 that affect the execution of \fBls\fR: \fBLANG\fR, \fBLC_ALL\fR,
2649 2654 \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, \fBLC_TIME\fR, \fBLC_MESSAGES\fR,
2650 2655 \fBNLSPATH\fR, and \fBTZ\fR.
2651 2656 .sp
2652 2657 .ne 2
2653 2658 .na
2654 2659 \fB\fBCOLUMNS\fR\fR
2655 2660 .ad
2656 2661 .sp .6
2657 2662 .RS 4n
2658 2663 Determines the user's preferred column position width for writing multiple
2659 2664 text-column output. If this variable contains a string representing a decimal
2660 2665 integer, the \fBls\fR utility calculates how many path name text columns to
2661 2666 write (see \fB-C\fR) based on the width provided. If \fBCOLUMNS\fR is not set
2662 2667 or is invalid, 80 is used. The column width chosen to write the names of files
2663 2668 in any given directory is constant. File names are not be truncated to fit into
2664 2669 the multiple text-column output.
2665 2670 .RE
2666 2671
2667 2672 .sp
2668 2673 .ne 2
2669 2674 .na
2670 2675 \fB\fBLS_COLORS\fR\fR
2671 2676 .ad
2672 2677 .sp .6
2673 2678 .RS 4n
2674 2679 Determines the coloring scheme used when displaying color output. If not set
2675 2680 and color output is specified, a default scheme is used. If TERM is not set, no
2676 2681 color output is used.
2677 2682 .RE
2678 2683
2679 2684 .sp
2680 2685 .ne 2
2681 2686 .na
2682 2687 \fB\fBTERM\fR\fR
2683 2688 .ad
2684 2689 .sp .6
2685 2690 .RS 4n
2686 2691 Determine the terminal type. If this variable is unset or NULL, no color output
2687 2692 is generated regardless of the value of the --color option.
2688 2693 .RE
2689 2694
2690 2695 .SH EXIT STATUS
2691 2696 .ne 2
2692 2697 .na
2693 2698 \fB\fB0\fR\fR
2694 2699 .ad
2695 2700 .RS 6n
2696 2701 All information was written successfully.
2697 2702 .RE
2698 2703
2699 2704 .sp
2700 2705 .ne 2
2701 2706 .na
2702 2707 \fB\fB>0\fR\fR
2703 2708 .ad
2704 2709 .RS 6n
2705 2710 An error occurred.
2706 2711 .RE
2707 2712
2708 2713 .SH FILES
2709 2714 .ne 2
2710 2715 .na
2711 2716 \fB\fB/etc/group\fR\fR
2712 2717 .ad
2713 2718 .sp .6
2714 2719 .RS 4n
2715 2720 group IDs for \fBls\fR \fB-l\fR and \fBls\fR \fB-g\fR
2716 2721 .RE
2717 2722
2718 2723 .sp
2719 2724 .ne 2
2720 2725 .na
2721 2726 \fB\fB/etc/passwd\fR\fR
2722 2727 .ad
2723 2728 .sp .6
2724 2729 .RS 4n
2725 2730 user IDs for \fBls\fR \fB-l\fR and \fBls\fR \fB-o\fR
2726 2731 .RE
2727 2732
2728 2733 .sp
2729 2734 .ne 2
2730 2735 .na
2731 2736 \fB\fB/usr/share/lib/terminfo/?/*\fR\fR
2732 2737 .ad
2733 2738 .sp .6
2734 2739 .RS 4n
2735 2740 terminal information database
2736 2741 .RE
2737 2742
2738 2743 .SH ATTRIBUTES
2739 2744 .LP
2740 2745 See \fBattributes\fR(5) for descriptions of the following attributes:
2741 2746 .SS "/usr/bin/ls"
2742 2747
2743 2748 .TS
2744 2749 box;
2745 2750 c | c
2746 2751 l | l .
2747 2752 ATTRIBUTE TYPE ATTRIBUTE VALUE
2748 2753 _
2749 2754 CSI Enabled
2750 2755 _
2751 2756 Interface Stability Committed
2752 2757 _
2753 2758 Standard See below.
2754 2759 .TE
2755 2760
2756 2761 .sp
2757 2762 .LP
2758 2763 For all options except \fB-A\fR, \fB-b\fR, \fB-e\fR, \fB-E,\fR \fB-h\fR,
2759 2764 \fB-S\fR, U \fB-v\fR, \fB-V\fR, \fB-@\fR, \fB-/\fR, \fB-%\fR, \fB--all\fR,
2760 2765 \fB--almost-all\fR, \fB--block-size\fR, \fB--classify\fR, \fB--color\fR,
2761 2766 \fB--colour\fR, \fB--dereference\fR, \fB--dereference-command-line\fR,
2762 2767 \fB--escape\fR, \fB--file-type\fR, \fB--full-time\fR, \fB--human-readable\fR,
2763 2768 \fB--ignore-backups\fR, \fB--inode\fR, \fB--no-group\fR,
2764 2769 \fB--numeric-uid-gid\fR, \fB--reverse\fR, \fB--recursive\fR, \fB--si\fR,
2765 2770 \fB--size\fR, and \fB--time-style\fR, see \fBstandards\fR(5).
2766 2771 .SS "/usr/xpg4/bin/ls"
2767 2772
2768 2773 .TS
2769 2774 box;
2770 2775 c | c
2771 2776 l | l .
2772 2777 ATTRIBUTE TYPE ATTRIBUTE VALUE
2773 2778 _
2774 2779 CSI Enabled
2775 2780 _
2776 2781 Interface Stability Committed
2777 2782 _
2778 2783 Standard See below.
2779 2784 .TE
2780 2785
2781 2786 .sp
2782 2787 .LP
2783 2788 For all options except \fB-A\fR, \fB-b\fR, \fB-e\fR, \fB-E,\fR \fB-h\fR,
2784 2789 \fB-S\fR, U \fB-v\fR, \fB-V\fR, \fB-@\fR, \fB-/\fR, \fB-%\fR, \fB--all\fR,
2785 2790 \fB--almost-all\fR, \fB--block-size\fR, \fB--classify\fR, \fB--color\fR,
2786 2791 \fB--colour\fR, \fB--dereference\fR, \fB--dereference-command-line\fR,
2787 2792 \fB--escape\fR, \fB--file-type\fR, \fB--full-time\fR, \fB--human-readable\fR,
2788 2793 \fB--ignore-backups\fR, \fB--inode\fR, \fB--no-group\fR,
2789 2794 \fB--numeric-uid-gid\fR, \fB--reverse\fR, \fB--recursive\fR, \fB--si\fR,
2790 2795 \fB--size\fR, and \fB--time-style\fR, see \fBstandards\fR(5).
2791 2796 .SS "/usr/xpg6/bin/ls"
2792 2797
2793 2798 .TS
2794 2799 box;
2795 2800 c | c
2796 2801 l | l .
2797 2802 ATTRIBUTE TYPE ATTRIBUTE VALUE
2798 2803 _
2799 2804 CSI Enabled
2800 2805 _
2801 2806 Interface Stability Committed
2802 2807 _
2803 2808 Standard See below.
2804 2809 .TE
2805 2810
2806 2811 .sp
2807 2812 .LP
2808 2813 For all options except \fB-A\fR, \fB-b\fR, \fB-e\fR, \fB-E,\fR \fB-h\fR,
2809 2814 \fB-S\fR, U \fB-v\fR, \fB-V\fR, \fB-@\fR, \fB-/\fR, \fB-%\fR, \fB--all\fR,
|
↓ open down ↓ |
1608 lines elided |
↑ open up ↑ |
2810 2815 \fB--almost-all\fR, \fB--block-size\fR, \fB--classify\fR, \fB--color\fR,
2811 2816 \fB--colour\fR, \fB--dereference\fR, \fB--dereference-command-line\fR,
2812 2817 \fB--escape\fR, \fB--file-type\fR, \fB--full-time\fR, \fB--human-readable\fR,
2813 2818 \fB--ignore-backups\fR, \fB--inode\fR, \fB--no-group\fR,
2814 2819 \fB--numeric-uid-gid\fR, \fB--reverse\fR, \fB--recursive\fR, \fB--si\fR,
2815 2820 \fB--size\fR, and \fB--time-style\fR, see \fBstandards\fR(5).
2816 2821 .SH SEE ALSO
2817 2822 .LP
2818 2823 \fBchmod\fR(1), \fBcp\fR(1), \fBsetfacl\fR(1), \fBfgetattr\fR(3C),
2819 2824 \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)
2825 +\fBenviron\fR(5), \fBfsattr\fR(5), \fBlargefile\fR(5), \fBstandards\fR(5),
2826 +\fBidmapd\fR(1M)
2821 2827 .SH NOTES
2822 2828 .LP
2823 2829 Unprintable characters in file names can confuse the columnar output options.
2824 2830 .sp
2825 2831 .LP
2826 2832 The total block count is incorrect if there are hard links among the files.
2827 2833 .sp
2828 2834 .LP
2829 2835 The sort order of \fBls\fR output is affected by the locale and can be
2830 2836 overridden by the \fBLC_COLLATE\fR environment variable. For example, if
2831 2837 \fBLC_COLLATE\fR equals \fBC\fR, dot files appear first, followed by names
2832 2838 beginning with upper-case letters, then followed by names beginning with
2833 2839 lower-case letters. But if \fBLC_COLLATE\fR equals \fBen_US.ISO8859-1\fR, then
2834 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/.
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX