|
|
1.1 root 1: .TH TFTP 1C "12 Nov 1984"
2: .UC 4
3: .SH NAME
4: tftp \- trivial file transfer program
5: .SH SYNOPSIS
6: .B tftp
7: [
8: .B host
9: ]
10: [
11: .B port
12: ]
13: .SH DESCRIPTION
14: .I Tftp
15: is the user interface to the ARPANET standard Trivial File Transfer Protocol.
16: The program allows a user to transfer files to and from a
17: remote network site
18: .I without
19: having a login account at that remote site; however, the remote files must be
20: accessible to the user.
21: .PP
22: The optional arguments are positional dependent. Argument
23: .I host
24: specifies the client host, and
25: .I port
26: specifies the port number through which
27: .I tftp
28: will contact an TFTP server.
29: If the user does not give a port number,
30: .I tftp
31: uses the port number reserved for TFTP servers.
32: .LP
33: .I Tftp
34: will then enter its command interpreter, print the prompt \*(lqtftp>\*(rq
35: and await the user's commands. It recognizes the following commands:
36: .TP
37: \fBconnect\fP \fIhost [port]\fP
38: specify the client host and optionally a port number through which
39: .I tftp
40: is to communicate with a TFTP server. The user
41: will be prompted for the missing arguments.
42: .TP
43: \fBmode\fP \fImode-type\fP
44: set the file transfer type to
45: .I mode-type.
46: Currently,
47: .I tftp
48: only supports the
49: .I ascii
50: type.
51: .TP
52: \fBput\fP \fIfrom-file [to-file]\fB
53: send a local file
54: .I from-file
55: to the remote file
56: .I to-file.
57: If
58: .I to-file
59: is not given,
60: .I tftp
61: uses the path
62: .I from-file
63: as the destination file.
64: See below for the argument description.
65: .TP
66: \fBput\fP \fIfrom-file from-file ... to-dir\fB
67: send a file or multiple files to the remote host.
68: Argument
69: .I from-file
70: specifies the local file to be sent, and
71: .I to-file
72: or
73: .I to-dir
74: the "address" of the receiving remote file or directory
75: which must have already existed and writeable by the user.
76: The format of
77: .I to-file
78: or
79: .I to-dir
80: is
81: .RS 12
82:
83: .I host-name:path-name
84:
85: or
86:
87: .I path-name
88:
89: where
90: .I host-name
91: is the remote site of the receiving file or directory, and
92: .I path-name
93: is the
94: .I full
95: pathname of the receiving file or directory.
96: If it is a directory, then the receiving files
97: must have already existed and writeable by the user. They
98: have the same base names as those of the original files.
99: If
100: .I host-name
101: is not given,
102: .I tftp
103: uses the host name most recently given.
104: .RE
105: .RS
106: The user is prompted for missing command arguments.
107: .RE
108: .TP
109: \fBget\fP \fIfrom-file [to-file]\fP
110: receive a single file from a remote host.
111: If
112: .I to-file
113: is not given,
114: .I tftp
115: uses the base name of the path
116: .I from-file
117: as the destination file.
118: See below for the argument description.
119: .TP
120: \fBget\fP \fIfrom-file from-file ... to-dir\fP
121: receive multiple files from a remote host.
122: The command argument
123: .I to-file
124: or
125: .I to-dir
126: specifies the local receiving file or directory, and
127: .I from-file
128: the remote file. The format of
129: .I from-file
130: is
131: .RS 12
132:
133: .I host-name:path-name
134:
135: or
136:
137: .I path-name
138:
139: .I host-name
140: and
141: .I path-name
142: are described in the
143: .I put
144: command.
145: If the receiving end is a directory, the receiving files
146: have the same base names as those of the original files.
147: .RE
148: .TP
149: .B quit
150: exit from
151: .I tftp.
152: .TP
153: .B trace
154: toggle the packet tracing option.
155: .TP
156: .B rexmt timeout-value
157: specify the
158: .I timeout-value
159: interval before each packet is retransmitted.
160: The default value is 5 seconds. The user will be prompted for any
161: missing arguments.
162: .TP
163: .B timeout timeout-value
164: specify the
165: overall
166: .I timeout-value
167: interval when retransmitting a packet. If this interval expires,
168: .I tftp
169: will terminate the file transfer process and prompt the user for
170: the next command. The default value is 25 seconds. The user will
171: be prompted for any missing arguments.
172: .TP
173: \fB?\fP \fIcommand-name\fP
174: to print a summary of available
175: .I tftp
176: commands. If
177: .Icommand-name
178: is given,
179: .I
180: tftp
181: prints the help messages for that particular command.
182: .PP
183: When receiving or sending files,
184: .I tftp
185: converts the Unix lines which terminate with 'nl' character into the
186: "network" lines which terminate with 'cr' 'nl' characters. As a result,
187: the number of transmitted or received characters is larger than the
188: actual file size.
189: .I Tftp
190: reports both the transmitted and actual file size.
191: .I Tftp
192: does not handle third party copies.
193: .SH DIAGNOSTICS
194: Both
195: .I tftp
196: (at the local site) and
197: TFTP server
198: (at the remote site) report errors detected during file transfers.
199: These errors concerns the file accessibility and are self-explanatory.
200: Error message from
201: .I tftp
202: are prefixed with "tftp:".
203: Error messages from the remote TFTP server are prefixed with
204: "Error code XX:".
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.