2.0; siorf (sio_receive_file), revision 2.0, 83/04/29
SIORF (SIO_RECEIVE_FILE) -- Receive a file from a remote host.
usage:  SIORF [ [-L {1|2|3}] [-N] [-F] [-AE] [-R] [-OBJ] [-X host_name]
              [pathname | * ] ]...


FORMAT

  SIORF [options] [pathname ...] [*]


  SIORF accepts remote host transmissions from the appropriate SIO line,
  decodes them according to the proper protocol, and writes them to the
  file you specify.

  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 SIORF are described in the SIOTF
  (SIO_TRANSMIT_FILE) command description in the "DOMAIN System Command
  Reference Manual."


ARGUMENTS

  pathname
  (optional)       Specify name of file to receive the transmission.
                   If you omit the filename, SIORF waits for the host
                   to specify a receive file.  (If you want the
                   transmission written to standard output, use the
                   "*" option.)  SIORF terminates when it receives an
                   end-of-transmission (EOT) signal, unless you include
                   the -F option.
                   Default if omitted: see above


OPTIONS

  -L n             Specify SIO line being used for the transmission.
                   The default SIO line is 1.

  -N               Select the Nibble protocol.

  -F               Cause SIORF to monitor the SIO line for host
                   transmissions until it receives an error message
                   over the SIO line or CTRL-Q from the node. When
                   you include this option, EOT does not cause SIORF
                   to terminate.

  -OBJ             Write transmissions to 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  -noquit  -sync  -noinsync
                   to receive an object file, presumably from another node.

  -R               Replace file(s) if they already exist.

  -AE              Abort on error.  Otherwise, transmission continues
                   until EOT.

  -X host_file     Request a remote host file to be transmitted.  This
                   presumes a host counterpart of SIOTF (SIO_TRANSMIT_FILE)
                   is active.

  *                Receive transmission to standard output.  This option
                   is valid only if the 'pathname' argument is omitted.


EXAMPLES

  1. $ tctl -line 2 -noquit -sync -noinsync   Create (or replace) a binary
     $ siorf -L 2 -r -obj prog.bin             file PROG.BIN with the data
                                               received over SIO line 2;
                                               presumably being sent by an
                                               SIOTF counterpart.

  2. $ siorf -r -f                            Receive files over SIO line 1
                                               whose names are specified by
                                               the transmission side (host
                                               or DOMAIN node). Existing
                                               files are replaced if necessary.
                                               SIORF remains active "forever"
                                               until CTRL/Q or error occurs.

  3. $ siorf -x ask_file /eng/new_copy        Request file ASK_FILE to be
                                               sent over SIO line 1 and write
                                               data received to /ENG/NEW_COPY.
                                               Presumes the other side is
                                               running SIOTF or equivalent.                                                SIORF remains active "forever"
                                               SIORF remains active "forever"
                                               until CTRL/Q or error occurs.

RELATED TOPICS

  More information is available.  Type:

    - HELP SIOTF
      for details about transmitting a file to a remote host.