1*66866Sbostic.\" Copyright (c) 1990, 1993, 1994 262309Sbostic.\" The Regents of the University of California. All rights reserved. 327201Slepreau.\" 448538Scael.\" %sccs.include.redist.roff% 527201Slepreau.\" 6*66866Sbostic.\" @(#)tftp.1 8.2 (Berkeley) 04/18/94 735643Sbostic.\" 848538Scael.Dd 948538Scael.Dt TFTP 1 1048538Scael.Os BSD 4.3 1148538Scael.Sh NAME 1248538Scael.Nm tftp 1348538Scael.Nd trivial file transfer program 1448538Scael.Sh SYNOPSIS 1548538Scael.Nm tftp 1648538Scael.Op Ar host 1748538Scael.Sh DESCRIPTION 1848538Scael.Nm Tftp 1948538Scaelis the user interface to the Internet 2048538Scael.Tn TFTP 2126991Slepreau(Trivial File Transfer Protocol), 2226991Slepreauwhich allows users to transfer files to and from a remote machine. 2326991SlepreauThe remote 2448538Scael.Ar host 2526991Slepreaumay be specified on the command line, in which case 2648538Scael.Nm tftp 2726991Slepreauuses 2848538Scael.Ar host 2926991Slepreauas the default host for future transfers (see the 3048538Scael.Cm connect 3126991Slepreaucommand below). 3248538Scael.Sh COMMANDS 3326991SlepreauOnce 3448538Scael.Nm tftp 3526991Slepreauis running, it issues the prompt 3648538Scael.LI tftp> 3726991Slepreauand recognizes the following commands: 3848538Scael.Pp 3948538Scael.Bl -tag -width verbose -compact 4048538Scael.It Cm \&? Ar command-name ... 4148538ScaelPrint help information. 4248538Scael.Pp 4348538Scael.It Cm ascii 4448538ScaelShorthand for "mode ascii" 4548538Scael.Pp 4648538Scael.It Cm binary 4748538ScaelShorthand for "mode binary" 4848538Scael.Pp 4948538Scael.It Cm connect Ar host-name Op Ar port 5026991SlepreauSet the 5148538Scael.Ar host 5226991Slepreau(and optionally 5348538Scael.Ar port ) 5426991Slepreaufor transfers. 5548538ScaelNote that the 5648538Scael.Tn TFTP 5748538Scaelprotocol, unlike the 5848538Scael.Tn FTP 5948538Scaelprotocol, 60*66866Sbosticdoes not maintain connections between transfers; thus, the 6148538Scael.Cm connect 6226991Slepreaucommand does not actually create a connection, 6326991Slepreaubut merely remembers what host is to be used for transfers. 6426991SlepreauYou do not have to use the 6548538Scael.Cm connect 6626991Slepreaucommand; the remote host can be specified as part of the 6748538Scael.Cm get 6826991Slepreauor 6948538Scael.Cm put 7026991Slepreaucommands. 7148538Scael.Pp 7248538Scael.It Cm get Ar filename 7348538Scael.It Cm get Ar remotename localname 7448538Scael.It Cm get Ar file1 file2 ... fileN 7548538ScaelGet a file or set of files from the specified 7648538Scael.Ar sources . 7748538Scael.Ar Source 7848538Scaelcan be in one of two forms: 7948538Scaela filename on the remote host, if the host has already been specified, 8048538Scaelor a string of the form 8148538Scael.Ar hosts:filename 8248538Scaelto specify both a host and filename at the same time. 8348538ScaelIf the latter form is used, 8448538Scaelthe last hostname specified becomes the default for future transfers. 8548538Scael.Pp 8648538Scael.It Cm mode Ar transfer-mode 8726991SlepreauSet the mode for transfers; 8848538Scael.Ar transfer-mode 8926991Slepreaumay be one of 9048538Scael.Em ascii 9126991Slepreauor 9248538Scael.Em binary . 9326991SlepreauThe default is 9448538Scael.Em ascii . 9548538Scael.Pp 9648538Scael.It Cm put Ar file 9748538Scael.It Cm put Ar localfile remotefile 9848538Scael.It Cm put Ar file1 file2 ... fileN remote-directory 9926991SlepreauPut a file or set of files to the specified 10026991Slepreauremote file or directory. 10126991SlepreauThe destination 10226991Slepreaucan be in one of two forms: 10326991Slepreaua filename on the remote host, if the host has already been specified, 10426991Slepreauor a string of the form 10548538Scael.Ar hosts:filename 10626991Slepreauto specify both a host and filename at the same time. 10726991SlepreauIf the latter form is used, 10826991Slepreauthe hostname specified becomes the default for future transfers. 10926991SlepreauIf the remote-directory form is used, the remote host is 11026991Slepreauassumed to be a 11148538Scael.Tn UNIX 11226991Slepreaumachine. 11348538Scael.Pp 11448538Scael.It Cm quit 11526991SlepreauExit 11648538Scael.Nm tftp . 11727201SlepreauAn end of file also exits. 11848538Scael.Pp 11948538Scael.It Cm rexmt Ar retransmission-timeout 12048538ScaelSet the per-packet retransmission timeout, in seconds. 12148538Scael.Pp 12248538Scael.It Cm status 12326991SlepreauShow current status. 12448538Scael.Pp 12548538Scael.It Cm timeout Ar total-transmission-timeout 12626991SlepreauSet the total transmission timeout, in seconds. 12748538Scael.Pp 12848538Scael.It Cm trace 12948538ScaelToggle packet tracing. 13048538Scael.Pp 13148538Scael.It Cm verbose 13248538ScaelToggle verbose mode. 13348538Scael.El 13448538Scael.Sh BUGS 13548538Scael.Pp 13626991SlepreauBecause there is no user-login or validation within 13726991Slepreauthe 13848538Scael.Tn TFTP 13926991Slepreauprotocol, the remote site will probably have some 14026991Slepreausort of file-access restrictions in place. The 14126991Slepreauexact methods are specific to each site and therefore 14226991Slepreaudifficult to document here. 14348538Scael.Sh HISTORY 14448538ScaelThe 14548538Scael.Nm 14648538Scaelcommand appeared in 14748538Scael.Bx 4.3 . 148