Artifact [870a8597bb]

Artifact 870a8597bb20b36fbda2fd48a5b58fb9745f980c:

Wiki page [Manual] by rkeene on 2014-02-08 02:44:00.
D 2014-02-08T02:44:00.349
L Manual
P 6ed6ec75caafb1bbf82c37537718f4501aaadfc8
U rkeene
W 2852
<H2>NAME</H2>
filed - serve files over HTTP
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>filed</B>
&#91;{<B>-h</B>|<B>--help</B>}&#93;
&#91;{<B>-d</B>|<B>--daemon</B>}&#93;
&#91;{<B>-b</B>|<B>--bind</B>}
<I>address</I>&#93;
&#91;{<B>-p</B>|<B>--port</B>}
<I>port</I>&#93;
&#91;{<B>-t</B>|<B>--threads</B>}
<I>count</I>&#93;
&#91;{<B>-c</B>|<B>--cache</B>}
<I>entries</I>&#93;
&#91;{<B>-l</B>|<B>--log</B>}
<I>file</I>&#93;
&#91;{<B>-u</B>|<B>--user</B>}
<I>user</I>&#93;
&#91;{<B>-r</B>|<B>--root</B>}
<I>directory</I>&#93;
<P>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<I>FILED</I>
serves files over HTTP as minimally as possible.  Only static files (i.e., files that never change or are replaced) are supported.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT><B>-h (or --help)</B>
<DD>
Prints detailed usage information
<P>
<DT><B>-d (or --daemon)</B>
<DD>
Instructs
<B>filed</B>
to become a daemon after initializing
the listening TCP socket and log files.
<P>
<DT><B>-b (or --bind)</B>
<DD>
Specifies the address to listen for incoming HTTP
requests on.
<P>
<DT><B>-p (or --port)</B>
<DD>
Specifies the TCP port number to listen for incoming HTTP
requests on.
<P>
<DT><B>-t (or --threads)</B>
<DD>
Specifies the number of worker threads to create. Each
worker thread can service one concurrent HTTP session.
Thus the number of threads created will determine how
many simultaneous transfers will be possible.
<P>
<DT><B>-c (or --cache)</B>
<DD>
Specifies the number of file information cache entries
to allocate.  Each cache entry holds file information as
well as an open file descriptor to the file, so resource
limits (i.e., ulimit) should be considered.  This should
be a prime number for ideal use with the lookup method.
<P>
<DT><B>-l (or --log)</B>
<DD>
Specifies a filename to open for writing log entries.  Log
entries are made for various stages in transfering files.
The log file is opened before switching users (see &quot;-u&quot;)
and root directories (see &quot;-r&quot;).  The log file is never
closed so log rotation without stopping the daemon is will
not work.  The value of &quot;-&quot; indicates that standard output
should be used for logging.
<P>
<DT><B>-u (or --user)</B>
<DD>
Specifies the user to switch user IDs to before servicing
requests.  The default is not change user IDs.
<P>
<DT><B>-r (or --root)</B>
<DD>
Specifies the directory to act as the root directory for
the file server.  If this option is specified, <A HREF="http://linux.die.net/man/2/chroot">chroot</A>(2)
is called.  The default is not change root directories,
that is, the &quot;/&quot; directory is shared out.  This will
likely be a security issue, so this option should always
be used.
<P>
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>AUTHOR</H2>
Roy Keene
<I>&lt;<A HREF="mailto:filed@rkeene.org">filed@rkeene.org</A>&gt;</I>
<P>

Z a9a7e6bc39a0361cd09da608dd875f4e