home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / util / bootute-1.2.lha / BootUte / BootUte.doc next >
Text File  |  1994-04-25  |  14KB  |  393 lines
  1.                       Documents for BootUte v1.2
  2.                       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  3.                   BootUte was written by Paul Toyne
  4.                         Released on 24-Apr-94.
  5.  
  6.                    1)   What is bootute ?  
  7.                    2)   BootUte's Options  
  8.                    3)   Error Messages     
  9.                    4)   Disclaimer         
  10.                    5)   Distribution       
  11.                    6)   A1200 Compatability
  12.                    7)   Greetings          
  13.                    8)   Future Versions    
  14.                    9)   Testing            
  15.                   10)   Contacting Me      
  16.                   11)   History            
  17.  
  18.                 BootUte was written in 100% assembler.
  19.  
  20.  
  21.                           What is BootUte ?
  22.                           ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  23. BootUte is a program that enables the loading, saving and executing
  24.  of bootblocks.
  25.  
  26. BootUte requires Kickstart and Workbench 2.0 or above, it also
  27.  requires any version of reqtools.library.
  28.  
  29. reqtools.library is © Nico Francois.
  30.  
  31. My main aim in producing this program was to make games and demos
  32.  that wouldn't work on my 1200 work.
  33.  
  34. I have expanded somewhat on my original idea so that it will be
  35.  useful to all people with accelerators, or with kickstart 2.0 and
  36.  above.
  37.  
  38. BootUte was written over a period of a couple of months on-off work.
  39.  
  40. It was written in 100% assembler using Devpac 3.
  41.  
  42. Why kickstart 2.0 and above only ?
  43.  
  44. I have two reasons for that :
  45.  
  46.  1) It is a lot easier to provide a good user interface under 2.0+.
  47.  2) If you are an acclerator owner you should have at least 2.0, and
  48.      if you don't I would suggest upgrading.
  49.  
  50.  
  51.                           BootUte's options
  52.                           ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  53. BootUte can be opened in any of the following screen-modes by setting
  54. the 'BootUte' environment variable from the shell/CLI.
  55.  
  56. eg SetEnv BootUte=PAL
  57.  
  58. Screen mode                 | Dimensions | Environment variable text
  59. ----------------------------|------------|--------------------------
  60. PAL:High Res                | 640 x 256  | PAL
  61. PAL:High Res Laced          | 640 x 512  | PALL
  62. NTSC:High Res               | 640 x 200  | NTSC
  63. NTSC:High Res Laced         | 640 x 400  | NTSCL
  64. DBLPAL:High Res             | 640 x 256  | DBLPAL
  65. DBLPAL:High Res No Flicker  | 640 x 512  | DBLPALN
  66. DBLNTSC:High Res            | 640 x 200  | DBLNTSC
  67. DBLNTSC:High Res No Flicker | 640 x 400  | DBLNTSCN
  68. EURO72:640 x 200            | 640 x 200  | EURO72
  69. EURO72:Productivity         | 640 x 400  | EURO72P
  70. EURO:36Hz High Res          | 640 x 200  | EURO36
  71. EURO:36Hz High Res Laced    | 640 x 400  | EURO36L
  72. MULTISCAN:640 x 240         | 640 x 240  | VGA
  73. MULTISCAN:Productivity      | 640 x 480  | VGAP
  74. SUPER72:Super-High Res      | 800 x 300  | SUPER72
  75.  
  76. If the screen-mode isn't available then BootUte will display a requester
  77. saying that it can't open the screen, also if the screen mode is not a
  78. 640 x 256 mode, the screen will be opened as an auto-scrolling 640 x 256
  79. screen.
  80.  
  81.    ** The text in the environment variable is NOT case sensitive **
  82.  
  83. Bootblock operations
  84. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  85.  Read bootblock from DF0:
  86.          Reads the bootblock from drive DF0: to the buffer.
  87.  
  88.  Write bootblock to DF0:
  89.          Writes the bootblock from the buffer to drive DF0:,
  90.           re-calculating the checksum so that it is correct.
  91.  
  92. File operations
  93. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  94.  Load bootblock to buffer
  95.          Loads a file from disk to the buffer.
  96.  
  97.          The file must be one of the following :
  98.  
  99.                         ·Raw data (1024 bytes long)
  100.                         ·Executable with only 1 code hunk
  101.                                 (1052 bytes long)
  102.                         ·An executable with a BootUte header.
  103.                                 (1220 bytes long)
  104.  
  105.         The checksum can be invalid, because BootUte corrects it
  106.          automatically when the file is loaded.
  107.  
  108.  Save from buffer
  109.          Saves the buffer to a file, using the file type specified in
  110.           the preferences section.
  111.  
  112. Buffer Operations
  113. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  114.  Execute
  115.          Executes the file in the buffer using the options specified
  116.           in the General Preferences section.
  117.  
  118.  Clear
  119.          Clears the bootblock from the buffer.
  120.  
  121.  Information
  122.          Displays the following information about the bootblock
  123.           that is in the buffer :
  124.                         ·Bootblock type (OFS, FFS etc.)
  125.                         ·Correct checksum.
  126.                         ·Whether the current checksum is valid.
  127.                         ·An ASCII dump of the bootblock.
  128.  
  129.  Quit BootUte
  130.          Exits BootUte.
  131.  
  132.  About BootUte
  133.          This displays information about the current version of
  134.           BootUte being used, and information about your Amiga
  135.           system.
  136.  
  137. Preferences
  138. ¯¯¯¯¯¯¯¯¯¯¯
  139. The preferences section is a set of six check boxes, split into two
  140.  sections, where options are either on or off.
  141.  
  142. General Preferences
  143. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  144. Disable CPU Caches
  145.          This option disables the Instruction and Data caches found
  146.           on the 68020 processor and above.
  147.  
  148.          It is only selectable if a 68020 or above is present in the
  149.           system.
  150.  
  151. Trap MOVE SR,<ea>
  152.          This option traps the assembler command MOVE SR,<ea> because
  153.           it is a 'Supervisor Mode' instruction on the 68010 and
  154.           above, whereas on the 68000 it can be used in 'User Mode'
  155.           and 'Supervisor Mode'.
  156.  
  157.          It is only selectable if a 68010 or above is present in the
  158.           system.
  159.  
  160. VBR Zero
  161.          This option moves the systems current Vector Base Register
  162.       to zero, as many old, and some new (Andromeda Sequential)
  163.       demos assume that it is zero.
  164.  
  165.          It is only selectable if a 68010 or above is present in the
  166.           system.
  167.  
  168. Save Preferences
  169. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  170. NOTE : Only one of the below, or neither can be selected at the same
  171.         time, both cannot be selected at the same time.
  172.  
  173. Raw Binary
  174.          This option makes the 'Save bootblock from buffer' option
  175.           save the data as a binary file, so that it can't be run.
  176.  
  177. BootUte Header
  178.          This option makes the 'Save bootblock from buffer' option
  179.           save the data using a special header that enables demo's
  180.           to be run from the CLI.
  181.  
  182.  
  183.     This is a list of the possible error messages BootUte can give
  184.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  185. If BootUte quits straight away, without displaying any error
  186.  messages, it means that it couldn't allocate the memory that it
  187.  needs to function.
  188.  
  189. Alert number 0003 8004
  190.     BootUte was unable to open v36 or above of the intuition.library,
  191.      this should only ever appear if you are running less than
  192.      kickstart 2.0 (v36)
  193.  
  194. You must be running Kickstart 2.0 or above
  195.     BootUte was unable to open all of the libraries it needs as
  196.      v36 or better, this should only appear if you have a mixture
  197.      of pre 2.0 libraries and post 2.0 libraries in your libs:
  198.      drawer.
  199.  
  200. Unable to open reqtools.library
  201.     BootUte was unable to open the 'reqtools.library', it needs this
  202.      file in the libs: directory for all of it's requesters.
  203.  
  204. Unable to open screen.
  205.     BootUte was unable to open it's screen, this may be due to the
  206.      fact that the selected monitor file hasn't been run.
  207.  
  208. Unable to open window.
  209.     BootUte was unable to open the window that it uses.
  210.  
  211. Unable to open trackdisk.device.
  212.     BootUte was unable to open the 'trackdisk.device' that it needs
  213.      for the reading and writing of the bootblocks.
  214.  
  215. Unable to allocate ReqTools file requester.
  216.     BootUte was unable to allocate the structure necessary for the
  217.      'reqtools.library' file requester, this may be due to low
  218.      memory conditions.
  219.  
  220. Unable to read the bootblock
  221.     BootUte was unable to read the bootblock of the disk in DF0:
  222.     A possible cause is that there wasn't actually a disk in DF0:
  223.  
  224. Unable to write the buffer because it is empty.
  225.     BootUte was unable to write the bootblock buffer to DF0: because
  226.      the buffer was empty.
  227.  
  228. Unable to save the buffer because it is empty.
  229.     BootUte was unable to save the bootblock buffer to disk because
  230.      the buffer was empty.
  231.  
  232. Unable to e