Beijing Paradise BBS Backup

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

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / RTFDC110.ZIP / RTFDC.DOC < prev next >

Wrap

Text File | 1993-04-20 | 19.9 KB | 574 lines

RBBS Turbo FMS Dupe Checker Version 1.10 (RTFDC) Copyright 1992 by Walter C. Ames. All rights reserved. Created July 5, 1992 ╓───────────────────────────────────────────────────────────────────────╖ ║ TABLE OF CONTENTS ║ ╙───────────────────────────────────────────────────────────────────────╜ License/Warranty/Registration . . . . . . . . . . . . . . . . . . . . 1 License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Warranty. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Registration. . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 About RTFDC . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 RTFDC Features. . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Kudos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . 3 Command Line Syntax/Usage . . . . . . . . . . . . . . . . . . . . . . 4 Creating Your Configuration File. . . . . . . . . . . . . . . . . . . 4 RTFDC Report File . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Appendix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Problem Reporting . . . . . . . . . . . . . . . . . . . . . . . . . 8 ■ RBBS-PC Turbo FMS Duplicate Checker v1.10 1 ────────────────────────────────────────────────────────────────────────── ╓───────────────────────────────────────────────────────────────────────╖ ║ LICENSE - WARRANTY - REGISTRATION ║ ╙───────────────────────────────────────────────────────────────────────╜ Distribution and/or use is permitted under the following terms: You may copy and distribute verbatim copies of the RTFDC documentation and executable code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy a valid copyright notice "Copyright 1992 by Walter C. Ames"; keep intact the notices on all files that refer to this license agreement and to the absence of any warranty. PROVIDE UNMODIFIED COPIES OF THE DOCUMENTATION AS PROVIDED WITH THE PROGRAM; and give any of the other recipients of the RTFDC program a copy of this license agreement along with the program. You may charge a distribution fee for the physical act of transferring a copy, but no more than is necessary to recover your actual costs incurred in the transfer. Under no circumstances is RTFDC to be distributed in such a way as to be construed as "value added" in a sales transaction, such as, but not limited to, software bundled with a modem or CD-ROM software collections, without the prior written consent of the author. Warranty THIS PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, INCLUDING ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THIS PROGRAM IS ASSUMED BY YOU. FURTHERMORE, I THE AUTHOR DO NOT WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE OF OR THE RESULTS OF THE USE OF THE PROGRAM, OR THAT THE PROGRAM WILL RUN WITHOUT ERROR, AND YOU RELY ON THE PROGRAM AND RESULTS SOLELY AT YOUR OWN RISK. I THE AUTHOR CANNOT ACCEPT RESPONSIBILITY FOR SYSTEM DAMAGE, LOSS OF PROFIT, OR ANY OTHER SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM THE USE OR INABILITY TO USE THIS PRODUCT. Registration This program is being released under the "FREEWARE" concept. This means that the program is "JUST FREE" no strings attached. You may use it for as long as you like or delete it right away. If you enjoy the program and feel that you must do something then please consider donating to the charity of your choice. I'm just one for good causes :-) By no means is the above mandatory, simply a suggestion. ■ RBBS-PC Turbo FMS Duplicate Checker v1.10 2 ────────────────────────────────────────────────────────────────────────── ╓───────────────────────────────────────────────────────────────────────╖ ║ INTRODUCTION ║ ╙───────────────────────────────────────────────────────────────────────╜ About RTFDC RTFDC is a full featured RBBS File Management System (FMS) Duplicate Checker. When set-up properly and used regularly it can aid in maintaining your RBBS File Management System. RTFDC has the ability to generate reports based on several different FMS conditions and is completely configurable. RTFDC's Features ■ Complete configurability. ■ Works with any size FMS. ■ Works with Chained FMS directories. ■ Works with Multiple FMS directories. ■ Handles up to 400 Downloadable DOS Sub Directories. ■ Creates formatted reports based on runtime requests. ■ Creates a list of all duplicate FMS entries. ■ Creates a list of all duplicate entries on disk. ■ Creates a list of all files in the FMS but not on the Disk(s). ■ Creates a list of all files on the Disk(s) but not in the FMS. ■ Creates a list of all possible duplicate file versions on the disk. ■ Five levels of processing. ■ User definable Sorting utility. ■ RBBS-PC Turbo FMS Duplicate Checker v1.10 3 ────────────────────────────────────────────────────────────────────────── ╓───────────────────────────────────────────────────────────────────────╖ ║ Kudos ║ ╙───────────────────────────────────────────────────────────────────────╜ I would like to take this opportunity to give special thanks to those individuals who contributed to the development of RTFDC. Their names are listed alphabetically below. Tom Collins MSFA (410)536-1935 Dan Shore The ShoreLine BBS (301)946-2771 Larry Tyler Games & Graphics (301)672-5360 ╓───────────────────────────────────────────────────────────────────────╖ ║ INSTALLATION PROCEDURES ║ ╙───────────────────────────────────────────────────────────────────────╜ Assumptions Three basic assumption are made: 1) You are an RBBS-PC SysOp with an operational RBBS installation. 2) You are familiar with the operation of DOS and RBBS. 3) You would like to test your File database for duplicates. System Requirements Although RTFDC was designed to be as generic as possible, the following system configuration is required as a minimum: 1) An IBM PC, XT, AT, PS/2, or a 100% compatible. 2) MS/PC-DOS 3.1 or above. 3) A text file sorting utility such as QSort or Sortf. Any sorting utility that is capable of sorting a text file the size of your FMS and accepts the command line parameters <infile> <outfile> should work. The DOS sort program will NOT work with RTFDC. Installation Summary 1) Read the documentation to become familiar with options. 3) Determine the configuration options to be used. 4) Edit the parameters in the sample configuration file to reflect your systems needs or create a new configuration file. 5) Run RTFDC. ■ RBBS-PC Turbo FMS Duplicate Checker v1.10 4 ────────────────────────────────────────────────────────────────────────── ╓───────────────────────────────────────────────────────────────────────╖ ║ COMMAND LINE SYNTAX/USAGE ║ ╙───────────────────────────────────────────────────────────────────────╜ The general format for RTFDC is: RTFDC <Config_File> <Output_FileName> RTFDC will automagicaly search the current directory for the file 'RTFDC.CFG', if this file is present RTFDC will use it to obtain it's configuration information. If the default configuration file is not present in the current directory RTFDC will display a help screen. You may optionally pass RTFDC a configuration file of your choice (provided it is in the RTFDC format) enabling you to run RTFDC with several configurations. RTFDC's default output report filename is RTFDC.DUP which can also be specified on the commandline. If you wish to tell RTFDC to use a different report filename you must also pass it a configuration filename. ╓───────────────────────────────────────────────────────────────────────╖ ║ CREATING YOUR CONFIGURATION FILE ║ ╙───────────────────────────────────────────────────────────────────────╜ The RTFDC configuration file is merely an ASCII text file. It uses a series of Keywords that define the parameters and file paths you wish to use. The Keywords can be placed in any order and in any case. The Keywords must begin in column 1 of the line they reside on to be effective, otherwise they are ignored as comments. Any line beginning with a semi-colon or a space is considered a comment. Blank lines are also ignored. The Following is a list of Valid Keywords: Mandatory Keywords: These are keywords that must be included in an RTFDC configuration file. If any of the following keywords are omitted RTFDC will terminate with an error condition. FMS_Directory - Full Path and FileName to the FMS Directory(s). FIDX_Def - Full Path and FileName to the FIDX.DEF File. LIDX_Def - Full Path and FileName to the LIDX.DEF File. Sort_Prog - Full Path and FileName to the Sorting Util. 1. FMS_Directory (Max - 50) The 'FMS_Directory' Keyword is used to define the full name and path of the FMS directory to be processed. If "Chained" type directories are being used RTFDC will process all Chains. RTFDC will process up to 50 FMS Directories. This includes "Chains". Each FMS directory you wish to process must have it's own keyword. Ex. FMS_Directory C:\Rbbs\Dirr\Master.Dir If the file 'MASTER.DIR' chains to 3 other FMS directories then that would count as 4 FMS total. One for the 'MASTER.DIR' and ■ RBBS-PC Turbo FMS Duplicate Checker v1.10 5 ────────────────────────────────────────────────────────────────────────── three more for the chains. This example configuration would only require 1 FMS_Directory configuration keyword as the Master and all of it's Chains are considered 1 directory, yet there are 4 physical files and therefore would count towards the 50 directory limit. 2. Fidx_Def (Max - 01) The 'Fidx_Def' Keyword is used to define the full name and path to the FIDX.DEF File you wish to process. This file must be related to the FMS directory to be processed or the dupe list may be very long. If you are not using the Fast File Search feature of RBBS and do not have less than 20 D/L directories to process this program will be of no use to you as it was designed to work with the FFS System. Ex. Fidx_Def C:\Rbbs\Dirr\Fidx.Def 3. Lidx_Def (Max - 01) The 'Lidx_Def' Keyword is used to define the full name and path to the corresponding LIDX.DEF File. This will be used in the reporting process to give you the exact locations of duplicate files. Ex. Lidx_Def C:\Rbbs\Dirr\Lidx.Def 4. Sort_Prog (Max - 01) The 'Sort_Prog' Keyword is used to define the full name and path to the sorting program you wish to have RTFDC use to do it's sorting. RTFDC doesn't do it's own sorting! The Sort program you choose must take the following command line arguments: ProgName <source> <dest> The Sort programs that have been tested are: Qsort.Exe and Sortf.Com If Qsort is used Version 3.04 or higher is required. If Sorf is used Version 2.57 or higher is required. The sorting program bundled with DOS will not work with RTFDC. Other versions of the above mentioned sort programs may work, but the above mention versions were tested. Ex. Sort_Prog C:\Work\qsort.exe Optional Keywords: These are keywords that are designed to enhance the operation of RTFDC and are considered optional. The absence of any of these keywords will not affect the operation of RTFDC in the least. Proc_Level - Selects the level of Processing and Reporting. Priv_Dir - Full Path and FileName to the Private Directory. Extra_Dir - Directories not processed by the MakeFidx program. Exclude_Dir - Directories to be excluded from the reporting Process. Ver_Comp - Upgrade Version detection and reporting. 1. Proc_Level (1,2,3,4) Default = 4 The 'Proc_Level' Keyword is used to define the level of processing to be performed by RTFDC. Each level will perform the function of that ■ RBBS-PC Turbo FMS Duplicate Checker v1.10 6 ────────────────────────────────────────────────────────────────────────── level and ALL levels under it. ie. If Level 2 processing is chosen Level 1 and 2 processing will be performed. If Level 3 processing is chosen Levels 1, 2, and 3 processing will be performed. 1. Create a List of all possible Upgraded File versions. 2. Create a List of any Duplicate entries in the FMS Directory(s). 3. Create a List of any Duplicate Files on your Disk(s). 4. Create a List of Files in your FMS but not on your Disk(s). 5. Create a List of Files on your Disk(s) but not in your FMS. Ex. Proc_Level 5 2. Priv_Dir (Max - 01) The 'Priv_Dir' Keyword is used to define the full name and path to you RBBS "Private Directory." This will be used to locate duplicate entries in the corresponding FMS directories to be processed. It will also determine if any files listed in the Private directory are not located on a specified D/L drive. Ex. Priv_dir C:\Rbbs\Priv\Priv.Def 3. Extra_Dir (Max - 20) The 'Extra_Dir' Keyword is used to define up to a Max of 20 other directories to process. These will be directories not listed in the FIDX.DEF File, or if you are not using the FFS and wish to process only 20 directories. Each Directory must have it's own keyword or it will not be processed. A File Mask is required for this keyword. ie. If you want all .ZIP files to be processed ONLY use *.ZIP If you want ALL Files to be processed use *.* Ex. Extra_Dir E:\Rbbs\Upld\*.* 4. Exclude_Dir (Max - 05) The 'Exclude_Dir' Keyword is used to define any disk directory that you wish to Exclude from the duplicate reporting process. This can be useful if you have a directory full of Zero byte files used to stop people from uploading specific files. You would not want said directories included in the reporting process. Use this Keyword to avoid unnecessary reporting. Ex. Exclude_Dir P:\DUPES\1\ 5. Ver_Comp (2 - 7) The 'Ver_Comp' Keyword is used to define the number of characters in filenames to use to determine if it is a possible version upgrade. This feature will do a literal comparison of 'x' number of characters of all of the filenames and create a listing of it's findings Ex. Ver_Comp 6 If the above example were used and RTFDC came across the following ■ RBBS-PC Turbo FMS Duplicate Checker v1.10 7 ────────────────────────────────────────────────────────────────────────── filenames it would report them as possible version updates. Ex. RTMBP301.ZIP, RTMBP302.ZIP Since the first 6 characters of the filenames are the same RTFDC assumes that this may be a version update and reports them accordingly. Although this is not the most accurate detection method in the world it works in many cases. ╓──────────────────────────────────────────────────────────────────────╖ ║ THE REPORT FILE ║ ╙──────────────────────────────────────────────────────────────────────╜ The following is an example of RTFDC's Output Report File. List of Files Found on the Disk(s) but NOT Found in the FMS [ FileName ]---[ Directory ]-------------------------------------------- $4SCHOOL.ZIP G:\FILES\1\ 4SQ11.ZIP G:\FILES\6\ ADULT.ZIP E:\RBBS\DNLD\ ARC600.EXE E:\RBBS\ ARENA10.ZIP G:\FILES\6\ List of Files Found in the FMS but NOT Found on the Disk(s) [ FileName ]---[ FMS Listing ]-------------------------------------- #2KEEN2.ZIP C:\RBBS\DIRR\MASTER.DIR 123QB11.ZIP C:\RBBS\DIRR\CHAIN91.DIR 174-NEW.ZIP C:\RBBS\DIRR\MASTER.DIR List of Duplicate Files Found on the Disk(s) [ FileName ]---[ Path One ]--------------------[ Path Two ]------------- List of Duplicate Entries in your File Listing [ FileName ]---[ Path One ]--------------------[ Path Two ]------------- 174-NEW.ZIP C:\RBBS\DIRR\MASTER.DIR C:\RBBS\DIRR\MASTER.DIR 174-NEW.ZIP C:\RBBS\DIRR\MASTER.DIR C:\RBBS\PRIV\PRIV.DEF 174DOCWP.ZIP C:\RBBS\DIRR\MASTER.DIR C:\RBBS\PRIV\PRIV.DEF ALIAS174.ZIP C:\RBBS\DIRR\MASTER.DIR C:\RBBS\PRIV\PRIV.DEF List of Duplicate Versions Found on the Disk(s) [ FileName ]---[ Path to File ]---------------------------------------- RTMBP301.ZIP E:\RBBS\DNLD\ RTMBP302.ZIP E:\RBBS\UPLD\ DSZ0412.ZIP F:\RBBS\DSZ\ DSZ0414.ZIP F:\RBBS\DSZ\ ■ RBBS-PC Turbo FMS Duplicate Checker v1.10 8 ────────────────────────────────────────────────────────────────────────── ╓───────────────────────────────────────────────────────────────────────╖ ║ APPENDIX ║ ╙───────────────────────────────────────────────────────────────────────╜ If you uncover a problem with the operation of this program please contact the author using one of the following methods. 1) BBS - The GreyHawk BBS Node 1 (410)461-9943 USR DS V.32Bis Node 2 (410)465-3891 USR DS V.32Bis 2) USPS - Walter C. Ames 3126 Wheaton Way Ellicott City, MD 21043 3) NetMail - RelayNet ->GREYHAWK R/O Capable FidoNet 1:261/1116 or 1:261/1117 RBBSNet 8:936/203 or 8:936/204