Annotation of src/usr.bin/tftp/tftp.1, Revision 1.13
1.13 ! jmc 1: .\" $OpenBSD: tftp.1,v 1.12 2006/07/24 17:29:58 mglocker 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
1.10 jmc 61: .Ql tftp\*(Gt
1.1 deraadt 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.13 ! jmc 76: .It Ic blksize Ar block-size
! 77: Set the block size in bytes for one packet.
! 78: The default value is 512 bytes.
! 79: Valid values are 8 bytes \(en 65464 bytes.
! 80: .Pp
1.3 aaron 81: .It Ic connect Ar host Op Ar port
1.1 deraadt 82: Set the
83: .Ar host
84: (and optionally
85: .Ar port )
86: for transfers.
87: Note that the
88: .Tn TFTP
89: protocol, unlike the
90: .Tn FTP
91: protocol,
92: does not maintain connections between transfers; thus, the
1.3 aaron 93: .Ic connect
1.1 deraadt 94: command does not actually create a connection,
95: but merely remembers what host is to be used for transfers.
1.4 aaron 96: You do not have to use the
1.3 aaron 97: .Ic connect
1.1 deraadt 98: command; the remote host can be specified as part of the
1.3 aaron 99: .Ic get
1.1 deraadt 100: or
1.3 aaron 101: .Ic put
1.1 deraadt 102: commands.
103: .Pp
1.8 jmc 104: .It Xo
1.10 jmc 105: .Ic get Oo Ar host : Oc Ns
1.8 jmc 106: .Ar file Op Ar localname
107: .Xc
108: .It Xo
1.10 jmc 109: .Ic get Oo Ar host1 : Oc Ns
1.8 jmc 110: .Ar file1
1.10 jmc 111: .Oo Ar host2 : Oc Ns
1.8 jmc 112: .Ar file2
113: .Ar ...
1.10 jmc 114: .Oo Ar hostN : Oc Ns
1.8 jmc 115: .Ar fileN
116: .Xc
117: Get a file or set of files from the remote host.
118: When using the
119: .Ar host
120: argument, the
121: .Ar host
122: will be used as the default host for future transfers.
123: If
124: .Ar localname
125: is specified,
126: the file is stored locally as
127: .Ar localname ,
128: otherwise the original filename is used.
129: .Pp
130: Note that it is not possible to download two files at the same time;
131: only one, three, or more than three files
132: can be downloaded at the same time.
1.1 deraadt 133: .Pp
1.3 aaron 134: .It Ic mode Ar transfer-mode
1.4 aaron 135: Set the mode for transfers;
1.1 deraadt 136: .Ar transfer-mode
137: may be one of
1.8 jmc 138: .Ar ascii
1.1 deraadt 139: or
1.8 jmc 140: .Ar binary .
1.1 deraadt 141: The default is
1.8 jmc 142: .Ar ascii .
1.1 deraadt 143: .Pp
1.8 jmc 144: .It Xo
145: .Ic put Ar file
1.10 jmc 146: .Oo Oo Ar host : Oc Ns
1.8 jmc 147: .Ar remotename Oc
148: .Xc
149: .It Xo
150: .Ic put Ar file1 file2 ... fileN
1.10 jmc 151: .Oo Oo Ar host : Oc Ns
1.8 jmc 152: .Ar remote-directory Oc
153: .Xc
154: Put a file or set of files to the remote host.
155: When using the
156: .Ar host
157: argument, the
158: .Ar host
159: will be used as the default host for future transfers.
160: If
161: .Ar remotename
162: is specified, the file is stored remotely as
163: .Ar remotename ,
164: otherwise the original filename is used.
165: If the
166: .Ar remote-directory
167: argument is used, the remote host is assumed to be a
1.1 deraadt 168: .Tn UNIX
169: machine.
170: .Pp
1.8 jmc 171: Note that files may only be written to if they already exist on the
172: remote host and are publicly writable.
173: See
174: .Xr tftpd 8
175: for further details.
176: .Pp
1.3 aaron 177: .It Ic quit
1.1 deraadt 178: Exit
1.10 jmc 179: .Nm .
1.3 aaron 180: An end-of-file also exits.
1.1 deraadt 181: .Pp
1.3 aaron 182: .It Ic rexmt Ar retransmission-timeout
1.13 ! jmc 183: Set the per-packet retransmission timeout, in seconds.
! 184: The default value is 5 seconds.
! 185: Valid values are 1 second \(en 255 seconds.
1.1 deraadt 186: .Pp
1.3 aaron 187: .It Ic status
1.1 deraadt 188: Show current status.
189: .Pp
1.3 aaron 190: .It Ic timeout Ar total-transmission-timeout
1.1 deraadt 191: Set the total transmission timeout, in seconds.
192: .Pp
1.13 ! jmc 193: .It Ic tout
! 194: Toggle the
! 195: .Ic tout
! 196: option.
! 197: This option devlivers the retransmission-timeout,
! 198: which is set by
! 199: .Ic rexmt ,
! 200: to the server,
! 201: so the server uses the same retransmission-timeout as the client.
! 202: .Pp
! 203: .It Ic tsize
! 204: Toggle the
! 205: .Ic tsize
! 206: option.
! 207: This option delivers the total size of the file to be transferred.
! 208: With this value given, the client or server can decide
! 209: whether they are able to accept the file.
! 210: .Pp
1.3 aaron 211: .It Ic trace
1.1 deraadt 212: Toggle packet tracing.
213: .Pp
1.3 aaron 214: .It Ic verbose
1.1 deraadt 215: Toggle verbose mode.
216: .El
1.5 aaron 217: .Sh SEE ALSO
1.8 jmc 218: .Xr ftp 1 ,
1.11 jmc 219: .Xr tftp-proxy 8 ,
1.8 jmc 220: .Xr tftpd 8
1.5 aaron 221: .Sh HISTORY
222: The
223: .Nm
224: command appeared in
225: .Bx 4.3 .
1.1 deraadt 226: .Sh BUGS
1.3 aaron 227: Because there is no user login or validation within
1.1 deraadt 228: the
229: .Tn TFTP
230: protocol, the remote site will probably have some
1.6 aaron 231: sort of file access restrictions in place.
232: The exact methods are specific to each site and therefore
1.1 deraadt 233: difficult to document here.