home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / DUT210.ZIP / DUTESTER.DOC < prev    next >
Text File  |  1995-06-20  |  37KB  |  807 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                        Domain Upload Tester  Version 2.1
  21.  
  22.                     Copyright (c) 1995 Domain Entertainment
  23.  
  24.                            Installation/Configuration
  25.  
  26.  
  27. Domain Upload Tester                                          Table of Contents
  28. ───────────────────────────────────────────────────────────────────────────────
  29.  
  30. Program Introduction/Features .............................................. 1
  31.  
  32. Program Installation ....................................................... 3
  33.  
  34. Configuring Domain Upload Tester ........................................... 6
  35.  
  36. Command Line Options ....................................................... 10
  37.  
  38. Importing Things to Remember ............................................... 11
  39.  
  40. Advanced Operation ......................................................... 12
  41.  
  42. Where To Get Required Archivers/Virus Scanners ............................. 14
  43.  
  44. Unregistered Version Information ........................................... 15
  45.  
  46. Program History ............................................................ 16
  47.  
  48.  
  49.  
  50. Domain Upload Tester         Introduction/Features                       Page 1
  51. ───────────────────────────────────────────────────────────────────────────────
  52.  
  53.     Domain Upload Tester (DUTESTER.EXE) is an upload event for use with
  54. Synchronet BBS software.  It is a very compact program which uses a very small
  55. amount of memory during operation.  It is the most easy to setup (with it's
  56. scrolling bar, text windowed configuration program), the most easy to use, and
  57. the most efficient tester of it's type.  Domain Upload Tester has abilities
  58. which are unsurpassed by other common upload testing programs, those features
  59. include, but may not be limited to, the following (* = New Feature):
  60.  
  61.     * Ability to have a SECONDARY virus scanner perform virus checking after
  62.       a PRIMARY scanner has already run.
  63.  
  64.     * DUTester allows for a CONFIGURABLE primary and secondary virus scanner
  65.       command line, allowing you to use virtually any virus scanner available.
  66.  
  67.     * Up to 500 names can now be added to the "List of Files to Delete"
  68.       (a configurable list of unwanted files which DUTester will delete from
  69.       uploads).  More than 500 names can be added by using a plain text editor
  70.       rather than the included configuration program.
  71.  
  72.     o Up to 10 filenames can be added to the "List of Files to Add"
  73.       (a configurable list of files which DUTester will add to uploads).
  74.  
  75.     * DUTester can convert compressed uploads to different compression formats,
  76.       including ZIP, ARJ, LZH, PAK, ZOO, SQZ, without losing the directory
  77.       structures and file attributes contained in the original file.
  78.  
  79.     * DUTester can compress uncompressed uploads such as GIF, EXE, and other
  80.       filetypes.
  81.  
  82.     * Configurable paths to archive testers, virus scanners, error log, and
  83.       rejected uploads directory.
  84.  
  85.     * Can optionally reject files older than a specified number of days.
  86.       Archives can be rejected based on the percentage of old files contained
  87.       within them.
  88.  
  89.     o DUTester automatically detects RIP and ANSI capabilities of the caller
  90.       and will display RIP, ANSI, or ASCII screens to the user accordingly.
  91.       These screens can NOT be seen locally.
  92.  
  93.     o Configuration program with scrolling bars and text windowed interface for
  94.       EASY program configuration and option selection.
  95.  
  96.     * Built in communications drivers with support for UART, FOSSIL, DigiBoard,
  97.       BIOS, and Extended BIOS.
  98.  
  99.  
  100. Domain Upload Tester         Introduction/Features                       Page 2
  101. ───────────────────────────────────────────────────────────────────────────────
  102.  
  103.     o Ability to test file TYPEs of GIF, ZIP, ARJ, LZH, ICE, PAK, ARC, ZOO,
  104.       SQZ, TD0, EXE, COM and others.  The reason I say "file TYPEs" is because
  105.       Domain Upload Tester does not look at the EXTENSION of the file, but
  106.       rather looks INTO the file for a signature, so if a .ZIP type file were
  107.       renamed to have an extension of .JNK, Domain Upload Tester would still
  108.       see that the file is of ZIP type and test it!
  109.  
  110.     o Ability to scan files, as well as files within archives at any depth,
  111.       for viruses using one or more of the following virus scanning programs:
  112.       SCAN.EXE/NETSCAN.EXE (McAfee), NAV.EXE (Norton Anti-Virus), VPCSCAN.EXE
  113.       (Datawatch Virex), F-PROT.EXE (Frisk Software), HTSCAN.EXE (Harry
  114.       Thijssen), TBSCAN.EXE (Thunderbyte), or most any other virus scanner.
  115.  
  116.     o Ability to test archives within archives (nested) to any depth.  For
  117.       example, if a file were within a ZIP file within a SQZ file within
  118.       an ARJ file within an LZH file within a ZOO file, Domain Upload Tester
  119.       would test and extract all the way to the bottom level, while testing
  120.       files and scanning for viruses along the way.
  121.  
  122.     o Can remove, and optionally replace, archive comments within ZIP, ARJ,
  123.       ZOO, SQZ, ARC, and PAK type files.
  124.  
  125.     o Can optionally reject files whose signatures do not match their
  126.       file extensions (ie: a ZIP type file without a .ZIP extension).
  127.  
  128.     o Rejected files can optionally be saved for later examination.
  129.  
  130.     o All errors which occur can optionally be logged for later evaluation.
  131.  
  132.  
  133. Domain Upload Tester              Installation                           Page 3
  134. ───────────────────────────────────────────────────────────────────────────────
  135.  
  136.     The following files MUST be placed in your EXEC directory.  Archive
  137. programs and virus scanners may be placed elsewhere if their path has been
  138. specified in the DUCONFIG.EXE program.  It is not necessary to have archive
  139. programs that you do not plan to support (ie: toggled off in the DUCONFIG
  140. program) in the directory.
  141.  
  142.     DUTESTER.EXE      **DUTESTER.KEY        GIFTEST .EXE
  143.     TDCHECK .EXE        PKUNZIP .EXE        PKZIP   .EXE
  144.    *LHA     .EXE       *PAK     .EXE        ARJ     .EXE
  145.     ZOO     .EXE        SQZ .EXE         ***SHROOM  .COM
  146.  
  147.     * PAK.EXE is used for both .PAK and .ARC files.  LHA.EXE is used for
  148.       both .LZH and .ICE files.
  149.  
  150.    ** The file DUTESTER.KEY is only included with REGISTERED version of Domain
  151.       Upload Tester, and is NOT necessary for operation of the UNREGISTERED
  152.       version.
  153.  
  154.   *** SHROOM.COM is only required if you will be doing virus scans using
  155.       Domain Upload Tester on versions of Synchronet prior to v2.00a.
  156.  
  157.     Optionally, you may place a comment to be added to ZIP, ARC, PAK, ARJ,
  158. and ZOO type files in your Synchronet TEXT directory, using the name of
  159. COMMENT.TXT.  VERY IMPORTANT: Because of the way ARJ adds comments, your
  160. COMMENT.TXT file can NOT have ANY blank lines at the beginning of the file,
  161. and it MUST have at least ONE blank line at the end of the file!
  162.  
  163.     If you wish to have DUTester check for viruses in programs, you should
  164. also place the necessary virus scanning programs into your Synchronet EXEC
  165. directory unless a different directory has been specified in the DUCONFIG
  166. program.
  167.  
  168.     NETSCAN .EXE        SCAN    .EXE        NAV     .EXE        F-PROT  .EXE
  169.     VPCSCAN .EXE        HTSCAN  .EXE        TBSCAN  .EXE
  170.  
  171.      NOTE: Some virus scanners may require that additional files be in the same
  172.            directory as the executable file (for example, for McAfee Scan v2.xx
  173.            you must have the SCAN.DAT, NAME.DAT, and CLEAN.DAT files in the
  174.            directory along with SCAN.EXE).  Consult the documentation which
  175.            accompanies the virus scanner you will be using to determine if any
  176.            additional files are required.
  177.  
  178. IMPORTANT: Users of Synchronet v2.00a and later should place DUTESTER in their
  179.            global swap list (if it does not already exist there) using SCFG.
  180.            The text contained on the next page, as well as any other text
  181.            referring to SHROOM, are for using Domain Upload Tester with
  182.            versions of Synchronet PRIOR to v2.00a.
  183.  
  184.  
  185.  
  186. Domain Upload Tester              Installation                           Page 4
  187. ───────────────────────────────────────────────────────────────────────────────
  188.  
  189. IMPORTANT: This section contains information on using DUTester with versions of
  190.            Synchronet PRIOR to v2.00a.  If you are running version 2.00a or
  191.            later of Synchronet, you should skip this section!
  192.  
  193. IMPORTANT NOTE ON USING VIRUS SCANNERS:  Because of the enormous amount of
  194. memory now required by various virus scanning programs, you MUST run Synchronet
  195. with the following command line if you wish to do virus scans on uploads:
  196.  
  197.     SHROOM -q -t DUTESTER.EXE SBBS
  198.  
  199. Or, if you are using a batch file to run Synchronet (probably SBBS.BAT), change
  200. it to look like this:
  201.  
  202.     C:
  203.     CD \SBBS\NODE1
  204.     ..\EXEC\SHROOM -q -t DUTESTER.EXE ..\EXEC\SBBS %1 %2 %3 %4 %5
  205.  
  206.     (insert the proper directory names for your BBS)
  207.  
  208.     If you are using Desqview to run Synchronet, your program setup (in
  209. Desqview) should look something like this:
  210.  
  211.     Program   : C:\SBBS\EXEC\SHROOM.COM
  212.     Parameters: -q -t DUTESTER.EXE SBBS
  213.     Directory : C:\SBBS\NODE1
  214.  
  215.     (insert the proper directory names for your BBS)
  216.  
  217.     This command line requires the use of SHROOM.COM, this will cause SHROOM
  218. to shrink Synchronet out of memory when the Dutester program is run, allowing
  219. it to do virus scans.  If you do NOT wish to do virus scans, you do NOT need
  220. to use SHROOM, and you MUST run Dutester with the /NOVIRUS switch.
  221.  
  222.  
  223. Domain Upload Tester              Installation                           Page 5
  224. ───────────────────────────────────────────────────────────────────────────────
  225.  
  226.     When you've finished all this, you'll need to go into the Synchronet
  227. Configuration utility, select FILE TRANSFERS, then select TESTABLE FILES.
  228. You will need to hit 'INS' to add a new Testable file type, once you do that,
  229. select it, and set it to the following:
  230.  
  231.         File Extension      *
  232.         Command Line        %!DUTESTER %f
  233.         Working String      Testing with Domain Upload Tester...
  234.         Access Requirements
  235.  
  236. NOTE: A file extension of '*' only works on Synchronet v1b rev 5 or higher, if
  237.       you are running an older version of Synchronet, you will need to set
  238.       up multiple extensions for the file types you wish to test.  Also note
  239.       that if you use any other file testing methods, you no longer need them
  240.       because of the versatility of Dutester.
  241.  
  242.     If you wish to have ASCII, ANSI, or RIP screens displayed to the user as
  243. the testing progresses, you should alter the 'Command Line' as necessary to
  244. accomodate your setup (as follows):
  245.  
  246. Using                           Command Line
  247. ---------------------------     -------------------------------
  248. Standard UART Serial Boards     %!DUTESTER /p=%u /c=%i /r=%b %f
  249. FOSSIL Driver                   %!DUTESTER /p=F /c=%p /r=%b %f
  250. DigiBoard Intelligent Board     %!DUTESTER /p=D /c=%p /r=%b %f
  251. BIOS                            %!DUTESTER /p=B /c=%p /r=%b %f
  252. Extended BIOS                   %!DUTESTER /p=E /c=%p /r=%b %f
  253.  
  254. NOTE: The '/r=%b' is an optional parameter, and may be omitted under most
  255.       circumstances.  The maximum baud rate for FOSSIL, BIOS, and Extended
  256.       BIOS setups is 38400 (if a FOSSIL driver is LOCKED at a higher baud
  257.       rate when it is loaded, this higher baud rate will be used by
  258.       Domain Upload Tester).
  259.  
  260.  
  261. Domain Upload Tester             Configuration                           Page 6
  262. ───────────────────────────────────────────────────────────────────────────────
  263.  
  264.     You're just about ready to go now, the only thing left to do is to set up
  265. the Domain Upload Tester options to suit your system.  To do this, go to
  266. your Domain Upload Tester directory (normally \SBBS\EXEC) and run DUCONFIG.
  267.  
  268.     Once you're in the DUCONFIG program you will see a menu of options, the
  269. following text will guide you through the options and explain what each option
  270. does (a "..." shown on an option indicates a sub-menu):
  271.  
  272. Configure Testing Options...
  273.  
  274.     This brings you to a sub-menu for configuring the available testing options
  275.     for DUTester.  The available options are:
  276.  
  277.     Allow GIFLite'd Files
  278.  
  279.         This option works only when using the GIFtest program written by Dave
  280.         Navarro.  If this is set to 'Yes' any GIF files which have been
  281.         compressed with GIFLite will be rejected.
  282.  
  283.     Test Nested Archives
  284.  
  285.         Set this option to 'Yes' to have DUTester extract and test archives
  286.         imbedded within other archives for viruses and file integrity.
  287.  
  288.     Save Rejected Uploads
  289.  
  290.         When this option is set to 'Yes' any files which are rejected by
  291.         DUTester will be saved to the DUTESTER.REJ directory (off of your
  292.         Synchronet EXEC directory).
  293.  
  294.     Should DUTESTER Log Errors
  295.  
  296.         When set to 'Yes' DUTester will log any errors it encounters to the
  297.         file DUERROR.LOG in your Synchronet EXEC directory.
  298.  
  299.     Check Extension to Signature
  300.  
  301.         When set to 'Yes' any file uploaded whose extension does NOT match it's
  302.         signature (ie: a ZIP type file without a .ZIP extension) it will be
  303.         rejected.
  304.  
  305.     Delete Files Older Than xx Days
  306.  
  307.         Placing a number in this option will cause DUTester to reject files
  308.         which are older than this number of days (up to 9999 days, which is
  309.         equivalent to just over 27 years).  Placing a 0 here will disable this
  310.         option.
  311.  
  312.  
  313. Domain Upload Tester             Configuration                           Page 7
  314. ───────────────────────────────────────────────────────────────────────────────
  315.  
  316.     Date Failure Percentage
  317.  
  318.         This option allows DUTester to be more selective about rejecting
  319.         archived files by age.  This will compare the total number of files
  320.         in an archive against the number of files exceeding the specified
  321.         date (from the 'Delete Files Older Than xx Days' option above).
  322.         If the percentage of old files in the archive is higher than what's
  323.         shown here, the archive will be considered old and rejected.
  324.  
  325.     Advanced Options...
  326.  
  327.         Selecting this option will bring you to a sub-menu of options that
  328.         do NOT need to be altered and should only be done so by those who have
  329.         a good working knowledge of DOS and computers.
  330.         The available options from this menu are:
  331.  
  332.         Error Log Path/Filename
  333.  
  334.             Using this option you can specify the path and filename of a file
  335.             that you wish to have Domain Upload Tester use as it's error log.
  336.             This defaults to DUERROR.LOG which will be created in the directory
  337.             where DUTester is executed from.
  338.  
  339.         Rejected Files Directory
  340.  
  341.             This option will allow you to specify the path where DUTester will
  342.             store rejected files (if the 'Save Rejected Uploads' option is
  343.             toggled to 'Yes').  By default this directory is DUTESTER.REJ and
  344.             is created off of the directory where DUTester is executed from.
  345.             If you change this you must be SURE that the directory you specify
  346.             already exists - DUTester will NOT create it.
  347.  
  348.         Path to File Archivers
  349.  
  350.             This option will allow you to specify the path where DUTester is
  351.             to look for archive and file integrity testing programs (such as
  352.             PKZIP, ARJ, GIFTEST, TDCHECK, etc).  DUTester normally looks in
  353.             the directory where it was executed from for these files.
  354.  
  355.         Path to Virus Scanners
  356.  
  357.             This option will allow you to specify the path where DUTester is
  358.             to look for virus scanning programs (such as SCAN, F-PROT, etc).
  359.             DUTester normally looks in the directory where it was executed from
  360.             for these files.
  361.  
  362.     Testable File Types...
  363.  
  364.         Selecting this option will bring you to a sub-menu containing the
  365.         types of files you wish to have DUTester test.  Set any types you
  366.         do NOT wish to have tested to 'No'.
  367.  
  368.  
  369. Domain Upload Tester             Configuration                           Page 8
  370. ───────────────────────────────────────────────────────────────────────────────
  371.  
  372.     Virus Scanner Options...
  373.  
  374.         Selecting this option will bring you to a sub-menu giving you the
  375.         available virus scanner options.  The available options are:
  376.  
  377.         Swap for Virus Scanner
  378.  
  379.             For virus scanners which require a large amount of memory, set
  380.             this option to 'Yes' to have DUTester swap out of memory when
  381.             running the virus scanners you have selected.
  382.  
  383.         Primary Virus Scanner (scanner name)
  384.  
  385.             Selecting this option will bring up a list of pre-configured
  386.             virus scanners.  Select the virus scanner you wish to use as
  387.             your PRIMARY virus scanner (or select 'Do NOT Perform Virus Scans'
  388.             or 'Other' to specify a custom command line for your primary virus
  389.             scanner).  DUTester automatically places the filename being tested
  390.             to the END of a custom command line when it runs.
  391.  
  392.         Secondary Virus Scanner (scanner name)
  393.  
  394.             Selecting this option will bring up a list of pre-configured
  395.             virus scanners.  Select the virus scanner you wish to use as
  396.             your SECONDARY virus scanner (or select 'Do NOT Perform Virus
  397.             Scans' or 'Other' to specify a custom command line for your
  398.             secondary virus scanner).   DUTester automatically places the
  399.             filename being tested to the END of a custom command line when it
  400.             runs.
  401.  
  402.     File Conversion Options...
  403.  
  404.         IMPORTANT: File conversion will ONLY work with Synchronet v2.11a or
  405.                    later.  If you are running a prior version of Synchronet,
  406.                    this option should be disabled!
  407.  
  408.         Selecting this option will bring you to a sub-menu giving you the
  409.         available file conversion options.  The available options are:
  410.  
  411.         Convert Files to Type xxx
  412.  
  413.             Selecting this option will allow you to choose an archive type
  414.             of preference.  When archives (or files) are uploaded which are not
  415.             in this format, DUTester will automatically convert them to this
  416.             archive format (with the exception of those which you have
  417.             configured to not be converted) altering the filename as required.
  418.  
  419.  
  420. Domain Upload Tester             Configuration                           Page 9
  421. ───────────────────────────────────────────────────────────────────────────────
  422.  
  423.         Convert xxx Files
  424.  
  425.             Setting each of these Yes/No options to your liking will allow you
  426.             to determine which file types should be converted to the file type
  427.             specified above.
  428.  
  429.         Compress xxx Files
  430.  
  431.             Setting each of these Yes/No options to your liking will allow you
  432.             to have DUTester compress files which are not normally compressed
  433.             using the preferred archive type specified above.  The 'Compress
  434.             All Other Files' option implies 'All Other' files besides .GIF and
  435.             Teledisk files (such as .EXE, .COM, .TXT, etc.).
  436.  
  437. Maintain List of Files to Add...
  438.  
  439.     Selecting this option will allow you to specify the path and filename of
  440.     up to 10 files that you wish to have added to archives which are processed
  441.     by DUTester (such as BBS ads or information files).  Press 'INS' to add a
  442.     new filename or 'DEL' to remove an existing filename.
  443.  
  444. Maintain List of Files to Delete...
  445.  
  446.     Selecting this option will allow you to specify the path and filename of
  447.     up to 500 files that you wish to have REMOVED from archives which are
  448.     processed by DUTester (such as BBS ads).  Press 'INS' to add a new filename
  449.     or 'DEL' to remove an existing filename.  If you require adding more than
  450.     500 filenames to this list, you must edit the file DUTESTER.DEL (in your
  451.     Synchronet EXEC directory) using a plain ASCII text editor placing one
  452.     complete filename (name and extension) on each line of the file.  The
  453.     maximum number of filenames DUTester will read from this file will depend
  454.     on the amount of free memory DUTester has available to it when it runs.
  455.  
  456.     When you are done setting these options to your liking, hit ESC.  Once you
  457. are back at the main selection menu, you can either select the 'Exit' option or
  458. press ESC to leave the program.  When leaving the configuration program, you
  459. will be able to choose whether or not to save your configuration.
  460.  
  461.  
  462. Domain Upload Tester          Command Line Options                      Page 10
  463. ───────────────────────────────────────────────────────────────────────────────
  464.  
  465.     IMPORTANT NOTE: Command line options will OVERRIDE any options set using
  466.                     the configuration utility!
  467.  
  468.     The syntax for using Dutester is:
  469.  
  470.         DUTESTER [/options] (filename to test)
  471.  
  472.     The following command line options can be used with Dutester:
  473.  
  474.     /NOVIR   do NOT perform virus scan      /NOLEV   do NOT check multi-level
  475.     /NOZIP   do NOT check .ZIP files        /NOARJ   do NOT check .ARJ files
  476.     /NOZOO   do NOT check .ZOO files        /NOSQZ   do NOT check .SQZ files
  477.     /NOPAK   do NOT check .PAK or .ARC      /NOLHA   do NOT check .LZH or .ICE
  478.     /NOTD0   do NOT check .TD0 files        /NOGIF   do NOT check .GIF files
  479.     /NOLOG   do NOT log errors              /GIFLT   ALLOW GIFLite'd .GIF files
  480.     /NOCHE   do NOT check file extensions   /NOCNV   do NOT convert file types
  481.  
  482.     /S[AVE]    Save rejected files
  483.     /D[AYS]=x  Delete files older than x days
  484.     /P[ORT]=x  Where x is the port #, the UART I/O address, D for DigiBoard,
  485.                A for Arnet Board, S for Stargate, or F for Fossil
  486.     /C[HAN]=x  Where x is the IRQ line, Fossil port #, or the DigiBoard,
  487.                Arnet, or Stargate channel number
  488.     /R[ATE]=x  Set com DTE rate to x (up to 115200, 38400 for FOSSIL)
  489.  
  490.     /SCAN    Use McAfee's 'SCAN.EXE' <default>
  491.     /NSCAN   Use McAfee's 'NETSCAN.EXE'
  492.     /NAV     Use Norton's Anti-Virus 'NAV.EXE'
  493.     /VPC     Use Datawatch's Virex 'VPCSCAN.EXE'
  494.     /FPROT   Use Frisk Software's 'F-PROT.EXE'
  495.     /HT      Use Harry Thijssen's 'HTSCAN.EXE'
  496.     /TBSCAN  Use Thunderbyte's 'TBSCAN.EXE'
  497.  
  498. IMPORTANT: The /NOLEV command line option will ONLY check the FIRST level of
  499.            an archive for CRC errors.  It will NOT perform checks on any files
  500.            WITHIN an archive, and will only perform a virus scan if the file
  501.            is an .EXE or .COM file.  (Use along with the /NOVIR option and the
  502.            program will be EXTREMELY fast and require very little memory).
  503.  
  504. NOTE     : Use only ONE virus scanner on the command line.
  505.            The /GIFLT switch ONLY works when you are using Dave Navarro's
  506.            GIFTEST.EXE, the program default is to NOT allow GIFLite'd GIF's.
  507.  
  508.            The /SAVE command line option will place rejected files (except
  509.            those rejected by date) into a directory called DUTESTER.REJ which
  510.            will be created under the directory where DUTESTER.EXE resides.
  511.            This option will slow down the operation of the upload tester, also,
  512.            there is no notice sent to the BBS to notify the Sysop of programs
  513.            in this directory, so if this option is used, the directory should
  514.            be checked periodically.
  515.  
  516.  
  517. Domain Upload Tester      Important Things to Remember                  Page 11
  518. ───────────────────────────────────────────────────────────────────────────────
  519.  
  520.     This section of the manual is intended to be used as a checklist to insure
  521. the proper operation of Domain Upload Tester after it's installation.  Only the
  522. most common problems are listed here, for more complete information it is
  523. always best to read the rest of the manual thoroughly.
  524.  
  525.     o The DUTESTER.EXE, DUCONFIG.EXE, and DUTESTER.KEY (for registered users)
  526.       programs MUST reside in your Synchronet EXEC directory.
  527.  
  528.     o DUTESTER MUST be placed into Synchronet's Global Swap List
  529.       (in the SCFG program under External Programs->Global Swap List).
  530.  
  531.     o Be sure to mark the DUTESTER.EXE file as READ ONLY to avoid sharing
  532.       problems under multi-node systems.  This can be done by using the ATTRIB
  533.       program included with DOS (e.g. type 'ATTRIB +r DUTESTER.EXE' and press
  534.       <ENTER> when in the directory where DUTESTER.EXE resides).
  535.  
  536.     o Be sure to REMOVE any READ ONLY attribute placed on the DUTESTER.EXE file
  537.       when upgrading to a new version.  Be sure to REPLACE any READ ONLY
  538.       attribute after the upgrade is complete.
  539.  
  540.     o Archive programs and virus scanners which are to be utilized by DUTester
  541.       MUST be placed in the Synchronet EXEC directory unless an alternate
  542.       directory has been specified using the DUCONFIG.EXE program.  For
  543.       purposes of this document the GIFTEST and TDCHECK programs are considered
  544.       to be archive programs.
  545.  
  546.     o The ASCII, ANSI, and RIP screens used by DUTester can only be seen by the
  547.       remote caller and are NOT configurable.  The proper command line must be
  548.       used in order for the remote caller to be able to see the screens.
  549.  
  550.     Always remember to read the manual thoroughly, and be sure to perform a
  551. couple of test uploads to be sure that DUTester is running smoothly (it's
  552. usually a good idea to have the error log enabled to see what errors may have
  553. occured).
  554.  
  555.  
  556. Domain Upload Tester           Advanced Operation                       Page 12
  557. ───────────────────────────────────────────────────────────────────────────────
  558.  
  559.     This section of the documentation will describe how to perform "advanced"
  560. operations with Domain Upload Tester.  There are only a couple of examples here
  561. to get you started with ideas, but most every obstacle can be overcome when
  562. combining the options available in Synchronet with the options available in
  563. Domain Upload Tester.  Read on!
  564.  
  565. Problem:
  566.     Users are uploading .ZIP files that contain password protected BBS ads in
  567.     them.  This causes Domain Upload Tester to reject the files, is there any
  568.     way around this?
  569.  
  570. Solution:
  571.     Domain Upload Tester is doing it's job properly by rejecting the files.
  572.     There is no way for Domain Upload Tester to determine that the cause of a
  573.     .ZIP error was a password protected file.
  574.     As a work around for this problem, keep a PLAIN ASCII TEXT list of the
  575.     filenames that you find password protected in the files users are
  576.     uploading, in this example we'll call the list BADFNAME.LST.
  577.     Next, insert a testable file type BEFORE the Domain Upload Tester event as
  578.     follows:
  579.  
  580.             File Extension      ZIP
  581.             Command Line        %!PKZIP -d %f @BADFNAME.LST
  582.             Working String      Removing garbage filenames from ZIP...
  583.             Access Requirements
  584.  
  585.     What this will do is run PKZIP telling it to delete any files in the .ZIP
  586.     file that match any files in the BADFNAME.LST (the list must be ONE
  587.     filename per line with a maximum of 255 lines, wildcards will work) file.
  588.     This will remove the password protected files BEFORE DUTester starts it's
  589.     testing.
  590.  
  591.  
  592. Domain Upload Tester           Advanced Operation                       Page 13
  593. ───────────────────────────────────────────────────────────────────────────────
  594.  
  595. Problem:
  596.     I have a GIF section on my BBS, I want DUTester to check .GIF files for
  597.     file integrity, but I don't want it deleting them because they are too old
  598.     (want to skip the date checking).
  599.  
  600. Solution:
  601.     In this case you would need two (2) testable file types for DUTester.  Set
  602.     them up as follows:
  603.  
  604.             File Extension      GIF
  605.             Command Line        %!DUTESTER %f /D=0
  606.             Working String      Testing .GIF file with Domain Upload Tester...
  607.             Access Requirements
  608.  
  609.             File Extension      *
  610.             Command Line        %!DUTESTER %f /NOGIF
  611.             Working String      Testing with Domain Upload Tester...
  612.             Access Requirements
  613.  
  614.     The first testable file type will test ONLY .GIF type files, the command
  615.     line option '/D=0' tells DUTester not to check the date.
  616.  
  617.     The second testable file type will test ALL file types, the command line
  618.     option '/NOGIF' tells DUTester not to test .GIF files.
  619.  
  620.  
  621. Domain Upload Tester      Aquiring Additional Software                  Page 14
  622. ───────────────────────────────────────────────────────────────────────────────
  623.  
  624.     The following programs are SHAREWARE and/or FREEWARE and can be obtained
  625. on various electronic bulletin board systems (including The Beast's Domain
  626. <Domain Entertainment's BBS> @ 714/521-9439 [Microcom 28.8] or 714/739-0669
  627. [ZyXEL 19.2]):
  628.  
  629. NOTE: If you received a UTILITIES disk with your registered version of Domain
  630.       Upload Tester, you will find the following files contained on that disk.
  631.       Read the READTHIS.NOW file contained on the utilities disk for more info.
  632.  
  633.     Shroom      Giftest     Tdcheck     Pkzip/Pkunzip       Lharc
  634.     Pak         VPCscan     F-Prot      TBscan              Sqz
  635.     Arj         Zoo         HTscan      Scan
  636.  
  637. They are not included with Dutester because of the various license requirements
  638. of the copyright holders of those programs.
  639.  
  640.     Norton's Anti Virus is a commercial software, and is available at many
  641. software retail outlets.  The FREEWARE version of Norton Anti Virus
  642. (NAVSCAN.EXE) cannot be used with this software because of the various screen
  643. pauses it contains (this will cause it to hang the BBS until a key is pressed).
  644.  
  645.     NOTE: All programs listed in this documentation file are copyright
  646.           by their respective copyright holders.
  647.  
  648.  
  649. Domain Upload Tester    Unregistered Version Information                Page 15
  650. ───────────────────────────────────────────────────────────────────────────────
  651.  
  652.     The following limitations are placed on the UNREGISTERED version of the
  653. program to encourage registration:
  654.  
  655.     o All command line options are DISABLED.
  656.  
  657.     o Only EXE type files will be scanned for viruses.
  658.  
  659.     o Only archive integrity testing will be performed (no multi-level
  660.       archive testing).
  661.  
  662.     o There is a small program delay, just enough to be annoying, but not
  663.       enough to impare the operation of the BBS.
  664.  
  665.     o Although there are these limitations, archive conversions WILL work
  666.       in the unregistered version of DUTester.
  667.  
  668.  
  669. Domain Upload Tester            Program History                         Page 16
  670. ───────────────────────────────────────────────────────────────────────────────
  671.  
  672. Version 1.00 RELEASE
  673. --------------------
  674.     Problem found: under certain conditions, 'fopen' would fail to open the
  675. upload tester's error log, I now use 'open' and the problem does not occur.
  676.     The new ARJ returns an error level of 9 when processing a file that is
  677. not an ARJ'd file.  This has been implemented for files that may have an
  678. ARJ header but are not ARJ files, rather than exiting with an errorlevel, the
  679. program will continue on (logging the error).
  680.  
  681. Version 1.00a
  682. -------------
  683.     Was looking for the KEYFILE in the current directory, and it needs to be
  684. looked for in the EXEC directory.  Now fixed.
  685.  
  686. Version 1.00b
  687. -------------
  688.     You can now specify a '/DAYS=xxx' on the command line, this will delete
  689. files and archives who's oldest file date is older than xxx days.
  690.  
  691. Version 1.01
  692. ------------
  693.     Improved file signature checking for LZH, ZIP, GIF and ZOO format files.
  694. ZOO does not support extracting to a path, it will only extract to the
  695. current directory, so now before extracting a ZOO file, it changes into the
  696. necessary work directory first, and then changes back when complete.
  697.     Added 'Origin Filename' to error log.
  698.     Added '/SAVE' command line option which will copy rejected files, into a
  699. directory called DUTESTER.REJ under the directory where DUTESTER.EXE resides,
  700. for later evaluation.
  701.  
  702. Version 1.02
  703. ------------
  704.     Now DUTESTER makes sure all test directories are empty before extracting
  705. files and performing any tests.
  706.  
  707. Version 1.10
  708. ------------
  709.     Domain Upload Tester now supports fossil drivers!
  710.  
  711. Version 1.10a
  712. -------------
  713.     Added support for oddball registration keys.
  714.     Fixed a problem in the fossil routines when passed a 0 baudrate.
  715.  
  716. Version 1.10b
  717. -------------
  718.     Screwed up part of the registration checking, fixed.
  719.     Found some bugs in the DEMO version, would hang on certain files, and
  720. would delete files in the root directory on certain files, fixed.
  721.  
  722.  
  723. Domain Upload Tester            Program History                         Page 17
  724. ───────────────────────────────────────────────────────────────────────────────
  725.  
  726. Version 1.10c
  727. -------------
  728.     Some archive programs would extract programs with the READ ONLY attribute
  729. set, and DUTester would be unable to remove them after testing, DUTester now
  730. changes the file attributes so that it can remove all work files.
  731.  
  732. Version 1.11
  733. ------------
  734.     Invalid baudrates would cause Domain Upload Tester to exit with an error
  735. level, they no longer do this.  Also, baud rates above 38,400 are now supported
  736. using the newer X00 (v1.53 and above) fossil driver.
  737.     File date testing was not working properly, now fixed.
  738.  
  739. Version 1.11a
  740. -------------
  741.     Maintenance release, found a possible bug in the virus scanning.
  742.  
  743. Version 1.11b
  744. -------------
  745.     Domain Upload Tester now compares file extensions and signatures by
  746. default, the /NOCHE command line option has been added to disable this.
  747.  
  748. Version 1.11c
  749. -------------
  750.     Minor cosmetic changes.
  751.  
  752. Version 1.11d
  753. -------------
  754.     Fixed problem of GIF 89 type files getting rejected.  Added support for
  755. McAfee's Scan v2.xx.  Final release of version 1 of DUTester.
  756.  
  757. Version 2.00
  758. ------------
  759.     Major revision!  Domain Upload Tester now has it's own communications
  760. routines, as well as support for intelligent communications boards.  It
  761. also has RIP support, and much improved ANSI and ASCII support.  There is now
  762. also a simple user configuration program to help set the DUTester options.
  763. DUTester only has standard FOSSIL support now, so if you plan to use baud rates
  764. above 38,400 you should LOCK your FOSSIL to that rate when you load it.
  765.  
  766.  
  767. Domain Upload Tester            Program History                         Page 18
  768. ───────────────────────────────────────────────────────────────────────────────
  769.  
  770. Version 2.00a
  771. -------------
  772.     After the long running, apparently bug free v2.00, I've decided to do a
  773. maintenance release with some very minor changes (and hope I didn't break
  774. anything in the process).
  775.     Some of the colors on the screens displayed to the users were "wrong" so
  776. I fixed these minor cosmetics.
  777.     Coding changes were made in DUTester to make the program more portable
  778. for possible future porting to other platforms.
  779.     Added the /NOEXPIRE command line switch for McAfee SCAN v1.xx for those
  780. people who insist on running outdated scan programs.
  781.  
  782. Version 2.10
  783. ------------
  784.     This major revision includes some requested features and a new DUCONFIG
  785. program to be able to utilize those features.  New features include the ability
  786. to convert archives from one type to another, the ability to use a "secondary"
  787. virus scanner, up to 500 unwanted files can be added to the file deletion list
  788. in the configuration program (more can be added by using an external editor),
  789. and more (see the "Introduction/Features" section of this manual for more
  790. detailed information).
  791.     When upgrading from v2.00 the old configuration file can still be read in
  792. but new features cannot be utilized without running the new DUCONFIG program
  793. and setting them up.
  794.     When comparing file signatures to extensions prior versions did not work
  795. properly.
  796.     In v2.00 the error level reported in the log was sometimes incorrect.
  797.     In v2.00 only UART support was working properly.
  798.     In v2.00 the transmit buffer wasn't working properly and would sometimes
  799. only display part of the screen when using ANSI or RIP.
  800.     In v2.00 the program would sometimes not take the phone off the hook if
  801. a user hung up during testing.
  802.     Removed unnecessary (since it's not supported by Synchronet) Arnet and
  803. Stargate board support.
  804.     Added BIOS and Extended BIOS support for complete Synchronet comm routine
  805. compatibility.
  806.  
  807.