1 '\" te
2 .\" Copyright 1989 AT&T
3 .\" Copyright (C) 2008, Sun Microsystems, Inc. All Rights Reserved
4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
7 .TH IN.TFTPD 1M "Nov 5, 2008"
8 .SH NAME
9 in.tftpd, tftpd \- Internet Trivial File Transfer Protocol server
10 .SH SYNOPSIS
11 .LP
12 .nf
13 \fBin.tftpd\fR [\fB-d\fR] [\fB-T\fR \fIrexmtval\fR] [\fB-s\fR] [\fIhomedir\fR]
14 .fi
15
16 .SH DESCRIPTION
17 .sp
18 .LP
19 \fBtftpd\fR is a server that supports the Internet Trivial File Transfer
20 Protocol (TFTP).
21 .sp
22 .LP
23 Before responding to a request, the server attempts to change its current
24 directory to \fIhomedir\fR; the default directory is \fB/tftpboot\fR.
25 .sp
26 .LP
27 The use of \fBtftp\fR does not require an account or password on the remote
28 system. Due to the lack of authentication information, \fBin.tftpd\fR will
29 allow only publicly readable files to be accessed. Files may be written only if
30 they already exist and are publicly writable. Note that this extends the
31 concept of "public" to include all users on all hosts that can be reached
32 through the network. This may not be appropriate on all systems, and its
33 implications should be considered before enabling this service.
34 .sp
35 .LP
36 \fBin.tftpd\fR runs with the user \fBID\fR and group \fBID\fR set to
37 \fB[GU]ID_NOBODY\fR under the assumption that no files exist with that owner or
38 group. However, nothing checks this assumption or enforces this restriction.
39 .SH OPTIONS
40 .sp
41 .ne 2
42 .na
43 \fB\fB-d\fR\fR
44 .ad
45 .RS 15n
46 Debug. When specified it sets the \fBSO_DEBUG\fR socket option.
47 .RE
48
49 .sp
50 .ne 2
51 .na
52 \fB\fB-s\fR\fR
53 .ad
54 .RS 15n
55 Secure. When specified, the directory change to \fIhomedir\fR must succeed. The
56 daemon also changes its root directory to \fIhomedir\fR.
57 .RE
58
59 .sp
60 .ne 2
61 .na
62 \fB\fB-T\fR \fIrexmtval\fR\fR
63 .ad
64 .RS 15n
65 Specifies the value of the retransmission timeout in seconds. This also affects
66 the maximum session timeout in that the latter is set to five times the
67 retransmission timeout value.
68 .RE
69
70 .SH USAGE
71 .sp
72 .LP
73 The \fBin.tftpd\fR server is IPv6-enabled. See \fBip6\fR(7P).
74 .sp
75 .LP
76 \fBin.tftpd\fR supports transfers of greater than 32 MB, per RFC 2348.
77 .SH SEE ALSO
78 .sp
79 .LP
80 \fBsvcs\fR(1), \fBtftp\fR(1), \fBinetadm\fR(1M), \fBinetd\fR(1M),
81 \fBsvcadm\fR(1M), \fBnetconfig\fR(4), \fBattributes\fR(5), \fBsmf\fR(5),
82 \fBip6\fR(7P)
83 .sp
84 .LP
85 Malkin, G. and Harkin, A. \fIRFC 2347, TFTP Option Extension\fR. The Internet
86 Society. May 1998
87 .sp
88 .LP
89 Malkin, G. and Harkin, A. \fIRFC 2348, TFTP Blocksize Option\fR. The Internet
90 Society. May 1998
91 .sp
92 .LP
93 Malkin, G. and Harkin, A. \fIRFC 2349, TFTP Timeout Interval and Transfer Size
94 Options\fR. The Internet Society. May 1998
95 .sp
96 .LP
97 Sollins, K.R. \fIRFC 1350, The TFTP Protocol (Revision 2)\fR. Network Working
98 Group. July 1992.
99 .SH NOTES
100 .sp
101 .LP
102 The \fBtftpd\fR server only acknowledges the transfer size option that is sent
103 with a \fBread\fR request when the octet transfer mode is specified.
104 .sp
105 .LP
106 The \fBin.tftpd.1m\fR service is managed by the service management facility,
107 \fBsmf\fR(5), under the service identifier:
108 .sp
109 .in +2
110 .nf
111 svc:/network/tftp/udp6:default
112 .fi
113 .in -2
114 .sp
115
116 .sp
117 .LP
118 Administrative actions on this service, such as enabling, disabling, or
119 requesting restart, can be performed using \fBsvcadm\fR(1M). Responsibility for
120 initiating and restarting this service is delegated to \fBinetd\fR(1M). Use
121 \fBinetadm\fR(1M) to make configuration changes and to view configuration
122 information for this service. The service's status can be queried using the
123 \fBsvcs\fR(1) command.
124 .sp
125 .LP
126 Unlike most \fBsmf\fR(5) services, a manifest for the \fBtftp\fR service is not
127 included in the system. To create one and enable this service, the
128 administrator should:
129 .RS +4
130 .TP
131 1.
132 Edit \fB/etc/inet/inetd.conf\fR and uncomment the \fBtftp\fR entry.
133 .RE
134 .RS +4
135 .TP
136 2.
137 Run \fB/usr/sbin/inetconv\fR.
138 .RE
139 .sp
140 .LP
141 After you run \fBinetconv\fR, the \fBsvc:/network/tftp/udp6:default\fR service
142 is created and enabled.
|
1 '\" te
2 .\" Copyright 1989 AT&T
3 .\" Copyright (C) 2008, Sun Microsystems, Inc. All Rights Reserved
4 .\" Copyright 2015 Nexenta Systems, Inc. All rights reserved.
5 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
6 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
7 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
8 .TH IN.TFTPD 1M "Jun 17, 2015"
9 .SH NAME
10 in.tftpd, tftpd \- Internet Trivial File Transfer Protocol server
11 .SH SYNOPSIS
12 .LP
13 .nf
14 \fBin.tftpd\fR [\fB-d\fR] [\fB-T\fR \fIrexmtval\fR] [\fB-s\fR] [\fIhomedir\fR]
15 .fi
16
17 .SH DESCRIPTION
18 .LP
19 \fBtftpd\fR is a server that supports the Internet Trivial File Transfer
20 Protocol (TFTP).
21 .sp
22 .LP
23 Before responding to a request, the server attempts to change its current
24 directory to \fIhomedir\fR; the default directory is \fB/tftpboot\fR.
25 .sp
26 .LP
27 The use of \fBtftp\fR does not require an account or password on the remote
28 system. Due to the lack of authentication information, \fBin.tftpd\fR will
29 allow only publicly readable files to be accessed. Files may be written only if
30 they already exist and are publicly writable. Note that this extends the
31 concept of "public" to include all users on all hosts that can be reached
32 through the network. This may not be appropriate on all systems, and its
33 implications should be considered before enabling this service.
34 .sp
35 .LP
36 \fBin.tftpd\fR runs with the user \fBID\fR and group \fBID\fR set to
37 \fB[GU]ID_NOBODY\fR under the assumption that no files exist with that owner or
38 group. However, nothing checks this assumption or enforces this restriction.
39 .SH OPTIONS
40 .ne 2
41 .na
42 \fB\fB-d\fR\fR
43 .ad
44 .RS 15n
45 Debug. When specified it sets the \fBSO_DEBUG\fR socket option.
46 .RE
47
48 .sp
49 .ne 2
50 .na
51 \fB\fB-s\fR\fR
52 .ad
53 .RS 15n
54 Secure. When specified, the directory change to \fIhomedir\fR must succeed. The
55 daemon also changes its root directory to \fIhomedir\fR.
56 .RE
57
58 .sp
59 .ne 2
60 .na
61 \fB\fB-T\fR \fIrexmtval\fR\fR
62 .ad
63 .RS 15n
64 Specifies the value of the retransmission timeout in seconds. This also affects
65 the maximum session timeout in that the latter is set to five times the
66 retransmission timeout value.
67 .RE
68
69 .SH USAGE
70 .LP
71 The \fBin.tftpd\fR server is IPv6-enabled. See \fBip6\fR(7P).
72 .LP
73 \fBin.tftpd\fR supports transfers of greater than 32 MB, per RFC 2348.
74 .SH SEE ALSO
75 .LP
76 \fBsvcs\fR(1), \fBtftp\fR(1), \fBinetadm\fR(1M), \fBinetd\fR(1M),
77 \fBsvcadm\fR(1M), \fBnetconfig\fR(4), \fBattributes\fR(5), \fBsmf\fR(5),
78 \fBip6\fR(7P)
79 .LP
80 Malkin, G. and Harkin, A. \fIRFC 2347, TFTP Option Extension\fR. The Internet
81 Society. May 1998
82 .sp
83 .LP
84 Malkin, G. and Harkin, A. \fIRFC 2348, TFTP Blocksize Option\fR. The Internet
85 Society. May 1998
86 .sp
87 .LP
88 Malkin, G. and Harkin, A. \fIRFC 2349, TFTP Timeout Interval and Transfer Size
89 Options\fR. The Internet Society. May 1998
90 .sp
91 .LP
92 Sollins, K.R. \fIRFC 1350, The TFTP Protocol (Revision 2)\fR. Network Working
93 Group. July 1992.
94 .SH NOTES
95 .LP
96 The \fBtftpd\fR server only acknowledges the transfer size option that is sent
97 with a \fBread\fR request when the octet transfer mode is specified.
98 .LP
99 The \fBin.tftpd.1m\fR service is managed by the service management facility,
100 \fBsmf\fR(5), under the service identifier:
101 .sp
102 .in +2
103 .nf
104 svc:/network/tftp/udp6:default
105 .fi
106 .in -2
107 .sp
108
109 .sp
110 .LP
111 Administrative actions on this service, such as enabling, disabling, or
112 requesting restart, can be performed using \fBsvcadm\fR(1M). Responsibility for
113 initiating and restarting this service is delegated to \fBinetd\fR(1M). Use
114 \fBinetadm\fR(1M) to make configuration changes and to view configuration
115 information for this service. The service's status can be queried using the
116 \fBsvcs\fR(1) command.
|