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.