NAME
tftp — trivial file transfer program
SYNOPSIS
tftp
[-B
val]
[-s]
[-t
val]
[host
[port]]
DESCRIPTION
tftp
is the user interface to the Internet
TFTP
(Trivial File Transfer Protocol),
that allows users to transfer files to and from a remote machine.
The remote
host
can be specified on the command line, in which case
tftp
uses
host
as the default host for future transfers (see the
connect
command below).
Note
tftp
now conforms to the RFCs: 2347, 2348, and 2349.
Options
tftp
supports the following new options:
- -B val
Set the block size option for data transfer, in octets. See
blksize
command for more information.
- -s
Set the use of transfer size option. See
tsize
command for more information.
- -t val
Set the retransmission timeout option, in seconds. See
newrexmt
command for more information.
Commands
Once
tftp
is running, it issues the prompt
tftp>
and recognizes the following commands:
- connect host [port]
Set the
host
(and optionally
port)
for transfers.
Note that the
TFTP
protocol, unlike the
FTP
protocol, does not maintain connections 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.
- mode transfer-mode
Set the mode for transfers;
transfer-mode
can be one of
ascii
or
binary
(default is
ascii).
- put file
- put localfile remotefile
- put file1 file2 ... fileN remotedirectory
Put a file or set of files to the specified remote file or directory.
The destination can be in one of two forms:
a filename on the remote host if the host has already been specified,
or a string of the form
host:filename
to specify both a host and filename at the same time.
If the latter form is used,
the hostname specified becomes the default for future transfers.
If the remote-directory form is used,
the remote host is assumed to be a
UNIX-like
machine.
- put localfile [IPv6_address]:remotefile
To invoke the
put
command with an IPv6 address, the IPv6 address must be enclosed
in a pair of square brackets
([ and ])
- get filename
- get remotename localname
- get file1 file2 ... fileN
Get a file or set of files from the specified
sources.
source
can be in one of two forms:
a filename on the remote host if the host has already been specified,
or a string of the form
host:filename
to specify both a host and filename at the same time.
If the latter form is used,
the last hostname specified becomes the default for future transfers.
- get [IPv6_address]:remotename localname
To invoke the
get
command with an IPv6 address, the IPv6 address must be enclosed
in a pair of square brackets
([ and ])
- quit
Exit
tftp.
Typing the end-of-file character also causes an exit.
- verbose
Toggle verbose mode.
- trace
Toggle packet tracing.
- status
Show current status.
- rexmt retransmission-timeout
Set the per-packet retransmission timeout, in seconds.
- timeout total-transmission-timeout
Set the total transmission timeout, in seconds.
- ascii
Shorthand for "mode ascii"
- binary
Shorthand for "mode binary"
- blksize val
Set the block size for data transfer. The client and the server communicate
to arrive upon a block size that is suitable for use on the network medium.
The valid range is 8 to 65464 octets. The default value is 512 octets.
- newrexmt val
Set the retransmission timeout, in seconds. The client and the server
communicate to arrive upon a retransmission timeout value.
The valid range is 1 to 255 seconds. The default value is 5 seconds.
- tsize
Toggles the use of transfer size. This option is implemented for binary mode
transfers only. By default, this option is disabled.
If this option is enabled, it allows the receiving side to determine the size
of the file being transferred. When the
get
command is used in binary mode and the size of the file is greater than the free disk space, transfer will be aborted immediately. When the
put
command is used in binary mode, the size of the file will be sent to the server.
- ? [command-name...]
Print help information.
WARNINGS
Since there is no user-login or validation within the
TFTP
protocol, the remote site probably has some sort
of file-access restrictions in place.
The exact methods are specific to each site and are therefore
difficult to document here.
AUTHOR
tftp
was developed by the University of California, Berkeley.