TFTP(1) BSD General Commands Manual TFTP(1)NAMEtftp — trivial file transfer program
SYNOPSIStftp [host [port]]
DESCRIPTION
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).
COMMANDS
Once tftp is running, it issues the prompt “tftp>” and recognizes the
following commands:
? command-name ...
Print help information.
ascii Shorthand for "mode ascii"
binary Shorthand for "mode binary"
connect host [port]
Set the host (and optionally port) for transfers. Note that the
TFTP protocol, unlike the FTP protocol, does not maintain con‐
nections between transfers; thus, the 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.
get [host:]file [localname]
get [host1:]file1 [host2:]file2 ... [hostN:]fileN
Get one or more files from the remote host. When using the host
argument, the host will be used as default host for future
transfers. If localname is specified, the file is stored
locally as localname, otherwise the original filename is used.
Note that it is not possible to download two files at a time,
only one, three, or more than three files, at a time.
To specify an IPv6 numeric address for a host, wrap it using
square brackets like “[3ffe:2900:e00c:ffee::1234]:file” to dis‐
ambiguate the colons used in the IPv6 address from the colon
separating the host and the filename.
mode transfer-mode
Set the mode for transfers; transfer-mode may be one of ascii or
binary. The default is ascii.
put file [[host:]remotename]
put file1 file2 ... fileN [[host:]remote-directory]
Put a file or set of files to the remote host. When remotename
is specified, the file is stored remotely as remotename, other‐
wise the original filename is used. If the remote-directory
argument is used, the remote host is assumed to be a UNIX
machine. To specify an IPv6 numeric address for a host, see the
example under the get command.
quit Exit tftp. An end of file also exits.
rexmt retransmission-timeout
Set the per-packet retransmission timeout, in seconds.
status Show current status.
timeout total-transmission-timeout
Set the total transmission timeout, in seconds.
trace Toggle packet tracing.
verbose Toggle verbose mode.
HISTORY
The tftp command appeared in 4.3BSD.
BUGS
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 dif‐
ficult to document here.
Files larger than 33488896 octets (65535 blocks) cannot be transferred
without client and server supporting blocksize negotiation (RFC1783).
BSD October 1, 2003 BSD
