INSTALL revision 1.65
11.65Sandvar#	$NetBSD: INSTALL,v 1.65 2021/12/12 22:20:52 andvar Exp $
21.1Snonaka#
31.1Snonaka#	INSTALL -- Installation kernel
41.1Snonaka#
51.1Snonaka
61.1Snonakainclude "arch/prep/conf/std.prep"
71.17Satatat
81.17Satatat#options 	INCLUDE_CONFIG_FILE	# embed config file in kernel binary
91.1Snonaka
101.60Sjoergmakeoptions	COPTS="-Os" # Reduce size.
111.1Snonaka
121.1Snonaka# Enable the hooks used for initializing the ram-disk.
131.1Snonakaoptions 	MEMORY_DISK_HOOKS
141.1Snonakaoptions 	MEMORY_DISK_IS_ROOT	# Force root on ram-disk
151.64Smrgoptions 	MEMORY_DISK_ROOT_SIZE=4608	# 2.25mb
161.50Stsutsuioptions 	MEMORY_DISK_SERVER=0	# don't need for install
171.52Sjymoptions 	MEMORY_DISK_RBFLAGS=RB_SINGLE	# boot in single-user mode
181.1Snonaka
191.1Snonakamaxusers	8
201.18Snonaka
211.18Snonaka# Platform support
221.49Sgarbledoptions 	PIC_OPENPIC	# OpenPIC support (7043-140)
231.50Stsutsuioptions 	PIC_PREPIVR
241.50Stsutsuioptions 	PIC_I8259
251.20Snonaka
261.1Snonaka# Compatibility options
271.63Smrginclude 	"conf/compat_netbsd20.config"
281.1Snonaka
291.1Snonaka# File systems
301.1Snonakafile-system 	FFS		# UFS
311.38Sgarbled#file-system	EXT2FS		# second extended file system (linux)
321.1Snonakafile-system 	MFS		# memory file system
331.1Snonakafile-system 	NFS		# Network File System client
341.1Snonakafile-system 	CD9660		# ISO 9660 + Rock Ridge file system
351.1Snonakafile-system 	MSDOSFS		# MS-DOS file system
361.34Schristos#file-system	PTYFS		# /dev/pts/N support
371.1Snonaka
381.1Snonaka# File system options
391.62Srin#options 	DISKLABEL_EI	# disklabel Endian Independent support
401.55Swiz#options 	FFS_EI		# FFS Endian Independent support
411.41Sgarbledoptions 	FFS_NO_SNAPSHOT	# No FFS snapshot support
421.1Snonaka#options 	EXT2FS_SYSTEM_FLAGS # makes ext2fs file flags (append and
431.1Snonaka 				# immutable) behave as system flags.
441.57Sdhollandoptions 	WAPBL		# File system journaling support
451.10Sjdolecek
461.27Snonaka#options 	USERCONF	# userconf(4) support
471.21Sabsoptions 	PIPE_SOCKETPAIR		# smaller, but slower pipe(2)
481.28Satatat#options 	SYSCTL_INCLUDE_DESCR	# Include sysctl descriptions in kernel
491.50Stsutsuioptions 	NFS_V2_ONLY	# Exclude NFS3 code to save space
501.1Snonaka
511.1Snonaka# Networking options
521.1Snonakaoptions 	INET		# IP + ICMP + TCP + UDP
531.38Sgarbled#options 	NFS_BOOT_BOOTPARAM
541.38Sgarbled#options 	NFS_BOOT_DHCP
551.1Snonaka
561.9Ssoren#
571.9Ssoren# wscons options
581.9Ssoren#
591.9Ssoren# builtin terminal emulations
601.9Ssorenoptions 	WSEMUL_VT100		# VT100 / VT220 emulation
611.58Sabsoptions 	WSDISPLAY_COMPAT_USL		# wsconscfg VT handling
621.9Ssoren# different kernel output - see dev/wscons/wsdisplayvar.h
631.9Ssorenoptions 	WS_KERNEL_FG=WSCOL_GREEN
641.9Ssoren#options 	WS_KERNEL_BG=WSCOL_BLACK
651.39Sdrochner# see dev/pckbport/wskbdmap_mfii.c for implemented layouts
661.9Ssoren#options 	PCKBD_LAYOUT="(KB_DE | KB_NODEAD)"
671.9Ssoren# allocate a number of virtual screens at autoconfiguration time
681.9Ssoren#options 	WSDISPLAY_DEFAULTSCREENS=4
691.9Ssoren# use a large software cursor that doesn't blink
701.9Ssorenoptions 	PCDISPLAY_SOFTCURSOR
711.9Ssoren
721.1Snonaka# Kernel root file system and dump configuration.
731.1Snonakaconfig	netbsd	root on ? type ?
741.1Snonaka
751.1Snonaka#
761.1Snonaka# Device configuration
771.1Snonaka#
781.1Snonaka
791.1Snonakamainbus0 at root
801.1Snonakacpu0	at mainbus0
811.1Snonaka
821.1Snonaka# Basic Bus Support
831.1Snonaka
841.1Snonaka# PCI bus support
851.1Snonakapci0	at mainbus0 bus ?
861.1Snonakapci*	at pchb? bus ?
871.20Snonakapci*	at ppb? bus ?
881.1Snonaka
891.1Snonaka# PCI bridges
901.1Snonakapchb*	at pci? dev ? function ?	# PCI-Host bridges
911.1Snonakapcib*	at pci? dev ? function ?	# PCI-ISA bridges
921.20Snonakappb*	at pci? dev ? function ?	# PCI-PCI bridges
931.37Sgarbledpceb*	at pci? dev ? function ?	# PCI-EISA bridges
941.37Sgarbled
951.37Sgarbled# EISA bus support
961.37Sgarbledeisa*   at pceb?
971.1Snonaka
981.1Snonaka# ISA bus support
991.1Snonakaisa*	at pcib?			# ISA on PCI-ISA bridge
1001.37Sgarbledisa*	at pceb?
1011.1Snonaka
1021.1Snonaka# PCMCIA bus support
1031.44Sgarbledpcmcia* at pcic? controller ? socket ?
1041.1Snonaka
1051.1Snonaka# ISA PCMCIA controllers
1061.44Sgarbledpcic0	at isa? port 0x3e0 iomem 0xd0000 iosiz 0x10000
1071.1Snonaka
1081.1Snonaka#options 	PCIC_ISA_INTR_ALLOC_MASK=0x4a00 # free irq 9,11,14
1091.1Snonaka#options 	PCIC_ISA_ALLOC_IOBASE=0x0400
1101.1Snonaka#options 	PCIC_ISA_ALLOC_IOSIZE=0x0100
1111.1Snonaka
1121.1Snonaka# ISA Plug-and-Play bus support
1131.27Snonaka#isapnp0 at isa?
1141.1Snonaka
1151.65Sandvar# PNP bus device for attaching objects described in the residual
1161.37Sgarbledpnpbus0	at mainbus0
1171.19Snonaka
1181.1Snonaka# Console Devices
1191.1Snonaka
1201.9Ssoren# wscons
1211.9Ssorenpckbc0		at isa?			# pc keyboard controller
1221.9Ssorenpckbd*		at pckbc?		# PC keyboard
1231.27Snonaka#pms*		at pckbc?		# PS/2 mouse for wsmouse
1241.9Ssorenvga*		at pci?
1251.9Ssorenwsdisplay*	at vga? console ?
1261.9Ssorenwskbd*		at pckbd? console ?
1271.27Snonaka#wsmouse*	at pms? mux 0
1281.1Snonaka
1291.44Sgarbledmcclock* at pnpbus?			# mc146818 and compatible
1301.44Sgarbledmkclock* at pnpbus?			# mk48t18 and compatible
1311.44Sgarblednvram* at pnpbus?
1321.1Snonaka
1331.1Snonaka# Serial Devices
1341.1Snonaka
1351.1Snonaka# ISA serial interfaces
1361.1Snonakacom0	at isa? port 0x3f8 irq 4	# standard PC serial ports
1371.1Snonakacom1	at isa? port 0x2f8 irq 3
1381.1Snonaka
1391.1Snonaka# Parallel Printer Interfaces
1401.1Snonaka
1411.1Snonaka# ISA parallel printer interfaces
1421.27Snonaka#lpt0	at isa? port 0x3bc irq 7	# standard PC parallel ports
1431.1Snonaka
1441.1Snonaka
1451.1Snonaka# SCSI Controllers and Devices
1461.1Snonaka
1471.1Snonaka# PCI SCSI controllers
1481.27Snonaka#adw*	at pci? dev ? function ?	# AdvanSys 9x0UW[D], 3940U[2,3]W SCSI
1491.27Snonaka#ahc*	at pci? dev ? function ?	# Adaptec [23]94x, aic78x0 SCSI
1501.27Snonaka#esiop*	at pci? dev ? function ?	# Symbios 53c825/875 and newer chips
1511.27Snonaka#iha*	at pci? dev ? function ?	# Initio INIC-940/950 SCSI
1521.27Snonaka#pcscp*	at pci? dev ? function ?	# AMD 53c974 PCscsi-PCI SCSI
1531.3Snonakasiop*	at pci? dev ? function ?	# Symbios 53c8xx SCSI
1541.1Snonaka
1551.1Snonaka# PCMCIA SCSI controllers
1561.27Snonaka#aic*	at pcmcia? function ?		# Adaptec APA-1460 SCSI
1571.1Snonaka
1581.1Snonaka# SCSI bus support
1591.27Snonaka#scsibus* at adw?
1601.27Snonaka#scsibus* at ahc?
1611.27Snonaka#scsibus* at aic?
1621.27Snonaka#scsibus* at esiop?
1631.27Snonaka#scsibus* at iha?
1641.27Snonaka#scsibus* at pcscp?
1651.3Snonakascsibus* at siop?
1661.1Snonaka
1671.1Snonaka# SCSI devices
1681.1Snonakasd*	at scsibus? target ? lun ?	# SCSI disk drives
1691.1Snonakast*	at scsibus? target ? lun ?	# SCSI tape drives
1701.1Snonakacd*	at scsibus? target ? lun ?	# SCSI CD-ROM drives
1711.1Snonaka
1721.1Snonaka
1731.1Snonaka# IDE and related devices
1741.19Snonaka
1751.37Sgarbled# IDE controller found on most Power Personal machines
1761.37Sgarbledwdc*	at pnpbus?
1771.19Snonaka
1781.45Sgarbled# PCI IDE controllers
1791.45Sgarbledpciide*		at pci? dev ? function ? flags 0x0000
1801.45Sgarbledhptide*		at pci? dev ? function ?
1811.48Sgarbledslide*		at pci? dev ? function ?
1821.45Sgarbled
1831.1Snonaka# PCMCIA IDE controllers
1841.27Snonaka#wdc*	at pcmcia? function ?
1851.1Snonaka
1861.25Slukem# ATA (IDE) bus support
1871.25Slukematabus* at ata?
1881.24Sbouyer
1891.1Snonaka# IDE drives
1901.1Snonaka# Flags are used only with controllers that support DMA operations
1911.1Snonaka# and mode settings (e.g. some pciide controllers)
1921.1Snonaka# The lowest order four bits (rightmost digit) of the flags define the PIO
1931.1Snonaka# mode to use, the next set of four bits the DMA mode and the third set the
1941.1Snonaka# UltraDMA mode. For each set of four bits, the 3 lower bits define the mode
1951.1Snonaka# to use, and the last bit must be 1 for this setting to be used.
1961.1Snonaka# For DMA and UDMA, 0xf (1111) means 'disable'.
1971.1Snonaka# 0x0fac means 'use PIO mode 4, DMA mode 2, disable UltraDMA'.
1981.1Snonaka# (0xc=1100, 0xa=1010, 0xf=1111)
1991.1Snonaka# 0x0000 means "use whatever the drive claims to support".
2001.24Sbouyerwd*	at atabus? drive ? flags 0x0000
2011.1Snonaka
2021.1Snonaka# ATAPI bus support
2031.25Slukematapibus* at atapi?
2041.1Snonaka
2051.1Snonaka# ATAPI devices
2061.1Snonaka# flags have the same meaning as for IDE drives.
2071.1Snonakacd*	at atapibus? drive ? flags 0x0000	# ATAPI CD-ROM drives
2081.1Snonakasd*	at atapibus? drive ? flags 0x0000	# ATAPI disk drives
2091.1Snonaka
2101.1Snonaka# Miscellaneous mass storage devices
2111.1Snonaka
2121.1Snonaka# ISA floppy
2131.27Snonaka#fdc0	at isa? port 0x3f0 irq 6 drq 2	# standard PC floppy controllers
2141.27Snonaka#fd*	at fdc? drive ?
2151.1Snonaka
2161.1Snonaka# Network Interfaces
2171.1Snonaka
2181.1Snonaka# PCI network interfaces
2191.44Sgarbledep*	at pci? dev ? function ?	# 3Com 3c59x
2201.44Sgarbledex*	at pci? dev ? function ?	# 3Com 3c90x[BC]
2211.44Sgarbledfxp*	at pci? dev ? function ?	# Intel EtherExpress PRO 10+/100B
2221.44Sgarbledne*	at pci? dev ? function ?	# NE2000-compatible Ethernet
2231.7Stsutsuipcn*	at pci? dev ? function ?	# AMD PCnet-PCI Ethernet
2241.44Sgarbledrtk*	at pci? dev ? function ?	# Realtek 8129/8139
2251.44Sgarbledsip*	at pci? dev ? function ?	# SiS 900/DP83815 Ethernet
2261.15Smycrofttlp*	at pci? dev ? function ?	# DECchip 21x4x and clones
2271.44Sgarbledvr*	at pci? dev ? function ?	# VIA Rhine Fast Ethernet
2281.1Snonaka
2291.5Snonaka# ISA network interfaces
2301.27Snonaka#ep*	at isa? port ? irq ?		# 3Com 3c509 Ethernet
2311.37Sgarbledwe1	at isa? port 0x300 iomem 0xe4000 irq 11	# WD/SMC Ethernet
2321.5Snonaka
2331.1Snonaka# ISA Plug-and-Play network intefaces
2341.27Snonaka#ep*	at isapnp?			# 3Com 3c509 Ethernet
2351.27Snonaka#ne*	at isapnp?			# NE2000-compatible Ethernet
2361.1Snonaka
2371.1Snonaka# PCMCIA network interfaces
2381.44Sgarbledep*	at pcmcia? function ?		# 3Com 3c589 and 3c562 Ethernet
2391.44Sgarbledne*	at pcmcia? function ?		# NE2000-compatible Ethernet
2401.1Snonaka
2411.1Snonaka# MII/PHY support
2421.44Sgarbleddmphy*	at mii? phy ?			# Davicom DM9101 PHYs
2431.44Sgarbledexphy*	at mii? phy ?			# 3Com internal PHYs
2441.44Sgarbledicsphy*	at mii? phy ?			# Integrated Circuit Systems ICS189x
2451.44Sgarbledinphy*	at mii? phy ?			# Intel 82555 PHYs
2461.44Sgarblediophy*	at mii? phy ?			# Intel 82553 PHYs
2471.44Sgarbledlxtphy*	at mii? phy ?			# Level One LXT-970 PHYs
2481.5Snonakansphy*	at mii? phy ?			# NS83840 PHYs
2491.44Sgarblednsphyter* at mii? phy ?			# NS83843 PHYs
2501.44Sgarbledqsphy*	at mii? phy ?			# Quality Semiconductor QS6612 PHYs
2511.44Sgarbledsqphy*	at mii? phy ?			# Seeq 80220/80221/80223 PHYs
2521.44Sgarbledtlphy*	at mii? phy ?			# ThunderLAN PHYs
2531.44Sgarbledtqphy*	at mii? phy ?			# TDK Semiconductor PHYs
2541.1Snonakaukphy*	at mii? phy ?			# generic unknown PHYs
2551.1Snonaka
2561.40Sgarbled# Pull in optional local configuration
2571.40Sgarbledinclude "arch/prep/conf/INSTALL.local"
2581.1Snonaka
2591.1Snonaka# Pseudo-Devices
2601.1Snonaka
2611.1Snonaka# disk/mass storage pseudo-devices
2621.54Shannkenpseudo-device	md			# memory disk device (ramdisk)
2631.53Spooka#pseudo-device	fss			# file system snapshot device
2641.59Schristospseudo-device	raid			# RAIDframe disk driver
2651.50Stsutsuioptions 	RAID_AUTOCONFIG		# auto-configuration of RAID components
2661.1Snonaka
2671.1Snonaka# network pseudo-devices
2681.1Snonakapseudo-device	loop			# network loopback
2691.1Snonaka
2701.1Snonaka# miscellaneous pseudo-devices
2711.1Snonakapseudo-device	pty			# pseudo-terminals
2721.8Slukem#options 	RND_COM			# use "com" randomness as well
273