aboutsummaryrefslogtreecommitdiff
path: root/man/vdir.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/vdir.1')
-rw-r--r--man/vdir.1271
1 files changed, 271 insertions, 0 deletions
diff --git a/man/vdir.1 b/man/vdir.1
new file mode 100644
index 0000000..4903faf
--- /dev/null
+++ b/man/vdir.1
@@ -0,0 +1,271 @@
+.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md.
+.TH VDIR "1" "2026-07-28" "BNU 9.11" "BNU Commands"
+.SH NAME
+vdir \- list directory contents
+.SH SYNOPSIS
+.B vdir
+[\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/vdir>
+.br
+BNU documentation is available locally via: info \(aq(bnu) vdir invocation\(aq