tftp(1C) TCP/IP 5.4.2 tftp(1C)
NAME
tftp - DARPA trivial file transfer protocol
SYNOPSIS
tftp [ host [ port ] ]
where:
host A hostname or a dot-format Internet address
port A small integer identifying a port
DESCRIPTION
The tftp program is the user interface to a very simple network file
transfer protocol. The program lets a user transfer files to and
from a remote network site.
This is a much simpler program than ftp(1C). It does not let you
display a remote directory, invoke a shell, or do other kinds of file
and directory manipulation. Generally, you would use it only when
communicating with a remote host that does not support ftp.
If port is not specified (the usual case), a default port is assumed.
When invoked, tftp displays a prompt, tftp>. You may then issue any
of the following commands:
? Help. Displays the tftp command list.
connect [ host [port] ]
Identifies a remote host with which to communicate.
Host is a hostname or a dot-format Internet address.
Port is an integer.
quit Terminates tftp.
mode [name] Sets the file transfer mode. File transfers (get,
put) made after the mode is set will be performed in
that mode. Name is one of the following:
ascii transfers standard ASCII text files.
binary transfers binary files, such as compiled
programs.
mail sends files as mail to a user rather than to a
file (this mode is not implemented).
get Transfers a file from the remote host to a local file
or directory. If connect has not been issued for the
remote host desired, then host: must be specified
explicitly. It is used much like cp(1).
get, executed without an argument, will prompt for
both filenames.
get [host:]/rdirpath/file copies remote file file from
the remote host into a file named file in the current
local directory. It will overwrite an existing file
Licensed material--property of copyright holder(s) 1
tftp(1C) TCP/IP 5.4.2 tftp(1C)
of the same name.
get [host:]/rdirpath/file1 [/ldirpath/]file2 copies
remote file file1 into local file file2.
get [host:]/rdirpath/file ... [/ldirpath/]dir copies
the remote file file into the specified local
directory. More than one remote file can be
specified; tftp assumes that the last name given is
the appropriately specified local directory that you
want the remote files moved to.
All rdirpaths must be absolute pathnames, i.e.,
specified all the way from the root directory / on the
remote host. Ldirpaths may be absolute or relative
pathnames (if not specified, the current local
directory is assumed). All hosts are specified by
hostnames or dot-format Internet addresses.
put Transfers a file from the local host to the remote
host. If connect has not been issued for the remote
host desired, then host: must be specified explicitly.
Otherwise, it is used much like cp(1).
put, executed without an argument, prompts for
filenames.
put [host:]/rdirpath/file copies local file file to
the remote host into a file of the same name in the
specified remote directory. It will overwrite an
existing file of the same name.
put [/ldirpath/]file1 [host:]/rdirpath/file2 copies
local file file1 into remote file file2.
put [/ldirpath/]file... [host:]/rdirpath copies local
file file into the specified remote directory. More
than one local file can be specified; tftp assumes
that the last name given is an appropriately specified
remote directory.
All rdirpaths must be absolute pathnames, i.e.,
specified all the way from the root directory /on the
remote host. Ldirpaths may be absolute or relative
pathnames (if not specified, the local current working
directory is assumed). Hosts are specified by
hostnames or by dot-format Internet addresses.
rexmt Sets the amount of time in seconds to wait before a
retry is sent. Default is 5 seconds. You might want
to increase the amount of time if the network is very
slow.
status Displays the settings for host, mode, trace, verbose,
Licensed material--property of copyright holder(s) 2
tftp(1C) TCP/IP 5.4.2 tftp(1C)
rexmt, and timeout.
timeout Sets the amount of time in seconds to wait before
giving up on a file transfer. Default is 25 seconds;
you might want to increase this number if the network
is very slow.
trace Turns on trace mode. When on, packet transfers are
displayed on the screen. During put and get, each
packet transfer prints the packet header on the
screen. The packet header contains information such as
type of packet and the packet number. Retries show up
as multiple lines with the same packet number.
verbose Turns on verbose mode. Verbose mode has no meaning in
the DG/UX System; nonetheless, it is visible to
status.
This protocol trades flexibility for simplicity. It uses a reliable,
lockstep packet mechanism. When the connection is to a non-secured
tftpd(1M), security depends on file permissions and how much
outsiders know about your directories and files. Remote users are
governed by the "others," or o section of a file permission. When
the connection is to a system running tftpd(1M) in secure mode,
security is enforced by restricting access to a single directory.
DIAGNOSTICS
Most errors terminate the command, including:
* file not found,
* user not found,
* access violation (you don't have access to a directory to which
you tried to send a file),
* internal errors (a server receives a badly formed packet).
SEE ALSO
chmod(1), chown(1), cp(1), ftp(1C), ftpd(1M), tftpd(1M), inet(3N),
hosts(4).
Licensed material--property of copyright holder(s) 3