|
|
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.