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


RELATED TOPICS

  More information is available.  Type:

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