diff options
Diffstat (limited to 'man/ls.1')
| -rw-r--r-- | man/ls.1 | 271 |
1 files changed, 271 insertions, 0 deletions
diff --git a/man/ls.1 b/man/ls.1 new file mode 100644 index 0000000..d399e48 --- /dev/null +++ b/man/ls.1 @@ -0,0 +1,271 @@ +.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md. +.TH LS "1" "2026-07-28" "BNU 9.11" "BNU Commands" +.SH NAME +ls \- list directory contents +.SH SYNOPSIS +.B ls +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" This page is derived from GNU Coreutils documentation. +This page documents BNU, an independent Bun implementation compatible with +GNU Coreutils 9.11. +.PP +List information about the FILEs (the current directory by default). +Sort entries alphabetically if none of \fB\-cftuvSUX\fR nor \fB\-\-sort\fR is specified. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-a'\fB\-a, \-\-all\fP\X'tty: link' +do not ignore entries starting with . +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-A'\fB\-A, \-\-almost\-all\fP\X'tty: link' +do not list implied . and .. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--author'\fB\-\-author\fP\X'tty: link' +with \fB\-l\fR, print the author of each file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-b'\fB\-b, \-\-escape\fP\X'tty: link' +print C\-style escapes for nongraphic characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--block-size'\fB\-\-block\-size=SIZE\fP\X'tty: link' +with \fB\-l\fR, scale sizes by SIZE when printing them; +e.g., '\-\-block\-size=M'; see SIZE format below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-B'\fB\-B, \-\-ignore\-backups\fP\X'tty: link' +do not list implied entries ending with ~ +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-c'\fB\-c\fP\X'tty: link' +with \fB\-lt\fR: sort by, and show, ctime +(time of last change of file status information); +with \fB\-l\fR: show ctime and sort by name; +otherwise: sort by ctime, newest first +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-C'\fB\-C\fP\X'tty: link' +list entries by columns +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--color'\fB\-\-color[=WHEN]\fP\X'tty: link' +color the output WHEN; more info below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-d'\fB\-d, \-\-directory\fP\X'tty: link' +list directories themselves, not their contents +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-D'\fB\-D, \-\-dired\fP\X'tty: link' +generate output designed for Emacs' dired mode +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-f'\fB\-f\fP\X'tty: link' +same as \fB\-a\fR \fB\-U\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-F'\fB\-F, \-\-classify[=\,WHEN]\fP\X'tty: link'\/\fR +append indicator (one of */=>@|) to entries WHEN +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--file-type'\fB\-\-file\-type\fP\X'tty: link' +like \fB\-F\fR, except do not append '*' +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--format'\fB\-\-format=WORD\fP\X'tty: link' +across,horizontal (\fB\-x\fR), commas (\fB\-m\fR), long (\fB\-l\fR), +single\-column (\fB\-1\fR), verbose (\fB\-l\fR), vertical (\fB\-C\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--full-time'\fB\-\-full\-time\fP\X'tty: link' +like \fB\-l\fR \fB\-\-time\-style\fR=\fI\,full\-iso\/\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-g'\fB\-g\fP\X'tty: link' +like \fB\-l\fR, but do not list owner +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--group-directories-first'\fB\-\-group\-directories\-first\fP\X'tty: link' +group directories before files +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-G'\fB\-G, \-\-no\-group\fP\X'tty: link' +in a long listing, don't print group names +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-h'\fB\-h, \-\-human\-readable\fP\X'tty: link' +with \fB\-l\fR and \fB\-s\fR, print sizes like 1K 234M 2G etc. +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--si'\fB\-\-si\fP\X'tty: link' +likewise, but use powers of 1000 not 1024 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-H'\fB\-H, \-\-dereference\-command\-line\fP\X'tty: link' +follow symbolic links listed on the command line +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--dereference-command-line-symlink-to-dir'\fB\-\-dereference\-command\-line\-symlink\-to\-dir\fP\X'tty: link' +follow each command line symbolic link that points to a directory +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--hide'\fB\-\-hide=PATTERN\fP\X'tty: link' +do not list implied entries matching shell PATTERN +(overridden by \fB\-a\fR or \fB\-A\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--hyperlink'\fB\-\-hyperlink[=WHEN]\fP\X'tty: link' +hyperlink file names WHEN +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--indicator-style'\fB\-\-indicator\-style=WORD\fP\X'tty: link' +append indicator with style WORD to entry names: +none (default), slash (\fB\-p\fR), file\-type (\fB\-\-file\-type\fR), classify (\fB\-F\fR) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-i'\fB\-i, \-\-inode\fP\X'tty: link' +print the index number of each file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-I'\fB\-I, \-\-ignore=\,PATTERN\fP\X'tty: link'\/\fR +do not list implied entries matching shell PATTERN +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-k'\fB\-k, \-\-kibibytes\fP\X'tty: link' +default to 1024\-byte blocks for file system usage; +used only with \fB\-s\fR and per directory totals +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-l'\fB\-l\fP\X'tty: link' +use a long listing format +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-L'\fB\-L, \-\-dereference\fP\X'tty: link' +when showing file information for a symbolic link, +show information for the file the link references +rather than for the link itself +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-m'\fB\-m\fP\X'tty: link' +fill width with a comma separated list of entries +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-n'\fB\-n, \-\-numeric\-uid\-gid\fP\X'tty: link' +like \fB\-l\fR, but list numeric user and group IDs +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-N'\fB\-N, \-\-literal\fP\X'tty: link' +print entry names without quoting +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-o'\fB\-o\fP\X'tty: link' +like \fB\-l\fR, but do not list group information +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-p'\fB\-p, \-\-indicator\-style=\,slash\fP\X'tty: link'\/\fR +append / indicator to directories +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-q'\fB\-q, \-\-hide\-control\-chars\fP\X'tty: link' +print ? instead of nongraphic characters +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--show-control-chars'\fB\-\-show\-control\-chars\fP\X'tty: link' +show nongraphic characters as\-is; +the default, unless program is 'ls' and output is a terminal +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-Q'\fB\-Q, \-\-quote\-name\fP\X'tty: link' +enclose entry names in double quotes +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--quoting-style'\fB\-\-quoting\-style=WORD\fP\X'tty: link' +use quoting style WORD for entry names: +literal, locale, shell, shell\-always, +shell\-escape, shell\-escape\-always, c, escape +(overrides QUOTING_STYLE environment variable) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-r'\fB\-r, \-\-reverse\fP\X'tty: link' +reverse order while sorting +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-R'\fB\-R, \-\-recursive\fP\X'tty: link' +list subdirectories recursively +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-s'\fB\-s, \-\-size\fP\X'tty: link' +print the allocated size of each file, in blocks +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-S'\fB\-S\fP\X'tty: link' +sort by file size, largest first +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--sort'\fB\-\-sort=WORD\fP\X'tty: link' +change default 'name' sort to WORD: +none (\fB\-U\fR), size (\fB\-S\fR), time (\fB\-t\fR), +version (\fB\-v\fR), extension (\fB\-X\fR), name, width +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--time'\fB\-\-time=WORD\fP\X'tty: link' +select which timestamp used to display or sort; +access time (\fB\-u\fR): atime, access, use; +metadata change time (\fB\-c\fR): ctime, status; +modified time (default): mtime, modification; +birth time: birth, creation; +with \fB\-l\fR, WORD determines which time to show; +with \fB\-\-sort\fR=\fI\,time\/\fR, sort by WORD (newest first) +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--time-style'\fB\-\-time\-style=TIME_STYLE\fP\X'tty: link' +time/date format with \fB\-l\fR; see TIME_STYLE below +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-t'\fB\-t\fP\X'tty: link' +sort by time, newest first; see \fB\-\-time\fR +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-T'\fB\-T, \-\-tabsize=\,COLS\fP\X'tty: link'\/\fR +assume tab stops at each COLS instead of 8 +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-u'\fB\-u\fP\X'tty: link' +with \fB\-lt\fR: sort by, and show, access time; +with \fB\-l\fR: show access time and sort by name; +otherwise: sort by access time, newest first +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-U'\fB\-U\fP\X'tty: link' +do not sort directory entries +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-v'\fB\-v\fP\X'tty: link' +natural sort of (version) numbers within text +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-w'\fB\-w, \-\-width=\,COLS\fP\X'tty: link'\/\fR +set output width to COLS. 0 means no limit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-x'\fB\-x\fP\X'tty: link' +list entries by lines instead of by columns +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-X'\fB\-X\fP\X'tty: link' +sort alphabetically by entry extension +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-Z'\fB\-Z, \-\-context\fP\X'tty: link' +print any security context of each file +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls--zero'\fB\-\-zero\fP\X'tty: link' +end each output line with NUL, not newline +.TP +\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ls-1'\fB\-1\fP\X'tty: link' +list one file per line +.TP +\X'tty: link https://www.gnu.org/software/coreutils/ls#ls--help'\fB\-\-help\fP\X'tty: link' +display this help and exit +.TP +\X'tty: link https://www.gnu.org/software/coreutils/ls#ls--version'\fB\-\-version\fP\X'tty: link' +output version information and exit +.PP +The SIZE argument is an integer and optional unit (example: 10K is 10*1024). +Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000). +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.PP +The TIME_STYLE argument can be full\-iso, long\-iso, iso, locale, or +FORMAT. +FORMAT is interpreted like in \fBdate\fP(1). If FORMAT is FORMAT1<newline>FORMAT2, +then FORMAT1 applies to non\-recent files and FORMAT2 to recent files. +TIME_STYLE prefixed with 'posix\-' takes effect only outside the POSIX locale. +Also the TIME_STYLE environment variable sets the default style to use. +.PP +The WHEN argument defaults to 'always' and can also be 'auto' or 'never'. +.PP +Using color to distinguish file types is disabled both by default and +with \fB\-\-color\fR=\fI\,never\/\fR. With \fB\-\-color\fR=\fI\,auto\/\fR, ls emits color codes only when +standard output is connected to a terminal. The LS_COLORS environment +variable can change the settings. Use the \fBdircolors\fP(1) command to set it. +.SS "Exit status:" +.TP +0 +if OK, +.TP +1 +if minor problems (e.g., cannot access subdirectory), +.TP +2 +if serious trouble (e.g., cannot access command\-line argument). +.SH AUTHORS +Upstream GNU Coreutils documentation authors: +Written by Richard M. Stallman and David MacKenzie. +.br +Adapted for BNU; the BNU implementation is independent. +.SH "REPORTING BUGS" +Report BNU bugs at <https://github.com/Soccera1/bnu/issues>. +.br +For upstream GNU Coreutils, see <https://www.gnu.org/software/coreutils/>. +.SH COPYRIGHT +Copyright \(co 2026 Free Software Foundation, Inc. +.br +This manual page was adapted for BNU in 2026. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBdircolors\fP(1) +.PP +.br +Upstream documentation <https://www.gnu.org/software/coreutils/ls> +.br +BNU documentation is available locally via: info \(aq(bnu) ls invocation\(aq |
