.SH SYNOPSIS
.I none
.SH DESCRIPTION
-When booting Plan 9 on a PC, the DOS program
+When booting Plan 9 on a PC, the bootloader program
.IR 9boot (8)
-first reads a DOS file
-containing configuration information from the boot disk.
+first reads configuration information from a file
+on the boot media.
This file,
.BR plan9.ini ,
looks like a shell script containing lines of the form
.EE
BUG: On many machines only the 16 bit card works.
.TP
+.B bcm
+Broadcom BCM57xx Gigabit Ethernet controllers.
+Completely configurable, no options need be given.
+.TP
+.B yuk
+Marvell 88e8057 Yukon2 Gigabit Ethernet controller.
+Completely configurable, no options need be given.
+.TP
+.B virtio
+Virtual Ethernet interface provided by QEMU/KVM and VirtualBox.
+No options need be given. The MAC address can be changed with the
+.B ea=
+option.
+.TP
.B sink
A
.B /dev/null
.B iwl
Intel Wireless WiFi Link mini PCI-Express adapters require
firmware from
-.B http://firmware.openbsd.org/firmware/iwn-firmware*.tgz
+.B http://firmware.openbsd.org/firmware/*/iwn-firmware*.tgz
to be present on attach in
.B /lib/firmware
or
.B /boot.
-To select the access point, the
+To limit the selected APs the options
.B essid=
and
.B bssid=
-parameters can be specified at boot or set during runtime
-like:
+may be set at boot or in the ether interface clone file
+using a space as the separator between option and value, e.g.
.EX
echo essid left-armpit >/net/ether1/clone
.EE
-If both
-.B essid=
-and
-.B bssid=
-are specified, both must match.
Scan results appear in the
.B ifstats
file and can be read out like:
cat /net/ether1/ifstats
.EE
Ad-hoc mode or WEP encryption is currently not supported.
-To enable WPA/WPA2 encryption, see
-.IR wpa (8)
-for details.
.TP
.B rt2860
Ralink Technology PCI/PCI-Express wireless adapters require
firmware from
-.B http://firmware.openbsd.org/firmware/ral-firmware*.tgz
+.B http://firmware.openbsd.org/firmware/*/ral-firmware*.tgz
to be present on attach in
.B /lib/firmware
or
.B /boot.
See iwl section above for configuration details.
+.TP
+.B wpi
+Intel PRO Wireless 3945abg PCI/PCI-Express wireless adapters require
+firmware from
+.B http://firmware.openbsd.org/firmware/*/wpi-firmware*.tgz
+to be present on attach in
+.B /lib/firmware
+or
+.B /boot.
+See iwl section above for configuration details.
+.SS \fLwpapsk\fI=password\fP
+WPA/WPA2 encryption
+is detected automatically and a prompt for the
+.I password
+will appear when using the WIFI interface for netbooting.
+To avoid the prompt, the
+.I password
+can be specified with the boot parameter above.
+.SS \fLnora6=
+Disable automatic IPv6 configuration from incoming router advertisements.
.SS DISKS, TAPES
(S)ATA controllers are autodetected.
.SS \fL*nodma=\fP
and
.I slot
to use as a root device for bootstrapping.
+.SS \fLramdisk\fIX\fL=\fIsize\fP
+.SS \fLramdisk\fIX\fL=\fIsize sectorsize\fP
+.SS \fLramdisk\fIX\fL=\fIaddress size sectorsize\fP
+This reserves physical memory as a ramdisk that will appear as
+.IR sd (3)
+device \fLsdZ\fIX\fR.
+When the
+.I address
+argument is omited or zero, then the ramdisk will be allocated
+from the top of physical memory.
.SS AUDIO
.SS \fLaudio\fIX\fL=\fIvalue\fP
-This defines a sound interface.
+This defines a sound interface. PCI based audio devices such as
+Intel HD audio or AC97 are autodetected and do not require any settings.
.PP
Known types are
.TF ess1688
.PD
.TP
+.B hda
+Intel HD audio.
+.TP
+.B ac97
+AC97 based card.
+.TP
.B sb16
Sound Blaster 16.
.TP
.LP
would use COM1 at 19,200 baud
with odd parity.
+.LP
+The value
+.B net
+specifies ``netconsole'' which sends console messages as UDP packets over the network.
+It bypasses the IP stack and writes Ethernet packets directly to the NIC.
+In this case
+.I params
+is mandatory and takes the form
+.IP
+\fIsrcip\fR [ \fB!\fIsrcport \fR] [ \fB/\fIdevno \fR] \fB, \fIdstip\fR [ \fB!\fIdstport \fR] [ \fB/\fIdstmac \fR]
+.LP
+\fISrcip\fR, \fIsrcport\fR (default 6665), \fIdstip\fR and \fIdstport\fR (default 6666) specify the source IP address, source port, destination IP address and destination port, respectively.
+\fIDevno\fR (default 0) specifies which NIC to use, a value of \fIn\fR corresponds to NIC at \fL#l\fIn\fR (see
+.IR ether (3)).
+\fIDstmac\fR specifies the destination MAC address; broadcast packets are sent if it is unspecified.
+Note that it is possible, but not recommended, to send packets to a host outside the local network by specifying the MAC address of the gateway as \fIdstmac\fR.
+Example lines are
+.IP
+.EX
+console=net 192.168.0.4,192.168.0.8
+console=net 192.168.2.10!1337/1,192.168.2.3!1337/0ea7deadbeef
+.EE
+.LP
.SS "PC CARD"
.SS \fLpccard0=disabled\fP
Disable probing for and automatic configuration of PC card controllers.
for more.
.SS \fLnobootprompt=\fIvalue\fP
Suppress the
-.L "root from"
+.L bootargs
prompt and use
.I value
as the answer instead.
+.SS \fLrootdir=\fB/root/\fIdir\fP
+.SS \fLrootspec=\fIspec\fP
+Changes the mount arguments for the root file server
+that was specified by
+.I bootargs
+above.
+By changing
+.I dir
+in
+.BR $rootdir ,
+a different sub-directory on the root file server
+can be used as the system root. see
+.IR boot (8)
+for details.
.SS \fLuser=\fIvalue\fP
Suppress the
.L "user"
battery life (see
.IR stats (8)).
It is not on by default because it causes problems on some laptops.
-.SS \fLusbwait=\fIvalue\fP
-This changes the sleep time from the default 2 to value in cases of
-USB devices taking a long time to come online.
+.SS USB
+.SS \fL*nousbprobe=\fP
+Disable USB host controller detection.
+.SS \fL*nousbohci=\fP
+.SS \fL*nousbuhci=\fP
+.SS \fL*nousbehci=\fP
+.SS \fL*nousbxhci=\fP
+Disable specific USB host controller types.
+.SS \fLnousbrc=\fP
+Disable
+.IR nusbrc (8)
+startup at boot time.
.SS \fLnousbhname=\fP
When defined,
.IR nusbrc (8)
serial0=type=generic port=0x3E8 irq=5
monitor=445x
vgasize=1600x1200x8
-bootfile=/386/9pcf
+bootfile=/386/9pc
%
.EE
.SH "SEE ALSO"
.IR 9boot (8),
.IR booting (8),
.IR boot (8)
-.SH BUGS
-Being able to set the console device to other than a
-display is marginally useful on file servers; MS-DOS
-and the programs which run under it are so tightly bound
-to the display that it is necessary to have a display if any
-setup or reconfiguration programs need to be run.
-Also, the delay before any messages appear at boot time
-is disconcerting, as any error messages from the BIOS
-are lost.
-.PP
-The declaration of a kernel parameter which is a prefix of
-previously declared parameters will delete the previous
-ones. If this is not desired, parameters should be given
-in shortest to longest order.