KFB file lister v5.1 By C.C.Wilson, sysop of Amiga Phoenix BBS 0151 283 6406 This program is (C) C.C.Wilson 1996 Amiga Phoenix BBS 0151 283 6406 NOTE: This program may be included on CD compilations only if I am sent a copy of the CD. How else can a poor sysop boost their filebase ? ;-) Call me for the address for donations. Thanks ! ----------------- This program was written for KFB v1.1, which is a replacement filebase system for Maxs BBS. It may work on earlier or newer versions as they become available, but I cannot guarantee it. This software is provided as is, and without warranty. I can take no responsibility if, for some unknown reason, it decides to do something nasty to your system. If it works on mine, there's a good chance it'll work on anything from a ZX81 upwards ! Now the nitty gritty! ~~~~~~~~~~~~~~~~~~~~~ This program was written using HiSoft Basic, and will extract data from the KFB.data file and write it to a text file called 'filelist.text' in the BBS directory. It requires about 160K of memory no matter what the size ofthe KFB.data file may be. You will need the hisoftbasic.library, which is in this archive. It uses the standard KFB.data file and takes the information from the data-file in the order it was uploaded. The path for KFB: must be assigned before running this program (it should be anyway). It will not alter this file in any way, it only scans it and removes the information it needs. The program can be run from the icon , or incorporated into a script to run at a time set via FIDO configure. I cannot as yet make an archived list directly from the program, but the enclosed script will do it for you. Please note that the small work file created in RAM: is not deleted after use, but it is safe to do so once the program has finished. The data file will be as large in bytes as the number of files you have under KFB, so 4000 files = 4000 byte data file ( less than 4K ) The program will use the following files: KFB:KFB.data (scanned to extract data) KFB:kfblister.adv (ascii advert for your BBS) KFB:kfblister.cfg (configuration file) RAM:kfblister.work (created as a fast reference file) BBS:filelist.text (the filelist) Installation ~~~~~~~~~~~~ 1) Drag the config file and the advert of your choice to KFB: 2) Put the icon anywhere you like ! 3) Click on it :-) Features ~~~~~~~~ You can exclude up to fifty areas ! - Ideal for hiding adult / sysop file areas etc. or if your FBxx numbers are widely spread apart. The program uses a config file, which consists of 153 lines of ';'s and should be placed in KFB: Do not delete the ';'s as they are used by the program to signify the end of a filename / area number. Lines 1-99 relate to the FBxx number Lines 100-101 let you specify which FBxx to start / end at Lines 102-152 are exclusion numbers. An FBxx number on these will be left out of the filelist (see example below) You can include the names of the file areas to the filelist by editing config file as below. The area name will be automatically centred, so don't add any spaces before / after the area name. Example config file ~~~~~~~~~~~~~~~~~~~ If you have trouble following this, just load the real config file into any text reader and look for the line numbers as mentioned above. The annotated notes are only there to try to guide you through it.... --8<--SNIP-- ; ; ;GAMES { this is on line 20, and is FB20's file area description ;UTILITIES ;UFO & SCI-FI ;TEXT FILES ;COMMS UTILITIES ;ARCHIVERS ;VIRUS UTILITIES ;DEMOS ;BBS PROGRAMS AND DOORS ;MUSIC MODULES / PLAYERS ;ART AND GRAPHICS ;PROGRAMMERS ;PC PROGRAMS ; { hidden ;SYSTEM LIBRARIES ; { hidden ; { hidden Note: hidden areas don't have to be added, because they're ignored anyway as long as you put them in the excludes ! ;20 { Line 100 This is the start FBxx, I use 20-36 inclusive ;36 { Line 101 "" "" "" end "" "" ;33 { ;35 { Lines 102 - 152 ;36 { ; { ; { These sections are excluded from the filelist ; { ; | ; | ; | ; V and so on..... --8<--SNIP-- Known bugs: ~~~~~~~~~~~ Nothing that I know of if you've read this far ! :-) If the second line of each .diz onwards is displaced to the left, you have your TAB key set to something other than 8. This is not my fault :-) The icon for the filelist doesn't have a default tool, but once set it will stay set (more/ppmore/ced etc.) Earlier versions ~~~~~~~~~~~~~~~~ Too many to list individually, but what I have done is optimised the .diz extraction routines / scan routines to boost the speed considerably. This version uses a small reference file in RAM: to speed up direct accessing. The use of this file also (hopefully) eliminates memory problems that were caused by very large filebase data arrays being held in a single string variable. The string is now only as large as the number of files in the largest area. Small cosmetic changes to the output file have also been made, these include use of TAB's instead of spaces to make the resulting filelist 33% smaller on average.. Early versions would extract approx 2.2 files per second, this is approaching 5.5 files per second. Stay kewl ! Colin Wilson !!! CALLS ARE FREE !!! to ~\/~ ___ _ ____ _ _ ~\/~ __/\__/ _ \ _ __ ___ (_) | _ \| |__ ___ ___ _ __ (_)_ ____/\__ \ oo / |_| | '_ ` _ \| |_____| |_) | '_ \ / _ \ / _ \ '_ \| \ \/ /\ oo / /_\/_\ _ | | | | | | |_____| __/| | | | (_) | __/ | | | |> < /_\/_\ \/ |_| |_|_| |_| |_|_| |_| |_| |_|\___/ \___|_| |_|_/_/\_\ \/ * (For local Cable NW customers with package deal only) * Sysop: Colin Wilson Location: Liverpool Tel: 0151-283-6406 *** Home of the standard-config BBS, download your own BBS today ! ***