| ls.1 (57695) | ls.1 (61178) |
|---|---|
| 1.\" Copyright (c) 1980, 1990, 1991, 1993, 1994 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" This code is derived from software contributed to Berkeley by 5.\" the Institute of Electrical and Electronics Engineers, Inc. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions --- 19 unchanged lines hidden (view full) --- 28.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 29.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 30.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 31.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 33.\" SUCH DAMAGE. 34.\" 35.\" @(#)ls.1 8.7 (Berkeley) 7/29/94 | 1.\" Copyright (c) 1980, 1990, 1991, 1993, 1994 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" This code is derived from software contributed to Berkeley by 5.\" the Institute of Electrical and Electronics Engineers, Inc. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions --- 19 unchanged lines hidden (view full) --- 28.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 29.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 30.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 31.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 33.\" SUCH DAMAGE. 34.\" 35.\" @(#)ls.1 8.7 (Berkeley) 7/29/94 |
| 36.\" $FreeBSD: head/bin/ls/ls.1 57695 2000-03-02 14:54:02Z sheldonh $ | 36.\" $FreeBSD: head/bin/ls/ls.1 61178 2000-06-02 14:53:42Z joe $ |
| 37.\" 38.Dd July 29, 1994 39.Dt LS 1 40.Os 41.Sh NAME 42.Nm ls 43.Nd list directory contents 44.Sh SYNOPSIS 45.Nm ls | 37.\" 38.Dd July 29, 1994 39.Dt LS 1 40.Os 41.Sh NAME 42.Nm ls 43.Nd list directory contents 44.Sh SYNOPSIS 45.Nm ls |
| 46.Op Fl ABCFHLPRTWabcdfgiklnoqrstu1 | 46.Op Fl ABCFGHLPRTWabcdfgiklnoqrstu1 |
| 47.Op Ar file ... 48.Sh DESCRIPTION 49For each operand that names a 50.Ar file 51of a type other than 52directory, 53.Nm 54displays its name as well as any requested, --- 30 unchanged lines hidden (view full) --- 85Display a slash (/) immediately after each pathname 86that is a directory, an asterisk (*) after each that is 87executable, 88an at sign (@) after each symbolic link, 89an equals sign (=) after each socket, 90a percent sign (%) after each whiteout, 91and a vertical bar (|) after each that is a 92.Tn FIFO . | 47.Op Ar file ... 48.Sh DESCRIPTION 49For each operand that names a 50.Ar file 51of a type other than 52directory, 53.Nm 54displays its name as well as any requested, --- 30 unchanged lines hidden (view full) --- 85Display a slash (/) immediately after each pathname 86that is a directory, an asterisk (*) after each that is 87executable, 88an at sign (@) after each symbolic link, 89an equals sign (=) after each socket, 90a percent sign (%) after each whiteout, 91and a vertical bar (|) after each that is a 92.Tn FIFO . |
| 93.It Fl G 94Use ANSI color sequences to distinguish file types. (See 95.Ev LSCOLORS 96below.) In addition to those mentioned above in 97.Fl F , 98some extra attributes (setuid bit set, etc.) are also displayed. |
|
| 93.It Fl H 94Symbolic links on the command line are followed. This option is assumed if 95none of the 96.Fl F , 97.Fl d , 98or 99.Fl l 100options are specified. --- 280 unchanged lines hidden (view full) --- 381based on the width provided. 382(See 383.Fl C . ) 384.It Ev TZ 385The timezone to use when displaying dates. 386See 387.Xr environ 7 388for more information. | 99.It Fl H 100Symbolic links on the command line are followed. This option is assumed if 101none of the 102.Fl F , 103.Fl d , 104or 105.Fl l 106options are specified. --- 280 unchanged lines hidden (view full) --- 387based on the width provided. 388(See 389.Fl C . ) 390.It Ev TZ 391The timezone to use when displaying dates. 392See 393.Xr environ 7 394for more information. |
| 395.It LSCOLORS 396The value of this variable describes what color to use for which 397attribute when the color output 398.Pq Fl G 399is specified. This string is a concatenation of pairs of the format 400.Sy fb , 401where 402.Sy f 403is the foreground color and 404.Sy b 405is the background color. 406.Pp 407The color designators are as follows: 408.Pp 409.Bl -tag -width 4n -offset indent -compact 410.It Sy 0 411black 412.It Sy 1 413red 414.It Sy 2 415green 416.It Sy 3 417yellow 418.It Sy 4 419blue 420.It Sy 5 421magenta 422.It Sy 6 423cyan 424.It Sy 7 425white 426.It Sy x 427default foreground or background 428.El 429.Pp 430(Note: the above are standard ANSI colors. The actual display may 431differ depending on the color capabilities of your terminal.) 432.Pp 433The order of the attributes are as follows: 434.Pp 435.Bl -enum -offset indent -compact 436.It 437directory 438.It 439symbolic link 440.It 441socket 442.It 443pipe 444.It 445executable 446.It 447block special 448.It 449character special 450.It 451executable with setuid bit set 452.It 453executable with setgid bit set 454.It 455directory writable to others, with sticky bit 456.It 457directory writable to others, without sticky bit 458.El 459.Pp 460The default is "4x5x2x3x1x464301060203", i.e., blue foreground and 461default background for regular directories, black foreground and red 462background for setuid executables, etc. |
|
| 389.It Ev LS_COLWIDTHS 390If this variable is set, it is considered to be a 391colon-delimited list of minimum column widths. Unreasonable 392and insufficient widths are ignored (thus zero signifies 393a dynamically sized column). Not all 394columns have changeable widths. The fields are, 395in order: inode, block count, number of links, user name, 396group name, flags, file size, file name. --- 25 unchanged lines hidden --- | 463.It Ev LS_COLWIDTHS 464If this variable is set, it is considered to be a 465colon-delimited list of minimum column widths. Unreasonable 466and insufficient widths are ignored (thus zero signifies 467a dynamically sized column). Not all 468columns have changeable widths. The fields are, 469in order: inode, block count, number of links, user name, 470group name, flags, file size, file name. --- 25 unchanged lines hidden --- |