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


NAME
       tftp - IPv4 Trivial File Transfer Protocol client

SYNOPSIS
       tftp [options...]  [host]

DESCRIPTION
       tftp is a client for the IPv4 Trivial file Transfer Proto-
       col, which can be used  to  transfer  files  to	and  from
       remote machines, including some very minimalistic, usually
       embedded, systems.  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.)

OPTIONS
       -v     Default to verbose mode.

       -V     Print the version number and configuration to stan-
	      dard output, then exit gracefully.

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

       ? command-name...

       help 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  proto-
	      col,  does  not maintain connections between trans-
	      fers; 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 file
       get remotefile localfile
       get file1 file2 file3...
	      Get a file or  set  of  files  from  the	specified
	      sources.	 A  remote  filename can be in one of two
	      forms: a plain 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 file-
	      name at the same time.  If the latter form is used,
	      the last hostname specified becomes the default for
	      future transfers.

       mode transfer-mode
	      Specify  the  mode for transfers; transfer-mode may
	      be one of ascii (or netascii) or binary (or octet.)
	      The default is ascii.

       put file
       put localfile remotefile
       put file1 file2 file3... 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 file-
	      name 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 sys-
	      tem or another system using / as directory  separa-
	      tor.

       quit   Exit tftp.  End-of-file will also exit.

       rexmt retransmission-timeout
	      Set  the per-packet retransmission timeout, in sec-
	      onds.

       status Show current status.

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

       trace  Toggle packet tracing (a debugging feature.)

       verbose
	      Toggle verbose mode.

NOTES
       The TFTP protocol provides no provisions	 for  authentica-
       tion or security.  Therefore, the remote server will prob-
       ably implement some kinds of access restriction	or  fire-
       walling.	 These access restrictions are likely to be site-
       and server-specific.

AUTHOR
       This version of tftp  is	 maintained  by	 H.  Peter  Anvin
       <hpa@zytor.com>.	  It  was  derived from, but has substan-
       tially diverged from, an OpenBSD source base,  with  added
       patches by Markus Gutschke and Gero Kulhman.

SEE ALSO
       tftpd(8).


tftp-hpa		 13 November 2001			2
