1*99bf06daSreed.\" $NetBSD: hpcboot.8,v 1.6 2019/12/23 17:31:54 reed Exp $ 28199a8e5Suwe.\" 38199a8e5Suwe.\" Copyright (c) 2004 Valeriy E. Ushakov 48199a8e5Suwe.\" All rights reserved. 58199a8e5Suwe.\" 68199a8e5Suwe.\" Redistribution and use in source and binary forms, with or without 78199a8e5Suwe.\" modification, are permitted provided that the following conditions 88199a8e5Suwe.\" are met: 98199a8e5Suwe.\" 1. Redistributions of source code must retain the above copyright 108199a8e5Suwe.\" notice, this list of conditions and the following disclaimer. 118199a8e5Suwe.\" 2. Neither the name of the author nor the names of any 128199a8e5Suwe.\" contributors may be used to endorse or promote products derived 138199a8e5Suwe.\" from this software without specific prior written permission. 148199a8e5Suwe.\" 158199a8e5Suwe.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS 168199a8e5Suwe.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 178199a8e5Suwe.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 188199a8e5Suwe.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 198199a8e5Suwe.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 208199a8e5Suwe.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 218199a8e5Suwe.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 228199a8e5Suwe.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 238199a8e5Suwe.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 248199a8e5Suwe.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 258199a8e5Suwe.\" POSSIBILITY OF SUCH DAMAGE. 268199a8e5Suwe.\" 278199a8e5Suwe.Dd April 3, 2004 288199a8e5Suwe.Dt HPCBOOT 8 298199a8e5Suwe.Os 308199a8e5Suwe.Sh NAME 318199a8e5Suwe.Nm hpcboot 328199a8e5Suwe.Nd load and boot kernel from Windows\ CE 338199a8e5Suwe.Sh SYNOPSIS 348199a8e5Suwe.Nm hpcboot.exe 358199a8e5Suwe.Sh DESCRIPTION 368199a8e5Suwe.Nm 378199a8e5Suweis a program that runs on Windows\ CE. 388199a8e5SuweIt loads and executes the specified 398199a8e5Suwe.Nx 408199a8e5Suwekernel. 418199a8e5Suwe.Nm 428199a8e5Suwesupports hpcarm, hpcmips, and hpcsh ports. 43f292fa7aSuwe.Pp 44f292fa7aSuweClick on the 45f292fa7aSuwe.Dq Boot 46f292fa7aSuwebutton to start the boot process with selected options. 47f292fa7aSuweClick on the 48f292fa7aSuwe.Dq Cancel 49f292fa7aSuwebutton to exit 50f292fa7aSuwe.Nm . 51f292fa7aSuwe.\" 52*99bf06daSreed.Ss Kernel Tab 53f292fa7aSuwe.\" 54f292fa7aSuweOn this tab you can select the kernel to boot and options to pass to 55f292fa7aSuwethe kernel. 56f292fa7aSuwe.Bl -tag -width "xx" 57f292fa7aSuwe.It Directory 58f292fa7aSuweIn this combobox you specify the 59f292fa7aSuwe.Dq current 60f292fa7aSuwedirectory. 61f292fa7aSuweThe kernel and miniroot image pathnames are taken to be relative to 62f292fa7aSuwethis directory. 63f292fa7aSuwe.Pp 64f292fa7aSuwe.Nm 65f292fa7aSuwecan load kernel and miniroot from FAT and UFS filesystems, and via 66f292fa7aSuweHTTP. 67f292fa7aSuwe.\" FIXME: describe the syntax for each of the above 68f292fa7aSuwe.It Kernel 69f292fa7aSuweIn this text field you specify the name of the kernel to load. 70f292fa7aSuweKernels compressed with 71f292fa7aSuwe.Xr gzip 1 72f292fa7aSuweare supported. 73f292fa7aSuwe.It Model 74f292fa7aSuweSelect your H/PC model in this combobox. 75f292fa7aSuwe.It Root File System 76f292fa7aSuweThis group of controls lets you specify the desired root file system 77f292fa7aSuwetype. 78f292fa7aSuweYou can select 79f292fa7aSuwe.Xr wd 4 , 80f292fa7aSuwe.Xr sd 4 , 81f292fa7aSuwe.Xr md 4 , 82f292fa7aSuweand NFS root. 83f292fa7aSuwe.Pp 84f292fa7aSuweIf you select 85f292fa7aSuwe.Xr md 4 86f292fa7aSuwememory disk root file system, you should specify the path name of the 87f292fa7aSuwefile system image in the text field below. 88f292fa7aSuweMiniroot images compressed with 89f292fa7aSuwe.Xr gzip 1 90f292fa7aSuweare supported. 91f292fa7aSuwe.It Kernel Boot Flags 92f292fa7aSuweThis group of controls is used to pass boot flags to the kernel. 93f292fa7aSuwe.El 94f292fa7aSuwe.\" 95*99bf06daSreed.Ss Option Tab 96f292fa7aSuwe.\" 97f292fa7aSuweOn this tab you can specify miscellaneous options that mostly control the 98f292fa7aSuwe.Nm 99f292fa7aSuweprogram itself. 100f292fa7aSuwe.Bl -tag -width "xx" 101f292fa7aSuwe.It Auto Boot 102f292fa7aSuweIf this option is selected 103f292fa7aSuwe.Nm 104f292fa7aSuwewill automatically boot 105f292fa7aSuwe.Nx 106f292fa7aSuweafter the specified timeout. 107f292fa7aSuwe.It Reverse Video 108f292fa7aSuweTells kernel if it should use the framebuffer in reverse video mode. 109f292fa7aSuwe.It Pause Before Boot 110f292fa7aSuweIf selected, a warning dialog will be presented 111f292fa7aSuwe.Em before 112f292fa7aSuweanything is done, right after the 113f292fa7aSuwe.Dq Boot 114f292fa7aSuwebutton is pressed. 115f292fa7aSuwe.It Load Debug Info 116f292fa7aSuweThis option currently does nothing. 117f292fa7aSuwe.It Safety Message 118f292fa7aSuweIf selected, a warning dialog will be presented 119f292fa7aSuwe.Em after 120f292fa7aSuwethe kernel has been loaded and prepared to be started. 121f292fa7aSuweThis will be your last chance to cancel the boot. 122f292fa7aSuwe.It Extra Kernel Options 123f292fa7aSuweIn this text field you can specify additional options to pass to the 124f292fa7aSuwekernel. 125f292fa7aSuwe.El 126f292fa7aSuwe.\" 127*99bf06daSreed.Ss Console Tab 128f292fa7aSuwe.\" 129f292fa7aSuweThis tab gets its name from the big text area that 130f292fa7aSuwe.Nm 131f292fa7aSuweuses as the 132f292fa7aSuwe.Dq console 133f292fa7aSuweto report its progress. 134f292fa7aSuwe.Bl -tag -width "xx" 135f292fa7aSuwe.It Save To File 136f292fa7aSuweIf checked, the progress log will be sent to the specified file instead. 137f292fa7aSuwe.It Dq Checkboxes Anonymous 13881b1f932SuweThe row of 8 checkboxes controls debugging options for 139f292fa7aSuwe.Nm 140f292fa7aSuweitself. 141f292fa7aSuweThey control the bits of an internal variable, the leftmost checkbox 142522d70a8Swizbeing the 7th bit. 143f292fa7aSuwe.It Dq Buttons Anonymous 144f292fa7aSuweThe buttons 145f292fa7aSuwe.Dq a 146f292fa7aSuweto 147f292fa7aSuwe.Dq d 148f292fa7aSuwecontrol 4 149f292fa7aSuwe.Dq hooks 150f292fa7aSuwea developer might want to use during 151f292fa7aSuwe.Nm 152f292fa7aSuwedevelopment. 153f292fa7aSuwe.El 1548199a8e5Suwe.Sh SEE ALSO 155f292fa7aSuwe.Xr kloader 4 , 156f292fa7aSuwe.Xr boot 8 1578199a8e5Suwe.Sh HISTORY 1588199a8e5SuweThe 1598199a8e5Suwe.Nm 1608199a8e5Suweutility first appeared in 1618199a8e5Suwe.Nx 1.6 . 1628199a8e5Suwe.Sh BUGS 1638199a8e5Suwe.Nm 1648199a8e5Suwereads the entire kernel image at once, 1658199a8e5Suweand requires enough free area on the main memory. 166