2.0;siotf (sio_transmit_file), revision 2.0, 86/11/06
SIOTF (SIO_TRANSMIT_FILE) -- Transmit a file to a remote host.
usage:  SIOTF [[-L {1|2|3}] [-N] [-F] [-AE] [-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.

  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 SIOTF are described in  the  SIOTF  command
  description in the "DOMAIN System Command Reference."


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

  -F                  Cause  SIOTF  to  continue  monitoring  the  SIO  line for
                     transmission requests from  the  remote  host  rather  than
                     terminating when transmission is complete.

  -OBJ                OBSOLETE  OPTION.  At  SR9.5,  SIOTF automatically detects
                     binary  objects  and   transmits   them   properly.   Prior
                     configuration  of the SIO line (via the TCTL command) is no
                     longer necessary.

  -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. $ siotf -L 2 prog1.bin prog2.bin        Transmit file PROG1.BIN, then
                                              transmit file PROG2.BIN over
                                              SIO line 2.

  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.