Make tarball generation quieter
[gpxe.git] / contrib / tftp / tftpd.8
blob6a154c10cd5dceced0aeda7b4267526216b39cd4
1 .\" Copyright (c) 1983 The Regents of the University of California.
2 .\" All rights reserved.
3 .\"
4 .\" Redistribution and use in source and binary forms are permitted
5 .\" provided that the above copyright notice and this paragraph are
6 .\" duplicated in all such forms and that any documentation,
7 .\" advertising materials, and other materials related to such
8 .\" distribution and use acknowledge that the software was developed
9 .\" by the University of California, Berkeley.  The name of the
10 .\" University may not be used to endorse or promote products derived
11 .\" from this software without specific prior written permission.
12 .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
13 .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
14 .\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
15 .\"
16 .\"     @(#)tftpd.8     6.3 (Berkeley) 9/20/88
17 .\"
18 .TH TFTPD 8 "September 20, 1988"
19 .UC 5
20 .SH NAME
21 tftpd \- DARPA Trivial File Transfer Protocol server
22 .SH SYNOPSIS
23 .B /etc/tftpd
25 .SM \-c
26 <rootdir> ] [
27 .SM \-d
28 ] [
29 .SM \-r
30 <filter> ]
31 .SH DESCRIPTION
32 .I Tftpd
33 is a server which supports the DARPA Trivial File Transfer
34 Protocol.
35 The TFTP server operates
36 at the port indicated in the ``tftp'' service description;
37 see
38 .IR services (5).
39 The server is normally started by
40 .IR inetd (8).
41 .PP
42 The use of
43 .I tftp
44 does not require an account or password on the remote system.
45 Due to the lack of authentication information, 
46 .I tftpd
47 will allow only publicly readable files to be
48 accessed.
49 Files may be written only if they already exist and are publicly writable.
50 Note that this extends the concept of ``public'' to include
51 all users on all hosts that can be reached through the network;
52 this may not be appropriate on all systems, and its implications
53 should be considered before enabling tftp service.
54 The server should have the user ID with the lowest possible privilege.
55 .SH OPTIONS
56 .TP
57 .B \-c
58 Pathname of a directory that is considered the rootdirectory for all
59 transfers. N.B.
60 .I tftpd
61 does not actually perform a
62 .IR chroot (2)
63 call; you should be aware of the security implications and you
64 probably should run the server from an unpriviledged account.
65 .TP
66 .B \-d
67 Increased debugging level.
68 .TP
69 .B \-r
70 Pathname of a file that is considered to be a filter program. Whenever
71 a client tries to download this file, the filter will be started and
72 its output is send to the client. An arbitrary amount of these
73 filters can be specified.
74 .SH "SEE ALSO"
75 tftp(1), inetd(8)