ecu - SCO XENIX V/{2,3}86 Extended CU part 37/47

[Warren Tucker]

---- Cut Here and unpack ----
#!/bin/sh
# this is part 37 of a multipart archive
# do not concatenate these parts, unpack them in order with /bin/sh
# file doc/_features.txt continued
#
CurArch=37
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/_features.txt"
sed 's/^X//' << 'SHAR_EOF' >> doc/_features.txt
X(having the '.ep' extension).
X
X.*s 2 "Lock Files"
X
XECU maintains lock files in /usr/spool/uucp in accordance with
Xthe HoneyDanBer UUCP conventions.
XLock files are created for both device names of a line.  For
Xexample, both LCK..tty1A and LCK..tty1a are created when
X/dev/tty1a OR /dev/tty1A is selected.
XSee the later section titled "HoneyDanBer UUCP Interface".
X
X.*s 2 "Dial-In/Dial-Out Line Support"
X
XECU works with the SCO getty to support dialing out on a line
Xenabled for login.  After use of the line is complete,
XECU signals the system to restore incoming call status to
Xthe line.
XSee the later section titled "HoneyDanBer UUCP Interface".
X
X.*s 2 "Tools"
X
XCommands are provided for conversion of hexadecimal or decimal numbers
Xto and from ASCII equivalents.  For example, 26(10) == 0x1a == ^Z == SUB.
X
SHAR_EOF
echo "File doc/_features.txt is complete"
chmod 0644 doc/_features.txt || echo "restore of doc/_features.txt fails"
echo "x - extracting doc/_hdb.txt (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/_hdb.txt &&
X.*s 2 "HoneyDanBer UUCP Interface"
X
X.*s 3 "UUCP Control Files"
X
X.*s 4 "/usr/lib/uucp/Devices"
X
XECU reads this file to determine what tty devices are available
Xfor outgoing calls.  For more information, see "UUCP Dialers"
Xand "Choosing a Dialout Line" below.
X
X.*s 4 "/usr/lib/uucp/Dialers"
X
XNo use is made of the
X.B Dialers
Xfile at this time.  ECU is capable
Xof calling a modem dial program, but not of using the HDB dialer
Xstrings found in
X.B Dialers .
X
X.*s 4 "/usr/lib/uucp/Systems"
X
XNo use is made of the
X.B Systems
Xfile at this time.  ECU provides the
Xequivalent function with its dialing directory.
X
X.*s 3 "Choosing a Dialout Line"
X
XWhen using the interactive
X.B dial
Xcommand, or when dialing from the initial menu,
Xif a logical or system name is specified, the directory
Xentry is fetched and examined.  If the tty field specifies
Xa value other than "Any", the specific line requested is
Xopened, if available, and dialing commences. 
XIf the specified line is not available, the dial attempt\
Xfails.
X
XIf "Any" is found in the dialing directory entry, then
XECU finds an avaialable line which matches the baud rate
Xspecified in the entry.  It does so by reading the
X.B Dialers
Xfile.
X
XIf a line matching the necessary baud rate is found (by
Xsearching /etc/utmp) to be a line enabled for login, but
Xwhich is currently idle, the getty interface, described below,
Xis used to acquire the line for outgoing use.
X
X.*s 3 "Getty Interface"
X
XWhen an idle dialin (enabled) line is chosen for dialout,
XECU makes use of
X.B /usr/lib/ecu/ecuungetty
Xto signal the line's getty to release the line.
X.B Ecuungetty
Xis again employed to signal the getty to reacquire the
Xline when outgoing communication is complete.
X
XEcuungetty is a privileged program, which must be owned by root
Xand have the setuid-on-execute bit set.  A encrypted id is passed
Xby ecu to ecuungetty to validate requests and to prevent abuse of
Xecuungetty by hackers, malcontents and other twentieth-century
Xphenomena.
X
X.*s 3 "UUCP Dialers"
X
XIf the
X.B Devices
Xfile can be found in /usr/lib/uucp,
Xand a valid entry for the attached line can be found,
XECU will use the dialer program specified in the
X.B Devices
Xentry.
SHAR_EOF
chmod 0644 doc/_hdb.txt || echo "restore of doc/_hdb.txt fails"
echo "x - extracting doc/_icmd.txt (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/_icmd.txt &&
X.*s 1 "Interactive Mode Commands"
X
XThe following is a partial list of commands available in the
Xinteractive (non-procedure) mode.
XIt is not necessary to
Xto enter the entire command in most cases.  The portion of
Xeach command which must be entered is capitalized in the
Xfollowing section headers.
X
X
X.*s 2 "ANsi"
X.DS L
Xusage: ansi [ on | off ]
X.DE
X
XThis command controls ECU's ansi filter.  MS-DOS-based
Xsystems use non-standard video display control sequences
X(SGR - Set Graphics Rendition).  Also, the "Save Cursor
XPosition" and "Restore Cursor Position" sequences supported
Xby MS-DOS are not part of ANSI X3.64, either.  When the ansi
Xfilter is on, these nonstandard sequences are emulated (at
Xsome cost in CPU overhead in the receiver process).  The
Xfilter state is normally on.  When using ECU on
Xcommunications lines running at baud rates above 2400 baud,
Xif you do not need it, you may wish to turn off the filter
Xto increase throughput and reduce CPU overhead.  Issuing the
Xcommand with no argument shows the current filter state.
X
XThe ANSI filter is turned on when ECU begins executing.
X
X.*s 2 "AX : ascii char to hex/oct/dec"
X.DS L
Xusage: ax [<param>]
X.DE
X
X<param> may be a single ASCII character, a standard ASCII
Xidentifier (such as ETX), or a two-character control
Xcharacter identifier (such as ^C, typed as a caret followed
Xby a C).
X
XIf no argument is supplied, a table of control characters
Xis printed containing decimal, octal, hex, ASCII identifiers
Xand two-character control character identifier.
X
X
X.*s 2 "BAud : set/display line baud rate"
X.DS L
Xusage: baud [<baud-rate>]
X.DE
X
X<baud-rate>, if specified, must be taken from the values
X110, 300, 600, 1200, 2400, 4800, 9600, 19200 and 38400.  On
Xsome systems, 19200 and 38400 may not be supported.  If baud
Xrate 110 is selected, 2 stop bits are automatically
Xspecified; other baud rates set 1 stop bit.  If <baud-rate>
Xis not supplied, the current baud rate is displayed.
X
XThe setting may be automatically changed as the result of a 'dial'
Xcommand.  See also the
X.B dial
Xand
X.B parity
Xcommand descriptions.
X
X
X.*s 2 "BN : all console event alarm"
X.DS L
Xusage: bn [ 0 | 1 | 2 ]
X.DE
X
X"bell notify":
XIf no argument is supplied, the current setting is
Xdisplayed.  Specifying 0 disables the facility; 1 causes an
Xaudible alarm to be sounded on all of the XENIX virtual
Xconsoles upon receipt of a bell (0x07) character from the
Xremote system; 2 causes an audible alarm to be sent to all
Xconsoles upon receipt of ANY characters from the remote
Xsystem.  A non-zero value also causes an audible alarm to be
Xsent to all console upon the successful completion of a 'redial'
Xcommand which must retry more than one redial
Xattempt or upon completion of a file transfer operation.
X
XDifferent alarms are sent depending upon the the type of
Xevent causing the alarms.
X
XBN is set to 1 when ECU begins executing.
X
X.*s 2 "BReak : send break to remote"
X.DS L
Xusage: break
X.DE
X
XThis command sends a break signal to the remote system.
X
X
X.*s 2 "CD : change current directory"
X.DS L
Xusage: cd [<dir-path>]
X.DE
X
XThis command allows you to change the working directory of
Xthe ECU process.  If <dir-path> is supplied, the previous
Xworking directory is displayed, and <dir-path> is made the
Xnew working directory.  A history of previous directory
Xchanges is maintained.  Entering the
X.B cd
Xcommand shows the numbered history list and allows you to select a new
Xdirectory by entering the number.  Other commands allow
Xdeletion of directories from the list or saving the list to
Xfile ~/.ecuphone.  This file is automatically read at ECU
Xstartup, providing a convenient list of directories
Xavailable for quick selection.
X
X
X.*s 2 "DA : decimal to ascii char"
X.DS L
Xusage: da [<decimal-val>]
X.DE
X
X<decimal-val> is a decimal value between 0 and 0377; the
Xparity (sign) bit is stripped and the equivalent ASCII
Xcharacter value is displayed.
X
XIf no argument is supplied, a table of control characters
Xis printed containing decimal, octal, hex, ASCII identifiers
Xand two-character control character identifier.
X
X
X.*s 2 "Dial : dial remote destination"
X.DS L
Xusage: dial [<dial-param>]
X.DE
X
X<dial-param> may take one of two forms, a telephone number
Xto dial or a logical name which can be found in the user
Xphone directory (in file ~/.ecuphone).
X
XIf a telephone number is supplied, the phone number is
Xdialed; you must first have set the desired baud rate and
Xparity using the
X.B baud
Xand
X.B parity
Xcommands.
X
XIf a logical name is entered, the phone directory is searched;
Xif the entry is found, the baud rate and parity
Xis automatically set.
XIf a procedure file can be found in the current directory
Xor the users home .ECU subdirectory whose name matches
Xthe logical name, then the procedure is executed with
Xthe argument '!INTERACTIVE'.
X
X
XIf <dial-param> is not supplied, then a screen-oriented
Xself-documenting directory manager is executed; you may
Xscan the the directory to select a number to dial, as well
Xas add, remove and edit entries.
XUpon dialing from the menu,
Xif a procedure file can be found in the current directory
Xor the users home .ECU subdirectory whose name matches
Xthe logical name, then the procedure is executed with
Xthe argument '!MENU'.
X
X
X.*s 2 "DO : perform procedure"
X.DS L
Xusage: do <procname> [<arg> ... ]
X.DE
X
XPerform ECU procedure.  Ecu searches for <procname>.ep in
Xthe current directory.  If the file is not found, the program
Xlooks for the file in the ~/.ECU directory.  One or more
Xarguments may be passed to the procedure
X
X
X.*s 2 "DUplex : set/display duplex"
X.DS L
Xusage: duplex [ Full | Half ]
X.DE
X
XThis command specifies whether or not ECU is to locally echo
Xcharacters typed by you at the keyboard.  The overwhelming
Xmajority of remote systems provide the echo function, in
Xwhich case full duplex must be used.  For the rare occasions
Xwhen the remote system does not echo your keyboard input,
Xsetting half duplex will allow you to see what you are
Xtyping.
X
XWhen communicating with another terminal in a "teletype
Xconversation", setting half duplex is generally required.
XIn such cases, use of the 
X.B nl ,
X.B nlin
X.R
Xand
X.B nlout
Xcommands may also be required.
X
XThe default setting for duplex is full.
X
X
X.*s 2 "EXit : drop carrier, exit program"
X.DS L
Xusage: exit
X.DE
X
XThis command terminates ECU promptly.  If your modem does
Xnot drop carrier upon loss of Data Terminal Ready (DTR),
Xthe command will terminate ECU,
Xbut may leave the communications line off hook.
XIt is strongly recommended that you configure your
Xmodem to hang up the phone line when DTR drops.  A shorthand
Xversion of this command exists: '.' is equivalent to 
X.B exit .
X
X
X.*s 2 "FI : send text file to line"
X.DS L
Xusage: fi [<filename>]
X.DE
X
X"file insert": This command causes file characters to be
Xinserted into the transmit data stream as though they had
Xbeen entered at the keyboard.  If <filename> is not entered
Xon the command line, a prompt for the filename is made.
XOnce the filename has been entered and file has been opened,
Xyou are asked whether the file should be transmitted at full
Xspeed or by a single line at a time.  Some remote systems
Xare not capable of receiving large amount of data (referred
Xto as "streaming data") without pauses.  By specifying
Xsingle line transmission, it is possible to increase the
Xlikelihood of proper receipt.  Even with "full" speed
Xtransmission, some "pacing" (inter-character delay) is
Xintroduced to ease loading on the remote system.  With
X"single" line transmission, you must press the space key to
Xinitiate sending each next line.  Pressing the 's' key stops
Xthe transfer.  Pressing the interrupt key (DEL) stops a full
Xspeed transmission.
X
X
X.*s 2 "FKey : function key definition"
X.DS L
Xusage: fkey [<keyset_name>]
X.DE
X
XThis command allows the mapping of function keys F1-F12,
XPgUp, PgDn, End and Ins and the cursor up, down, left and
Xright keys to emit a desired sequence of characters when a
Xfunction key is pressed.  <keyset_name> specifies which key
Xset in ~/.ecukeys is to be selected: Sample entry in .ecukeys:
X.DS I
Xhayes
X    F1:escape:+ + +
X    F2:autoans:A T S 0 = 1 cr
X    F3:dial:A T D T
Xbbs
X    F1:cancel:^K
X    F2:yes:y cr
X.DE
X
XIf a keyset_name matches a logical dial directory name, it
Xis loaded when the number is dialed.
X
X
X.*s 2 "HAngup : hang up modem"
X.DS L
Xusage: hangup
X.DE
X
XThis causes a Hayes modem command sequence to be sent to
Xterminate any outstanding connection (+++, pause, ATH).
X
X
X.*s 2 "HElp : invoke help"
X.DS L
Xusage: help [<cmd-name>]
X.DE
X
XIssuing this command with no argument displays a list of
Xcommands followed by a request for a command for further
Xinformation.
X
X
X.*s 2 "LLp : set session log to /dev/lp"
X.DS L
Xusage: llp
X.DE
X
XThis command is available only in XENIX versions.  It is a
Xshorthand version of 'log /dev/lp'.  /dev/lp must not be
Xunder the control of a print spooler.
X
X
X.*s 2 "LOFf : turn off session logging"
X.DS L
Xusage: loff
X.DE
X
XThis command is shorthand for 'log off'.  If session logging
Xis active, it is turned off.
X
X
X.*s 2 "LOG : session logging control"
X.DS L
Xusage: 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.DE
X
XThis command controls session logging; issuing the command
Xwith no argument causes the status of session logging to be
Xdisplayed.  The special argument 'off' causes active logging
Xto be terminated.  Other argument values cause logging to
Xstart using the argument as a filename.  Issuing a 
X.B log
Xcommand with a filename when logging is already active causes the
Xprevious file to be closed and the new file to be opened.
XSwitches are meaningful only when used in conjunction with a
Xfilename to start logging.
X
X
X.*s 2 "NL : display CR/LF mapping"
X.DS L
Xusage: nl
X.DE
X
XDisplay the current setting of CR/LF mapping.  For more
Xinformation, refer to the
X.B nlin
Xand
X.B nlout
Xcommand descriptions.
X
X
X.*s 2 "NLIn : set receive CR/LF mapping"
X.DS L
Xusage: nlin [<y-n>]
X.DE
X
XThis command controls whether or not a newline (NL/LF)
Xcharacter is sent to the screen upon receipt of a carriage
Xreturn (CR) from the remote system.  Most remote computers
Xsupply a NL after CR.  When communicating with another
Xterminal in a "teletype conversation", this is generally not
Xthe case (see also the 
X.B duplex
Xcommand).
X
XIssuing the command without <y-n> causes the current setting
Xto be displayed.  The format of <y-n> is flexible: 'y' or '1'
Xenables appending NL to CR, 'n' or '0' causes the
Xfeature to be disabled.
X
X
X.*s 2 "NLOut : set transmit CR/LF mapping"
X.DS L
Xusage: nlout [<y-n>]
X.DE
X
XThis command controls whether or not a newline (NL/LF)
Xcharacter is sent to the remote system upon transmission of
Xa carriage return (CR) entered by the keyboard.  Most remote
Xcomputers do not require (indeed "dislike") a NL after CR.
XWhen communicating with another terminal in a "teletype
Xconversation", this is generally not the case (see also the
X.B duplex
Xcommand).
X
XIssuing the command without <y-n> causes the current setting
Xto be displayed.  The format of <y-n> is flexible: 'y' or '1'
Xenables appending NL to CR, 'n' or '0' causes the
Xfeature to be disabled.
X
X
X.*s 2 "OA : octal to ascii char"
X.DS L
Xusage: oa [<octal-val>]
X.DE
X
X<octal-val> is a octal value between 0 and 0377; the parity
X(sign) bit is stripped and the equivalent ASCII character
Xvalue is displayed.
X
XIf no argument is supplied, a table of control characters
Xis printed containing decimal, octal, hex, ASCII identifiers
Xand two-character control character identifier.
X
X
X.*s 2 "PARity : set/display line parity"
X.DS L
Xusage: parity [ None | Even | Odd ]
X.DE
X
XThis command controls the parity of characters transmitted
Xby the keyboard.  Issuing the command with no argument
Xdisplays the current setting.  When the argument is
Xsupplied, only the first character is required.  Even or odd
Xparity implies seven data bits; no parity implies eight data
Xbits.  Parity of incoming characters is not checked.
X
XThe setting may be automatically changed as the result of an
Xinteractive or procedure
X.B dial
Xcommand.  See the 
X.B baud
Xand 
X.B dial
Xcommand descriptions.
X
X
X.*s 2 "PId : display process ids"
X.DS L
Xusage: pid
X.DE
X
XThis command displays the process id of the ECU transmitter
Xprocess, the ECU receiver process and the process ids of
XECU's parent and group.
X
X.*s 2 "PLog : procedure logging"
X.DS L
Xusage: ptrace [ <filename> | off]
X.DE
X
X.*s 2 "PTrace : control procedure trace"
X.DS L
Xusage: ptrace [ 0 | 1 | on | off]
X.DE
X
XThis command controls whether or not procedure execution is
Xto be traced. Trace output is written to
Xthe screen and varys in its nature depending
Xupon the command being traced.  Specifically,
Xany change to a string or integer variable
Xis noted.  If tracing is enabled, the output will also be
Xwritten to the procedure log file (see the
X.b plog
Xinteractive and procedure commands).
XIssuing the command with no argument shows current status.
X
X.*s 2 "PWd : print working directory"
X.DS L
Xusage: pwd
X.DE
X
XThis command prints the current working directory of the ECU
Xprocess.
X
X
X.*s 2 "REDial : redial last number"
X.DS L
Xusage: redial [<retry-count> [<pause-interval>]]
X.DE
X
XThis command redials a number previously dialed with the 'dial'
Xcommand.  Under non-XENIX versions, one dial attempt
Xis made.  Under XENIX versions, modem status is tested and
Xmultiple retries may be made.  <retry-count> specifies how
Xmany retries are to be made.  <pause-interval> specifies how
Xmany seconds the program pauses after a failure to connect.
XYou must specify <retry-count> in order to specify
X<pause-interval>.  The default value for <retry-count> is
X10, for <pause-interval> is 15.
X
XYou should know that in some jurisdictions, it is ILLEGAL to
Xdial the same telephone number more than a specified number
Xof times during some interval of time.  In any case,
Xspecifying <pause-interval> less than 15 seconds is silently
Xchanged to 15 seconds.
X
X
X.*s 2 "REV : ECU revision/make date"
X.DS L
Xusage: rev
X.DE
X
XThis command displays ECU's revision, the transmitter,
Xreceiver, parent and group process ids and the date and time
XECU was made.
X
X
X.*s 2 "RK : receive via C-Kermit"
X.DS L
Xusage: rk
X.DE
X
XThis command searches the PATH list for 'ckermit' (Columbia
XUniversity C-Kermit) and invokes it to receive files.
X
XThe file ~/.kermrc must be set up to have any desired
Xinitialization paraeters you desire.  Refer to C-Kermit
Xdocumentation for more information.
X
X
X.*s 2 "RS : receive via SEAlink"
X.DS L
Xusage: rs
X.DE
X
XThis command invokes a SEAlink receive protocol.
X
X
X.*s 2 "RX : receive via XMODEM/CRC"
X.DS L
Xusage: rx
X.DE
X
XThis command invokes ecurz to receive files from the remote
Xsystem using XMODEM/CRC.
X
XAfter entering the command, you are prompted as to whether
Xor not file CR/LF characters are to be converted to
Xnewlines.  If you are transferring text files from a system
Xwhich contain CR/LF line terminators, you must answer yes
Xto this question.  You should answer no when transferring
Xbinary files, such as executables, .arc files and the like.
XFile transfer progress is presented on a visual display.  To
Xabort the transfer, press your interrupt key (usually DEL
Xunless reset with stty(C)).
X
X
X.*s 2 "RY : receive via YMODEM Batch"
X.DS L
Xusage: ry
X.DE
X
XThis command invokes ecurz to receive files from the remote
Xsystem using YMODEM batch with CRC-16 error correction.  The
XYMODEM is "true YMODEM", not XMODEM-1k.  File transfer
Xprogress is presented on a visual display.  To abort the
Xtransfer, press your interrupt key (usually DEL unless reset
Xwith stty(C)).
X
X
X.*s 2 "RZ : receive via ZMODEM/CRC32"
X.DS L
Xusage: rz
X.DE
X
XThis command invokes ecurz to receive files from the remote
Xsystem using ZMODEM/CRC32.  File transfer progress is
Xpresented on a visual display.  To abort the transfer, press
Xyour interrupt key (usually DEL unless reset with stty(C)).
X
X
X.*s 2 "SDNAME : select screen dump file name"
X.DS L
Xusage: sdname [<filename>]
X.DE
X
XWhen the "cursor 5" key is pressed, the screen contents are
Xdumped to a file.  By default, this file is named '~/.ecu/screen.dump'.
XThis command either displays or changes the current screen
Xdump file name, depending upon whether or not a argument
Xis supplied.
X
XThe actions of this command have no effect on the
Xoperation of the
X.b scrdump
Xprocedure command.
X
X.*s 2 "SK : send via C-Kermit"
X.DS L
Xusage: sk [<file-list>]
X.DE
X
XThis command searches the PATH list for 'ckermit' (Columbia
XUniversity C-Kermit) and invokes it to send files.  The file
X~/.kermrc must be set up to have any desired initialization
Xparaeters you desire.
X
XAfter entering the command, you are prompted as to whether
Xor not file newline characters are to be converted to CR/LF.
XIf you are transferring text files to a system which
Xrequires CR/LF line terminators, you must answer yes to this
Xquestion.  You should answer no when transferring binary
Xfiles, such as executables, .arc files and the like.  You
Xare prompted to enter a list of files to send, which may
Xcontain one or more wildcard specifications.
X
XThe file ~/.kermrc must be set up to have any desired
Xinitialization arguments you desire.  Refer to C-Kermit
Xdocumentation for more information.
X
X
X.*s 2 "SS : send via SEAlink"
X.DS L
Xusage: ss [<file-list>]
X.DE
X
XThis command invokes a SEAlink file transmission protocol.
X.DS L
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.DE
X
X.*s 2 "STat : connection status"
X.DS L
Xusage: stat
X.DE
X
XThis command displays statistics about ECU usage.
XExample display:
X.DS L
XDate/time: 06-14-1988 11:40:35 (UTC 15:40)
XTotal chars transmitted: 178
XTotal chars received:    3681
X
XDate/time: 06-14-1988 14:41:24 (UTC 18:41)
XConnected to CompuHost (555-1234) at 14:40:57
XParameters: 2400-N-1 Connect time: 00:01:27
XTotal chars transmitted: 234 (since CONNECT 142)
XTotal chars received:    2278 (since CONNECT 1478)
X.DE
X
X.*s 2 "SX : send via XMODEM/CRC"
X.DS L
Xusage: sx [<file-name>]
X.DE
X
XThis command invokes ecusz to send a file to the remote
Xsystem using XMODEM/CRC.
X
XAfter entering the command, you are prompted as to whether
Xor not file CR/LF characters are to be converted to
Xnewlines.  If you are transferring text files from a system
Xwhich contain CR/LF line terminators, you must answer yes
Xto this question.  You should answer no when transferring
Xbinary files, such as executables, .arc files and the like.
X
XYou are prompted to enter a filename to send.  File transfer
Xprogress is presented on a visual display.  To abort the
Xtransfer, press your interrupt key (usually DEL unless reset
Xwith stty(C)).
X.DS L
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.DE
X
X.*s 2 "SY : send via YMODEM Batch"
X.DS L
Xusage: sy [<file-list>]
X.DE
X
XThis command invokes ecusz to send file(s) to the remote
Xsystem using YMODEM/CRC.
X
XYou are prompted to enter filename(s) to send, which may
Xconsist of one or more wildcard specifications.  File
Xtransfer progress is presented on a visual display.  To
Xabort the transfer, press your interrupt key (usually DEL
Xunless reset with stty(C)).
X.DS L
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.DE
X
X.*s 2 "SZ : send via ZMODEM/CRC32"
X.DS L
Xusage: sz [<file-list>]
X.DE
X
XThis command invokes ecusz to send file(s) to the remote
Xsystem using ZMODEM/CRC32.
X
XYou are prompted to enter filename(s) to send, which may
Xconsist of one or more wildcard specifications.  File
Xtransfer progress is presented on a visual display.  To
Xabort the transfer, press your interrupt key (usually DEL
Xunless reset with stty(C)).
X
XNote: if you specify sending only newer files and the remote
Xreceiver does not support the feature, it may skip (reject)
Xall your files.  Retry the transfer specifying 'N' to 'Transfer
Xonly newer files'.
X.DS L
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.DE
X
X.*s 2 "TIme : time of day"
X.DS L
Xusage: time
X.DE
X
XThis command displays the local date and time as well as the
Xcurrent UTC.
X
X.*s 2 "TTy : console tty name"
X.DS L
Xusage: tty
X.DE
X
XThis command displays the current console tty name.
X
X
X.*s 2 "XA : hex to ascii char"
X.DS L
Xusage: xa [<hex-val>]
X.DE
X
X<hex-val> is a hexadecimal value between 0 and FF; the
Xparity (sign) bit is stripped and the equivalent ASCII
Xcharacter value is displayed.
X
XIf no argument is supplied, a table of control characters
Xis printed containing decimal, octal, hex, ASCII identifiers
Xand two-character control character identifier.
X
X
X.*s 2 "! : execute shell"
X.DS L
Xusage: !
X       !<command>
X.DE
X
XThe '!' command is a shell escape.  The environment variable
XSHELL is read to determine what shell program to execute
X(e.g., /bin/sh, etc).  If '!' is entered by itself, an
Xinteractive shell is started; press ^D to exit back to ECU.
XIf <command> is supplied, it is executed by the shell with
Xan immediate return to ECU.
X
SHAR_EOF
chmod 0644 doc/_icmd.txt || echo "restore of doc/_icmd.txt fails"
echo "x - extracting doc/_intro.txt (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/_intro.txt &&
X.*s 1 "Introduction"
X
XECU (Extended Call Utility) is a personal communications program for
Xusers of XENIX System V on 80286 and 80386 systems.
XThis
Xpreliminary
Xdocument describes ECU functionality and
Ximplementation from a technical point of view.
X
XECU provides the classic terminal communications facility of
Xpassing keyboard data to a serial line and incoming data
Xto the computer video display.
XIn addition, a dialing directory, a function key mapping feature,
Xand session logging are available.
X
XA very flexible procedure (script) language is also
Xincorporated to automate many communications tasks.
XUsing shell scripts and ECU procedures, it is possible
Xto use ECU in an entirely "unattended" fashion for
Xbatch-style communications sessions.
X
XECU supports numerous file transfer protocols:
Xas of this writing, XMODEM, XMODEM/CRC,
XXMODEM-1K, YMODEM/CRC Batch, ZMODEM/CRC-16, ZMODEM/CRC-32,
XKermit and SEAlink are supported.
X
XThis document is only of a preliminary nature and is
X.B NOT
Xwell written.  It attempts to get
Xacross to the inquiring mind how ECU works.
XIn places,
Xan understanding of the UNIX programming model,
XXENIX and UUCP constructs and
Xasynchrononous communications techniques is assumed.
XIn other places, the document goes into tedious detail
Xabout the simplest of concepts.
SHAR_EOF
chmod 0644 doc/_intro.txt || echo "restore of doc/_intro.txt fails"
echo "x - extracting doc/_p_cmd.txt (Text)"
sed 's/^X//' << 'SHAR_EOF' > doc/_p_cmd.txt &&
X.*s 2 "Commands"
X
X.*s 3 "baud"
X
Xusage: baud <baud-int>
X
XThis command sets the baud rate for the attached line.
XThe integer argument <baud-int> must be one of
X110, 300, 600, 1200, 2400, 4800, 9600, 19200 and 38400.
X.DS L
XExample:
X    baud 9600
X    set $i0=2400; baud $i0
X.DE
X
X.*s 3 "break"
X
Xusage: break
X
XThis command is used inside a
X.B whilei
Xor
X.B whiles
Xcompound statement to exit the loop.
X.DS L
XExample:
X
X    whilei 1=1 #forever unless break command executed
X    {
X        echo -n 'Answer yes or no: '
X        set $s0=%cgets # get answer
X        ifi %instr($s0,'y') == 0 set $i0 = 1; break
X        ifi %instr($s0,'n') == 0 set $i0 = 0; break
SHAR_EOF
echo "End of part 37"
echo "File doc/_p_cmd.txt is continued in part 38"
echo "38" > 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.