home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / dbase / fwkcs120.zip / WHATSNEW.TXT < prev   
Text File  |  1993-05-28  |  23KB  |  495 lines
  1. FWKCS(TM) Contents_Signature System, Ver. 1.20, 1993 May 28.
  2. (C)Copyright Frederick W. Kantor 1989-1993. All rights reserved.
  3.  
  4. Summary: The FWKCS(TM) Contents_Signature System provides a powerful platform
  5.          supporting contents_signature functions.  Among other applications,
  6.          FWKCS is used on giant bulletin boards for protecting against
  7.          duplicate files and against accidentally uploaded commercial files.
  8.  
  9.          The FWKCS system has been shown, experimentally, to provide
  10.          statistical resolution typically more than one thousand times as good
  11.          as the best that is mathematically possible for the 32_bit CRC to do.
  12.  
  13.          The new low pricing, the automated installation procedures ranging
  14.          from simple to complex, and the extensive on_line support provided
  15.          by FWKCS on your computer, bring the FWKCS system within reach of
  16.          almost anyone with a computer that can run DOS or a DOS session.
  17.  
  18. Important: FWKCS(TM) is provided on a two_step test_before_you_decide basis.
  19.            See "Notes", below.
  20.  
  21.            Your use of this software is at solely your own risk: please have
  22.            proper backups of your files.
  23.  
  24. New or changed in FWKCS(TM) Version 1.20:
  25.  
  26. Pricing:
  27. ~~~~~~~~
  28. Very low price, as the regular pricing.
  29.  
  30. Example:  10 node system - Step 1 price: $20.00;  Step 2 price: $2.00
  31. (plus all applicable taxes)
  32.  
  33. For more information, see REGISTER.DOC and REGISTER.FRM.
  34.  
  35.  
  36. Bulletin Board Systems:
  37. ~~~~~~~~~~~~~~~~~~~~~~~
  38. 1. Added more nearly generic support for interfacing with various bulletin
  39.    board systems, using BBSTART.BAT to configure a node's environment, and
  40.    SCANFILE.BAT to test files.  Instructions are included for editing these
  41.    two programs.  As shipped, they are configured for use with Mustang
  42.    Software's Wildcat.
  43.  
  44. 2. FWKCS can now recognize three environment variables for setting node ID:
  45.    FWKNODE=ccc (any 3 DOS filename characters); PCBNODE=nnn ; WCNODEID=nnn.
  46.  
  47. 3. Added support of different filedate formats, besides the U.S. standard.
  48.  
  49.  
  50. New Client/Host Configuration:
  51. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  52. On a network, each node can call on a "client" program to evaluate new
  53. uploaded files. The client, FWKCSC.COM, can fit in ca. 32 K of memory.
  54.  
  55. The client then calls an FWKCS "host" to do the CPU_intensive work.  Any
  56. additional supporting programs called by the host, such as Phil Katz's
  57. PKZIP/PKUNZIP for file integrity testing etc., and McAfee's SCAN for virus
  58. testing, do not use the client's memory.
  59.  
  60. The host sends back a reply to the client, and the client uses this to
  61. handle the node's request.
  62.  
  63. This process is fast. It uses a dynamic queue, which can be served by one
  64. or more processors running FWKCS as host.  When running as host in various
  65. multitasking time_slice environments, FWKCS checks its queue for work; if
  66. the queue is empty, FWKCS releases the rest of its time_slice for other
  67. use.
  68.  
  69. The process is essentially transparent to the end user.  This client/host
  70. configuration can routinely let any BBS node on a network, including the
  71. slowest nodes, handle an end user's uploaded file by calling on the speed
  72. of the fastest processor(s) on the network.
  73.  
  74. (client/host configuration is enabled by a code key, reserved for
  75. registered FWKCS)
  76.  
  77.  
  78. New or Changed in Installation Procedure:
  79. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  80. 1. Added QIKSTART, to set up the FWKCS system quickly without searching
  81.    your file collection; this provides a convenient way to see the
  82.    programs and literature, and to see the structure of the working
  83.    system.
  84.  
  85. 2. Modified the REPLACE procedure, so that systems using QBASIC can use
  86.    less free memory for running the automatic upgrade to the new
  87.    version of FWKCS.
  88.  
  89. 3. FWKCS.EXE and FWKCSC.COM search the environment for node identification.
  90.    They can recognize FWKNODE=ccc (where "ccc" is any 3 DOS filename
  91.    characters), PCBNODE=nnn, and WCNODEID=nnn, in that order of priority.
  92.    When available, node ID is usually used as part of the filename for
  93.    temporary files, except for reply filenames when a client is sending a
  94.    batch upload to a host and will not be waiting for the replies.
  95.  
  96.  
  97. Changes in FWKCS.EXE:
  98. ~~~~~~~~~~~~~~~~~~~~~
  99.  
  100. Compatibility with PKZIP/PKUNZIP v2.04g:
  101. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  102. 1. Revised FWKCS.EXE to treat the AV stamp in compliance with Phil
  103.    Katz's PKZIP(R) version 2.04g.
  104.  
  105. 2. If FWKCS finds than a file appears to be only one part of a
  106.    multidisk disk_spanning zipfile, FWKCS returns exit errorlevel 26
  107.  
  108.    2.1. Under Auxiliary Function 3 or 4, if not s, it changes the
  109.         extension to ".PSZ" (Part of disk_Spanning Zipfile);
  110.  
  111.    2.2. Under Auxiliary Function 5 or 6,
  112.  
  113.         2.2.1. prepares a message to the user,
  114.  
  115.         2.2.2. notes the file as "Span Zip" in the comments column of
  116.                the FWKCS upload log (\CSA\FWKUPLD.LOG).
  117.  
  118.         2.2.3. if not s, and if exist target for failed zipfiles, then
  119.                FWKCS puts that uploaded file there (if you used the
  120.                automatic installation, this would be in the \CSA\FZT
  121.                (Failed Zipfile Test) subdirectory).
  122.  
  123. 3. FWKCS /1b(1) d:filename.ext outfile
  124.  
  125.    new /1b option for a multidisk disk_spanning backup zipfile:
  126.  
  127.    /1b delivers the contents_signatures in the same order that the
  128.        files are listed in the zipfile; if the central directory is
  129.        split onto more than one disk, this will require that the last
  130.        disk be reinsterted (it asks for the disks in a specific order).
  131.  
  132.    /1b1 delivers the contents_signatures by reading the last disk
  133.        first, and then asks you for one or more other disks in a
  134.        specified order; this is less work for the user, and is intended
  135.        for use when the list of contents_signatures will be sorted.
  136.  
  137.    /1bd redates zipfile entry on last disk to latest date of any file
  138.        found inside multidisk zipfile.
  139.  
  140. 4. FWKCS d:\path\filename.ext /a2(b)(d)
  141.  
  142.    new b option for a multidisk disk_spanning backup zipfile; maximum
  143.    number of files is 16383.
  144.  
  145.    /a2b finds matching contents_signatures, prepares a MATCHING.RPT,
  146.    optionally displays results, and optionally keeps or deletes the
  147.    MATCHING.RPT.
  148.  
  149.    If a multidisk zipfile contains at least 1 new entry, /a2b normally
  150.    accessions the collection into the contents_signature data base.
  151.  
  152.    d reDate zipfile; when used with option b, will redate the part of the
  153.      zipfile which appears on the last disk, to the latest file date
  154.      FWKCS saw inside the multidisk zipfile (e.g., it does not look
  155.      inside a zip_in_zip to see if the date on the zipfile has been
  156.      deliberately set to appear earlier than the files inside).
  157.  
  158. 5. added options  z3(~3+-)=;  and  z43+-); , to send control characters to
  159.    suppress selected PKZIP/PKUNZIP options, in case of incompatibility
  160.    between PKZIP/PKUNZIP and your system.
  161.  
  162.  
  163. Other Changes in FWKCS.EXE:
  164. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  165. The following additional changes were made in FWKCS.EXE:
  166.  
  167. 1. FWKCS now supports operation in a client/host system configuration.  New
  168.    Auxiliary Function 8 supports operation as client; new code supports
  169.    operation as host.  The host code is re_entrant; when running as host,
  170.    FWKCS.EXE can stay in memory watching for new work, swapping itself out
  171.    of memory when space is needed for programs it calls.
  172.  
  173.    Operation as an FWKCS host (including in a BBS environment) is called
  174.    using DO_HOSTQ.BAT (see below).
  175.  
  176.    Clients running in other operating systems than DOS may access functions
  177.    from FWKCS running as a host in DOS, provided that they can properly
  178.    handle the file access procedures.
  179.  
  180.    (for more information, see FWKCS120.REF and SETUP.120)
  181.  
  182. 2. For use under Auxiliary Function 5, added a family of options for split
  183.    testing (a subset of the new functions for host mode), reserved for
  184.    registered FWKCS; and the following new options fully enabled in the
  185.    unregistered version:
  186.  
  187.  &a,acdmnopw; - if ATTACH, keep selected UPLOAD options.  If you wish to
  188.    drop certain tests or functions, omit the corresponding letter from the
  189.    ,...; part of the &a,...; option:
  190.  
  191.         a - age test
  192.         c - zipfile comment
  193.         d - catching duplicate or redundant files
  194.         l - log ATTACHed files (see L1,atlog; re keeping separate log)
  195.         m - deleting all matches
  196.         n - novelty test
  197.         o - oust: deleting files from inside zipfiles
  198.         p - purge non_AV files from AV_zipfiles
  199.         w - wipe (w_flag) selected files from non_AV zipfiles
  200.  
  201.       (for use in processing files uploaded as attachments to messages,
  202.        e.g., under PCBoard 15)
  203.  
  204.  &d,DMY; - set date format dd-mm-yy, any order of D,M,Y.  Default is
  205.    mm-dd-yy.  The output format uses each two_character day, month, and
  206.    year entry in the same order as the DMY letters appear in this option;
  207.    for example, for dd-yy-mm, use  &d,DYM;  (upper or lower case OK).
  208.  
  209.  &fN - use description from FILE_ID.DIZ or DESC.SDI.  If FILE_ID.DIZ or
  210.    DESC_SDI is found, extract the files; if the contents_signature for
  211.    FILE_ID.DIZ is not rejected, FILE_ID.DIZ has higher priority than
  212.    DESC.SDI; maximum of ten lines output for text description, not counting
  213.    any lines added by FWKCS.
  214.  
  215.  &lN - data line,  Files: NNN  firstdate...lastdate  New: NNN  , added
  216.    after text description; suboptions to use or omit the "New: NNN" entry,
  217.    and as to whether or not the line is suppressed in PCBoard graphics
  218.    mode; if only one file in zipfile, then only one date is shown.
  219.  
  220.  &mNN - max. allowed uncompressed length, 0-99999999 Kilobytes.  This is
  221.    based on the apparent total uncompressed length of files in a zipfile.
  222.    E.g., it can help in identifying "zip bombs" (small, contrived zipfiles
  223.    containing large file(s) which, if unzipped, could get in the way of
  224.    other operations); it catches them without unzipping them. ( &m can also
  225.    be used under Auxiliary Functions 3 and 4)
  226.  
  227.  kl,d:\path; where to keep zipfiles which fail the &m length test.
  228.  
  229.     Default setting provided in macro [x] during automatic installation is
  230.     &m6000 for 6000 K ("6000" is decimal, "K" = 1024 decimal);
  231.     corresponding target directory for rejected files is \CSA\ZXL.
  232.  
  233.     Corresponding new "comment" entry for FWKUPLD.LOG is "UnzL>Lim"; zcs is
  234.     given (total uncompressed filelength (hexadecimal) can be read from the
  235.     zcs).
  236.  
  237.     Corresponding new exit errorlevel is 29. FWKCS can accept corresponding
  238.     file materials provided by you to send along with, or instead of, its
  239.     own report.
  240.  
  241.  l1,atlog; - separate log for files attached to messages.  If the second
  242.     variable on the command line (%2) is "ATTACH" (case insensitive), and
  243.     option  &a,acdlmnopw;  includes "L" (upper or lower case OK), then this
  244.     option  L1,d:\path\atlog;  can be used to designate a separate log for
  245.     recording what FWKCS did re files attached to messages (rather than
  246.     using the same log as for "UPLOAD").  The format is the same as for the
  247.     upload log; files received as ATTACHed are labeled "Attached" in the
  248.     comment column.
  249.  
  250. 3. FWKCS /1c can now accept and process a command list which includes
  251.    d:\path\filename.ext which contain gaps, such as the OS/2 2.00
  252.    system/hidden/read_only "EA DATA. SF" and the system/hidden
  253.    "WP ROOT. SF" found by FWKDG on a full system scan (to access such
  254.    files, boot directly from DOS on your hard drive or boot from a
  255.    floppy); to terminate filename at first gap, use c0 (see below).
  256.  
  257.    This includes the ability to make contents_signatures for files in
  258.    subdirectories when there is a gap in the subdirectory name. For
  259.    example, in a DOS session under OS/2 2.00, to make cs's for files in
  260.    your  c:\hoo ha  subdirectory on your FAT formatted drive (and
  261.    remove spurious tails from .GIFs), do
  262.  
  263.    echo c:\hoo ha\*.*|fwkcs /1cfjpxz >cslist
  264.  
  265.    Default for /1 option c is to permit filenames with gap(s). If you
  266.    wish to use only the first non_gap string on a text line as the
  267.    designated (d:\path\)filename.ext, use /1 option  c0 . If you use /1
  268.    option e , then c0 is implied.
  269.  
  270. 4. The FWKCS /a7.8 text search functions can now accept quotation marks
  271.    as part of the search string.  To include a '"' as part of a search
  272.    string, use a pair '""' to represent one '"' . (Here, the ASCII 39
  273.    character ' is used as a string delimiter to mark the string made of
  274.    ASCII 34 " characters.)
  275.  
  276.    grammar: the first '"' marks the start of the search string and is
  277.               not included in the search string,
  278.             every subsequent pair '""' is included as one '"' in the
  279.               search string,
  280.             the first '"' which is not part of such a pair marks the end
  281.               of the search string and is not included in the search
  282.               string.
  283.  
  284.    For example,
  285.  
  286.             FWKCS infile.txt /a7.8f"""Oh?"""
  287.  
  288.    would search the file INFILE.TXT for each line containing the
  289.    five_byte string '"Oh?"' and send the result to the screen (via the
  290.    redirectable standard output).
  291.  
  292.    For the 3_byte string '"""', use /a7.8f""""""""
  293.  
  294. 5. You can now use FWKCS macros to store explicitly quoted case_
  295.    sensitive strings, which can include gaps and can include paired
  296.    '""'.  To enter a quote_delimited macro on the command line, the
  297.    left '"' must be the first non_blank character after FWKCS on the
  298.    command line.
  299.  
  300.    For example, you can make a macro which can be called as part of a
  301.    text search. This command
  302.  
  303.             FWKCS "Case_sensitive string, with "" for search" /ds
  304.  
  305.    would include an exact copy of the complete quote_delimited string,
  306.    including the quotes, in macro [s].  To see the entry, type
  307.    FWKCS /d! <enter> .  The following line (flush left) would then
  308.    appear as part of the display:
  309.  
  310. S. = "Case_sensitive string, with "" for search"
  311.  
  312.    Detection of the left quotation mark suppresses interpretation of
  313.    square brackets [], and thus suppresses incorporation of a file by
  314.    reference.
  315.  
  316.    A quote_delimited string can be entered from a file incorporated
  317.    into the command line using [+filename], but the quotation marks
  318.    must appear in the file.
  319.  
  320. 6. revised code for 'find' command, to prevent repeated attempts to
  321.    open a file when operator gives a nonexisting path for the output
  322.    file.
  323.  
  324. 7. revised the waiting for file_swap under option /a7.5a, so that it
  325.    quits if the target file is updated during the wait.
  326.  
  327. 8. split testing, client/host, and automatic text interpretation
  328.    functions are enabled using a code key, reserved for registered
  329.    FWKCS(TM).
  330.  
  331. 9. Many modifications for operation as host, suppressing options which
  332.    depend on "pipelining" or on direct interaction with the user; these
  333.    restrictions apply only in host mode, not for direct use of FWKCS.
  334.  
  335. 10. Modified Auxiliary Function 1, to accept path for DIRGUIDE.TXT on
  336.     the command line; required for AuxF 1 in host/client configuration.
  337.  
  338. 11. Modified Auxiliary Functions 3 and 4, to optionally send output to
  339.     a file designated after the options list; permits capture of a3 and
  340.     a4 output for client when running in client/host configuration.
  341.  
  342. 12. Added release of unused part of time_slice when waiting for work in
  343.     various multitasking time_slice environments; because of the range of
  344.     methods which have been used in the past, also added ability to
  345.     suppress that function via an environment variable or a command_line
  346.     option.
  347.  
  348.     To suppress, type  "SET FWKKTS=." <enter> (without the quotes; any
  349.     permitted character can be used: the program looks for whether the
  350.     variable is there or not).
  351.  
  352. 13. Added a simple but highly flexible grammar for use in passing commands,
  353.     citations of macros, filenames, etc. between client and host; this
  354.     grammar can also be used to load sets of complex, non_contiguous
  355.     commands into macros.
  356.  
  357. 14. Enlarged the ability to customize messages to BBS users, to convey a
  358.     second set of customized messages in cases where the file was ATTACHed
  359.     to a message rather than UPLOADed in its own standing to the bulletin
  360.     board (supports this new option in PCBoard 15).
  361.  
  362. 15. Improved support of remote Lookup, including the ability to process a
  363.     single lookup made remotely from a wildcard input of up to 512 non_zip
  364.     files.
  365.  
  366. New:  FWKCSC.COM:
  367. ~~~~~~~~~~~~~~~~~
  368. 1. FWKCSC.COM is specially designed to run as a client, with one or more
  369.    FWKCS hosts.  It is < 16 KB long, and can fit in ca. 32 KB of memory. It
  370.    releases remaining part of time_slice when waiting in various
  371.    multitasking time_slice environments; that function can be turned off by
  372.    setting the environment variable "FWKKTS=." (without the quotes; any
  373.    permitted character OK) or using command_line option k .
  374.  
  375.    To set up for BBS file testing in the client/host configuration, see
  376.    also BBCLIENT.BAT, below.
  377.  
  378.    (for more information, see FWKCS120.REF and SETUP.120)
  379.  
  380.  
  381. Changes in FWKDG.COM:
  382. ~~~~~~~~~~~~~~~~~~~~~
  383. 1. Added option p to Pause for approximately the time specified in
  384.    tNNNN.NN, i.e., circa 0 - 9999.99 seconds.
  385.  
  386. 2. Matched FWKDG version number to FWKCS version number.
  387.  
  388.  
  389. Changes in FWKHI.COM:
  390. ~~~~~~~~~~~~~~~~~~~~~
  391. 1. Added release of unused part of time_slice when waiting for input in
  392.    multitasking time_slice environment; because of the range of methods
  393.    which have been used in the past, also added ability to use an
  394.    environment variable to suppress that function. To suppress, type
  395.    "SET FWKKTS=." <enter> (without the quotes; any permitted character OK).
  396.  
  397. 2. Matched FWKHI version number to FWKCS version number.
  398.  
  399.  
  400. Changes in FWKCSS.COM and FWKCST.COM:
  401. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  402. 1. Matched FWKCSS and FWKCST version numbers to FWKCS version number.
  403.  
  404.  
  405. New or Changed in .BAT and .BAS programs:
  406. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  407. 1. New:  BBCLIENT.BAT, to set up for screening BBS uploads using the FWKCS
  408.    system in the client/host configuration.
  409.  
  410. 2. New:  BBSTART.BAT, to set up environment variables and work area, and
  411.    call a bulletin board system program with use of FWKCS. Instructions are
  412.    included for editing this program. (As shipped, it is configured for use
  413.    with Wildcat.)
  414.  
  415. 3. New:  DO_HOSTQ.BAT, for running one or more processors as FWKCS host(s).
  416.  
  417. 4. New:  FWKCHTST.BAT, for testing client/host configuration, primarily
  418.    Auxiliary Functions 4 and 5 (related to testing files uploaded to an
  419.    Electronic Bulletin Board System); requires a multitasking or
  420.    multiprocessor (network) environment, registered FWKCS.
  421.  
  422. 5. New:  SCANFILE.BAT, for generic use. It calls FWKCS directly (including
  423.    split_test), or in client/host configuration, to process uploads, etc.
  424.    Instructions are included for customizing this program. It uses
  425.    environment variables set by BBSTART.BAT (above). (As shipped, it is
  426.    configured for use with Wildcat.)
  427.  
  428. 6. changed:  GET_DFLT.BAT, for convenience in editing the default entries
  429.    and macros of both FWKCS.EXE and FWKCSC.COM, including the more flexible
  430.    grammar introduced to support the new client/host configuration.
  431.  
  432. 7. changes in DO_BLOG.BAT:
  433.  
  434.   7.1  added new option to allow the program to continue looking for
  435.        new work, repeatedly checking with optional pause between checks
  436.        on a network; this monitors for work listed in \CSA\BLOG, and
  437.        when that is used up (or not yet present), the screen displays a
  438.        shifting pattern so that it's easy to see that it's working.
  439.  
  440.   7.2  modified call to FWKCS using option x0, so that the text created
  441.        by FWKCS when reporting FAIL is in plain ASCII (i.e., it does
  442.        not contain any special PCBoard @codes).
  443.  
  444.   7.3  added a dividing line between reports appended to the local file
  445.        FAIL2.LST.
  446.  
  447. 8. enclosed  ^  with  quotation marks in SPLITEST.BAT and in
  448.    FWKDG120.BAT, for compatibility with "4DOS".
  449.  
  450. 9. changed:  SPLITEST.BAT, corrected the explanation of how to add a
  451.    second_step zipfile comment.
  452.  
  453. 10. changed:  FWKCTEST.BAT, added Zipfile eXcessive uncompressed Length
  454.     (ZXL) test and subdirectory.
  455.  
  456. 11. changed:  FWKCLEAR.BAT, to clean up after both the revised FWKCTEST.BAT
  457.     and the new FWKCHTST.BAT.
  458.  
  459. 12. many interlocked .BAT programs were changed to support or reflect the
  460.     expanded FWKCS capabilities, including CSAM, CSAMACS, CSM, DELCSA,
  461.     SETFWKCS, all the installation programs, etc.
  462.  
  463.  
  464. Notes:
  465. ~~~~~~
  466. 1. FWKCS(TM) is provided on a two step test_before_you_decide basis.  At
  467.    each step, you may test the software before you decide whether to pay;
  468.    if this software is used in a public, commercial, school, institutional,
  469.    or governmental environment, then the test period for each step,
  470.    respectively, is restricted to no more than 30 days.  Except for Split
  471.    Testing, the first step contains all the functions previously available
  472.    in unregistered FWKCS (some have been enhanced), together with some new
  473.    features.  If you are pleased with what you have in step 1, then you
  474.    should register as described in REGISTER.DOC, using the form
  475.    REGISTER.FRM.
  476.  
  477.    The second step is available only for registered FWKCS, and uses a key.
  478.    The second step contains client/host operation, split testing, and
  479.    procedures for interpreting file descriptions so powerful that they
  480.    warranted writing the assembly_language code for the FWKCS sorting
  481.    functions. In the second step, test the additional features appropriately.
  482.    If you are pleased with what you find in the second step, you should make
  483.    the further registration specified.
  484.  
  485.    In both steps, test before you make your decision. In both steps, the
  486.    program is not free -- if you do not register, you should discontinue
  487.    using that functionality.
  488.  
  489. 2. The remote lookup functions are available in a relatively small kit,
  490.    FWKLU120.ZIP, released 1993 May 28.  If you run a BBS, you may wish to
  491.    get the FWKLU120.ZIP kit for your users, especially if your BBS is a
  492.    "feeder BBS" and many of your users are other BBS's.  The kit comes with
  493.    instructions, and contains a short bulletin, FWKLU120.BLT, suitable for
  494.    posting.
  495.