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.  (See "Protocols" following the
                     SIOTF  (SIO_TRANSMIT_FILE)  command  description   in   the
                     "DOMAIN System Command Reference Manual.")

  -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 needed.
                                              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
                                              in "forever" mode.


RELATED TOPICS

  More information is available.  Type:

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