home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Usenet 1994 October
/
usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso
/
misc
/
volume21
/
ecuman
/
part04
< prev
next >
Wrap
Text File
|
1991-08-09
|
38KB
|
1,258 lines
Newsgroups: comp.sources.misc
From: Warren Tucker <wht@n4hgf.Mt-Park.GA.US>
Subject: REPOST: v21i093: Manual for ECU comm package rev 3.10, Part04/04
Message-ID: <1991Aug9.181341.28699@sparky.IMD.Sterling.COM>
X-Md4-Signature: 6506d7e7b41fd27749461f647c7ceae9
Date: Fri, 9 Aug 1991 18:13:41 GMT
Approved: kent@sparky.imd.sterling.com
Submitted-by: Warren Tucker <wht@n4hgf.Mt-Park.GA.US>
Posting-number: Volume 21, Issue 93
Archive-name: ecuman/part04
Environment: SCO, XENIX, ISC
Supersedes: ecuman3: Volume 16, Issue 22-24
---- Cut Here and feed the following to sh ----
#!/bin/sh
# this is ecuman310.04 (part 4 of ecuman310)
# do not concatenate these parts, unpack them in order with /bin/sh
# file doc/ecu.man continued
#
if touch 2>&1 | fgrep 'amc' > /dev/null
then TOUCH=touch
else TOUCH=true
fi
if test ! -r _shar_seq_.tmp; then
echo 'Please unpack part 1 first!'
exit 1
fi
(read Scheck
if test "$Scheck" != 4; then
echo Please unpack part "$Scheck" next!
exit 1
else
exit 0
fi
) < _shar_seq_.tmp || exit 1
if test ! -f _shar_wnt_.tmp; then
echo 'x - still skipping doc/ecu.man'
else
echo 'x - continuing file doc/ecu.man'
sed 's/^X//' << 'SHAR_EOF' >> 'doc/ecu.man' &&
X format 'hh:mm:ss' for the integer parameter int0, a number of seconds.
X
X
X Example:
X
X echo %etime(62)
X 00:01:02
X
X
X
X 5.6.16 %filepart
X
X usage: %filepart(str0)
X
X This function returns the filename portion of the pathname supplied in
X str0. See also %basename and %dirpart.
X
X
X Examples:
X
X %filepart('/u1/src/src/foo.c') = "foo.c"
X %filepart('foo.c') = "foo.c"
X
X
X
X 5.6.17 %fmodestr
X
X usage: %fmodestr(int0)
X
X This function returns a string representation of the familiar file mode
X string given the file mode integer int0.
X
X
X Example:
X
X echo %fmodestr(0100755)
X -rwxr-xr-x
X
X echo %fmodestr(%fmode('/usr/lib'))
X drwxr-xr-x
X
X
X
X 5.6.18 %itos
X
X usage: %itos(int0[,format])
X
X
X
X Public Domain by wht@n4hgf 7/25/91
X
X
X
X
X
X
X
X ECU Technical Description 94
X
X
X
X This function converts integer int0 to a string, optionally controlling
X the format of the conversion.
X
X If the format parameter is missing, the conversion is to a minimum
X number of decimal characters necessary to hold the result.
X
X If the format parameter is present, it must of consist of a non-null
X string made of one or both optional parts:
X
X decimal number of digits to be part of result string
X (a leading zero indicates leading zeroes are to
X appear in the string; no leading zero pads with
X leading spaces
X
X a lower case letter from the following list:
X d - decimal conversion
X x - hexadecimal conversion
X o - octal conversion
X
X Example:
X
X %itos(33) '33'
X %itos(33,d) '33'
X %itos(33,x) '21'
X %itos(33,5d) ' 33'
X %itos(33,010d) '0000000033'
X %itos(33,10d) ' 33'
X %itos(33,x) '21'
X %itos(33,04x) '0021'
X %itos(33,4x) ' 21'
X %itos(33,o) '41'
X %itos(33,4o) ' 41'
X
X
X
X 5.6.19 %left
X
X usage: %left(str0,int0)
X
X This function returns the leftmost int0 characters of str0. If the
X length of the string is less than int0, the entire str0 is returned.
X
X Example:
X
X if $s0 == 'abcdefg'
X %left($s0,3) returns 'abc'
X
X
X
X
X
X
X
X
X Public Domain by wht@n4hgf 7/25/91
X
X
X
X
X
X
X
X ECU Technical Description 95
X
X
X
X 5.6.20 %line
X
X usage: %line
X
X This function returns the name of the attached communications line in
X the form "/dev/ttyxx". If no line is currently attached, the function
X returns null.
X
X
X 5.6.21 %logname
X
X usage: %logname
X
X This function returns the login name of the user executing ECU. Note:
X the name returned is the name supplied to a login prompt, not any
X current su(C) username that may be in effect.
X
X
X 5.6.22 %mid
X
X usage: %mid(str0,int0[,int1])
X
X This function returns the middle portion of a string str0 beginning with
X the character at position int0 and for a length of int1 characters. If
X int0 is greater than or equal to the length of stro, a null string is
X returned. If the optional argument int1 is not supplied, or if the
X length of the string is less than int1, the entire str0 is returned.
X
X Example:
X
X if $s0 == '0123456789abc'
X %mid($s0,3,4) returns '3456'
X %mid($s0,3) returns '3456789abc'
X %mid($s0,10,2) returns 'ab'
X %mid($s0,10,5) returns 'abc'
X
X
X
X 5.6.23 %month
X
X usage: %month
X
X This function returns the current month as a three character
X abbreviation: 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug',
X 'Sep', 'Oct', 'Nov', 'Dec'.
X
X
X 5.6.24 %rdesc
X
X usage: %rdesc
X
X
X
X
X Public Domain by wht@n4hgf 7/25/91
X
X
X
X
X
X
X
X ECU Technical Description 96
X
X
X
X This function returns the description portion of the dialing directory
X entry for the currently connected remote. If no connection exists, the
X function returns null.
X
X
X 5.6.25 %right
X
X usage: %right(str0,int0)
X
X This function returns the rightmost int0 characters of str0. If the
X length of the string is less than int0, the entire str0 is returned.
X
X Example:
X
X if $s0 == 'abcdefg'
X %right($s0,3) returns 'efg'
X
X
X
X 5.6.26 %rname
X
X usage: %rname
X
X This function returns the logical name portion of the dialing directory
X entry for the currently connected remote. If the remote was dialed
X directly, as in dial 5551212, the returned value is the phone number.
X If no connection exists, the function returns null.
X
X The value returned by this command may be overridden by use of the rname
X procedure command.
X
X
X 5.6.27 %rtelno
X usage: %rtelno
X
X This function returns the telephone number portion of the dialing
X directory entry for the currently connected remote. If no connection
X exists, the function returns null.
X
X
X 5.6.28 %time
X
X usage: %time
X
X This function returns the current time in the form 'hh:mm' in the local
X time zone (daylight time if it applies).
X
X
X 5.6.29 %times
X
X usage: %times
X
X
X
X Public Domain by wht@n4hgf 7/25/91
X
X
X
X
X
X
X
X ECU Technical Description 97
X
X
X
X This function returns the current time in the form 'hh:mm:ss' in the
X local time zone (daylight time if it applies).
X
X
X 5.6.30 %timez
X
X usage: %timez
X
X This function returns the current time in the form 'hh:mm' in the UTC
X (Z) time zone.
X
X
X 5.6.31 %timezs
X
X usage: %timezs
X
X This function returns the current time in the form 'hh:mm:ss' in the UTC
X (Z) time zone.
X
X
X 5.6.32 %tty
X
X usage: %tty
X
X This function returns the console tty name in the form "/dev/ttynn".
X
X
X
X 5.7 Special Procedures
X
X
X ECU provides for special "hook" procedures to be executed at certain
X times. Their use is encouraged, but you must take precautions not to
X excecute any unreasoable commands in them, for the are rather "raw"
X hooks and it is easily possible to confuse ECU by performing illogical
X operations in them. Judicious use can, however, be quite productive.
X
X They are searched for in the same manner as any other procedure, so you
X can have a customised version of them in a working directory and a
X default in your ~/.ecu subdirectory. No error is reported if they are
X not found.
X
X
X 5.7.1 _rc.ep
X
X Afer ECU is initialized, but before it presents the setup screen or
X executes a -p initial procedure, procedure '_rc' is executed with no
X arguments. (It is named in the tradition of /etc/rc, .mailrc, etc..)
X This procedure can be used to customize the ecu environment prior to
X beginning the usual operation. This is not a place to do any dialing or
X long-lived operations, nor is it possible to bypass the setup screen:
X
X
X
X Public Domain by wht@n4hgf 7/25/91
X
X
X
X
X
X
X
X ECU Technical Description 98
X
X
X
X for this, use the -p initial procedure.
X
X The %getenv() function may be useful in here (Am I running on an xterm?
X Do I want to change the default ECUPROMPT?).
X
X If _rc.ep returns a non-zero status or fails (due to syntax or other
X error), ecu terminates immediately.
X
X
X 5.7.2 _connect.ep
X
X This procedure is executed after every connection success after the
X CONNECT message ("result code") is printed. It is passed one argument,
X the "result code" string generated by the dialer function (e.g.,
X "CONNECT 19200").
X
X You may use %rname and other functions and features to customize this
X function based on the particular system just reached. Note that integer
X variable $i0 and string variable $s0 set zero prior to executing the
X function. This function may modify the behavior of coorperating dialer
X functions by setting the value of numbered string or integer variables.
X In particular, the dialer function will inherit the values of $i0 and
X $s0 when this special function terminates. Be careful of what you do in
X here since MANY ecu procedure commands affect $i0 and $s0 as a side
X effect of their operation. Even if you know what you do in _connect.ep
X does not modify $i0 or $s0, use of the preservation technique shown in
X the example below may save you headaches if you add to the function in
X the future (long after you have forgotten this pedantic admonition).
X
X If this procedure fails (abnormal procedure termination or non-zero
X return code), ECU hangs up on the line and proceeds as if the connection
X failed.
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X Public Domain by wht@n4hgf 7/25/91
X
X
X
X
X
X
X
X ECU Technical Description 99
X
X
X
X Example:
X #+------------------------------------------------------------------
X # _connect.ep - post-CONNECT special "hook" procedure
X #-------------------------------------------------------------------
X #+:EDITS:
X #:07-13-1991-14:47-wht@n4hgf-creation
X
X $iv0_save = $i0 # it is a VERY good idea to save the dialer
X $sv0_save = $s0 # function return status
X # since gobs of functions and commands modify $i0
X # and/or $s0 as a side effect of their operation
X
X $s30 = '_connect '+%rname+' ('+%argv(1)+')'
X echo $s30 # this still will also live to be visible by
X # the dialer function
X
X ifi %baud > 2400
X {
X xon off # turn XON/XOFF off first, then ...
X rtscts on # turn on RTS/CTS
X }
X else
X {
X rtscts off # turn off RTS/CTS, then ...
X xon on # turn XON/XOFF on
X }
X
X $i0 = $iv0_save # restore dialer return status
X $s0 = $sv0_save
X
X
X
X 5.7.3 _connfail.ep
X
X This procedure is executed after every connection failure after the
X failure message ("result code") is printed. It is passed two arguments,
X the logical system name (the dial directory entry name or the phone
X number) and the "result code" string generated by the dialer function
X (e.g., "BUSY"). The function is called after $i0 has been set to 1 and
X $s0 has been set to the result code. This function may modify the
X behavior of coorperating dialer functions by setting the value of
X numbered string or integer variables. In particular, the dialer
X function will inherit the values of $i0 and $s0 when this special
X function terminates. Be careful of what you do in here since MANY ecu
X procedure commands affect $i0 and/or $s0 as a side effect of their
X operation. See _connect.ep above for further screams and moans.
X
X ]If you get very involved with using this procedure, you'll sooner or
X later run into some undocumented $so values. You'll have to take a look
X at ecuDCE.c and hdbintf.c for an authoritative reference, but perhaps
X you can get along by knowing that result codes with an exclamation point
X
X
X
X Public Domain by wht@n4hgf 7/25/91
X
X
X
X
X
X
X
X ECU Technical Description 100
X
X
X
X as their first character are generated by ECU.
X
X ECU ignores any failure (abnormal procedure termination or non-zero
X return code) resulting from the execution of this procedure.
X
X
X 5.7.4 _hangup.ep
X
X This procedure is executed after every connection termination. It is
X passed one argument, a string representation of the number of seconds
X you were connected. You may use %rname and other functions and features
X to customize this function based on the particular system just reached.
X ECU ignores any error returned by the procedure. ECU ignores any
X failure (abnormal procedure termination or non-zero return code)
X resulting from the execution of this procedure.
X
X
X 5.8 HoneyDanBer UUCP Interface
X
X
X
X 5.8.1 UUCP Control Files
X
X
X 5.8.1.1 /usr/lib/uucp/Devices
X
X ECU reads this file to determine what tty devices are available for
X outgoing calls. The fifth field of each entry must contain either the
X full pathname of a modem dialer program (with leading slash) or the name
X of an entry in the /usr/lib/uucp/Dialers file. Sysfiles support is not
X yet provided. The Devices file must be named /usr/lib/uucp/Devices.
X For more information, see "UUCP Dialers" and "Choosing a Dialout Line"
X below.
X
X
X 5.8.1.2 /usr/lib/uucp/Dialers
X
X Dialers entries may be specified in the Devices entry. Sysfiles support
X is not yet provided. The Dialers file must be named
X /usr/lib/uucp/Dialers.
X
X
X 5.8.1.3 /usr/lib/uucp/Sysfiles
X
X Sysfiles support is not yet provided. The Devices and Dialers files
X must have their default names.
X
X
X 5.8.1.4 /usr/lib/uucp/Systems
X
X No use is made of the Systems file at this time. ECU provides the
X
X
X
X Public Domain by wht@n4hgf 7/25/91
X
X
X
X
X
X
X
X ECU Technical Description 101
X
X
X
X equivalent function with its dialing directory.
X
X
X 5.8.2 Choosing a Dialout Line
X
X TTY devices must be named in the style of:
X
X /dev/tty#N
X ^^
X ||
X |`------ uppercase letter for modem control
X | lowercase for non-modem control
X `--------digit (1-4)
X
X
X A future version of ECU will address this limitation.
X
X If you are using FAS or other third-party driver, you may use ECU with
X ports not normally named in the /dev/tty#N style in one of two ways
X under UNIX and one way under XENIX:
X
X
X 1. Under XENIX or UNIX, create a link to the port
X with a compatible name:
X
X ln /dev/ttyF00 /dev/tty1a
X ln /dev/ttyFM00 /dev/tty1A
X
X 2. Under UNIX, add additional lines to the
X /etc/conf/node.d file and rebuild the kernel
X environment (this is the recommended approach
X for UNIX):
X
X fas ttyF00 c 48
X fas tty1a c 48
X fas ttyF01 c 49
X fas tty1b c 49
X fas ttyFM00 c 208
X fas tty1A c 208
X fas ttyFM01 c 209
X fas tty1B c 209
X
X
X When using the interactive dial command, or when dialing from the
X initial menu, if a logical or system name is specified, the directory
X entry is fetched and examined. If the tty field specifies a value other
X than "Any", the specific line requested is opened, if available, and
X dialing commences. If the specified line is not available, the dial
X attempt fails.
X
X If "Any" is found in the dialing directory entry, then ECU finds an
X
X
X
X Public Domain by wht@n4hgf 7/25/91
X
X
X
X
X
X
X
X ECU Technical Description 102
X
X
X
X available Devices line which matches the baud rate specified in the
X entry. It does so by reading the Dialers file.
X
X A line is selected only if its class begins with the three characters
X "ACU." UUCP will only select a line whose Devices entry class matches
X the active Systems entry class (usually "ACU"), so usually you may make
X a modem accessible to ECU, but not to UUCP, by setting it's class to
X ACUECU.
X
X If a line matching the necessary baud rate is found (by searching
X /etc/utmp) to be a line enabled for login, but which is currently idle,
X the getty interface, described below, is used to acquire the line for
X outgoing use.
X
X
X 5.8.3 Getty Interface
X
X When an idle dialin (enabled) line is chosen for dialout, ECU makes use
X of /usr/lib/ecu/ecuungetty to signal the line's getty to release the
X line (via SIGUSR1). Ecuungetty is again employed to signal the getty to
X reacquire the line when outgoing communication is complete (via
X SIGUSR2).
X
X Ecuungetty is a privileged program, which must be owned by root and have
X the setuid-on-execute bit set. A encrypted id is passed by ecu to
X ecuungetty to validate requests and to prevent abuse of ecuungetty by
X hackers, malcontents and other twentieth-century phenomena.
X
X
X 5.8.4 UUCP Dialer Programs
X
X If the Devices file can be found in /usr/lib/uucp, and a valid entry for
X the attached line can be found, ECU will use the Dialers script or
X dialer program specified in the Devices entry.
X
X Sample enhanced modem dialer program sources may be found in the uucp
X subdirectory of the distribution.
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X Public Domain by wht@n4hgf 7/25/91
X
X
X
X
X
X
X
X
X
X
X
X CONTENTS
X
X
X 1. Introduction....................................... 2
X
X 2. Basic Organization................................. 3
X 2.1 Transmitter Process (XMTR)................... 3
X 2.1.1 Keyboard Interface................... 3
X 2.1.2 ECU Command Assembly................. 3
X 2.1.3 Function Key Mapping................. 4
X 2.1.4 Auxiliary Operation Control.......... 4
X 2.2 Receiver Process (RCVR)...................... 5
X 2.2.1 ANSI Filter.......................... 5
X 2.2.2 Session Logging...................... 5
X 2.3 Supported Terminals.......................... 5
X 2.4 Function Key Recognition..................... 7
X 2.5 Function Key Mapping......................... 9
X 2.6 Host Video Control Sequences................. 11
X 2.6.1 All Local Terminals.................. 11
X 2.6.2 Multiscreen Local Terminals.......... 12
X 2.6.3 Character Mapping.................... 13
X 2.7 Line Editing................................. 14
X 2.8 Screen Dump.................................. 14
X 2.8.1 Multiscreen and Non-Multiscreen...... 14
X 2.8.2 Multiscreen Bug...................... 15
X 2.9 Interactive Command History.................. 15
X 2.10 Dialing Directory............................ 15
X 2.11 Online Command Dictionary.................... 17
X 2.12 Multiscreen Event Alarm...................... 17
X 2.13 Built-in Modem Dialer........................ 18
X 2.14 File Transfer................................ 18
X 2.15 Procedures (Scripts)......................... 19
X 2.15.1 Initial (Startup) Procedure.......... 20
X 2.15.2 Dialing Procedure.................... 20
X 2.16 Home Directory Files......................... 20
X 2.17 Lock Files................................... 20
X 2.18 Dial-In/Dial-Out Line Support................ 21
X 2.19 Tools........................................ 21
X 2.20 Shared Memory 'Friend' Interface............. 21
X
X 3. Starting the Program............................... 23
X 3.1 Simple Startup - Initial Setup Menu.......... 23
X 3.1.1 Name/Phone Number Field.............. 23
X 3.1.2 Other Fields......................... 24
X 3.1.3 Special Characters................... 24
X 3.2 Command Line Arguments and Switches.......... 25
X 3.2.1 Non-Switch Arguments................. 25
X 3.2.2 <tel-number>......................... 25
X 3.2.3 <logical>............................ 26
X 3.2.4 <arg>................................ 26
X 3.2.5 -l................................... 26
X
X
X
X - i -
X
X
X
X
X
X
X
X
X
X
X
X 3.2.6 -f................................... 26
X 3.2.7 -e, -o............................... 26
X 3.2.8 -p <procname>........................ 27
X 3.2.9 -d................................... 27
X 3.2.10 -D................................... 27
X 3.2.11 -t................................... 27
X 3.2.12 -A................................... 27
X 3.2.13 -N................................... 27
X 3.3 Environment Variables........................ 28
X 3.3.1 ECUPROMPT............................ 28
X 3.3.2 ECUHELP.............................. 28
X
X 4. Interactive Mode Commands.......................... 29
X 4.1 AX : ascii char to hex/oct/dec............... 29
X 4.2 BAud : set/display line baud rate............ 29
X 4.3 BN : all console event alarm................. 29
X 4.4 BReak : send break to remote................. 30
X 4.5 CD : change current directory................ 30
X 4.6 DA : decimal to ascii char................... 31
X 4.7 Dial : dial remote destination............... 31
X 4.7.1 Alternate Dialing Directory.......... 31
X 4.7.2 Multi-Number Redial Cycle............ 32
X 4.7.3 Automatic Dialing/Login
X Procedure............................ 32
X 4.8 DO : perform procedure....................... 33
X 4.9 DUplex : set/display duplex.................. 33
X 4.10 EXit : drop carrier, exit program............ 34
X 4.11 FI : send text file to line.................. 34
X 4.12 FKey : function key definition............... 35
X 4.13 HAngup : hang up modem....................... 36
X 4.14 HElp : invoke help........................... 36
X 4.15 LLp : set session log to /dev/lp............. 36
X 4.16 LOFf : turn off session logging.............. 36
X 4.17 LOG : session logging control................ 36
X 4.18 NL : display CR/LF mapping................... 37
X 4.19 NLIn : set receive CR/LF mapping............. 37
X 4.20 NLOut : set transmit CR/LF mapping........... 37
X 4.21 OA : octal to ascii char..................... 38
X 4.22 PARity : set/display line parity............. 38
X 4.23 PId : display process ids.................... 38
X 4.24 PLog : procedure logging..................... 38
X 4.25 POpd : pop to previous directory............. 39
X 4.26 PTrace : control procedure trace............. 39
X 4.27 PUshd : push to new directory................ 39
X 4.28 PWd : print working directory................ 40
X 4.29 REDial : redial last number.................. 40
X 4.30 REV : ECU revision/make date................. 40
X 4.31 RK : receive via C-Kermit.................... 41
X 4.32 RS : receive via SEAlink..................... 41
X 4.33 RTScts : control RTS/CTS flow control........ 41
X 4.34 RX : receive via XMODEM/CRC.................. 42
X
X
X
X - ii -
X
X
X
X
X
X
X
X
X
X
X
X 4.35 RY : receive via YMODEM Batch................ 42
X 4.36 RZ : receive via ZMODEM/CRC32................ 42
X 4.37 SDNAME : select screen dump file name........ 43
X 4.38 SK : send via C-Kermit....................... 43
X 4.39 SS : send via SEAlink........................ 43
X 4.40 STat : connection status..................... 44
X 4.41 SX : send via XMODEM/CRC..................... 44
X 4.42 SY : send via YMODEM Batch................... 45
X 4.43 SZ : send via ZMODEM/CRC32................... 45
X 4.44 TIme : time of day........................... 46
X 4.45 TTy : console tty name....................... 46
X 4.46 XA : hex to ascii char....................... 46
X 4.47 XON : xon/xoff flow control.................. 47
X 4.48 ! : execute shell............................ 47
X
X 5. Procedures......................................... 48
X 5.1 Procedures................................... 48
X 5.2 Line Syntax (Labels, Commands and
X Comments).................................... 48
X 5.3 Arguments.................................... 49
X 5.3.1 Switches............................. 49
X 5.3.2 Alphabetic Tokens.................... 49
X 5.3.3 Integers............................. 49
X 5.3.3.1 Constants 49
X 5.3.3.2 Variables 50
X 5.3.3.3 Functions 50
X 5.3.3.4 Expressions 50
X 5.3.3.5 Relational Operators 51
X 5.3.4 Strings.............................. 51
X 5.3.4.1 Constants 51
X 5.3.4.2 Variables 51
X 5.3.4.3 Functions 52
X 5.3.4.4 Expressions 52
X 5.3.4.5 Relational Operators 52
X 5.4 Commands..................................... 52
X 5.4.1 baud................................. 52
X 5.4.2 break................................ 53
X 5.4.3 cd................................... 53
X 5.4.4 clrx................................. 54
X 5.4.5 cls.................................. 54
X 5.4.6 color................................ 54
X 5.4.7 continue............................. 54
X 5.4.8 cursor............................... 55
X 5.4.9 delline.............................. 56
X 5.4.10 dial................................. 56
X 5.4.11 do................................... 57
X 5.4.12 duplex............................... 57
X 5.4.13 echo................................. 58
X 5.4.14 eeol................................. 58
X 5.4.15 else................................. 58
X 5.4.16 exit................................. 60
X
X
X
X - iii -
X
X
X
X
X
X
X
X
X
X
X
X 5.4.17 expresp.............................. 61
X 5.4.18 fchmod............................... 62
X 5.4.19 fclose............................... 62
X 5.4.20 fdel................................. 62
X 5.4.21 fgetc................................ 63
X 5.4.22 fgets................................ 63
X 5.4.23 fkey................................. 64
X 5.4.24 flush................................ 64
X 5.4.25 fopen................................ 64
X 5.4.26 fputc................................ 65
X 5.4.27 fputs................................ 65
X 5.4.28 fseek................................ 66
X 5.4.29 getf................................. 66
X 5.4.30 gosub................................ 66
X 5.4.31 gosubb............................... 67
X 5.4.32 goto................................. 67
X 5.4.33 gotob................................ 68
X 5.4.34 hangup............................... 68
X 5.4.35 hexdump.............................. 68
X 5.4.36 home................................. 69
X 5.4.37 icolor............................... 69
X 5.4.38 ifi.................................. 69
X 5.4.39 ifs.................................. 70
X 5.4.40 lbreak............................... 70
X 5.4.41 lgets................................ 70
X 5.4.42 insline.............................. 71
X 5.4.43 logevent............................. 71
X 5.4.44 lookfor.............................. 71
X 5.4.45 mkvar................................ 72
X 5.4.45.1 Variable Names 72
X 5.4.45.2 Variable Life and
X Scope 72
X 5.4.45.3 String Variable Size 73
X 5.4.46 nap.................................. 73
X 5.4.47 nice................................. 73
X 5.4.48 parity............................... 74
X 5.4.49 pclose............................... 74
X 5.4.50 plog................................. 74
X 5.4.51 popd................................. 75
X 5.4.52 popen................................ 75
X 5.4.53 prompt............................... 76
X 5.4.54 ptrace............................... 76
X 5.4.55 pushd................................ 77
X 5.4.56 putf................................. 77
X 5.4.57 return............................... 77
X 5.4.58 rk................................... 78
X 5.4.59 rlog................................. 78
X 5.4.60 rname................................ 79
X 5.4.61 rs................................... 79
X 5.4.62 rtscts............................... 79
X 5.5 Integer Functions............................ 80
X
X
X
X - iv -
X
X
X
X
X
X
X
X
X
X
X
X 5.5.1 %argc................................ 80
X 5.5.2 %baud................................ 80
X 5.5.3 %colors.............................. 80
X 5.5.4 %cols................................ 81
X 5.5.5 %conn................................ 81
X 5.5.6 %curx................................ 82
X 5.5.7 %cury................................ 82
X 5.5.8 %csec................................ 82
X 5.5.9 %ctoi................................ 82
X 5.5.10 %esecs............................... 82
X 5.5.11 %fatime.............................. 82
X 5.5.12 %fmode............................... 83
X 5.5.13 %fmtime.............................. 83
X 5.5.14 %fmode............................... 83
X 5.5.15 %ftell............................... 84
X 5.5.16 %instr............................... 84
X 5.5.17 %ischr............................... 84
X 5.5.18 %isdir............................... 85
X 5.5.19 %isreg............................... 85
X 5.5.20 %len................................. 86
X 5.5.21 %lgetc............................... 86
X 5.5.22 %lines............................... 86
X 5.5.23 %nice................................ 86
X 5.5.24 %pid................................. 86
X 5.5.25 %match............................... 87
X 5.5.26 %mhack............................... 87
X 5.5.27 %rchr................................ 88
X 5.5.28 %rchrc............................... 88
X 5.5.29 %rinstr.............................. 88
X 5.5.30 %shmid............................... 88
X 5.5.31 %stoi................................ 89
X 5.5.32 %uid................................. 89
X 5.5.33 %xchr................................ 89
X 5.5.34 %xchrc............................... 89
X 5.6 String Functions............................. 89
X 5.6.1 %argv................................ 89
X 5.6.2 %basename............................ 90
X 5.6.3 %cgetc............................... 91
X 5.6.4 %cgets............................... 91
X 5.6.5 %chr................................. 91
X 5.6.6 %date................................ 91
X 5.6.7 %datez............................... 91
X 5.6.8 %day................................. 91
X 5.6.9 %dayz................................ 92
X 5.6.10 %dir................................. 92
X 5.6.11 %dirpart............................. 92
X 5.6.12 %edate............................... 92
X 5.6.13 %envvar.............................. 93
X 5.6.14 %errstr.............................. 93
X 5.6.15 %etime............................... 94
X 5.6.16 %filepart............................ 94
X
X
X
X - v -
X
X
X
X
X
X
X
X
X
X
X
X 5.6.17 %fmodestr............................ 94
X 5.6.18 %itos................................ 94
X 5.6.19 %left................................ 95
X 5.6.20 %line................................ 96
X 5.6.21 %logname............................. 96
X 5.6.22 %mid................................. 96
X 5.6.23 %month............................... 96
X 5.6.24 %rdesc............................... 96
X 5.6.25 %right............................... 97
X 5.6.26 %rname............................... 97
X 5.6.27 %rtelno.............................. 97
X 5.6.28 %time................................ 97
X 5.6.29 %times............................... 97
X 5.6.30 %timez............................... 98
X 5.6.31 %timezs.............................. 98
X 5.6.32 %tty................................. 98
X 5.7 Special Procedures........................... 98
X 5.7.1 _rc.ep............................... 98
X 5.7.2 _connect.ep.......................... 99
X 5.7.3 _connfail.ep......................... 100
X 5.7.4 _hangup.ep........................... 101
X 5.8 HoneyDanBer UUCP Interface................... 101
X 5.8.1 UUCP Control Files................... 101
X 5.8.1.1 /usr/lib/uucp/Devices 101
X 5.8.1.2 /usr/lib/uucp/Dialers 101
X 5.8.1.3 /usr/lib/uucp/Sysfiles 101
X 5.8.1.4 /usr/lib/uucp/Systems 101
X 5.8.2 Choosing a Dialout Line.............. 102
X 5.8.3 Getty Interface...................... 103
X 5.8.4 UUCP Dialer Programs................. 103
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 - vi -
X
X
X
X
SHAR_EOF
echo 'File doc/ecu.man is complete' &&
$TOUCH -am 0725045191 'doc/ecu.man' &&
chmod 0644 doc/ecu.man ||
echo 'restore of doc/ecu.man failed'
Wc_c="`wc -c < 'doc/ecu.man'`"
test 184389 -eq "$Wc_c" ||
echo 'doc/ecu.man: original size 184389, current size' "$Wc_c"
rm -f _shar_wnt_.tmp
fi
# ============= doc/exits.man ==============
if test -f 'doc/exits.man' -a X"$1" != X"-c"; then
echo 'x - skipping doc/exits.man (File already exists)'
rm -f _shar_wnt_.tmp
else
> _shar_wnt_.tmp
echo 'x - extracting doc/exits.man (Text)'
sed 's/^X//' << 'SHAR_EOF' > 'doc/exits.man' &&
X
X
X
X - 1 -
X
X
X
X ECU 3.10
X
X (Extended Call Utility)
X
X
X
X
X
X
X Professional and Engineering
X Asynchronous Communications Package
X for UNIX and XENIX System V
X
X
X
X
X
X
X
X
X
X
X
X
X Warren H. Tucker, III <wht@n4hgf.Mt-Park.GA.US>
X
X
X
X
X
X
X Exit Codes
X Revision 3.10
X 7/25/91
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X Public Domain by wht@n4hgf 7/25/91
X
X
X
X
X
X
X
X ECU Exit Codes 1
X
X
X
X 1. Exit Codes
X
X
X When ECU exits (terminates execution), it uses a code from the following
X table:
X
X OK 0 no error
X SIG1 1 SIGHUP (signal 1)
X SIGN 64 signal 64 - see below
X LINE_READ_ERROR 129 could not read from attached line
X XMTR_WRITE_ERROR 130 could not write to attached line
X XMTR_LOGIC_ERROR 131 software logic error
X BSD4_IOCTL 132 not currently used
X SHM_ABL 133 not currently used
X SHM_RTL 134 not currently used
X NO_FORK_FOR_RCVR 135 could not fork receiver process
X TTYIN_READ_ERROR 136 could not read from console
X LINE_OPEN_ERROR 137 could not attach (open) requested line
X PWENT_ERROR 138 error in /etc/passwd processing
X USAGE 139 command line syntax error
X CONFIG_ERROR 140 missing or erroroenous configuration file
X INIT_PROC_ERROR 192 initial procedure terminated in error
X USER1 193 exit procedure command called with 1
X USERN 223 exit procedure command called with 31
X
X
X The logical names 'SIG1' and 'SIGN' refer to a range of error codes
X signifying ecu termination due to a signal. A larger range (64) is
X reserved than is necessary to handle reasonable expansion of SIG values
X in the OS. Not all signals will be reported in this manner. ECU will
X never report status 9 (signal 9, SIGKILL), for instance.
X
X The logical names 'USER1' and 'USERN' refer to a range of error exits
X codes reserved for use by the 'exit' procedure command. See the
X description of this command for more information.
X
X For ecu friend code, formal C #define identifiers for exit codes may be
X found in ecuhangup.h and consist of the above logical names prefixed
X with 'HANGUP_'.
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X Public Domain by wht@n4hgf 7/25/91
X
X
X
X
SHAR_EOF
$TOUCH -am 0725045191 'doc/exits.man' &&
chmod 0644 doc/exits.man ||
echo 'restore of doc/exits.man failed'
Wc_c="`wc -c < 'doc/exits.man'`"
test 2201 -eq "$Wc_c" ||
echo 'doc/exits.man: original size 2201, current size' "$Wc_c"
rm -f _shar_wnt_.tmp
fi
rm -f _shar_seq_.tmp
echo You have unpacked the last part
exit 0
--------------------------------------------------------------------
Warren Tucker, TuckerWare emory!n4hgf!wht or wht@n4hgf.Mt-Park.GA.US
Hacker Extraordinaire d' async PADs, pods, proteins and protocols
exit 0 # Just in case...
--
Kent Landfield INTERNET: kent@sparky.IMD.Sterling.COM
Sterling Software, IMD UUCP: uunet!sparky!kent
Phone: (402) 291-8300 FAX: (402) 291-4362
Please send comp.sources.misc-related mail to kent@uunet.uu.net.
