Beijing Paradise BBS Backup

home *** CD-ROM | disk | FTP | other *** search

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / TESTF21D.ZIP / TESTF.DOC < prev

Wrap

Text File | 1992-03-19 | 18.7 KB | 464 lines

======================= TESTF 2.1 - ShareWare ======================= (C) 1992 Rui Jorge Ramos Claro All rights reserved By: Rui Ramos Claro 1st. Release 29 Jan 1992 Last revision: 18 Mar 1992 AFTA BBS - 3649684 - R. Belem 75 1300 Lisboa - PORTUGAL It's forbidden the selling of this program or any changes whitout specific authorization from the author ! I make no warranties for this software except that it will TEST your uploads! This program was developed to test uploaded files for PCboard 14.5a. (Tm) Although there are several programs to do this task, none of them was sufficient for my needs, so here is a new program to test uploads. --------------- Files included: --------------- TESTF.EXE the actual program SAMPLE.CFG then sample configuration file TESTFL.ENG English language file TESTFL.POR Portuguese language file FILECRC.ZIP Utility to get CRC codes of files PCBTEST.BAT To replace your PCBTEST.BAT (have a look at it first!) TESTF.DOC This Document ------------------------------------------------------------------------- ----------------------- WHAT DOES TESTFile DO ? ------------------------- ------------------------------------------------------------------------- - Tests uploads in any archive type - Tests for EXE or COM compressed archive formats - Tests for GIF files - Tests for age constraints - Tests for CRC value of files - Stores CRC values of files, not allowing 2 equal CRC values - Tests for Virus - Skips testing of some users - Skips testing of some files (wildcards allowed) - Bulletin of last x uploads - Adds comments to files - Deletes files inside compressed ones - Adds " " " " - etc. ------------------------------------------------------------------------- ----------------------------- INSTALATION ------------------------------- ------------------------------------------------------------------------- If you are using a former version, CHANGES MUST BE MADE! Here's what you should do: Make a directory for the program (i.e. MD C:\TESTF) Decompress this file in the directory made. Place in your autoexec this directory in the autoexec statment (i.e. PATH=C:\TESTF) If you are running a multi-node BBS then several config files must be made to work with this: Explanation of a config file: config files can have comments by placing a ; in the first column of every line. Also blank lines are allowed. Every field must exist, even if you don't intend to use it. Some fields require an = sign, refer to the sample config file. Some field are followed by others, with no ; comment lines. Don't put blank lines or comments between this (refer to the sample config file). Order of fields is not significant, nor is case. FIELDS: Explanation: ---------- ---------------------------------------------------------- PCBDIR Variable that should contain the path and filename of your PCBOARD.SYS COM Same as EXE EXE YES if you want to check for a compressed file (several compression programs allow you to make EXE or COM files of your compressed file) NO, don't check this COMMENT YES if you want to place a comment file in the compressed files. Many compressed formats let you do this, like ZIP or ARJ or ZOO. NO leave as is. Don't place any comment file COMFILE Path and filename of your comment file COMNUM YES, if you want to insert the number of files that the compressed file has in the description file. COMDATE YES, if you want to put the newest file, in the description ADDFILE Followed by the files that you want to include in the compressed file (maximum 20) This must end with ENDADD DELETEFILE Same as ADDFILE, but the following files, if found will be deleted. This must end with ENDDEL BLT Yes if you want to make a bulletin of the last uploads including the one that is to be tested (if passed test). The next line must have the path and filename of the bulletin (do not append G for graphics, as the program will do this) The next line has the number of uploads that you want to report (18 maximum) The next line has the control file for this bulletin (don't include path because this file will be placed in the path defined by the DATAFILES parameter). VIRUS YES if you want to check for viruses The next line has the path and filename of the program that looks for viruses The next line has the parameters passed to the virus check program The next line has the errorlevel of a good exit (in case of using SCAN from McAfee the errorlevel of a good exit is 0, for other software refer to its documentation, this also applies to the compress programs, see EXT fields). This must end with ENDVIRUS statment. USER These next lines contain the users that you want to skip testing (maximum 100). End this with ENDUSER GIF YES if you want to test GIF (Tm) files. Program to test GIFS Parameters passed to it Errorlevel of a good exit Errorlevel of a good exit (I allow 2 exit codes here because there are programs that return more than one errorlevel of a good exit) NOTEST Followed by this line should be the files that you wish to skip testing (up to 20) Use *EXT if you want to specify an extension rather than just a filename. i.e. if you want to skip testing for *.DOC files, and TESTF.EXE: NOTEST *DOC TESTF.EXE ENDTEST Got it ? End this with ENDTEST statment EXT Place extension made by the compressing program The testing program and parameters The compress program and parameters for adding files The compress program and parameters for deleting files The decompressing program and it's parameters The insert/replace comment file program and parameters The errorlevel of a successfull testing exit Note that you should place in these programs the 'Quiet mode' and 'Batch mode' options if available. Refer to the program's documentation or manual Example for ZIP: EXT=ZIP (say its ZIP extension) pkunzip -t (test archive) pkzip -a -k (add a file) pkzip -d (delete a file) pkunzip -o (decompress) recom -s (place comment) 0 (exit code 0 means good exit) TESTfile 2.1 allows you to put up 10 extensions! Repeat this EXT statment for every archive format that you wish to test. NOTE: in case of some archive types there is no comment file (case of LZH), in this situation just leave a blank line. In the sample config file, there are lots of archive types for you to look at. LOG YES for logging information. File to place LOG (don't include path, as this file will be placed in the DATAFILES path. NOTE: Extended logging report is done, allowing you to see what went wrong. DATAFILES Path to where all control files needed by TESTF will be placed BOOSTDRIVE Drive and Path of a 'boost' drive. Boost can be a ramdrive, or a device faster than the hard disk. All the testing will be done here, instead of the hard disk. You will need however some considerable free space to use this option, because TESTFile will decompress all the files in here. I suppose 1 Mbyte is a good choice. It all dependes on the size of the uncompressed files! If you don't have this, leave blank, I mean: BOOSTDRIVE= OLDERTHAN YES if you want to check for a file's age. month day year All files will be tested to see if any of them is older than month/day/year, if so the file will be placed offline. Answer NO if you don't want this option End this line with ENDOLDER statment OFFLINE This is the drive and path of your offline directory. I could of get this in PCBOARD.DAT, but to allow future verions including other type of software rather than PCBoard (Tm) I placed this statment. CRC YES if you want to delete files containing the CRC values specified in the next lines. The file will be posted but without the files that have this CRC values. CRC values in 16 bit HEX End with ENDCRC You can have up to 100 hex values. In order for you to know what is the CRC value of files there is a program called FILECRC that gives you the CRC value of files. Refer to its included documentation. CRCSTORE YES or NO Suppose you have TESTF21.ZIP in your BBS available for download. Suppose then that a user, seeing that you already have this file, but needs more time or bytes than he would rename it and upload it to you. what now? (what a bad guy this user is!) YOUR PROBLEM IS OVER! This option will store all CRC values of files that are uploaded (including the ones that are compressed), and if this CRC value is found in the file that you will specify, the file will go offline! Filename of the file that has stored CRC values of files. This file is formated in the following manner: Column 1 - 4 digit (16 bits) CRC HEX value Column 6 - Filename of file that has this CRC value Column 20 - Path and filename of compressed file where the file is located. This must be manually entered, for REGISTERED users I will distribute (freely) a program to do this. ->> END OF CONFIG FILE (don't include this!!) Refer to the sample config file included for more information. ------------------------------------------------------------------------- ------------------------------ MULTI LANG ------------------------------- ------------------------------------------------------------------------- The program is now fully prepared to work with multi lingual files. I distribute here two language files: TESTFL.ENG - English TESTFL.POR - Portuguese (Long live Portuguese Shareware) These next few lines are not chinese but actually only for Portuguese Sysops: Vivam Sysops portugueses. Gostaram desta (eheheh), um ingles quando ler isto nao vai perceber nada (eheheh). Sao mesmo nabos estes ingleses!! Bem, voltemos a lingua deles. These next lines explain the fields: ------------------------------------------------------------------------- ------------------- RECOMMENDED SOFTWARE AND CREDITS -------------------- ------------------------------------------------------------------------- For this program, I used some other software that are available in most BBS's that I found reliable to work with, here's the list: - ReComment - .ZIPfile comment processor Version 1.05 - Copyright 1990, Michael C. Loewen - SCAN BETA85 Copyright 1989-91 by McAfee Associates. (408) 988-3832 - PKUNZIP (R) FAST! Extract Utility Version 1.1 Copr. 1989-1990 PKWARE Inc. All Rights Reserved. PKUNZIP Reg. U.S. Pat. and Tm. Off. - PKZIP (tm) FAST! Create/Update Utility Version 1.01 Copyright 1989 PKWARE Inc. All Rights Reserved. - LHA version 2.13 - Copyright (c) Haruyasu Yoshizaki, 1988-91 - ARJ 2.30 Beta_2 Copyright (c) 1990,91 Robert K Jung. - GIFtest 4.0ß, CopyRight 1991 by Dave Navarro, Jr. - Zoo archiver, zoo 2.1 (C) Copyright 1991 Rahul Dhesi - PKARC FAST! Archive Create/Update Utility Version 3.5 Copyright (c) 1986,1987 PKWARE Inc. All Rights Reserved. - PKXARC FAST! Archive Extract Utility Version 3.5 Copyright (c) 1986,1987 PKWARE Inc. All Rights Reserved. - FILECRC.COM 3.02 File Integrity Checker (c) C J Mair 1989. - PCBOARD is a trademark of Clark Development Company All programs listed here are available in AFTA BBS, 351-01-3649684, except for PCBoard, which is not shareware. ------------------------------------------------------------------------- -------------------------- THANKS TO: ----------------------------------- ------------------------------------------------------------------------- I wish to thank the following people for their interest and cooperation on making this project: - Luis Silva (McBBS) - for his interest and support - Antonio Cerqueira - suggestion to include CRC checking - Pedro Cardoso - suggestion to include Zip AV checking ------------------------------------------------------------------------- ------------------------ FUTURE VERSIONS -------------------------------- ------------------------------------------------------------------------- This project if well accepted amongst BBS's will be continuously updated to include other items of interest. I hope the next version to include: - Test for security level. If greater than 'x' then no test will be performed. - Test for 'real' zip -AV - Don't test the upload now, test it later (when the user logs off or in an event). - My own 32bit CRC file testing - Default archiving format - JPEG file testing - Default graphic file format ------------------------------------------------------------------------- ------------------------------- REGISTER -------------------------------- ------------------------------------------------------------------------- Mail to: Rui Jorge Claro R. Prof. Vitorino Nemesio, 64 Madorna 2775 Parede - Portugal With the following information: Name:______________________________________________________________ Address:___________________________________________________________ City, State:_______________________________________________________ Country:___________________________________________________________ Zip. Code:_________________________________________________________ Name and phone number of your BBS:_________________________________ Fax number (if available):_________________________________________ FidoNet address (if available):____________________________________ Version that you got of TESTFile:__________________________________ $20 USD in cash. To all that register this Program it will be given the possiblity to: - Minor changes or corrected bugs -> free version. - Major changes -> lower prices. - Full support - Remove delay telling unregistered - Program to store CRC values of files already on disk in the file specified by the CRCSTORE statment. - If using a 80286 or a 80386 then you will get the 80x86 version of TESTFile 2.1 (it's FASTER!) Support: In case of any error (if the programmer 'goofed') a file TESTF.ERR will be made in the root directory of drive C Contact me at AFTA BBS 351-01-3649684 (data) <2400-V42,MNP> 351-01-3631622 (voice) FidoNet address 2:362/16 -------------------------------------------------------------------------- History: Version 1.0 - 28 Jan 1992 Test for ZIP, LZH, ARJ Test for normal EXE COM or compressed EXE COM Seach for Viruses. Placement of comments in Zips and Arjs LOG file of all operations Version 1.1 - 30 Jan 1992 Corrected the error when PKUNZIP v1.01 is in use Changed name to TESTEF, due to the existance of a program to work with PCBoard called Testfile.exe Test for GIF Version 2.0 - 7 Fev 1992 Descriptive Screen 4DOS is not needed now Instalation with /I parameter Parameters for Giftest Parameters for Scan Detection of communication port Added user name, node in use and MB available for Upload Multi-Node (Multitasking ou net) operation Add files and/or delete files from compressed file to test Version 2.1 - 11 Fev 1992 Multi lang Support added Bulletin of Last 'X' Uploads with @PCB ansi esc codes Ansi color suported Skip tests for some users Skip tests for some files (wildcards allowed) Detection of Desqview Description from DESC.SDI or FILE_ID.DIZ ANY compressed file format! Test for file's CRCs Comparing of file's CRCs already on the BBS EXTENDED logging report Test of Date --------------------------------------------------------------------------- --------- SHAREWARE IS ONLY POSSIBLE WITH YOUR CONTRIBUTION TO IT --------- --------------------------------------------------------------------------- . End of Document TESTF 2.1 30 Mar 1992 Rui J. Claro .