{ "content": [ { "type": "text", "text": "# vdir (man)\n\n## NAME\n\nvdir - list directory contents\n\n## SYNOPSIS\n\nvdir [OPTION]... [FILE]...\n\n## DESCRIPTION\n\nList information about the FILEs (the current directory by default). Sort entries alphabeti‐\ncally if none of -cftuvSUX nor --sort is specified.\n\n## TLDR\n\n> This command is an alias of `ls -l --escape`.\n\n- View documentation for the original command:\n `tldr ls`\n\n*Source: tldr-pages*\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION** (48 subsections)\n- **AUTHOR**\n- **REPORTING BUGS**\n- **COPYRIGHT**\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "vdir", "section": "", "mode": "man", "summary": "vdir - list directory contents", "synopsis": "vdir [OPTION]... [FILE]...", "tldr_summary": "This command is an alias of `ls -l --escape`.", "tldr_examples": [ { "description": "View documentation for the original command", "command": "tldr ls" } ], "tldr_source": "official", "flags": [ { "flag": "-a", "long": "--all", "arg": null, "description": "do not ignore entries starting with ." }, { "flag": "-A", "long": "--almost-all", "arg": null, "description": "do not list implied . and .." }, { "flag": "", "long": "--author", "arg": null, "description": "with -l, print the author of each file" }, { "flag": "-b", "long": "--escape", "arg": null, "description": "print C-style escapes for nongraphic characters --block-size=SIZE with -l, scale sizes by SIZE when printing them; e.g., '--block-size=M'; see SIZE for‐ mat below" }, { "flag": "-B", "long": "--ignore-backups", "arg": null, "description": "do not list implied entries ending with ~" }, { "flag": "-c", "long": null, "arg": null, "description": "tion); with -l: show ctime and sort by name; otherwise: sort by ctime, newest first" }, { "flag": "-C", "long": null, "arg": null, "description": "--color[=WHEN] colorize the output; WHEN can be 'always' (default if omitted), 'auto', or 'never'; more info below" }, { "flag": "-d", "long": "--directory", "arg": null, "description": "list directories themselves, not their contents" }, { "flag": "-D", "long": "--dired", "arg": null, "description": "generate output designed for Emacs' dired mode" }, { "flag": "-f", "long": "--color", "arg": null, "description": "" }, { "flag": "-F", "long": "--classify", "arg": null, "description": "append indicator (one of */=>@|) to entries" }, { "flag": "", "long": "--file-type", "arg": null, "description": "likewise, except do not append '*' --format=WORD across -x, commas -m, horizontal -x, long -l, single-column -1, verbose -l, vertical -C" }, { "flag": "", "long": "--full-time", "arg": null, "description": "like -l --time-style=full-iso" }, { "flag": "-l", "long": null, "arg": null, "description": "" }, { "flag": "", "long": "--group-directories-first", "arg": null, "description": "group directories before files; can be augmented with a --sort option, but any use of --sort=none (-U) disables group‐ ing" }, { "flag": "-G", "long": "--no-group", "arg": null, "description": "in a long listing, don't print group names" }, { "flag": "-h", "long": "--human-readable", "arg": null, "description": "with -l and -s, print sizes like 1K 234M 2G etc. --si likewise, but use powers of 1000 not 1024" }, { "flag": "-H", "long": "--dereference-command-line", "arg": null, "description": "follow symbolic links listed on the command line" }, { "flag": "", "long": "--dereference-command-line-symlink-to-dir", "arg": null, "description": "follow each command line symbolic link that points to a directory --hide=PATTERN do not list implied entries matching shell PATTERN (overridden by -a or -A) --hyperlink[=WHEN] hyperlink file names; WHEN can be 'always' (default if omitted), 'auto', or 'never' --indicator-style=WORD append indicator with style WORD to entry names: none (default), slash (-p), file-type (--file-type), classify (-F)" }, { "flag": "-i", "long": "--inode", "arg": null, "description": "print the index number of each file" }, { "flag": "-I", "long": "--ignore", "arg": null, "description": "do not list implied entries matching shell PATTERN" }, { "flag": "-k", "long": "--kibibytes", "arg": null, "description": "default to 1024-byte blocks for disk usage; used only with -s and per directory totals" }, { "flag": "-l", "long": null, "arg": null, "description": "" }, { "flag": "-L", "long": "--dereference", "arg": null, "description": "when showing file information for a symbolic link, show information for the file the link references rather than for the link itself" }, { "flag": "-m", "long": null, "arg": null, "description": "" }, { "flag": "-n", "long": "--numeric-uid-gid", "arg": null, "description": "like -l, but list numeric user and group IDs" }, { "flag": "-N", "long": "--literal", "arg": null, "description": "print entry names without quoting" }, { "flag": "-l", "long": null, "arg": null, "description": "" }, { "flag": "-p", "long": "--indicator-style", "arg": null, "description": "append / indicator to directories" }, { "flag": "-q", "long": "--hide-control-chars", "arg": null, "description": "print ? instead of nongraphic characters" }, { "flag": "", "long": "--show-control-chars", "arg": null, "description": "show nongraphic characters as-is (the default, unless program is 'ls' and output is a terminal)" }, { "flag": "-Q", "long": "--quote-name", "arg": null, "description": "enclose entry names in double quotes --quoting-style=WORD use quoting style WORD for entry names: literal, locale, shell, shell-always, shell-escape, shell-escape-always, c, escape (overrides QUOTINGSTYLE environment variable)" }, { "flag": "-r", "long": "--reverse", "arg": null, "description": "reverse order while sorting" }, { "flag": "-R", "long": "--recursive", "arg": null, "description": "list subdirectories recursively" }, { "flag": "-s", "long": "--size", "arg": null, "description": "print the allocated size of each file, in blocks" }, { "flag": "-S", "long": null, "arg": null, "description": "--sort=WORD sort by WORD instead of name: none (-U), size (-S), time (-t), version (-v), extension (-X) --time=WORD change the default of using modification times; access time (-u): atime, access, use; change time (-c): ctime, status; birth time: birth, creation; with -l, WORD determines which time to show; with --sort=time, sort by WORD (newest first) --time-style=TIMESTYLE time/date format with -l; see TIMESTYLE below" }, { "flag": "-t", "long": "--time", "arg": null, "description": "" }, { "flag": "-T", "long": "--tabsize", "arg": null, "description": "assume tab stops at each COLS instead of 8" }, { "flag": "-l", "long": null, "arg": null, "description": "otherwise: sort by access time, newest first" }, { "flag": "-U", "long": null, "arg": null, "description": "" }, { "flag": "-v", "long": null, "arg": null, "description": "" }, { "flag": "-w", "long": "--width", "arg": null, "description": "set output width to COLS. 0 means no limit" }, { "flag": "-x", "long": null, "arg": null, "description": "" }, { "flag": "-X", "long": null, "arg": null, "description": "" }, { "flag": "-Z", "long": "--context", "arg": null, "description": "print any security context of each file" }, { "flag": "-b", "long": null, "arg": null, "description": "--help display this help and exit" }, { "flag": "", "long": "--version", "arg": null, "description": "output version information and exit The SIZE argument is an integer and optional unit (example: 10K is 10*1024). Units are K,M,G,T,P,E,Z,Y (powers of 1024) or KB,MB,... (powers of 1000). Binary prefixes can be used, too: KiB=K, MiB=M, and so on. The TIMESTYLE argument can be full-iso, long-iso, iso, locale, or +FORMAT. FORMAT is inter‐ preted like in date(1). If FORMAT is FORMAT1FORMAT2, then FORMAT1 applies to non-recent files and FORMAT2 to recent files. TIMESTYLE prefixed with 'posix-' takes effect only outside the POSIX locale. Also the TIMESTYLE environment variable sets the default style to use. Using color to distinguish file types is disabled both by default and with --color=never. With --color=auto, ls emits color codes only when standard output is connected to a terminal. The LSCOLORS environment variable can change the settings. Use the dircolors command to set it." } ], "examples": [], "see_also": [], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 2, "subsections": [] }, { "name": "DESCRIPTION", "lines": 5, "subsections": [ { "name": "-a --all", "lines": 2, "flag": "-a", "long": "--all" }, { "name": "-A --almost-all", "lines": 2, "flag": "-A", "long": "--almost-all" }, { "name": "--author", "lines": 2, "long": "--author" }, { "name": "-b --escape", "lines": 6, "flag": "-b", "long": "--escape" }, { "name": "-B --ignore-backups", "lines": 2, "flag": "-B", "long": "--ignore-backups" }, { "name": "-c -lt", "lines": 2, "flag": "-c" }, { "name": "-C", "lines": 4, "flag": "-C" }, { "name": "-d --directory", "lines": 2, "flag": "-d", "long": "--directory" }, { "name": "-D --dired", "lines": 2, "flag": "-D", "long": "--dired" }, { "name": "-f -aU -ls --color", "lines": 1, "flag": "-f", "long": "--color" }, { "name": "-F --classify", "lines": 2, "flag": "-F", "long": "--classify" }, { "name": "--file-type", "lines": 6, "long": "--file-type" }, { "name": "--full-time", "lines": 2, "long": "--full-time" }, { "name": "-g -l", "lines": 1, "flag": "-l" }, { "name": "--group-directories-first", "lines": 5, "long": "--group-directories-first" }, { "name": "-G --no-group", "lines": 2, "flag": "-G", "long": "--no-group" }, { "name": "-h --human-readable", "lines": 4, "flag": "-h", "long": "--human-readable" }, { "name": "-H --dereference-command-line", "lines": 2, "flag": "-H", "long": "--dereference-command-line" }, { "name": "--dereference-command-line-symlink-to-dir", "lines": 14, "long": "--dereference-command-line-symlink-to-dir" }, { "name": "-i --inode", "lines": 2, "flag": "-i", "long": "--inode" }, { "name": "-I --ignore", "lines": 2, "flag": "-I", "long": "--ignore" }, { "name": "-k --kibibytes", "lines": 2, "flag": "-k", "long": "--kibibytes" }, { "name": "-l", "lines": 1, "flag": "-l" }, { "name": "-L --dereference", "lines": 3, "flag": "-L", "long": "--dereference" }, { "name": "-m", "lines": 1, "flag": "-m" }, { "name": "-n --numeric-uid-gid", "lines": 2, "flag": "-n", "long": "--numeric-uid-gid" }, { "name": "-N --literal", "lines": 2, "flag": "-N", "long": "--literal" }, { "name": "-o -l", "lines": 1, "flag": "-l" }, { "name": "-p --indicator-style", "lines": 2, "flag": "-p", "long": "--indicator-style" }, { "name": "-q --hide-control-chars", "lines": 2, "flag": "-q", "long": "--hide-control-chars" }, { "name": "--show-control-chars", "lines": 3, "long": "--show-control-chars" }, { "name": "-Q --quote-name", "lines": 7, "flag": "-Q", "long": "--quote-name" }, { "name": "-r --reverse", "lines": 2, "flag": "-r", "long": "--reverse" }, { "name": "-R --recursive", "lines": 2, "flag": "-R", "long": "--recursive" }, { "name": "-s --size", "lines": 2, "flag": "-s", "long": "--size" }, { "name": "-S", "lines": 14, "flag": "-S" }, { "name": "-t --time", "lines": 1, "flag": "-t", "long": "--time" }, { "name": "-T --tabsize", "lines": 2, "flag": "-T", "long": "--tabsize" }, { "name": "-u -lt -l", "lines": 2, "flag": "-l" }, { "name": "-U", "lines": 1, "flag": "-U" }, { "name": "-v", "lines": 1, "flag": "-v" }, { "name": "-w --width", "lines": 2, "flag": "-w", "long": "--width" }, { "name": "-x", "lines": 1, "flag": "-x" }, { "name": "-X", "lines": 1, "flag": "-X" }, { "name": "-Z --context", "lines": 2, "flag": "-Z", "long": "--context" }, { "name": "-1 -q -b", "lines": 2, "flag": "-b" }, { "name": "--version", "lines": 17, "long": "--version" }, { "name": "Exit status:", "lines": 6 } ] }, { "name": "AUTHOR", "lines": 2, "subsections": [] }, { "name": "REPORTING BUGS", "lines": 3, "subsections": [] }, { "name": "COPYRIGHT", "lines": 5, "subsections": [] }, { "name": "SEE ALSO", "lines": 6, "subsections": [] } ], "sections": { "NAME": { "content": "vdir - list directory contents\n", "subsections": [] }, "SYNOPSIS": { "content": "vdir [OPTION]... [FILE]...\n", "subsections": [] }, "DESCRIPTION": { "content": "List information about the FILEs (the current directory by default). Sort entries alphabeti‐\ncally if none of -cftuvSUX nor --sort is specified.\n\nMandatory arguments to long options are mandatory for short options too.\n", "subsections": [ { "name": "-a --all", "content": "do not ignore entries starting with .\n", "flag": "-a", "long": "--all" }, { "name": "-A --almost-all", "content": "do not list implied . and ..\n", "flag": "-A", "long": "--almost-all" }, { "name": "--author", "content": "with -l, print the author of each file\n", "long": "--author" }, { "name": "-b --escape", "content": "print C-style escapes for nongraphic characters\n\n--block-size=SIZE\nwith -l, scale sizes by SIZE when printing them; e.g., '--block-size=M'; see SIZE for‐\nmat below\n", "flag": "-b", "long": "--escape" }, { "name": "-B --ignore-backups", "content": "do not list implied entries ending with ~\n", "flag": "-B", "long": "--ignore-backups" }, { "name": "-c -lt", "content": "tion); with -l: show ctime and sort by name; otherwise: sort by ctime, newest first\n", "flag": "-c" }, { "name": "-C", "content": "--color[=WHEN]\ncolorize the output; WHEN can be 'always' (default if omitted), 'auto', or 'never';\nmore info below\n", "flag": "-C" }, { "name": "-d --directory", "content": "list directories themselves, not their contents\n", "flag": "-d", "long": "--directory" }, { "name": "-D --dired", "content": "generate output designed for Emacs' dired mode\n", "flag": "-D", "long": "--dired" }, { "name": "-f -aU -ls --color", "content": "", "flag": "-f", "long": "--color" }, { "name": "-F --classify", "content": "append indicator (one of */=>@|) to entries\n", "flag": "-F", "long": "--classify" }, { "name": "--file-type", "content": "likewise, except do not append '*'\n\n--format=WORD\nacross -x, commas -m, horizontal -x, long -l, single-column -1, verbose -l, vertical\n-C\n", "long": "--file-type" }, { "name": "--full-time", "content": "like -l --time-style=full-iso\n", "long": "--full-time" }, { "name": "-g -l", "content": "", "flag": "-l" }, { "name": "--group-directories-first", "content": "group directories before files;\n\ncan be augmented with a --sort option, but any use of --sort=none (-U) disables group‐\ning\n", "long": "--group-directories-first" }, { "name": "-G --no-group", "content": "in a long listing, don't print group names\n", "flag": "-G", "long": "--no-group" }, { "name": "-h --human-readable", "content": "with -l and -s, print sizes like 1K 234M 2G etc.\n\n--si likewise, but use powers of 1000 not 1024\n", "flag": "-h", "long": "--human-readable" }, { "name": "-H --dereference-command-line", "content": "follow symbolic links listed on the command line\n", "flag": "-H", "long": "--dereference-command-line" }, { "name": "--dereference-command-line-symlink-to-dir", "content": "follow each command line symbolic link\n\nthat points to a directory\n\n--hide=PATTERN\ndo not list implied entries matching shell PATTERN (overridden by -a or -A)\n\n--hyperlink[=WHEN]\nhyperlink file names; WHEN can be 'always' (default if omitted), 'auto', or 'never'\n\n--indicator-style=WORD\nappend indicator with style WORD to entry names: none (default), slash (-p), file-type\n(--file-type), classify (-F)\n", "long": "--dereference-command-line-symlink-to-dir" }, { "name": "-i --inode", "content": "print the index number of each file\n", "flag": "-i", "long": "--inode" }, { "name": "-I --ignore", "content": "do not list implied entries matching shell PATTERN\n", "flag": "-I", "long": "--ignore" }, { "name": "-k --kibibytes", "content": "default to 1024-byte blocks for disk usage; used only with -s and per directory totals\n", "flag": "-k", "long": "--kibibytes" }, { "name": "-l", "content": "", "flag": "-l" }, { "name": "-L --dereference", "content": "when showing file information for a symbolic link, show information for the file the\nlink references rather than for the link itself\n", "flag": "-L", "long": "--dereference" }, { "name": "-m", "content": "", "flag": "-m" }, { "name": "-n --numeric-uid-gid", "content": "like -l, but list numeric user and group IDs\n", "flag": "-n", "long": "--numeric-uid-gid" }, { "name": "-N --literal", "content": "print entry names without quoting\n", "flag": "-N", "long": "--literal" }, { "name": "-o -l", "content": "", "flag": "-l" }, { "name": "-p --indicator-style", "content": "append / indicator to directories\n", "flag": "-p", "long": "--indicator-style" }, { "name": "-q --hide-control-chars", "content": "print ? instead of nongraphic characters\n", "flag": "-q", "long": "--hide-control-chars" }, { "name": "--show-control-chars", "content": "show nongraphic characters as-is (the default, unless program is 'ls' and output is a\nterminal)\n", "long": "--show-control-chars" }, { "name": "-Q --quote-name", "content": "enclose entry names in double quotes\n\n--quoting-style=WORD\nuse quoting style WORD for entry names: literal, locale, shell, shell-always,\nshell-escape, shell-escape-always, c, escape (overrides QUOTINGSTYLE environment\nvariable)\n", "flag": "-Q", "long": "--quote-name" }, { "name": "-r --reverse", "content": "reverse order while sorting\n", "flag": "-r", "long": "--reverse" }, { "name": "-R --recursive", "content": "list subdirectories recursively\n", "flag": "-R", "long": "--recursive" }, { "name": "-s --size", "content": "print the allocated size of each file, in blocks\n", "flag": "-s", "long": "--size" }, { "name": "-S", "content": "--sort=WORD\nsort by WORD instead of name: none (-U), size (-S), time (-t), version (-v), extension\n(-X)\n\n--time=WORD\nchange the default of using modification times; access time (-u): atime, access, use;\nchange time (-c): ctime, status; birth time: birth, creation;\n\nwith -l, WORD determines which time to show; with --sort=time, sort by WORD (newest\nfirst)\n\n--time-style=TIMESTYLE\ntime/date format with -l; see TIMESTYLE below\n", "flag": "-S" }, { "name": "-t --time", "content": "", "flag": "-t", "long": "--time" }, { "name": "-T --tabsize", "content": "assume tab stops at each COLS instead of 8\n", "flag": "-T", "long": "--tabsize" }, { "name": "-u -lt -l", "content": "otherwise: sort by access time, newest first\n", "flag": "-l" }, { "name": "-U", "content": "", "flag": "-U" }, { "name": "-v", "content": "", "flag": "-v" }, { "name": "-w --width", "content": "set output width to COLS. 0 means no limit\n", "flag": "-w", "long": "--width" }, { "name": "-x", "content": "", "flag": "-x" }, { "name": "-X", "content": "", "flag": "-X" }, { "name": "-Z --context", "content": "print any security context of each file\n", "flag": "-Z", "long": "--context" }, { "name": "-1 -q -b", "content": "--help display this help and exit\n", "flag": "-b" }, { "name": "--version", "content": "output version information and exit\n\nThe SIZE argument is an integer and optional unit (example: 10K is 10*1024). Units are\nK,M,G,T,P,E,Z,Y (powers of 1024) or KB,MB,... (powers of 1000). Binary prefixes can be used,\ntoo: KiB=K, MiB=M, and so on.\n\nThe TIMESTYLE argument can be full-iso, long-iso, iso, locale, or +FORMAT. FORMAT is inter‐\npreted like in date(1). If FORMAT is FORMAT1FORMAT2, then FORMAT1 applies to\nnon-recent files and FORMAT2 to recent files. TIMESTYLE prefixed with 'posix-' takes effect\nonly outside the POSIX locale. Also the TIMESTYLE environment variable sets the default\nstyle to use.\n\nUsing color to distinguish file types is disabled both by default and with --color=never.\nWith --color=auto, ls emits color codes only when standard output is connected to a terminal.\nThe LSCOLORS environment variable can change the settings. Use the dircolors command to set\nit.\n", "long": "--version" }, { "name": "Exit status:", "content": "0 if OK,\n\n1 if minor problems (e.g., cannot access subdirectory),\n\n2 if serious trouble (e.g., cannot access command-line argument).\n" } ] }, "AUTHOR": { "content": "Written by Richard M. Stallman and David MacKenzie.\n", "subsections": [] }, "REPORTING BUGS": { "content": "GNU coreutils online help: \nReport any translation bugs to \n", "subsections": [] }, "COPYRIGHT": { "content": "Copyright © 2020 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later\n.\nThis is free software: you are free to change and redistribute it. There is NO WARRANTY, to\nthe extent permitted by law.\n", "subsections": [] }, "SEE ALSO": { "content": "Full documentation \nor available locally via: info '(coreutils) vdir invocation'\n\n\n\nGNU coreutils 8.32 January 2026 VDIR(1)", "subsections": [] } } } }