1*4da37b8eSschwarze.\" $OpenBSD: ls.1,v 1.79 2016/10/24 13:46:58 schwarze Exp $ 2af0beca9Sderaadt.\" $NetBSD: ls.1,v 1.14 1995/12/05 02:44:01 jtc Exp $ 3df930be7Sderaadt.\" 4df930be7Sderaadt.\" Copyright (c) 1980, 1990, 1991, 1993, 1994 5df930be7Sderaadt.\" The Regents of the University of California. All rights reserved. 6df930be7Sderaadt.\" 7df930be7Sderaadt.\" This code is derived from software contributed to Berkeley by 8df930be7Sderaadt.\" the Institute of Electrical and Electronics Engineers, Inc. 9df930be7Sderaadt.\" 10df930be7Sderaadt.\" Redistribution and use in source and binary forms, with or without 11df930be7Sderaadt.\" modification, are permitted provided that the following conditions 12df930be7Sderaadt.\" are met: 13df930be7Sderaadt.\" 1. Redistributions of source code must retain the above copyright 14df930be7Sderaadt.\" notice, this list of conditions and the following disclaimer. 15df930be7Sderaadt.\" 2. Redistributions in binary form must reproduce the above copyright 16df930be7Sderaadt.\" notice, this list of conditions and the following disclaimer in the 17df930be7Sderaadt.\" documentation and/or other materials provided with the distribution. 1829295d1cSmillert.\" 3. Neither the name of the University nor the names of its contributors 19df930be7Sderaadt.\" may be used to endorse or promote products derived from this software 20df930be7Sderaadt.\" without specific prior written permission. 21df930be7Sderaadt.\" 22df930be7Sderaadt.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 23df930be7Sderaadt.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 24df930be7Sderaadt.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 25df930be7Sderaadt.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 26df930be7Sderaadt.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 27df930be7Sderaadt.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 28df930be7Sderaadt.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 29df930be7Sderaadt.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 30df930be7Sderaadt.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 31df930be7Sderaadt.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32df930be7Sderaadt.\" SUCH DAMAGE. 33df930be7Sderaadt.\" 34df930be7Sderaadt.\" @(#)ls.1 8.7 (Berkeley) 7/29/94 35df930be7Sderaadt.\" 36*4da37b8eSschwarze.Dd $Mdocdate: October 24 2016 $ 37df930be7Sderaadt.Dt LS 1 38df930be7Sderaadt.Os 39df930be7Sderaadt.Sh NAME 40df930be7Sderaadt.Nm ls 41df930be7Sderaadt.Nd list directory contents 42df930be7Sderaadt.Sh SYNOPSIS 437349792aSaaron.Nm ls 449079317dSokan.Op Fl 1AaCcdFfgHhikLlmnopqRrSsTtux 45679f6f8fSsobrado.Op Ar 46df930be7Sderaadt.Sh DESCRIPTION 47df930be7SderaadtFor each operand that names a 48df930be7Sderaadt.Ar file 494337acb7Saaronof a type other than directory, 50f11c8a18Saaron.Nm 51df930be7Sderaadtdisplays its name as well as any requested, 52df930be7Sderaadtassociated information. 534337acb7SaaronFor each named directory, 54f11c8a18Saaron.Nm 55df930be7Sderaadtdisplays the names of files contained 56df930be7Sderaadtwithin that directory, as well as any requested, associated 57df930be7Sderaadtinformation. 58df930be7Sderaadt.Pp 59df930be7SderaadtIf no operands are given, the contents of the current 60df930be7Sderaadtdirectory are displayed. 61df930be7SderaadtIf more than one operand is given, 62a0eee1efSjmcnon-directory operands are displayed first; directory 63a0eee1efSjmcand non-directory operands are sorted separately and in 64df930be7Sderaadtlexicographical order. 65a40a3c37SjmcBy default, 66a40a3c37Sjmc.Nm 67a40a3c37Sjmclists one entry per line to standard 68a40a3c37Sjmcoutput; the exceptions are to terminals or when the 69a40a3c37Sjmc.Fl C , 70a40a3c37Sjmc.Fl m , 71a40a3c37Sjmcor 72a40a3c37Sjmc.Fl x 73a40a3c37Sjmcoptions are specified. 74df930be7Sderaadt.Pp 7518611b21SaaronThe options are as follows: 76f1ba3473Saaron.Bl -tag -width Ds 77b8d89680Sjmc.It Fl 1 78b8d89680Sjmc(The numeric digit 79b8d89680Sjmc.Dq one . ) 80b8d89680SjmcForce output to be one entry per line. 81b8d89680SjmcThis is the default when 82b8d89680Sjmcoutput is not to a terminal. 83df930be7Sderaadt.It Fl A 84df930be7SderaadtList all entries except for 85b8d89680Sjmc.Sq \&. 86df930be7Sderaadtand 87b8d89680Sjmc.Sq \&.. . 88a3542fadSaaronAlways set for the superuser. 89b8d89680Sjmc.It Fl a 90b8d89680SjmcInclude directory entries whose names begin with a 91b8d89680Sjmcdot 92b8d89680Sjmc.Pq Sq \&. . 93df930be7Sderaadt.It Fl C 94df930be7SderaadtForce multi-column output; this is the default when output is to a terminal. 95b8d89680Sjmc.It Fl c 96b8d89680SjmcUse time file's status was last changed instead of last modification 97b8d89680Sjmctime for sorting 98b8d89680Sjmc.Pq Fl t 99b8d89680Sjmcor printing 10063f87300Sjmc.Pf ( Fl g , l , 10163f87300Sjmcor 10263f87300Sjmc.Fl n ) . 103b8d89680Sjmc.It Fl d 104b8d89680SjmcDirectories are listed as plain files (not searched recursively) and 105b8d89680Sjmcsymbolic links in the argument list are not indirected through. 106df930be7Sderaadt.It Fl F 107b3119326SaaronDisplay a slash 108b3119326Saaron.Pq Sq / 109b3119326Saaronimmediately after each pathname that is a directory, 110b3119326Saaronan asterisk 111b8d89680Sjmc.Pq Sq * 112b3119326Saaronafter each that is executable, 113b3119326Saaronan at sign 114b3119326Saaron.Pq Sq @ 115b3119326Saaronafter each symbolic link, 116b3119326Saaronan equal sign 117b3119326Saaron.Pq Sq = 118b3119326Saaronafter each socket, 119b3119326Saaronand a vertical bar 120b3119326Saaron.Pq Sq \&| 121cdba0873Saaronafter each that is a FIFO. 122df930be7Sderaadt.It Fl f 123df930be7SderaadtOutput is not sorted. 1247f5741ceSjmcThis option implies 125cad8a15cSsobrado.Fl a . 126404227c8Sderaadt.It Fl g 127a40a3c37SjmcList in long format as in 128947f7ba6Smillert.Fl l , 129947f7ba6Smillertexcept that the owner is not printed. 1309079317dSokan.It Fl H 1319079317dSokanFollow symbolic links specified on the command line. 132923c3fdeSjmcThis is the default behaviour when none of the 1339079317dSokan.Fl d , F , 1349079317dSokanor 1359079317dSokan.Fl l 1369079317dSokanoptions are specified. 13791ea06e0Stedu.It Fl h 13891ea06e0SteduWhen used with a long format 13991ea06e0Steduoption, use unit suffixes: Byte, Kilobyte, Megabyte, Gigabyte, Terabyte, 140b8d89680SjmcPetabyte, and Exabyte in order to reduce the number of digits to four or fewer 14191ea06e0Steduusing powers of 2 for sizes (K=1024, M=1048576, etc.). 142df930be7Sderaadt.It Fl i 143a2d58deaSaaronFor each file, print its inode number. 144df930be7Sderaadt.It Fl k 145df930be7SderaadtModifies the 146df930be7Sderaadt.Fl s 1478c926583Saaronoption, causing the sizes to be reported in kilobytes. 1488c926583SaaronOverrides any value specified by the 149a2d58deaSaaron.Ev BLOCKSIZE 150a2d58deaSaaronenvironment variable. 151b8d89680Sjmc.It Fl L 152b8d89680SjmcIf argument is a symbolic link, evaluate the file information and file type 153b8d89680Sjmcto be those of the file referenced by the link, and not the link itself; 154b8d89680Sjmchowever, 155b8d89680Sjmc.Nm 156b8d89680Sjmcwrites the name of the link itself and not the file referenced by the link. 157df930be7Sderaadt.It Fl l 158b3119326Saaron(The lowercase letter 159e4c1364eSjmc.Dq ell . ) 160a2d58deaSaaronList in long format (see below). 1617c8121b0SjmcA total sum of all file 162df930be7Sderaadtsizes is output on a line before the long listing. 1637c8121b0SjmcOutput is one entry per line. 164b94f2f87Sderaadt.It Fl m 165b94f2f87SderaadtStream output format; list files across the page, separated by commas. 166404227c8Sderaadt.It Fl n 167404227c8SderaadtList in long format as in 168404227c8Sderaadt.Fl l , 169404227c8Sderaadtbut retain user and group IDs in a numeric format. 170a40a3c37SjmcThe output of 171a40a3c37Sjmc.Fl gn 172a40a3c37Sjmcand 173a40a3c37Sjmc.Fl ng 174a40a3c37Sjmcis identical: 175a40a3c37Sjmca long listing with numerical group ID, 176a40a3c37Sjmcand no numerical user ID. 177a40a3c37SjmcThe output of 178a40a3c37Sjmc.Fl ln 179a40a3c37Sjmcand 180a40a3c37Sjmc.Fl \&nl 181a40a3c37Sjmcis identical: 182a40a3c37Sjmca long listing with numerical group and user ID. 183df930be7Sderaadt.It Fl o 184a2d58deaSaaronInclude the file flags in a long format 18563f87300Sjmc.Pf ( Fl g , l , 18663f87300Sjmcor 18763f87300Sjmc.Fl n ) 188404227c8Sderaadtoutput. 18999316626Sespie.It Fl p 190a2d58deaSaaronDisplay a slash 191b8d89680Sjmc.Pq Sq / 192a2d58deaSaaronimmediately after each pathname that is a directory. 193df930be7Sderaadt.It Fl q 194df930be7SderaadtForce printing of non-graphic characters in file names as 195b3119326Saaronthe character 196c1ed470cSjmc.Sq \&? ; 197b3119326Saaronthis is the default when output is to a terminal. 198b8d89680Sjmc.It Fl R 199b8d89680SjmcRecursively list subdirectories encountered. 200df930be7Sderaadt.It Fl r 201df930be7SderaadtReverse the order of the sort to get reverse 202df930be7Sderaadtlexicographical order or the smallest or oldest entries first. 203b8d89680Sjmc.It Fl S 204b8d89680SjmcSort by size, largest file first. 205df930be7Sderaadt.It Fl s 206a2d58deaSaaronDisplay the number of file system blocks actually used by each file, 2078c926583Saaronwhere partial units are rounded up to the next integer value. 2088c926583SaaronBlocks are 512 bytes unless overridden by the 209a2d58deaSaaron.Fl k 210a2d58deaSaaronflag or 211a2d58deaSaaron.Ev BLOCKSIZE 212a2d58deaSaaronenvironment variable. 213b8d89680Sjmc.It Fl T 214b8d89680SjmcDisplay complete time information for the file, including 215b8d89680Sjmcmonth, day, hour, minute, second, and year. 216b8d89680SjmcThis option has no effect unless one of the long format 21763f87300Sjmc.Pf ( Fl g , l , 21863f87300Sjmcor 21963f87300Sjmc.Fl n ) 220b8d89680Sjmcoptions is also specified. 221df930be7Sderaadt.It Fl t 222df930be7SderaadtSort by time modified (most recently modified 223a2d58deaSaaronfirst) before sorting the operands in lexicographical 224df930be7Sderaadtorder. 225df930be7Sderaadt.It Fl u 226a2d58deaSaaronUse file's last access time 227a2d58deaSaaroninstead of last modification time 228a2d58deaSaaronfor sorting 229df930be7Sderaadt.Pq Fl t 230df930be7Sderaadtor printing 23163f87300Sjmc.Pf ( Fl g , l , 23263f87300Sjmcor 23363f87300Sjmc.Fl n ) . 234a2d58deaSaaron.It Fl x 235a2d58deaSaaronMulti-column output sorted across the page rather than down the page. 236df930be7Sderaadt.El 237df930be7Sderaadt.Pp 238a40a3c37SjmcIt is not an error to specify more than one of 239a40a3c37Sjmcthe following mutually exclusive options: 240df930be7Sderaadt.Fl 1 , 241df930be7Sderaadt.Fl C , 242947f7ba6Smillert.Fl g , 243404227c8Sderaadt.Fl l , 2447c8121b0Sjmc.Fl m , 245a40a3c37Sjmc.Fl n , 246df930be7Sderaadtand 247a40a3c37Sjmc.Fl x ; 248db1c0769Sjmcand 249a40a3c37Sjmc.Fl c , 250db1c0769Sjmc.Fl f , 251a40a3c37Sjmc.Fl S , 252a40a3c37Sjmc.Fl t , 253a40a3c37Sjmcand 254db1c0769Sjmc.Fl u . 255a40a3c37SjmcWhere more than one option is specified from the same 256a40a3c37Sjmcmutually exclusive group, 257a40a3c37Sjmcthe last option given overrides the others, 258a40a3c37Sjmcexcept that 259a40a3c37Sjmc.Fl l 260a40a3c37Sjmcalways overrides 261a40a3c37Sjmc.Fl g ; 262a40a3c37Sjmcand 263a40a3c37Sjmc.Fl f 264a40a3c37Sjmcalways overrides 265a40a3c37Sjmc.Fl c , 266a40a3c37Sjmc.Fl S , 267a40a3c37Sjmc.Fl t , 268a40a3c37Sjmcand 269a40a3c37Sjmc.Fl u . 270df930be7Sderaadt.Ss The Long Format 271df930be7SderaadtIf the 27263f87300Sjmc.Fl g , 27363f87300Sjmc.Fl l , 274404227c8Sderaadtor 275404227c8Sderaadt.Fl n 276404227c8Sderaadtoptions are given, the following information 277df930be7Sderaadtis displayed for each file: 278a2d58deaSaaronmode, 279a2d58deaSaaronnumber of links, 2809f9ed71fSjmcowner (though not for 28163f87300Sjmc.Fl g ) , 2829f9ed71fSjmcgroup, 283a2d58deaSaaronsize in bytes, 284a2d58deaSaarontime of last modification 285a2d58deaSaaron.Pq Dq mmm dd HH:MM , 286a2d58deaSaaronand the pathname. 287a2d58deaSaaronIn addition, for each directory whose contents are displayed, the first 288a2d58deaSaaronline displayed is the total number of blocks used by the files in the 2898c926583Saarondirectory. 2908c926583SaaronBlocks are 512 bytes unless overridden by the 291a2d58deaSaaron.Fl k 292a2d58deaSaaronoption or 293a2d58deaSaaron.Ev BLOCKSIZE 294a2d58deaSaaronenvironment variable. 295df930be7Sderaadt.Pp 2967796b8ddSpjanzenIf the owner or group name is not a known user or group name, respectively, 297404227c8Sderaadtor the 298404227c8Sderaadt.Fl n 299a2d58deaSaaronoption is given, the numeric ID is displayed. 300df930be7Sderaadt.Pp 301df930be7SderaadtIf the file is a character special or block special file, 302df930be7Sderaadtthe major and minor device numbers for the file are displayed 303a2d58deaSaaronin the size field. 304a2d58deaSaaron.Pp 305a2d58deaSaaronIf the 306a2d58deaSaaron.Fl T 307a2d58deaSaaronoption is given, the time of last modification is displayed using the 308a2d58deaSaaronformat 309dc2cf4e4Sjmc.Dq mmm dd HH:MM:SS ccyy . 310a2d58deaSaaron.Pp 311a2d58deaSaaronIf the file is a symbolic link, the pathname of the 312df930be7Sderaadtlinked-to file is preceded by 3134457c270Smillert.Dq \-\*(Gt . 314df930be7Sderaadt.Pp 315404227c8SderaadtThe file mode printed under the 31663f87300Sjmc.Fl g , 31763f87300Sjmc.Fl l , 318404227c8Sderaadtor 319404227c8Sderaadt.Fl n 320582c0f4fSjmcoptions consists of the entry type, owner permissions, group permissions, 321582c0f4fSjmcand other permissions. 3228c926583SaaronThe entry type character describes the type of file, as follows: 323df930be7Sderaadt.Pp 324df930be7Sderaadt.Bl -tag -width 4n -offset indent -compact 325fa97a36eSjmc.It Sy \- 326fa97a36eSjmcregular file 327df930be7Sderaadt.It Sy b 328f81d96dfSaaronblock special file 329df930be7Sderaadt.It Sy c 330f81d96dfSaaroncharacter special file 331df930be7Sderaadt.It Sy d 332f81d96dfSaarondirectory 333df930be7Sderaadt.It Sy l 334f81d96dfSaaronsymbolic link 335fa97a36eSjmc.It Sy p 336fa97a36eSjmcFIFO 337df930be7Sderaadt.It Sy s 338f81d96dfSaaronsocket link 339df930be7Sderaadt.El 340df930be7Sderaadt.Pp 341df930be7SderaadtThe next three fields 342df930be7Sderaadtare three characters each: 343df930be7Sderaadtowner permissions, 344df930be7Sderaadtgroup permissions, and 345df930be7Sderaadtother permissions. 346df930be7SderaadtEach field has three character positions: 347a2d58deaSaaron.Pp 348a2d58deaSaaron.Bl -enum -offset indent -compact 349df930be7Sderaadt.It 350df930be7SderaadtIf 351df930be7Sderaadt.Sy r , 352df930be7Sderaadtthe file is readable; if 353df930be7Sderaadt.Sy \- , 354df930be7Sderaadtit is not readable. 355df930be7Sderaadt.It 356df930be7SderaadtIf 357df930be7Sderaadt.Sy w , 358df930be7Sderaadtthe file is writable; if 359df930be7Sderaadt.Sy \- , 360df930be7Sderaadtit is not writable. 361df930be7Sderaadt.It 362df930be7SderaadtThe first of the following that applies: 363df930be7Sderaadt.Bl -tag -width 4n -offset indent 364df930be7Sderaadt.It Sy S 365df930be7SderaadtIf in the owner permissions, the file is not executable and 366df930be7Sderaadtset-user-ID mode is set. 367df930be7SderaadtIf in the group permissions, the file is not executable 368df930be7Sderaadtand set-group-ID mode is set. 369df930be7Sderaadt.It Sy s 370df930be7SderaadtIf in the owner permissions, the file is executable 371df930be7Sderaadtand set-user-ID mode is set. 372df930be7SderaadtIf in the group permissions, the file is executable 373b4f1a09cSjmcand set-group-ID mode is set. 374df930be7Sderaadt.It Sy x 375df930be7SderaadtThe file is executable or the directory is 376df930be7Sderaadtsearchable. 377df930be7Sderaadt.It Sy \- 378df930be7SderaadtThe file is neither readable, writable, executable, 379a2d58deaSaaronnor set-user-ID, nor set-group-ID, nor sticky (see below). 380df930be7Sderaadt.El 381df930be7Sderaadt.Pp 382df930be7SderaadtThese next two apply only to the third character in the last group 383a2d58deaSaaron(other permissions): 384df930be7Sderaadt.Bl -tag -width 4n -offset indent 385df930be7Sderaadt.It Sy T 386df930be7SderaadtThe sticky bit is set 387df930be7Sderaadt(mode 388df930be7Sderaadt.Li 1000 ) , 389a2d58deaSaaronbut neither executable nor searchable (see 390df930be7Sderaadt.Xr chmod 1 391df930be7Sderaadtor 392a2d58deaSaaron.Xr sticky 8 ) . 393df930be7Sderaadt.It Sy t 394df930be7SderaadtThe sticky bit is set (mode 395df930be7Sderaadt.Li 1000 ) , 396a2d58deaSaaronand is searchable or executable 397a2d58deaSaaron(see 398df930be7Sderaadt.Xr chmod 1 399df930be7Sderaadtor 400a2d58deaSaaron.Xr sticky 8 ) . 401df930be7Sderaadt.El 402df930be7Sderaadt.El 403df930be7Sderaadt.Pp 40453165553SespieIn addition, if the 40553165553Sespie.Fl o 406a2d58deaSaaronoption is specified, the file flags (see 407f81d96dfSaaron.Xr chflags 1 ) 408a2d58deaSaaronare displayed as comma-separated strings in front of the file size, 409f81d96dfSaaronabbreviated as follows: 410f81d96dfSaaron.Pp 41115d6261aSderaadt.Bl -tag -width 8n -offset indent -compact 412a2d58deaSaaron.It \&- 41353165553Sespieno flags 414609f1f5eSjmc.It arch 415609f1f5eSjmcarchived 416609f1f5eSjmc.It nodump 417609f1f5eSjmcdo not dump 418609f1f5eSjmc.It sappnd 419609f1f5eSjmcsystem append-only 420609f1f5eSjmc.It schg 421609f1f5eSjmcsystem immutable 42253165553Sespie.It uappnd 42353165553Sespieuser append-only 42453165553Sespie.It uchg 42553165553Sespieuser immutable 42653165553Sespie.El 42741371632Sderaadt.Sh ENVIRONMENT 428df930be7Sderaadt.Bl -tag -width BLOCKSIZE 429df930be7Sderaadt.It Ev BLOCKSIZE 430af0beca9SderaadtIf the environment variable 431df930be7Sderaadt.Ev BLOCKSIZE 432df930be7Sderaadtis set, and the 433df930be7Sderaadt.Fl k 434df930be7Sderaadtoption is not specified, the block counts 435df930be7Sderaadt(see 436df930be7Sderaadt.Fl s ) 437df930be7Sderaadtwill be displayed in units of that size block. 43823ebb1e2Sbentley.It Ev COLUMNS 4397220d8ecSbentleyIf set to a positive integer, 4407220d8ecSbentleyoutput is formatted to the given width in columns. 4417220d8ecSbentleyOtherwise, 4427220d8ecSbentley.Nm 4437220d8ecSbentleydefaults to the terminal width, or 80 columns if the output is not a terminal. 444b6203726Sschwarze.It Ev LC_CTYPE 445*4da37b8eSschwarzeThe character encoding 446*4da37b8eSschwarze.Xr locale 1 . 447*4da37b8eSschwarzeIt decides which byte sequences form characters 448*4da37b8eSschwarzeand what their display width is. 449*4da37b8eSschwarzeIf unset or set to 450*4da37b8eSschwarze.Qq C , 451*4da37b8eSschwarze.Qq POSIX , 452*4da37b8eSschwarzeor an unsupported value, non-ASCII bytes are replaced by question marks. 453df930be7Sderaadt.It Ev TZ 454df930be7SderaadtThe time zone to use when displaying dates. 455df930be7SderaadtSee 456df930be7Sderaadt.Xr environ 7 457df930be7Sderaadtfor more information. 458df930be7Sderaadt.El 45959a5f2b9Sjmc.Sh EXIT STATUS 46059a5f2b9Sjmc.Ex -std ls 461e4c1364eSjmc.Sh EXAMPLES 462ef7ec574SjaredyList the contents of the current working directory in long format: 463e4c1364eSjmc.Pp 464ef7ec574Sjaredy.Dl $ ls -l 465e4c1364eSjmc.Pp 466e4c1364eSjmcIn addition to listing the contents of the current working directory in 467e4c1364eSjmclong format, show inode numbers, file flags (see 468e4c1364eSjmc.Xr chflags 1 ) , 469ef7ec574Sjaredyand suffix each filename with a symbol representing its file type: 470e4c1364eSjmc.Pp 471ef7ec574Sjaredy.Dl $ ls -lioF 472e4c1364eSjmc.Pp 473e4c1364eSjmcList the files in 474e4c1364eSjmc.Pa /var/log , 47549e12f67Ssobradosorting the output such that the most recently modified entries are 476ef7ec574Sjaredyprinted first: 477ef7ec574Sjaredy.Pp 478ef7ec574Sjaredy.Dl $ ls -lt /var/log 479df930be7Sderaadt.Sh SEE ALSO 48086c57c4cSericj.Xr chflags 1 , 481ca961342Saaron.Xr chmod 1 , 482df930be7Sderaadt.Xr symlink 7 , 483df930be7Sderaadt.Xr sticky 8 484df930be7Sderaadt.Sh STANDARDS 485df930be7SderaadtThe 486f11c8a18Saaron.Nm 4870f3f4dbcSjmcutility is compliant with the 48899332e38Sjmc.St -p1003.1-2008 489e8de5af1Sjmcspecification, 490e8de5af1Sjmcexcept behaviour for the 491e8de5af1Sjmc.Fl o 492cad8a15cSsobradoflag differs. 493947f7ba6Smillert.Pp 4940f3f4dbcSjmcThe flags 495e8de5af1Sjmc.Op Fl hT , 496e8de5af1Sjmcas well as the 497e8de5af1Sjmc.Ev BLOCKSIZE 498e8de5af1Sjmcenvironment variable, 4990f3f4dbcSjmcare extensions to that specification. 5000f3f4dbcSjmc.Pp 501e8de5af1SjmcThe flags 502e8de5af1Sjmc.Op Fl go 503e8de5af1Sjmcare marked by 504e8de5af1Sjmc.St -p1003.1-2008 505e8de5af1Sjmcas being an X/Open System Interfaces option. 506e8de5af1Sjmc.Pp 507947f7ba6SmillertHistorically, the 508947f7ba6Smillert.Fl g 509947f7ba6Smillertflag was used to specify that the group field be included in long listings. 510947f7ba6SmillertThe group field is now automatically included in the long listing for 511947f7ba6Smillertfiles and the meaning of the 512947f7ba6Smillert.Fl g 513947f7ba6Smillertflag has been changed in order to be compatible with the 51499332e38Sjmc.St -p1003.1-2008 515df930be7Sderaadtspecification. 516e3085f41Saaron.Sh HISTORY 517e3085f41SaaronAn 518e3085f41Saaron.Nm 519e3085f41Saaronutility appeared in 5203a0c2a3aSschwarze.At v1 . 521