<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>man/eza.1.md - fork/eza @ v0.14.2</title>
<meta name="description" content="man/eza.1.md in fork/eza at v0.14.2.">
<meta property="og:title" content="man/eza.1.md - fork/eza @ v0.14.2">
<meta property="og:description" content="man/eza.1.md in fork/eza at v0.14.2.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="v0.14.2" data-tip="7b743992578a9cb1f666f118d8b4edc218d60577">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>fork/eza</h1>
</div>
<pre class="clone">git clone https://git.julia.blue/fork/eza</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">Christina Sørensen</span><span class="commit-message" data-commit="6a4f911a42d30a02bd5055ebb8af3f1ae2697d7f">Merge pull request #508 from MartinFillon/add-env-var-to-override-git</span><span class="snapshot-sha sha" data-commit="6a4f911a42d30a02bd5055ebb8af3f1ae2697d7f">6a4f911a</span><time datetime="2023-10-11T08:29:54+00:00" title="2023-10-11 08:29:54 +0000">2023-10-11</time></p>
<header class="topbar"><details class="switcher"><summary>v0.14.2</summary><div class="menu"><strong>branches</strong><a href="/fork/eza/ref/main/">main</a><strong>tags</strong><a href="/fork/eza/ref/v0.14.1/">v0.14.1</a><a class="current" href="/fork/eza/ref/v0.14.2/">v0.14.2</a><a href="/fork/eza/ref/v0.15.0/">v0.15.0</a><a href="/fork/eza/ref/v0.15.1/">v0.15.1</a><a href="/fork/eza/ref/v0.15.2/">v0.15.2</a><a href="/fork/eza/ref/v0.15.3/">v0.15.3</a><a href="/fork/eza/ref/v0.16.0/">v0.16.0</a><a href="/fork/eza/ref/v0.16.1/">v0.16.1</a><a class="all" href="/fork/eza/refs">all refs →</a></div></details><nav class="crumbs"><a href="/fork/eza/">eza</a> / <a href="/fork/eza/ref/v0.14.2/tree/man/">man</a> / <span class="cur">eza.1.md</span></nav>
<span class="view-stats"><span>10.2 KiB</span><span>325 lines</span></span><span class="actions"><a class="raw" href="/fork/eza/raw/1819752b22c2e907fd5ec1e2f61cbdd369e7b31d/man/eza.1.md">raw</a></span></header>
<div class="markdown-view"><input type="radio" name="markdown-view" id="markdown-rendered" checked><label for="markdown-rendered">rendered</label><input type="radio" name="markdown-view" id="markdown-code"><label for="markdown-code">code</label><section class="readme rendered"><p>% eza(1) $version</p>
&lt;!-- This is the eza(1) man page, written in Markdown. --&gt;
&lt;!-- To generate the roff version, run `just man`, --&gt;
&lt;!-- and the man page will appear in the ‘target’ directory. --&gt;
<h1>NAME</h1>
<p>eza — a modern replacement for ls</p>
<h1>SYNOPSIS</h1>
<p><code>eza [options] [files...]</code></p>
<p><strong>eza</strong> is a modern replacement for <code>ls</code>.
It uses colours for information by default, helping you distinguish between many types of files, such as whether you are the owner, or in the owning group.</p>
<p>It also has extra features not present in the original <code>ls</code>, such as viewing the Git status for a directory, or recursing into directories with a tree view.</p>
<h1>EXAMPLES</h1>
<p><code>eza</code>
: Lists the contents of the current directory in a grid.</p>
<p><code>eza --oneline --reverse --sort=size</code>
: Displays a list of files with the largest at the top.</p>
<p><code>eza --long --header --inode --git</code>
: Displays a table of files with a header, showing each file’s metadata, inode, and Git status.</p>
<p><code>eza --long --tree --level=3</code>
: Displays a tree of files, three levels deep, as well as each file’s metadata.</p>
<h1>META OPTIONS</h1>
<p><code>--help</code>
: Show list of command-line options.</p>
<p><code>-v</code>, <code>--version</code>
: Show version of eza.</p>
<h1>DISPLAY OPTIONS</h1>
<p><code>-1</code>, <code>--oneline</code>
: Display one entry per line.</p>
<p><code>-F</code>, <code>--classify</code>
: Display file kind indicators next to file names.</p>
<p><code>-G</code>, <code>--grid</code>
: Display entries as a grid (default).</p>
<p><code>-l</code>, <code>--long</code>
: Display extended file metadata as a table.</p>
<p><code>-R</code>, <code>--recurse</code>
: Recurse into directories.</p>
<p><code>-T</code>, <code>--tree</code>
: Recurse into directories as a tree.</p>
<p><code>-X</code>, <code>--dereference</code>
: Dereference symbolic links when displaying information.</p>
<p><code>-x</code>, <code>--across</code>
: Sort the grid across, rather than downwards.</p>
<p><code>--color=WHEN</code>, <code>--colour=WHEN</code>
: When to use terminal colours (using ANSI escape code to colorize the output).</p>
<p>Valid settings are ‘<code>always</code>’, ‘<code>automatic</code>’ (or ‘<code>auto</code>’ for short), and ‘<code>never</code>’.
The default value is ‘<code>automatic</code>’.</p>
<p>The default behavior (‘<code>automatic</code>’ or ‘<code>auto</code>’) is to colorize the output only when the standard output is connected to a real terminal. If the output of <code>eza</code> is redirected to a file or piped into another program, terminal colors will not be used. Setting this option to ‘<code>always</code>’ causes <code>eza</code> to always output terminal color, while ‘<code>never</code>’ disables the use of terminal color.</p>
<p>Manually setting this option overrides <code>NO_COLOR</code> environment.</p>
<p><code>--color-scale</code>, <code>--colour-scale</code>
: Colour file sizes on a scale.</p>
<p><code>--icons</code>
: Display icons next to file names.</p>
<p><code>--no-icons</code>
: Don't display icons. (Always overrides --icons)</p>
<p><code>--no-quotes</code>
: Don't quote file names with spaces.</p>
<p><code>--hyperlink</code>
: Display entries as hyperlinks</p>
<p><code>-w</code>, <code>--width=COLS</code>
: Set screen width in columns.</p>
<h1>FILTERING AND SORTING OPTIONS</h1>
<p><code>-a</code>, <code>--all</code>
: Show hidden and “dot” files.
Use this twice to also show the ‘<code>.</code>’ and ‘<code>..</code>’ directories.</p>
<p><code>-A</code>, <code>--almost-all</code>
: Equivalent to --all; included for compatibility with <code>ls -A</code>.</p>
<p><code>-d</code>, <code>--list-dirs</code>
: List directories as regular files, rather than recursing and listing their contents.</p>
<p><code>-L</code>, <code>--level=DEPTH</code>
: Limit the depth of recursion.</p>
<p><code>-r</code>, <code>--reverse</code>
: Reverse the sort order.</p>
<p><code>-s</code>, <code>--sort=SORT_FIELD</code>
: Which field to sort by.</p>
<p>Valid sort fields are ‘<code>name</code>’, ‘<code>Name</code>’, ‘<code>extension</code>’, ‘<code>Extension</code>’, ‘<code>size</code>’, ‘<code>modified</code>’, ‘<code>changed</code>’, ‘<code>accessed</code>’, ‘<code>created</code>’, ‘<code>inode</code>’, ‘<code>type</code>’, and ‘<code>none</code>’.</p>
<p>The <code>modified</code> sort field has the aliases ‘<code>date</code>’, ‘<code>time</code>’, and ‘<code>newest</code>’, and its reverse order has the aliases ‘<code>age</code>’ and ‘<code>oldest</code>’.</p>
<p>Sort fields starting with a capital letter will sort uppercase before lowercase: ‘A’ then ‘B’ then ‘a’ then ‘b’. Fields starting with a lowercase letter will mix them: ‘A’ then ‘a’ then ‘B’ then ‘b’.</p>
<p><code>-I</code>, <code>--ignore-glob=GLOBS</code>
: Glob patterns, pipe-separated, of files to ignore.</p>
<p><code>--git-ignore</code> [if eza was built with git support]
: Do not list files that are ignored by Git.</p>
<p><code>--group-directories-first</code>
: List directories before other files.</p>
<p><code>-D</code>, <code>--only-dirs</code>
: List only directories, not files.</p>
<p><code>-f</code>, <code>--only-files</code>
: List only files, not directories.</p>
<h1>LONG VIEW OPTIONS</h1>
<p>These options are available when running with <code>--long</code> (<code>-l</code>):</p>
<p><code>-b</code>, <code>--binary</code>
: List file sizes with binary prefixes.</p>
<p><code>-B</code>, <code>--bytes</code>
: List file sizes in bytes, without any prefixes.</p>
<p><code>--changed</code>
: Use the changed timestamp field.</p>
<p><code>-g</code>, <code>--group</code>
: List each file’s group.</p>
<p><code>-h</code>, <code>--header</code>
: Add a header row to each column.</p>
<p><code>-H</code>, <code>--links</code>
: List each file’s number of hard links.</p>
<p><code>-i</code>, <code>--inode</code>
: List each file’s inode number.</p>
<p><code>-m</code>, <code>--modified</code>
: Use the modified timestamp field.</p>
<p><code>-M</code>, <code>--mounts</code>
: Show mount details (Linux and Mac only)</p>
<p><code>-n</code>, <code>--numeric</code>
: List numeric user and group IDs.</p>
<p><code>-S</code>, <code>--blocksize</code>
: List each file’s size of allocated file system blocks.</p>
<p><code>-t</code>, <code>--time=WORD</code>
: Which timestamp field to list.</p>
<p>: Valid timestamp fields are ‘<code>modified</code>’, ‘<code>changed</code>’, ‘<code>accessed</code>’, and ‘<code>created</code>’.</p>
<p><code>--time-style=STYLE</code>
: How to format timestamps.</p>
<p>: Valid timestamp styles are ‘<code>default</code>’, ‘<code>iso</code>’, ‘<code>long-iso</code>’, ‘<code>full-iso</code>’, ‘<code>relative</code>', or you can use a <code>custom</code> style with '<code>+</code>' as prefix. (Ex: "<code>+%Y/%m/%d, %H:%M</code>" =&gt; "<code>2023/9/30, 12:00</code>"). for more details about format syntax, please read: https://docs.rs/chrono/latest/chrono/format/strftime/index.html</p>
<p><code>-u</code>, <code>--accessed</code>
: Use the accessed timestamp field.</p>
<p><code>-U</code>, <code>--created</code>
: Use the created timestamp field.</p>
<p><code>--no-permissions</code>
: Suppress the permissions field.</p>
<p><code>-o</code>, <code>--octal-permissions</code>
: List each file's permissions in octal format.</p>
<p><code>--no-filesize</code>
: Suppress the file size field.</p>
<p><code>--no-user</code>
: Suppress the user field.</p>
<p><code>--no-time</code>
: Suppress the time field.</p>
<p><code>-@</code>, <code>--extended</code>
: List each file’s extended attributes and sizes.</p>
<p><code>-Z</code>, <code>--context</code>
: List each file's security context.</p>
<p><code>--git</code>  [if eza was built with git support]
: List each file’s Git status, if tracked.
This adds a two-character column indicating the staged and unstaged statuses respectively. The status character can be ‘<code>-</code>’ for not modified, ‘<code>M</code>’ for a modified file, ‘<code>N</code>’ for a new file, ‘<code>D</code>’ for deleted, ‘<code>R</code>’ for renamed, ‘<code>T</code>’ for type-change, ‘<code>I</code>’ for ignored, and ‘<code>U</code>’ for conflicted. Directories will be shown to have the status of their contents, which is how ‘deleted’ is possible if a directory contains a file that has a certain status, it will be shown to have that status.</p>
<p><code>--git-repos</code> [if eza was built with git support]
: List each directory’s Git status, if tracked.
Symbols shown are <code>|</code>= clean, <code>+</code>= dirty, and <code>~</code>= for unknown.</p>
<p><code>--git-repos-no-status</code> [if eza was built with git support]
: List if a directory is a Git repository, but not its status.
All Git repository directories will be shown as (themed) <code>-</code> without status indicated.</p>
<p><code>--no-git</code>
: Don't show Git status (always overrides <code>--git</code>, <code>--git-repos</code>, <code>--git-repos-no-status</code>)</p>
<h1>ENVIRONMENT VARIABLES</h1>
<p>If an environment variable prefixed with <code>EZA_</code> is not set, for backward compatibility, it will default to its counterpart starting with <code>EXA_</code>.</p>
<p>eza responds to the following environment variables:</p>
<h2><code>COLUMNS</code></h2>
<p>Overrides the width of the terminal, in characters, however, <code>-w</code> takes precedence.</p>
<p>For example, ‘<code>COLUMNS=80 eza</code>’ will show a grid view with a maximum width of 80 characters.</p>
<p>This option won’t do anything when eza’s output doesn’t wrap, such as when using the <code>--long</code> view.</p>
<h2><code>EZA_STRICT</code></h2>
<p>Enables <em>strict mode</em>, which will make eza error when two command-line options are incompatible.</p>
<p>Usually, options can override each other going right-to-left on the command line, so that eza can be given aliases: creating an alias ‘<code>eza=eza --sort=ext</code>’ then running ‘<code>eza --sort=size</code>’ with that alias will run ‘<code>eza --sort=ext --sort=size</code>’, and the sorting specified by the user will override the sorting specified by the alias.</p>
<p>In strict mode, the two options will not co-operate, and eza will error.</p>
<p>This option is intended for use with automated scripts and other situations where you want to be certain you’re typing in the right command.</p>
<h2><code>EZA_GRID_ROWS</code></h2>
<p>Limits the grid-details view (‘<code>eza --grid --long</code>’) so it’s only activated when at least the given number of rows of output would be generated.</p>
<p>With widescreen displays, it’s possible for the grid to look very wide and sparse, on just one or two lines with none of the columns lining up.
By specifying a minimum number of rows, you can only use the view if it’s going to be worth using.</p>
<h2><code>EZA_ICON_SPACING</code></h2>
<p>Specifies the number of spaces to print between an icon (see the ‘<code>--icons</code>’ option) and its file name.</p>
<p>Different terminals display icons differently, as they usually take up more than one character width on screen, so there’s no “standard” number of spaces that eza can use to separate an icon from text. One space may place the icon too close to the text, and two spaces may place it too far away. So the choice is left up to the user to configure depending on their terminal emulator.</p>
<h2><code>NO_COLOR</code></h2>
<p>Disables colours in the output (regardless of its value). Can be overridden by <code>--color</code> option.</p>
<p>See <code>https://no-color.org/</code> for details.</p>
<h2><code>LS_COLORS</code>, <code>EZA_COLORS</code></h2>
<p>Specifies the colour scheme used to highlight files based on their name and kind, as well as highlighting metadata and parts of the UI.</p>
<p>For more information on the format of these environment variables, see the <a href="/fork/eza/ref/v0.14.2/blob/man/eza_colors.5.md">eza_colors.5.md</a> manual page.</p>
<h2><code>EZA_OVERRIDE_GIT</code></h2>
<p>Overrides any <code>--git</code> or <code>--git-repos</code> argument</p>
<h1>EXIT STATUSES</h1>
<p>0
: If everything goes OK.</p>
<p>1
: If there was an I/O error during operation.</p>
<p>3
: If there was a problem with the command-line arguments.</p>
<h1>AUTHOR</h1>
<p>eza is maintained by Christina Sørensen and many other contributors.</p>
<p><strong>Source code:</strong> <code>https://github.com/eza-community/eza</code> <br />
<strong>Contributors:</strong> <code>https://github.com/eza-community/eza/graphs/contributors</code></p>
<p>Our infinite thanks to Benjamin ‘ogham’ Sago and all the other contributors of exa, from which eza was forked.</p>
<h1>SEE ALSO</h1>
<ul>
<li><a href="/fork/eza/ref/v0.14.2/blob/man/eza_colors.5.md">eza_colors.5.md</a></li>
<li><a href="/fork/eza/ref/v0.14.2/blob/man/eza_colors-explanation.5.md">eza_colors-explanation.5.md</a></li>
</ul>
</section><div class="code-panel"><pre class="code src language-markdown"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text">% eza(1) $version</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text"><a-c>&lt;!-- This is the eza(1) man page, written in Markdown. --&gt;</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text"><a-c>&lt;!-- To generate the roff version, run `just man`, --&gt;</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text"><a-c>&lt;!-- and the man page will appear in the ‘target’ directory. --&gt;</a-c></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text"><a-tt>NAME</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text"><a-p>====</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text">eza — a modern replacement for ls</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text"><a-tt>SYNOPSIS</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text"><a-p>========</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text">`eza [options] [files...]`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text">**eza** is a modern replacement for `ls`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text">It uses colours for information by default, helping you distinguish between many types of files, such as whether you are the owner, or in the owning group.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text">It also has extra features not present in the original `ls`, such as viewing the Git status for a directory, or recursing into directories with a tree view.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text"><a-tt>EXAMPLES</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"><a-p>========</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text">`eza`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text">: Lists the contents of the current directory in a grid.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text">`eza --oneline --reverse --sort=size`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text">: Displays a list of files with the largest at the top.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text">`eza --long --header --inode --git`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text">: Displays a table of files with a header, showing each file’s metadata, inode, and Git status.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text">`eza --long --tree --level=3`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text">: Displays a tree of files, three levels deep, as well as each file’s metadata.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"><a-tt>META OPTIONS</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"><a-p>===============</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text">`--help`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text">: Show list of command-line options.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text">`-v`, `--version`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text">: Show version of eza.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text"><a-tt>DISPLAY OPTIONS</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text"><a-p>===============</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text">`-1`, `--oneline`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text">: Display one entry per line.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text">`-F`, `--classify`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text">: Display file kind indicators next to file names.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text">`-G`, `--grid`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text">: Display entries as a grid (default).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text">`-l`, `--long`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text">: Display extended file metadata as a table.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L66" href="#L66">66</a><span class="code-text">`-R`, `--recurse`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L67" href="#L67">67</a><span class="code-text">: Recurse into directories.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L68" href="#L68">68</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L69" href="#L69">69</a><span class="code-text">`-T`, `--tree`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L70" href="#L70">70</a><span class="code-text">: Recurse into directories as a tree.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L71" href="#L71">71</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L72" href="#L72">72</a><span class="code-text">`-X`, `--dereference`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L73" href="#L73">73</a><span class="code-text">: Dereference symbolic links when displaying information.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L74" href="#L74">74</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L75" href="#L75">75</a><span class="code-text">`-x`, `--across`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L76" href="#L76">76</a><span class="code-text">: Sort the grid across, rather than downwards.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L77" href="#L77">77</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L78" href="#L78">78</a><span class="code-text">`--color=WHEN`, `--colour=WHEN`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L79" href="#L79">79</a><span class="code-text">: When to use terminal colours (using ANSI escape code to colorize the output).</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L80" href="#L80">80</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L81" href="#L81">81</a><span class="code-text">Valid settings are ‘`always`’, ‘`automatic`’ (or ‘`auto`’ for short), and ‘`never`’.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L82" href="#L82">82</a><span class="code-text">The default value is ‘`automatic`’.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L83" href="#L83">83</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L84" href="#L84">84</a><span class="code-text">The default behavior (‘`automatic`’ or ‘`auto`’) is to colorize the output only when the standard output is connected to a real terminal. If the output of `eza` is redirected to a file or piped into another program, terminal colors will not be used. Setting this option to ‘`always`’ causes `eza` to always output terminal color, while ‘`never`’ disables the use of terminal color.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L85" href="#L85">85</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L86" href="#L86">86</a><span class="code-text">Manually setting this option overrides `NO_COLOR` environment.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L87" href="#L87">87</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L88" href="#L88">88</a><span class="code-text">`--color-scale`, `--colour-scale`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L89" href="#L89">89</a><span class="code-text">: Colour file sizes on a scale.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L90" href="#L90">90</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L91" href="#L91">91</a><span class="code-text">`--icons`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L92" href="#L92">92</a><span class="code-text">: Display icons next to file names.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L93" href="#L93">93</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L94" href="#L94">94</a><span class="code-text">`--no-icons`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L95" href="#L95">95</a><span class="code-text">: Don&#39;t display icons. (Always overrides --icons)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L96" href="#L96">96</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L97" href="#L97">97</a><span class="code-text">`--no-quotes`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L98" href="#L98">98</a><span class="code-text">: Don&#39;t quote file names with spaces.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L99" href="#L99">99</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L100" href="#L100">100</a><span class="code-text">`--hyperlink`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L101" href="#L101">101</a><span class="code-text">: Display entries as hyperlinks</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L102" href="#L102">102</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L103" href="#L103">103</a><span class="code-text">`-w`, `--width=COLS`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L104" href="#L104">104</a><span class="code-text">: Set screen width in columns.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L105" href="#L105">105</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L106" href="#L106">106</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L107" href="#L107">107</a><span class="code-text"><a-tt>FILTERING AND SORTING OPTIONS</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L108" href="#L108">108</a><span class="code-text"><a-p>=============================</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L109" href="#L109">109</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L110" href="#L110">110</a><span class="code-text">`-a`, `--all`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L111" href="#L111">111</a><span class="code-text">: Show hidden and “dot” files.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L112" href="#L112">112</a><span class="code-text">Use this twice to also show the ‘`.`’ and ‘`..`’ directories.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L113" href="#L113">113</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L114" href="#L114">114</a><span class="code-text">`-A`, `--almost-all`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L115" href="#L115">115</a><span class="code-text">: Equivalent to --all; included for compatibility with `ls -A`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L116" href="#L116">116</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L117" href="#L117">117</a><span class="code-text">`-d`, `--list-dirs`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L118" href="#L118">118</a><span class="code-text">: List directories as regular files, rather than recursing and listing their contents.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L119" href="#L119">119</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L120" href="#L120">120</a><span class="code-text">`-L`, `--level=DEPTH`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L121" href="#L121">121</a><span class="code-text">: Limit the depth of recursion.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L122" href="#L122">122</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L123" href="#L123">123</a><span class="code-text">`-r`, `--reverse`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L124" href="#L124">124</a><span class="code-text">: Reverse the sort order.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L125" href="#L125">125</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L126" href="#L126">126</a><span class="code-text">`-s`, `--sort=SORT_FIELD`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L127" href="#L127">127</a><span class="code-text">: Which field to sort by.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L128" href="#L128">128</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L129" href="#L129">129</a><span class="code-text">Valid sort fields are ‘`name`’, ‘`Name`’, ‘`extension`’, ‘`Extension`’, ‘`size`’, ‘`modified`’, ‘`changed`’, ‘`accessed`’, ‘`created`’, ‘`inode`’, ‘`type`’, and ‘`none`’.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L130" href="#L130">130</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L131" href="#L131">131</a><span class="code-text">The `modified` sort field has the aliases ‘`date`’, ‘`time`’, and ‘`newest`’, and its reverse order has the aliases ‘`age`’ and ‘`oldest`’.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L132" href="#L132">132</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L133" href="#L133">133</a><span class="code-text">Sort fields starting with a capital letter will sort uppercase before lowercase: ‘A’ then ‘B’ then ‘a’ then ‘b’. Fields starting with a lowercase letter will mix them: ‘A’ then ‘a’ then ‘B’ then ‘b’.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L134" href="#L134">134</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L135" href="#L135">135</a><span class="code-text">`-I`, `--ignore-glob=GLOBS`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L136" href="#L136">136</a><span class="code-text">: Glob patterns, pipe-separated, of files to ignore.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L137" href="#L137">137</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L138" href="#L138">138</a><span class="code-text">`--git-ignore` [if eza was built with git support]</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L139" href="#L139">139</a><span class="code-text">: Do not list files that are ignored by Git.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L140" href="#L140">140</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L141" href="#L141">141</a><span class="code-text">`--group-directories-first`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L142" href="#L142">142</a><span class="code-text">: List directories before other files.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L143" href="#L143">143</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L144" href="#L144">144</a><span class="code-text">`-D`, `--only-dirs`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L145" href="#L145">145</a><span class="code-text">: List only directories, not files.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L146" href="#L146">146</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L147" href="#L147">147</a><span class="code-text">`-f`, `--only-files`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L148" href="#L148">148</a><span class="code-text">: List only files, not directories.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L149" href="#L149">149</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L150" href="#L150">150</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L151" href="#L151">151</a><span class="code-text"><a-tt>LONG VIEW OPTIONS</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L152" href="#L152">152</a><span class="code-text"><a-p>=================</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L153" href="#L153">153</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L154" href="#L154">154</a><span class="code-text">These options are available when running with `--long` (`-l`):</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L155" href="#L155">155</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L156" href="#L156">156</a><span class="code-text">`-b`, `--binary`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L157" href="#L157">157</a><span class="code-text">: List file sizes with binary prefixes.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L158" href="#L158">158</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L159" href="#L159">159</a><span class="code-text">`-B`, `--bytes`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L160" href="#L160">160</a><span class="code-text">: List file sizes in bytes, without any prefixes.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L161" href="#L161">161</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L162" href="#L162">162</a><span class="code-text">`--changed`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L163" href="#L163">163</a><span class="code-text">: Use the changed timestamp field.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L164" href="#L164">164</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L165" href="#L165">165</a><span class="code-text">`-g`, `--group`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L166" href="#L166">166</a><span class="code-text">: List each file’s group.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L167" href="#L167">167</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L168" href="#L168">168</a><span class="code-text">`-h`, `--header`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L169" href="#L169">169</a><span class="code-text">: Add a header row to each column.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L170" href="#L170">170</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L171" href="#L171">171</a><span class="code-text">`-H`, `--links`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L172" href="#L172">172</a><span class="code-text">: List each file’s number of hard links.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L173" href="#L173">173</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L174" href="#L174">174</a><span class="code-text">`-i`, `--inode`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L175" href="#L175">175</a><span class="code-text">: List each file’s inode number.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L176" href="#L176">176</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L177" href="#L177">177</a><span class="code-text">`-m`, `--modified`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L178" href="#L178">178</a><span class="code-text">: Use the modified timestamp field.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L179" href="#L179">179</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L180" href="#L180">180</a><span class="code-text">`-M`, `--mounts`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L181" href="#L181">181</a><span class="code-text">: Show mount details (Linux and Mac only)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L182" href="#L182">182</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L183" href="#L183">183</a><span class="code-text">`-n`, `--numeric`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L184" href="#L184">184</a><span class="code-text">: List numeric user and group IDs.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L185" href="#L185">185</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L186" href="#L186">186</a><span class="code-text">`-S`, `--blocksize`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L187" href="#L187">187</a><span class="code-text">: List each file’s size of allocated file system blocks.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L188" href="#L188">188</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L189" href="#L189">189</a><span class="code-text">`-t`, `--time=WORD`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L190" href="#L190">190</a><span class="code-text">: Which timestamp field to list.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L191" href="#L191">191</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L192" href="#L192">192</a><span class="code-text">: Valid timestamp fields are ‘`modified`’, ‘`changed`’, ‘`accessed`’, and ‘`created`’.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L193" href="#L193">193</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L194" href="#L194">194</a><span class="code-text">`--time-style=STYLE`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L195" href="#L195">195</a><span class="code-text">: How to format timestamps.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L196" href="#L196">196</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L197" href="#L197">197</a><span class="code-text">: Valid timestamp styles are ‘`default`’, ‘`iso`’, ‘`long-iso`’, ‘`full-iso`’, ‘`relative`&#39;, or you can use a `custom` style with &#39;`+`&#39; as prefix. (Ex: &quot;`+%Y/%m/%d, %H:%M`&quot; =&gt; &quot;`2023/9/30, 12:00`&quot;). for more details about format syntax, please read: https://docs.rs/chrono/latest/chrono/format/strftime/index.html</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L198" href="#L198">198</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L199" href="#L199">199</a><span class="code-text">`-u`, `--accessed`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L200" href="#L200">200</a><span class="code-text">: Use the accessed timestamp field.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L201" href="#L201">201</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L202" href="#L202">202</a><span class="code-text">`-U`, `--created`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L203" href="#L203">203</a><span class="code-text">: Use the created timestamp field.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L204" href="#L204">204</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L205" href="#L205">205</a><span class="code-text">`--no-permissions`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L206" href="#L206">206</a><span class="code-text">: Suppress the permissions field.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L207" href="#L207">207</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L208" href="#L208">208</a><span class="code-text">`-o`, `--octal-permissions`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L209" href="#L209">209</a><span class="code-text">: List each file&#39;s permissions in octal format.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L210" href="#L210">210</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L211" href="#L211">211</a><span class="code-text">`--no-filesize`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L212" href="#L212">212</a><span class="code-text">: Suppress the file size field.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L213" href="#L213">213</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L214" href="#L214">214</a><span class="code-text">`--no-user`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L215" href="#L215">215</a><span class="code-text">: Suppress the user field.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L216" href="#L216">216</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L217" href="#L217">217</a><span class="code-text">`--no-time`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L218" href="#L218">218</a><span class="code-text">: Suppress the time field.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L219" href="#L219">219</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L220" href="#L220">220</a><span class="code-text">`-@`, `--extended`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L221" href="#L221">221</a><span class="code-text">: List each file’s extended attributes and sizes.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L222" href="#L222">222</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L223" href="#L223">223</a><span class="code-text">`-Z`, `--context`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L224" href="#L224">224</a><span class="code-text">: List each file&#39;s security context.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L225" href="#L225">225</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L226" href="#L226">226</a><span class="code-text">`--git`  [if eza was built with git support]</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L227" href="#L227">227</a><span class="code-text">: List each file’s Git status, if tracked.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L228" href="#L228">228</a><span class="code-text">This adds a two-character column indicating the staged and unstaged statuses respectively. The status character can be ‘`-`’ for not modified, ‘`M`’ for a modified file, ‘`N`’ for a new file, ‘`D`’ for deleted, ‘`R`’ for renamed, ‘`T`’ for type-change, ‘`I`’ for ignored, and ‘`U`’ for conflicted. Directories will be shown to have the status of their contents, which is how ‘deleted’ is possible if a directory contains a file that has a certain status, it will be shown to have that status.  </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L229" href="#L229">229</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L230" href="#L230">230</a><span class="code-text">`--git-repos` [if eza was built with git support]</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L231" href="#L231">231</a><span class="code-text">: List each directory’s Git status, if tracked.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L232" href="#L232">232</a><span class="code-text">Symbols shown are `|`= clean, `+`= dirty, and `~`= for unknown.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L233" href="#L233">233</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L234" href="#L234">234</a><span class="code-text">`--git-repos-no-status` [if eza was built with git support]</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L235" href="#L235">235</a><span class="code-text">: List if a directory is a Git repository, but not its status.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L236" href="#L236">236</a><span class="code-text">All Git repository directories will be shown as (themed) `-` without status indicated.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L237" href="#L237">237</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L238" href="#L238">238</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L239" href="#L239">239</a><span class="code-text">`--no-git`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L240" href="#L240">240</a><span class="code-text">: Don&#39;t show Git status (always overrides `--git`, `--git-repos`, `--git-repos-no-status`)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L241" href="#L241">241</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L242" href="#L242">242</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L243" href="#L243">243</a><span class="code-text"><a-tt>ENVIRONMENT VARIABLES</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L244" href="#L244">244</a><span class="code-text"><a-p>=====================</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L245" href="#L245">245</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L246" href="#L246">246</a><span class="code-text">If an environment variable prefixed with `EZA_` is not set, for backward compatibility, it will default to its counterpart starting with `EXA_`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L247" href="#L247">247</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L248" href="#L248">248</a><span class="code-text">eza responds to the following environment variables:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L249" href="#L249">249</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L250" href="#L250">250</a><span class="code-text"><a-p>##</a-p> <a-tt>`COLUMNS`</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L251" href="#L251">251</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L252" href="#L252">252</a><span class="code-text">Overrides the width of the terminal, in characters, however, `-w` takes precedence.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L253" href="#L253">253</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L254" href="#L254">254</a><span class="code-text">For example, ‘`COLUMNS=80 eza`’ will show a grid view with a maximum width of 80 characters.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L255" href="#L255">255</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L256" href="#L256">256</a><span class="code-text">This option won’t do anything when eza’s output doesn’t wrap, such as when using the `--long` view.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L257" href="#L257">257</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L258" href="#L258">258</a><span class="code-text"><a-p>##</a-p> <a-tt>`EZA_STRICT`</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L259" href="#L259">259</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L260" href="#L260">260</a><span class="code-text">Enables _strict mode_, which will make eza error when two command-line options are incompatible.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L261" href="#L261">261</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L262" href="#L262">262</a><span class="code-text">Usually, options can override each other going right-to-left on the command line, so that eza can be given aliases: creating an alias ‘`eza=eza --sort=ext`’ then running ‘`eza --sort=size`’ with that alias will run ‘`eza --sort=ext --sort=size`’, and the sorting specified by the user will override the sorting specified by the alias.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L263" href="#L263">263</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L264" href="#L264">264</a><span class="code-text">In strict mode, the two options will not co-operate, and eza will error.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L265" href="#L265">265</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L266" href="#L266">266</a><span class="code-text">This option is intended for use with automated scripts and other situations where you want to be certain you’re typing in the right command.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L267" href="#L267">267</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L268" href="#L268">268</a><span class="code-text"><a-p>##</a-p> <a-tt>`EZA_GRID_ROWS`</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L269" href="#L269">269</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L270" href="#L270">270</a><span class="code-text">Limits the grid-details view (‘`eza --grid --long`’) so it’s only activated when at least the given number of rows of output would be generated.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L271" href="#L271">271</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L272" href="#L272">272</a><span class="code-text">With widescreen displays, it’s possible for the grid to look very wide and sparse, on just one or two lines with none of the columns lining up.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L273" href="#L273">273</a><span class="code-text">By specifying a minimum number of rows, you can only use the view if it’s going to be worth using.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L274" href="#L274">274</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L275" href="#L275">275</a><span class="code-text"><a-p>##</a-p> <a-tt>`EZA_ICON_SPACING`</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L276" href="#L276">276</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L277" href="#L277">277</a><span class="code-text">Specifies the number of spaces to print between an icon (see the ‘`--icons`’ option) and its file name.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L278" href="#L278">278</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L279" href="#L279">279</a><span class="code-text">Different terminals display icons differently, as they usually take up more than one character width on screen, so there’s no “standard” number of spaces that eza can use to separate an icon from text. One space may place the icon too close to the text, and two spaces may place it too far away. So the choice is left up to the user to configure depending on their terminal emulator.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L280" href="#L280">280</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L281" href="#L281">281</a><span class="code-text"><a-p>##</a-p> <a-tt>`NO_COLOR`</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L282" href="#L282">282</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L283" href="#L283">283</a><span class="code-text">Disables colours in the output (regardless of its value). Can be overridden by `--color` option.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L284" href="#L284">284</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L285" href="#L285">285</a><span class="code-text">See `https://no-color.org/` for details.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L286" href="#L286">286</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L287" href="#L287">287</a><span class="code-text"><a-p>##</a-p> <a-tt>`LS_COLORS`, `EZA_COLORS`</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L288" href="#L288">288</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L289" href="#L289">289</a><span class="code-text">Specifies the colour scheme used to highlight files based on their name and kind, as well as highlighting metadata and parts of the UI.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L290" href="#L290">290</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L291" href="#L291">291</a><span class="code-text">For more information on the format of these environment variables, see the [eza_colors.5.md](eza_colors.5.md) manual page.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L292" href="#L292">292</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L293" href="#L293">293</a><span class="code-text"><a-p>##</a-p> <a-tt>`EZA_OVERRIDE_GIT`</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L294" href="#L294">294</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L295" href="#L295">295</a><span class="code-text">Overrides any `--git` or `--git-repos` argument</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L296" href="#L296">296</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L297" href="#L297">297</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L298" href="#L298">298</a><span class="code-text"><a-tt>EXIT STATUSES</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L299" href="#L299">299</a><span class="code-text"><a-p>=============</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L300" href="#L300">300</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L301" href="#L301">301</a><span class="code-text">0</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L302" href="#L302">302</a><span class="code-text">: If everything goes OK.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L303" href="#L303">303</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L304" href="#L304">304</a><span class="code-text">1</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L305" href="#L305">305</a><span class="code-text">: If there was an I/O error during operation.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L306" href="#L306">306</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L307" href="#L307">307</a><span class="code-text">3</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L308" href="#L308">308</a><span class="code-text">: If there was a problem with the command-line arguments.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L309" href="#L309">309</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L310" href="#L310">310</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L311" href="#L311">311</a><span class="code-text"><a-tt>AUTHOR</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L312" href="#L312">312</a><span class="code-text"><a-p>======</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L313" href="#L313">313</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L314" href="#L314">314</a><span class="code-text">eza is maintained by Christina Sørensen and many other contributors.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L315" href="#L315">315</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L316" href="#L316">316</a><span class="code-text">**Source code:** `https://github.com/eza-community/eza` \</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L317" href="#L317">317</a><span class="code-text">**Contributors:** `https://github.com/eza-community/eza/graphs/contributors`</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L318" href="#L318">318</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L319" href="#L319">319</a><span class="code-text">Our infinite thanks to Benjamin ‘ogham’ Sago and all the other contributors of exa, from which eza was forked.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L320" href="#L320">320</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L321" href="#L321">321</a><span class="code-text"><a-tt>SEE ALSO</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L322" href="#L322">322</a><span class="code-text"><a-p>========</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L323" href="#L323">323</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L324" href="#L324">324</a><span class="code-text"><a-p>- </a-p>[eza_colors.5.md](eza_colors.5.md)</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L325" href="#L325">325</a><span class="code-text"><a-p>- </a-p>[eza_colors-explanation.5.md](eza_colors-explanation.5.md)</span></span></pre></div></div>
</main>
</body>
</html>
