Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
tftp(1)				 User Commands			       tftp(1)

NAME
       tftp - trivial file transfer program

SYNOPSIS
       tftp [ host [port]]

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	and optional port may be specified on the com-
       mand line, in which case	tftp uses host as the  default	host,  and  if
       specified, port as the default port, for	future transfers. See the con-
       nect command below.

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

   Commands
       connect host-name [ port	]

	   Set	the  host, and optionally port,	for transfers. The TFTP	proto-
	   col,	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	trans-
	   fers.  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 filename
       put localfile remotefile
       put filename1 filename2 ... filenameN remote-directory

	    Transfer  a	 file, or a set	of files, to the specified remote file
	   or directory. The destination can be	in one of two forms:  a	 file-
	   name	 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	 specified host	becomes	the default for	future
	   transfers. If the remote-directory form is used, the	remote host is
	   assumed to be running the UNIX system.

	   The host can	be a host name (see hosts(4) or	ipnodes(4)) or an IPv4
	   or IPv6 address string (see inet(7P)	or inet6(7P)). Since IPv6  ad-
	   dresses already contain ":"s, the host should be enclosed in	square
	   brackets when an IPv6 address is used. Otherwise, the first	occur-
	   rence  of  a	colon will be interpreted as the separator between the
	   host	and the	filename. For example,

	   [1080::8:800:200c:417A]:myfile

	   Files may be	written	only if	they already exist  and	 are  publicly
	   writable. See in.tftpd(1M).

       get filename
       get remotename localname
       get filename1 filename2 filename3 ... filenameN

	    Get	 a file	or set of files	(three or more)	from the specified re-
	   mote	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 host specified becomes the default for fu-
	   ture	transfers. See the put command regarding specifying a host.

       quit

	   Exit	tftp. An EOF 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.

       blksize transfer-blocksize

	   The value of	the transfer blocksize option to  negotiate  with  the
	   server. A value of 0	disables the negotiation of this option.

       srexmt server-retransmission-timeout

	   The	value of the retransmission timeout option to request that the
	   server uses.	A value	of 0 disables the negotiation of this option.

       tsize

	   A toggle that sends the transfer size option	to the server. By  de-
	   fault, the option is	not sent. The transfer size option is not sent
	   with	a write	request	when the transfer-mode is ascii.

       ? [  command-name ... ]

	   Print help information.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWtftp			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       in.tftpd(1M), hosts(4), ipnodes(4),attributes(5),inet(7P), inet6(7P)

       Malkin, G. and Harkin, A. RFC 2347, TFTP	Option Extension. The Internet
       Society.	May 1998

       Malkin, G. and Harkin, A. RFC 2348, TFTP	Blocksize Option. The Internet
       Society.	May 1998

       Malkin, G. and Harkin, A. RFC 2349, TFTP	Timeout	Interval and  Transfer
       Size Options. The Internet Society. May 1998

       Sollins,	 K.R. RFC 1350,	The TFTP Protocol (Revision 2).	 Network Work-
       ing Group. July 1992.

NOTES
       The default transfer-mode is ascii. This	differs	from pre-SunOS 4.0 and
       pre-4.3BSD  systems, so explicit	action must be taken when transferring
       non-ASCII binary	files such as executable commands.

       Because there is	no user-login or validation within the TFTP  protocol,
       many  remote sites restrict file	access in various ways.	Approved meth-
       ods for file access are specific	to each	site, and therefore cannot  be
       documented here.

       When  using  the	 get  command to transfer multiple files from a	remote
       host, three or more files must be specified.  If	two files  are	speci-
       fied, the second	file is	used as	a local	file.

SunOS 5.10			  2 Jan	2002			       tftp(1)

NAME | SYNOPSIS | DESCRIPTION | USAGE | ATTRIBUTES | SEE ALSO | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=tftp&sektion=1&manpath=SunOS+5.10>

home | help