Check-in [f1c59a3a0d]
Overview
Comment:Updated man page
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: f1c59a3a0d89b2f8ba91854d915d7d0bf0da73ff
User & Date: rkeene on 2014-02-07 20:43:52
Other Links: manifest | tags
Context
2014-02-07
21:06
Added install target check-in: 13b69230ce user: rkeene tags: trunk
20:43
Updated man page check-in: f1c59a3a0d user: rkeene tags: trunk
2014-02-06
23:35
Added usage information check-in: a67c46369b user: rkeene tags: trunk
Changes

Modified filed.1 from [957f2aad04] to [fae93fba37].

1
2
3
4
5
6
7
8
9
10
11














12
13
14
15
16
17
18


19
20







































21
22
23
24
25
1
2
3
4
5
6
7




8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30


31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74







-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+







+
+
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+





.PU
.TH FILED 1 "06 Feb 14" "filed 1.0"
.SH NAME
filed \- serve files over HTTP
.SH SYNOPSIS
.ll +10
.B filed
.RB [ "\-h" ]
.RB [ \-p\ port ]
.RB [ \-t\ counts ]
.RB [ \-c\ entries ]
.RB [{ \-h | \-\-help }]
.RB [{ \-b | \-\-bind }
.IR address ]
.RB [{ \-p | \-\-port }
.IR port ]
.RB [{ \-t | \-\-threads }
.IR count ]
.RB [{ \-c | \-\-cache }
.IR entries ]
.RB [{ \-u | \-\-user }
.IR user ]
.RB [{ \-r | \-\-root }
.IR directory ]

.ll -10
.SH DESCRIPTION
.I FILED
serves files over HTTP as minimally as possible.  Only static files (i.e., files that never change or are replaced) are supported.

.SH OPTIONS
.TP
.B -h (or --help)
Prints detailed usage information
.B \-p
port

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

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

.TP
.B -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.

.TP
.B -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.

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

.TP
.B -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.

.SH AUTHOR
.Sp
Roy Keene
.I <filed@rkeene.org>