home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d9xx / d919 / bbbf.lha / BBBF / BootVirLib / Programmers / BootblockLibrary.doc next >
Text File  |  1993-10-04  |  13KB  |  378 lines
  1.  
  2.                           Bootblock.library
  3.                              version 3.1
  4.  
  5.                    Released the 26th of June 1993
  6.  
  7.              Programmed by Johan Eliasson, SHI member.
  8.             Copyright © Safe Hex International 1992,1993
  9.  
  10.  
  11. INTRODUCTION
  12. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  13. The Bootblock.library/brainfile is an attempt to make life a little
  14. bit easier for programmers of anti-virus utilities, diskcopy programs,
  15. directory utilities, disk packers and for whoever who wants to check the
  16. bootblock of some device, and of course for you, the user, who are dead-
  17. tired of those %$£&%$& viruses...
  18. The library has some easy-to-use functions to read the brainfile, and to
  19. check a bootblock with it. The brainfile will be kept in memory for
  20. you by the library, so that more than one program can use it simultaneously.
  21. I know this doc is short, but take a look at my CheckDrive.c source
  22. and you will get it. If not, write me a letter!
  23.  
  24. Each bootblock is identified with a checksum of four strategically chosen
  25. longwords.
  26.  
  27. I have about 600+ non-virus-bootblocks that I check every new version
  28. of the brainfile with, and so far there has been no false alarms!
  29.  
  30. Note that this is not a standard auto-doc file. It is typed by hand!
  31.  
  32. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  33. LEGAL STUFF
  34. ~~~~~~~~~~~
  35. The BBBF package is freely distributable as long as all of its files are
  36. included in their original form without additions, deletions, or
  37. modifications of any kind, with the following exception:
  38. If your program uses the Bootblock.library/Bootblock.brainfile then they
  39. may be distributed along with it.
  40. If you use this library in your program you must give credit to SHI (like
  41. the note below) and the programmer in your documentation.
  42. The BBBF package may not be used in a commercial program without written
  43. permission by Safe Hex International.
  44. Only a nominal fee (maximum 6$) may be charged for the distribution of BBBF.
  45. This software is provided "AS IS" without warranty of any kind, either
  46. expressed or implied. By using the BBBF package, you agree to accept the
  47. entire risk as to the quality and performance of the program.
  48.  
  49. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  50. A note about Safe Hex International:
  51.  
  52. If  you   know  a  virus  programmer  you  can  get  a reward of $ 1000 for
  53. supplying  his  name  and  address.  The fact is that the law punishes data 
  54. crime very severely. (5 years in jail in most countries).
  55.  
  56. We  are an international group with more than 250 members  who have started 
  57. trying to stop the spread of virus. Let me give you some example:
  58.  
  59.  
  60.         1. Our motto is: "Safe Hex", who dares do anything else today?".
  61.     2. A virus bank containing all well known virus killer programmes.
  62.     3. We help people to get money back lost by virus infection.
  63.         4. We  write articles about virus problems for 8 magazines.
  64.         5. We release the newest and the best virus killers around.
  65.         6. We have more than 20 "Virus Centers" worldwide  where you 
  66.            can get free virus help by phoning our "Hotline", and the
  67.            newest killers translated n your own language at very little
  68.            cost.
  69.  
  70. For more information contact:
  71.  
  72.         SAFE HEX INTERNATIONAL            (Please  send  a "Coupon-Response 
  73.         Erik Loevendahl Soerensen         International" and a self addres-
  74.         Snaphanevej 10                    sed  envelope, if you want infor-
  75.         DK-4720 Praestoe                  mation about SHI by letter).
  76.         Denmark                             
  77.         Phone: + 45 55 99 25 12
  78.         Fax  : + 45 55 99 34 98
  79.  
  80. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  81. TABLE OF CONTENTS
  82.  
  83. Bootblock.library/ReadBBBF
  84. Bootblock.library/FreeBBBF
  85. Bootblock.library/CheckBoot
  86. Bootblock.library/GetBBBFInfo
  87. Bootblock.library/ListBBBF
  88. Bootblock.library/ReadBoot
  89. Bootblock.library/WriteBoot
  90. Bootblock.library/InstallBoot
  91.  
  92. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  93. Bootblock.library/ReadBBBF
  94.  
  95.   result = ReadBBBF(name);
  96.  
  97.   long     ReadBBBF(char *);
  98.                     A0
  99.  
  100.   DESCRIPTION
  101.     Will read the Bootblock.brainfile from name, and keep it in memory
  102.     for you until you FreeBBBF() it.
  103.  
  104.   INPUTS
  105.     name = "L:Bootblock.brainfile" or wherever you want to load it from.
  106.  
  107.   RESULT
  108.     result = errorcode.
  109.     if result >  0  then result is the code returned by IoErr() in case
  110.                     of an IO error.
  111.     if result =  0  then the brainfile is successfully loaded and
  112.                     everything's fine.
  113.     if result = -1  It was no brainfile...strange...
  114.                 -2  Corrupted brainfile. Someone has fiddled with it.
  115.                 -3  Already loaded by someone else!
  116.                 -4  No memory for brainfile. Free some and try again...
  117.  
  118.  
  119. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  120. Bootblock.library/FreeBBBF
  121.  
  122.   result = FreeBBBF();
  123.  
  124.   void     FreeBBBF(void);
  125.  
  126.  
  127.   DESCRIPTION
  128.     Will free the memory used for the brainfile, ie. unload it.
  129.     If the brainfile is not loaded the function will just return.
  130.     You don't HAVE to do this. If you don't, it will be done when
  131.     the library is flushed.
  132.  
  133.   INPUTS
  134.     none
  135.  
  136.   RESULT
  137.     none
  138.  
  139. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  140. Bootblock.library/CheckBoot
  141.  
  142.   Boot = CheckBoot(buffer,&status);
  143.  
  144.   struct Bootblock *CheckBoot(char *,ULONG);
  145.                               A0     A1
  146.  
  147.   DESCRIPTION
  148.  
  149.   INPUTS
  150.     buffer = simply the bootblock that you want to check.
  151.     status = address of an ULONG. Status will afterwards contain one 
  152.              of the following values:
  153.              -1 : Error - The brainfile is not loaded.
  154.               0 : The bootblock is unknown.
  155.               1 : The bootblock is a virus! Kill it!
  156.               2 : The bootblock is not bootable...
  157.  
  158.   RESULT
  159.     Boot    Bootblock struct that contains the name of the bootblock etc.
  160.             If status != 1 then Boot will be NULL.
  161.  
  162.   NOTES
  163.     If the bootblock is a virus, then you'll have to append ' virus!' to
  164.     the name from the Bootblock struct. It saved me quite a lot of bytes
  165.     in the brainfile. 200 ' virus!' would be 1400 bytes...
  166.     I hope you don't mind! 8-)
  167.  
  168. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  169. Bootblock.library/GetBBBFInfo
  170.  
  171. result = GetBBBFInfo(&virus,version);
  172.  
  173. long     GetBBBFInfo(USHORT,char[30]);
  174.                      A0       A1
  175.  
  176.   DESCRIPTION
  177.  
  178.   INPUTS
  179.     virus   = will be the number of viruses known to this brainfile.
  180.     version = string that will contain the brainfile version-string,
  181.               without the '$VER: '.
  182.  
  183.   RESULT
  184.    result   If result == -1 then the brainfile is not loaded.
  185.             If success then result will be 0.
  186.  
  187.  
  188. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  189. Bootblock.library/ListBBBF
  190.  
  191. Boot = ListBBBF()
  192.  
  193. struct Bootblock *ListBBBF(void)
  194.  
  195.   DESCRIPTION
  196.     This function returns the pointer to the first Bootblock structure.
  197.     Useful for listing all known bootblocks etc.
  198.  
  199.   INPUTS
  200.     none
  201.  
  202.   RESULT
  203.     Boot   Pointer to the first Bootblock structure, or
  204.            NULL == the brainfile is not loaded.
  205.  
  206. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  207. Bootblock.library/ReadBoot
  208.  
  209. result = ReadBoot(drive,buffer);
  210.  
  211. ULONG    ReadBoot(ULONG,char *);
  212.                   D0    A0
  213.  
  214.   DESCRIPTION
  215.  
  216.     This function will read the bootblock from the desired drive,
  217.     using the trackdisk.device and CMD_READ.
  218.  
  219.   INPUTS
  220.  
  221.     drive  = drive number (0-3)
  222.  
  223.     buffer = the destination of the bootblock. Must be at least 1024
  224.              bytes. Note that it must be in chip ram if running
  225.              under kickstart V36 or below.
  226.  
  227.   RESULT
  228.  
  229.     result = either NULL = success,
  230.              or an errorcode returned by IoErr(),
  231.              Can occur during the OpenDevice() (see <exec/errors.h>
  232.              or the bootread (see <devices/trackdisk.h>)
  233.              It can also be 103 (out of memory).
  234.  
  235. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  236. Bootblock.library/WriteBoot
  237.  
  238. result = WriteBoot(drive,buffer);
  239.  
  240. ULONG    WriteBoot(ULONG,char *);
  241.                   D0    A0
  242.  
  243.   DESCRIPTION
  244.  
  245.     This function will write the bootblock to the selected drive.
  246.  
  247.   INPUTS
  248.  
  249.     drive  = drive number (0-3)
  250.  
  251.     buffer = the bootblock. Note that it must be in chip ram if running
  252.              under kickstart V36 or below.
  253.  
  254.   RESULT
  255.  
  256.     result = either NULL = success,
  257.              or an errorcode returned by IoErr(),
  258.              Can occur during the OpenDevice() (see <exec/errors.h>
  259.              or the bootwrite (see <devices/trackdisk.h>)
  260.              It can also be 103 (out of memory).
  261.  
  262. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  263. Bootblock.library/InstallBoot
  264.  
  265. result = InstallBoot(drive,bootnumber);
  266.  
  267. long   = InstallBoot(ULONG,USHORT)
  268.                      D0    D1
  269.  
  270.   DESCRIPTION
  271.  
  272.     This function will install an AmigaDOS bootblock to the selected drive.
  273.  
  274.   INPUTS
  275.  
  276.     drive : drive number (0-3)
  277.  
  278.     bootnumber : 0 = 1.x OFS
  279.                  1 = 1.3 FFS
  280.                  2 = 2.0 OFS
  281.                  3 = 2.0 FFS
  282.                  4 = 2.0 OFS International
  283.                  5 = 2.0 FFS International
  284.                  6 = 3.0 OFS DirCache
  285.                  7 = 3.0 FFS DirCache
  286.  
  287.   RESULT
  288.  
  289.     result : either NULL = success,
  290.              or an errorcode returned by IoErr(),
  291.              Can occur during the OpenDevice() (see <exec/errors.h>
  292.              or the bootwrite (see <devices/trackdisk.h>)
  293.              It can also be 103 (out of memory),
  294.              or -99 = illegal bootnumber (must be 0 - 7).
  295.  
  296. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  297.  
  298. LIBRARY HISTORY
  299. ~~~~~~~~~~~~~~~
  300.  
  301. Version 0.9 beta
  302. ~~~~~~~~~~~~~~~~
  303. First version.
  304.  
  305. Version 0.91 beta
  306. ~~~~~~~~~~~~~~~~~
  307. Removed all non-virus bootblocks from the brainfile upon request from
  308. Erik Loevendahl Soerensen. Now you will only be alerted if the bootblock
  309. contains a virus, anti-virus, or any other suspicious resident program.
  310. This is for speed and so that the user won't be bothered with messages
  311. like 'This bootblock is the MegaSuperDemoLoader 32.84' all the time.
  312. The GetBBBFInfo() function is changed accordingly.
  313. I have tried to clean up this doc a bit too. There were a few obvious
  314. mistakes that I guess you spotted.
  315. BBBF now knows 171 original viruses, and a vast number of clones.
  316.  
  317. Version 0.92 beta (15.10.92)
  318. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  319. V 0.91 didn't recognize the Chameleon (little Sven) virus correctly.
  320. Instead of adding a short piece of code to deal with that, I rewrote
  321. the complete brainfile-system, so it will be easier to add new viruses
  322. to the brainfile from now on. As a result of that, the Bootblock structure
  323. has changed a bit. Also, ReadBBBF() and CheckBoot() are a little bit slower,
  324. and the brainfile is 656 bytes bigger......but a lot safer!
  325. BBBF now knows 164 original viruses, and a vast number + 7 clones.
  326.  
  327. Version 0.93 beta (05.11.92)
  328. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  329. Bug fix: If the brainfile-reading was interrupted due to lack of memory,
  330.          the already allocated memory would not be freed correctly. 
  331.  
  332. Version 1.0 (11.11.92)
  333. ~~~~~~~~~~~~~~~~~~~~~~
  334. New function - ReadBoot().
  335. I also optimized the library down to 2876 bytes!
  336.  
  337. Version 1.01 (12.12.92)
  338. ~~~~~~~~~~~~~~~~~~~~~~~
  339. Now you don't HAVE to free the memory with FreeBBBF() when you exit.
  340. If you don't, it will be freed automagically when the library is flushed.
  341.  
  342. Version 2.00 (16.12.92)
  343. ~~~~~~~~~~~~~~~~~~~~~~~
  344. New function - WriteBoot().
  345.  
  346. I learned that OpenLibrary() is case-sensitive. And I have spelled
  347. Bootblock.library with a capital B... so if your OpenLibrary() fails,
  348. that might be the cause...
  349.  
  350. Version 3.00 (02.03.93)
  351. ~~~~~~~~~~~~~~~~~~~~~~~
  352. New function - InstallBoot()
  353.  
  354. Version 3.1 (26.06.93)
  355. ~~~~~~~~~~~~~~~~~~~~~~
  356. Corrected the version-string as you can see.
  357. Changed a few other internal things.
  358.  
  359.  
  360. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  361.  
  362. Please, I need your opinions! Even if you have no complaints nor ideas
  363. it's nice just to hear that it works... 8-)
  364. Send new viruses, ideas, threats and harddrives to:
  365.  
  366.              Johan Eliasson             Phone: +46 11 169138
  367.              Bäckgatan 6
  368.              60358 Norrköping
  369.              SWEDEN
  370.  
  371. Thanks goes to Magnus Holmgren and Tommy Hallgren for helping out with my
  372. C problems, Tommy Hallgren and Mats Erlandsson for testing!
  373. Erik Loevendahl Soerensen at SHI for all his support.
  374. John Lohmeyer, whose Interpret.library I used as a model when designing
  375. this library. Thanks guys!
  376.  
  377. END OF DOC.
  378.