home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / SFVL1004.ZIP / SFVLAB.DOC < prev    next >
Text File  |  1992-07-25  |  21KB  |  528 lines
  1.  
  2.  
  3.    ▓▓▓▓▓▓▓▓▓   ▓▓▓▓▓▓▓▓▓   ▓           ▓   ▓          ▓▓▓▓▓▓▓▓▓   ▓▓▓▓▓▓▓▓▓▓▓
  4.    ▓░░░░░░░░░  ▓░░░░░░░░░  ▓           ▓   ▓░         ▓░░░░░░░▓░   ░▓░░░░░░░▓░
  5.    ▓░          ▓░          ▓           ▓   ▓░         ▓░      ▓░    ▓░      ▓░
  6.    ▓░          ▓░           ▓         ▓    ▓░         ▓░      ▓░    ▓░      ▓░
  7.    ▓▓▓▓▓▓▓▓▓   ▓▓▓▓▓▓▓       ▓       █     ▓░         ▓▓▓▓▓▓▓▓▓░    ▓▓▓▓▓▓▓▓▓░
  8.     ░░░░░░░▓░  ▓░░░░░░░       ▓     ▓      ▓░         ▓░░░░░░░▓░    ▓░░░░░░░▓░
  9.            ▓░  ▓░              ▓   ▓       ▓░         ▓░      ▓░    ▓░      ▓░
  10.            ▓░  ▓░               ▓ ▓        ▓░         ▓░      ▓░    ▓░      ▓░
  11.    ▓▓▓▓▓▓▓▓▓░  ▓░                ▓         ▓▓▓▓▓▓▓▓▓  ▓░      ▓░  ▓▓▓▓▓▓▓▓▓▓▓░
  12.     ░░░░░░░░░   ░                           ░░░░░░░░░  ░       ░   ░░░░░░░░░░░
  13.  
  14.  
  15.  
  16.                              **************
  17.                            ***  Shareware ***
  18.                              **************
  19.  
  20.  
  21.                       Another Checker for Upload File.
  22.  
  23.  
  24.                      (C)Copyright 1991,1992 JP Luiggi
  25.  
  26.  
  27.                             All Rights Reserved
  28.  
  29.                           SFVLAB Reference Manual
  30.  
  31.                                Release 1.00
  32.  
  33.  
  34.  
  35.        Table of Contents
  36.        ====================================================================
  37.  
  38.           Comments  . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  39.  
  40.           Preliminary Information . . . . . . . . . . . . . . . . . . .   2
  41.                What is SFVLAB?  . . . . . . . . . . . . . . . . . . . .   2
  42.                Features . . . . . . . . . . . . . . . . . . . . . . . .   2
  43.                Developped . . . . . . . . . . . . . . . . . . . . . . .   2
  44.                What is Shareware? . . . . . . . . . . . . . . . . . . .   3
  45.                Registration Information . . . . . . . . . . . . . . . .   3
  46.                Support for SFVLAB ..........  . . . . . . . . . . . . .   4
  47.                Files Included . . . . . . . . . . . . . . . . . . . . .   5
  48.                Disclaimer . . . . . . . . . . . . . . . . . . . . . . .   5
  49.  
  50.         Quick Setup . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  51.                Configuration File . . . . . . . . . . . . . . . . . . .   5
  52.  
  53.           Running  SFVLAB . . . . . . . . . . . . . . . . . . . . . . .   6
  54.                Command Line Options for Spitfire board  . . . . . . . .   6
  55.                Command Line Options for TriBBS  . . . . . . . . . . . .   7
  56.  
  57.           SFVLAB  at  Run . . . . . . . . . . . . . . . . . . . . . . .   8
  58.  
  59.           APPENDIX A: General info  . . . . . . . . . . . . . . . . . .   11
  60.  
  61.           APPENDIX B: Products and Trademarks . . . . . . . . . . . . .   11
  62.  
  63.  
  64.   page 1
  65.  
  66.  
  67.           Comments:
  68.           ────────
  69.  
  70.           I hope you don't look too much at my english language.
  71.           i've tried to make no error but ....
  72.  
  73.  
  74.           This documentation and associated programs are the property
  75.           of JP Luiggi.
  76.           This program may be distributed only in its original form,
  77.           including all documentation and support files.
  78.  
  79.  
  80.           From a demand from a friend at the beginning, SFVLAB growns
  81.           to several hundred of lines of code in order to reach a
  82.           ( i hope ) valuable value.
  83.  
  84.                 These days, with all problems that occure on BBS:
  85.  
  86.                 - Bad upload (CRC fails)
  87.                 - Bad files  (virus ...)
  88.                 - etc ...
  89.  
  90.                 We must check upload, so it's the purpose of SFVLAB.
  91.  
  92.                 It now covers several possible problems that may occure
  93.                 when files are uploaded.
  94.  
  95.                 It has been developped on a SPITFIRE BBS basis, but
  96.                 due to his design, i think that others BBS packages can
  97.                 use it in order to prevent from problem.
  98.  
  99.  
  100.                 I would like to thank the following people for their help
  101.                 on SFVLAB from the beginning.
  102.  
  103.                  --------> Stef Evain  Sysop of ALF BBS. (Paris-France)
  104.  
  105.  
  106.  
  107.              I hope you will enjoy SFVLAB and it could help you in
  108.              the use of your BBS.
  109.  
  110.  
  111.  
  112.    page 2
  113.  
  114.        Preliminary Information
  115.        ====================================================================
  116.           This section explains the general philosophy of the SFVLAB,
  117.           the shareware philosophy, and important general information.
  118.  
  119.  
  120.  
  121.        What is SFVLAB?
  122.        ====================================================================
  123.           SFVLAB works as an Checker for all files upload on a Spitfire
  124.           BBS or on one another.
  125.           SysOp can put it into their board and sfvlab will check
  126.           files integrity, virus, file's date & add a banner.
  127.  
  128.  
  129.        Features
  130.        ====================================================================
  131.           - Fast
  132.           - Up to four archive type (arj, lzh, zip, ...) can be used
  133.           - Check files integrity
  134.           - Check for virus
  135.           - Possibility to check the year of the file uploaded
  136.           - Test for scratch file ...
  137.           - Add a banner file for .Zip & .Arj
  138.           - Executable (.Exe file) can be uploaded & Checked
  139.           - Three window for SysOp (local & remote & status)
  140.           - Remote write to caller
  141.           - Log file
  142.           - Txt file for SysOp likes "HeySysOp.log" for Spitfire BBS
  143.           - Every archive is decompressed recursively if you want
  144.             & in this case, scanner will check every sub dir, a "kill dir"
  145.             is also performed ...
  146.  
  147.        Developped
  148.        ====================================================================
  149.           SFVLAB has been written with TopSpeed Modula-2 & Slick Editor.
  150.  
  151.  
  152.  
  153.   page 3
  154.  
  155.  
  156.        What is Shareware?
  157.        ====================================================================
  158.           The shareware concept is great for both programmer and the end-
  159.           user. The programmers can distribute their product without
  160.           getting involved in expensive marketing or advertising. The end-
  161.           user benefits by receiving a full-featured program, usually
  162.           better than the commercial competition, and support available
  163.           directly from the author. But it only works if the end-user
  164.           participates in the shareware concept.
  165.  
  166.           Shareware is not free. After using SFVLAB for the suggested 30
  167.           day trial period, you must pay for continued use of the program.
  168.           I have worked hard to produce a good program and the price is
  169.           very fair.
  170.  
  171.  
  172.        Registration Information
  173.        ====================================================================
  174.           Unregistered copies are completely functional. You will only see
  175.           the "shareware screen" at the end of the run.
  176.           This lets you test the program with its true look and feel.
  177.           Please encourage me to continue this policy by registering.
  178.  
  179.  
  180.           SFVLAB registration is only $15 US.
  181.           Send (in US funds) to:
  182.  
  183.                Jean Philippe Luiggi
  184.                18 Rue de l'Avignou
  185.                78370 Plaisir (FRANCE)
  186.  
  187.  
  188.           (Print out REGISTER.FRM for complete ordering information)
  189.  
  190.           After i receive your registration, you will receive an
  191.           activation code. Because the program is not crippled,
  192.           the effect your activation code will have is the
  193.           elimination of the shareware screen (which only appears at
  194.           the end of the program) and the program will be show as
  195.           Registered to your users during run.
  196.  
  197.  
  198.   page 4
  199.  
  200.  
  201.        Support for SFVLAB
  202.        ====================================================================
  203.  
  204.  
  205.        BBS:
  206.                BUGGY BBS:
  207.                ──────────   (33) 1-30-55-80-98        v32
  208.           (Board's home)
  209.  
  210.  
  211.           Log with Login SFVLAB, password "SFVLAB" and left
  212.           a comment to Sysop.
  213.  
  214.  
  215.                ALF BBS:
  216.                ────────     (33) 1-39-50-46-98        v32 bis
  217.                             (33) 1-39-51-26-25        v22 bis
  218.                             (33) 1-30-21-43-83        v32
  219.  
  220.  
  221.           Log with Login: SFVLAB press 3 times enter for no password and
  222.           then left a message !
  223.  
  224.               
  225.                                        OR
  226.  
  227.           Left a message to JEAN LUIGGI on :
  228.  
  229.                 CircuitNET network Spitfire  conference  ( Node 033000 )
  230.                 Intelec            Shareware conference
  231.                 RIME               Shareware conference  ( ->ALF )
  232.                 TTN                Shareware or triBBS support
  233.  
  234.           You can also write to me with questions:
  235.  
  236.                Jean Philippe Luiggi
  237.                18 Rue de l'Avignou
  238.                78370 Plaisir (FRANCE)
  239.  
  240.  
  241.           Unfortunately, i can not offer phone support at this time. But
  242.           i will respond quickly to queries sent by these alternate
  243.           methods.
  244.  
  245.  
  246.  
  247.   page 5
  248.  
  249.  
  250.        Files Included
  251.        ====================================================================
  252.          Filename       Size      Description
  253.          ===========    ======    ==============================
  254.          SFVLAB.EXE               SFVLAB Program (Generic type).
  255.          SFVLAB.CFG               SFVLAB configuration file (exemple).
  256.          SFVLAB.DOC               SFVLAB documentation.
  257.          SFVLCFG.EXE              To Create Config File for SFVLAB.
  258.          SFVLCFG.DOC              SFVLCFG Documentation.
  259.          README.1ST               Introduction Information.
  260.          REGISTER.FRM             Registration form.
  261.          HISTORY.DOC              Different release.
  262.          SUMMARY.NEW              Summary of new changes v1.00
  263.          QUICK.RUN                To quickly run SFVLAB.
  264.          SFEXTUPA.BAT             Exemple of a batch upload file for Spitfire.
  265.          UPLOAD.BAT               Exemple of a batch upload file for TriBBS.
  266.  
  267.  
  268.        Disclaimer
  269.        ====================================================================
  270.           SFVLAB and all support files are provided on an "AS - IS" basis
  271.           with no warranty. JP Luiggi cannot accept responsibility for
  272.           loss of data, profit, or any damages which are incurred by
  273.           the use of this program or any support files.
  274.  
  275.  
  276.        Quick Setup
  277.        ====================================================================
  278.           You need only to create/modify SFVLAB.CFG file, using
  279.           SFVLCFG.EXE
  280.  
  281.           SFVLAB can't run whitout this file.
  282.  
  283.   page 6
  284.  
  285.        Running SFVLAB
  286.        ====================================================================
  287.           Put SFVLAB.EXE into the subdir of your choice and include it
  288.           into the batch file after upload.
  289.  
  290.  
  291.           Command Line Options for Spitfire
  292.           =================================
  293.  
  294.           Put the following line into the batch file "SFEXTNODx.BAT"
  295.           where (x) means a, b, c, etc ...
  296.  
  297.  
  298.           SFVLAB <pathname> *.ArJ x1 x2 x3
  299.  
  300.           Where <pathname> is the repertory where is SFVLAB.CFG
  301.           and x1 x2 x3 etc ... are the filename that SFVLAB must check.
  302.           ie *.ARJ, *.ZIP, *.EXE, etc .........
  303.  
  304.           Don't forget to configure sfvlab in order to use these archive.
  305.           ------------
  306.  
  307.  
  308.           Exemple:   SFVLAB  c:\sf\uti   *.ARJ *.ZIP *.EXE *.LZH
  309.           ────────           ---------   -----------------------
  310.                              Pathname      File
  311.  
  312.           Please don't put a '\' at the end of the pathname.
  313.  
  314.           Config file (SFVLAB.CFG) don't need to be in the same directory
  315.           than SFVLAB.EXE, specially for SPITFIRE because of lookup
  316.           of the files by Spit.
  317.           So put the CFG File in one another REP and just run likes showed
  318.           before.
  319.  
  320.           Exemple
  321.           ========
  322.                 Edit your SFEXTUPx.BAT file.
  323.                 (x) meaning a, b, c, etc ....
  324.  
  325.                 Following is an exemple of file.
  326.                 ----------------------------------------------
  327.                 Echo Executing SPITFIRE'S External Protocol #1
  328.                 D:
  329.                 CD \sf\EXTNOD1
  330.                 DSZ port 2 pB4096 ha on rz -r -m
  331.                 SFVLAB d:\sf *.zip *.arj  *.lzh
  332.                 cd \sf
  333.  
  334.  
  335.   
  336.    page 7
  337.  
  338.           Command Line Options for TriBBS
  339.           ===============================
  340.  
  341.           Edit your upload.bat file and add this statement
  342.  
  343.           SFVLAB <pathname> %1
  344.  
  345.           Where <pathname> is the repertory where is SFVLAB.CFG
  346.           and %1 is the variable passed by TriBBS to upload.bat
  347.  
  348.           Don't forget to configure sfvlab in order to use these archive.
  349.           ------------
  350.  
  351.  
  352.           Exemple:   SFVLAB  d:\tribbs   %1
  353.           ────────           ---------   --
  354.  
  355.                              Pathname    Variable
  356.  
  357.           Please don't put a '\' at the end of the pathname.
  358.  
  359.           Config file (SFVLAB.CFG) don't need to be in the same directory
  360.           than SFVLAB.EXE.
  361.  
  362.  
  363.  
  364.  
  365.   page 8
  366.  
  367.  
  368.        SFVLAB at RUN
  369.        ====================================================================
  370.  
  371.  
  372.        Following are the result of an execution of SFVLAB on a file
  373.        named desk.arj.
  374.  
  375.  
  376.  
  377.   ╔══════════════════════════════════EXECUTION═══════════════════════════════╗
  378.   ║SFVLAB (c) 1991-92  JP Luiggi                                             ║
  379.   ║Version - v1.00 ßeta 3                                                    ║
  380.   ║Registered To [UNREGISTERED COPY]                                         ║
  381.   ║                                                                          ║
  382.   ║Processing : desk.Arj                                                     ║
  383.   ║k:\arj.exe   x -y f:\com\desk.Arj                                         ║
  384.   ║scan.Exe *.* /nomem                                                       ║
  385.   ║Testing For Date ...                                                      ║
  386.   ║mv.exe f:\com\desk.Arj f:\com\up /r                                       ║
  387.   ║                                                                          ║
  388.   ║                                                                          ║
  389.   ╚══════════════════════════════════════════════════════════════════════════╝
  390.   ╔════════════════════════════════════RESULT═════════════════════════════════╗
  391.   ║Welcome Jean                                                               ║
  392.   ║                                                                           ║
  393.   ║Some test will be applied to the upload(s)                                 ║
  394.   ║                                                                           ║
  395.   ║Processing : desk.Arj                                                      ║
  396.   ║Testing Archive File for Scratch ...... Ok !                               ║
  397.   ║Testing Archive File Integrity ........ Ok !                               ║
  398.   ║Scanning Archive File for Viruses ..... Ok !                               ║
  399.   ║Testing Archive File for Valid Date ... Ok !                               ║
  400.   ║                                                                           ║
  401.   ║                                                                           ║
  402.   ╚═══════════════════════════════════════════════════════════════════════════╝
  403.  
  404.  
  405.  
  406.   page 9
  407.  
  408.  
  409.            The first window shows what's happening on your local console
  410.  
  411.   ╔══════════════════════════════════EXECUTION═══════════════════════════════╗
  412.   ║SFVLAB (c) 1991-92  JP Luiggi                                             ║
  413.   ║Version - v1.00 ßeta 3                                                    ║
  414.   ║Registered To [UNREGISTERED COPY]                                         ║
  415.   ║                                                                          ║
  416.   ║Processing : desk.Arj                                                     ║
  417.   ║k:\arj.exe   x -y f:\com\desk.Arj                                         ║
  418.   ║scan.Exe *.* /nomem                                                       ║
  419.   ║Testing For Date ...                                                      ║
  420.   ║mv.exe f:\com\desk.Arj f:\com\up /r                                       ║
  421.   ║                                                                          ║
  422.   ║                                                                          ║
  423.   ╚══════════════════════════════════════════════════════════════════════════╝
  424.  
  425.        Processing : desk.Arj                 <───── File being checked ...
  426.  
  427.        k:\arj.exe   x -y f:\com\desk.Arj     <─────  Operation to decompress
  428.                                                      file, where 'k:'
  429.                                                      represent your work drive
  430.  
  431.        scan.Exe *.* /nomem                   <─────  Operation to scan file(s)
  432.  
  433.  
  434.        Testing For Date ...                  <─────  Operation to test date
  435.  
  436.        mv.exe f:\com\desk.Arj f:\com\up /r   <─────  Operation to move file
  437.                                                       from download rep to
  438.                                                       'good' or 'bad' rep
  439.  
  440.  
  441.  
  442.  
  443.   page 10
  444.  
  445.  
  446.        The second window send different info to the remote caller.
  447.        the infos show the result of the test applied
  448.        to the file uploaded.
  449.  
  450.  
  451.   ╔════════════════════════════════════RESULT═════════════════════════════════╗
  452.   ║Welcome Jean                                                               ║
  453.   ║                                                                           ║
  454.   ║Some test will be applied to the upload(s)                                 ║
  455.   ║                                                                           ║
  456.   ║Processing : desk.Arj                                                      ║
  457.   ║Testing Archive File for Scratch ...... Ok !                               ║
  458.   ║Testing Archive File Integrity ........ Ok !                               ║
  459.   ║Scanning Archive File for Viruses ..... Ok !                               ║
  460.   ║Testing Archive File for Valid Date ... Ok !                               ║
  461.   ║                                                                           ║
  462.   ║                                                                           ║
  463.   ╚═══════════════════════════════════════════════════════════════════════════╝
  464.  
  465.  
  466.        Welcome Jean Luiggi                           <─────  Name of caller
  467.  
  468.        Some test will be applied to the upload(s)    <─────  Info
  469.  
  470.        Processing : desk.Arj                         <─────  File being tested
  471.  
  472.        Testing Archive File for Scratch ...... OK !  <─────  Test for scratch
  473.        Testing Archive File Integrity ........ Ok !  <─────  Test for integrity
  474.        Scanning Archive File for Viruses ..... Ok !  <─────  Test for virus
  475.        Testing Archive File for Valid Date ... Ok !  <─────  Test for date
  476.  
  477.  
  478.  
  479.                                 IMPORTANT
  480.  
  481.  
  482.        If one test fails, current file will be moved to the 'BAD dir' and
  483.        SFVLAB.LOG will be updated with some informations including
  484.        file involved, date, time and error type.
  485.  
  486.  
  487.        If you have choosen to use the 'txt files' feature, this file
  488.        will be also updated.
  489.  
  490.  
  491.  
  492.   page 11
  493.  
  494.  
  495.        APPENDIX A: General Info
  496.        ====================================================================
  497.  
  498.         - SFVLAB.EXE and SFVLCFG.EXE aren't compressed so you can
  499.           use on it an Exe Compressor likes LZEXE or PKLITE.
  500.           Code size will decrease from about 50 %
  501.  
  502.         - SFVLAB can be run not only on a BBS but with your
  503.           favorite communication program.
  504.           You just need to configure and run it after
  505.           used your communication software.
  506.           With this, you'll able to check the files you've just downloaded.
  507.  
  508.  
  509.  
  510.  
  511.        APPENDIX B: Products and Trademarks
  512.        ====================================================================
  513.  
  514.           4DOS is a product of JP Software Inc.
  515.           ARJ is product of Robert K. Jung
  516.           DesqView is a trademark of Quarterdeck Office Systems.
  517.           LHA is a product of Haruyasu Yoshizaki.
  518.           LZEXE is a product of Fabrice Bellard.
  519.           MS-DOS is a trademark of Microsoft Corp.
  520.           PKLITE is a product of PKWARE.
  521.           PKPAK and PKUNPAK is a product of PKWARE.
  522.           PKZIP and PKUNZIP is a product of PKWARE.
  523.           SPITFIRE is a product of Buffalo Creek's Software.
  524.           Topspeed Modula-2 is a product of JPI International.
  525.           Scan is a product of McAfee Associates.
  526.           Slick Editor is a product of MicroEdge Inc.
  527.  
  528.