|
|
1.1 root 1: .\" Copyright (c) 1990 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)tftp.1 5.4 (Berkeley) 6/24/90
19: .\"
20: .TH TFTP 1 "%Q"
21: .UC 6
22: .SH NAME
23: tftp \- trivial file transfer program
24: .SH SYNOPSIS
25: .B tftp
26: [
27: host
28: ]
29: .SH DESCRIPTION
30: .I Tftp
31: is the user interface to the Internet TFTP
32: (Trivial File Transfer Protocol),
33: which allows users to transfer files to and from a remote machine.
34: The remote
35: .I host
36: may be specified on the command line, in which case
37: .I tftp
38: uses
39: .I host
40: as the default host for future transfers (see the
41: .B connect
42: command below).
43: .SH COMMANDS
44: Once
45: .I tftp
46: is running, it issues the prompt
47: .B tftp>
48: and recognizes the following commands:
49: .TP
50: \fBconnect\fP \fIhost-name\fP [ \fIport\fP ]
51: Set the
52: .I host
53: (and optionally
54: .IR port )
55: for transfers.
56: Note that the TFTP protocol, unlike the FTP protocol,
57: does not maintain connections betweeen transfers; thus, the
58: .I connect
59: command does not actually create a connection,
60: but merely remembers what host is to be used for transfers.
61: You do not have to use the
62: .I connect
63: command; the remote host can be specified as part of the
64: .I get
65: or
66: .I put
67: commands.
68: .TP
69: \fBmode\fP \fItransfer-mode\fP
70: Set the mode for transfers;
71: .I transfer-mode
72: may be one of
73: .IR ascii
74: or
75: .IR binary .
76: The default is
77: .IR ascii .
78: .TP
79: \fBput\fP \fIfile\fP
80: .ns
81: .TP
82: \fBput\fP \fIlocalfile remotefile\fP
83: .ns
84: .TP
85: \fBput\fP \fIfile1 file2 ... fileN remote-directory\fP
86: Put a file or set of files to the specified
87: remote file or directory.
88: The destination
89: can be in one of two forms:
90: a filename on the remote host, if the host has already been specified,
91: or a string of the form
92: .I host:filename
93: to specify both a host and filename at the same time.
94: If the latter form is used,
95: the hostname specified becomes the default for future transfers.
96: If the remote-directory form is used, the remote host is
97: assumed to be a
98: .I UNIX
99: machine.
100: .TP
101: \fBget\fP \fIfilename\fP
102: .ns
103: .TP
104: \fBget\fP \fIremotename\fP \fIlocalname\fP
105: .ns
106: .TP
107: \fBget\fP \fIfile1\fP \fIfile2\fP ... \fIfileN\fP
108: Get a file or set of files from the specified
109: .IR sources .
110: .I Source
111: can be in one of two forms:
112: a filename on the remote host, if the host has already been specified,
113: or a string of the form
114: .I host:filename
115: to specify both a host and filename at the same time.
116: If the latter form is used,
117: the last hostname specified becomes the default for future transfers.
118: .TP
119: .B quit
120: Exit
121: .IR tftp .
122: An end of file also exits.
123: .TP
124: .B verbose
125: Toggle verbose mode.
126: .TP
127: .B trace
128: Toggle packet tracing.
129: .TP
130: .B status
131: Show current status.
132: .TP
133: \fBrexmt\fP \fIretransmission-timeout\fP
134: Set the per-packet retransmission timeout, in seconds.
135: .TP
136: \fBtimeout\fP \fItotal-transmission-timeout\fP
137: Set the total transmission timeout, in seconds.
138: .TP
139: .B ascii
140: Shorthand for "mode ascii"
141: .TP
142: .B binary
143: Shorthand for "mode binary"
144: .TP
145: \fB?\fP \ [ \fIcommand-name\fP ... ]
146: Print help information.
147: .SH BUGS
148: .PP
149: Because there is no user-login or validation within
150: the
151: .I TFTP
152: protocol, the remote site will probably have some
153: sort of file-access restrictions in place. The
154: exact methods are specific to each site and therefore
155: difficult to document here.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.