home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / util / bootute-1.2.lha / BootUte / BootUte.doc < prev    next >
Encoding:
Text File  |  1994-04-25  |  13.7 KB  |  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 execute the buffer because it is empty.
  233.     The buffer couldn't be executed because it was empty.
  234.  
  235. Unable to clear the buffer because it is empty.
  236.     The buffer couldn't be cleared because it was already clear.
  237.  
  238. Unable to write the bootblock.
  239.     BootUte couldn't write the bootblock to the disk in DF0:
  240.     A possible cause is that there isn't a disk in the drive.
  241.  
  242. There was an error reading the file.
  243.     BootUte couldn't read a bootblock to the buffer.
  244.     A possible cause is that the disk has got a read/write error.
  245.  
  246. There was an error writing the file
  247.     BootUte couldn't write the buffer to a file.
  248.     Possible causes are : the disk in the drive is write protected.
  249.                           the disk is full.
  250.                           the disk has got a read/write error.
  251.  
  252. Sorry, the file you are trying to
  253.  load isn't a valid bootblock
  254.     You are trying to load a file as a bootblock, and it isn't a
  255.      valid format.
  256.  
  257.  
  258.                               Disclaimer
  259.                               ¯¯¯¯¯¯¯¯¯¯
  260. This software is provided "as is" without warranty of any kind,
  261.  either expressed or implied. By using it, you agree to accept the
  262.  entire risk as to the quality and performance of the program. Should
  263.  the software prove defective, you assume the cost of all necessary
  264.  servicing, repair or correction.
  265.  
  266.  
  267.                              Distribution
  268.                              ¯¯¯¯¯¯¯¯¯¯¯¯
  269. BootUte is ©1994 TLS.
  270.  
  271. The program can be distributed by any means (BBS, mail etc.) as
  272.  long as the following conditions are met :
  273.  
  274.   1) No money changes hands.
  275.   2) The following files are included, in their original state and
  276.       are not modified in any way :
  277.  
  278.       BootUte
  279.       BootUte.doc
  280.       BootUte.guide
  281.       Install.doc
  282.       reqtools.library - Any version.
  283.  
  284.  
  285.         This information is only useful for users with A1200's
  286.         ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  287. A lot of compatability problems are due to the fact that the new
  288.  Amiga 1200's don't have any fast ram fitted as standard. If you own
  289.  an A1200, then I suggest that you buy a fast ram expansion as it
  290.  makes lots more programs run.
  291.  
  292.  
  293.                               Greetings
  294.                               ¯¯¯¯¯¯¯¯¯
  295. I would like to greet the following people :
  296.  
  297.  Oliver Norton (Oll¿e) - Betatester (A4000/040)
  298.      Thanx for finding the bugs, hope ya like this great new
  299.       version.
  300.  
  301. Hi to these guys :
  302.  
  303.  Michael Morris : Hi, 'ex-beta-tester' - did you ever test it??
  304.  
  305.                            Future Additions
  306.                            ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  307. The following options will definately be added to future versions of
  308.  BootUte :
  309.  
  310.  »» CBM Installer script to make BootUte easier to install.
  311.  »» 'Delay' option to allow for bootblocks/files that require mouse
  312.      buttons to be held down to access a 'hidden' part.
  313.  »» 'No Fast Ram' option to turn off fast ram, if it is fitted.
  314.  »» 'Localisation' - For workbench 3.0+ to enable users in other
  315.                       countries to have the menus etc in their own
  316.                       language.
  317.  »» Modify screen mode selection to use the ReqTools Screen mode
  318.      requester.
  319.  »» Have font selection.
  320.  »» Ability to use drives other than DF0:
  321.  »» Ability to load and execute executable files.
  322.  »» 'No Fast Ram' option for programs that don't like fast ram.
  323.  
  324. The following options may be added to future versions of BootUte,
  325.  providing I get enough feedback from you (the users).
  326.  
  327.  »» 'Fake Fast Ram' option for users unable to afford a fast ram
  328.      expansion.
  329.  »» 'Arexx interface'
  330.  
  331. If you think of any more options, or want the 'possible' options
  332.  added then e-mail me - see 'How to contact me'
  333.  
  334.  
  335.                            Testing BootUte
  336.                            ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  337. BootUte has been tested on the following platforms/configurations.
  338.  
  339. Amiga 1200
  340.         2 mb Chip, 4 mb Fast & 20Mhz 68881
  341.         80 mb Seagate 2.5" IDE Hard Drive
  342.         External Power XL High Density floppy drive.
  343.  
  344.         Kickstart 3.0 ROM (v39)
  345.  
  346. Amiga 4000/040
  347.         2 mb Chip, 2 mb Fast
  348.         120 mb Seagate 3.5" IDE Hard Drive
  349.  
  350.         Kickstart 3.0 ROM (v39)
  351.  
  352. Amiga 500+
  353.         1 mb Chip, 0 mb Fast
  354.  
  355.         Kickstart 2.04 ROM (v37)
  356. .-------------------------------------------------------------------.
  357. | My Beta-Tester said that he'd tested it, but I can't be 100% sure |
  358. |  as I haven't seen it running on a 68000 machine.            |
  359. `-------------------------------------------------------------------'
  360.  
  361. BootUte has been tested fully with 'Enforcer', and has been found to
  362.  produce no enforcer hits.
  363.  
  364.  
  365.                             Contacting me
  366.                             ¯¯¯¯¯¯¯¯¯¯¯¯¯
  367. I can be contacted in the following ways:
  368.  
  369. E-Mail (Internet) : se1pt@dmu.ac.uk
  370.  
  371.  
  372.  
  373.                           BootUte's history
  374.                           ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  375.  Version |   Date    | Information
  376. ---------|-----------|------------------------------------------
  377.   1.0    | 01-Mar-94 | First release version - PAL only
  378. ---------|-----------|------------------------------------------
  379.   1.1    | 22-Mar-94 | Now uses a 'BootUte' environment variable
  380.          |           |  to determine the screen mode.
  381. ---------|-----------|------------------------------------------
  382.   1.11   | 02-Apr-94 | A couple of minor bug fixes, and the text
  383.          |           |  in the environment variable is no longer
  384.          |           |  case sensitive.
  385. ---------|-----------|------------------------------------------
  386.   1.12   | 23-Apr-94 | Found two very stupid bugs.... fixed
  387.          |           | Only released to EDGE
  388. ---------|-----------|------------------------------------------
  389.   1.2    | 24-Apr-94 | Changed the screen layout a bit and added
  390.          |           |  the VBR Zero option, after problems
  391.          |           |  running a demo (Sequential by Andromeda)
  392. ---------|-----------|------------------------------------------
  393.