Annotation of src/usr.bin/tftp/tftp.1, Revision 1.9
1.9 ! jmc 1: .\" $OpenBSD: tftp.1,v 1.8 2003/09/25 09:45:46 jmc Exp $
1.1 deraadt 2: .\" $NetBSD: tftp.1,v 1.5 1995/08/18 14:45:44 pk Exp $
3: .\"
4: .\" Copyright (c) 1990, 1993, 1994
5: .\" The Regents of the University of California. All rights reserved.
6: .\"
7: .\" Redistribution and use in source and binary forms, with or without
8: .\" modification, are permitted provided that the following conditions
9: .\" are met:
10: .\" 1. Redistributions of source code must retain the above copyright
11: .\" notice, this list of conditions and the following disclaimer.
12: .\" 2. Redistributions in binary form must reproduce the above copyright
13: .\" notice, this list of conditions and the following disclaimer in the
14: .\" documentation and/or other materials provided with the distribution.
1.7 millert 15: .\" 3. Neither the name of the University nor the names of its contributors
1.1 deraadt 16: .\" may be used to endorse or promote products derived from this software
17: .\" without specific prior written permission.
18: .\"
19: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29: .\" SUCH DAMAGE.
30: .\"
31: .\" @(#)tftp.1 8.2 (Berkeley) 4/18/94
32: .\"
33: .Dd April 18, 1994
34: .Dt TFTP 1
1.4 aaron 35: .Os
1.1 deraadt 36: .Sh NAME
37: .Nm tftp
38: .Nd trivial file transfer program
39: .Sh SYNOPSIS
40: .Nm tftp
1.9 ! jmc 41: .Op Ar host Oo Ar port Oc
1.1 deraadt 42: .Sh DESCRIPTION
1.6 aaron 43: .Nm
1.1 deraadt 44: is the user interface to the Internet
45: .Tn TFTP
46: (Trivial File Transfer Protocol),
47: which allows users to transfer files to and from a remote machine.
48: The remote
49: .Ar host
1.8 jmc 50: and
51: .Ar port
1.1 deraadt 52: may be specified on the command line, in which case
1.6 aaron 53: .Nm
1.8 jmc 54: uses them as the default for future transfers (see the
1.3 aaron 55: .Ic connect
1.1 deraadt 56: command below).
57: .Sh COMMANDS
58: Once
1.6 aaron 59: .Nm
1.1 deraadt 60: is running, it issues the prompt
61: .Ql tftp>
62: and recognizes the following commands:
63: .Pp
64: .Bl -tag -width verbose -compact
1.3 aaron 65: .It Ic \&? Ar command-name Op Ar ...
1.1 deraadt 66: Print help information.
67: .Pp
1.3 aaron 68: .It Ic ascii
69: Shorthand for
1.8 jmc 70: .Ic mode Ar ascii .
1.3 aaron 71: .Pp
72: .It Ic binary
73: Shorthand for
1.8 jmc 74: .Ic mode Ar binary .
1.1 deraadt 75: .Pp
1.3 aaron 76: .It Ic connect Ar host Op Ar port
1.1 deraadt 77: Set the
78: .Ar host
79: (and optionally
80: .Ar port )
81: for transfers.
82: Note that the
83: .Tn TFTP
84: protocol, unlike the
85: .Tn FTP
86: protocol,
87: does not maintain connections between transfers; thus, the
1.3 aaron 88: .Ic connect
1.1 deraadt 89: command does not actually create a connection,
90: but merely remembers what host is to be used for transfers.
1.4 aaron 91: You do not have to use the
1.3 aaron 92: .Ic connect
1.1 deraadt 93: command; the remote host can be specified as part of the
1.3 aaron 94: .Ic get
1.1 deraadt 95: or
1.3 aaron 96: .Ic put
1.1 deraadt 97: commands.
98: .Pp
1.8 jmc 99: .It Xo
100: .Ic get Oo Ar host Ns : Oc Ns
101: .Ar file Op Ar localname
102: .Xc
103: .It Xo
104: .Ic get Oo Ar host1 Ns : Oc Ns
105: .Ar file1
106: .Oo Ar host2 Ns : Oc Ns
107: .Ar file2
108: .Ar ...
109: .Oo Ar hostN Ns : Oc Ns
110: .Ar fileN
111: .Xc
112: Get a file or set of files from the remote host.
113: When using the
114: .Ar host
115: argument, the
116: .Ar host
117: will be used as the default host for future transfers.
118: If
119: .Ar localname
120: is specified,
121: the file is stored locally as
122: .Ar localname ,
123: otherwise the original filename is used.
124: .Pp
125: Note that it is not possible to download two files at the same time;
126: only one, three, or more than three files
127: can be downloaded at the same time.
1.1 deraadt 128: .Pp
1.3 aaron 129: .It Ic mode Ar transfer-mode
1.4 aaron 130: Set the mode for transfers;
1.1 deraadt 131: .Ar transfer-mode
132: may be one of
1.8 jmc 133: .Ar ascii
1.1 deraadt 134: or
1.8 jmc 135: .Ar binary .
1.1 deraadt 136: The default is
1.8 jmc 137: .Ar ascii .
1.1 deraadt 138: .Pp
1.8 jmc 139: .It Xo
140: .Ic put Ar file
141: .Oo Oo Ar host Ns : Oc Ns
142: .Ar remotename Oc
143: .Xc
144: .It Xo
145: .Ic put Ar file1 file2 ... fileN
146: .Oo Oo Ar host Ns : Oc Ns
147: .Ar remote-directory Oc
148: .Xc
149: Put a file or set of files to the remote host.
150: When using the
151: .Ar host
152: argument, the
153: .Ar host
154: will be used as the default host for future transfers.
155: If
156: .Ar remotename
157: is specified, the file is stored remotely as
158: .Ar remotename ,
159: otherwise the original filename is used.
160: If the
161: .Ar remote-directory
162: argument is used, the remote host is assumed to be a
1.1 deraadt 163: .Tn UNIX
164: machine.
165: .Pp
1.8 jmc 166: Note that files may only be written to if they already exist on the
167: remote host and are publicly writable.
168: See
169: .Xr tftpd 8
170: for further details.
171: .Pp
1.3 aaron 172: .It Ic quit
1.1 deraadt 173: Exit
174: .Nm tftp .
1.3 aaron 175: An end-of-file also exits.
1.1 deraadt 176: .Pp
1.3 aaron 177: .It Ic rexmt Ar retransmission-timeout
1.1 deraadt 178: Set the per-packet retransmission timeout, in seconds.
179: .Pp
1.3 aaron 180: .It Ic status
1.1 deraadt 181: Show current status.
182: .Pp
1.3 aaron 183: .It Ic timeout Ar total-transmission-timeout
1.1 deraadt 184: Set the total transmission timeout, in seconds.
185: .Pp
1.3 aaron 186: .It Ic trace
1.1 deraadt 187: Toggle packet tracing.
188: .Pp
1.3 aaron 189: .It Ic verbose
1.1 deraadt 190: Toggle verbose mode.
191: .El
1.5 aaron 192: .Sh SEE ALSO
1.8 jmc 193: .Xr ftp 1 ,
194: .Xr tftpd 8
1.5 aaron 195: .Sh HISTORY
196: The
197: .Nm
198: command appeared in
199: .Bx 4.3 .
1.1 deraadt 200: .Sh BUGS
1.3 aaron 201: Because there is no user login or validation within
1.1 deraadt 202: the
203: .Tn TFTP
204: protocol, the remote site will probably have some
1.6 aaron 205: sort of file access restrictions in place.
206: The exact methods are specific to each site and therefore
1.1 deraadt 207: difficult to document here.
1.8 jmc 208: .Pp
209: Files larger than 33488896 octets (65535 blocks) cannot be transferred
210: without client and server supporting blocksize negotiation (RFC 1783).
211: .Pp
212: Many tftp clients will not transfer files over 16744448 octets (32767 blocks).
![[BACK]](/icons/back.gif){kind=icon}
Return to tftp.1 CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [local] / src / usr.bin / tftp