Gecko [ www.thearyasamaj.org ]

Name	Size	Permission
ASCII.html	3.71 KB	-rw-r--r--
AWS.html	26.05 KB	-rw-r--r--
AuthFiles.html	9.54 KB	-rw-r--r--
Authentication.html	15.32 KB	-rw-r--r--
BCP.html	13.7 KB	-rw-r--r--
Chroot.html	14.27 KB	-rw-r--r--
Classes.html	5.92 KB	-rw-r--r--
Compiling.html	34.11 KB	-rw-r--r--
ConfigFile.html	16.47 KB	-rw-r--r--
ConfigurationTricks.html	16.54 KB	-rw-r--r--
ConnectionACLs.html	6.84 KB	-rw-r--r--
Controls.html	11.95 KB	-rw-r--r--
CreateHome.html	7.79 KB	-rw-r--r--
DNS.html	6.92 KB	-rw-r--r--
DSO.html	14.9 KB	-rw-r--r--
Debugging.html	12.47 KB	-rw-r--r--
Directory.html	10.89 KB	-rw-r--r--
DisplayFiles.html	6.69 KB	-rw-r--r--
ECCN.html	4.73 KB	-rw-r--r--
FTP.html	16.09 KB	-rw-r--r--
FXP.html	5.57 KB	-rw-r--r--
Filters.html	7.93 KB	-rw-r--r--
Globbing.html	5.53 KB	-rw-r--r--
KeepAlives.html	19.68 KB	-rw-r--r--
Limit.html	15.08 KB	-rw-r--r--
ListOptions.html	6.18 KB	-rw-r--r--
LogLevels.html	5.08 KB	-rw-r--r--
LogMessages.html	14.89 KB	-rw-r--r--
Logging.html	22.37 KB	-rw-r--r--
Memcache.html	9.04 KB	-rw-r--r--
NAT.html	11.15 KB	-rw-r--r--
Nonroot.html	4.23 KB	-rw-r--r--
Quotas.html	17.17 KB	-rw-r--r--
Radius.html	17.35 KB	-rw-r--r--
Redis.html	8.53 KB	-rw-r--r--
Regex.html	22.23 KB	-rw-r--r--
Rewrite.html	16.8 KB	-rw-r--r--
SQL.html	40.55 KB	-rw-r--r--
SSH.html	5.14 KB	-rw-r--r--
Scoreboard.html	9.11 KB	-rw-r--r--
Sendfile.html	7.34 KB	-rw-r--r--
ServerType.html	10.45 KB	-rw-r--r--
Stopping.html	10.31 KB	-rw-r--r--
TLS.html	58.93 KB	-rw-r--r--
Testing.html	8.73 KB	-rw-r--r--
Timestamps.html	6.71 KB	-rw-r--r--
Tracing.html	8.68 KB	-rw-r--r--
Translations.html	3.52 KB	-rw-r--r--
Umask.html	9.16 KB	-rw-r--r--
Upgrade.html	2.14 KB	-rw-r--r--
Versioning.html	5.41 KB	-rw-r--r--
Vhost.html	11.55 KB	-rw-r--r--
VirtualUsers.html	8.8 KB	-rw-r--r--
ftpaccess.html	2.03 KB	-rw-r--r--
index.html	10.45 KB	-rw-r--r--

Code Editor : ListOptions.html

<!DOCTYPE html>
<html>
<head>
<title>ProFTPD: Directory Lists and ListOptions</title>
</head>

<hr>
<center><h2>Directory Lists and <code>ListOptions</code></h2></center>
<hr>

The <code><a href="../modules/mod_ls.html#ListOptions">ListOptions</a></code>
directive of ProFTPD can be used to control how directory listings are
generated. Directory listings are sent in response to the <code>LIST</code>
and <code>NLST</code> FTP commands.

The <code>ListOptions</code> directive supports the following options:
<ul>
 <li><dt>-1</dt>
 <dd>List one file per line</dd>
 <li><dt>-A</dt>
 <dd>List all files except &quot;.&quot; and &quot;..&quot;</dd>
 <li><dt>-a</dt>
 <dd>List all files including those whose names start with &quot;.&quot;</dd>
 <li><dt>-B</dt>
 <dd>Force printing of non-printable filename characters as \xxx, where xxx is the octal value of the character</dd>
 <li><dt>-C</dt>
 <dd>List entries by columns</dd>
 <li><dt>-c<dt>
 <dd>Sort by file status change time when <code>-t</code> is also used</dd>
 <li><dt>-d</dt>
 <dd>List directory entries instead of directory contents</dd>
 <li><dt>-F</dt>
 <dd>Append file type indicator (one of &quot;*&quot;, &quot;/&quot;, &quot;=&quot;, &quot;@&quot; or &quot;|&quot;) to names</dd>
 <li><dt>-h</dt>
 <dd>Print file sizes in human-readable format (e.g. 1K, 234M, 2G)</dd>
 <li><dt>-L</dt>
 <dd>List files pointed to by symlinks</dd>
 <li><dt>-l</dt>
 <dd>Use a long listing format</dd>
 <li><dt>-n</dt>
 <dd>List numeric UIDs/GIDs instead of user/group names</dd>
 <li><dt>-R</dt>
 <dd>List subdirectories recursively</dd>
 <li><dt>-r</dt>
 <dd>Sort filenames in reverse order</dd>
 <li><dt>-S</dt>
 <dd>Sort by file size</dd>
 <li><dt>-t</dt>
 <dd>Sort by file modification time</dd>
 <li><dt>-U<dt>
 <dd>Do not sort; list entries in directory order</dd>
 <li><dt>-u<dt>
 <dd>Sort by file access time when <code>-t</code> is also used</dd>
</ul>

Although not strictly supported by the FTP RFCs, many FTP clients send these
options with the <code>LIST</code> and <code>NLST</code> commands, and many
FTP servers honor them. The <code>ListOptions</code> directive configures
default options to be used, in addition to any sent by the client. For
example, to show all files except the &quot;hidden&quot; files for clients,
you could use:
<pre>
 ListOptions -a
</pre>

Another use of <code>ListOptions</code> is to prevent certain options
from being used. The <code>-R</code> option, for recursively listing
all subdirectories, can use a lot of system resources, especially on very
large and/or very deep directory structures, as <code>proftpd</code> scans
all of the files. For this reason, some sites may wish to prevent the
<code>-R</code> option from being used. <code>ListOptions</code> supports
this with use of the &quot;+&quot; character. Options are enabled using the
&quot;-&quot; character, thus they are disabled using &quot;+&quot;--think
of the &quot;+&quot; as cancelling out the &quot;-&quot;. For example:
<pre>
 ListOptions +R strict
</pre>
would disable all use of the <code>-R</code> option.

Where did the <code>strict</code> come from in the example above?
<code>ListOptions</code> configures a set of default options, but if a client
sends its own directory options, <code>proftpd</code> will use the client's
options instead. To ignore the client options and use only the
<code>ListOptions</code> configured, one uses the &quot;strict&quot; keyword.
That is why the <code>+R</code> example above required
&quot;strict&quot;--it causes <code>proftpd</code> to ignore any
<code>-R</code> option the client might send.

What if you wanted to enable some options and disable others in the same
<code>ListOptions</code> directive? You would surround your options in quotation marks, like so:
<pre>
 ListOptions &quot;-a +R&quot; strict
</pre>

If you are not using the <code>--enable-nls</code> configure option,
and you want to see non-printable characters in filenames when listing
directories, you should use:
<pre>
 ListOptions -B
</pre>

The following keywords are supported, in addition to &quot;strict&quot;:
<ul>
 <li><dt>maxfiles</dt>
 <dd>Sets a maximum limit on the number of files listed in one directory listing</dd>
 <li><dt>maxdirs</dt>
 <dd>Sets a maximum limit on the number of directories listed in one directory listing</dd>
 <li><dt>maxdepth</dt>
 <dd>Sets a maximum recursion depth, if the <code>-R</code> option is allowed</dd>
 <li><dt>LISTOnly</dt>
 <dd>Applies the <code>ListOptions</code> only to <code>LIST</code> commands (and not <code>NLST</code> or <code>STAT</code> commands)
 <li><dt>NLSTOnly</dt>
 <dd>Applies the <code>ListOptions</code> only to <code>NLST</code> commands (and not <code>LIST</code> or <code>STAT</code> commands)
 <li><dt>NoErrorIfAbsent</dt>
 <dd>Causes a 226 response code to be returned for <code>LIST/NLST</code> commands for files which do not exist, rather than 450
 <li><dt>SortedNLST</dt>
 <dd>Causes the <code>NLST</code> results to be sorted by name
</ul>
These keywords were added for finer-grained control over directory listings.
They make it possible to allow recursive listings and yet still apply limits,
to keep the recursion from taking too long:
<pre>
 ListOptions -a maxfiles 2000 maxdepth 3
</pre>
This configures the <code>-a</code> option by default, and limits the maximum
files in the generated listing to 2000. If the client uses the <code>-R</code>
option, <code>proftpd</code> will not recurse into directories more than 3
levels deep when generating the listing.

Or perhaps you want the one-file-per-line format, but only for
<code>NLST</code> commands and not <code>LIST</code> commands. You
would thus use something like:
<pre>
 ListOptions "-1" strict NLSTOnly
</pre>

Note that <code><a href="Limit.html">&lt;Limit&gt;</a></code> sections can be
used to block the <code>LIST</code> and <code>NLST</code> commands altogether.

</body>
</html>

${this.title}

Code Editor : ListOptions.html