Update of "Manual"
Overview

Artifact ID: 05a55d927599acf2c1d4f9f3f50b6ad319b8bfe4
Page Name:Manual
Date: 2014-02-08 02:29:44
Original User: rkeene
Parent: 7227ed2b734274233938ae1fb4b9fc2d1367b09b
Content

FILED

Section: User Commands (1)
Updated: 06 Feb 14
Index
 

NAME

filed - serve files over HTTP  

SYNOPSIS

filed [{-h|--help}] [{-d|--daemon}] [{-b|--bind} address] [{-p|--port} port] [{-t|--threads} count] [{-c|--cache} entries] [{-l|--log} file] [{-u|--user} user] [{-r|--root} directory]

 

DESCRIPTION

FILED serves files over HTTP as minimally as possible. Only static files (i.e., files that never change or are replaced) are supported.

 

OPTIONS

-h (or --help)
Prints detailed usage information

-d (or --daemon)
Instructs filed to become a daemon after initializing the listening TCP socket and log files.

-b (or --bind)
Specifies the address to listen for incoming HTTP requests on.

-p (or --port)
Specifies the TCP port number to listen for incoming HTTP requests on.

-t (or --threads)
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.

-c (or --cache)
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.

-l (or --log)
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 "-u") and root directories (see "-r"). The log file is never closed so log rotation without stopping the daemon is will not work. The value of "-" indicates that standard output should be used for logging.

-u (or --user)
Specifies the user to switch user IDs to before servicing requests. The default is not change user IDs.

-r (or --root)
Specifies the directory to act as the root directory for the file server. If this option is specified, chroot(2) is called. The default is not change root directories, that is, the "/" directory is shared out. This will likely be a security issue, so this option should always be used.

 

AUTHOR

Roy Keene <filed@rkeene.org>


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
AUTHOR