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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
.\" Hey, EMACS: -*- nroff -*-
.TH IN.TFTPD 8 "December 27, 2000"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
in.tftpd \- Trivial File Transfer Protocol Server.
.SH SYNOPSIS
.B in.tftpd
.RI [ options ] " path"
.SH DESCRIPTION
.B in.tftpd
is a TFTP (rfc1350) server. By default it is started by inetd, but may
run as a stand alone daemon. This server is multithreaded and supports
all options described in rfc2090 (multicast still experimental),
rfc2347 (option extension), rfc2348 (blksize) and rfc2349 (tsize and
timeout).
.SH OPTIONS
This program supports both the usual GNU command line syntax, with
long options starting with two dashes (`-') as well as short
options. A description of the options is included below.
.TP
.B \-t, \-\-tftpd\-timeout <value>
Number of seconds of inactivity before the server exits. Default is
300 seconds.
.TP
.B \-r, \-\-retry\-timeout <value>
How many seconds to wait for a reply before retransimitting a
packet. Default is 5 seconds. This can be overridden by the tftp
client.
.TP
.B \-m, \-\-maxthread <value>
Maximum number of concurrent threads allowed. Default is 100.
.TP
.B \-v, \-\-verbose[=value]
Increase or set the logging level. No args will increase by one the
current value. Default is LOG_NOTICE, see syslog(3) for log
level. Current value range from 0 (LOG_EMERG) to 7 (LOG_DEBUG).
.TP
.B \-\-no\-timeout
disable 'timeout' from RFC2349. This will prevent the server from
acknowledging timeout option requested by the client.
.TP
.B \-\-no\-tsize
disable 'tsize' from RFC2349. This will prevent the server from
acknowledging tsize option requested by the client.
.TP
.B \-\-no\-blksize
disable 'blksize' from RFC2348. This will prevent the server from
acknowledging blksize request by the client.
.TP
.B \-\-no\-multicast
disable 'multicast' from RFC2090. This will prevent the server from
acknowledging multicast request by the client.
.TP
.B \-\-logfile <logfile>
Log to a specific file instead of only syslog. 'nobody' (or any user
used to run the server) must have permissions on the given
file. Assuming the file is /var/log/atftpd.log, simply run: "touch
/var/log/atftpd.log" and then "chown nobody.nogroup
/var/log/atftpd.log". When the server is ran in daemon mode,
/dev/stdout or /dev/stderr can be used.
.TP
.B \-\-daemon
Run as a daemon. Do not use this option if atftpd is started by inetd.
.TP
.B \-\-no-fork
When \-\-daemon is specified, this option will prevent the server from
forking to backgroung. It is useful for debugging purpose or
specialized usage.
.TP
.B \-\-user <user[.group]>
By default, the server change identity to the user nobody and group
nogroup. Specify an alternate user.group with this option.
.TP
.B \-\-group <group>
Alternate way of specifing the group. If group is specified with
\-\-user and \-\-group, the last option will be used.
.TP
.B \-\-port
Specify the port on which atftpd listen. Useful in when \-\-daemon is
specified.
.TP
.B \-\-mcast_ttl
Specify the ttl to be used for multicast datagram. By default a value
of 1 is used.
.TP
.B \-\-mcast_addr
Specify the IP address range to be used for multicast transfer. Format
string may comprise range and list of values:
"239.255.0.0-31,128-132,200". Default value is "239.255.0.0-255".
.TP
.B \-\-mcast_port
Specify TCP port to use for multicast transfer. Format string may
contain range and list of port number: "1753-2000,8000-9000". default
value is "1753".
.TP
.B \-h, \-\-help
Show summary of options.
.TP
.B \-V, \-\-version
Show version of program.
.TP
.B path
This is the root directory used by the in.tftpd server. All requested
files from a TFTP client must reside in this directory. If not
specified, the directory defaults to /tftpboot. Since
in.tftpd run as the 'nobody' user, the permission of the directory
must be set properly to allow file reading and writing.
.SH STATS
Starting with release 0.2, the server collects some statistics.
Currently the server compute system load, time between connections and
some thread statistics like number of file sent, received, number of
abort... To see those stats in the logs, you need to set --verbose=6
(LOG_NOTICE) or higher.
.SH SEE ALSO
.BR inetd (8),
RFC1350, RFC2090, RFC2347, RFC2348 and RFC2349.
.SH AUTHOR
This manual page was written by Remi Lefebvre <remi@debian.org> and Jean-Pierre
Lefebvre <helix@step.polymtl.ca>.
|
