TFTP(TC)                                   UNIX System V



     Name
          tftp - User interface to the DARPA TFTP protocol


     Syntax
          tftp [ host [ port ] ]


     Description
          The tftp command is the user interface to the DARPA standard
          Trivial  File  Transfer Protocol.  The program allows a user
          to transfer files to and from a remote network site.

          The client host with which tftp is  to  communicate  may  be
          specified  on  the command line.  If this is done, tftp will
          immediately attempt to establish  a  connection  to  a  TFTP
          server on that host.  Otherwise, tftp will enter its command
          interpreter and await instructions from the user.  When tftp
          is awaiting commands from the user, the prompt:

               tftp>

          appears.  The following commands are recognized by tftp:

          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 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 command.

          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 a filename  at
               the  same  time.   If  the  latter  form  is  used, the
               hostname  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
               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.


     Files
          /etc/hosts


     See Also
          tftpd(ADMN).


     Warnings
          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.


     (printed 8/17/89)                                  TFTP(TC)