2.0; siotf (sio_transmit_file), revision 2.0, 83/04/29.
SIOTF (SIO_TRANSMIT_FILE) -- Transmit a file to a remote host.
usage:  SIOTF [[-L {1|2|3}] [-N] [-F] [-AE] [-OBJ] [-X host_name] [file|*]]...


FORMAT

  SIOTF [options] [pathname ...] [*]


  SIOTF sends the DOMAIN file(s) you specify to a remote computer ("host")
  using the appropriate SIO line and protocol.

  Arguments and options may appear in any order and are processed and take
  effect as encountered.  This means options must be specified BEFORE the
  file(s) for which they are intended.

  The transmission protocols used by SIOTF are described in the SIOTF
  command description in the "DOMAIN System Command Reference Manual."


ARGUMENTS

  pathname
  (optional)       Specify name of file to be transmitted.  If you wish to
                   transmit data from standard input, use the "*" option.
                   Default if omitted: must use "*"


OPTIONS

  -L n             Specify SIO line to be used for transmission.
                   The default SIO line is 1.

  -N               Select the Nibble protocol.

  -F               Cause SIOTF to continue monitoring the SIO line
                   for transmission requests from the remote host
                   rather than terminating when transmission is complete.

  -OBJ             Transmit a DOMAIN object file.  The SIO line used
                   for the transmission must have been previously
                   configured (using the TCTL command) in the following
                   manner:
                           $ tctl  -nosync  -insync
                   to transmit an object file, presumably to another node.

  -AE              Abort on error rather than attempting to continue.

  -X host_file     Pass a filename to the remote host.  The host can use
                   this name for the next file it receives from the node.
                   This presumes a host counterpart to SIORF
                   (SIO_RECEIVE_FILE) is active.

  *                Read from standard input and send standard input to
                   the remote host. Signal end of data with an end-of-file
                   (CTRL/Z).


EXAMPLES

  1. $ siotf -f            Wait for file requests over SIO line 1 and
                           transmit them.

  2. $ tctl -line 2 -nosync -insync          Transmit file PROG1.BIN, then
     $ siotf -L 2 -obj prog1.bin prog2.bin    transmit file PROG2.BIN over
                                              SIO line 2.  Presumably the
                                              receiving side is using SIORF
                                              with -OBJ also, and has SIO
                                              line 2 configured properly.

  3. $ siotf -x tell_file /eng/notes         Send the name 'tell_file', then
                                              transmit the file /ENG/NOTES.
                                              Presumably the receiving side
                                              is in "forever" mode (-F) and
                                              thus waiting for instructions.


RELATED TOPICS

  More information is available.  Type:

    - HELP SIORF
      for details about receiving a file from a remote host.