_icmd.txt

一个通讯程序源码

of proper receipt.  Echo pacing reads the return data stream to
attempt to keep from overloading the remote.  Pressing the interrupt
key (DEL) stops an echo paced transmission.

As a last resort, if echo pacing is not working for you, (i.e., you
are using the command in an environment where the remote does not
echo your characters), single line at a time transmission is
available.  With "single" line transmission, you must press the
space key to initiate sending each line.  Pressing the 'ESC' or 's'
key stops the transfer.

.*s 2 "FKEy : function key definition"
.DS L
usage: fkey [<keyset_name>]
       fkey -r
.DE

This command allows the mapping of function keys F1-F12,
PgUp, PgDn, End and Ins and the cursor up, down, left and
right keys to emit a desired sequence of characters when a
function key is pressed.  <keyset_name> specifies which key
set in ~/.ecu/keys is to be selected. Sample entry:
.DS I
hayes
    F1:escape:+ + +
    F2:autoans:A T S 0 = 1 cr
    F3:dial:A T D T
bbs
    F1:cancel:^K
    F2:yes:y cr
.DE

-r resets the key handler to the same state as when ECU
was started.  See the section above titled "Standard Function Keys".

If a keyset_name matches a logical dial directory name, it
is loaded after a connection is established.

The characters in the mapped string may be any printable character
or one of the following:
.DS I
map -> character       map -> character
---    -----------     ---    ------------
nul    0 000 00 ^@  |  dle    16 020 10 ^P
soh    1 001 01 ^A  |  dc1    17 021 11 ^Q
stx    2 002 02 ^B  |  dc2    18 022 12 ^R
etx    3 003 03 ^C  |  dc3    19 023 13 ^S
eot    4 004 04 ^D  |  dc4    20 024 14 ^T
enq    5 005 05 ^E  |  nak    21 025 15 ^U
ack    6 006 06 ^F  |  syn    22 026 16 ^V
bel    7 007 07 ^G  |  etb    23 027 17 ^W
bs     8 010 08 ^H  |  can    24 030 18 ^X
ht     9 011 09 ^I  |  em     25 031 19 ^Y
nl    10 012 0a ^J  |  sub    26 032 1a ^Z
vt    11 013 0b ^K  |  esc    27 033 1b ^[
ff    12 014 0c ^L  |  fs     28 034 1c ^\e
cr    13 015 0d ^M  |  gs     29 035 1d ^]
so    14 016 0e ^N  |  rs     30 036 1e ^^
si    15 017 0f ^O  |  us     31 037 1f ^_
.DE

.*s 2 "FKMap : funckeymap (function key recognition) management"
.DS L
usage: fkmap 
       fkmap <keyname>
       fkmap <keyname> <keylist>
       fkmap -l <name>
       fkmap -r
       fkmap -s <file>
.DE

This command manages the mechanism ECU uses to recognize function
keys when they are entered at the console.  Entering the command
with no arguments displays the current mapping in funckeymap format.

If supplied, the first argument to the command must be the
recognized name of a function key from the list:
.DS L
 F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12
 Home End PgUp PgDn CUP CUL CU5 CUR CUD
.DE
The case of the entered argument is unimportant.

If only one argument is supplied, the mapping for the specified key
is displayed.  If more than one argument is supplied, the keyboard
mapping is changed.  Arguments 2-n are character code specifiers
in the format used to define a funckeymap entry.

.B WARNING :
If found to be syntactically correct, a mapping change
is installed immediately.  If incorrect mapping of the HOME
key is requested, you may lose control of ECU.

The -l form reads an entire funckeymap definition matching <name>
from ~/.ecu/funckeymap (if not found there, in a file by the same
name in the library directory).  This form behaves exactly
in the same manner as the command line switch -F.
Due to the drastic nature of this command, if it fails to
execute properly, ECU terminates itself.  Note that
improper use of this form of the command can still render
ECU an albatross (with Home unrecognizable).

The -r form rereads the original funckeymap definition (as
at program invocation), reseting the mapping.  The -s switch
saves the current mapping to <file>.

Switches may not be combined.  Only one switch may appear.

.DS L
Examples:

    fkmap f10       display F10 mapping
    fkmap Home ^Z   map Home to ^Z
                    after this command, type ^Z for Home
.DE

.*s 2 "HAngup : hang up modem"
.DS L
usage: hangup
.DE

This causes DTR to be momentarily interrupted,
terminating any outstanding connection.
Your DCE (modem) must be able to drop carrier upon loss of DTR.

.*s 2 "HElp : invoke help"
.DS L
usage: help [<cmd-name>]
.DE

Issuing this command with no argument displays a list of
commands followed by a request for a command for further
information.

.*s 2 "KBDTest : test keyboard mapping"
.DS L
usage: kbdtest
.DE

This command runs a keyboard test which asks you to press function keys
(e.g., F1).  For each key pressed, ECU gives you the actual character
sequence generated by the key.  It also tells you which function key it
recognizes (if any).  mapping of keyboard generated character sequences
to ECU internal key codes.  The command is useful for verifying and
debugging a "funckeymap" entry.  To exit the test at any time, press the
escape key.

.*s 2 "LLp : set session log to /dev/lp"
.DS L
usage: llp
.DE

This command is a
shorthand version of 'log /dev/lp'.  /dev/lp must not be
under the control of a print spooler.


.*s 2 "LOFf : turn off session logging"
.DS L
usage: loff
.DE

This command is shorthand for 'log off'.  If session logging
is active, it is turned off.

.*s 2 "LOG : session logging control"
.DS L
usage: log [-s] [-r] [ | off | filename ]
    -s "scratch" previous file contents; otherwise append
    -r "raw" logging; otherwise non-printable characters
        other than tab and newline are omitted from the log
.DE

This command controls session logging; issuing the command
with no argument causes the status of session logging to be
displayed.  The special argument 'off' causes active logging
to be terminated.  Other argument values cause logging to
start using the argument as a filename.  Issuing a 
.B log
command with a filename when logging is already active causes the
previous file to be closed and the new file to be opened.
Switches are meaningful only when used in conjunction with a
filename to start logging.


.*s 2 "NL : display CR/LF mapping"
.DS L
usage: nl
.DE

Display the current setting of CR/LF mapping.  For more
information, refer to the
.B nlin
and
.B nlout
command descriptions.


.*s 2 "NLIn : set receive CR/LF mapping"
.DS L
usage: nlin [<y-n>]
.DE

This command controls whether or not a newline (NL/LF)
character is sent to the screen upon receipt of a carriage
return (CR) from the remote system.  Most remote computers
supply a NL after CR.  When communicating with another
terminal in a "teletype conversation", this is generally not
the case (see also the 
.B duplex
command).

Issuing the command without <y-n> causes the current setting
to be displayed.  The format of <y-n> is flexible: 'y' or '1'
enables appending NL to CR, 'n' or '0' causes the
feature to be disabled.


.*s 2 "NLOut : set transmit CR/LF mapping"
.DS L
usage: nlout [<y-n>]
.DE

This command controls whether or not a newline (NL/LF)
character is sent to the remote system upon transmission of
a carriage return (CR) entered by the keyboard.  Most remote
computers do not require (indeed "dislike") a NL after CR.
When communicating with another terminal in a "teletype
conversation", this is generally not the case (see also the
.B duplex
command).

Issuing the command without <y-n> causes the current setting
to be displayed.  The format of <y-n> is flexible: 'y' or '1'
enables appending NL to CR, 'n' or '0' causes the
feature to be disabled.


.*s 2 "OA : octal to ascii char"
.DS L
usage: oa [<octal-val>]
.DE

<octal-val> is a octal value between 0 and 0377; 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 "PARity : set/display line parity"
.DS L
usage: parity [ None | Even | Odd ]
.DE

This command controls the parity of characters transmitted
by the keyboard.  Issuing the command with no argument
displays the current setting.  When the argument is
supplied, only the first character is required.  Even or odd
parity implies seven data bits; no parity implies eight data
bits.  Parity of incoming characters is not checked.

The setting may be automatically changed as the result of an
interactive or procedure
.B dial
command.  See the 
.B baud
and 
.B dial
command descriptions.


.*s 2 "PId : display process ids"
.DS L
usage: pid
.DE

This command displays the process id of the ECU transmitter
process, the ECU receiver process and the process ids of
ECU's parent and group.

.*s 2 "PLog : procedure logging"
.DS L
usage: plog [ <filename> | off]
.DE

This command enables or disables procedure logging.

.*s 2 "POpd : pop to previous directory"
.DS L
usage: popd [ | <#> | all]
.DE

This command returns to a previous directory after a
.B pushd
command has been previously executed.

If no argument is supplied, the directory at the immediately previous
level is restored.  

If a numeric argument is supplied, the directory
at the specified level is restored; the level numbers may be obtained by
issuing a
.B pushd
command with no arguments.

If the 'all' argument is supplied, it is treated as a numeric argument of 0;
that is the directory stack is cleared and the directory at level 0 is
restored.

The directory stack is shared between interactive and procedure
commands.  Neither beginning nor ending a procedure affects the
directory stack level.

.DS L
Examples:
   popd
   popd 3
   popd all
.DE

.*s 2 "PTrace : control procedure trace"
.DS L
usage: ptrace [ on | off | #]
     on  - set trace state to 1
     off - set trace state to 0
     #   - set trace to numeric value #
.DE

This command controls whether or not procedure execution is
to be traced. Trace output is written to
the screen and varies in its nature depending
upon the command being traced.  Specifically,
any change to a string or integer variable
is noted.  If tracing is enabled, the output will also be
written to the procedure log file (see the
.b plog
interactive and procedure commands).

The majority of procedure tracing features use the current trace
state as a binary condition.  That is, either tracing is done
or not.  However, the procedure command
.B expresp
emits varying levels of debugging output in a manner similar to
the uucico -x flag.

Issuing the command with no argument shows current status.

.*s 2 "PUshd : push to new directory"
.DS L
usage: pushd [ | <dir>]
.DE

This command either 1) saves the current directory pathname on
a stack and establishes a new current directory or
2) displays the current stack and current directory.
The stack size is 10.

If no argument is supplied, the directory stack is displayed.

The directory stack is shared between interactive and procedure
commands.  Neither beginning nor ending a procedure affects the
directory stack level.

.DS L
Examples:
   pushd
   pushd /tmp
.DE

.*s 2 "PWd : print working directory"
.DS L
usage: pwd
.DE

This command prints the current working directory of the ECU
process.


.*s 2 "REDial : redial last number"
.DS L
usage: redial [<retry-count> [<pause-interval>]]
.DE

This command redials a number previously dialed with the 'dial' command.
Modem status is tested and multiple retries may be made.  <retry-count>
specifies how many retries are to be made.  <pause-interval> specifies
how many seconds the program pauses after a failure to connect.  You
must specify <retry-count> in order to specify <pause-interval>.  The
default value for <retry-count> is 10, for <pause-interval> is 60.

You should know that in some jurisdictions, it is ILLEGAL to dial the
same telephone number more than a specified number of times during some
interval of time.  In any case, a <pause-interval> less than 15 seconds
is silently changed to 15 seconds.

.*s 2 "REV : ECU revision/make date"
.DS L