home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 100-199 / ff175.lzh / SafeBoot / SafeBoot.Doc < prev    next >
Text File  |  1989-02-04  |  9KB  |  167 lines
  1.  
  2.  SafeBoot V2.2    ©1988 Mark Lanoux
  3.  UnderSea World Software 03-Oct-88
  4.  Docs revised: 29-Oct-88
  5.  
  6. Boring stuff:
  7.     This program is NOT public domain, nor Shareware.  The author (me!)
  8. retains all rights.  SafeBoot is Copyrighted, therefore it may not be
  9. sold by anyone without my permission.  This program may be distributed
  10. freely as long as all the files in the archive accompany it.  
  11.  
  12. Brief history of SafeBoot:
  13.    V1.0     CLI based only
  14.    V1.1     Threw in some basic Workbench support...
  15.    V2.0     Trashed the old interface, added the Arp file requester
  16.    V2.1     ..mistakenly released..sorry!
  17.    V2.2     Replaced Arp file requester with one of my own doing, added
  18.             'loop mode' so multilple saves/restores can be done without
  19.             having to restart each time
  20.       ...who knows what the future holds...
  21.  
  22. Requirements:
  23.    The only requirement, other then Kickstart/Workbench 1.2+, is to have
  24. the BootIcon file in the directory that you start SafeBoot from.  This file
  25. is actually the .info file that will be created for any files that you
  26. save IF you run under WorkBench.  If you run from the CLI exclusivly, you
  27. do not have to have this file for SafeBoot to work.
  28.  
  29. Synopsis:
  30.    The virus problem is well known in the Amiga community.  These virus
  31. are brought into the system from the boot sectors of a bootable disk, and
  32. usually spread like wildfire unless detected.  The numerous virus checkers
  33. out there in PD land do the trick, but one problem is if the virus infects
  34. the boot sectors of commercial disks, which occasionaly have special code
  35. imbedded there which is needed to start the program, that disk will be
  36. rendered useless.  This program was written to solve that problem.
  37.  
  38.    SafeBoot will allow the user to save custom boot sectors of all your
  39. commercial disks and save them for such an emergency.  If a virus somehow
  40. manages to trash the boot sectors of a commercial disk, just run SafeBoot
  41. and it will restore the boot sectors, therefore saving your disk! (and hard
  42. earned money!).
  43.  
  44. INSTRUCTIONS:
  45.    SafeBoot is runnable from Workbench and the CLI.  If you run it from
  46. Workbench, an icon for the saved boot block data file will be created.
  47. Remember, for the icon to be created, the BootIcon file must be in the
  48. directory that you start SafeBoot from!
  49.  
  50.    When the program starts, a small window comes up and you are presented
  51. with nine gadgets.  These gadgets are all thats needed to run the
  52. program.  Here is a layout of the gadgets:
  53.  
  54.                            Save    Restore   >  ?
  55.                          DF0: DF1: DF2: DF3: >  ?
  56.                          Volume Name  Custom Name
  57.   (this is NOT a gadget) Status:
  58.                          Exit
  59.  
  60.    Save         Sets the program into save mode whereby the user may save
  61.                 the boot block data from a bootable disk.  When clicked on,
  62.                 Save will be printed next to the > .
  63.  
  64.    Restore      Acts like save, but this will allow the user to restore a
  65.                 boot block to a bootable disk.  Restore will be printed
  66.                 next to the > .
  67.  
  68.    DF0: DF1:    These gadgets select which drive the bootable disk whose
  69.    DF2: DF3:    boot block is to be saved/restored is placed.  The drive
  70.                 selected will be printed next to the > .
  71.  
  72.    Volume Name  Hitting this gadget will affect SafeBoot depending on which
  73.                 mode (Save or Restore) you are in.  If in Save mode, the
  74.                 file that will be saved will be given the name of the
  75.                 disk volume whose data is to be saved.  The data file will
  76.                 be saved in the directory that SafeBoot was started from.
  77.                 In Restore mode, SafeBoot will look for the date file with
  78.                 the disk volume name whose boot block is to be restored.
  79.                 This file is searched for in the directory SafeBoot was
  80.                 started from.
  81.  
  82.    Custom Name  This gadget puts up the file requester.  You may select
  83.                 files by clicking on their names, and to enter directories
  84.                 you just click on the directory name.  To back out of a
  85.                 directory, hit the Parent Dir gadget.  If you need to change
  86.                 drives or even devices, use the proportional gadget on the
  87.                 right hand side to display the bottom of the listing.  At
  88.                 the end is a list of AmigaDOS drives and devices.  Clicking
  89.                 on these will send you to any drive or device that you have
  90.                 mounted.  To select the file, you have 3 choices.  First,
  91.                 you may go to the string gadget near the bottom of the
  92.                 requester and type in a name.  Second, you can click on a
  93.                 name in the list, it will then appear in the string gadget.
  94.                 Or third, you may go to any directory you wish and click in
  95.                 the string gadget.  If you delete all the characters in the
  96.                 string gadget (if any at all), then SafeBoot will use the
  97.                 volume name of the target disk.  This is like hitting the
  98.                 Volumne Name gadget, except that you can specify in which
  99.                 directory the file is.  Finally, if you are satisfied with
  100.                 the filename, click in the Use It gadget.  To abort at any
  101.                 time, click the CANCEL gadget.
  102.  
  103.    Exit         Quits the program.
  104.  
  105.       When you have selected the mode of operation, the drive where
  106.    the bootable disk is located, and the filename, the actual work begins.
  107.    If all is ok, the filename that is created/accessed will be printed
  108.    in the Workbench Screen's title bar.  If there is an error, a small
  109.    error message will be printed to alert the user.
  110.  
  111.       There is no required order of operation, but a sample run may be
  112.    as follows.  For a save, first click on the Save gadget.  Next, select
  113.    the disk drive gadget where the bootable disk is placed.  Finally,
  114.    decide on whether you want to use a custom name or the disk volume name.
  115.    To restore a boot block, just select the Restore gadget and follow the
  116.    same pattern as above.
  117.  
  118.       As a little bit of added protection, if you attempt to save a
  119.    bootblock, and a file with the same name that you wish to use already
  120.    exists, SafeBoot puts up a requester asking whether or not you wish to
  121.    overwrite the old file.  Click on Save Anyway to overwrite the file,
  122.    otherwise just click on Cancel.
  123.  
  124.       At the time of saving, a checksum is calculated and saved as part of
  125.    the header.  When a restore is attempted, the checksum is recalculated
  126.    and compared to the checksum in the saved header.  If they do not match
  127.    for some reason, a requester is displayed warning the user, and a choice
  128.    is given on whether to proceed or abort is given.
  129.  
  130.       A note on restoring boot blocks.  SafeBoot saves as part of the
  131.    data file a header, this header contains the volume name of the disk
  132.    it was saved from.  If you attempt to restore a boot block data file
  133.    to the disk that is was not originally from, SafeBoot puts a requester
  134.    warning you.  You may then proceed to restore, or abort.  If you give
  135.    a boot block data file a less than descript filename, you should go to
  136.    the CLI and do a TYPE <datafile> OPT H for a hex dump of the file.
  137.    You will see on the first line  'BootBlock for:' and on the second line
  138.    will appear the volume name this boot block file is for.  But, for the
  139.    easiest way to check the volume name for a particular file, just check
  140.    that file's comment.  You can do this in the CLI by listing the file or
  141.    by getting a directory where the file is.  The comment line will show
  142.    'BootBlock for:' and the volume name will be printed here.  If you run
  143.    from Workbench, just click on the icon for the data file, and select
  144.    the 'Info' menu selection from the Project menu.
  145.  
  146.  
  147.    This program was written in Benchmark Modula-2.  I would like to thank
  148.    the following people, who in one way or the other, helped me to finish
  149.    this program (after heavy-duty testing):
  150.     Patrick Goudeau who gave me programming tips, help, suggestions.
  151.     Paul Trauth who drew the great icons, thanx Paul!
  152.     John Palmer who gave me the idea and who has helped test this program.
  153.  
  154.    If you wish to thank me, gripe, complain, give money, etc, I can be
  155.    reached at the following address:
  156.  
  157.    Mark Lanoux
  158.    4447 Markham Avenue
  159.    Jefferson, LA 70121 USA
  160.  
  161.  The source is available from me, just send me a blank disk and it will
  162.  be promptly returned.
  163.  This program can be found on our board, UnderSea World BBS (504)-341-5323.
  164.  It is also in the New Orleans Commodore Klub (NOCK) library on it's
  165.  anti-virus disk, appropriatly named the in-NOCK-ulation disk.
  166.  
  167.