NAME    [Toc]    [Back]

     tftp - trivial file transfer program

SYNOPSIS    [Toc]    [Back]

     tftp [host [port]]

DESCRIPTION    [Toc]    [Back]

     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 and port may  be  specified  on  the
command line, in
     which  case  tftp uses them as the default for future transfers (see the
     connect command below).

COMMANDS    [Toc]    [Back]

     Once tftp is running, it issues the prompt `tftp>' and  recognizes the
     following commands:

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

     ascii    Shorthand for mode ascii.

     binary   Shorthand for mode binary.

     connect host [port]
              Set  the  host (and optionally port) for transfers.
Note that the
              TFTP protocol, unlike the FTP  protocol,  does  not
maintain connections
  between 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.

     get [host:]file [localname]
     get [host1:]file1 [host2:]file2 ... [hostN:]fileN
              Get  a  file  or set of files from the remote host.
When using the
              host argument, the host will be used as the default
host for future
  transfers.   If  localname  is specified, the
file is stored
              locally as localname, otherwise the original  filename is used.

              Note  that it is not possible to download two files
at the same
              time; only one, three, or more than three files can
be downloaded
 at the same time.

     mode transfer-mode
              Set  the  mode  for transfers; transfer-mode may be
one of ascii or
              binary.  The default is ascii.

     put file [[host:]remotename]
     put file1 file2 ... fileN [[host:]remote-directory]
              Put a file or set of  files  to  the  remote  host.
When using the
              host argument, the host will be used as the default
host for future
 transfers.  If remotename  is  specified,  the
file is stored
              remotely  as  remotename,  otherwise  the  original
filename is used.
              If the remote-directory argument is used,  the  remote host is assumed
 to be a UNIX machine.

              Note  that files may only be written to if they already exist on
              the remote host and  are  publicly  writable.   See
tftpd(8) for
              further details.

     quit     Exit tftp.  An end-of-file also exits.

     rexmt retransmission-timeout
              Set  the per-packet retransmission timeout, in seconds.

     status   Show current status.

     timeout total-transmission-timeout
              Set the total transmission timeout, in seconds.

     trace    Toggle packet tracing.

     verbose  Toggle verbose mode.

SEE ALSO    [Toc]    [Back]

     ftp(1), tftpd(8)

HISTORY    [Toc]    [Back]

     The tftp command appeared in 4.3BSD.

BUGS    [Toc]    [Back]

     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.

     This implementation of tftp does not support blocksize negotiation (RFC
     1783), so files larger than 33488896 octets  (65535  blocks)
cannot be
     transferred.

OpenBSD      3.6                          April      18,     1994