_p_cmd.txt

一个通讯程序源码

is omitted, the received files are stored as received; otherwise
carriage return/linefeed pairs are converted to newlines.

.*s 2 "rlog"

.DS L
usage: rlog [-srf] <str>
       rlog 'off'
.DE

This command controls receiver logging.  It's function is the same as
the interactive
.B log
command.

The first form of the command enables logging. The
.B -s switch causes the file to be
.B s cratched
when it is opened (otherwise the file is opened for append).  The
.B -r
switch causes raw logging, else filter logging is performed.  The
.B -f
switch causes the log file to be flushed  each time it is written to
(unbuffered I/O); this switch is useful if you are logging to
a terminal or hard copy device and wish to see output as soon as it
is produced.

.*s 2 "rname"

usage: rname <str>

Normally, the %rname string function returns the same string
as the logical dialing directory entry.  This command allows
the default value to be overridden with a user-selected
value (63-character maximum).

This feature is useful in situations where one system is initially
dialed, but a connection is made to yet another system from the dialed
system via networking.

.*s 2 "rs"

usage: rs

This command invokes the SEAlink file receive protocol.
There
is no provision in the SEAlink protocol to convert
carriage return/linefeed pairs to newlines,
so the received files are stored as received.
The remote sender must have been started prior to the
execution of this command.

.*s 2 "rtscts"
.DS L
usage: rtscts [ off | on | no | yes | 0..7 ]
.DE

This command controls the RTS/CTS flow control feature of
the line driver (which may or may not work).
This is a very confusing area though it should not be.

If no argument is supplied, the current setting is
displayed.  Specifying 0 or n disables the facility;
1 or y causes RTS/CTS flow control to be enabled.

What the command does is to manipulate the RTSFLOW and CTSFLOW
bits of the termio c_cflag word (see 
.B termio(S) ).

SCO's sio driver before UNIX 3.2v4/ODT 2.0
does half duplex flow control.
FAS does hardware flow control based on the device magic
number, but if you use a device number specifying no hardware flow
control, RTSFLOW and CTSFLOW can be used to specify SCO-style flow
control.
CRTSFL offers full duplex line control
on 3.2v4 and later ONLY for SCO's sio driver.

.DS I
 arg | RTSFLOW | CTSFLOW    arg | RTSFLOW | CTSFLOW | CRTSFL
-----+---------+---------  -----+---------+---------+--------
 off |   0     |   0         0  |   0     |   0     |
 on  |   0     |   1         1  |   0     |   1     |
 no  |   0     |   0         2  |   1     |   0     |
 yes |   0     |   1         3  |   1     |   1     |
                             4  |   0     |   0     |   1
.DE
Choice 4 only works on SCO 3.2v4 and ODT 2.0.
As you can see, numeric values are masks.
If the 4 bit is present in the numeric value, it
overrides the lower-order bits:  Specifying 7 as an argument
specifies CRTSFL is to be used if it is supported, otherwise
RTSFLOW and CTSFLOW.

Under System V Release 4, an TCGETX/TCSETX manipulation
is performed, modifying the x_hflag bits as follows:
.DS I
argument | RTSXOFF | CTSXON    argument | RTSXOFF | CTSXON 
---------+---------+---------  ---------+---------+---------
  off    |   0     |   0         0      |   0     |   0
  on     |   0     |   1         1      |   0     |   1
  no     |   0     |   0         2      |   1     |   0
  yes    |   0     |   1         3      |   1     |   1
.DE
Under SunOS 4.1, only CTS support is provided.  You should read
the termio and zs man pages.  Arguments result in the stated
manipulations of the termio element c_cflag:
.DS I
argument | CRTSCTS    argument | CRTSCTS
---------+---------  ----------+---------
  off    |   0           0     |   0
  on     |   1           1     |   1
  no     |   0     
  yes    |   1    
.DE

.DS L
Examples:

	ifi %baud >= 9600
        rtscts 7 | use CRTSFL if available, otherwise whatever
.DE

.*s 2 "rx"

usage: rx [-a] <str>

This command invokes the XMODEM file receive protocol
to receive file <str>.  If switch '-a'
is omitted, the received file is stored as received; otherwise
carriage return/linefeed pairs are converted to newlines.
The remote sender must have been started prior to the
execution of this command.

.*s 2 "ry"

usage: ry

This command invokes the YMODEM Batch (not to be confused with
XMODEM-1K) protocol to receive files from a remote system.  The remote
sender must have been started prior to the execution of this command.

.*s 2 "rz"

usage: rz

This command receives files with ZMODEM/CRC-32.
The remote sender must have been started prior to the
execution of this command.  
Automatic ZMODEM frame detection is NOT supported during
procedure execution.

.*s 2 "scrdump"

usage: scrdump [<str>]

This command causes the current screen contents to be
stored in a file.  If <str> is supplied, it is used as a pathname.
If <str> is not supplied, "~/.ecu/screen.dump".
The actions of the interactive
.B sdname
command have no effect on the execution of this command.

See the section titled "Screen Dump" for more information.
The subsection titled "Multiscreen and Non-Multiscreen" will be
of particular interest when using screen dumps in an
automated environment.

.*s 2 "send"

usage: send [-n] <str>

This command sends <str> to the communications line.  If the '-n'
switch is omitted, a carriage return (0x0D) is transmitted after <str>.
If '-n' is supplied, no carriage return is transmitted.

.DS L
Examples:

    send 'ps -au'
    send -n %chr(0x02)+'START'+%chr(0x03)
.DE

.*s 2 "set"

.DS L
usage: set [$]i<name>=<int-expression>[, ...]
       set [$]s<name>=<str-expression>[, ...]
.DE

This command sets an integer or string variable
to an expression.  The 'set' verb may be omitted provided the
otherwise optional '$' is supplied.  There are many examples of
how the set statement is performed throughout this document.
The examples here are to further clarify the statement's syntax.

If the '=<expression>' is omitted, the value of the variable is
displayed (useful when debugging).   If procedure tracing is
enabled with the
.B ptrace
command, all variables referenced by the
.B
set
command, whether a value is assigned or not, are displayed.

.DS L
Examples:

    set i0=0
    set $s0='brown',s1='The quick '+$s0+' fox'
    set $S0              with no '=', displays contents
    set i0,$i1,s0='abc',s1
    $s0 = 'abc'          legal
    set s0='abc'         legal
    s0 = 'abc'           illegal
.DE
.*s 2 "setline"

.DS L
usage: setline <filename>
.DE
This command is an exact analog of the -l command line switch.
<filename> is used on the setup screen (if it is presented)
as the default filename. If you do not edit this name, ECU will
attempt to open the line when you press End or ^D. 
<filename> has the format of a complete pathanme in /dev or simple
tty name. 

.B setline
may only be used in _rc.ep.  Using the
.B setline
command with the
.B baud
command gives you programatic control over the actual
choice of the line and rate or the defaults for the setup screen,
depending upon other options.

NOTE: using the setline command will override any command line -l
specification.

NOTE: For important considerations on line choice, see the
ECU manual sections titled "Choosing a Dialout Line" and "DCDwatch".

.DS L
Example:
  setline '/dev/tty1a'
  setline 'tty1a'
  setline 'cua0'
.DE
.*s 2 "sk"

usage: sk [-a] <str>

This command invokes C-Kermit to
send
files. ECU searches the PATH list for 'kermit' or 'ckermit',
expecting to find Columbia University C-Kermit version 5A(173)
or later.  The file ~/.kermrc must be set up to have any desired
initialization parameters you desire (refer to C-Kermit
documentation for more information).
The remote protocol must have been started prior to the
execution of this command.

WARNING: until further notice, avoid suspending Kermit
with ^\Z.  ECU is totally unprepared to act as a job control
process group leader.

If switch '-a' is supplied,
newlines are converted to carriage return/linefeed pairs.
If '-a' is omitted, the file(s) are transmitted without modification.

Integer variable $i0 receives the exit status from the transfer.  If 0,
transfer was normal.
Note:
procedure execution IS terminated by a SIGINT to the spawned file
transfer process.  This is different than for versions prior to 3.10.
If $i0 is set to -1, the file transfer program did not begin.

.*s 2 "ss"

usage: ss <str>

This command invokes the SEAlink file transfer protocol to send
one or more files.
There is no provision in the SEAlink protocol to convert
newlines to carriage return/linefeed pairs.
so the received files are stored as received.

Integer variable $i0 receives the exit status from the transfer. If 0,
transfer was normal.
Note:
procedure execution IS terminated by a SIGINT to the spawned file
transfer process.  This is different than for versions prior to 3.10.
If $i0 is set to -1, the file transfer program did not begin.

.*s 2 "sx"

usage: sx [-ak[l]] [<label-str>] <filename-str>

This command invokes the XMODEM or XMODEM-1K file transfer protocol
to send a file.  If '-k' is supplied, XMODEM-1K is used, else XMODEM.
If switch '-a' is supplied,
newlines are converted to carriage return/linefeed pairs.
If '-a' is omitted, the file(s) are transmitted without modification.
If '-l' is supplied, then <label-str> specifies a string to
display on the bottom of the file transfer screen.  If '-l' is
omitted, then <label_str> must also be omitted.

Integer variable $i0 receives the exit status from the transfer. If 0,
transfer was normal.
Note:
procedure execution IS terminated by a SIGINT to the spawned file
transfer process.  This is different than for versions prior to 3.10.
If $i0 is set to -1, the file transfer program did not begin.

.DS L
Examples:

    sx -al 'sending log file' '/tmp/log.file'
    sx -
.DE

.*s 2 "sy"

usage: sy [-a[l]] [<label-str>] <filelist-str>

This command invokes the YMODEM Batch (not 
to be confused with XMODEM-1K) file transfer protocol
to send one or more files. 

If switch '-a' is supplied,
newlines are converted to carriage return/linefeed pairs.
If '-a' is omitted, the file(s) are transmitted without modification.
If '-l' is supplied, then <label-str> specifies a string to
display on the bottom of the file transfer screen.  If '-l' is
omitted, then <label_str> must also be omitted.

Integer variable $i0 receives the exit status from the transfer. If 0,
transfer was normal.
Note:
procedure execution IS terminated by a SIGINT to the spawned file
transfer process.  This is different than for versions prior to 3.10.
If $i0 is set to -1, the file transfer program did not begin.

.*s 2 "system"

usage: system [-ls] <cmdstr>

<cmdstr> is passed to the Bourne shell.

If switch '-l', is supplied, the attached communications line 
becomes the stdin and stdout for the command.

If switch '-s', is supplied, all ECU file descriptors remain
open.  The -s option is important to include if you pass the
ECU line file descriptor to another process.

Integer variable $i0 is set to
the spawned process' exit status if the process exits "normally",
or 0x100 if the process is killed, dumps core or interrupted.

Note:  procedure execution is NOT terminated by a SIGINT to
the spawned process.  It is the responsibility of the procedure
to process the exit status returned in $i0.
If $i0 is set to -1, the file transfer program did not begin.

.DS L
Examples:

	$s2 = '/tmp/ecu'+%itos(%pid,05)
    system ' fgrep foo bar > '+$s2

    system -s '/etc/NBSsetclk -i '+%itos(%conn)
.DE

.*s 2 "sz"

usage: sz [-anf[l]r] [<label-str>] <filelist-str>

This command sends files using ZMODEM/CRC-32.
The remote protocol must have been started prior to the
execution of this command unless the remote has automatic
ZMODEM frame detection.

Switch '-a' specifies an ASCII transfer; the default is binary.

Switch '-f'  causes the full pathname of each file to be sent;
otherwise, the simple filename is transmitted.

Switch '-l' with the <label-str> argument specifies a string to
display on the bottom of the file transfer screen.  If '-l' is
omitted, then <label_str> must also be omitted.

Switch '-n' causes the receiver to accept files with do not
already exist at the remote system or which have older
times of  last access that at the sending system.
Not all remote protocol software will accept or obey this option.

Switch '-r' causes an interrupted file transfer to be resumed.
if the remote receiver supports the ZMODEM protocol feature.

Integer variable $i0 receives the exit status from the transfer. 
If 0, transfer was normal.  Other $i0 values possible:
.DS L
  1-126:   count of files not transmitted (see ~/.ecu/log)
  127:     127 or more files not transmitted (see ~/.ecu/log)
.DE
Other ecusz error codes are shown here for refernce, but
they are converted by ECU to printed messages and result in procedure
termination.
.DS L
  128-192: process terminated with signal==code-128
           signal 0 == program logic error
  253:     could not open any files
  254:     protocol failed (bad line conditions,brain dead remote)
  255:     usage
.DE

Note:
procedure execution IS terminated by a SIGINT to the spawned file
transfer process.  This is different than for versions prior to 3.10.
If $i0 is set to -1, the file transfer program did not begin.

.*s 2 "vidcolor"

usage: vidcolor <type> <fcolor> [<bcolor>]

This command allows control over the internal color choices
ECU makes.  <type> must be one of the following:

.DS I
normal   - normal video color
reverse  - reverse video color
notify   - color used for low key notifications such as
           "[interactive mode]" and "[procedure finished]"
success  - color used for modem CONNECT messages and other
           "success" notifications
alert    - color used to alert user for warning or caution
           purposes
error    - color used to display error status or messages
.DE

<fcolor> and <bcolor> are color names as described in the description of the
.B color
command. <fcolor> choses the foreground color and must be supplied.
<bcolor> choses the background color and is optional; if not supplied,
the background color is black.

Note: The vidcolor normal and reverse options are analogs of the
.B color
and
.B
color -r
.R
command.

.DS L
Examples:  (showing ECU default internal color list)

    vidcolor normal lt_green 
    vidcolor reverse red white
    vidcolor notify gray
    vidcolor success lt_green 
    vidcolor alert yellow 
    vidcolor error red 
.DE

.*s 2 "vidnorm"

usage: vidnorm

This command causes later screen output to appear in the
normal, as opposed to reverse video mode.
The
.B color
command forces normal video mode.

.*s 2 "vidrev"

usage: vidrev

This command causes later screen output to appear in the
reverse, as opposed to normal video mode.
The
.B color
command forces normal video mode.

.*s 2 "whilei"

.DS L
usage: whilei <int> <rel-op> <int> <statement>
       whilei <int> <rel-op> <int>
           <statement>
       whilei <int> <rel-op> <int>
       {
           any kind or number of statements
           (labels are not allowed inside braces)
       }
.DE

This command executes a loop one or more statements
based on a test of two integer quantities.
The <rel-op> argument is descibed in a earlier subsection
titled "Relational Operators."
See the
description of the
.B break ,
.B continue ,
and
.B else
commmands
and many other examples throughout the document,
for examples of how the command is used.
.*s 2 "whiles"

.DS L
usage: whiles <str> <rel-op> <str> <statement>
       whiles <int> <rel-op> <int>
           <statement>
       whiles <int> <rel-op> <int>
       {
           any kind or number of statements
           (labels are not allowed inside braces)
       }
.DE

This command executes a loop of one or more statements
based on a test of two string values.  
The <rel-op> argument is descibed in a earlier subsection
titled "Relational Operators."
See the
description of the
.B break ,
.B continue ,
and
.B else
commmands
and many other examples throughout the document,
for examples of how the command is used.
.*s 2 "xon"

.DS L
usage: xon <arg>
where <arg> is on    input and output flow control
               off   no flow control
               in    input flow control
               out   output flow control
.DE

This command enables or disables xon/xoff flow control.

.DS L
Examples:

    hangup
    dial 'mysys'
    ifi %conn != 0 parity none;xon on
.DE