tftp.1 (10f9229070a6a01520c51edb9a0ffff63994f1d4) tftp.1 (752fa694029c20397f7928fa5f6b80f787677be2)
1.\" Copyright (c) 1990, 1993, 1994
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 23 unchanged lines hidden (view full) ---

32.\" @(#)tftp.1 8.2 (Berkeley) 4/18/94
33.\" $FreeBSD$
34.\"
35.Dd October 1, 2003
36.Dt TFTP 1
37.Os
38.Sh NAME
39.Nm tftp
1.\" Copyright (c) 1990, 1993, 1994
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 23 unchanged lines hidden (view full) ---

32.\" @(#)tftp.1 8.2 (Berkeley) 4/18/94
33.\" $FreeBSD$
34.\"
35.Dd October 1, 2003
36.Dt TFTP 1
37.Os
38.Sh NAME
39.Nm tftp
40.Nd "trivial file transfer program"
40.Nd trivial file transfer program
41.Sh SYNOPSIS
42.Nm
43.Op Ar host Op Ar port
44.Sh DESCRIPTION
45The
46.Nm
47utility is the user interface to the Internet
48.Tn TFTP
49(Trivial File Transfer Protocol),
50which allows users to transfer files to and from a remote machine.
51The remote
52.Ar host
53may be specified on the command line, in which case
54.Nm
55uses
56.Ar host
57as the default host for future transfers (see the
41.Sh SYNOPSIS
42.Nm
43.Op Ar host Op Ar port
44.Sh DESCRIPTION
45The
46.Nm
47utility is the user interface to the Internet
48.Tn TFTP
49(Trivial File Transfer Protocol),
50which allows users to transfer files to and from a remote machine.
51The remote
52.Ar host
53may be specified on the command line, in which case
54.Nm
55uses
56.Ar host
57as the default host for future transfers (see the
58.Ic connect
58.Cm connect
59command below).
60.Sh COMMANDS
61Once
62.Nm
63is running, it issues the prompt
59command below).
60.Sh COMMANDS
61Once
62.Nm
63is running, it issues the prompt
64.Dq Li "tftp> "
64.Dq Li tftp>
65and recognizes the following commands:
66.Pp
65and recognizes the following commands:
66.Pp
67.Bl -tag -width ".Ic verbose" -compact
68.It Ic \&? Ar command-name ...
67.Bl -tag -width verbose -compact
68.It Cm \&? Ar command-name ...
69Print help information.
70.Pp
69Print help information.
70.Pp
71.It Ic ascii
72Shorthand for
73.Ic mode Cm ascii .
71.It Cm ascii
72Shorthand for "mode ascii"
74.Pp
73.Pp
75.It Ic binary
76Shorthand for
77.Ic mode Cm binary .
74.It Cm binary
75Shorthand for "mode binary"
78.Pp
76.Pp
79.It Ic connect Ar host Op Ar port
77.It Cm connect Ar host Op Ar port
80Set the
81.Ar host
82(and optionally
83.Ar port )
84for transfers.
85Note that the
86.Tn TFTP
87protocol, unlike the
88.Tn FTP
89protocol,
90does not maintain connections between transfers; thus, the
78Set the
79.Ar host
80(and optionally
81.Ar port )
82for transfers.
83Note that the
84.Tn TFTP
85protocol, unlike the
86.Tn FTP
87protocol,
88does not maintain connections between transfers; thus, the
91.Ic connect
89.Cm connect
92command does not actually create a connection,
93but merely remembers what host is to be used for transfers.
94You do not have to use the
90command does not actually create a connection,
91but merely remembers what host is to be used for transfers.
92You do not have to use the
95.Ic connect
93.Cm connect
96command; the remote host can be specified as part of the
94command; the remote host can be specified as part of the
97.Ic get
95.Cm get
98or
96or
99.Ic put
97.Cm put
100commands.
101.Pp
98commands.
99.Pp
102.It Ic get Oo Ar host : Oc Ns Ar file Op Ar localname
103.It Ic get Xo
100.It Cm get Oo Ar host : Oc Ns Ar file Op Ar localname
101.It Cm get Xo
104.Oo Ar host1 : Oc Ns Ar file1
105.Oo Ar host2 : Oc Ns Ar file2 ...
106.Oo Ar hostN : Oc Ns Ar fileN
107.Xc
108Get one or more files from the remote host.
109When using the
110.Ar host
111argument, the

--- 9 unchanged lines hidden (view full) ---

121.Pp
122To specify an IPv6 numeric address for a host, wrap it using square
123brackets like
124.Dq Li [3ffe:2900:e00c:ffee::1234] : Ns Ar file
125to disambiguate the
126colons used in the IPv6 address from the colon separating the host and
127the filename.
128.Pp
102.Oo Ar host1 : Oc Ns Ar file1
103.Oo Ar host2 : Oc Ns Ar file2 ...
104.Oo Ar hostN : Oc Ns Ar fileN
105.Xc
106Get one or more files from the remote host.
107When using the
108.Ar host
109argument, the

--- 9 unchanged lines hidden (view full) ---

119.Pp
120To specify an IPv6 numeric address for a host, wrap it using square
121brackets like
122.Dq Li [3ffe:2900:e00c:ffee::1234] : Ns Ar file
123to disambiguate the
124colons used in the IPv6 address from the colon separating the host and
125the filename.
126.Pp
129.It Ic mode Ar transfer-mode
127.It Cm mode Ar transfer-mode
130Set the mode for transfers;
131.Ar transfer-mode
132may be one of
128Set the mode for transfers;
129.Ar transfer-mode
130may be one of
133.Cm ascii
131.Em ascii
134or
132or
135.Cm binary .
133.Em binary .
136The default is
134The default is
137.Cm ascii .
135.Em ascii .
138.Pp
136.Pp
139.It Ic put Ar file Op Oo Ar host : Oc Ns Ar remotename
140.It Ic put Ar file1 file2 ... fileN Op Oo Ar host : Oc Ns Ar remote-directory
137.It Cm put Ar file Op Oo Ar host : Oc Ns Ar remotename
138.It Cm put Ar file1 file2 ... fileN Op Oo Ar host : Oc Ns Ar remote-directory
141Put a file or set of files to the remote host.
142When
143.Ar remotename
144is specified, the file is stored remotely as
145.Ar remotename ,
146otherwise the original filename is used.
147If the
148.Ar remote-directory
149argument is used, the remote host is assumed to be a
150.Ux
151machine.
152To specify an IPv6 numeric address for a
153.Ar host ,
154see the example under the
139Put a file or set of files to the remote host.
140When
141.Ar remotename
142is specified, the file is stored remotely as
143.Ar remotename ,
144otherwise the original filename is used.
145If the
146.Ar remote-directory
147argument is used, the remote host is assumed to be a
148.Ux
149machine.
150To specify an IPv6 numeric address for a
151.Ar host ,
152see the example under the
155.Ic get
153.Cm get
156command.
157.Pp
154command.
155.Pp
158.It Ic quit
156.It Cm quit
159Exit
160.Nm .
161An end of file also exits.
162.Pp
157Exit
158.Nm .
159An end of file also exits.
160.Pp
163.It Ic rexmt Ar retransmission-timeout
161.It Cm rexmt Ar retransmission-timeout
164Set the per-packet retransmission timeout, in seconds.
165.Pp
162Set the per-packet retransmission timeout, in seconds.
163.Pp
166.It Ic status
164.It Cm status
167Show current status.
168.Pp
165Show current status.
166.Pp
169.It Ic timeout Ar total-transmission-timeout
167.It Cm timeout Ar total-transmission-timeout
170Set the total transmission timeout, in seconds.
171.Pp
168Set the total transmission timeout, in seconds.
169.Pp
172.It Ic trace
170.It Cm trace
173Toggle packet tracing.
174.Pp
171Toggle packet tracing.
172.Pp
175.It Ic verbose
173.It Cm verbose
176Toggle verbose mode.
177.El
178.Sh HISTORY
179The
180.Nm
181command appeared in
182.Bx 4.3 .
183.Sh BUGS
184Because there is no user-login or validation within
185the
186.Tn TFTP
187protocol, the remote site will probably have some
188sort of file-access restrictions in place.
189The
190exact methods are specific to each site and therefore
191difficult to document here.
192.Pp
193Files larger than 33488896 octets (65535 blocks) cannot be transferred
194without client and server supporting blocksize negotiation (RFC1783).
174Toggle verbose mode.
175.El
176.Sh HISTORY
177The
178.Nm
179command appeared in
180.Bx 4.3 .
181.Sh BUGS
182Because there is no user-login or validation within
183the
184.Tn TFTP
185protocol, the remote site will probably have some
186sort of file-access restrictions in place.
187The
188exact methods are specific to each site and therefore
189difficult to document here.
190.Pp
191Files larger than 33488896 octets (65535 blocks) cannot be transferred
192without client and server supporting blocksize negotiation (RFC1783).