TFTP(1C)                             BSD                              TFTP(1C)



NAME
     tftp - trivial file transfer protocol

SYNOPSIS
     tftp [ -g|g!|p|r|w ]  localname host foreignname [mode]

DESCRIPTION
     tftp is the front-end to the Trivial File Transfer Protocol.  It enables
     you to copy files among internet hosts without remote user-level access.
     A minus sign (-) may be substituted for localname in which case the
     standard input (or output) will be used.

     tftp requires a switch to dictate the direction of the file transfer.
     The recognized switches are:

     put (-p, -w)
                Write the local file (localname) onto the foreign host's file
                system as foreignname.  Note that foreignname must be quoted
                if it contains shell special characters.  (The word put, the
                switch -p, and the switch -w are all synonymous).

     get (-g, -r)
                Read the foreign host's file (foreignname) into the local
                file, localname.  If localname already exists, tftp will fail
                with an appropriate error message.

     get! (-g!) Perform a tftp get, overwriting the local file (if it exists).
                Note that the exclamation point following the command
                indicates that the command will modify a data structure (in
                this case, it will overwrite an existing file; the syntax is
                derived from the Yale/T and MIT/Scheme naming conventions).
                Within a UNIX shell, the exclamation point must be escaped
                (usually with a backslash) to avoid shell interpretation.

TRANSFER MODES
     Mode may be netascii, or image. netascii, the default mode, transfers the
     file as standard ascii characters.  Image mode transfers the file in
     binary, with no character conversion.

NOTES
     The Domain/OS BSD versions of tftp and tftpd(8C) are adaptations of the
     MIT Project Athena implementations of the tftp protocol. Domain/OS BSD
     tftp will interface with any RFC783 compliant implementation.  Note,
     however, that the 4.3BSD distribution version of tftp does not meet these
     restrictions.

WARNINGS
     tftp and tftpd(8C) comprise an implementation of the Trivial File
     Transfer Protocol described in RFC783.  They allow you to quickly copy
     files among hosts on an internet without regard to ownership or access
     restrictions.  Therefore, the desired security of a system should be
     considered before allowing tftp transactions.  In an inspired attempt to
     prevent accidental destruction of important files, tftp requires that
     remote file names be absolute pathnames (that is, beginning with /)
     containing the string "/tftp/", but not containing the string "/../".

EXAMPLES
     Each of the following examples presumes that there is a host on the
     internet called carrara, running a tftp server.

     1.   tftp -p /tftp/foo carrara /tftp/bar

     Copies the local file /tftp/foo to carrara, and deposits it in carrara's
     /tftp directory under the name bar.

     2.   tftp get /tftp/new carrara /tftp/bar

     Copies the remote file (on carrara) named /tftp/bar to the local file
     named /tftp/new.

     3.   tftp -g\! /tftp/new carrara /tftp/zed image

     Copies  the remote binary file (on carrara) named /tftp/zed to the local
     file named /tftp/new, overwriting the old copy of /tftp/new.

SEE ALSO
     tftpd(8C)
     Configuring and Managing TCP/IP.