home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / misc / bootx450.lha / BootX4.50 / BootX.doc < prev    next >
Encoding:
Text File  |  1992-05-08  |  38.6 KB  |  1,346 lines

  1.  
  2.  
  3.                     BootX v4.50 User's Manual                   1
  4.  
  5.  
  6.                            BootX v4.50
  7.  
  8.           Copyright ⌐ 1989, 1990, 1991, 1992 Peter Stuer
  9.                        All rights reserved
  10.  
  11.                     Release date May 7, 1992
  12.  
  13.                             FREEWARE
  14.  
  15.                            User Manual
  16.                     KickStart 2.0 compatible
  17.  
  18.  
  19. COPYRIGHT NOTICE 
  20.  
  21.   BootX software and documentation are ⌐ 1989, 1990, 1991, 1992
  22. by Peter Stuer. All rights reserved 
  23.  
  24.  
  25. DISCLAIMER 
  26.  
  27.   BootX has been thoroughly tested and is the result of a
  28. constant process of changes and updates that started in April
  29. 1989.  The program has proven to be stable in everyday use.  The
  30. author is not responsible for any loss of data, damages to
  31. software or hardware that may result directly or indirectly from
  32. the use of this program.  The author reserves the right to make
  33. changes to the software or documentation without notice.  
  34.  
  35.  
  36. PREFACE 
  37.  
  38.   This program is freeware, this means that you can copy it
  39. freely as long as you don't ask any more money for it than a
  40. nominal fee for copying.  If you want to distribute this program
  41. you should keep this document with it.  This program cannot be
  42. used for commercial purposes without written permission from the
  43. author.  
  44.  
  45.   Special permission is hereby granted to include BootX in
  46. Public-Domain collections such as Fred Fish's Amiga Library.  
  47.  
  48.  
  49. HOW TO GET THE LATEST VERSION OF BOOTX 
  50.  
  51.   If you send me a 3╜" disk and a letter to get the most recent
  52. version of BootX, please don't forget to include enough stamps
  53. or money to send your disk back.  BootX has been generating a
  54. lot of mail and most of the times I had to pay the postal fee
  55. myself to send the disk back.  Remember, BootX itself is a
  56. FREEWARE so no money is expected for it (although I won't refuse
  57. it, grin...).  
  58.  
  59.   And please, state your name and address clearly in print
  60. because sometimes they are nearly impossible to decipher.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                     BootX v4.50 User's Manual                   2
  68.  
  69.  
  70.   Every letter with a disk AND money will be answered AS SOON AS
  71. POSSIBLE...  
  72.  
  73.   If you have suggestions or remarks about this program, or if
  74. you find any bugs, please let me know.  
  75.  
  76.   If you find any new viruses or linkviruses that BootX does not
  77. recognize yet, please send them on a disk to me (my address
  78. follows this paragraph).  I will return the disk to you with an
  79. updated copy of BootX.  
  80.  
  81. Write to the following address: 
  82.  
  83.         Peter Stuer
  84.         Kauwlei 21
  85.         B-2550 Kontich
  86.         Belgium - Europe
  87.  
  88. I will also try to put the latest available version of BootX on
  89. the following BBS (this may change without further notice): 
  90.  
  91.  
  92.         Great Balls Of Fire BBS 
  93.         Herman Stevens 
  94.         Lubbeek 
  95.         ADS Regional Coordinator Belgium 
  96.         Tel. +32-(0)16-64.09.12 
  97.         2400 BPS N.8.1 
  98.         24-24 h.  
  99.         Fido Node 2:292/603 
  100.  
  101.  
  102. A MESSAGE FROM OUR SPONSORS...  
  103.  
  104.   Our motto: "Safe Hex..." 
  105.  
  106.   BootX can be kept up to date thanks to the energy and work put
  107. into a global anti-virus information bank founded by Erik
  108. L°vendahl S°rensen from Denmark.  
  109.  
  110.   This group has over 120 international members now, among them
  111. some of the programmers of wellknown anti-virus programs like
  112. Steve Tibbet and Jonathan Potter.  Among the activities of this
  113. group are: 
  114.  
  115. - Spreading information to anti-virus programmers as fast as
  116.   possible.
  117.  
  118. - Trying to get names and proof against virus programmers and
  119.   giving the information to the justice departement of his/her
  120.   country to press charges.
  121.  
  122. - Writing articles in popular magazines to inform new Amiga
  123.   users about viruses and how to protect themselves.
  124.  
  125.   Also the organization is prepared to pay $ 1000 US for the
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                     BootX v4.50 User's Manual                   3
  132.  
  133.  
  134. name and the address of a virus programmer.  All information
  135. will be delt with confidentially and will be handed over to the
  136. proper authorities of the virus programmer's country.  
  137.  
  138.   All this is volunteer work.  If you want some more information
  139. about this organization or you want to sponsor our work, contact
  140. Erik at the following address: 
  141.  
  142.         SAFE HEX INTERNATIONAL
  143.         Erik L°vendahl S°rensen
  144.         Snaphanevej 10
  145.         DK-4720 Prµst°
  146.         Denmark - Europe
  147.  
  148.         Phone: 00 45 55 99 25 12
  149.         Fax  : 00 45 55 99 34 98
  150.         Fidonet 2:23424/43
  151.  
  152. In Erik's words:
  153.  
  154. "We are an international group with more than 250 members who have
  155. started trying to stop the spread of viruses. Let me give you some
  156. examples:
  157.  
  158.         1. Our motto is: "Safe Hex"
  159.         2. A virus bank containing all well known viruskiller
  160.            programs.
  161.         3. We help people to get money back lost by virus infection
  162.         4. We write articles about viruses for 8 magazines.
  163.         5. We release the newest and the best viruskillers around.
  164.         6. We have more than 20 "Virus Centers" worldwide where
  165.            you can get free virus help by phoning our "Hotline",
  166.            and the newest killers translated in your own language
  167.            at very little cost."
  168.  
  169. THE AUTHOR 
  170.  
  171.   Since so many people keep asking me about it...  I graduated
  172. in June 1991 as a programmer-analyst and am currently working in
  173. a software firm.  
  174.  
  175.   I use an Amiga A3000 25/100 with 6 Mbytes memory, 2 3╜" drives,
  176. 1 5╝" drive and a Supra2400 modem.  
  177.  
  178.   BootX has been created using DevPac Assembler, WShell 2.0 and
  179. CygnusEd Professional.  
  180.  
  181.  
  182. PACKAGE 
  183.  
  184. The BootX package consists of: 
  185.  
  186.         BootX                   The program file
  187.         BootX.BBLib             The BootX bootblock library
  188.         BootX.Brain             An example of a brainfile
  189.         BootX.Recog             Recognition information
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                     BootX v4.50 User's Manual                   4
  196.  
  197.  
  198.         BootX.doc               This file
  199.         BootX.history           Complete history of BootX
  200.         BootX.alarm             An example of an alarm sample
  201.  
  202.   Note that the BootX.BBLib or the BootX.Brain files are not
  203. required to run the program.  BootX will display an errormessage
  204. when either of these two files are not found.  The BootX.Recog
  205. is required if you want to do any checking.  
  206.  
  207.  
  208. REQUIREMENTS 
  209.  
  210.   BootX v4.50 should run on any Amiga starting from the A500 all
  211. the way up to the A3000, any of these models with or without
  212. processor expansion boards.  
  213.  
  214.   BootX has been tested with KickStart 1.3 and 2.0 on all three
  215. Amiga models except the Amiga 1000 (but there is no reason why
  216. it should not run on this model).  
  217.  
  218.   Should you have any trouble running BootX on your machine,
  219. please write to me with the full specifications of your machine,
  220. that is KickStart version, model, expansion boards etc...  
  221.  
  222.   When BootX detects the ReqTools library (by Nico Franτois) it
  223. will use it for its requesters.  Make sure you have the correct
  224. version installed on your system.  ReqTools is copyrighted 1991
  225. by Nico Franτois.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                     BootX v4.50 User's Manual                   5
  260.  
  261.  
  262. Chapter 1 Introducing BootX     
  263.  
  264. 1.1 Short introduction      
  265.  
  266.   BootX v4.50 is an attempt to make the ultimate viruskiller.
  267. BootX v4.50 is fast (written completely in assembler), small and
  268. tries to be as user friendly as possible.  Among the many
  269. features supported by BootX are: 
  270.  
  271. ╖ Configurable link and file virus check 
  272.  
  273. ╖ KickStart 2.0 look and feel (even with KickStart 1.2 & 1.3).  
  274.  
  275. ╖ BootX can scan your disks or hard-disk and generate a report of 
  276.   the file types and viruses found. The report can be saved to 
  277.   disk for later reviewing.  
  278.  
  279. ╖ Saveable settings.  
  280.  
  281. ╖ KickStart 2.0 SetPatch support.  
  282.  
  283. ╖ Loads bootblock libraries with several alternative bootblocks.  
  284.  
  285. ╖ Allows you to create your own brain files to recognize the 
  286.   bootblocks of your disks.  
  287.  
  288. ╖ Allows you to load and save bootblocks to disk as a protection 
  289.   against virus attacks.  
  290.  
  291. ╖ Audible alarm when a virus or unknown bootblock is found.  
  292.  
  293. ╖ AmigaDOS Release 2 (KickStart & Workbench 2.0) compatible and 
  294.   aware.  
  295.  
  296. ╖ PAL/NTSC/INTERLACE aware.  
  297.  
  298. ╖ Written completely in Assembler.  
  299.  
  300.  
  301. 1.2 Installing BootX      
  302.  
  303.   KickStart 1.3 users need to copy the 1.3 version of the
  304. ReqTools library to their LIBS:  directory.  For KickStart 2.0
  305. users this is optional but it will make the usage of BootX more
  306. comfortable.  
  307.  
  308. To run, BootX only requires the BootX executable.  BUT:  If you
  309. want to install different bootblocks, BootX needs the
  310. BootX.BBLib file.  
  311.  
  312. If you want to check for viruses of any kind, the BootX.  Recog
  313. file is needed which contains the identifaction patterns BootX
  314. uses.  
  315.  
  316. The BootX.Brain file is simply included as an example.  It is
  317. advisable you create your own brainfile, should you encounter a
  318.  
  319.  
  320.  
  321.  
  322.  
  323.                     BootX v4.50 User's Manual                   6
  324.  
  325.  
  326. bootblock that BootX does not yet recognize. If the bootblock is
  327. added to the Recog file later, BootX will use that information.  
  328.  
  329. When BootX finds a file called 'BootX.alarm' in the directory
  330. from which it started, and this file is a FORM 8SVX sound
  331. sample, BootX will play this sample every time an unknown
  332. bootblock or a boot-, file or linkvirus is detected.  The FORM
  333. 8SVX file format is the standard Amiga file format for audio
  334. samples.  All the major sound digitizers or editing programs use
  335. this file format.  BootX will use the settings it finds in the
  336. file to play the sample.  
  337.  
  338. Also, when start BootX for the first time, there will be no
  339. BootX.Prefs file in your S: directory. Use the Save Settings
  340. menu item when you first start BootX to create one (read on).  
  341.  
  342.  
  343. Chapter 2 How to start BootX   
  344.  
  345.   BootX v4.50 (from here on referred to as BootX) was written to
  346. be used by both beginners and experienced users.  BootX can be
  347. started both from CLI and the Workbench.  
  348.  
  349.  
  350. 2.1 Starting BootX from the CLI   
  351.  
  352. To start BootX from the CLI simply type: 
  353.  
  354.         1> BootX 
  355.  
  356. followed by a return.  This loads the BootX program and starts
  357. it.  BootX then detaches itself from the CLI.  This means that
  358. you can start BootX without using the run command, bring the
  359. Workbench screen back to the front and then close the CLI window
  360. with the EndCLI command.  
  361.  
  362. NOTE: BootX tries to load the BootX.BBLib, BootX.Brain and
  363. BootX.Recog files from the current directory. If your current
  364. directory is not the same as the one BootX is in, change to it
  365. with the CLI command CD: 
  366.  
  367.         1> cd <BootX directory> 
  368.  
  369.  
  370. 2.2 Starting BootX from the WorkBench   
  371.  
  372.   This is the easy part.  Simply click on the accompaning icon
  373. and BootX starts.  
  374.  
  375. NOTE:  Workbench 2.0 users can also use the Execute Command item
  376. from the Workbench menu to run BootX.  
  377.  
  378.  
  379. Chapter 3 How to use BootX: a guided 
  380.  
  381.   A lot of viruscheckers and viruskillers have already written
  382.  
  383.  
  384.  
  385.  
  386.  
  387.                     BootX v4.50 User's Manual                   7
  388.  
  389.  
  390. for the Amiga but none of them offered all the features I
  391. needed.  Hence the various disks offering several different
  392. programs for doing the job.  Enters BootX.  
  393.  
  394.   BootX can check the bootblock of a disk, check memory for any
  395. resident viruses and scan a disk for link and fileviruses.  It
  396. can load bootblock libraries with bootblocks for you to write on
  397. your disks as an alternative for the boring DOS Install
  398. bootblock.  It can load "brain files" so you can add any new
  399. bootblocks that BootX does not recognise yet.  
  400.  
  401.   Let's start a guided tour of the screen.  The main screen
  402. offers several gadgets and menus.  Just click the appropriate
  403. gadget or select a menu item to perform an action.  
  404.  
  405.  
  406. 3.1 Quit       
  407.  
  408.   Does just what the gadget says:  it releases all used memory
  409. and quits the program.  
  410.  
  411.   Before BootX quits it will check to see if you have made any
  412. changes to the brain file. If so, it will ask you first if you
  413. want to save the changes you have made.  
  414.  
  415. NOTE:  Watch out that you don't leave any infected disks in your
  416. drives when you quit BootX ! Especially disks that are infected
  417. with disk-validator viruses.  
  418.  
  419.  
  420. 3.2 Read BB      
  421.  
  422.   This gadget explicitly instructs BootX to read the bootblock
  423. from the current selected drive into the buffer.  Normally BootX
  424. detects when a new disk is inserted and automatically reads its
  425. bootblock.  But some old 5╝ drives don't support this automatic
  426. diskchange.  This gadget can also be used to read the bootblock
  427. after another program has modified the bootblock.  
  428.  
  429.   You will also need to use this gadget when you have turned of
  430. the auto-diskchange detection or when you have locked a drive
  431. (see further).  
  432.  
  433.  
  434. 3.3 Write BB      
  435.  
  436.   Here you instruct BootX to write the bootblock currently in
  437. the buffer to the selected drive.  BootX maintains a buffer that
  438. holds the last read bootblock.  This buffer is also visible in
  439. the large display window in semi-ASCII form (more about this
  440. later).  The buffer allows you to read a bootblock from one disk
  441. and then copy it to another.  
  442.  
  443.  
  444. 3.4 The 4 drive gadgets    
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.                     BootX v4.50 User's Manual                   8
  452.  
  453.  
  454.   You can connect 4 disk drives to the Amiga.  BootX checks how
  455. many drives are connected to the Amiga and installs a gadget for
  456. every one of them.  
  457.  
  458.   When a drive is not found its radiobutton will be ghosted.
  459. Note that although a drive is connected the Amiga will not
  460. recognize its presence when it is turned off (only applicable
  461. for external drives).  
  462.  
  463.  
  464. 3.5 Lock Drive      
  465.  
  466.   Normally when you insert a disk in the disk-drive, the Amiga
  467. tries to see if the checksum of the disk is OK. When it is not,
  468. the Amiga tries to validate it. Pre-2.0 KickStarts need to load
  469. and execute a program called Disk-Validator from the L directory
  470. to check and/or repair the checksum.  
  471.  
  472.   When a disk-drive is 'locked', BootX will prevent AmigaDOS
  473. from validating your disk. This also means that Disk-Validator
  474. viruses have no chance of getting in. You can insert and remove
  475. disks as many times as you like.  
  476.  
  477.   Also the automatic diskchange detect will be temporarily
  478. disabled.  
  479.  
  480.  
  481. 3.6 Install       
  482.  
  483.   Here you can write the selected built-in bootblock to the
  484. bootblock of the current drive.  When no bootblock library is
  485. loaded only the normal AmigaDOS Install v1.3 bootblock is
  486. available.  
  487.  
  488.   At startup BootX looks for a file called "BootX.BBLib" in the
  489. directory from which BootX started.  It contains several
  490. alternative bootblocks.  It is possible to load another
  491. bootblock library using the "Load bootblock library" menuitem
  492. (see further).  
  493.  
  494.  
  495. 3.7 Next and Previous (< and >)  
  496.  
  497.   These gadgets show the next or the previous bootblocks in the
  498. currently loaded bootblock library.  If no library is loaded,
  499. only the normal AmigaDOS Install 1.3 bootblock will be
  500. available.  
  501.  
  502.   Among the bootblocks are the normal DOS bootblock, Ralph
  503. Babel's Install2 and several others.  Thanks to all groups and
  504. programmers whose bootblock I included.  Note however that when
  505. you press Next and Previous the bootblock buffer is not
  506. updated.  
  507.  
  508.  
  509. 3.8 Built-in bootblock name     
  510.  
  511.  
  512.  
  513.  
  514.  
  515.                     BootX v4.50 User's Manual                   9
  516.  
  517.  
  518.  
  519.   This window shows the name of the selected built-in
  520. bootblock.  
  521.  
  522.  
  523. 3.9 Message window      
  524.  
  525.   This window reports messages and errors resulting from the
  526. various operations.  
  527.  
  528.  
  529. 3.10 Main display window     
  530.  
  531.   Shows the bootblock that is currently in the buffer in
  532. semi-ASCII representation.  Only the readable characters are
  533. shown.  This allows you to check for readable text signifying
  534. the nature of the bootblock when BootX reports "Unknown
  535. bootblock".  
  536.  
  537.   The main display window is also used for the output of several
  538. other BootX functions.  
  539.  
  540.  
  541. Chapter 4 The BootX Project Menu items  
  542.  
  543. 4.1 Load Bootblock library     
  544.  
  545.   Selecting this menuitem (or the key combination Right-Amiga-B)
  546. allows you to load another bootblock library than the default
  547. BootX.BBLib.  BootX will only load valid bootblock libraries.  
  548.  
  549.  
  550. 4.2 Load Recog file     
  551.  
  552.   As of BootX v4.30 all the recognition information BootX needs
  553. to identify a virus or a bootblock is contained in a file called
  554. BootX.Recog. Here you can load different BootX.Recog files than
  555. the one BootX loads at started called "BootX.Recog".  
  556.  
  557. NOTE: The BootX.Recog files are coded and protected by a
  558. checksum to prevent anyone from modifying the information it
  559. contains with a file editor.  
  560.  
  561. Always try to get the latest version of the BootX.Recog file to
  562. get maximum protection. You can find out the version of a
  563. BootX.Recog file in several ways: 
  564.  
  565. 1. After BootX has succesfully loaded a recog file it will display
  566.    the version and the release date of the file.
  567.  
  568. 2. Select the About menu item. The text will show the version and
  569.    the release date of the recog file and how many bootblocks,
  570.    bootviruses and fileviruses it knows.
  571.  
  572.    NOTE: these numbers may vary from the number reported by the
  573.          "Show known xxx" menu items. The numbers reported here
  574.  
  575.  
  576.  
  577.  
  578.  
  579.                     BootX v4.50 User's Manual                  10
  580.  
  581.  
  582.          are the number of recog blocks that BootX can use to
  583.          identify a virus. The "Show known xxx" menu items only
  584.          report all the different names that BootX uses, f.e.
  585.          BootX can recognize several different mutants of the
  586.          same virus but the name will only show up once in the
  587.          the "Show known bootviruses" list.
  588.  
  589. 3. Use the Workbench 2.x version command:
  590.  
  591.         1> version BootX.Recog
  592.  
  593.  
  594. 4.3 Clear Brainfile      
  595.  
  596.   Removes a brain file from memory (see further).  
  597.  
  598.  
  599. 4.4 Load Brainfile      
  600.  
  601.   Selecting this menuitem (or the key combination Right-Amiga-L)
  602. allows you to load another brainfile than the default
  603. BootX.Brain.  BootX will load only valid brainfiles.  Before
  604. loading it asks you if you want this brainfile to replace the
  605. one in memory.  
  606.  
  607.  
  608. 4.5 Save Brainfile      
  609.  
  610.   Selecting this menuitem (or the key combination Right-Amiga-S)
  611. allows you to save the brainfile that is currently in memory.  
  612.  
  613.   If you forget to save the brainfile before you try to quit
  614. BootX, the program will warn you if the brainfile has been
  615. changed. You will then get another chance to save the
  616. brainfile.  
  617.  
  618.  
  619. 4.6 View Brainfile      
  620.  
  621.   This menuitem allows you to view all the entries that are in
  622. the brainfile that is in memory.  
  623.  
  624.  
  625. 4.7 Merge Brainfile      
  626.  
  627.   Sometimes it happens that two BootX users have different
  628. entries in their brainfiles. This menuitem allows you to merge
  629. any brainfile with the one in memory. BootX will only add an
  630. entry that is not yet present. Don't forget to save the new
  631. brainfile to disk.  
  632.  
  633.  
  634. 4.8 Show known bootblocks     
  635.  
  636.   This menuitem will produce a list of all the bootblocks and
  637. bootblock viruskillers BootX knows.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.                     BootX v4.50 User's Manual                  11
  644.  
  645.  
  646.  
  647.  
  648. 4.9 Show known bootviruses     
  649.  
  650.   This menuitem will produce a list of all the bootviruses BootX
  651. knows.  
  652.  
  653.  
  654. 4.10 Show known fileviruses     
  655.  
  656.   This menuitem will produce a list of all the file- and
  657. linkviruses BootX knows.  
  658.  
  659.  
  660. 4.11 Goto sleep      
  661.  
  662.   Closes the main BootX screen and releases as much memory as
  663. possible.  A small window on the workbench screen will be opened
  664. showing you that BootX is still in memory.  
  665.  
  666.   In this state BootX uses no CPU time and just waits for you to
  667. make the window active and click in it with the menu button (the
  668. right mouse button).  Then the main BootX screen and window is
  669. opened again and you can go on again.  
  670.  
  671.   BootX does not unload a brain file or a bootblock library.
  672. Also, when asleep, BootX doesn't do any checking (like VirusX
  673. does).  I did this on purpose.  There is no need to continuously
  674. keep checking every disk that is inserted.  Just check them once
  675. to make sure they are virus-free.  
  676.  
  677.  
  678. 4.12 About       
  679.  
  680.   Displays information about BootX and the version number.
  681. Always try to get the latest version available to have optimum
  682. virus protection.  
  683.  
  684.   You can also find out which version of the BootX.Recog you are
  685. using and how many viruses and bootblocks it knows.  
  686.  
  687.  
  688. 4.13 Quit       
  689.  
  690.   Guess what this one does...  
  691.  
  692.  
  693. Chapter 5 The BootX Bootblock Menu items  
  694.  
  695. 5.1 Load/Save       
  696.  
  697.   BootX can save the bootblock in the buffer to any valid
  698. drive.  'Save' can be used to save the bootblocks of games, mega
  699. demos and other programs to a separate data disk.  
  700.  
  701.   In case of a virus attack or a bad disk you can load the
  702.  
  703.  
  704.  
  705.  
  706.  
  707.                     BootX v4.50 User's Manual                  12
  708.  
  709.  
  710. previously saved bootblock back in the buffer and write it back
  711. to the original disk.  
  712.  
  713.   'Load' will only allow you to load a file that contains a
  714. valid bootblock.  It checks if it is an Old or Fast File System
  715. bootblock and then recalculates the checksum of the bootblock.  
  716.  
  717.   When the bootblock checksum is wrong, BootX will ask you if
  718. you want to repair it.  If you select Yes, BootX repairs the
  719. bootblock checksum of the loaded copy.  
  720.  
  721.  
  722. 5.2 Learn       
  723.  
  724.   This menu item prompts you for a name when BootX does not
  725. known the bootblock in the buffer yet.  Enter an empty string
  726. when you want to cancel the operation.  BootX then adds the
  727. bootblock to the current brain file (if present).  Otherwise it
  728. makes a brain file in memory.  
  729.  
  730.  
  731. Chapter 6 The BootX Files Menu items  
  732.  
  733. 6.1 Check Files      
  734.  
  735.   Selecting this menu item pops up a requester allowing you to
  736. set your preferences for the file- and linkvirus check.  
  737.  
  738.   To close the requester, click the CloseWindow gadget.  
  739.  
  740. 6.2 Check Files Options     
  741.  
  742. 6.2.1 Skip Directories      
  743.  
  744.   When this option is on BootX will skip any subdirectories it
  745. encounters during a scan.  This option allows you to make a
  746. quick scan of the root of a disk or hard-disk.  
  747.  
  748.  
  749. 6.2.2 Check crunched executables     
  750.  
  751.   When this option is enabled, BootX tries to decrunch all
  752. crunched executables in memory and then checks the file for
  753. viruses.  Note that this will slow down a file check
  754. considerabely.  
  755.  
  756. Recognized crunchers: 
  757.         PowerPacker 3.0 
  758.         PowerPacker 4.0 
  759.         TNM Cruncher 1.1 
  760.  
  761. 6.2.3 Enter interactively      
  762.  
  763.   When this option is active BootX asks if it should enter a
  764. directory everytime it encounters one.  This is handy for
  765. scanning hard-disks with lots of directories.  A requester pops
  766.  
  767.  
  768.  
  769.  
  770.  
  771.                     BootX v4.50 User's Manual                  13
  772.  
  773.  
  774. up giving you the option to enter the directory (select the Yes
  775. gadget) or skip this directory (select the No gadget).  
  776.  
  777.  
  778. 6.2.4 Auto-remove read-protection      
  779.  
  780.   AmigaDOS 2.0 recognizes and honours the protection bits of a
  781. file.  That means that if the read protection is on, programs
  782. are not allowed to read that file.  When BootX encounters such a
  783. file it will ask you if you want to remove the read protection
  784. of the file.  
  785.  
  786.   If you select Yes BootX retains all previous protection bits
  787. with exception of the read protection bit.  Read protection will
  788. be turned off and the file will be re-checked.  
  789.  
  790.   If you wish to restore the read protection afterwards, use the
  791. AmigaDOS command Protect like this: 
  792.  
  793.         1> protect <filename> -r 
  794.  
  795. which will give the file its read protection back.  
  796.  
  797.   If you select this option, the Auto-skip option will be turned
  798. off.  See further.  
  799.  
  800.  
  801. 6.2.5 Auto-skip read-protected files     
  802.  
  803.   It happens sometimes that you want to protect some files on
  804. your disks or hard-disk from reading by removing the read
  805. protection bit.  
  806.  
  807.   When this option is selected, BootX will ignore all read
  808. protected files.  It will count them though.  
  809.  
  810.   If you select this gadget, the Auto-remove option will be
  811. turned off.  See higher.  
  812.  
  813.  
  814. 6.2.6 Handle viruses automatically     
  815.  
  816.   When BootX encounters a virus it will ask you if it should use
  817. any of the three mark methods you specified.  Select this option
  818. when you want BootX to handle all viruses automatically when it
  819. encounters them.  
  820.  
  821. HINT: These last two options are especially handy when checking 
  822.       hard-disks with a lot of files on them.  
  823.  
  824.  
  825. 6.2.7 Virus Mark options     
  826.  
  827.   You can choose any of the three mark options that specify what
  828. BootX should do with a virus.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.                     BootX v4.50 User's Manual                  14
  836.  
  837.  
  838.   You can add a filenote to the file, delete the file or rename
  839. the file.  
  840.  
  841.   When BootX renames the file it will use a name that is
  842. composed of the virus name and a special counter that ensures
  843. that all virus names are unique.  
  844.  
  845.   The filenote or comment that BootX adds to the file specifies
  846. the name of the virus and which version of BootX detected it.
  847. This comment can be seen when you use the 'List' command in the
  848. CLI or the Shell to list the files of a directory.  
  849.  
  850.  
  851. 6.2.8 Report features      
  852.  
  853.   These options allow you to generate a report of your disk or
  854. hard-disk.  At the end of the virus check will BootX ask you
  855. what to do with the report.  You can either take a look at it or
  856. save it to disk.  
  857.  
  858.   Normally BootX only reports files that are infected or have
  859. errors in them.  When you turn on the Report File types option
  860. BootX will add every file it encounters to the report together
  861. with its file type.  
  862.  
  863.  
  864. 6.2.9 Check files      
  865.  
  866.   This gadget pops up the file requester for you to specify a
  867. device to search for file- and linkviruses.  You can select any
  868. AmigaDOS device that supports a file system.  You can also
  869. specify a particular directory to check.  
  870.  
  871.   When you select OK BootX starts searching for viruses in any
  872. file it encounters according to the preferences you specified.  
  873.  
  874.   During the file check you can press the right mousebutton to
  875. pause.  Press the left mousebutton to stop the file check.  
  876.  
  877.   When BootX finds a virus it will bring the BootX screen to the
  878. front and, depending on the state of the Audible Alarm flag,
  879. will play the sample found in the file 'BootX.alarm' or beep the
  880. 'display'.  
  881.  
  882.  
  883. 6.3 Show report again     
  884.  
  885.   This menu item allows you to see the last generated report
  886. again.  
  887.  
  888.  
  889. 6.4 Save report      
  890.  
  891.   This menu item allows you to save the last generated report to
  892. disk.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.                     BootX v4.50 User's Manual                  15
  900.  
  901.  
  902.  
  903. 6.5 Check Disk      
  904.  
  905.   When you select this menu item, BootX will put up a requester
  906. that allows you to specify which actions BootX should perform
  907. when performing a complete disk check.  
  908.  
  909.         Check bootblock: checks the bootblock 
  910.  
  911.         Check tracks   : performs the Repair Disk action 
  912.  
  913.         Check files    : performs the Check Files action 
  914.  
  915. All these actions will be performed on the disk in the drive
  916. currently selected.  
  917.  
  918.  
  919. 6.6 Repair Disk      
  920.  
  921.   Currently this menu item allows you to repair the damage done
  922. by the Saddam disk-validator virus.  This virus will corrupt the
  923. bitmap of a disk and encode the data blocks on a disk.  
  924.  
  925.   As long as the virus is in memory, these blocks get decoded
  926. invisibly every time they are accessed.  This way you don't
  927. notice there is anything wrong.  But when you use that disk on
  928. an uninfected Amiga, these block will be unusable.  
  929.  
  930.   Repair Disk scans a disk and tries to repair the damage.  Make
  931. sure there is no virus in memory (especially not the Saddam
  932. virus).  BootX will do a memory scan just to be safe and removes
  933. the virus if it is found.  
  934.  
  935.   BootX then locks the current drive (make a different drive
  936. current using the 4 drive gadgets, see higher) and asks you to
  937. insert the corrupted disk.  
  938.  
  939.   During the scan you'll get a progress report.  You can leave
  940. the write-protection of your disk on to scan a disk without
  941. making modifications.  
  942.  
  943.  
  944. 6.7. How BootX handles link- and fileviruses...  
  945.  
  946.   When you ask BootX to check the files of a disk or a
  947. directory, BootX starts scanning and checking every file it
  948. encounters.  
  949.  
  950.   When it finds a read-protected file, BootX will ask you if you
  951. wish to remove the read-protection from that file.  If you
  952. select the No gadget, BootX will leave the file as it is.  This
  953. file will NOT be checked.  In case you select the Yes gadget
  954. BootX will try to remove the read-protection.  
  955.  
  956.   The file is then checked to see if it contains a virus.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.                     BootX v4.50 User's Manual                  16
  964.  
  965.  
  966.   Whether or not you mark an infected file or not, BootX will
  967. set the protection flags of the file to ---A---D which means
  968. that the file can only be deleted.  The Archive flag makes sure
  969. that this file will not be included in a backup of that
  970. directory.  
  971.  
  972.  
  973. 6.8. How to kill disk-validator viruses...   
  974.  
  975.   First make sure that your memory is clear of any virus.  You
  976. can do this by turning of your Amiga for a few seconds and then
  977. booting from a NON-INFECTED disk.  Always make sure all the
  978. disks you insert are WRITE-PROTECTED unless it contains a
  979. disk-validator virus you want to kill.  
  980.  
  981.   Start BootX and lock the current drive by clicking on the Lock
  982. gadget in the upper right corner of the BootX screen.  This
  983. prevents AmigaDOS and the Workbench from accessing the disks you
  984. are about to insert.  
  985.  
  986.   Insert the infected disk into the current drive and click on
  987. Read.  BootX now reads the bootblock and checks the file called
  988. "disk-validator".  This file can be found in the L drawer of the
  989. disk.  
  990.  
  991.   If BootX does not check the disk-validator, make sure that the
  992. "Check Disk-Validator" preference item is selected in the
  993. "Settings" menu.  
  994.  
  995.   When BootX finds a disk-validator virus, it will ask you if it
  996. should kill the virus.  If you select Yes, BootX destroys the
  997. complete virus code and makes a harmless executable program of
  998. it that does nothing than set the dos errorcode to -1.  
  999.  
  1000.   Next you are given the advice to repair the disk using the
  1001. "Repair Disk" menu item.  
  1002.  
  1003.   As a last step you need to copy an UNINFECTED disk-validator
  1004. file into the L drawer of the repaired disk.  This step could
  1005. not be automated because the Disk-Validator file is copyrigthed
  1006. by Commodore Amiga.  
  1007.  
  1008.  
  1009. Chapter 7 The BootX Miscellaneous Menu items  
  1010.  
  1011. 7.1 Check Memory      
  1012.  
  1013.   Checks the memory for any known virus ignoring all known
  1014. resident virus checkers.  When BootX finds a virus it will
  1015. display an Alert identifying which virus was in memory and will
  1016. try to kill it.  BootX also removes any known linkvirus from
  1017. memory.  
  1018.  
  1019.   After the memory check, BootX will show you some important
  1020. vectors from Execbase in the main display window.  These vectors
  1021. are mostly altered by viruses.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.                     BootX v4.50 User's Manual                  17
  1028.  
  1029.  
  1030.  
  1031.   Next the resources, libraries and devices are scanned to see
  1032. if any of their vectors have been changed.  
  1033.  
  1034.   A normal vector will be display in black.  When BootX thinks
  1035. that something is not normal it will display a message in white
  1036. next to the vector saying 'Please check...'.  Note that this not
  1037. necessarily means that there is a virus in memory.  Resident
  1038. programs as f.i.  TurboPrint use these vectors too.  
  1039.  
  1040.   I will try to keep BootX's knowledge base as up to date as
  1041. possible.  In case of doubt, save all data and cold-start the
  1042. Amiga, that is, turn of the power and wait a few seconds before
  1043. turning it on again.  
  1044.  
  1045.   This display generates a lot of technical information.  If you
  1046. are a beginning Amiga user and BootX reports that some of the
  1047. vectors have been changed and it does not know which program,
  1048. please contact a more experienced Amiga user (preferably a
  1049. programmer).  
  1050.  
  1051.  
  1052. 7.2 Reset vectors      
  1053.  
  1054.   This menu item gives you the option to clear the first five
  1055. vector that BootX shows in its vector list.  This is not a fail
  1056. safe way to kill a virus.  Also if any other software is using
  1057. these vectors, it will not survive the next reset.  
  1058.  
  1059.  
  1060. 7.3 Install resident LVD     
  1061.  
  1062.   LVD is a small program I wrote that patches the main entry
  1063. point of the Amiga operating system that is used for loading
  1064. executable programs.  Once installed, LVD uses no CPU time until
  1065. you try to load an executable program.  
  1066.  
  1067.   Before this program gets a chance to run, LVD checks if there
  1068. is a known linkviruses attached to it.  If there is the code of
  1069. the program gets changed and the program will not get started.
  1070. This prevents the virus from becoming activated.  
  1071.  
  1072.   But when you already have a virus in memory, every program you
  1073. load can be infected, every disk access can be fatal.  This menu
  1074. option install a Resident version of LVD with any disk access.  
  1075.  
  1076.   First make sure you select Check Memory and Reset vectors to
  1077. try to kill the virus.  Then install the resident LVD.  When you
  1078. reset, LVD survives the reset and patches the entry point.  Now
  1079. if there is a virus infected program in your startup-sequence,
  1080. LVD will intercept it before it gets a chance to run.  
  1081.  
  1082. NOTE:  LVD installs itself at the END of the KickTag chain.
  1083. That way if any other program is using the KickTag vector it
  1084. will remain active.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.                     BootX v4.50 User's Manual                  18
  1092.  
  1093.  
  1094.  
  1095. Chapter 8 The BootX Settings Menu items  
  1096.  
  1097. 8.1 Detection diskchange      
  1098.  
  1099.   This menu item works as an on/off switch.  It turns the
  1100. diskchange detection on or off.  Sometimes it is not useful to
  1101. have BootX read the bootblock of every disk you insert,
  1102. especially when you have a bootblock in the buffer you wish to
  1103. write to another disk.  This gadget allows one drive user to
  1104. copy bootblocks.  
  1105.  
  1106.  
  1107. 8.2 Show Help      
  1108.  
  1109.   This menu item toggles the help feature on or off.  When it is
  1110. turned on you can click any gadget or select any menuitem to get
  1111. a short help message about its function.  Select the Show Help
  1112. item again to turn off the help feature.  
  1113.  
  1114.  
  1115. 8.3 Pause after page     
  1116.  
  1117.   This option controls if the text display will by shown page by
  1118. page.  This feature will be temporarily disabled when you start
  1119. a file check.  
  1120.  
  1121.  
  1122. 8.4 Check Memory at startup    
  1123.  
  1124.   When this option is selected BootX will perform a full memory
  1125. check every time it is started or when it wakes up after being
  1126. put to sleep.  
  1127.  
  1128.  
  1129. 8.5 Check Disk-Validator      
  1130.  
  1131.   When you insert a disk into the current drive BootX will first
  1132. try to identify the bootblock.  When this option is on, it will
  1133. check the disk-validator also when it is on the disk.  This way
  1134. disk-validator viruses can be identified before they get into
  1135. the system.  
  1136.  
  1137. NOTE: this option is especially effective when the current drive
  1138. is locked ! 
  1139.  
  1140.  
  1141. 8.6 Audible alarm      
  1142.  
  1143.   If this menu item is checked BootX will sound an audible alarm
  1144. using the sample found in the file 'BootX.alarm' every time an
  1145. unknown bootblock or a boot-, file- or linkvirus is found.  
  1146.  
  1147.  
  1148. 8.7 Set Colors      
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.                     BootX v4.50 User's Manual                  19
  1156.  
  1157.  
  1158.   When BootX is able to open the ReqTools library, you can
  1159. change the BootX screen colors using the palette requester.  The
  1160. colors will be saved in your BootX.Prefs file.  
  1161.  
  1162.  
  1163. 8.8 Load/Save settings      
  1164.  
  1165.   These items allow you to load and save your prefered settings
  1166. of BootX.  
  1167.  
  1168.   Save settings uses the default name S:BootX.Prefs.  
  1169.  
  1170.  
  1171. 8.9 Save settings as     
  1172.  
  1173.   This is essentially the same as Save settings exept that you
  1174. can specify the name of the settings file.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.                         Table Of Contents
  1223.  
  1224.                            BootX v4.50
  1225.  
  1226. Chapter 1 Introducing BootX    ............................    5
  1227.    1.1 Short introduction     .............................    5
  1228.    1.2 Installing BootX     ...............................    5
  1229. Chapter 2 How to start BootX  .............................    6
  1230.    2.1 Starting BootX from the CLI  .......................    6
  1231.    2.2 Starting BootX from the WorkBench  .................    6
  1232. Chapter 3 How to use BootX: a guided.......................    6
  1233.    3.1 Quit      ..........................................    7
  1234.    3.2 Read BB     ........................................    7
  1235.    3.3 Write BB     .......................................    7
  1236.    3.4 The 4 drive gadgets   ..............................    7
  1237.    3.5 Lock Drive     .....................................    8
  1238.    3.6 Install      .......................................    8
  1239.    3.7 Next and Previous (< and >) ........................    8
  1240.    3.8 Built-in bootblock name    .........................    8
  1241.    3.9 Message window     .................................    9
  1242.    3.10 Main display window    ............................    9
  1243. Chapter 4 The BootX Project Menu items ....................    9
  1244.    4.1 Load Bootblock library    ..........................    9
  1245.    4.2 Load Recog file    .................................    9
  1246.    4.3 Clear Brainfile     ................................   10
  1247.    4.4 Load Brainfile     .................................   10
  1248.    4.5 Save Brainfile     .................................   10
  1249.    4.6 View Brainfile     .................................   10
  1250.    4.7 Merge Brainfile     ................................   10
  1251.    4.8 Show known bootblocks    ...........................   10
  1252.    4.9 Show known bootviruses    ..........................   11
  1253.    4.10 Show known fileviruses    .........................   11
  1254.    4.11 Goto sleep     ....................................   11
  1255.    4.12 About      ........................................   11
  1256.    4.13 Quit      .........................................   11
  1257. Chapter 5 The BootX Bootblock Menu items ..................   11
  1258.    5.1 Load/Save      .....................................   11
  1259.    5.2 Learn      .........................................   12
  1260. Chapter 6 The BootX Files Menu items ......................   12
  1261.    6.1 Check Files     ....................................   12
  1262.    6.2 Check Files Options    .............................   12
  1263.       6.2.1 Skip Directories     ..........................   12
  1264.       6.2.2 Check crunched executables    .................   12
  1265.       6.2.3 Enter interactively     .......................   12
  1266.       6.2.4 Auto-remove read-protection     ...............   13
  1267.       6.2.5 Auto-skip read-protected files    .............   13
  1268.       6.2.6 Handle viruses automatically    ...............   13
  1269.       6.2.7 Virus Mark options    .........................   13
  1270.       6.2.8 Report features     ...........................   14
  1271.       6.2.9 Check files     ...............................   14
  1272.    6.3 Show report again    ...............................   14
  1273.    6.4 Save report     ....................................   14
  1274.    6.5 Check Disk     .....................................   15
  1275.    6.6 Repair Disk     ....................................   15
  1276.    6.7. How BootX handles link- and fileviruses... ........   15
  1277.    6.8. How to kill disk-validator viruses...  ............   16
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286. Chapter 7 The BootX Miscellaneous Menu items ..............   16
  1287.    7.1 Check Memory     ...................................   16
  1288.    7.2 Reset vectors     ..................................   17
  1289.    7.3 Install resident LVD    ............................   17
  1290. Chapter 8 The BootX Settings Menu items ...................   18
  1291.    8.1 Detection diskchange     ...........................   18
  1292.    8.2 Show Help     ......................................   18
  1293.    8.3 Pause after page    ................................   18
  1294.    8.4 Check Memory at startup   ..........................   18
  1295.    8.5 Check Disk-Validator     ...........................   18
  1296.    8.6 Audible alarm     ..................................   18
  1297.    8.7 Set Colors     .....................................   18
  1298.    8.8 Load/Save settings     .............................   19
  1299.    8.9 Save settings as    ................................   19
  1300.  
  1301. ⌐ 1992 BootX v4.50 written by Peter Stuer
  1302.  
  1303. Thanks to Nico Franτois & Johan Van Houtven for the
  1304. ▀eta-testing and all the useful suggestions.
  1305.  
  1306. Thanks to Bart Beeckmans for redesigning the icon.
  1307.  
  1308.              _
  1309.             //
  1310. Thanks to \X/ Amiga for being the best computer ever !
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.