tftp(1) CLIX tftp(1)
NAME
tftp - Runs a user interface to the Internet trivial file transfer program
SYNOPSIS
/usr/ip32/tcpip/tftp [host [port]]
DESCRIPTION
The tftp command is the user interface to the Internet Trivial File
Transfer Protocol (TFTP), which allows users to transfer files to and from
a remote machine.
The tftp command transfers files between the local host and a specified
remote host. The remote host can be specified on the command line. In
this case tftp uses host as the default host for future transfers (see the
connect command described in the Commands subsection). If host is
specified on the command line, an optional port number can also be
specified. In this case, tftp uses the specified port number for future
transfers.
Commands
When tftp is running, it displays the tftp> prompt and recognizes the
following commands:
connect host [port]
Sets the host (and optionally port) for transfers. The TFTP
protocol, unlike the FTP protocol, does not maintain connections
between transfers; thus, the connect command does not actually
create a connection, but specifies the host to be used for
transfers. The connect command is not required; the remote host
can be specified as part of the get or put command.
mode transfer-mode
Sets the mode for transfers; transfer-mode can be ascii or binary.
The default is ascii.
put file
put local-file remote-file
Copies a file to the specified remote file. The destination can be
in one of two forms: a filename on the remote host if the host has
been specified or a string of the form host@file to specify both a
host and filename at once. If the latter form is used, the
hostname specified becomes the default for future transfers.
get filename
get remote-name local-name
Gets a file from the specified source. The source can be in one of
two forms: a file on the remote host if the host has been
2/94 - Intergraph Corporation 1
tftp(1) CLIX tftp(1)
specified, or a string of the form host@file to specify both a host
and filename at once. If the latter form is used, the last
hostname specified becomes the default for future transfers.
For a valid get request, the data being transferred is stored to a
temporary location on the local disk until the transfer is
complete, at which point the data is placed in the destination
file. If an error occurs during transfer, the temporary file is
removed from disk without ever writing data to the destination
file. This prevents a previously-existing file which has the same
name as the destination filename from being erased until the
transfer is successful.
quit Exits tftp. An end-of-file also exits.
verbose
Toggles verbose mode.
trace Toggles packet tracing.
status Shows the current status.
rexmt retransmission-timeout
Sets the per-packet retransmission timeout. The timeout is
specified in seconds.
timeout total-transmission-timeout
Sets the total transmission timeout. The timeout is specified in
seconds.
ascii Synonym for mode ascii.
binary Synonym for mode binary.
? [command-name ... ]
help [command-name ... ]
Displays help information.
EXAMPLES
1. To enter tftp in interactive mode, displaying the tftp> prompt, enter:
/usr/ip32/tcpip/tftp
2. To connect to host sam, enter:
/usr/ip32/tcpip/tftp sam
3. To connect to host sam using port 190, enter:
2 Intergraph Corporation - 2/94
tftp(1) CLIX tftp(1)
/usr/ip32/tcpip/tftp sam 190
NOTES
Because no user login or validation is in the TFTP protocol, the remote
site will probably have file access restrictions. The exact methods are
specific to each site.
If free disk space is low (and the destination file already exists), a get
command may fail due to temporary disk storage.
DIAGNOSTICS
tftp: udp/tftp: unknown service
The /etc/services file on your system needs to be updated.
tftp: could not link file filename
The tftp command is unable to link the temporary file to the
destination filename.
Other errors are displayed with the perror() function and are prepended
with tftp:.
EXIT VALUES
The tftp command exits with a value of 0 if successful. If unsuccessful,
it exits with a value of 1.
RELATED INFORMATION
Commands: tftpd(8)
Functions: perror(3)
2/94 - Intergraph Corporation 3