2.0;siorf (sio_receive_file), revision 2.0, 86/11/06
SIORF (SIO_RECEIVE_FILE) -- Receive a file from a remote host.
usage:  SIORF [ [-L {1|2|3}] [-N] [-F] [-AE] [-R] [-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.

  You  do not need to use the TCTL command to set the sync and insync parameters
  of the SIO line when receiving a non-ASCII file. SIOTF and SIORF recognize the
  types of the files being transferred and set these parameters correctly.

  The   transmission  protocols  used  by  SIORF  are  described  in  the  SIOTF
  (SIO_TRANSMIT_FILE)  command  description  in  the  "DOMAIN   System   Command
  Reference."


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.")

  -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               OBSOLETE OPTION.  At  SR9.5,  SIORF  automatically  detects
                     binary   objects   and   receives   them   properly.  Prior
                     configuration of the SIO line (via the TCTL command) is  no
                     longer necessary.

  -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. $ siorf -L 2 -r prog.bin                Create (or replace) a binary
                                              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.