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.