The MultiNet TFTP utility uses the Internet-standard Trivial File Transfer Protocol (TFTP) to transfer files between the local host and a remote host. This appendix describes the commands you can use during a TFTP session.
The below table lists the TFTP commands:
|
Command |
Description |
|
CONNECT |
Specifies the name or address of the TFTP server. |
|
GET |
Transfers remote_file on the remote host to local_file on the local host. |
|
PUT |
Copies local_file on the local host to remote_file on the remote host. |
|
QUIT |
Terminates TFTP and returns to DCL. |
|
REXMT |
Specifies the amount of time TFTP waits for a response to arrive before retransmitting a request. The default value for the retransmission timer is five seconds. |
|
STATUS |
Displays the current TFTP status. |
|
TIMEOUT |
Sets the amount of time TFTP waits for a response from the server before aborting a transfer. |
|
TRACE |
Toggles TFTP packet tracing. |
Specifies the name or address of the TFTP server. This value overrides the command line host specification. You may use either a symbolic host name or an Internet address.
This command does not cause any network action, but sets the destination address for the TFTP UDP packets. If the host cannot be reached, an error is not displayed until a GET or PUT command is attempted.
FORMAT
connect host
PARAMETERS
host
Specifies a remote host.
EXAMPLE
This example connects to the host EXAMPLE.COM.
tftp>connect example.com
Transfers remote_file on the remote host to local_file on the local host.
You must specify an absolute path name (device, directory, and file name) for remote_file, and typically the server requires the file to be world-readable. If you do not specify local_file, the default is the same name and directory as remote_file.
FORMAT
get remote_file [local_file]
PARAMETERS
remote_file
Specifies the name of the input file on the remote host.
local_file
Specifies the name of the output file on the local host.
EXAMPLE
This example retrieves the file USERS:[SMITH]LOGIN.COM and stores it in the file LOGIN.COM.
tftp>get users:[smith]login.com login.com
Received 2361 bytes in 1 seconds.
tftp>
Copies local_file on the local host to remote_file on the remote host.
You must use absolute pathnames on remote_file, and typically the server requires the file to already exist and be world-writable (W:W). If you do not specify remote_file, it defaults to the same name and directory as local_file.
FORMAT
put local_file [remote_file]
PARAMETERS
local_file
Specifies the name of the input file on the local host.
remote_file
Specifies the name of the output file on the remote host.
EXAMPLE
This example transfers SYS$LOGIN:LOGIN.COM to the remote file specification /tmp/foo.
tftp>put sys$login:login.com /tmp/foo
Sent 2361 bytes in 1 second.
tftp>
Terminates TFTP and returns to DCL.
FORMAT
quit
EXAMPLE
tftp>quit
$
Specifies the amount of time TFTP waits for a response to arrive before retransmitting a request. The default value for the retransmission timer is five seconds.
FORMAT
rexmt seconds
PARAMETERS
seconds
Sets the TFTP retransmission timer to the specified number of seconds.
EXAMPLE
This example sets the TFTP retransmission timer to 10 seconds.
tftp>rexmt 10
Displays the current TFTP status.
FORMAT
STATUS
EXAMPLE
This example shows how to display TFTP status after a connection has been made to EXAMPLE.COM. All values shown are the defaults.
tftp>status
Connected to EXAMPLE.COM.
Mode: octet Tracing: off
Rexmt-interval: 5 seconds, Max-timeout: 25 seconds
tftp>
Sets the amount of time TFTP waits for a response from the server before aborting a transfer.
The REXMT command controls how often the request is retransmitted. The default value for the maximum timeout is 25 seconds.
FORMAT
timeout seconds
PARAMETERS
seconds
Specifies the number of seconds for the maximum timeout allowed per TFTP packet.
EXAMPLE
This example shows how to set the maximum timeout to 50 seconds.
tftp> timeout 50
tftp>
Toggles TFTP packet tracing.
FORMAT
trace
EXAMPLES
This example shows how to enable TFTP packet tracing. Issue the command a second time to disable packet tracing.
tftp>trace
Packet tracing on.
tftp>
This example shows a transfer with packet tracing enabled.
get use2s:[smith]login.com .com
sent LOCALHOST.69 RRQ
<file=users:[smith]login.com, mode=octet>
received LOCALHOST.69 DATA <block=1, 512 bytes>
sent LOCALHOST.69 ACK <block=1>
received LOCALHOST.69 DATA <block=2, 512 bytes>
sent LOCALHOST.69 ACK <block=2>
received LOCALHOST.69 DATA <block=3, 512 bytes>
sent LOCALHOST.69 ACK <block=3>
received LOCALHOST.69 DATA <block=4, 512 bytes>
sent LOCALHOST.69 ACK <block=4>
received LOCALHOST.69 DATA <block=5, 313 bytes>
Received 2361 bytes in 2 seconds.
tftp>