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

  -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 (presumably to another node.)
                     The SIO line used  for  the  transmission  must  have  been
                     previously  configured  (using  the  TCTL  command)  in the
                     following manner:

                                          $ tctl  -nosync  -insync

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