Sync usage with man page.
[netbsd-mini2440.git] / share / man / man8 / man8.hpcarm / boot.8
blob9f8cd9a53138666b6b6adb693dc45d88e99d6b94
1 .\"     $NetBSD$
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 January 13, 2006
28 .Dt BOOT 8 hpcarm
29 .Os
30 .Sh NAME
31 .Nm boot
32 .Nd system bootstrapping procedures
33 .Sh DESCRIPTION
34 Windows\ CE machines with
35 .Tn StrongARM
36 CPUs use the
37 .Xr hpcboot 8
38 program to boot
39 .Nx .
40 .Ss Power fail and crash recovery
41 .\"
42 Unfortunately,
43 .Nx
44 can't reboot itself at power-up or after crashes.
45 The machine will go through the cold reset and boot into Windows\ CE.
46 You will have to restart
47 .Nx
48 manually using
49 .Xr hpcboot 8 .
50 .Pp
51 Once
52 .Nx
53 starts, an automatic consistency check of the file systems will be
54 performed, and unless this fails, the system will resume multi-user
55 operations.
56 .\"
57 .Ss Cold starts
58 .\"
59 On cold reset Windows\ CE handheld machines attempt to boot the Windows\ CE
60 operating system from the boot ROM.
61 The boot ROM is usually not rewritable, so you cannot erase or damage
62 Windows\ CE image.
63 .Pp
64 You can't boot
65 .Nx
66 directly, skipping Windows\ CE.
67 The
68 .Nx
69 bootloader,
70 .Xr hpcboot 8 ,
71 is provided as a Windows\ CE application program instead.
72 Though the bootloader is an application program, it blows the entire
73 running Windows\ CE, its data, and its settings away from RAM (but not
74 ROM!\&) when the kernel boots successfully.
76 .Nx
77 is halted the machine will go through the cold reset and will reboot
78 into Windows\ CE.
79 .\"
80 .Ss Normal Operation
81 .\"
82 Please, refer to the
83 .Xr hpcboot 8
84 manual page.
85 .Sh FILES
86 .\"
87 .Bl -tag -width hpcboot.exe -compact
88 .It Pa hpcboot.exe
89 bootloader program for Windows\ CE
90 .El
91 .\"
92 .Sh SEE ALSO
93 .\"
94 .Xr hpcboot 8
95 .\"
96 .Sh BUGS
97 .\"
98 There is no general way to launch the bootloader automatically, as
99 only a few Windows\ CE machines provide an
100 .Dq auto run
101 mechanism.
103 This port doesn't support
104 .Xr kloader 4 ,
105 which means that when the system is rebooted, it goes back to Windows\ CE.