share/man/man8/man8.hpcsh/boot.8

   1 .\"     $NetBSD: boot.8,v 1.3 2006/01/13 22:16:21 uwe Exp $
   2 .\"
   3 .\" Copyright (c) 2004 Valeriy E. Ushakov
   4 .\" All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Neither the name of the author nor the names of any
  12 .\"    contributors may be used to endorse or promote products derived
  13 .\"    from this software without specific prior written permission.
  14 .\"
  15 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS
  16 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  17 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  18 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  19 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  20 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  21 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  22 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  23 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  24 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  25 .\" POSSIBILITY OF SUCH DAMAGE.
  26 .\"
  27 .Dd April 3, 2004
  28 .Dt BOOT 8 hpcsh
  29 .Os
  30 .Sh NAME
  31 .Nm boot
  32 .Nd system bootstrapping procedures
  33 .Sh DESCRIPTION
  34 Windows\ CE machines with
  35 .Tn SuperH
  36 CPUs use the
  37 .Xr hpcboot 8
  38 program to boot
  39 .Nx .
  40 Once running,
  41 .Nx
  42 can reboot itself if
  43 .Xr kloader 4
  44 is configured in the kernel.
  45 .Ss Power fail and crash recovery
  46 .\"
  47 Unfortunately,
  48 .Nx
  49 can't reboot itself at power-up or after crashes.
  50 The machine will go through the cold reset and boot into Windows\ CE.
  51 You will have to restart
  52 .Nx
  53 manually using
  54 .Xr hpcboot 8 .
  55 .Pp
  56 Once
  57 .Nx
  58 starts, an automatic consistency check of the file systems will be
  59 performed, and unless this fails, the system will resume multi-user
  60 operations.
  61 .\"
  62 .Ss Cold starts
  63 .\"
  64 On cold reset Windows\ CE handheld machines attempt to boot the Windows\ CE
  65 operating system from the boot ROM.
  66 The boot ROM is usually not rewritable, so you cannot erase or damage
  67 Windows\ CE image.
  68 .Pp
  69 You can't boot
  70 .Nx
  71 directly, skipping Windows\ CE.
  72 The
  73 .Nx
  74 bootloader,
  75 .Xr hpcboot 8 ,
  76 is provided as a Windows\ CE application program instead.
  77 Though the bootloader is an application program, it blows the entire
  78 running Windows\ CE, its data, and its settings away from RAM (but not
  79 ROM!\&) when the kernel boots successfully.
  80 If
  81 .Nx
  82 is halted the machine will go through the cold reset and will reboot
  83 into Windows\ CE.
  84 .\"
  85 .Ss Normal Operation
  86 .\"
  87 Please, refer to the
  88 .Xr hpcboot 8
  89 manual page.
  90 .Sh FILES
  91 .\"
  92 .Bl -tag -width hpcboot.exe -compact
  93 .It Pa hpcboot.exe
  94 bootloader program for Windows\ CE
  95 .El
  96 .\"
  97 .Sh SEE ALSO
  98 .\"
  99 .Xr kloader 4 ,
 100 .Xr hpcboot 8
 101 .\"
 102 .Sh BUGS
 103 .\"
 104 There is no general way to launch the bootloader automatically, as
 105 only a few Windows\ CE machines provide an
 106 .Dq auto run
 107 mechanism.