wht@tridom.uucp (Warren Tucker) (10/12/89)
---- Cut Here and unpack ----
#!/bin/sh
# this is part 42 of a multipart archive
# do not concatenate these parts, unpack them in order with /bin/sh
# file doc/ecu.man continued
#
CurArch=42
if test ! -r s2_seq_.tmp
then echo "Please unpack part 1 first!"
exit 1; fi
( read Scheck
if test "$Scheck" != $CurArch
then echo "Please unpack part $Scheck next!"
exit 1;
else exit 0; fi
) < s2_seq_.tmp || exit 1
echo "x - Continuing file doc/ecu.man"
sed 's/^X//' << 'SHAR_EOF' >> doc/ecu.man
X
X usage: bn [ 0 | 1 | 2 ]
X
X
X "bell notify": If no argument is supplied, the current setting is
X displayed. Specifying 0 disables the facility; 1 causes an audible
X alarm to be sounded on all of the XENIX virtual consoles upon receipt of
X a bell (0x07) character from the remote system; 2 causes an audible
X alarm to be sent to all consoles upon receipt of ANY characters from the
X remote system. A non-zero value also causes an audible alarm to be sent
X to all console upon the successful completion of a 'redial' command
X which must retry more than one redial attempt or upon completion of a
X file transfer operation.
X
X Different alarms are sent depending upon the the type of event causing
X the alarms.
X
X BN is set to 1 when ECU begins executing.
X
X
X 5.5 _B_R_e_a_k : _s_e_n_d _b_r_e_a_k _t_o _r_e_m_o_t_e
X
X usage: break
X
X
X This command sends a break signal to the remote system.
X
X
X
X 5.6 _C_D : _c_h_a_n_g_e _c_u_r_r_e_n_t _d_i_r_e_c_t_o_r_y
X
X usage: cd [<dir-path>]
X
X
X This command allows you to change the working directory of the ECU
X process. If <dir-path> is supplied, the previous working directory is
X displayed, and <dir-path> is made the new working directory. A history
X of previous directory changes is maintained. Entering the ccccdddd command
X shows the numbered history list and allows you to select a new directory
X by entering the number. Other commands allow deletion of directories
X from the list or saving the list to file ~/.ecuphone. This file is
X
X
X
X Copyright (C) 1989, Warren H. Tucker 10/8/89
X
X
X
X
X
X
X
X ECU Technical Description 16
X
X
X
X automatically read at ECU startup, providing a convenient list of
X directories available for quick selection.
X
X
X
X 5.7 _D_A : _d_e_c_i_m_a_l _t_o _a_s_c_i_i _c_h_a_r
X
X usage: da [<decimal-val>]
X
X
X <decimal-val> is a decimal value between 0 and 0377; the parity (sign)
X bit is stripped and the equivalent ASCII character value is displayed.
X
X If no argument is supplied, a table of control characters is printed
X containing decimal, octal, hex, ASCII identifiers and two-character
X control character identifier.
X
X
X
X 5.8 _D_i_a_l : _d_i_a_l _r_e_m_o_t_e _d_e_s_t_i_n_a_t_i_o_n
X
X usage: dial [<dial-param>]
X
X
X <dial-param> may take one of two forms, a telephone number to dial or a
X logical name which can be found in the user phone directory (in file
X ~/.ecuphone).
X
X If a telephone number is supplied, the phone number is dialed; you must
X first have set the desired baud rate and parity using the bbbbaaaauuuudddd and
X ppppaaaarrrriiiittttyyyy commands.
X
X If a logical name is entered, the phone directory is searched; if the
X entry is found, the baud rate and parity is automatically set. If a
X procedure file can be found in the current directory or the users home
X .ECU subdirectory whose name matches the logical name, then the
X procedure is executed with the argument '!INTERACTIVE'.
X
X
X If <dial-param> is not supplied, then a screen-oriented self-documenting
X directory manager is executed; you may scan the the directory to select
X a number to dial, as well as add, remove and edit entries. Upon dialing
X from the menu, if a procedure file can be found in the current directory
X or the users home .ECU subdirectory whose name matches the logical name,
X then the procedure is executed with the argument '!MENU'.
X
X
X
X
X
X
X
X
X
X Copyright (C) 1989, Warren H. Tucker 10/8/89
X
X
X
X
X
X
X
X ECU Technical Description 17
X
X
X
X 5.9 _D_O : _p_e_r_f_o_r_m _p_r_o_c_e_d_u_r_e
X
X usage: do <procname> [<arg> ... ]
X
X
X Perform ECU procedure. Ecu searches for <procname>.ep in the current
X directory. If the file is not found, the program looks for the file in
X the ~/.ECU directory. One or more arguments may be passed to the
X procedure
X
X
X
X 5.10 _D_U_p_l_e_x : _s_e_t/_d_i_s_p_l_a_y _d_u_p_l_e_x
X
X usage: duplex [ Full | Half ]
X
X
X This command specifies whether or not ECU is to locally echo characters
X typed by you at the keyboard. The overwhelming majority of remote
X systems provide the echo function, in which case full duplex must be
X used. For the rare occasions when the remote system does not echo your
X keyboard input, setting half duplex will allow you to see what you are
X typing.
X
X When communicating with another terminal in a "teletype conversation",
X setting half duplex is generally required. In such cases, use of the
X nnnnllll, nnnnlllliiiinnnn and nnnnlllloooouuuutttt commands may also be required.
X
X The default setting for duplex is full.
X
X
X
X 5.11 _E_X_i_t : _d_r_o_p _c_a_r_r_i_e_r, _e_x_i_t _p_r_o_g_r_a_m
X
X usage: exit
X
X
X This command terminates ECU promptly. If your modem does not drop
X carrier upon loss of Data Terminal Ready (DTR), the command will
X terminate ECU, but may leave the communications line off hook. It is
X strongly recommended that you configure your modem to hang up the phone
X line when DTR drops. A shorthand version of this command exists: '.' is
X equivalent to eeeexxxxiiiitttt.
X
X
X
X
X
X
X
X
X
X
X
X Copyright (C) 1989, Warren H. Tucker 10/8/89
X
X
X
X
X
X
X
X ECU Technical Description 18
X
X
X
X 5.12 _F_I : _s_e_n_d _t_e_x_t _f_i_l_e _t_o _l_i_n_e
X
X usage: fi [<filename>]
X
X
X "file insert": This command causes file characters to be inserted into
X the transmit data stream as though they had been entered at the
X keyboard. If <filename> is not entered on the command line, a prompt
X for the filename is made. Once the filename has been entered and file
X has been opened, you are asked whether the file should be transmitted at
X full speed or by a single line at a time. Some remote systems are not
X capable of receiving large amount of data (referred to as "streaming
X data") without pauses. By specifying single line transmission, it is
X possible to increase the likelihood of proper receipt. Even with "full"
X speed transmission, some "pacing" (inter-character delay) is introduced
X to ease loading on the remote system. With "single" line transmission,
X you must press the space key to initiate sending each next line.
X Pressing the 's' key stops the transfer. Pressing the interrupt key
X (DEL) stops a full speed transmission.
X
X
X
X 5.13 _F_K_e_y : _f_u_n_c_t_i_o_n _k_e_y _d_e_f_i_n_i_t_i_o_n
X
X usage: fkey [<keyset_name>]
X
X
X This command allows the mapping of function keys F1-F12, PgUp, PgDn, End
X and Ins and the cursor up, down, left and right keys to emit a desired
X sequence of characters when a function key is pressed. <keyset_name>
X specifies which key set in ~/.ecukeys is to be selected: Sample entry in
X .ecukeys:
X
X hayes
X F1:escape:+ + +
X F2:autoans:A T S 0 = 1 cr
X F3:dial:A T D T
X bbs
X F1:cancel:^K
X F2:yes:y cr
X
X
X If a keyset_name matches a logical dial directory name, it is loaded
X when the number is dialed.
X
X
X
X
X
X
X
X
X
X
X Copyright (C) 1989, Warren H. Tucker 10/8/89
X
X
X
X
X
X
X
X ECU Technical Description 19
X
X
X
X 5.14 _H_A_n_g_u_p : _h_a_n_g _u_p _m_o_d_e_m
X
X usage: hangup
X
X
X This causes a Hayes modem command sequence to be sent to terminate any
X outstanding connection (+++, pause, ATH).
X
X
X
X 5.15 _H_E_l_p : _i_n_v_o_k_e _h_e_l_p
X
X usage: help [<cmd-name>]
X
X
X Issuing this command with no argument displays a list of commands
X followed by a request for a command for further information.
X
X
X
X 5.16 _L_L_p : _s_e_t _s_e_s_s_i_o_n _l_o_g _t_o /_d_e_v/_l_p
X
X usage: llp
X
X
X This command is available only in XENIX versions. It is a shorthand
X version of 'log /dev/lp'. /dev/lp must not be under the control of a
X print spooler.
X
X
X
X 5.17 _L_O_F_f : _t_u_r_n _o_f_f _s_e_s_s_i_o_n _l_o_g_g_i_n_g
X
X usage: loff
X
X
X This command is shorthand for 'log off'. If session logging is active,
X it is turned off.
X
X
X
X 5.18 _L_O_G : _s_e_s_s_i_o_n _l_o_g_g_i_n_g _c_o_n_t_r_o_l
X
X usage: log [-s] [-r] [ | off | filename ]
X -s "scratch" previous file contents; otherwise append
X -r "raw" logging; otherwise non-printable characters
X other than tab and newline are omitted from the log
X
X
X This command controls session logging; issuing the command with no
X argument causes the status of session logging to be displayed. The
X
X
X
X Copyright (C) 1989, Warren H. Tucker 10/8/89
X
X
X
X
X
X
X
X ECU Technical Description 20
X
X
X
X special argument 'off' causes active logging to be terminated. Other
X argument values cause logging to start using the argument as a filename.
X Issuing a lllloooogggg command with a filename when logging is already active
X causes the previous file to be closed and the new file to be opened.
X Switches are meaningful only when used in conjunction with a filename to
X start logging.
X
X
X
X 5.19 _N_L : _d_i_s_p_l_a_y _C_R/_L_F _m_a_p_p_i_n_g
X
X usage: nl
X
X
X Display the current setting of CR/LF mapping. For more information,
X refer to the nnnnlllliiiinnnn and nnnnlllloooouuuutttt command descriptions.
X
X
X
X 5.20 _N_L_I_n : _s_e_t _r_e_c_e_i_v_e _C_R/_L_F _m_a_p_p_i_n_g
X
X usage: nlin [<y-n>]
X
X
X This command controls whether or not a newline (NL/LF) character is sent
X to the screen upon receipt of a carriage return (CR) from the remote
X system. Most remote computers supply a NL after CR. When communicating
X with another terminal in a "teletype conversation", this is generally
X not the case (see also the dddduuuupppplllleeeexxxx command).
X
X Issuing the command without <y-n> causes the current setting to be
X displayed. The format of <y-n> is flexible: 'y' or '1' enables
X appending NL to CR, 'n' or '0' causes the feature to be disabled.
X
X
X
X 5.21 _N_L_O_u_t : _s_e_t _t_r_a_n_s_m_i_t _C_R/_L_F _m_a_p_p_i_n_g
X
X usage: nlout [<y-n>]
X
X
X This command controls whether or not a newline (NL/LF) character is sent
X to the remote system upon transmission of a carriage return (CR) entered
X by the keyboard. Most remote computers do not require (indeed
X "dislike") a NL after CR. When communicating with another terminal in a
X "teletype conversation", this is generally not the case (see also the
X dddduuuupppplllleeeexxxx command).
X
X Issuing the command without <y-n> causes the current setting to be
X displayed. The format of <y-n> is flexible: 'y' or '1' enables
X appending NL to CR, 'n' or '0' causes the feature to be disabled.
X
X
X
X Copyright (C) 1989, Warren H. Tucker 10/8/89
X
X
X
X
X
X
X
X ECU Technical Description 21
X
X
X
X 5.22 _O_A : _o_c_t_a_l _t_o _a_s_c_i_i _c_h_a_r
X
X usage: oa [<octal-val>]
X
X
X <octal-val> is a octal value between 0 and 0377; the parity (sign) bit
X is stripped and the equivalent ASCII character value is displayed.
X
X If no argument is supplied, a table of control characters is printed
X containing decimal, octal, hex, ASCII identifiers and two-character
X control character identifier.
X
X
X
X 5.23 _P_A_R_i_t_y : _s_e_t/_d_i_s_p_l_a_y _l_i_n_e _p_a_r_i_t_y
X
X usage: parity [ None | Even | Odd ]
X
X
X This command controls the parity of characters transmitted by the
X keyboard. Issuing the command with no argument displays the current
X setting. When the argument is supplied, only the first character is
X required. Even or odd parity implies seven data bits; no parity implies
X eight data bits. Parity of incoming characters is not checked.
X
X The setting may be automatically changed as the result of an interactive
X or procedure ddddiiiiaaaallll command. See the bbbbaaaauuuudddd and ddddiiiiaaaallll command descriptions.
X
X
X
X 5.24 _P_I_d : _d_i_s_p_l_a_y _p_r_o_c_e_s_s _i_d_s
X
X usage: pid
X
X
X This command displays the process id of the ECU transmitter process, the
X ECU receiver process and the process ids of ECU's parent and group.
X
X
X 5.25 _P_L_o_g : _p_r_o_c_e_d_u_r_e _l_o_g_g_i_n_g
X
X usage: ptrace [ <filename> | off]
X
X
X
X 5.26 _P_T_r_a_c_e : _c_o_n_t_r_o_l _p_r_o_c_e_d_u_r_e _t_r_a_c_e
X
X usage: ptrace [ 0 | 1 | on | off]
X
X
X This command controls whether or not procedure execution is to be
X
X
X
X Copyright (C) 1989, Warren H. Tucker 10/8/89
X
X
X
X
X
X
X
X ECU Technical Description 22
X
X
X
X traced. Trace output is written to the screen and varys in its nature
X depending upon the command being traced. Specifically, any change to a
X string or integer variable is noted. If tracing is enabled, the output
X will also be written to the procedure log file (see the interactive and
X procedure commands). Issuing the command with no argument shows current
X status.
X
X
X 5.27 _P_W_d : _p_r_i_n_t _w_o_r_k_i_n_g _d_i_r_e_c_t_o_r_y
X
X usage: pwd
X
X
X This command prints the current working directory of the ECU process.
X
X
X
X 5.28 _R_E_D_i_a_l : _r_e_d_i_a_l _l_a_s_t _n_u_m_b_e_r
X
X usage: redial [<retry-count> [<pause-interval>]]
X
X
X This command redials a number previously dialed with the 'dial' command.
X Under non-XENIX versions, one dial attempt is made. Under XENIX
X versions, modem status is tested and multiple retries may be made.
X <retry-count> specifies how many retries are to be made. <pause-
X interval> specifies how many seconds the program pauses after a failure
X to connect. You must specify <retry-count> in order to specify <pause-
X interval>. The default value for <retry-count> is 10, for <pause-
X interval> is 15.
X
X You should know that in some jurisdictions, it is ILLEGAL to dial the
X same telephone number more than a specified number of times during some
X interval of time. In any case, specifying <pause-interval> less than 15
X seconds is silently changed to 15 seconds.
X
X
X
X 5.29 _R_E_V : _E_C_U _r_e_v_i_s_i_o_n/_m_a_k_e _d_a_t_e
X
X usage: rev
X
X
X This command displays ECU's revision, the transmitter, receiver, parent
X and group process ids and the date and time ECU was made.
X
X
X
X
X
X
X
X
X
X Copyright (C) 1989, Warren H. Tucker 10/8/89
X
X
X
X
X
X
X
X ECU Technical Description 23
X
X
X
X 5.30 _R_K : _r_e_c_e_i_v_e _v_i_a _C-_K_e_r_m_i_t
X
X usage: rk
X
X
X This command searches the PATH list for 'ckermit' (Columbia University
X C-Kermit) and invokes it to receive files.
X
X The file ~/.kermrc must be set up to have any desired initialization
X paraeters you desire. Refer to C-Kermit documentation for more
X information.
X
X
X
X 5.31 _R_S : _r_e_c_e_i_v_e _v_i_a _S_E_A_l_i_n_k
X
X usage: rs
X
X
X This command invokes a SEAlink receive protocol.
X
X
X
X 5.32 _R_X : _r_e_c_e_i_v_e _v_i_a _X_M_O_D_E_M/_C_R_C
X
X usage: rx
X
X
X This command invokes ecurz to receive files from the remote system using
X XMODEM/CRC.
X
X After entering the command, you are prompted as to whether or not file
X CR/LF characters are to be converted to newlines. If you are
X transferring text files from a system which contain CR/LF line
X terminators, you must answer yes to this question. You should answer no
X when transferring binary files, such as executables, .arc files and the
X like. File transfer progress is presented on a visual display. To
X abort the transfer, press your interrupt key (usually DEL unless reset
X with stty(C)).
X
X
X
X 5.33 _R_Y : _r_e_c_e_i_v_e _v_i_a _Y_M_O_D_E_M _B_a_t_c_h
X
X usage: ry
X
X
X This command invokes ecurz to receive files from the remote system using
X YMODEM batch with CRC-16 error correction. The YMODEM is "true YMODEM",
X not XMODEM-1k. File transfer progress is presented on a visual display.
X To abort the transfer, press your interrupt key (usually DEL unless
X
X
X
X Copyright (C) 1989, Warren H. Tucker 10/8/89
X
X
X
X
X
X
X
X ECU Technical Description 24
X
X
X
X reset with stty(C)).
X
X
X
X 5.34 _R_Z : _r_e_c_e_i_v_e _v_i_a _Z_M_O_D_E_M/_C_R_C_3_2
X
X usage: rz
X
X
X This command invokes ecurz to receive files from the remote system using
X ZMODEM/CRC32. File transfer progress is presented on a visual display.
X To abort the transfer, press your interrupt key (usually DEL unless
X reset with stty(C)).
X
X
X
X 5.35 _S_D_N_A_M_E : _s_e_l_e_c_t _s_c_r_e_e_n _d_u_m_p _f_i_l_e _n_a_m_e
X
X usage: sdname [<filename>]
X
X
X When the "cursor 5" key is pressed, the screen contents are dumped to a
X file. By default, this file is named '~/.ecu/screen.dump'. This
X command either displays or changes the current screen dump file name,
X depending upon whether or not a argument is supplied.
X
X The actions of this command have no effect on the operation of the
X procedure command.
X
X
X 5.36 _S_K : _s_e_n_d _v_i_a _C-_K_e_r_m_i_t
X
X usage: sk [<file-list>]
X
X
X This command searches the PATH list for 'ckermit' (Columbia University
X C-Kermit) and invokes it to send files. The file ~/.kermrc must be set
X up to have any desired initialization paraeters you desire.
X
X After entering the command, you are prompted as to whether or not file
X newline characters are to be converted to CR/LF. If you are
X transferring text files to a system which requires CR/LF line
X terminators, you must answer yes to this question. You should answer no
X when transferring binary files, such as executables, .arc files and the
X like. You are prompted to enter a list of files to send, which may
X contain one or more wildcard specifications.
X
X The file ~/.kermrc must be set up to have any desired initialization
X arguments you desire. Refer to C-Kermit documentation for more
X information.
X
X
X
X
X Copyright (C) 1989, Warren H. Tucker 10/8/89
X
X
X
X
X
X
X
X ECU Technical Description 25
X
X
X
X 5.37 _S_S : _s_e_n_d _v_i_a _S_E_A_l_i_n_k
X
X usage: ss [<file-list>]
X
X
X This command invokes a SEAlink file transmission protocol.
X
X
X .--[ Send SEAlink ]-------- dir: /u1/src/ecu ------------------.
X | |
X | File(s) to send: |
X | ___________________________________________________________ |
X | |
X | TAB:next ^B:prev END:perform transfer ESC:abort |
X `-- enter file(s) to send -------------------------------------'
X
X
X
X 5.38 _S_T_a_t : _c_o_n_n_e_c_t_i_o_n _s_t_a_t_u_s
X
X usage: stat
X
X
X This command displays statistics about ECU usage. Example display:
X
X Date/time: 06-14-1988 11:40:35 (UTC 15:40)
X Total chars transmitted: 178
X Total chars received: 3681
X
X Date/time: 06-14-1988 14:41:24 (UTC 18:41)
X Connected to CompuHost (555-1234) at 14:40:57
X Parameters: 2400-N-1 Connect time: 00:01:27
X Total chars transmitted: 234 (since CONNECT 142)
X Total chars received: 2278 (since CONNECT 1478)
X
X
X
X 5.39 _S_X : _s_e_n_d _v_i_a _X_M_O_D_E_M/_C_R_C
X
X usage: sx [<file-name>]
X
X
X This command invokes ecusz to send a file to the remote system using
X XMODEM/CRC.
X
X After entering the command, you are prompted as to whether or not file
X CR/LF characters are to be converted to newlines. If you are
X transferring text files from a system which contain CR/LF line
X terminators, you must answer yes to this question. You should answer no
X when transferring binary files, such as executables, .arc files and the
X like.
X
X
X
X Copyright (C) 1989, Warren H. Tucker 10/8/89
X
X
X
X
X
X
X
X ECU Technical Description 26
X
X
X
X You are prompted to enter a filename to send. File transfer progress is
X presented on a visual display. To abort the transfer, press your
X interrupt key (usually DEL unless reset with stty(C)).
X
X .--[ Send XMODEM/CRC ]----- dir: /u1/src/ecu -----------.
X | |
X | File to send: |
X | ____________________________________________________ |
X | |
X | Binary: Y (no NL-CR/LF translation) |
X | |
X | TAB:next ^B:prev END:perform transfer ESC:abort |
X `-- enter file(s) to send ------------------------------'
X
X
X
X 5.40 _S_Y : _s_e_n_d _v_i_a _Y_M_O_D_E_M _B_a_t_c_h
X
X usage: sy [<file-list>]
X
X
X This command invokes ecusz to send file(s) to the remote system using
X YMODEM/CRC.
X
X You are prompted to enter filename(s) to send, which may consist of one
X or more wildcard specifications. File transfer progress is presented on
X a visual display. To abort the transfer, press your interrupt key
X (usually DEL unless reset with stty(C)).
X
X .--[ Send YMODEM/CRC ]----- dir: /u1/src/ecu -----------.
X | |
X | File to send: |
X | ____________________________________________________ |
X | |
X | Binary: Y (no NL-CR/LF translation) |
X | |
X | TAB:next ^B:prev END:perform transfer ESC:abort |
X `-- enter file(s) to send ------------------------------'
X
X
X
X 5.41 _S_Z : _s_e_n_d _v_i_a _Z_M_O_D_E_M/_C_R_C_3_2
X
X usage: sz [<file-list>]
X
X
X This command invokes ecusz to send file(s) to the remote system using
X ZMODEM/CRC32.
X
X You are prompted to enter filename(s) to send, which may consist of one
X or more wildcard specifications. File transfer progress is presented on
X
X
X
X Copyright (C) 1989, Warren H. Tucker 10/8/89
X
X
X
X
X
X
X
X ECU Technical Description 27
X
X
X
X a visual display. To abort the transfer, press your interrupt key
X (usually DEL unless reset with stty(C)).
X
X Note: if you specify sending only newer files and the remote receiver
X does not support the feature, it may skip (reject) all your files.
X Retry the transfer specifying 'N' to 'Transfer only newer files'.
X
X
X .--[ Send ZMODEM/CRC32 ]--- dir: /u1/src/ecu ----------.
X | |
X | File(s) to send: |
X | ___________________________________________________ |
X | |
X | Binary: Y (no NL-CR/LF translation) |
X | Overwrite destination files: Y |
X | Send full pathames: N |
X | Transfer only newer files: N |
X | |
X | TAB:next ^B:prev END:perform transfer ESC:abort |
X `-- enter file(s) to send -----------------------------'
X
X
X
X
X 5.42 _T_I_m_e : _t_i_m_e _o_f _d_a_y
X
X usage: time
X
X
X This command displays the local date and time as well as the current
X UTC.
X
X
X 5.43 _T_T_y : _c_o_n_s_o_l_e _t_t_y _n_a_m_e
X
X usage: tty
X
X
X This command displays the current console tty name.
X
X
X
X 5.44 _X_A : _h_e_x _t_o _a_s_c_i_i _c_h_a_r
X
X usage: xa [<hex-val>]
X
X
X <hex-val> is a hexadecimal value between 0 and FF; the parity (sign) bit
X is stripped and the equivalent ASCII character value is displayed.
X
X If no argument is supplied, a table of control characters is printed
X
X
X
X Copyright (C) 1989, Warren H. Tucker 10/8/89
X
X
X
X
X
X
X
X ECU Technical Description 28
X
X
X
X containing decimal, octal, hex, ASCII identifiers and two-character
X control character identifier.
X
X
X
X 5.45 ! : _e_x_e_c_u_t_e _s_h_e_l_l
X
X usage: !
X !<command>
X
X
X The '!' command is a shell escape. The environment variable SHELL is
X read to determine what shell program to execute (e.g., /bin/sh, etc).
X If '!' is entered by itself, an interactive shell is started; press ^D
X to exit back to ECU. If <command> is supplied, it is executed by the
X shell with an immediate return to ECU.
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X Copyright (C) 1989, Warren H. Tucker 10/8/89
X
X
X
X
X
X
X
X ECU Technical Description 29
X
X
X
X 6. _P_r_o_c_e_d_u_r_e _L_a_n_g_u_a_g_e
X
X
X Sample procedures are shown in the companion document 'samplproc.man'.
X
X
X
X 6.1 _A_r_g_u_m_e_n_t_s
X
X
X There are five types of arguments to procedure commands:
X
X witch
X Alphabetic Token
X Integer
X String
X Relational Operators
X
X This section describes the syntax and construction of each type in turn.
X There are separate groups of valid of relational operators for integers
X and strings; thus, they are described under the appropriate sections.
X
X
X 6.1.1 _S_w_i_t_c_h_e_s
X
X Switch arguments begin with a hyphen (minus, '-'). The switch argument
X must be the first argument after the command. Only one switch argument
X is allowed on the command line. If switches '-a', '-b' and '-c', are
X available and '-a' and '-b' are desired, '-ab' or '-ba' is entered.
X
X
X 6.1.2 _A_l_p_h_a_b_e_t_i_c _T_o_k_e_n_s
X
X Alphabetic tokens, for lack of a better term, are non-integer, non-
X quoted terms used as arguments for certain commands, such as:
X
X plog off
X
X Such argument types are fairly simple to understand and use; they are
X described here for completeness.
X
X
X 6.1.3 _I_n_t_e_g_e_r_s
X
X Integer values are 32-bit quantities ranging between -2147483647 and
X 2147483647.
X
X In one case, an integer is used to store a 32-bit color mask as
X described by the ccccoooolllloooorrrr command and the %%%%ccccoooolllloooorrrrssss integer function.
X
X
X
X
X
X Copyright (C) 1989, Warren H. Tucker 10/8/89
X
X
X
X
X
X
X
X ECU Technical Description 30
X
X
X
X 6.1.3.1 _C_o_n_s_t_a_n_t_s
X
X Integer constants are numeric strings, optionally with an initial minus
X sign, the absolue value of which must be less than 2147483648.
X
X
X 6.1.3.2 _V_a_r_i_a_b_l_e_s
X
X There are 50 numbered, permanent integer variables referenced by the
X terms '$i0' through '$i49'. When ECU is started, the value of each
X variable is zero. Variables retain their value until changed, even
X between procedure executions. The integer variable number may be
X expressed as an expression by enclosing an integer expression in brackets.
X For instance:
X
X $i[4+5] refers to $i9
X
X $i2=5
X $i[20+$i2] refers to $i25
X
X
X Integer variables may be created for use as "local" variables or to
X promote code readability. Refer to the mmmmkkkkvvvvaaaarrrr command.
X
X
X 6.1.3.3 _F_u_n_c_t_i_o_n_s
X
X ECU has many built-in functions which return the value of ecu- or
X system-related information. A list of the functions appears in a later
SHAR_EOF
echo "End of part 42"
echo "File doc/ecu.man is continued in part 43"
echo "43" > s2_seq_.tmp
exit 0
--
-------------------------------------------------------------------
Warren Tucker, Tridom Corporation ...!gatech!emory!tridom!wht
Ker-au'-lo-phon. An 8-foot partial flue-stop, having metal pipes
surmounted by adjustable rings, and with a hole bored near the top
of each pipe, producing a soft and "reedy" tone.