distrib/acorn32/stand/BtNetBSD/!BtNetBSD/Docs/FBInstall

   1 $NetBSD: FBInstall,v 1.1.1.1 2002/05/09 20:03:57 jdolecek Exp $
   2
   3 Note of FastBoot/AutoBoot Installation for !BtNetBSD V0.90
   4 based on !BtRiscBSD
   5
   6 Updated by Reinoud Zandijk 18 Feb 2001
   7 Author: Mark Brinicombe 12th May 1995
   8 Updated: 20th June 1997
   9
  10 Installation
  11 ------------
  12
  13 Two patches are required to the standard boot files
  14
  15 The following lines should be added to the start of
  16 !Boot.Choices.Boot.PreDesktop
  17
  18 ----------------------- Cut here -----------------------
  19
  20 |Start NetBSD !Boot FastBoot
  21 Run <Obey$Dir>.^.^.^.BtNetBSD.!BtNetBSD.!Boot
  22 Run <BtNetBSD$Dir>.TestBoot
  23 If "<NetBSD$FastBoot>" = "1" THEN Echo NetBSD FastBoot mode engaged
  24 If "<NetBSD$FastBoot>" = "2" THEN Echo NetBSD ConfBoot mode engaged
  25 If "<NetBSD$FastBoot>" = "3" THEN Echo NetBSD AutoBoot mode engaged
  26 If "<NetBSD$FastBoot>" = "4" THEN Echo NetBSD FastConf mode engaged
  27 |End
  28
  29 ----------------------- Cut here -----------------------
  30
  31 These commands should be the first one run in the PreDesktop
  32 file. They boot the boot loader application (primarily to set
  33 BtNetBSD$Dir). The file <BtNetBSD$Dir>.TestBoot is then run
  34 to test for the ALT or CTRL keys are being held down. In addition
  35 it checks several CMOS RAM bits for boot configuration options.
  36
  37 The following lines should be added to the start of
  38 !Boot.Choices.Boot.Desktop
  39
  40 ----------------------- Cut here -----------------------
  41
  42 |Start NetBSD !Boot FastBoot
  43 Iconsprites <BtNetBSD$Dir>.!Sprites22
  44 If <NetBSD$FastBoot> = 4 THEN Run <BtNetBSD$Dir>.!Edit
  45 If <NetBSD$FastBoot> > 0 AND <NetBSD$FastBoot> < 4 THEN Obey <BtNetBSD$Dir>.fastboot
  46 |End
  47
  48 ----------------------- Cut here -----------------------
  49
  50 This command should be the first one run in the Desktop file.
  51 It runs the NetBSD Bootloader with the configured parameters.
  52
  53
  54 There is a specific reason for not putting all the fastboot code in
  55 one file. The PreDesktop patch is run very early in the boot up so
  56 that the ALT and CTRL keys can be detected quickly. However, currently
  57 the actually bootloader cannot be run at this point unless a lot of
  58 memory is available in the module area (~1Meg) as currently the
  59 module area is used for temporary storage of the kernel being
  60 booted.
  61 This means that the actual boot is prosponed until the start of
  62 the Desktop file. At this point the desktop has been started and
  63 the task manager is running so it will be possible to allocate
  64 a large amount of module space.
  65
  66
  67 Activation
  68 ----------
  69
  70 Once installed, to engage the fastboot hold ALT down immediately
  71 after a reset. As soon as the "fastboot engaged" message is printed
  72 the ALT key can be released.
  73 To engage the fastconf mode  hold CTRL down immediately
  74 after a reset. As soon as the "fastconf engaged" message is printed
  75 the CTRL key can be released.
  76
  77
  78 Configuration
  79 -------------
  80
  81 Configuration is done via the !BtNetBSD application.
  82 When ever NetBSD is booted the commandline used to boot it is saved
  83 by the bootloader to the file <BtNetBSD$Dir>.FastBoot
  84 Rerunning this file will then boot NetBSD with the last parameters
  85 used. It is this file that the fastboot uses so the fast boot will
  86 boot NetBSD with the same parameters as were used for the last boot.
  87
  88
  89 ConfBoot mode
  90 -------------
  91
  92 This mode is identified by NetBSD$FastBoot being set to 2. This indicates
  93 that the bootloader has been configured to always boot NetBSD. This is
  94 down by setting a bit in the CMOS RAM (via !BtNetBSD).
  95 If NetBSD boots are configured the action of the ALT is reversed so that
  96 holding down ALT will allow a RISC OS boot instead.
  97
  98
  99 AutoBoot mode
 100 -------------
 101
 102 This mode is identified by NetBSD$FastBoot being set to 3. This indicates
 103 that an automatic boot was requested by NetBSD before it rebooted. This
 104 will happen when /sbin/reboot is used instead of /sbin/halt.
 105
 106
 107 FastBoot mode
 108 -------------
 109
 110 This is the behaviour when ALT is held down at boot time and ConfBoot mode
 111 has not been configured. It just bypasses most of the normal startup and
 112 boots NetBSD.
 113
 114
 115 FastConf mode
 116 -------------
 117
 118 This is the behaviour when CTRL is held down at boot time. This is similar to
 119 FastBoot mode except that the !BtNetBSD is provided to allow boot parameters
 120 to be changed.
 121
 122
 123 Bugs
 124 ----
 125
 126 Well hopefully there are no bugs :-)