TFTP(1) | General Commands Manual | TFTP(1) |
tftp
— trivial
file transfer program
tftp |
[host [port]] |
The tftp
utility is the user interface to
the Internet TFTP (Trivial File Transfer Protocol), which allows users to
transfer files to and from a remote machine. The remote
host may be specified on the command line, in which
case tftp
uses host as the
default host for future transfers (see the connect
command below).
The optional -e
argument sets the
blocksize to the largest supported value and enables the TFTP timeout option
as if the tout
command had been given. In previous
versions of tftp
, it also enabled binary mode and
the TFTP blksize option; these are now on by default.
Once tftp
is running, it issues the prompt
“tftp>
” and recognizes the
following commands:
?
command-name ...ascii
binary
blocksize
[size]blocksize2
[size]connect
host [port]connect
command does not actually create
a connection, but merely remembers what host is to be used for transfers.
You do not have to use the connect
command; the
remote host can be specified as part of the get
or
put
commands.
debug
levelpacket
,
simple
, options
, or
access
.
get
[host:]file
[localname]get
[host1:]file1
[host2:]file2 ...
[hostN:]fileNTo specify an IPv6 numeric address for a host, wrap it using
square brackets like
“[3ffe:2900:e00c:ffee::1234]
:file”
to disambiguate the colons used in the IPv6 address from the colon
separating the host and the filename.
mode
transfer-modepacketdrop
[arg]
put
file
[[host:]remotename]put
file1 file2 ... fileN
[[host:]remote-directory]get
command.
options
[arg]on
(enable RFC 2347
options), off
(disable RFC 2347 options), and
extra
(toggle support for non-RFC defined
options).
quit
tftp
. An end of file also exits.
rexmt
retransmission-timeoutrollover
[arg]
status
timeout
total-transmission-timeouttrace
verbose
windowsize
[size]The following RFC's are supported:
RFC 1350: The TFTP Protocol (Revision 2).
RFC 2347: TFTP Option Extension.
RFC 2348: TFTP Blocksize Option.
RFC 2349: TFTP Timeout Interval and Transfer Size Options.
RFC 3617: Uniform Resource Identifier (URI) Scheme and Applicability Statement for the Trivial File Transfer Protocol (TFTP).
RFC 7440: TFTP Windowsize Option.
The non-standard rollover
and
blksize2
TFTP options are mentioned here:
Extending TFTP, https://www.compuphase.com/tftp.htm.
The tftp
command appeared in
4.3BSD.
Edwin Groothuis <edwin@FreeBSD.org> performed a major
rewrite of the tftpd(8) and
tftp
code to support RFC2348.
Because there is no user-login or validation within the TFTP protocol, the remote site will probably have some sort of file-access restrictions in place. The exact methods are specific to each site and therefore difficult to document here.
Files larger than 33488896 octets (65535 blocks) cannot be transferred without client and server supporting the TFTP blocksize option (RFC2348), or the non-standard TFTP rollover option.
November 16, 2022 | macOS 14.6 |