INSTALL revision 1.18
11.18Snonaka#	$NetBSD: INSTALL,v 1.18 2002/05/02 14:58:36 nonaka 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.1Snonakamakeoptions	COPTS="-Os -mmultiple"	# -Os -mmultiple to 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.12Slukemoptions 	MEMORY_DISK_ROOT_SIZE=4096	# 2 Megabytes
161.1Snonaka
171.1Snonakamaxusers	8
181.18Snonaka
191.18Snonaka# Platform support
201.18Snonakaoptions 	PLATFORM_IBM_6050		# IBM Personal Power Series 830
211.18Snonakaoptions 	PLATFORM_IBM_7248		# IBM RS/6000 7248-100/120/133
221.18Snonakaoptions 	PLATFORM_MOTOROLA_ULMB60XA	# Motorola ULMB60xA (?)
231.1Snonaka
241.1Snonaka# Compatibility options
251.1Snonaka#options 	COMPAT_13	# NetBSD 1.3,
261.3Snonakaoptions 	COMPAT_14	# NetBSD 1.4,
271.3Snonakaoptions 	COMPAT_43	# and 4.3BSD
281.1Snonaka
291.1Snonaka# File systems
301.1Snonakafile-system 	FFS		# UFS
311.1Snonakafile-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.1Snonaka
371.1Snonaka# File system options
381.1Snonakaoptions 	VNODE_OP_NOINLINE # Save space by not inlining vnode op calls
391.3Snonaka#options 	FFS_EI		# FFS Endian Independant support
401.1Snonaka#options 	EXT2FS_SYSTEM_FLAGS # makes ext2fs file flags (append and
411.1Snonaka 				# immutable) behave as system flags.
421.10Sjdolecek
431.13Sgmcgarry#options 	USERCONF	# userconf(4) support
441.10Sjdolecek#options	PIPE_SOCKETPAIR	# smaller, but slower pipe(2)
451.1Snonaka
461.1Snonaka# Networking options
471.1Snonakaoptions 	INET		# IP + ICMP + TCP + UDP
481.1Snonakaoptions 	NFS_BOOT_BOOTPARAM
491.1Snonakaoptions 	NFS_BOOT_DHCP
501.1Snonaka
511.9Ssoren#
521.9Ssoren# wscons options
531.9Ssoren#
541.9Ssoren# builtin terminal emulations
551.9Ssorenoptions 	WSEMUL_VT100		# VT100 / VT220 emulation
561.9Ssoren# different kernel output - see dev/wscons/wsdisplayvar.h
571.9Ssorenoptions 	WS_KERNEL_FG=WSCOL_GREEN
581.9Ssoren#options 	WS_KERNEL_BG=WSCOL_BLACK
591.9Ssoren# see dev/pckbc/wskbdmap_mfii.c for implemented layouts
601.9Ssoren#options 	PCKBD_LAYOUT="(KB_DE | KB_NODEAD)"
611.9Ssoren# allocate a number of virtual screens at autoconfiguration time
621.9Ssoren#options 	WSDISPLAY_DEFAULTSCREENS=4
631.9Ssoren# use a large software cursor that doesn't blink
641.9Ssorenoptions 	PCDISPLAY_SOFTCURSOR
651.9Ssoren
661.1Snonaka# Kernel root file system and dump configuration.
671.1Snonakaconfig	netbsd	root on ? type ?
681.1Snonaka
691.1Snonaka
701.1Snonaka#
711.1Snonaka# Device configuration
721.1Snonaka#
731.1Snonaka
741.1Snonakamainbus0 at root
751.1Snonakacpu0	at mainbus0
761.1Snonaka
771.1Snonaka
781.1Snonaka# Basic Bus Support
791.1Snonaka
801.1Snonaka# PCI bus support
811.1Snonakapci0	at mainbus0 bus ?
821.1Snonakapci*	at pchb? bus ?
831.1Snonaka
841.3Snonakaoptions 	PCI_NETBSD_CONFIGURE
851.3Snonaka
861.1Snonaka# PCI bridges
871.1Snonakapchb*	at pci? dev ? function ?	# PCI-Host bridges
881.1Snonakapcib*	at pci? dev ? function ?	# PCI-ISA bridges
891.1Snonaka
901.1Snonaka# ISA bus support
911.1Snonakaisa*	at pcib?			# ISA on PCI-ISA bridge
921.1Snonaka
931.1Snonaka# PCMCIA bus support
941.1Snonakapcmcia* at pcic? controller ? socket ?
951.1Snonaka
961.1Snonaka# ISA PCMCIA controllers
971.1Snonakapcic0	at isa? port 0x3e0 iomem 0xd0000 iosiz 0x10000
981.1Snonaka
991.1Snonaka#options 	PCIC_ISA_INTR_ALLOC_MASK=0x4a00 # free irq 9,11,14
1001.1Snonaka#options 	PCIC_ISA_ALLOC_IOBASE=0x0400
1011.1Snonaka#options 	PCIC_ISA_ALLOC_IOSIZE=0x0100
1021.1Snonaka
1031.1Snonaka# ISA Plug-and-Play bus support
1041.1Snonakaisapnp0 at isa?
1051.1Snonaka
1061.1Snonaka# Console Devices
1071.1Snonaka
1081.9Ssoren# wscons
1091.9Ssorenpckbc0		at isa?			# pc keyboard controller
1101.9Ssorenpckbd*		at pckbc?		# PC keyboard
1111.9Ssorenpms*		at pckbc?		# PS/2 mouse for wsmouse
1121.9Ssorenvga*		at pci?
1131.9Ssorenwsdisplay*	at vga? console ?
1141.9Ssorenwskbd*		at pckbd? console ?
1151.9Ssorenwsmouse*	at pms? mux 0
1161.1Snonaka
1171.9Ssorenpcppi0	at isa?				# PC prog. periph. interface
1181.9Ssorenisabeep0 at pcppi?			# "keyboard" beep
1191.1Snonaka
1201.1Snonakamcclock0 at isa? port 0x70		# mc146818 and compatible
1211.1Snonaka
1221.1Snonaka
1231.1Snonaka# Serial Devices
1241.1Snonaka
1251.1Snonaka# ISA serial interfaces
1261.1Snonakacom0	at isa? port 0x3f8 irq 4	# standard PC serial ports
1271.1Snonakacom1	at isa? port 0x2f8 irq 3
1281.1Snonaka
1291.1Snonaka# Parallel Printer Interfaces
1301.1Snonaka
1311.1Snonaka# ISA parallel printer interfaces
1321.1Snonakalpt0	at isa? port 0x3bc irq 7	# standard PC parallel ports
1331.1Snonaka
1341.1Snonaka
1351.1Snonaka# SCSI Controllers and Devices
1361.1Snonaka
1371.1Snonaka# PCI SCSI controllers
1381.6Sbriggsadw*	at pci? dev ? function ?	# AdvanSys 9x0UW[D], 3940U[2,3]W SCSI
1391.5Snonakaahc*	at pci? dev ? function ?	# Adaptec [23]94x, aic78x0 SCSI
1401.4Stsutsuiiha*	at pci? dev ? function ?	# Initio INIC-940/950 SCSI
1411.1Snonakapcscp*	at pci? dev ? function ?	# AMD 53c974 PCscsi-PCI SCSI
1421.3Snonakasiop*	at pci? dev ? function ?	# Symbios 53c8xx SCSI
1431.1Snonaka
1441.1Snonaka# PCMCIA SCSI controllers
1451.1Snonakaaic*	at pcmcia? function ?		# Adaptec APA-1460 SCSI
1461.1Snonaka
1471.1Snonaka# SCSI bus support
1481.6Sbriggsscsibus* at adw?
1491.5Snonakascsibus* at ahc?
1501.1Snonakascsibus* at aic?
1511.4Stsutsuiscsibus* at iha?
1521.1Snonakascsibus* at pcscp?
1531.3Snonakascsibus* at siop?
1541.1Snonaka
1551.1Snonaka# SCSI devices
1561.1Snonakasd*	at scsibus? target ? lun ?	# SCSI disk drives
1571.1Snonakast*	at scsibus? target ? lun ?	# SCSI tape drives
1581.1Snonakacd*	at scsibus? target ? lun ?	# SCSI CD-ROM drives
1591.1Snonaka
1601.1Snonaka
1611.1Snonaka# IDE and related devices
1621.1Snonaka
1631.1Snonaka# PCMCIA IDE controllers
1641.1Snonakawdc*	at pcmcia? function ?
1651.1Snonaka
1661.1Snonaka# IDE drives
1671.1Snonaka# Flags are used only with controllers that support DMA operations
1681.1Snonaka# and mode settings (e.g. some pciide controllers)
1691.1Snonaka# The lowest order four bits (rightmost digit) of the flags define the PIO
1701.1Snonaka# mode to use, the next set of four bits the DMA mode and the third set the
1711.1Snonaka# UltraDMA mode. For each set of four bits, the 3 lower bits define the mode
1721.1Snonaka# to use, and the last bit must be 1 for this setting to be used.
1731.1Snonaka# For DMA and UDMA, 0xf (1111) means 'disable'.
1741.1Snonaka# 0x0fac means 'use PIO mode 4, DMA mode 2, disable UltraDMA'.
1751.1Snonaka# (0xc=1100, 0xa=1010, 0xf=1111)
1761.1Snonaka# 0x0000 means "use whatever the drive claims to support".
1771.1Snonakawd*	at wdc? channel ? drive ? flags 0x0000
1781.1Snonaka
1791.1Snonaka# ATAPI bus support
1801.1Snonakaatapibus* at wdc? channel ?
1811.1Snonaka
1821.1Snonaka# ATAPI devices
1831.1Snonaka# flags have the same meaning as for IDE drives.
1841.1Snonakacd*	at atapibus? drive ? flags 0x0000	# ATAPI CD-ROM drives
1851.1Snonakasd*	at atapibus? drive ? flags 0x0000	# ATAPI disk drives
1861.1Snonaka
1871.1Snonaka# Miscellaneous mass storage devices
1881.1Snonaka
1891.1Snonaka# ISA floppy
1901.8Slukemfdc0	at isa? port 0x3f0 irq 6 drq 2	# standard PC floppy controllers
1911.1Snonakafd*	at fdc? drive ?
1921.1Snonaka
1931.1Snonaka# Network Interfaces
1941.1Snonaka
1951.1Snonaka# PCI network interfaces
1961.1Snonakaep*	at pci? dev ? function ?	# 3Com 3c59x
1971.16Skleinkex*	at pci? dev ? function ?	# 3Com 3c90x[BC]
1981.5Snonakafxp*	at pci? dev ? function ?	# Intel EtherExpress PRO 10+/100B
1991.1Snonakane*	at pci? dev ? function ?	# NE2000-compatible Ethernet
2001.7Stsutsuipcn*	at pci? dev ? function ?	# AMD PCnet-PCI Ethernet
2011.5Snonakartk*	at pci? dev ? function ?	# Realtek 8129/8139
2021.7Stsutsuisip*	at pci? dev ? function ?	# SiS 900/DP83815 Ethernet
2031.15Smycrofttlp*	at pci? dev ? function ?	# DECchip 21x4x and clones
2041.1Snonakavr*	at pci? dev ? function ?	# VIA Rhine Fast Ethernet
2051.1Snonaka
2061.5Snonaka# ISA network interfaces
2071.5Snonakaep*	at isa? port ? irq ?		# 3Com 3c509 Ethernet
2081.5Snonaka
2091.1Snonaka# ISA Plug-and-Play network intefaces
2101.1Snonakaep*	at isapnp?			# 3Com 3c509 Ethernet
2111.5Snonakane*	at isapnp?			# NE2000-compatible Ethernet
2121.1Snonaka
2131.1Snonaka# PCMCIA network interfaces
2141.1Snonakaep*	at pcmcia? function ?		# 3Com 3c589 and 3c562 Ethernet
2151.1Snonakane*	at pcmcia? function ?		# NE2000-compatible Ethernet
2161.1Snonaka
2171.1Snonaka# MII/PHY support
2181.16Skleinkexphy*	at mii? phy ?			# 3Com internal PHYs
2191.5Snonakainphy*	at mii? phy ?			# Intel 82555 PHYs
2201.5Snonakansphy*	at mii? phy ?			# NS83840 PHYs
2211.7Stsutsuiqsphy*	at mii? phy ?			# Quality Semiconductor QS6612 PHYs
2221.7Stsutsuisqphy*	at mii? phy ?			# Seeq 80220/80221/80223 PHYs
2231.1Snonakaukphy*	at mii? phy ?			# generic unknown PHYs
2241.1Snonaka
2251.1Snonaka
2261.1Snonaka# Pseudo-Devices
2271.1Snonaka
2281.1Snonaka# disk/mass storage pseudo-devices
2291.1Snonakapseudo-device	md		1	# memory disk device (ramdisk)
2301.1Snonaka
2311.1Snonaka# network pseudo-devices
2321.1Snonakapseudo-device	loop			# network loopback
2331.1Snonaka
2341.1Snonaka# miscellaneous pseudo-devices
2351.1Snonakapseudo-device	pty			# pseudo-terminals
2361.1Snonakapseudo-device	rnd			# /dev/random and in-kernel generator
2371.8Slukem#options 	RND_COM			# use "com" randomness as well
238