tftp(1) - c7

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
43       -w window-size
44              Set the "windowsize" TFTP option (RFC  7440)  to  the  specified
45              value.
46

COMMANDS

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

NOTES

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

AUTHOR

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