Annotation of 43BSDReno/usr.bin/tftp/tftp.1, revision 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.