Annotation of cci/usr/src/man/man1/tftp.1c, revision 1.1.1.1

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

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.