2.11BSD#431 - /usr/man/cat1/tftp.0

TFTP(1)             UNIX Programmer's Manual		  TFTP(1)


NAME
     tftp - trivial file transfer program

SYNOPSIS
     tftp [ host ]

DESCRIPTION
     Tftp is the user interface to the Internet TFTP (Trivial
     File Transfer Protocol), which allows users to transfer
     files to and from a remote machine.  The remote host may be
     specified on the command line, in which case tftp uses host
     as the default host for future transfers (see the connect
     command below).

COMMANDS
     Once tftp is running, it issues the prompt tftp> and recog-
     nizes the following commands:

     connect host-name [ port ]
	  Set the host (and optionally port) for transfers.  Note
	  that the TFTP protocol, unlike the FTP protocol, does
	  not maintain connections betweeen 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 may be one of
	  ascii or binary.  The default is ascii.

     put file
     put localfile remotefile
     put file1 file2 ... fileN remote-directory
	  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 host-
	  name specified becomes the default for future
	  transfers.  If the remote-directory form is used, the
	  remote host is assumed to be a UNIX machine.

     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


Printed 11/24/99	       1Q				1


TFTP(1)             UNIX Programmer's Manual		  TFTP(1)


	  host and filename at the same time.  If the latter form
	  is used, the last hostname specified becomes the
	  default for future transfers.

     quit Exit tftp.  An end of file also exits.

     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"

     ?	[ command-name ... ]
	  Print help information.

BUGS
     Because there is no user-login or validation within the TFTP
     protocol, the remote site will probably have some sort of
     file-access restrictions in place.  The exact methods are
     specific to each site and therefore difficult to document
     here.


Printed 11/24/99	       2Q				2