_icmd.txt

一个通讯程序源码

.*s 1 "Interactive Mode Commands"

The following is a partial list of commands available in the
interactive (non-procedure) mode.  It is not necessary to enter
the entire command in most cases.  The portion of each command
which must be entered is capitalized in the following section
headers.

Refer to the sections titled Interactive Command History
and Line Editing for more information.

.*s 2 "AUTORZ : Automatic ZMODEM Receive"
Usage: autorz [off | on | ]

ECU in the interactive mode (no procedure executing) can interpret a
SUB, 'B', '0', '0' receive data sequence as a ZMODEM ZRQINIT frame and
automatically begin a ZMODEM receive operation.  This command controls
or displays this feature.  By default, this feature is turned on.

.*s 2 "AX : ascii char to hex/oct/dec"
.DS L
usage: ax [<param>]
.DE

<param> may be a single ASCII character, a standard ASCII
identifier (such as ETX), or a two-character control
character identifier (such as ^C, typed as a caret followed
by a C).

If no argument is supplied, a table of control characters
is printed containing decimal, octal, hex, ASCII identifiers
and two-character control character identifier.


.*s 2 "BAud : set/display line baud rate"
.DS L
usage: baud [<baud-rate>]
.DE

<baud-rate>, if specified, must be taken from the values
110, 300, 600, 1200, 2400, 4800, 9600, 19200 and 38400.  On
some systems, 19200 and 38400 may not be supported.  If a baud
rate less than 300 is selected, 2 stop bits are automatically
specified; other baud rates set 1 stop bit.  If <baud-rate>
is not supplied, the current baud rate is displayed.

The setting may be automatically changed as the result of a 'dial'
command.  See also the
.B dial
and
.B parity
command descriptions.


.*s 2 "BN : all console event alarm"
.DS L
Usage: bn [ off | on | alert ]
       bn [ 0 | 1 | 2 ]
.DE

"bell notify": If no parameter is supplied, the current setting is
displayed.  Specifying 0 or off disables the facility; 1 or on causes
an audible alarm to be sounded upon receipt of a bell (0x07)
character from the remote system; 2 or alert causes an audible alarm
upon receipt of ANY characters.  This command may not be functional
in the version for your system.

On SCO, different alarm styles are sent depending upon the type of
event causing the alarms.  The alarms consist of Morse characters.
Even if you do not understand Morse, the patterns of the alarm
tones are distinct enough to be distinguishable.

Additionally on SCO, if you are running ECU from a multiscreen,
the alarms will be signalled even if you have temporarily
switched to another screen.

BN is set to 1 (on) when ECU begins executing.

.*s 2 "BReak : send break to remote"
.DS L
usage: break
.DE

This command sends a break signal to the remote system.


.*s 2 "CD : change current directory"
.DS L
usage: cd [<dir-path>]
.DE

This command allows you to change the working directory of
the ECU process.  If <dir-path> is supplied, the previous
working directory is displayed, and <dir-path> is made the
new working directory.  A history of previous directory
changes is maintained.  Entering the
.B cd
command shows the numbered history list and allows you to select a new
directory by entering the number.  Other commands allow
deletion of directories from the list or saving the list to
file ~/.ecu/dir.  This file is automatically read at ECU
startup, providing a convenient list of directories
available for quick selection.  If you edit this file by hand,
you may force ECU to re-read the file using the %read option.

The %xmitcd option transmits "cd "+current_directory+CR to the remote,
a convenience to set the remote current directory to the
same as your local one.

The %pushd # option pushes the current directory onto the same stack
used by the
.B pushd
interactive command and changes the current directory to the numbered
directory specified by #.  Use the
.B popd
interactive command to return to the previous directory.

Other %options have usage information by entering them with no arguments.

.*s 2 "CONXon : console xon/xoff flow control"
.DS L
usage: conxon [<arg>]
where <arg> is on    honor ^S/^Q local flow control (DEFAULT)
               off   pass ^S/^Q to remote
.DE

This command enables or disables console xon/xoff flow control.
If the argument is omitted, the current flow control state is displayed.

If on, typing ^S/^Q stops or restarts the local console driver
output.  If off, ^S and ^Q are passed to the remote (for EMACS,
of course -- who else?).

.*s 2 "DA : decimal to ascii char"
.DS L
usage: da [<decimal-val>]
.DE

<decimal-val> is a decimal value between 0 and 256; the
parity (sign) bit is stripped and the equivalent ASCII
character value is displayed.

If no argument is supplied, a table of control characters
is printed containing decimal, octal, hex, ASCII identifiers
and two-character control character identifier.

.*s 2 "DCDwatch"
.DS L
usage: dcdwatch [<dcdwatch-param>]
.DE

This command controls the DCD watcher.  The optional parameter may be:
.DS L
   y  yes - enable DCD watcher
   n  no - disable DCD watcher
   t  terminate - terminate ECU on loss of DCD
.DE
Entering the command without an argument shows the current status.

The DCD watcher when enabled causes ECU to monitor the DCD line
(within the limits imposed by the OS with its CLOCAL=0 functionality).
When the watcher is on and DCD drops, ecu automatically performs
the action of the interactive or procedure
.B hangup
command.  If the 't'erminate option is chosen, then after
hangup processing is complete, the ECU program will terminate.  

The state of the watcher may be changed by the use of the dial
command which uses a directory entry that changes the
DCD watcher status.

The DCD watcher depends upon the tty driver to return zero
on a read when DCD is low when the termio flag CLOCAL is reset.
The tty driver must ignore DCD if CLOCAL is set.
If your system offers a "modem" and "direct" choice (by choice
of filename), you probably need to use the "modem" choice for
this to work properly.  However, the choice depends upon
the needs of the underlying driver you are using.
For instance, if you are using FAS in a shared modem application,
your getty should use the "modem" choice and ECU should
use the "direct" choice.  Some experimentation may be required.

.*s 2 "Dial : dial remote destination"
.DS L
usage: dial [<dial-param>]
.DE

<dial-param> may take one of two forms, a telephone number
to dial (initial digit) or a logical name (initial letter)
which can be found in the user
phone directory (in file ~/.ecu/phone).

If a telephone number is supplied, the phone number is
dialed; you must first have set the desired baud rate and
parity using the
.B baud
and
.B parity
commands.
(If the last character of a telephone number is a dollar sign,
it is removed and is replaced with the contents of the first line
in ~/.ecu/credit.  See the description of the dialing directory.)

If a logical name is entered, the phone directory is searched; if
the entry is found, the baud rate and parity is automatically
set.  if a procedure file can be found in the current directory,
the user's home .ecu subdirectory or the ECU library directory "ep"
(normally /usr/local/lib/ecu/ep) whose name matches the logical
name, then the procedure is executed with the argument '!INTERACTIVE'.

If <dial-param> is not supplied, then a screen-oriented
self-documenting <:-)> directory manager is executed; you may
scan the directory to select a number to dial, as well
as add, remove and edit entries.
.*s 3 "Alternate Dialing Directory"

The default dialing directory is ~/.ecu/phone.  You may change to
another directory by issuing the interactive 
.B dial
command with no arguments to enter the dialing directory
menu, selecting 'c'hange dial directory, and entering the name
of a new directory.  The specified pathname must either be
a fully qualified pathname or a pathname relative to the
current working directory.  Once an alternate directory
has been selected, it will be used by
both the interactive command 'dial <logical>' and 
the dialing directory menu.

Using the dial command with a directory entry may change the 
DCD watcher (dcdwatch) status.
See the section on the
.B dcdwatch
command for more information.

See the section below titled "Choosing a Dialout Line" for
more information on using "Any" in the "tty"
field of a directory entry.

.*s 3 "Multi-Number Redial Cycle"

While in the  dialing directory, you may "mark" one or more
entries for a cyclical redial attempt.  When any entry is
marked, typing ENTER (carriage return or line feed/newline)
causes each marked entry to be dialed in turn until one of
the remote systems is successfully connected.  When a
successful connection occurs, ECU unmarks the 
associated entry, leaving the others marked.  Thus, you
may mark several entries and merely reenter the dialing
directory after each connection is finished and press
ENTER to reenter the redial cycle.  If a single entry
is marked, ECU pauses 15 seconds between each dialing attempt,
otherwise 5 seconds.  Pressing 'c' will cause the pause to
be prematurely terminated and the next attempt to be made.
Pressing your interrupt key (DEL, ^C or whatever) aborts
the cycle.  If you interrupt an active dialing attempt, you 
will be prompted as to whether or not you wish to cycle to the next
entry or abort the cycle.

If no entries are marked for redial, the current, highlighted
directory entry is used for dialing.

To unmark a single entry, press 'M' (uppercase M).
To unmark all entries, press 'U'.

.*s 3 "Automatic Dialing/Login Procedure"

Upon dialing from the menu, if a procedure file can be found in
the current directory, the user's home .ecu subdirectory or the
ECU library subdirectory "ep" (normally /usr/local/lib/ecu/ep) whose name
matches the logical name, then the procedure is executed with the
argument '!MENU'.  It is the responsibility of the automatically
executed procedure to establish connection with the remote system
(by using the procedure
.B dial
command).  An example of an automatic login procedure
can be found in the distribution subdirectory 'models'
named 'sysname.ep'.  A companion procedure is 'unixlogin.ep'.

For example,
.DS L
.--[ dialing directory ]-- /u1/wht/.ecu/phone -- ...
| entry name | telephone number | tty | baud P | ...
| sysname    | 555-1234         | Any | 2400 N | ...
.DE
.DS L
#-----------------------------------------------------------
# sysname.ep - procedure to call UNIX-like system 'sysname'
#
# CONFIDENTIAL - This function should be chmod 0600 because
# it contains a password which you probably don't want to be
# common knowledge.
#
# This procedure calls 'unixlogin.ep' to do the hard work.
#-----------------------------------------------------------

    mkvar $s_pwd(20)    # local variable preserves password
    $s_pwd = 'password' # security by disappearing when the
                        # procedure terminates

#   also, by keeping the password text off the following line,
#   the password will not be displayed if you abort (interrupt)
#   the procedure

    do 'unixlogin' %argv(0) 'username' $s_pwd 'ansi-or-whatever'
.DE

.*s 2 "DO : perform procedure"
.DS L
usage: do <procname> [<arg> ... ]
.DE

Perform ECU procedure.  Ecu searches for <procname>.ep in
the current directory.  If the file is not found, the program
looks for the file in the ~/.ecu directory and in the ep subdirectory
of the library directory (usually /usr/local/lib/ecu/ep).  One or more
arguments may be passed to the procedure.  Arguments
are made available in the called procedure by use of the
.B %argc
integer function and
.B %argv
string function.

Unlike arguments to the
.B do
procedure command, 
arguments to the
.B do
interactive command are not quoted and may not contain
embedded spaces or tabs.


.*s 2 "DUplex : set/display duplex"
.DS L
usage: duplex [ Full | Half ]
.DE

This command specifies whether or not ECU is to locally echo
characters typed by you at the keyboard.  The overwhelming
majority of remote systems provide the echo function, in
which case full duplex must be used.  For the rare occasions
when the remote system does not echo your keyboard input,
setting half duplex will allow you to see what you are
typing.

When communicating with another terminal in a "teletype
conversation", setting half duplex is generally required.
In such cases, use of the 
.B nl ,
.B nlin
.R
and
.B nlout
commands may also be required.

The default setting for duplex is full.


.*s 2 "EXit : drop carrier, exit program"
.DS L
usage: exit
.DE

This command terminates ECU promptly.  If your modem does
not drop carrier upon loss of Data Terminal Ready (DTR),
the command will terminate ECU,
but may leave the communications line off hook.
It is strongly recommended that you configure your
modem to hang up the phone line when DTR drops.  A shorthand
version of this command exists: '.' is equivalent to 
.B exit .


.*s 2 "FI : send text file to line"
.DS L
usage: fi [<filename>]  [ | f | e | s]
                        f full speed transmission
                        e echo pacing
                        s single line transmission

.DE

"file insert": This command causes file characters to be inserted
into the transmit data stream as though they had been entered at the
keyboard.  No error correction is provided, although XON/XOFF flow
control is obeyed.

If <filename> is not entered on the command line, a prompt for the
filename is made.  Once the filename has been entered and file has
been opened, you are asked whether the file should be transmitted at
full speed, by "echo pacing" or by a single line at a time.  You may
also append an 'f', 'e' or 's' argument to the command line.

If your remote can tolerate it, full speed transmission is the
fastest.  Some systems are not capable of receiving large amount of
data ("streaming data") without pauses.  Even with "full" speed
transmission, some "pacing" (inter-character delay) is introduced to
ease loading on the remote system.  Pressing the interrupt key (DEL)
stops a full speed transmission.

By specifying echo pacing, it is possible to increase the likelihood