Return to tftp.1c CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man1

Power 6/32 Unix version 1.21

.TH TFTP 1C "12 Nov 1984"
.UC 4
.SH NAME
tftp \- trivial file transfer program
.SH SYNOPSIS
.B tftp
[
.B host
]
[ 
.B port
]
.SH DESCRIPTION
.I Tftp
is the user interface to the ARPANET standard Trivial File Transfer Protocol.
The program allows a user to transfer files to and from a
remote network site
.I without
having a login account at that remote site; however, the remote files must be
accessible to the user.
.PP
The optional arguments are positional dependent. Argument
.I host 
specifies the client host, and
.I port
specifies the port number through which 
.I tftp 
will contact an TFTP server. 
If the user does not give a port number, 
.I tftp
uses the port number reserved for TFTP servers.
.LP
.I Tftp
will then enter its command interpreter, print the prompt \*(lqtftp>\*(rq
and await the user's commands. It recognizes the following commands:
.TP
\fBconnect\fP \fIhost [port]\fP
specify the client host and optionally a port number through which
.I tftp
is to communicate with a TFTP server. The user 
will be prompted for the missing arguments.
.TP 
\fBmode\fP \fImode-type\fP
set the file transfer type to 
.I mode-type.
Currently,
.I tftp
only supports the
.I ascii
type.
.TP
\fBput\fP \fIfrom-file [to-file]\fB
send a local file 
.I from-file 
to the remote file
.I to-file.
If
.I to-file
is not given, 
.I tftp
uses the path
.I from-file
as the destination file.
See below for the argument description.
.TP
\fBput\fP \fIfrom-file from-file ... to-dir\fB
send a file or multiple files to the remote host.
Argument
.I from-file
specifies the local file to be sent, and
.I to-file
or
.I to-dir
the "address" of the receiving remote file or directory 
which must have already existed and writeable by the user. 
The format of 
.I to-file
or
.I to-dir
is
.RS 12

.I host-name:path-name

or

.I path-name

where
.I host-name
is the remote site of the receiving file or directory, and
.I path-name
is the
.I full
pathname of the receiving file or directory. 
If it is a directory, then the receiving files 
must have already existed and writeable by the user. They
have the same base names as those of the original files.
If 
.I host-name
is not given, 
.I tftp
uses the host name most recently given.
.RE
.RS
The user is prompted for missing command arguments.
.RE
.TP
\fBget\fP \fIfrom-file [to-file]\fP
receive a single file from a remote host.
If
.I to-file
is not given, 
.I tftp
uses the base name of the path
.I from-file
as the destination file.
See below for the argument description.
.TP
\fBget\fP \fIfrom-file from-file ... to-dir\fP
receive multiple files from a remote host.
The command argument
.I to-file
or
.I to-dir
specifies the local receiving file or directory, and
.I from-file
the remote file. The format of
.I from-file
is
.RS 12

.I host-name:path-name

or

.I path-name

.I host-name
and
.I path-name
are described in the 
.I put
command. 
If the receiving end is a directory, the receiving files
have the same base names as those of the original files.
.RE
.TP
.B quit
exit from
.I tftp.
.TP 
.B trace
toggle the packet tracing option.
.TP
.B rexmt timeout-value
specify the 
.I timeout-value 
interval before each packet is retransmitted.
The default value is 5 seconds. The user will be prompted for any
missing arguments.
.TP
.B timeout timeout-value
specify the
overall
.I timeout-value
interval when retransmitting a packet. If this interval expires, 
.I tftp
will terminate the file transfer process and prompt the user for
the next command. The default value is 25 seconds. The user will
be prompted for any missing arguments.
.TP
\fB?\fP \fIcommand-name\fP
to print a summary of available 
.I tftp
commands. If
.Icommand-name
is given, 
.I
tftp
prints the help messages for that particular command.
.PP
When receiving or sending files,
.I tftp
converts the Unix lines which terminate with 'nl' character into the
"network" lines which terminate with 'cr' 'nl'  characters. As a result,
the number of transmitted or received characters is larger than the
actual file size.
.I Tftp
reports both the transmitted and actual file size.
.I Tftp
does not handle third party copies.
.SH DIAGNOSTICS
Both
.I tftp
(at the local site) and
TFTP server
(at the remote site) report errors detected during file transfers.
These errors concerns the file accessibility and are self-explanatory.
Error message from
.I tftp
are prefixed with "tftp:".
Error messages from the remote TFTP server are prefixed with 
"Error code XX:". 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.