home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / CHECK30.ZIP / CHECKUP.DOC < prev    next >
Text File  |  1995-01-04  |  8KB  |  166 lines
  1.  
  2.                               CheckUp For GAP
  3.                         GAP BBS File Upload Utility
  4.                          (c)1993-1994 No Anchovies
  5.                            Written By Frank Capo
  6.  
  7.  
  8.     *** SEE FILE 'UPDATE.DOC' FOR ADDITIONS/CHANGES TO THESE INSTRUCTIONS ***
  9.  
  10.  
  11.     OVERVIEW
  12.     --------
  13.     CheckUp is designed to check uploads on GAP BBS systems.  It performs
  14.     archive integrity checks, virus scans, duplicate checking, description
  15.     file (FILE_ID.DIZ - DESC.SDI) reformatting and insertion, archive
  16.     comment insertion, BBS advertisement deletion, and also checks for
  17.     out-dated files as well as GIF graphics integrity.
  18.  
  19.     As of version 2.8, CheckUp will NOT check nested archives.  This may be
  20.     added later.
  21.  
  22.     CheckUp needs approximately 530k free memory to run from GAP.  This
  23.     memory requirement is due to the fact that CheckUp calls virus scanning
  24.     software which usually needs 350-400k free.  CheckUp itself needs only
  25.     150k.  It has been tested with McAfee's Scan v2.0 under the above
  26.     conditions.
  27.  
  28.     Also, until I get an updated programming library I used to write
  29.     CheckUp, it will only support baud rates up to 57,600.  The author claims
  30.     it supports 115,200 now but my testing proves otherwise.  You can try
  31.     CheckUp at 115,200.  If it works, let me know.  Otherwise, it's stuck
  32.     at 57,600 or below until I get an updated COM port routine.
  33.  
  34.     CheckUp can also be used locally from GAPFILE's "Stray Files" function.
  35.     Simply set the stray files "Batch File Name" to UPCHECK.BAT and turn OFF
  36.     the "DOS Window".
  37.  
  38.     ********************************************************************
  39.     *** Make sure you have PKZIP.EXE, PKUNZIP.EXE, LHA.EXE, ARJ.EXE, ***
  40.     *** and GIFTEST.EXE somewhere in your path.                      ***
  41.     ********************************************************************
  42.  
  43.     If you choose not to have certain types of files on your system, you will
  44.     have to perform this operation prior to calling CheckUp.  You can have
  45.     UPCHECK.BAT check for the type of file before calling CheckUp.  If the
  46.     upload is not an archive, CheckUp will perform it's other operations.
  47.  
  48.  
  49.     CONFIGURATION
  50.     -------------
  51.     Create a subdirectory for CheckUp.  I call mine C:\CHECKUP.  Place
  52.     CHECKUP.EXE in this subdirectory.  Make a configuration file in this
  53.     subdirectory.  Call it anything you wish.  I call mine CHECKUP.CFG.
  54.     Here's what CHECKUP.CFG should look like:
  55.  
  56.     1>  C:\GAP                      <- Path to DOOR.SYS
  57.     2>  No Anchovies PC             <- Your BBS name
  58.     3>  REGNUMBER=0000              <- Your registration number
  59.     4>  WORKDIR=T:                  <- Work drive letter for CheckUp
  60.     5>  VIRUSPGM=SCAN #F# /NOMEM    <- Virus scan command line (SEE BELOW)
  61.     6>  OLDFILE=01/01/1988          <- Old file date (Note 4 digit year)
  62.     7>  BADFILE=C:\BADUP            <- Directory to move rejected files
  63.     8>  PORTIRQ=0                   <- COM port IRQ (0 if standard)
  64.     9>  PORTADDRESS=0               <- COM port address (0 if standard)
  65.  
  66.     NOTE : Words to the LEFT of the equals sign (=) must be EXACTLY as they
  67.            appear above (lines 3 through 9).
  68.  
  69.     ALSO NOTE : You must have GAP configured to write a DOOR.SYS file at
  70.                 logon.  See GAP documentation.
  71.  
  72.     Line #1 is the path to GAPBBS.CNF.  Check needs info from this file.
  73.  
  74.     Line #2 is your BBS name - CASE SENSITIVE.
  75.  
  76.     Line #3 is your CheckUp registration number.  CheckUp will not perform
  77.     duplicate file checking unless it's registered (SEE BELOW).
  78.  
  79.     Line #4 is the drive letter (with colon) that CheckUp will use as a work
  80.     drive.  This may be a RAM disk - but make sure you have a couple of megs
  81.     there for large uploads.  CheckUp will create a subdirectory on this
  82.     drive and do it's work there.
  83.  
  84.     Line #5 is the virus program's command line.  The sample above will work
  85.     with McAfee's SCAN.EXE v2.0.  This command line uses a '#F#' parameter
  86.     to pass the file name to the virus program.  If you use a program other
  87.     than McAfee's, place a #F# on this command line where the file name should
  88.     be.  Be sure that your virus program can run in a "batch mode"
  89.     otherwise, CheckUp's operation will be stopped waiting for user input.
  90.  
  91.     Line #6 is the date of the oldest file you will allow CheckUp to pass.
  92.     Note that all 4 digits of the year are used.
  93.  
  94.     Line #7 is the directory where you want CheckUp to move files that fail
  95.     any of the checks.  Make sure this directory exists and it's NOT the root
  96.     directory of any drive.
  97.  
  98.     Line #8 is the COM port IRQ.  If you're using a non-standard IRQ, place
  99.     the IRQ number here.  Otherwise use zero.
  100.  
  101.     Line #9 is the COM port base address.  If you're using a non-standard
  102.     COM port base address, place it here.  It MUST be a hexadecimal number.
  103.     Otherwise use zero.
  104.  
  105.     CheckUp is called from GAP's UPCHECK.BAT file.  You'll need to edit your
  106.     UPCHECK.BAT file to look something like this:
  107.  
  108.     1>  @echo off                               <- standard procedure
  109.     2>  c:\                                     <- here too
  110.     3>  cd \checkup                             <- change to CheckUp dir
  111.     4>  checkup checkup.cfg %1 %2 %3 %4 %5 %6   <- run CheckUp (SEE BELOW)
  112.     5>  cd \gap                                 <- back to GAP
  113.  
  114.     Line #4 above calls CheckUp.  There are 7 parameters.  The 1st is the
  115.     name of the conguration file.  Leave the %1 through %6 as is.
  116.  
  117.  
  118.     UNWANTED FILES
  119.     --------------
  120.     If you wish to have CheckUp scan for and delete unwanted files (BBS ads
  121.     for example), create an ASCII file named BBS.ADS in CheckUp's directory.
  122.     Place unwanted file names in this file - ONE FILE NAME PER LINE.  If
  123.     CheckUp finds any of these files, it will delete them.
  124.  
  125.  
  126.     COMMENT INSERTION
  127.     -----------------
  128.     CheckUp will place or replace comments in archives.  Simply create a file
  129.     called COMMENT.TXT in CheckUp's directory.  CheckUp will place the text
  130.     of this file in the archive's comment field.  This function of CheckUp
  131.     calls the various archive utilities (PKZIP, ARJ, etc) so these must be
  132.     somewhere on your system in your path.
  133.  
  134.  
  135.     DUPLICATE FILE CHECKING
  136.     -----------------------
  137.     If (when?) you register CheckUp, it will perform duplicate file checking
  138.     based on a series of data files that it finds in it's directory.  Using
  139.     these "binary" data files makes CheckUp VERY FAST at checking for dupes.
  140.     I have 13 CDROM data files that CheckUp scans for dupes and it takes
  141.     less than 5 seconds.  This function is primarily for checking CDROMs but
  142.     it could be used for other files in other directories as well.  Since
  143.     I haven't yet released a utility that creates these data files, you'll have
  144.     to rely on me to create them for you.  If you register, I'll be glad to
  145.     help you set up the dupe checking and create any data files you may need.
  146.  
  147.  
  148.     FINALLY
  149.     -------
  150.     CheckUp is not written to be "all things" to all sysops.  It performs
  151.     the way it does to suit my purposes.  One of the problems I encountered
  152.     when writing CheckUp was the memory limitation when calling the virus
  153.     scanner.  In order to have enough free memory, CheckUp's code must remain
  154.     small.  I may issue updates as I see fit.  The current version as of this
  155.     writing has been in operation on my BBS for almost 1 year and works well.
  156.  
  157.  
  158.     Registration for CheckUp is only $10.00 (US).  You can register by mail,
  159.     or use the TABS system or a credit card on No Anchovies BBS.
  160.  
  161.               Frank Capo
  162.               No Anchovies PC
  163.               1205 Lake Avenue
  164.               Ashtabula, OH. 44004
  165.               No Anchovies BBS : 216-466-1151/1152/1153 HST Duals
  166.