mirror of
https://github.com/lsd-rs/lsd
synced 2024-11-13 23:57:08 +00:00
4.6 KiB
4.6 KiB
| title | section | header | footer | date |
|---|---|---|---|---|
| lsd | 1 | User Manual | lsd <version> | <date> |
NAME
lsd - LSDeluxe
SYNOPSIS
lsd [FLAGS] [OPTIONS] [--] [FILE]...
DESCRIPTION
lsd is a ls command with a lot of pretty colours and some other stuff to enrich and enhance the directory listing experience.
OPTIONS
-a,--all- Do not ignore entries starting with .
-A,--almost-all- Do not list implied . and ..
--classic- Enable classic mode (no colours or icons)
-L,--dereference- When showing file information for a symbolic link, show information for the file the link references rather than for the link itself
-d,--directory-only- Display directories themselves, and not their contents (recursively when used with --tree)
-X,--extensionsort- Sort by file extension
--git- Display git status. Directory git status is a reduction of included file statuses (recursively).
--help- Prints help information
-h,--human-readable- For ls compatibility purposes ONLY, currently set by default
--ignore-config- Ignore the configuration file
--config-file <path>- Provide the config file from a custom location
-F,--classify- Append indicator (one of */=>@|) at the end of the file names
-i,--inode- Display the index number of each file
-l,--long- Display extended file metadata as a table
--no-symlink- Do not display symlink target
-1,--oneline- Display one entry per line
-R,--recursive- Recurse into directories
-r,--reverse- Reverse the order of the sort
-S,--sizesort- Sort by size
-t,--timesort- Sort by time modified
--total-size- Display the total size of directories
--tree- Recurse into directories and present the result as a tree
-V,--version- Prints version information
-v,--versionsort- Natural sort of (version) numbers within text
--blocks <blocks>...- Specify the blocks that will be displayed and in what order [possible values: permission, user, group, size, date, name, inode, git]
--color <color>...- When to use terminal colours [default: auto] [possible values: always, auto, never]
--date <date>...- How to display date [possible values: date, locale, relative, +date-time-format] [default: date]
--depth <num>...- Stop recursing into directories after reaching specified depth
--group-dirs <group-dirs>...- Sort the directories then the files [default: none] [possible values: none, first, last]
--group-directories-first- Groups the directories at the top before the files. Same as
--group-dirs=first --hyperlink <hyperlink>...- Attach hyperlink to filenames [default: never] [possible values: always, auto, never]
--icon <icon>...- When to print the icons [default: auto] [possible values: always, auto, never]
--icon-theme <icon-theme>...- Whether to use fancy or unicode icons [default: fancy] [possible values: fancy, unicode]
-I, --ignore-glob <pattern>...- Do not display files/directories with names matching the glob pattern(s). More than one can be specified by repeating the argument [default: ]
--permission <permission>...- How to display permissions [default: rwx for linux, attributes for windows] [possible values: rwx, octal, attributes, disable]
--size <size>...- How to display size [default: default] [possible values: default, short, bytes]
--sort <WORD>...- Sort by WORD instead of name [possible values: size, time, version, extension, git]
-U,--no-sort- Do not sort. List entries in directory order
-Z--context- Display SELinux or SMACK security context
--header- Display block headers
-N --literal- Print entry names without quoting
--truncate-owner-after- Truncate the user and group names if they exceed a certain number of characters
--truncate-owner-marker- Truncation marker appended to a truncated user or group name
ARGS
<FILE>...- A file or directory to list [default: .]
EXAMPLES
lsd- Display listing for current directory
lsd /etc- Display listing of /etc
lsd -la- Display listing of current directory, including files starting with
.and the current directory's entry.
ENVIRONMENT
LS_COLORS- Used to determine color for displaying filenames. See dir_colors.
XDG_CONFIG_HOME- Used to locate optional config file. If
XDG_CONFIG_HOMEis set, use$XDG_CONFIG_HOME/lsd/config.yamlelse$HOME/.config/lsd/config.yaml. SHELL_COMPLETIONS_DIRorOUT_DIR- Used to specify the directory for generating a shell completions file. If neither are set, no completions file will be generated. The directory will be created if it does not exist.