PN 93000088K DigiFAX Software Release Notes Version 2.9.0 Software Package P/N 75000115K Software Package P/N 75000116K Software Package P/N 71000014A AIX Software Package P/N 71000015A AIX Diskette P/N 40000581K V2.9.0 (5.25", DigiFAX Single Channel) Diskette P/N 40000582K V2.9.0 (3.5", DigiFAX Single Channel) Diskette P/N 40000585K V2.9.0 (3.5", DigiFAX Multi Channel) Diskette P/N 40000584K V2.9.0 (5.25", DigiFAX Multi Channel) Diskette P/N 40001160A V2.9.0 (3.5", DigiFAX Single Channel AIX) Diskette P/N 40001161A V2.9.0 (3.5", DigiFAX Multi Channel AIX) Diskette P/N 40000588D V2.4.0 (3.5", FaxJet) Diskette P/N 40000587D V2.4.0 (5.25", FaxJet) Diskette P/N 40001166A V2.4.0 (3.5", FaxJet AIX) Software Manual P/N 92000143A (Installation) Software Manual P/N 92000144A (User's) Software Manual P/N 92000145A (Reference) INTRODUCTION These are the release notes for the DigiFAX software. They contain corrections and additional information not in the manual. Please read these notes before attempting to perform the installation procedure in the manual. DISKETTES All of the software diskettes included with this product are specially formatted to be readable by both tar and cpio. This means that they can be read using either the SCO XENIX or UNIX custom command, or by the installpkg command found on ISC, AT&T, Novell, Intel, Everex, and Dell versions of UNIX/386. Although your operating system may support installation of either of these types of formats, we recommend that you use the command shown in the following table to install the diskettes: Operating System Installation Command __________________________________________________________________ AT&T UNIX System V/386 Release 3.2.x installpkg Dell UNIX System V/386 Release 3.2.x installpkg Everex Esix System V/386 Release 3.2.x installpkg INTERACTIVE 386/ix Release 2.0.x sysadm installpkg INTERACTIVE UNIX System V/386 Release 3.2.x sysadm installpkg SCO XENIX System V/386 Release 2.3.2 custom SCO UNIX System V/386 3.2.x custom SCO Open Desktop Release 2.x custom - 1 - PN 93000088K DigiFAX Software Release Notes Version 2.9.0 Dell UNIX System V Release 4.0 installpkg Novell UnixWare 1.x (SVR4.2) installpkg IBM AIX 3.2 installp __________________________________________________________________ If you suspect that a diskette is bad, you can use the UNIX sum command to verify the diskette. All of the DigiFAX diskettes will report a sum of 65535. DigiFAX ships from the factory on 3.5" diskettes. 5.25" diskettes are no longer shipped by default. If you need 5.25" diskettes, they are available by calling DigiBoard Technical Support. UPGRADING FROM A PREVIOUS RELEASE If you are upgrading from a previous release, you should make copies of any of the shell scripts or configuration files which you have modified. The installation procedure will attempt to do this for you, but it can't hurt to make your own copies just in case. Note that in this release the default configuration that is stored in the file /usr/spool/fax/faxconfig is for a DigiCHANNEL FAX/1 board. Previous releases had the default configuration set for a single channel JT FAX 9600 board. You can overlay a new release of the software without removing the old release first. Make sure that the old server has been shut down before starting. On SCO only, you should also remove /etc/perms/digifax, and /etc/perms/faxjet before installing the new release. SIGNIFICANT CHANGES SINCE THE LAST RELEASE This release of DigiFAX contains the following major enhancements (a complete list of changes appears at the end of this document). o Support has been added for the new HP ScanJet IIcx scanner (HP Part Number 2507A) and its associated interface card (HP Part Number C2502A). See the section on scanning later in this document. o Support has been added for Greyscale tiff scanning. See the section on scanning later in this document. o Added support for Canon BubbleJet printers. - 2 - PN 93000088K DigiFAX Software Release Notes Version 2.9.0 SUPPORTED HARDWARE ___________________________________________________________________________________ |__________________________________________________________________________________| | FAX Boards DigiBoard DigiCHANNEL FAX/1 dfax | | DigiBoard DigiCHANNEL FAX/2 dfax | | Hayes JT FAX 9600B jfax | | Quadram JT FAX 9600B jfax | | Brooktrout TR111 [except on UNIX SVR4] bfax | | Brooktrout TR112 [except on UNIX SVR4] bfax | |__________________________________________________________________________________| |__________________________________________________________________________________| | Scanners Hewlett-Packard ScanJet hpsj | | Hewlett-Packard ScanJet Plus hpsj | | Hewlett-Packard ScanJet IIp,IIc, IIcx sjii | |__________________________________________________________________________________| | Graphics Displays EGA console | | VGA console | | Hercules (SCO only) console | |__________________________________________________________________________________| | Serial Terminals All models which have serial | | terminfo entries and do not | | have the ``magic cookie'' | | glitch where display | | attributes take up a screen | | location. | |__________________________________________________________________________________| DOCUMENTATION ERRATA The three volume set of manuals is current with this release. HINTS AND TIPS The hints and tips documents have been added to the manual set. In addition several examples and samples are provided in directory /usr/spool/fax/samples. These samples are described in the README file in that directory. TERMINALS If you intend on using serial terminals to access the menus and screens (faxdir and faxrcv), please note that the terminfo description must include the following attributes: smso/rmso, smul/rmul, rev, blink, sgr, and sgr0 (standout (a.k.a. reverse), underline, reverse, blink, normal). In addition, eight function keys and the cursor arrow keys are recommended. The /usr/lib/terminfo/keyconfig command can be used to add key definitions to a terminfo terminal - 3 - PN 93000088K DigiFAX Software Release Notes Version 2.9.0 description via an easy to use menu system. If function keys are not available on your terminal, you can press the _____ key followed by a number between 1 and 8 to simulate the ____ through ____ keys. On XENIX, the color capabilities of the menus are not supported. Whenever possible, an ANSI style terminal emulation, such as ansi or vt220, should be selected if your terminal hardware supports it. If using a VT-220 terminal or emulator, please consult the technical tips document which is attached. If you use the Wyse 60 terminal, check to see if you have the wy60ak terminfo description. If you do, it is preferable to set your TERM variable to that description. The wy60ak will temporarily reprogram the Wyse cursor keys to emit ANSI style escape sequences, allowing applications to differentiate between, say, the left arrow being pressed versus the backspace key. If the terminfo description for a particular terminal describes it as having automatic margins (line wraps at column 80), then the terminal should be setup to have this feature enabled. Otherwise, the screen display may be garbled. CONSOLE DISPLAYS There are two versions of the SCO UNIX console driver. Please consult the TERMOPTS(5) manual page for information on how to adjust your environment to handle whichever console driver you have. It may also be appropriate to set the TERMOPTS variable on other vendors UNIXes if they release new versions of their console driver which changes such as the ones that SCO has made. Some versions of the XENIX and UNIX VGA console drivers have a bug when a monochrome VGA display is attached. These console drivers refuse to allow programs to switch the console into graphics mode, such as for viewing FAXes. If this happens to you, the solution is to use a color VGA display, or to seek a bug fix from your UNIX vendor. ADDITIONAL DISPLAYS FOR PREVIEWING FAXES The Hercules monochrome graphics display card may be used to display FAXes on SCO UNIX and XENIX. The display mode number is 299 (e.g. FAXVIEWMODE=299). - 4 - PN 93000088K DigiFAX Software Release Notes Version 2.9.0 The Wyse 160 serial terminal may also be used to display FAXes, on any supported version of UNIX or XENIX. The display mode number to use for the Wyse is 160 (e.g. FAXVIEWMODE=160). For acceptable response, the Wyse terminal should be running at 57,600 baud or greater. In addition, the terminal must be in native (Wyse 160) mode with Enhance turned on. Receive flow control should be enabled and transmit flow control should be disabled in the terminal setup. SERIAL FAX MODEMS SUPPORTED This release now contains support for external SP-2388 (ersatz class 2) FAX modems. See the Addenda for the list of tested modems, and additional installation instructions. ADAPTEC SCSI DISK CONTROLLERS The Hayes JT FAX 9600B fax board and the Adaptec 154x series of bus mastering SCSI disk controllers are incompatible. HEWLETT-PACKARD SCANJET IIP SUPPORTED The Hewlett-Packard (HP) ScanJet IIp and IIc scanners using either the HP C1752-66500 or HP C2502A (dedicated SCSI) interface cards are now supported using the sjii device driver included with DigiFAX. Only one scanner is supported on the SCSI bus, and its ID must be set to two (2) (the factory default). Connection of the scanner to an existing third party SCSI adapter is not supported. The C2502A card (which has replaced the older C1752-66500 card) is IO mapped rather than memory mapped. In addition the new card has the ability to have it's IO address set via software, so there are no DIP switches on this board. Before installing either card, you will need to determine a suitable address for the card. The older C1752-66500 card requires 16k of memory space, that must be set using DIP swithces on the card itself. This is described below. The newer C2502A requires 16 bytes of IO space at one of the following locations: 280, 290, 300, 310, 320, 330, 340, or 350. Since there are no jumpers, the faxconfig program will ask you for the IO address to use and configure the kernel accordingly. No other configuration is required. The HP C1752-66500 interface card does not use interrupts or DMA. It has a dual port memory architecture requiring 16k of space in the C8000-E7FFF range. The following figure - 5 - PN 93000088K DigiFAX Software Release Notes Version 2.9.0 shows the DIP switch settings for the card. Depress the side of the switch where the is shown. ____________________________________________________ | | | | | | | | __D4000-D7FF__D0000-D3FFF__CC000-CFFF__C8000-CBFFF__ _1___2___3___1___2___3___41___2___3___1___2___3___4_ |___________|____________|___________|______________| |___________|____________|___________|_______________ ____________________________________________________ The sjii device driver which is provided is intended to be used by the faxscan program. Using the device driver to scan monochrome or dithered grayscale images at either FAX or 300x300 resolutions will cause less than a 10% load on the CPU. The driver is capable of reading and writing raw HP Scanner Command Langauge (SCL) escape sequences, if desired. Due to limitations with HP's interface board, using this device driver to perform color or undithered grayscale scans is not recommended (severe loading of the system will occur). GREYSCALE TIFF SCANNING The faxscan software has been enhanced to now support greyscale scanning when scanning in tiff format (greyscale scanning is incompatible with the FAX format). Use the -g flag to invoke greyscale scanning. This flag is ignored unless the -c compression_type is also present, signifying tiff format (since FAX format does not support compression). POSTSCRIPT PRINTER EMULATOR The GNU Ghostscript printer emulator is now provided in the package as an unsupported add-on for DigiFAX. This emulator is similar to the FaxJet HP LaserJet emulator, except that it accepts the PostScript language instead of PCL. WARNINGS FOR WORD PERFECT USERS Sites which have installed copies of Word Perfect 5.0 dated earlier than November, 1990 should be aware that when a printer is defined in this version of WordPerfect 5.0, WP will modify the UNIX line printer interface script in such a way as to break the script when more than one option flag is passed to the script. This is because WP will wrap the following around the shell script: - 6 - PN 93000088K DigiFAX Software Release Notes Version 2.9.0 # Please Do Not Remove or Move This Line, wpport uses it if [ $5 -a $5 = WP50 ] then /usr/wp/bin/wpp50 <$6 exit 0 else ... Your original printer interface script ... fi The problem with the above is that the arguments on the ``if'' statement are not quoted. To fix this, the system administrator must make the statement look like this: if [ "$5" -a "$5" = WP50 ] The printer interfaces are located in directory /usr/spool/lp/admins/lp/interfaces. If you use WP on your system, you should check and change any of the scripts that WP has modified. Later versions of WP 5.0 use a different scheme involving a ``for'' loop which does not break the printer interface scripts. SOFTWARE CHANGES This is a list of recent changes to the software: 2.8.0: March, 1994 faxsend: Added -m option for mail notification on a per fax basis faxconfig: fixed "=header" error message in Page Header on Xenix fax2pr: Added lj3-75 as possible printer type. class2opts: Allow specification of S7 value efax dvr: Added support for Class 2.0 modems. faxsrv,faxrun,faxsend,faxdir,faxrcv: Fixed problem with calculation of the start/end date for daylight savings time which was introduced in v2.7.0's new handling of the TZ variable. faxrun: Changed so that all signals, including SIGHUP, are set to default actions before exec'ing getty on a data call. 2.7.0: July, 1993 faxrun: Corrected problem with doing ioctl's on some SVR4.0's. Sympton: ATE0 command doesn't see "OK" response. faxrun: Added initcmd=COMMAND. See $SPOOLDIR/faxconfig for details. faxjet: Corrected problem handling PCL macros generated by MS Word. hpview: Corrected problem handling PCL macros generated by MS Word. samples: Added 8lpi2fax sample shell script imagecvt: Added reader for XPM, XPM2, and XPM3 formats. imagecvt: Added writer for B/W PCX output format. jfax dvr: Fixed Space.c for SVR4.2 (jfaxdevflag was undefined) faxview/faxrcv/faxdir: FAX viewer can now view arbitrarily long FAXes. faxdir: Fixed core dump that occurred when adding group members. dfax dvr: Added pulse overrides to Space.c - 7 - PN 93000088K DigiFAX Software Release Notes Version 2.9.0 faxrcv/faxdir: xfaxview is now run in background. faxcover: Added config option to allow faxjet to convert PCL covers. faxadmin: Added -r and -t flags to allow separate enable of rx/tx. faxadmin: Added -Z flag to gracefully shutdown the server faxsend: Changed to not wait if server is down. Send requests are successful anyway. Delete and kick requests will fail. faxadmin: Changed to not wait if server is down. faxstat: Changed to not wait if server is down. efax dvr: Fixed initial sync-up problem with PPI-2400FX96SA if modem wasn't configured for FCLASS=2. faxrcv: Fixed error -6 in post_menu if more than 999 FAXes are stored. faxsrv: If logging all attempts, don't log cumulative xmit time. faxdir: Fixed bug where it would send a FAX even if not all the file names listed are accessable. faxsend: Changed to avoid file link count limit with large numbers of destinations. faxsend: Added ability to delete ranges of FAXes; faxsend: Added ability to change priority, time and # of queued job. faxdir/faxrcv: patched tgetch.o to allow better escape sequence handling over a network. 2.6.0: 01/25/93 faxdir: fixed faxdir to put sender info on cover when -q is used. dfax drvr: changed DIS to 40 bits. dfax drvr: changed 'w' dial modifier to wait S7 seconds dfax drvr: if no carrier is received, now sends FTT frame fax2pr: added -Pletter_legal adaptive paper selection for lasers. faxsrv: puts an entry into txlog if job is deleted while tx'ing faxrun: corrected problem receiving multiple pages using the Brooktrout TR-11X fax cards. faxjet(v2.3.1): Ignore extraneous NUL's in print stream faxsrv/faxrun: Documented SP2388 faxmodem (ersatz class 2) support faxsrv/faxrun: Added data/fax line sharing for class 2 modems faxscan: Changed to avoid bug in HP ScanJet IIc scanner where scanner reported 215 bytes as the width of a scanline. sjii drvr: Corrected problem where legal-sized scans on IIc would report io error. faxsend: -u "" forces a cover sheet even if no other information is available -- for use when all cover sheet info is coming from environment variables. samples: Added mailfaxer sample for sendmail to fax integration. samples: Added text2landfax script showing how to fax wide text files in landscape mode using Laserjet emulation. dfax dvr: Changed so that positive values of Dial Tone wait parameter *require* dial tone to be present before dialing. Negative values blind dial after absolute-value(parameter) seconds. faxsrv: Changed so that a number is not dialed twice at the same time in a multiple channel system. Added "samenumber=1" config parameter to force the old way (useful for dialing into pools). - 8 - PN 93000088K DigiFAX Software Release Notes Version 2.9.0 2.5.0: 09/04/92 faxdir: Added -f option(s) to preload files list with pathnames faxdir: Added -q option to go directly to Quicker Send menu samples: Added informix.4gl sample showing how to integrate a typical database application with "faxdir". faxsend: Added FAXCOVER env. variable to override name of cover sheet creation program. Default is value 'faxcover'. faxrcv: Added hook for viewing with arbitrary program. dfax drv: Fixed problem where some failed receives would leave phone line off-hook. 2.4.2: 07/29/92 [Beta Test Version Only] faxsend: Places "to" number in environment for faxcover. faxdir/faxsend: Made more immune to corruption in /etc/utmp file when determining sender login name. imagecvt: Fixed bug when using -x, -X options with RGB images faxdir: Fixed core dump in Choose Group Member caused by 2.4.1 faxdir: Fixed limit in number of group members that can be handled by menus. faxrcv: Fixed passing print range options to faxprint faxpoll/faxanswer: Changed name of faxpoll to faxanswer all: Changed C-file and D-file names to start with c and d for compatibility with PC-NFS. faxprint: Changed to parse options using getopt. sjii drvr: Added device driver for HP ScanJet IIp/IIc interface board. faxscan: Changed to try opening both /dev/hpsj0 and /dev/sjii0 when no device is specified. 2.4.1: 06/18/92 faxrcv: Fixed bug that used a file descriptor for each showfax faxrcv: Added 'd' indicator when fax is saved. faxdir: Added "Quicker Send" temporary phone directory entry for sending with just a name and a fax#. faxrun: Rcv'd D file is kept mode 0600 while being received fax2ps: Added -cfax3 output option for Level 2 Postscript printers fax generators: changed to not pad RTC codes in some cases. Remove: fixed typos in remove script Remove: Added delete of ?88digifax from /etc/rc?.d faxdir/faxrcv: On Addamax UNIX SVR4, fixed to detect when operating under X-windows to displaying using xfaxview. imagecvt: Fixed infinite loop when page range is specified. imagecvt: Will always write multiple files when dstname contains a "%d" type printf specifier. dfax dvr: Changed response timeout to avoid problems with some fax machines. Sends two flags after each frame to make some machines happy. faxsrv: Added "logattempts" faxconfig option to log every attempt to the txlog. faxrun: Added 2nd %%02d (total pages) parameter to page header string to allow putting Page 1 of N on top of pages. - 9 - PN 93000088K DigiFAX Software Release Notes Version 2.9.0 2.4.0: 05/01/92 hpsj dvr: Fixed XENIX version to not fail after 50 scans. faxsend/faxnotify: Added list of source files in the job to the mail message sent by faxnotify. faxcover: Changed to use line drawing characters digiprintf: Added to package for use by faxcover faxsrv/faxnotify: Added retry warning after N retries faxsrv: Changed to remember retry count if stopped and restarted. faxstat: Added option to display phone #'s instead of nicknames faxsrv: Added option to log phone #'s in txlog instead of nicknames faxnotify: Added save to dead fax directory option dfax dvr: turned on echo cancellation tone, output level to -9.6dbm dfax dvr: allocates memory only when active dfax dvr: Extend T4 response period to 5 seconds to allow for fax machines on satellite links enough time to respond. dfax dvr: Changed pulse dialing interdigit pause to 1 second. viewers: Turn Wyse 160 Enhance Mode on if not already on Allows return from viewing even if enhance mode was off. tiff2fax: if -l option is on, and TIFF vertical resolution is greater than 75% of horizontal resolution, then overlay every other scan line. Otherwise, just mark it low res. faxconfig: Changed to compensate for weird XENIX 9-15 vector numbering scheme (fixes installing TR112 on XENIX). faxrcv: Added page range selection to print options faxrcv: Added 'd' mark for deleted FAXes (for terms w/o underline) jfax dvr: Fixed to operate properly on SVR4 faxdir: Fixed to allow Files Menu to place entry on Notes: field /etc/rc2.d/digifax: Added "fail-safe" to make device nodes in case buggy version of UNIX's idmkenv forgot to. all tiff: Changed to use rev 3.0 of TIFF library. faxjet(v2.3.0): Fixed register save problem which caused core dump faxjet(v2.3.0): Fixed problem handling raster graphics in macros 2.3.0: 12/24/91 faxconfig: Fixed getstr to handle 'q' properly Remove: Deleted extra "<" char in script fax2ps: Added -h,-f,-T options, fixed core dump on long pages faxdir: Added -l and -c options (defaults for res, cover sheet) faxdir: Added group menus and group send faxdir: Added Cover Sheet notes capability faxdir: Fixed File Menu to output full pathname faxsend: Added -n notesfile capability for cover sheet faxsend: fixed bug printing error msg for XSEQ faxsend: added 'u' line to C file listing -u user (for email gateway) faxsend/faxdir: Added $FAXPHONE and $FAXGROUP environment variables faxcover: completely reorganized for clarity; faxcover: better looking default cover sheets faxcover: added notesfile capability faxnotify: fixed to deal with imbedded quotes better faxpoll: added missing manual page for this program faxsrv: fixed imbedded quotes when calling faxnotify - 10 - PN 93000088K DigiFAX Software Release Notes Version 2.9.0 d/efax dvr: Fixed remote ID when none sent (was using old one) dfax dvr: Changed for FAX machines that EOM (not MPS) between pages fixes problem where second pages might not be received dfax dvr: Zero EQM register on CDET for newer -13 fax chips dfax dvr: Changed DIS frame on receive to not offer a poll dfax dvr: Changed to not use cpass() which is broken on SVR4 dfax dvr: Changed receive to wait for DCN before hanging up dfax dvr: Changed MCF message to have proper DIS rcv bit, fixes problem where sender would disconnect with an error faxrun: Implemented auto detect of 80/132 text columns faxrun: Changed to handle low res only fax machines when driving dfax faxrun/faxsend: implemented -H page-header override option faxrun/faxsend: added [prefix]number and uucp style Dialcodes faxmerge: Added -h and -l options to force output resolution faxmerge: Added -x and -y options to specify overlay offset faxscan: allow centimeters and millimeters for x, X, y, and Y options imagecvt: All new program to convert image formats dfaxlp dvr: Changed to not give "Bad address" with XENIX stty dfaxlp dvr: Fixed dropped characters when stty opost is active dfaxlp dvr: Improved parallel port performance on SCO UNIX&XENIX SCO XENIX: 4800 bytes/sec, SCO UNIX: 5760 bytes/sec All other UNIX: 9600 bytes/sec. /etc/rc2.d/digifax: Added "su root -c" around faxsrv for SCO UNIX Fixes mail notification and fax printing after reboot 2.2.0: 08/22/91 dfax dvr: Fixed handling of quoted strings dfax dvr: Fixed handling of tabs faxsend: fixed english faxconfig: added setting of page header dfax dvr: Fixed timeout table overflow Install: adding linking of man pages on SCO Install: added workaround for Bourne shell bug in SVR4 faxconfig: added workaround for Bourne shell bug in SVR4 faxrun: bfax interface module: Fixed LINE ERROR problem with 1/9/91 V6.3 BT firmware. (wasn't waiting for DCN). faxrun: efax/dfax interface module: set 60 second carrier wait faxdir: changed to auto save directory on Quick Send faxdir: changed to require unique Nicknames in database faxdir,faxrcv: added TERMOPTS environment variable to handle the two varieties of SCO console driver and the different color numbering that SCO uses. faxdir,faxrcv: changed so that if function keys aren't defined in a terminfo entry, the menus can be accessed by using ESC-1 thru ESC-8 instead. F-Labels now reflect this. keyconfig: Adjusted script to handle terminals with ^A sequences faxdir: changed to handle single quotes in nicknames faxdir: changed dirpopup to select current item on CR faxdir: added view capability to dirpopup; changed usage msg 2.2.0beta: 7/10/91 - 11 - PN 93000088K DigiFAX Software Release Notes Version 2.9.0 Support for DigiFAX FAX board (dfax driver, faxrun) Overhauled /etc/faxconfig 2.1.1: Really fixed core dump in faxdir when '//' is typed faxdir: Fixed dithering options selection[u1] faxdir: Fixed PR#1216, core dump with blank recipient key[u1] faxprint: removed blank after -t option (for XENIX)[u2] faxprint: added -og to raw_lp_opts (for safety with SCO)[u2] fax_uux: handle arbitrary - options, added install instructions keyconfig: Fixed to handle \r,\n,\f properly tigetkey: Fixed to use PID in temp file and remove it 2.1.0: 01/30/91 Changed name to DigiFAX. Added -q option to faxsend (Quiet Mode) Renamed /etc/faxixcfg to /etc/faxconfig Fixed '%%' printf format in device drivers for SCO Turned on idlok in faxdir and faxrcv to speed scrolling Fixed core dump in faxdir when '//' is typed Changed Add Entry screen in faxdir to autoclear the nickname field Added pages sent so far to /usr/spool/fax/log, C-file 'L' line Fixed remote ID reading for short ASCII transmissions - 12 -