4.3BSD-UWisc/man/cat1/tftp.1c

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



NAME
     tftp - trivial file transfer program

SYNOPSIS
     tftp [ host ]

DESCRIPTION
     _T_f_t_p 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 _h_o_s_t may be
     specified on the command line, in which case _t_f_t_p uses _h_o_s_t
     as the default host for future transfers (see the connect
     command below).

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

     connect _h_o_s_t-_n_a_m_e [ _p_o_r_t ]
          Set the _h_o_s_t (and optionally _p_o_r_t) for transfers.  Note
          that the TFTP protocol, unlike the FTP protocol, does
          not maintain connections betweeen transfers; thus, the
          _c_o_n_n_e_c_t 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 _c_o_n_n_e_c_t command;
          the remote host can be specified as part of the _g_e_t or
          _p_u_t commands.

     mode _t_r_a_n_s_f_e_r-_m_o_d_e
          Set the mode for transfers; _t_r_a_n_s_f_e_r-_m_o_d_e may be one of
          _a_s_c_i_i or _b_i_n_a_r_y.  The default is _a_s_c_i_i.

     put _f_i_l_e
     put _l_o_c_a_l_f_i_l_e _r_e_m_o_t_e_f_i_l_e
     put _f_i_l_e_1 _f_i_l_e_2 ... _f_i_l_e_N _r_e_m_o_t_e-_d_i_r_e_c_t_o_r_y
          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
          _h_o_s_t:_f_i_l_e_n_a_m_e 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 _U_N_I_X machine.

     get _f_i_l_e_n_a_m_e
     get _r_e_m_o_t_e_n_a_m_e _l_o_c_a_l_n_a_m_e
     get _f_i_l_e_1 _f_i_l_e_2 ... _f_i_l_e_N
          Get a file or set of files from the specified _s_o_u_r_c_e_s.
          _S_o_u_r_c_e 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 _h_o_s_t:_f_i_l_e_n_a_m_e to specify both a



Printed 12/27/86         April 20, 1986                         1






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



          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 _t_f_t_p.  An end of file also exits.

     verbose
          Toggle verbose mode.

     trace
          Toggle packet tracing.

     status
          Show current status.

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

     timeout _t_o_t_a_l-_t_r_a_n_s_m_i_s_s_i_o_n-_t_i_m_e_o_u_t
          Set the total transmission timeout, in seconds.

     ascii
          Shorthand for "mode ascii"

     binary
          Shorthand for "mode binary"

     ?  [ _c_o_m_m_a_n_d-_n_a_m_e ... ]
          Print help information.

BUGS
     Because there is no user-login or validation within the _T_F_T_P
     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 12/27/86         April 20, 1986                         2