Print this page
5172 tftpd service is not registered by default and its manual is giving misleading directions
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1m/in.tftpd.1m
+++ new/usr/src/man/man1m/in.tftpd.1m
1 1 '\" te
2 2 .\" Copyright 1989 AT&T
3 3 .\" Copyright (C) 2008, Sun Microsystems, Inc. All Rights Reserved
4 +.\" Copyright 2015 Nexenta Systems, Inc. All rights reserved.
4 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.
5 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.
6 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]
7 -.TH IN.TFTPD 1M "Nov 5, 2008"
8 +.TH IN.TFTPD 1M "Jun 17, 2015"
8 9 .SH NAME
9 10 in.tftpd, tftpd \- Internet Trivial File Transfer Protocol server
10 11 .SH SYNOPSIS
11 12 .LP
12 13 .nf
13 14 \fBin.tftpd\fR [\fB-d\fR] [\fB-T\fR \fIrexmtval\fR] [\fB-s\fR] [\fIhomedir\fR]
14 15 .fi
15 16
16 17 .SH DESCRIPTION
17 -.sp
18 18 .LP
19 19 \fBtftpd\fR is a server that supports the Internet Trivial File Transfer
20 20 Protocol (TFTP).
21 21 .sp
22 22 .LP
23 23 Before responding to a request, the server attempts to change its current
24 24 directory to \fIhomedir\fR; the default directory is \fB/tftpboot\fR.
25 25 .sp
26 26 .LP
27 27 The use of \fBtftp\fR does not require an account or password on the remote
28 28 system. Due to the lack of authentication information, \fBin.tftpd\fR will
29 29 allow only publicly readable files to be accessed. Files may be written only if
|
↓ open down ↓ |
2 lines elided |
↑ open up ↑ |
30 30 they already exist and are publicly writable. Note that this extends the
31 31 concept of "public" to include all users on all hosts that can be reached
32 32 through the network. This may not be appropriate on all systems, and its
33 33 implications should be considered before enabling this service.
34 34 .sp
35 35 .LP
36 36 \fBin.tftpd\fR runs with the user \fBID\fR and group \fBID\fR set to
37 37 \fB[GU]ID_NOBODY\fR under the assumption that no files exist with that owner or
38 38 group. However, nothing checks this assumption or enforces this restriction.
39 39 .SH OPTIONS
40 -.sp
41 40 .ne 2
42 41 .na
43 42 \fB\fB-d\fR\fR
44 43 .ad
45 44 .RS 15n
46 45 Debug. When specified it sets the \fBSO_DEBUG\fR socket option.
47 46 .RE
48 47
49 48 .sp
50 49 .ne 2
51 50 .na
52 51 \fB\fB-s\fR\fR
53 52 .ad
54 53 .RS 15n
55 54 Secure. When specified, the directory change to \fIhomedir\fR must succeed. The
56 55 daemon also changes its root directory to \fIhomedir\fR.
57 56 .RE
58 57
59 58 .sp
60 59 .ne 2
|
↓ open down ↓ |
10 lines elided |
↑ open up ↑ |
61 60 .na
62 61 \fB\fB-T\fR \fIrexmtval\fR\fR
63 62 .ad
64 63 .RS 15n
65 64 Specifies the value of the retransmission timeout in seconds. This also affects
66 65 the maximum session timeout in that the latter is set to five times the
67 66 retransmission timeout value.
68 67 .RE
69 68
70 69 .SH USAGE
71 -.sp
72 70 .LP
73 71 The \fBin.tftpd\fR server is IPv6-enabled. See \fBip6\fR(7P).
74 -.sp
75 72 .LP
76 73 \fBin.tftpd\fR supports transfers of greater than 32 MB, per RFC 2348.
77 74 .SH SEE ALSO
78 -.sp
79 75 .LP
80 76 \fBsvcs\fR(1), \fBtftp\fR(1), \fBinetadm\fR(1M), \fBinetd\fR(1M),
81 77 \fBsvcadm\fR(1M), \fBnetconfig\fR(4), \fBattributes\fR(5), \fBsmf\fR(5),
82 78 \fBip6\fR(7P)
83 -.sp
84 79 .LP
85 80 Malkin, G. and Harkin, A. \fIRFC 2347, TFTP Option Extension\fR. The Internet
86 81 Society. May 1998
87 82 .sp
88 83 .LP
89 84 Malkin, G. and Harkin, A. \fIRFC 2348, TFTP Blocksize Option\fR. The Internet
90 85 Society. May 1998
91 86 .sp
92 87 .LP
93 88 Malkin, G. and Harkin, A. \fIRFC 2349, TFTP Timeout Interval and Transfer Size
94 89 Options\fR. The Internet Society. May 1998
95 90 .sp
96 91 .LP
97 92 Sollins, K.R. \fIRFC 1350, The TFTP Protocol (Revision 2)\fR. Network Working
98 93 Group. July 1992.
99 94 .SH NOTES
100 -.sp
101 95 .LP
102 96 The \fBtftpd\fR server only acknowledges the transfer size option that is sent
103 97 with a \fBread\fR request when the octet transfer mode is specified.
104 -.sp
105 98 .LP
106 99 The \fBin.tftpd.1m\fR service is managed by the service management facility,
107 100 \fBsmf\fR(5), under the service identifier:
108 101 .sp
109 102 .in +2
110 103 .nf
111 104 svc:/network/tftp/udp6:default
112 105 .fi
113 106 .in -2
114 107 .sp
115 108
116 109 .sp
117 110 .LP
118 111 Administrative actions on this service, such as enabling, disabling, or
119 112 requesting restart, can be performed using \fBsvcadm\fR(1M). Responsibility for
120 113 initiating and restarting this service is delegated to \fBinetd\fR(1M). Use
121 114 \fBinetadm\fR(1M) to make configuration changes and to view configuration
122 115 information for this service. The service's status can be queried using the
123 116 \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.
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX