(C)Copyright Frederick W. Kantor 1991. All rights reserved. C O N T E N T S GO.BAT, an integrated installation procedure, is provided. For many computer setups, this lets you install the FWKCS(TM) Contents_Signature System, Ver. 1.12, with only a few keystrokes. This installation procedure also provides you with two on_line_help menus. Also, all but one of the .BAT and .COM programs, as initially installed, give on_line help about themselves in response to /* as the only entry on the command line after the program name. (The only exception is PCBTEST.BAT, which passes the request along to FWKCS.COM, which in turn responds with its own /* help_screen. Further execution is blocked by that /* .) Once it is installed, the FWKCS(TM) Contents_Signature System provides you with powerful tools for avoiding duplication, error, and waste. By means of "contents_signatures", it can automatically compare all the files in a new zipfile with all the files in all the zipfiles on an entire electronic bulletin board system, working in real time, independent of filenames, file extensions, dates, compression ratios, comments, zipped paths, and order in which the files appear in the zipfile. It can prevent wasteful duplication, and can be used to protect against unwanted files. It can automatically evaluate uploaded files, and prepare reports to send to the users. FWKCS is in use on electronic bulletin board systems with multiple servers and more than 40 nodes, and runs also on a single personal computer for personal use. FWKCS can run tests on all the files in a zipfile -- including the case of zipped paths for a complete DOS tree of subdirectories -- while using only a single subdirectory as a workarea. It preserves the AV_stamp and the internal structure of the zipfile being tested. In this way, it serves the need of the creative author to protect the integrity of his or her work, while serving the need of the bulletin board operator to protect against harmful files. It can be used remotely, via LOOKUP. This can contribute significant savings in time and communication costs for users of electronic bulletin boards. Cross_references can also be followed up remotely, using RCROSREF. FWKCS uses special "contents_signatures". Key parts of this system are guided by concepts from Kantor's Information Mechanics (1), and are written directly in assembly_language. The resulting software provides a combination of speed, flexibility, power, and resolution which stands in a class of its own. FILE Contents: In the left margin next to each .BAT program is a notation about the program. entry meaning | | /* The .BAT or .COM program will accept /* as a request for help, in the form PROGNAME /* . D Direct execution with no explanation and no pause. The programs for many_times_a_day regular use do not have pauses built in. E if you type the name of the program, and then press the enter key, the program will Explain what it does. I the program operates in an interactive mode at the beginning, from which you can quit, or operates in an interactive mode throughout the program. P after the program explains what it does, it will Pause. To quit, you can then press Ctrl+C, after which you then press the y key. (Press "Ctrl+C" means first press the Ctrl key and hold it down while you press the c key.) R after the program explains what it does, it Returns you to the command line. Note: every .BAT and .COM program in the FWKCS(TM) Contents_Signature System, Version 1.12, can be safely asked for on_line help, by typing progname /* where PROGNAME is the name of the program in question. In every case, execution of the program is blocked. In the rare cases (all four of which are marked, below) where the program does not give on_line help, the request is passed on to FWKCS.COM, which recognizes the /* , displays its own /* help_screen, and blocks further execution. README.TXT a short note on how to get started using GO.BAT. CONTENTS <--<< you are here. WHATSNEW.112 a short list of new features or changes; see HISTORY.112 for prior announcements of features. >--> SETUP.112 If you have not yet installed the FWKCS(TM) Contents_Signature System, then this is where to go after CONTENTS. It contains instructions about how to unzip and install files and programs from FWKCS112.ZIP. REGISTER.DOC registration prices, forms of payment, address, how to get help. FWKCS112.DOC an overview, and technical background. FWKCS112.REF reference manual for FWKCS112, listing all the commands and display screens. These details require patient study, and are intended for use by people who wish to be able to make innovative use of the many features provided. LOOKUP.DOC "Lookup" works together with FWKCS Ver. 1.12 to let you use large BBSs as high_speed multi_gigabyte remote_ ER/* LOOKUP.BAT access reference libraries, and helps you avoid uploading duplicate or redundant material. To support this function, the BBS runs FWKCS Ver. 1.10 or later, remote_ inquiry option i. ER/* RCROSREF.BAT "Rcrosref" follows up on cross_references which may be returned from the BBS in response to your Lookup inquiry. (See LOOKUP.DOC) PRECHECK.DOC "Precheck" works together with FWKCS Ver. 1.12 to let you pre_check files listed in the uploads directory ER/* PRECHECK.BAT of a BBS which uses option g of FWKCS Ver. 1.10 or later. It provides you with the ability to automatically skip files which are duplicates of files on your system. EXAMPLES.112 examples of applications; see list, below. HISTORY.112 notes on prior revisions. RECIPES.112 this contains a collection of explanations and step by step recipes for certain aspects of setting up the FWKCS Contents_Signature System, to provide special help in getting the system up and running. Even if you plan to study the docs in detail later, these recipes can help you see what happens in practical cases. For the newest commands, see WHATSNEW.112, SETUP.112, and FWKCS112.REF. UTILS.112 utilities; see list, below /* FWKCS.COM this is the central program of the FWKCS(TM) Contents_Signature System. (see FWKCS112.REF) it is written in assembly_language, guided by information_mechanics concepts. (see FWKCS112.DOC) in carrying out some of its auxiliary functions, it also calls other programs. To ensure compatibility, the following four .BAT programs are provided in two forms. The long form provides on_line explanation if called without any other entry on the command line, and is provided in FWKCS112.ZIP. The short form can be generated directly from FWKCS.COM. It does not provide on_line explanations. If there is an error, it makes direct use of FWKCS.COM's error handling capabilities, with an error message sent to the screen and logged to FWKCS.ERR in the default directory. The short form can be called more efficiently from other .BAT programs. ER/* Y.BAT for finding matching contents_signatures for plain files and for zipfiles. It prepares a report which you have the option to read, and accessions new material into the system; can redate zipfile to latest file in the zipfile. (blocked by /*) A terse form of Y.BAT, called YT.BAT, which does not provide explanation when called, can be made directly from FWKCS.COM. This short form uses error_logging capabilities of FWKCS.COM, and can be called more efficiently from other .BAT programs. To make terse_form YT.BAT, type FWKCS /a2m . ER/* ACCESION.BAT for accessioning zip or plain files; can perform tests on the file, and can rename files which do not pass the tests. This uses the options set in FWKCS.COM macro [b]. (blocked by /*) A short form of ACCESION.BAT, called ACCESN.BAT, which does not provide explanation when called, can be made directly from FWKCS.COM. This short form uses error_logging capabilities of FWKCS.COM, and can be called more efficiently from other .BAT programs. To make short_form ACCESN.BAT, type FWKCS /a3m . ER/* ACCESZIP.BAT for accessioning zip or plain files, uses Phil Katz's PKUNZIP(R) to unzip zipfiles, can perform a variety of tests, and can rename files which do not pass the tests. This uses the options set in FWKCS.COM macro [b]. (blocked by /*) A short form of ACCESZIP.BAT, called ACCZIP.BAT, which does not provide explanation when called, can be made directly from FWKCS.COM. This short form uses error_logging capabilities of FWKCS.COM, and can be called more efficiently from other .BAT programs. To make short_form ACCZIP.BAT, type FWKCS /a4m . D (blocked by /*) PCBTEST.BAT for automating the testing of zipfiles (including self_extracting zipfiles) and plain files for electronic bulletin board systems, independent of file extensions. Can test (including run McAfee's SCAN on) all the files in a zipfile which contains a complete IBM/MS DOS tree of paths and subdirectories, while preserving the integrity and Authenticity Verification stamp of the original zipfile, and can accomplish this using a single subdirectory as a work_area; or one work_area per node for concurrent processing on a multi_node BBS. Can recognize duplicate or redundant material, independent of filenames, extensions, order in which they appear in a zipfile, comments, etc. Many powerful tests are provided. Can keep a log, and prepare messages to users. Can sequester or delete files which do not pass the tests, can automatically remove non_AV files found in Authenticity Verification zipfiles, and can recognize specific files or AV_stamps as not acceptable. This uses the options set in FWKCS.COM macros [cdef]. Note: Of all the .BAT programs provided in the FWKCS Contents_Signature System, Version 1.12, only this one is originally installed (via GO.BAT, 2_SETUP, S_SETUP, and CSAMACS.BAT) in a form which does not provide on_line explanation. This program is intended for machine interface. (For local use with on_line help, see LUT.BAT, below.) PCBTEST.BAT makes direct use of FWKCS.COM's error_handling capabilities, with an error message sent to the screen and logged to FWKCS.ERR in the default directory. To make PCBTEST.BAT, type FWKCS /a5m . ER/* LUT.BAT Local Upload Test is provided in FWKCS112.ZIP, to carry out the functions (except for generating PCBoard @codes) done under PCBTEST.BAT. LUT also provides local display of messages which under PCBTEST.BAT would be returned to PCBoard for @code_interpretation and transmission to a user, but without @codes so as to permit direct local use. If you link LUT to messages of your own (see MSGS.BAT), any @codes which you insert are retained. To avoid conflict under concurrent operation with PCBoard, the output message files are called PASS.TXT and FAIL.TXT (rather than PCBPASS.TXT and PCBFAIL.TXT). When processing a local "upload", if the file is accepted, then LUT can revise an upload description. If you provide LUT with the filename to use for an upload description, but no description, LUT will create a template containing: the filename, size, date, and a blank space for a description, on the first line; if you have specified that zipfiles containing apparently encrypted material be accepted and reported (see FWKCS112.REF, Auxiliary Function 5, option kN), then the next line may contain such a report as to encryption status; and a line with contents_signature or zipfile_ contents_signature; and file_date of a non_zip file, or date of the latest file in a zipfile. LUT displays such (revised) upload description or template locally. For on_line help, type LUT /* . (R/*) (LUTNOTE.BAT contains most of the on_line help for LUT.BAT, which has been split out to reduce overhead, e.g., when LUT is called from another .BAT program.) /* FWKDG.COM used here for listing files on drives C:-Z: or on selected drives A:-Z:, and in supporting FWKCS option /a1. Has other uses (see UTILS.112). For on_line help, type FWKDG /* . /* FWKHI.COM used here for user input to GO.BAT. For on_line help, type FWKHI /* /* DSA.COM FWKDSA(TM) Directory Spacing Adjust, Ver. 1.01, may be called by FWKTDR19.BAS. For on_line help, type DSA /* . ATX80CNT.BAS Convenience programs, for inserting @X80 to allow ATX80QWK.BAS PCBoard users to suppress lines by switching to DELVSQWK.BAS graphics mode, and insert a line for vertical DEX80CNT.BAS spacing; and to remove the vertical spacing line DEX80QWK.BAS and the @X80's. CNT=count, QWK="quick" (no display). DEX80SP.BAS FWKC17D.BAS "column 17 delete" : to delete designated files (see 2 in EXAMPLES.112) FWKLOCAL.BAS to process batches of files locally, making use of many of the features available for processing uploaded files. FWKTDR19.BAS for cleaning up text directories after deleting duplicates TOREJECT.BAS to make TOREJECT.BAT to delete selected files from specific zipfiles. UPSYSOP.BAS convenience program for inserting "Uploaded by: Sysop" into JOINLIST produced by execution of FWKLOCAL (see UTILS.112); with options of masking the "Uploaded by" line in PCBoard graphics mode, and of adding a 'blank' line for vertical spacing. EI/* GO.BAT .BATs for installing the FWKCS(TM) Contents_Signature ER/* 2_SETUP.BAT System, Version 1.12, under various conditions. ER/* S_SETUP.BAT See SETUP.112 for instructions about these 4 programs, or type the program name, press enter, and for GO.BAT, press A to quit (the other 3 return you to the command_line). ER/* CSAMACS.BAT CSAMACS sets up a place for Contents_Signature Activity, called \CSA, and loads macros and an uploads_log specification into FWKCS.COM. (CSAMACS is used by 2_SETUP.BAT and S_SETUP.BAT. It can be called separately.) EI/* CSM.BAT on_line_help menu re special .BAT and .COM programs in the \CS Contents_Signature subdirectory. EI/* CSAM.BAT on_line_help menu re special .BAT and .COM programs, and literature, in the \CSA Contents_Signature Activity place. ER/* DELCS.BAT to delete all non_directory files in the \cs contents_ signature subdirectory, and, if it is then empty, remove the subdirectory. (If further subdirectory(s) have been added, below the subdirectory in question, then the presence of further subdirectory structure blocks removal of the upper subdirectory.) ER/* DELCSA.BAT to delete all files in the \CSA Contents_Signature Activity place, and, if they are then empty, remove the corresponding structure of subdirectories. (If further subdirectory(s) have been added, below the subdirectory in question, then the presence of further subdirectory structure blocks removal of the upper subdirectory.) EP/* ADD_G.BAT for installing option g for BBS operation under PCBoard 14.5a, to revise descriptions of uploaded files, including providing contents_signature information, the date of the latest file in a zipfile, and (optionally) information about apparently encrypted file(s) in zipfiles. EP/* ADD_Z_4.BAT for installing option z for use under Auxiliary Function /a4, so as to accept in local processing only files in zipfile format, including self_extracting zipfiles, independent of file extension. EP/* ADD_Z_56.BAT for installing option z for use under Auxiliary Functions /a5 and /a6, so as to accept only files uploaded in zipfile format, including self_extracting zipfiles, independent of file extension. EP/* MSGS.BAT for making small message files that contain their own filenames; those files can be used as a guide to where to put material, for customizing messages to users. ER/* NEWCSL.BAT for creating new master list of contents_signatures, ER/* S_NEWCSL.BAT indexing it, and starting fresh rapid_update files (S_ supports string searches). ER/* REVCSL.BAT for making new master_list etc., into which is carried ER/* S_REVCSL.BAT every unique contents_signature which appeared in the prior lists, including those of retired files. for working with Authenticy Verification stamps for zipfiles ER/* BANAV.BAT to ban abused AV_stamps. ER/* LISTAV.BAT to list AV_stamps for future recognition. ER/* TESTAV.BAT to test AV_stamps. ER/* EXCLUDE.BAT to mark unwelcome material for automatic exclusion. ER/* WIPE.BAT to mark unwelcome material for automatic deletion from non_AV zipfiles. ER/* GET.BAT gets matching contents_signatures when given either a contents_signature, or a (zip or plain) file. EP/* KEEPMACS.BAT to transfer macros from FWKCS.COM Ver. 1.09 or later, to new copy of FWKCS.COM. EP/* REVERT.BAT sets all defaults on the right of "=" in FWKCS /d to the initial conditions on the left of "=" ER/* SETFWKCS.BAT sets defaults 1-4, A-F in FWKCS.COM to work with \CS subdirectory and \CSA Contents_Signature Activity place. ER/* SETDRIVE.BAT sets the d in d:\cs\cslist... of defaults 1-4 in FWKCS /d, to point to where those files are kept. ER/* NULSTART.BAT for quick initial setup with empty reference files. EP/* CSFILKIT.BAT to generate sublists, from CSLIST.SRT, of contents_ signatures, with their duplicate matching cs_ entries collected into separate files, and a multiplicity report with each collection of apparent duplicates; and to find non_AV files which have been inserted into AV_zipfiles. (performs the functions of CS_SPLIT and CSDUPS, in less time than the total of running them separately) EP/* CS_SPLIT.BAT to make sublists of contents signatures for classes of files. EP/* CSDUPS.BAT to find non-unique contents_signatures for classes of files, and make multiplicity reports. EP/* FWKDG108.BAT to make DIRGUIDE.TXT. See item 1 in UTILS.112. FWKDG108.SCR displayed after making DIRGUIDE.TXT. EP/* FINDUNAV.BAT to find non_AV files in AV_zipfiles (called by AVONLY.BAT). EP/* AVONLY.BAT to remove non_AV files found in Authenticity Verification zipfiles (calls FINDUNAV.BAT and runs TOREJECT.BAS). ------------------------------------------------------------------------ In EXAMPLES.112: (some uses, with some working examples and .BAT listings) 1. Finding files and adding new files 2. Running FWKCS with an electronic bulletin board system: PCBoard 14.n 2.1 Broader use under EBBS with plain ascii output for sending 3. Accessioning zipfiles 4. Accessioning general files 5. FWKCS/1m multiplicity report MULTCNT.RPT ------------------------------------------------------------------------ In UTILS.112: FWKDG.COM options FWKDG screen FWKC17D.BAS specialized selective deletion Cleaning up text directories FWKTDR19.BAS DSA.COM Locally processing batches of files as uploads FWKLOCAL.BAS Programs specially about zipfile Authenticity Verification BANAV.BAT LISTAV.BAT TESTAV.BAT Protecting against abuse BANAV.BAT EXCLUDE.BAT WIPE.BAT ------------------------------------------------------------------------ If you received this on a disk, this disk contains: README.TXT a short note on how to get started using GO.BAT. CONTENTS.112 <--< you are here. REGISTER.DOC how to register FWKCS and how to get help. GO.BAT integrated installation program: provides a menu, simplifies installation. FWKCS112.ZIP the FWKCS(TM) Contents_Signature System, in an Authenticity Verification Zipfile. If you upload this material to a bulletin board system, the only part which you have permission to upload is FWKCS112.ZIP, in its original, umodified form. It contains all the files, including README.TXT, CONTENTS.112, REGISTER.DOC, and GO.BAT. If you upload FWKCS112.ZIP to a bulletin board system, please provide the instruction either to do PKUNZIP FWKCS112 SETUP.112 and then follow the instructions in SETUP.112, or to do PKUNZIP FWKCS112 GO.BAT and then run GO. ******************************************************************************* * * * Support: * * * * Persons in good standing who subscribe to The Invention Factory BBS, and * * who have full current registration for the FWKCS(TM) Contents_Signature * * System, may obtain support in the FWKCS conference on The IFBB, 212 431 * * 1194, 2400 N 8 1 (other speeds are available, up to 19,200 bits/sec; * * Hayes, USRobotics V.32, and CompuCom high speed modems are supported; 44 * * nodes, 5.8 Gigabytes of storage). To register FWKCS, see REGISTER.DOC. * * Subscription to The IFBB is between the user and The IFBB. The FWKCS * * conference is private. * * * * Limited questions may be discussed also in SmartNet SYSOP conference and * * in Ilink Shareware conference. * * * ******************************************************************************* ---------------------------------------------------------------------------- Reference: 1. Frederick W. Kantor, Information Mechanics, published by John Wiley & Sons, Inc. (1977), Library of Congress Cataloging QC28.K36 530.1 77-6747 ISBN 0-471-02968-8. (If you ask your local library to get it for you on an inter_library loan, this cataloging data may help them help you.)