10.0;siorf (sio_receive_file), revision 1.0, 88/01/21
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 | * ] ]...
DESCRIPTION
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.
ARGUMENTS
pathname (optional)
Specify the name of the 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.
-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.
-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
Create (or replace) a binary file prog.bin with the data received over
SIO line 2; presumably being sent by an siotf counterpart.
$ siorf -l 2 -r prog.bin
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 until CTRL/Q or error occurs.
$ siorf -r -f
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.
$ siorf -x ask_file /eng/new_copy
SEE ALSO
More information is available. Type
help siotf For details about transmitting a file to a remote host