19b50d902SRodney W. Grimes.\" Copyright (c) 1990, 1993, 1994 29b50d902SRodney W. Grimes.\" The Regents of the University of California. All rights reserved. 39b50d902SRodney W. Grimes.\" 49b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without 59b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions 69b50d902SRodney W. Grimes.\" are met: 79b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright 89b50d902SRodney W. Grimes.\" notice, this list of conditions and the following disclaimer. 99b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright 109b50d902SRodney W. Grimes.\" notice, this list of conditions and the following disclaimer in the 119b50d902SRodney W. Grimes.\" documentation and/or other materials provided with the distribution. 129b50d902SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software 139b50d902SRodney W. Grimes.\" must display the following acknowledgement: 149b50d902SRodney W. Grimes.\" This product includes software developed by the University of 159b50d902SRodney W. Grimes.\" California, Berkeley and its contributors. 169b50d902SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors 179b50d902SRodney W. Grimes.\" may be used to endorse or promote products derived from this software 189b50d902SRodney W. Grimes.\" without specific prior written permission. 199b50d902SRodney W. Grimes.\" 209b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 219b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 229b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 239b50d902SRodney W. Grimes.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 249b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 259b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 269b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 279b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 289b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 299b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 309b50d902SRodney W. Grimes.\" SUCH DAMAGE. 319b50d902SRodney W. Grimes.\" 329b50d902SRodney W. Grimes.\" @(#)tftp.1 8.2 (Berkeley) 4/18/94 339b50d902SRodney W. Grimes.\" 349b50d902SRodney W. Grimes.Dd April 18, 1994 359b50d902SRodney W. Grimes.Dt TFTP 1 369b50d902SRodney W. Grimes.Os BSD 4.3 379b50d902SRodney W. Grimes.Sh NAME 389b50d902SRodney W. Grimes.Nm tftp 399b50d902SRodney W. Grimes.Nd trivial file transfer program 409b50d902SRodney W. Grimes.Sh SYNOPSIS 41fd129a02SPhilippe Charnier.Nm 429b50d902SRodney W. Grimes.Op Ar host 439b50d902SRodney W. Grimes.Sh DESCRIPTION 449b50d902SRodney W. Grimes.Nm Tftp 459b50d902SRodney W. Grimesis the user interface to the Internet 469b50d902SRodney W. Grimes.Tn TFTP 479b50d902SRodney W. Grimes(Trivial File Transfer Protocol), 489b50d902SRodney W. Grimeswhich allows users to transfer files to and from a remote machine. 499b50d902SRodney W. GrimesThe remote 509b50d902SRodney W. Grimes.Ar host 519b50d902SRodney W. Grimesmay be specified on the command line, in which case 52fd129a02SPhilippe Charnier.Nm 539b50d902SRodney W. Grimesuses 549b50d902SRodney W. Grimes.Ar host 559b50d902SRodney W. Grimesas the default host for future transfers (see the 569b50d902SRodney W. Grimes.Cm connect 579b50d902SRodney W. Grimescommand below). 589b50d902SRodney W. Grimes.Sh COMMANDS 599b50d902SRodney W. GrimesOnce 60fd129a02SPhilippe Charnier.Nm 619b50d902SRodney W. Grimesis running, it issues the prompt 62fd129a02SPhilippe Charnier.Nm tftp> 639b50d902SRodney W. Grimesand recognizes the following commands: 649b50d902SRodney W. Grimes.Pp 659b50d902SRodney W. Grimes.Bl -tag -width verbose -compact 669b50d902SRodney W. Grimes.It Cm \&? Ar command-name ... 679b50d902SRodney W. GrimesPrint help information. 689b50d902SRodney W. Grimes.Pp 699b50d902SRodney W. Grimes.It Cm ascii 709b50d902SRodney W. GrimesShorthand for "mode ascii" 719b50d902SRodney W. Grimes.Pp 729b50d902SRodney W. Grimes.It Cm binary 739b50d902SRodney W. GrimesShorthand for "mode binary" 749b50d902SRodney W. Grimes.Pp 759b50d902SRodney W. Grimes.It Cm connect Ar host-name Op Ar port 769b50d902SRodney W. GrimesSet the 779b50d902SRodney W. Grimes.Ar host 789b50d902SRodney W. Grimes(and optionally 799b50d902SRodney W. Grimes.Ar port ) 809b50d902SRodney W. Grimesfor transfers. 819b50d902SRodney W. GrimesNote that the 829b50d902SRodney W. Grimes.Tn TFTP 839b50d902SRodney W. Grimesprotocol, unlike the 849b50d902SRodney W. Grimes.Tn FTP 859b50d902SRodney W. Grimesprotocol, 869b50d902SRodney W. Grimesdoes not maintain connections between transfers; thus, the 879b50d902SRodney W. Grimes.Cm connect 889b50d902SRodney W. Grimescommand does not actually create a connection, 899b50d902SRodney W. Grimesbut merely remembers what host is to be used for transfers. 909b50d902SRodney W. GrimesYou do not have to use the 919b50d902SRodney W. Grimes.Cm connect 929b50d902SRodney W. Grimescommand; the remote host can be specified as part of the 939b50d902SRodney W. Grimes.Cm get 949b50d902SRodney W. Grimesor 959b50d902SRodney W. Grimes.Cm put 969b50d902SRodney W. Grimescommands. 979b50d902SRodney W. Grimes.Pp 989b50d902SRodney W. Grimes.It Cm get Ar filename 999b50d902SRodney W. Grimes.It Cm get Ar remotename localname 1009b50d902SRodney W. Grimes.It Cm get Ar file1 file2 ... fileN 1019b50d902SRodney W. GrimesGet a file or set of files from the specified 1029b50d902SRodney W. Grimes.Ar sources . 1039b50d902SRodney W. Grimes.Ar Source 1049b50d902SRodney W. Grimescan be in one of two forms: 1059b50d902SRodney W. Grimesa filename on the remote host, if the host has already been specified, 1069b50d902SRodney W. Grimesor a string of the form 1079b50d902SRodney W. Grimes.Ar hosts:filename 1089b50d902SRodney W. Grimesto specify both a host and filename at the same time. 1099b50d902SRodney W. GrimesIf the latter form is used, 1109b50d902SRodney W. Grimesthe last hostname specified becomes the default for future transfers. 1119b50d902SRodney W. Grimes.Pp 1129b50d902SRodney W. Grimes.It Cm mode Ar transfer-mode 1139b50d902SRodney W. GrimesSet the mode for transfers; 1149b50d902SRodney W. Grimes.Ar transfer-mode 1159b50d902SRodney W. Grimesmay be one of 1169b50d902SRodney W. Grimes.Em ascii 1179b50d902SRodney W. Grimesor 1189b50d902SRodney W. Grimes.Em binary . 1199b50d902SRodney W. GrimesThe default is 1209b50d902SRodney W. Grimes.Em ascii . 1219b50d902SRodney W. Grimes.Pp 1229b50d902SRodney W. Grimes.It Cm put Ar file 1239b50d902SRodney W. Grimes.It Cm put Ar localfile remotefile 1249b50d902SRodney W. Grimes.It Cm put Ar file1 file2 ... fileN remote-directory 1259b50d902SRodney W. GrimesPut a file or set of files to the specified 1269b50d902SRodney W. Grimesremote file or directory. 1279b50d902SRodney W. GrimesThe destination 1289b50d902SRodney W. Grimescan be in one of two forms: 1299b50d902SRodney W. Grimesa filename on the remote host, if the host has already been specified, 1309b50d902SRodney W. Grimesor a string of the form 1319b50d902SRodney W. Grimes.Ar hosts:filename 1329b50d902SRodney W. Grimesto specify both a host and filename at the same time. 1339b50d902SRodney W. GrimesIf the latter form is used, 1349b50d902SRodney W. Grimesthe hostname specified becomes the default for future transfers. 1359b50d902SRodney W. GrimesIf the remote-directory form is used, the remote host is 1369b50d902SRodney W. Grimesassumed to be a 1379b50d902SRodney W. Grimes.Tn UNIX 1389b50d902SRodney W. Grimesmachine. 1399b50d902SRodney W. Grimes.Pp 1409b50d902SRodney W. Grimes.It Cm quit 1419b50d902SRodney W. GrimesExit 1429b50d902SRodney W. Grimes.Nm tftp . 1439b50d902SRodney W. GrimesAn end of file also exits. 1449b50d902SRodney W. Grimes.Pp 1459b50d902SRodney W. Grimes.It Cm rexmt Ar retransmission-timeout 1469b50d902SRodney W. GrimesSet the per-packet retransmission timeout, in seconds. 1479b50d902SRodney W. Grimes.Pp 1489b50d902SRodney W. Grimes.It Cm status 1499b50d902SRodney W. GrimesShow current status. 1509b50d902SRodney W. Grimes.Pp 1519b50d902SRodney W. Grimes.It Cm timeout Ar total-transmission-timeout 1529b50d902SRodney W. GrimesSet the total transmission timeout, in seconds. 1539b50d902SRodney W. Grimes.Pp 1549b50d902SRodney W. Grimes.It Cm trace 1559b50d902SRodney W. GrimesToggle packet tracing. 1569b50d902SRodney W. Grimes.Pp 1579b50d902SRodney W. Grimes.It Cm verbose 1589b50d902SRodney W. GrimesToggle verbose mode. 1599b50d902SRodney W. Grimes.El 1609b50d902SRodney W. Grimes.Sh BUGS 1619b50d902SRodney W. Grimes.Pp 1629b50d902SRodney W. GrimesBecause there is no user-login or validation within 1639b50d902SRodney W. Grimesthe 1649b50d902SRodney W. Grimes.Tn TFTP 1659b50d902SRodney W. Grimesprotocol, the remote site will probably have some 1669b50d902SRodney W. Grimessort of file-access restrictions in place. The 1679b50d902SRodney W. Grimesexact methods are specific to each site and therefore 1689b50d902SRodney W. Grimesdifficult to document here. 1699b50d902SRodney W. Grimes.Sh HISTORY 1709b50d902SRodney W. GrimesThe 1719b50d902SRodney W. Grimes.Nm 1729b50d902SRodney W. Grimescommand appeared in 1739b50d902SRodney W. Grimes.Bx 4.3 . 174