home *** CD-ROM | disk | FTP | other *** search
/ Micro R&D 1 / MicroRD-CD-ROM-Vol1-1994.iso / disktools / moni / bb20.lzh / BB / BB.doc < prev    next >
Text File  |  1992-01-18  |  5KB  |  136 lines
  1.  
  2.                                     BB
  3.                                     --
  4.           Documentation for version 2.0, on September 11th, 1991
  5.  
  6.                               by Bruno Costa
  7.  
  8.  
  9.  
  10. WARNING
  11.  
  12.   Although  this  program  is freely distributable (see COPYRIGHT below), I
  13. would  appreciate  if  you  take the time to write me a line or two (E-Mail
  14. please)  if  you  are  using  any of my programs or if you have any kind of
  15. ideas  or  suggestions  (This is not too much to ask, is it?).  If you feel
  16. particularly  generous,  I  would  like  to  receive a disk with any useful
  17. programs you have written, preferrably with source.  Thanks!
  18.  
  19.  
  20. DESCRIPTION
  21.  
  22.   BB  is a multi-purpose small utility to manipulate Amiga floppy disk boot
  23. blocks.  Besides being able to read, write, show and install bootblocks, BB
  24. has a couple of unusual features.  It is able to fix the bootblock checksum
  25. of  a  disk, so that you may be able to write your own bootblocks or modify
  26. existing  ones  and  keep them bootable.  It is also able to insert a small
  27. preamble in existing bootblocks that will put the Fatter Agnus in PAL mode,
  28. so  that any programs - including Workbench and even most heavily protected
  29. games - will believe to be running in a PAL machine, with the corresponding
  30. PAL  display.   If  you have any European applications, games or demos that
  31. boot from floppies, this is certainly the easiest way to automatically boot
  32. them in PAL mode.
  33.  
  34.   BB  is  also useful to install custom bootblocks you have written, and to
  35. backup  bootblocks  to  files, so that if your disks become infected with a
  36. bootblock  virus,  you  will be able to restore the original bootblock from
  37. your backups. It works both under WB1.3 and WB2.0.
  38.  
  39.  
  40. OPTIONS
  41.  
  42.   usage: bb [-acshpd] [-i<filename>] [-r<filename>] <drivename>
  43.  
  44.   BB  can  operate  in  only  one  of  the following modes, selected by the
  45. respective option:
  46.  
  47.   i =  install new bootblock.  The given filename is read, and installed in
  48.   the selected drive, with a correct checksum.
  49.  
  50.   d =  install a DOS bootblock.  An 1.3 standard bootblock is installed  in
  51.   the selected drive, with a correct checksum.
  52.  
  53.   r = read bootblock.  Reads the bootblock from disk and writes it verbatim
  54.   to  the  given file.  Note that the whole bootblock is written (including
  55.   the header), i.e., a total of 1024 bytes.
  56.  
  57.   c =  fix  checksum.  Fixes the checksum of the bootblock on  the selected
  58.   drive.
  59.  
  60.   s =  show bootblock.  Prints the printable characters in the bootblock in
  61.   ASCII format to standard output.
  62.  
  63.   p =  adds  PAL  booter.   Adds  a  small  PAL  preamble  to the  existing
  64.   bootblock.   Note  that  this may not work with some bootblocks, so it is
  65.   advisable  to  backup the bootblock to a file using the 'r' option.  Note
  66.   also  that  this preamble does not work with an Agnus chip older than the
  67.   Fatter (it will simply boot in NTSC in this case).
  68.  
  69.   In  any of these modes, an 'a' option may be used to make the program ask
  70. for a disk insertion before proceeding.  This is mostly useful to owners of
  71. single drive systems.
  72.  
  73.   A drivename may be specified either as "df1:", "DF1:" or simply "1".
  74.  
  75.  
  76. EXAMPLES
  77.  
  78.   To install a PAL booter in df0:, with a prompt for disk insertion:
  79.  
  80.   > BB -ap 0
  81.   Please insert disk in DF0: and press ENTER ...
  82.   warning: this may make your bootblock unusable!
  83.            remove disk or press ENTER to continue:
  84.  
  85.   To backup a bootblock to a file:
  86.  
  87.   > BB -rdh0:bblocks/diska.bb df0:
  88.  
  89.   To restore that bootblock to the disk:
  90.  
  91.   > BB -idh0:bblocks/diska.bb df0:
  92.  
  93.   To show the contents of a bootblock in drive df1:
  94.  
  95.   > BB df1:
  96.  
  97.  
  98. BUGS
  99.  
  100.   PAL booter does not always work.
  101.  
  102.   This  kind of program is perfect to be a trojan horse type virus, but you
  103. have the full source code so that you can assure it isn't.
  104.  
  105.  
  106. AUTHOR
  107.  
  108.   The  accompanying  program  and  this documentation were written by Bruno
  109. Costa.  He can be reached in the following ways:
  110.  
  111.   E-Mail: bruno@brlncc.bitnet (InterNet)
  112.           bruno@BRLNCC        (BitNet)
  113.  
  114.   Mail:   Bruno Costa
  115.           Rua Almirante Guilhem 454/102 bloco 1
  116.           Leblon - Rio de Janeiro
  117.           RJ 22440
  118.           BRAZIL
  119.  
  120.  
  121. COPYRIGHT
  122.  
  123.   This program is copyrighted by Bruno Costa.  It may be freely distributed
  124. if  and  only if the source code, the documentation and the executables are
  125. provided  in  original form.  It may be included in Public Domain/Shareware
  126. compilations,  like  the  one  organized  by  Fred  Fish, as long as just a
  127. nominal fee is charged for each disk (no more than US$10 per disk), and may
  128. also be uploaded to BBS's or network services like BIX and CompuServe.
  129.  
  130.  
  131. DISCLAIMER
  132.  
  133.   The author makes no warranty of any kind with respect to this product and
  134. explicitly  disclaims  any implied warranties of merchantability or fitness
  135. for  any  particular  purpose.
  136.