tftp(1) - c8

1TFTP(1)                          User's Manual                         TFTP(1)
2
3
4

NAME

6       tftp - IPv4 Trivial File Transfer Protocol client
7

SYNOPSIS

9       tftp [ options... ] [host [port]] [-c command]
10

DESCRIPTION

12       tftp  is  a client for the Trivial file Transfer Protocol, which can be
13       used to transfer files to and from remote machines, including some very
14       minimalistic, usually embedded, systems.  The remote host may be speci‐
15       fied on the command line, in which case tftp uses host as  the  default
16       host for future transfers (see the connect command below.)
17

OPTIONS

19       -4     Connect with IPv4 only, even if IPv6 support was compiled in.
20
21       -6     Connect with IPv6 only, if compiled in.
22
23       -c command
24              Execute  command  as  if it had been entered on the tftp prompt.
25              Must be specified last on the command line.
26
27       -l     Default to literal mode. Used to avoid special processing of ':'
28              in a file name.
29
30       -m mode
31              Set  the  default  transfer  mode to mode.  This is usually used
32              with -c.
33
34       -R port:port
35              Force the originating port number to be in the  specified  range
36              of port numbers.
37
38       -v     Default to verbose mode.
39
40       -V     Print  the  version number and configuration to standard output,
41              then exit gracefully.
42

COMMANDS

44       Once tftp is running, it issues the prompt  tftp>  and  recognizes  the
45       following commands:
46
47       ? command-name...
48
49       help command-name...
50              Print help information
51
52       ascii  Shorthand for mode ascii.
53
54       binary Shorthand for mode binary.
55
56       connect host [port]
57              Set the host (and optionally port) for transfers.  Note that the
58              TFTP protocol, unlike the FTP protocol, does not  maintain  con‐
59              nections  between  transfers; thus, the connect command does not
60              actually create a connection, but merely remembers what host  is
61              to  be  used  for transfers.  You do not have to use the connect
62              command; the remote host can be specified as part of the get  or
63              put commands.
64
65       get file
66       get remotefile localfile
67       get file1 file2 file3...
68              Get a file or set of files from the specified sources.  A remote
69              filename can be in one of two forms: a  plain  filename  on  the
70              remote host, if the host has already been specified, or a string
71              of the form host:filename to specify both a host and filename at
72              the  same  time.   If the latter form is used, the last hostname
73              specified becomes the default for future transfers.  Enable lit‐
74              eral  mode  to  prevent  special  treatment of the ':' character
75              (e.g. C:\dir\file).
76
77       literal
78              Toggle literal mode.   When  set,  this  mode  prevents  special
79              treatment of ':' in filenames.
80
81       mode transfer-mode
82              Specify  the  mode  for  transfers;  transfer-mode may be one of
83              ascii (or netascii) or binary (or octet.)  The default is ascii.
84
85       put file
86       put localfile remotefile
87       put file1 file2 file3... remote-directory
88              Put a file or set of files  to  the  specified  remote  file  or
89              directory.   The destination can be in one of two forms: a file‐
90              name on the remote host, if the host has already been specified,
91              or a string of the form host:filename to specify both a host and
92              filename at the same time.  If the  latter  form  is  used,  the
93              hostname specified becomes the default for future transfers.  If
94              the remote-directory form is used, the remote host is assumed to
95              be  a UNIX system or another system using / as directory separa‐
96              tor.  Enable literal mode to prevent special  treatment  of  the
97              ':' character (e.g. C:\dir\file).
98
99       quit   Exit tftp.  End-of-file will also exit.
100
101       rexmt retransmission-timeout
102              Set the per-packet retransmission timeout, in seconds.
103
104       status Show current status.
105
106       timeout total-transmission-timeout
107              Set the total transmission timeout, in seconds.
108
109       trace  Toggle packet tracing (a debugging feature.)
110
111       verbose
112              Toggle verbose mode.
113

NOTES

115       The  TFTP  protocol  provides no provisions for authentication or secu‐
116       rity.  Therefore, the remote server will probably implement some  kinds
117       of  access  restriction  or firewalling.  These access restrictions are
118       likely to be site- and server-specific.
119

AUTHOR

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