Annotation of 43BSDReno/usr.bin/tftp/tftp.1, revision 1.1.1.1

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.

unix.superglobalmegacorp.com

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