FreeBSD Manual Pages
LR(1) General Commands Manual LR(1) NAME lr -- list files, recursively SYNOPSIS lr [-0 | -F | -l [-TA | -TC | -TM] | -S | -f fmt] [-B | -D] [-H | -L] [-1AGPQXdhsx] [-U | -W | -o ord] [-q] [-e regex] [-t test] [-C [color:]path] path ... DESCRIPTION lr is a versatile tool to generate file listings with configurable format- ting, ordering and filtering. When no path is given or path is an empty string, the current directory is used by default. The special path argument `-' makes lr read file names from standard input, instead of traversing path. Likewise, the special path argument @file makes lr read file names from file. By default, lr traverses directories before their entries. When -D is used, the subdirectories (and files) are traversed first. When -B is used, each level of depth is traversed before moving deeper. The options are as follows: -0 Output filenames separated by NUL bytes. Likewise, read input filenames separated by NUL bytes. -1 Don't go below one level of directories. -A Don't list files starting with a dot. -B Use breadth first traversal. For each depth of the directory tree, files are sorted and printed, then the next depth is looked at. -C [color:]path Behaves as if path was passed like an ordinary argument, but over- rides the color of the file names to the number color which must be between 0 and 255 (default: 2, green). Implies -GG. -D Use depth first traversal. prune will not work, but entries and total are computed on the fly. -F Output filenames and an indicator of their file type (one of `*/=>@|'). -G Colorize output to TTY. Use twice to force colorized output. If the environment variable NO_COLOR is set, colors are never used. -H Only follow symlinks on command line (default: don't follow sym- links). -L Follow all symlinks. -P Quote file names using Austin Group #249 syntax $'...' (implies -Q). -Q Quote file names (default for output to TTY). -S Output inspired by BSD stat(1) (implies -Q). -TA With -l, print atime. -TC With -l, print ctime. -TM With -l, print mtime. This is the default. -U Don't sort results, print during traversal. -W Sort results by name and print during traversal. (This is subtly different from sorting by file name with -on as it prints directo- ries directly before their contents.) -X Output OSC 8 hyperlinks to TTY. Use twice to force hyperlinks. -d Don't enter directories. -e regex Only show files where basename matches the POSIX ERE regex. -f fmt Custom formatting, see "FORMATTING". -h Print human readable size for -l (also %s). -l Long output a la `ls -l' (implies -Q). -o ord Sort according to ord, see "SORT ORDER". -q Silently ignore "Permission denied" errors. -s Strip directory prefix passed on command line. -t test Only show files matching the expression test, see "TESTS". Multi- ple occurrences of -t and -e are regarded as a conjunction. -x Don't enter other filesystems. FORMATTING lr format strings support the following escape sequences: \a, \b, \f, \n, \r, \v Special characters as in C \ddd Byte with one, two or three-digit octal value \xdd Byte with one or two-digit hexadecimal value %% A plain `%' %s File size in bytes %S File size, with human readable unit %b File size in 512-byte blocks %k File size in 1024-byte blocks %d Path depth %D Device number (stat.st_dev) %R Device ID for special files (stat.st_rdev) %i Inode number %I One space character for every depth level %p Full path (%P if -s is used) %P Full path without command line argument prefix %l Symlink target %n Number of hardlinks %F File indicator type symbol (one of `*/=>@|') %f File basename (everything after last /) %A-, %C-, %T- relative age for atime/ctime/mtime. %Ax, %Cx, %Tx result of strftime(3) for %x on atime/ctime/mtime %m Octal file permissions %M ls-style symbolic file permissions %y ls-style symbolic file type (`bcdfls') %g Group name %G Numeric gid %u User name %U Numeric uid %e Number of entries in directories %t Total size used by accepted files in directories (only with -D) %Y Type of the filesystem the file resides on %x Linux-only: Print a combination of `#' for files with security ca- pabilities, `+' for files with an ACL, `@' for files with other ex- tended attributes SORT ORDER Sort order is string consisting of the following letters. Uppercase let- ters reverse sorting. Default sort order is `n'. a atime c ctime d path depth e file extension f file basename i inode number m mtime n file name p directory name s file size t file type. This sorts all directories before other files. v file name as version numbers (sorts `2' before `10') E.g. `Sn' sorts first by size, smallest last, and then by name (in case sizes are equal). TESTS lr tests are given by the following EBNF: <expr> ::= <expr> || <expr> -- disjunction | <expr> && <expr> -- conjunction | <expr> ? <expr> : <expr> -- ternary operator | ! <expr> -- negation | ( <expr ) | <timeprop> <numop> <dur> | <numprop> <numop> <num> | <strprop> <strop> <str> | <typetest> | <modetest> | prune -- do not traverse into subdirectories | print -- always true value | skip -- always false value | color <num> -- always true value, override 256-color <timeprop> ::= atime | ctime | mtime <numprop> ::= depth | dev | entries | gid | inode | links | mode | rdev | size | total | uid <numop> ::= <= | < | >= | > | == | = | != <dur> ::= "./path" -- mtime of relative path | "/path" -- mtime of absolute path | "YYYY-MM-DD HH:MM:SS" | "YYYY-MM-DD" -- at midnight | "HH:MM:SS" -- today | "HH:MM" -- today | "-[0-9]+d" -- n days ago at midnight | "-[0-9]+h" -- n hours before now | "-[0-9]+m" -- n minutes before now | "-[0-9]+s" -- n seconds before now | [0-9]+ -- absolute epoch time <num> ::= [0-9]+ ( c -- *1 | b -- *512 | k -- *1024 | M -- *1024*1024 | G -- *1024*1024*1024 | T )? -- *1024*1024*1024*1024 <strprop> ::= fstype | group | name | path | target | user | xattr <strop> ::= == | = | != -- string (in)equality | === | !=== -- case insensitive string (in)equality | ~~ | !~~ -- glob (fnmatch) | ~~~ | !~~~ -- case insensitive glob (fnmatch) | =~ | !=~ | !~ -- POSIX Extended Regular Expressions | =~~ | !=~~ -- case insensitive POSIX Extended Regular Expressions <str> ::= " ([^"] | "")+ " -- use "" for a single " inside " | $[A-Za-z0-9_]+ -- environment variable <typetest> ::= type ( == | = | != ) ( b | c | d | p | f | l ) <modetest> ::= mode ( == | = -- exact permissions | & -- check if all bits of <octal> set | | -- check if any bit of <octal> set ) <octal> | mode = "<chmod>" -- check if symbolic mode is satisfied <octal> ::= [0-7]+ <chmod> ::= <clause> (, <clause>)+ <clause> ::= [guoa]* [+-=] [rwxXstugo]* -- see chmod(1) EXIT STATUS The lr utility exits 0 on success, and >0 if an error occurs. SEE ALSO du(1), find(1), ls(1), stat(1), tw(1) AUTHORS Leah Neukirchen <leah@vuxu.org> LICENSE lr is licensed under the terms of the MIT license. FreeBSD ports 15.quarterly August 30, 2025 LR(1)
NAME | SYNOPSIS | DESCRIPTION | FORMATTING | SORT ORDER | TESTS | EXIT STATUS | SEE ALSO | AUTHORS | LICENSE
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=lr&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>