.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"
with the
.B -p
option, so that it can be debugged.
-.SS \fLfactotumopts=\fIoptions\fP
-Causes
-.IR boot (8)
-to start
-.I factotum
-with the given
-.IR options ,
-which must be a single word (i.e., contain no whitespace).
.SS \fLcfs=\fIvalue\fP
This gives the name of the file holding the disk partition
for the cache file system,
.B bootargs
and
.BR cfs .
-.SS \fLfs=\fIa.b.c.d\fP
-.SS \fLauth=\fIa.b.c.d\fP
-These specify the IP address of the file and authentication server
+.SS \fLfs=\fIaddress\fP
+.SS \fLauth=\fIaddress\fP
+.SS \fLsecstore=\fIaddress\fP
+These specify the network address (IP or domain name)
+of the file, authentication and secstore server
to use when mounting a network-provided root file system.
-They are used only if the addresses cannot be determined via DHCP.
+When not specified, then these settings are determined via DHCP.
+When
+.B secstore
+is not specified, then the authentication server is used.
.SS PROCESSOR
.SS \fL*e820=\fItype \fB0x\fIstart \fB0x\fIend ...\fP
This variable is automatically generated by the boot loader (see
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.