.\" $OpenBSD: boot_config.8,v 1.9 1999/07/09 13:35:36 aaron Exp $ .\" .\" Copyright (c) 1996 Mats O Jansson .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by Theo de Raadt. .\" 4. Neither the name of the author nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .Dd December 13, 1998 .Dt boot_config 8 .Os .Sh NAME .Nm boot_config .Nd how to change kernel configuration at boot .Sh DESCRIPTION .Nm BOOT_CONFIG is a kernel option that makes it possible to change the configuration at boot time. .Pp The boot time configuration is invoked by the .Fl c option when OpenBSD prompts for a kernel to boot: .Pp .Bd -literal >> OpenBSD BOOT 640/31744 k [1.29] use ? for file list, or carriage return for defaults use hd(1,a)/bsd to boot sd0 when sd0 is also installed .No "Boot: [[[wd(0,a)]/bsd][-abcdrs]] :" Ic -c Booting... avail mem = 28188672 using 430 buffers containing 1761280 bytes of memory User Kernel Config UKC> .Ed .Sh COMMANDS .Bl -tag -width "disable devno | dev" indent .It Ic add Ar dev Add a device through copying another. .It Ic base Ar 8 | 10 | 16 Change the base of numbers displayed and entered, e.g. I/O addresses in a VAXen are octal. .It Ic change Ar devno | dev Modify one or more devices. .It Ic disable Ar devno | dev Disable one or more devices. .It Ic enable Ar devno | dev Enable one or more devices. .It Ic exit Continue boot. .It Ic find Ar devno | dev Find one or more devices. .It Ic help Give a short summary of all commands and their arguments. .It Ic list Show all known devices, a screen at a time. .It Ic lines Op Ar count Set the number of rows per page. .It Ic quit Continue boot. .It Ic show Op Ar attr Op Ar val Show all devices for which attribute .Ar attr has the value .Ar val . .It Ic verbose Toggle the autoconfig verbose variable. .El .Pp .Sh EXAMPLES The ethernet card is not detected at boot because the kernel configuration does not match the physical hardware configuration, e.g. wrong IRQ in OpenBSD/i386. The ethernet card is supposed to use the .Xr ne 4 driver. .Pp .Bd -literal .No UKC> Ic find ne 24 ne0 at isa0 port 0x240 size 0 iomem 0xd8000 iosiz 0 irq 9 drq -1 drq2 -1 25 ne1 at isa0 port 0x300 size 0 iomem -1 iosiz 0 irq 10 drq -1 drq2 -1 26 ne* at isapnp0 port -1 size 0 iomem -1 iosiz 0 irq -1 drq -1 27 ne* at pci* dev -1 function -1 28 ne* at pcmcia* function -1 irq -1 UKC> .Ed .Pp ne1 seems to match the configuration except it uses IRQ 5 instead of IRQ 10. So the irq on ne1 should be changed via the .Fa change command. The device can be specified by either name or number. .Pp .Bd -literal .No UKC> Ic change ne1 25 ne1 at isa0 port 0x300 size 0 iomem -1 iosiz 0 irq 10 drq -1 drq2 -1 .No change (y/n) ? Ic y .No port [0x300] ? .No size [0] ? .No iomem [-1] ? .No iosiz [0] ? .No irq [10] ? Ic 5 .No drq [-1] ? .No drq2 [-1] ? 25 ne1 changed 25 ne1 at isa0 port 0x300 size 0 iomem -1 iosiz 0 irq 5 drq -1 drq2 -1 UKC> .Ed .Pp Another case is a mistakenly detected non-existing device instead of another device at the probed location. One known case is the Mitsumi CD-ROM in OpenBSD/i386. The simplest thing to solve that problem is to disable mcd0. .Pp .Bd -literal .No UKC> Ic find mcd0 29 mcd0 at isa0 port 0x300 size 0 iomem -1 iosiz 0 irq 10 drq -1 drq2 -1 .No UKC> Ic disable mcd0 29 mcd0 disabled .No UKC> Ic find 29 29 mcd0 at isa0 disable port 0x300 size 0 iomem -1 iosiz 0 irq 10 drq -1 drq2 -1 .Ed .Pp The show command is useful for finding which devices have a certain attribute. It can also be used to find those devices with a particular value for an attribute. .Bd -literal .No UKC> Ic show slot 2 ahc* at eisa0 slot -1 10 uha* at eisa0 slot -1 12 ep0 at eisa0 slot -1 17 ep* at eisa0 slot -1 102 ahb* at eisa0 slot -1 103 fea* at eisa0 slot -1 .No UKC> Ic show port 0x300 25 ne1 at isa0 port 0x300 size 0 iomem -1 iosiz 0 irq 10 drq -1 drq2 -1 72 we1 at isa0 port 0x300 size 0 iomem 0xcc000 iosiz 0 irq 10 drq -1 drq2 -1 75 el0 at isa0 port 0x300 size 0 iomem -1 iosiz 0 irq 9 drq -1 drq2 -1 77 ie1 at isa0 port 0x300 size 0 iomem -1 iosiz 0 irq 10 drq -1 drq2 -1 UKC> .Ed .Pp It is possible to add new devices, but only devices that were linked into the kernel. If a new device is added, following devices will be renumbered. .Pp .Bd -literal .No UKC> Ic find ep 11 ep0 at isa0 port -1 size 0 iomem -1 iosiz 0 irq -1 drq -1 drq2 -1 12 ep0 at eisa0 slot -1 13 ep0 at pci* dev -1 function -1 14 ep* at isapnp0 port -1 size 0 iomem -1 iosiz 0 irq -1 drq -1 15 ep* at isa0 port -1 size 0 iomem -1 iosiz 0 irq -1 drq -1 drq2 -1 16 ep* at eisa0 slot -1 17 ep* at pci* dev -1 function -1 18 ep* at pcmcia* dev -1 irq -1 .No UKC> Ic add ep1 .No "Clone Device (DevNo, 'q' or '?') ?" Ic 13 .No "Insert before Device (DevNo, 'q' or '?')" Ic 14 14 ep1 at pci* dev -1 function -1 .No UKC> Ic change 14 14 ep1 at pci* dev -1 function -1 .No change (y/n) ? Ic y .No dev [-1] ? Ic 14 .No function [-1] ? 14 ep1 changed 14 ep1 at pci* dev 14 function -1 UKC> .Ed .Pp When configuration is completed, booting can proceed by issuing the .Ic quit or .Ic exit commands. .Pp .Bd -literal .No UKC> Ic quit Continuing... mainbus0 (root) .Ed .Pp .Sh BUGS The add command is rather restricted, and might be expanded in the future. .Pp There is no way to save the configuration for next boot. .Sh AUTHOR Mats O Jansson