put(1C)                                                   put(1C)



     NAME
          put - puts a file onto a remote machine

     SYNOPSIS
          put [-p port] [-sSPEED] [-i[ID]] fromfile[tofile]
          put [-p port] [-sSPEED] -ccommand [args] ...

     DESCRIPTION
          put is part of system of programs useful for transferring
          files between UNIX® systems connected by serial lines.  It
          is the uploader, designed to transmit files from a local
          machine to a remote machine.  For a brief discussion of the
          take/put system and installation instructions, see the Oreo
          Network System Administration Manual.

          The default port is /dev/tty0; the -p flag option may be
          used to specify an alternate output port.  The default speed
          is determined by the system; the -s flag option may be used
          to specify a speed.  If tofile is unspecified, then it is
          assumed to be the same as fromfile.  If fromfile is a
          directory, tofile must be a directory on the remote machine
          (or if nonexistent, the last existent directory specified in
          the pathname must be writable).

          The -i[ID] flag option specifies a system ID and is the
          mechanism for remapping pathnames on the remote machine.
          The system ID is passed to the remote machine, where it is
          used to generate pathname prefixes (using the /etc/takeoem
          file) which are appended to the tofile pathname supplied by
          put.  If an ID is specified when using the -i flag option,
          it is used on the remote machine. If no ID is specified, the
          default ID is read from the /etc/sysid file, if it exists;
          if the /etc/sysid does not exist, the system ID is
          considered to be the user name of the invoker of put7 (i.e.,
          the user who logged in over the port used).

          The -c flag option is useful for executing an arbitrary
          command on the remote machine.  All arguments following the
          -c flag are collected, transmitted to the remote machine and
          executed as a single command.  The standard input to the put
          program is sent to the remote machine to become the standard
          input to the command specified.  The standard error of the
          remote command becomes the standard error of put.  The
          standard output of the remote command is not returned.  The
          exit status of the remote command is returned as the exit
          status of put.

          In order to perform its function, put(1C) interfaces with
          the program /usr/bin/put7 on the remote machine.

     EXAMPLE
               put /a/b/c



     Page 1                                        (last mod. 1/16/87)

     put(1C)                                                   put(1C)



          puts the contents of the directory (or file) /a/b/c on the
          local machine into a similarly named directory (or file) on
          the remote machine; if /a/b/c did not previously exist on
          the remote machine, it is created; otherwise, it is
          overwritten.

               put file.c /x/y/z

          puts the contents of file.c on the local machine into
          /x/y/z/file.c on the remote machine.  Note that file.c is
          created on the remote machine if z is a directory; if z is a
          file rather than a directory, its contents are overwritten,
          but its name remains z, rather than becoming file.c.

     FILES
          /usr/bin/put

          fromfile    The local filename.  When using the -i flag
                      option, this file should be specified as a
                      pathname starting at the root of the local
                      machine.

          tofile      The remote file name; if tofile is null, tofile
                      is defaulted to fromfile.

     SEE ALSO
          cu(1C), take(1C).
          Oreo Network System Administration Manual.



























     Page 2                                        (last mod. 1/16/87)