INSTALL revision 1.35
11.35Stsutsui#	$NetBSD: INSTALL,v 1.35 2005/12/07 09:10:19 tsutsui 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.33Skleinkoptions 	PLATFORM_IBM_6015		# IBM RS/6000 40P
211.23Smattoptions 	PLATFORM_IBM_6040		# IBM ThinkPad 820
221.18Snonakaoptions 	PLATFORM_IBM_6050		# IBM Personal Power Series 830
231.18Snonakaoptions 	PLATFORM_IBM_7248		# IBM RS/6000 7248-100/120/133
241.20Snonakaoptions 	PLATFORM_IBM_7043_140		# IBM RS/6000 43P 7043-140
251.18Snonakaoptions 	PLATFORM_MOTOROLA_ULMB60XA	# Motorola ULMB60xA (?)
261.1Snonaka
271.20Snonakaoptions 	OPENPIC				# OpenPIC support (7043-140)
281.20Snonaka
291.1Snonaka# Compatibility options
301.27Snonaka#options 	COMPAT_13	# NetBSD 1.3,
311.27Snonaka#options 	COMPAT_14	# NetBSD 1.4,
321.27Snonaka#options 	COMPAT_15	# NetBSD 1.5,
331.27Snonaka#options 	COMPAT_16	# NetBSD 1.6,
341.27Snonaka#options 	COMPAT_43	# and 4.3BSD
351.29Schristosoptions		COMPAT_BSDPTY	# /dev/[pt]ty?? ptys.
361.1Snonaka
371.1Snonaka# File systems
381.1Snonakafile-system 	FFS		# UFS
391.1Snonakafile-system	EXT2FS		# second extended file system (linux)
401.1Snonakafile-system 	MFS		# memory file system
411.1Snonakafile-system 	NFS		# Network File System client
421.1Snonakafile-system 	CD9660		# ISO 9660 + Rock Ridge file system
431.1Snonakafile-system 	MSDOSFS		# MS-DOS file system
441.34Schristos#file-system	PTYFS		# /dev/pts/N support
451.1Snonaka
461.1Snonaka# File system options
471.21Sabsoptions 	VNODE_OP_NOINLINE	# Not inlining vnode op calls saves mem
481.3Snonaka#options 	FFS_EI		# FFS Endian Independant support
491.35Stsutsui#options 	FFS_NO_SNAPSHOT	# No FFS snapshot support
501.1Snonaka#options 	EXT2FS_SYSTEM_FLAGS # makes ext2fs file flags (append and
511.1Snonaka 				# immutable) behave as system flags.
521.10Sjdolecek
531.27Snonaka#options 	USERCONF	# userconf(4) support
541.21Sabsoptions 	PIPE_SOCKETPAIR		# smaller, but slower pipe(2)
551.28Satatat#options 	SYSCTL_INCLUDE_DESCR	# Include sysctl descriptions in kernel
561.21Sabsoptions 	MALLOC_NOINLINE		# Not inlining MALLOC saves memory
571.1Snonaka
581.1Snonaka# Networking options
591.1Snonakaoptions 	INET		# IP + ICMP + TCP + UDP
601.1Snonakaoptions 	NFS_BOOT_BOOTPARAM
611.1Snonakaoptions 	NFS_BOOT_DHCP
621.1Snonaka
631.9Ssoren#
641.9Ssoren# wscons options
651.9Ssoren#
661.9Ssoren# builtin terminal emulations
671.9Ssorenoptions 	WSEMUL_VT100		# VT100 / VT220 emulation
681.9Ssoren# different kernel output - see dev/wscons/wsdisplayvar.h
691.9Ssorenoptions 	WS_KERNEL_FG=WSCOL_GREEN
701.9Ssoren#options 	WS_KERNEL_BG=WSCOL_BLACK
711.9Ssoren# see dev/pckbc/wskbdmap_mfii.c for implemented layouts
721.9Ssoren#options 	PCKBD_LAYOUT="(KB_DE | KB_NODEAD)"
731.9Ssoren# allocate a number of virtual screens at autoconfiguration time
741.9Ssoren#options 	WSDISPLAY_DEFAULTSCREENS=4
751.9Ssoren# use a large software cursor that doesn't blink
761.9Ssorenoptions 	PCDISPLAY_SOFTCURSOR
771.9Ssoren
781.1Snonaka# Kernel root file system and dump configuration.
791.1Snonakaconfig	netbsd	root on ? type ?
801.1Snonaka
811.1Snonaka
821.1Snonaka#
831.1Snonaka# Device configuration
841.1Snonaka#
851.1Snonaka
861.1Snonakamainbus0 at root
871.1Snonakacpu0	at mainbus0
881.1Snonaka
891.1Snonaka
901.1Snonaka# Basic Bus Support
911.1Snonaka
921.1Snonaka# PCI bus support
931.1Snonakapci0	at mainbus0 bus ?
941.1Snonakapci*	at pchb? bus ?
951.20Snonakapci*	at ppb? bus ?
961.1Snonaka
971.3Snonakaoptions 	PCI_NETBSD_CONFIGURE
981.3Snonaka
991.1Snonaka# PCI bridges
1001.1Snonakapchb*	at pci? dev ? function ?	# PCI-Host bridges
1011.1Snonakapcib*	at pci? dev ? function ?	# PCI-ISA bridges
1021.20Snonakappb*	at pci? dev ? function ?	# PCI-PCI bridges
1031.1Snonaka
1041.1Snonaka# ISA bus support
1051.1Snonakaisa*	at pcib?			# ISA on PCI-ISA bridge
1061.1Snonaka
1071.1Snonaka# PCMCIA bus support
1081.27Snonaka#pcmcia* at pcic? controller ? socket ?
1091.1Snonaka
1101.1Snonaka# ISA PCMCIA controllers
1111.27Snonaka#pcic0	at isa? port 0x3e0 iomem 0xd0000 iosiz 0x10000
1121.1Snonaka
1131.1Snonaka#options 	PCIC_ISA_INTR_ALLOC_MASK=0x4a00 # free irq 9,11,14
1141.1Snonaka#options 	PCIC_ISA_ALLOC_IOBASE=0x0400
1151.1Snonaka#options 	PCIC_ISA_ALLOC_IOSIZE=0x0100
1161.1Snonaka
1171.1Snonaka# ISA Plug-and-Play bus support
1181.27Snonaka#isapnp0 at isa?
1191.1Snonaka
1201.19Snonaka# on-board I/O for IBM Personal Power Series 830 IDE controller
1211.19Snonakaobio0	at mainbus0
1221.19Snonaka
1231.19Snonaka
1241.1Snonaka# Console Devices
1251.1Snonaka
1261.9Ssoren# wscons
1271.9Ssorenpckbc0		at isa?			# pc keyboard controller
1281.9Ssorenpckbd*		at pckbc?		# PC keyboard
1291.27Snonaka#pms*		at pckbc?		# PS/2 mouse for wsmouse
1301.9Ssorenvga*		at pci?
1311.9Ssorenwsdisplay*	at vga? console ?
1321.9Ssorenwskbd*		at pckbd? console ?
1331.27Snonaka#wsmouse*	at pms? mux 0
1341.1Snonaka
1351.1Snonakamcclock0 at isa? port 0x70		# mc146818 and compatible
1361.20Snonakamkclock0 at isa? port 0x74		# mk48t18 and compatible
1371.1Snonaka
1381.1Snonaka
1391.1Snonaka# Serial Devices
1401.1Snonaka
1411.1Snonaka# ISA serial interfaces
1421.1Snonakacom0	at isa? port 0x3f8 irq 4	# standard PC serial ports
1431.1Snonakacom1	at isa? port 0x2f8 irq 3
1441.1Snonaka
1451.1Snonaka# Parallel Printer Interfaces
1461.1Snonaka
1471.1Snonaka# ISA parallel printer interfaces
1481.27Snonaka#lpt0	at isa? port 0x3bc irq 7	# standard PC parallel ports
1491.1Snonaka
1501.1Snonaka
1511.1Snonaka# SCSI Controllers and Devices
1521.1Snonaka
1531.1Snonaka# PCI SCSI controllers
1541.27Snonaka#adw*	at pci? dev ? function ?	# AdvanSys 9x0UW[D], 3940U[2,3]W SCSI
1551.27Snonaka#ahc*	at pci? dev ? function ?	# Adaptec [23]94x, aic78x0 SCSI
1561.27Snonaka#esiop*	at pci? dev ? function ?	# Symbios 53c825/875 and newer chips
1571.27Snonaka#iha*	at pci? dev ? function ?	# Initio INIC-940/950 SCSI
1581.27Snonaka#pcscp*	at pci? dev ? function ?	# AMD 53c974 PCscsi-PCI SCSI
1591.3Snonakasiop*	at pci? dev ? function ?	# Symbios 53c8xx SCSI
1601.1Snonaka
1611.1Snonaka# PCMCIA SCSI controllers
1621.27Snonaka#aic*	at pcmcia? function ?		# Adaptec APA-1460 SCSI
1631.1Snonaka
1641.1Snonaka# SCSI bus support
1651.27Snonaka#scsibus* at adw?
1661.27Snonaka#scsibus* at ahc?
1671.27Snonaka#scsibus* at aic?
1681.27Snonaka#scsibus* at esiop?
1691.27Snonaka#scsibus* at iha?
1701.27Snonaka#scsibus* at pcscp?
1711.3Snonakascsibus* at siop?
1721.1Snonaka
1731.1Snonaka# SCSI devices
1741.1Snonakasd*	at scsibus? target ? lun ?	# SCSI disk drives
1751.1Snonakast*	at scsibus? target ? lun ?	# SCSI tape drives
1761.1Snonakacd*	at scsibus? target ? lun ?	# SCSI CD-ROM drives
1771.1Snonaka
1781.1Snonaka
1791.1Snonaka# IDE and related devices
1801.19Snonaka
1811.19Snonaka# IBM Personal Power Series 830 IDE controller
1821.19Snonakawdc0	at obio? port 0x1f0 irq 13
1831.19Snonakawdc1	at obio? port 0x170 irq 13
1841.19Snonaka
1851.19Snonaka# ISA Plug-and-Play IDE controllers
1861.27Snonaka#wdc*	at isapnp?
1871.1Snonaka
1881.1Snonaka# PCMCIA IDE controllers
1891.27Snonaka#wdc*	at pcmcia? function ?
1901.1Snonaka
1911.25Slukem# ATA (IDE) bus support
1921.25Slukematabus* at ata?
1931.24Sbouyer
1941.1Snonaka# IDE drives
1951.1Snonaka# Flags are used only with controllers that support DMA operations
1961.1Snonaka# and mode settings (e.g. some pciide controllers)
1971.1Snonaka# The lowest order four bits (rightmost digit) of the flags define the PIO
1981.1Snonaka# mode to use, the next set of four bits the DMA mode and the third set the
1991.1Snonaka# UltraDMA mode. For each set of four bits, the 3 lower bits define the mode
2001.1Snonaka# to use, and the last bit must be 1 for this setting to be used.
2011.1Snonaka# For DMA and UDMA, 0xf (1111) means 'disable'.
2021.1Snonaka# 0x0fac means 'use PIO mode 4, DMA mode 2, disable UltraDMA'.
2031.1Snonaka# (0xc=1100, 0xa=1010, 0xf=1111)
2041.1Snonaka# 0x0000 means "use whatever the drive claims to support".
2051.24Sbouyerwd*	at atabus? drive ? flags 0x0000
2061.1Snonaka
2071.1Snonaka# ATAPI bus support
2081.25Slukematapibus* at atapi?
2091.1Snonaka
2101.1Snonaka# ATAPI devices
2111.1Snonaka# flags have the same meaning as for IDE drives.
2121.1Snonakacd*	at atapibus? drive ? flags 0x0000	# ATAPI CD-ROM drives
2131.1Snonakasd*	at atapibus? drive ? flags 0x0000	# ATAPI disk drives
2141.1Snonaka
2151.1Snonaka# Miscellaneous mass storage devices
2161.1Snonaka
2171.1Snonaka# ISA floppy
2181.27Snonaka#fdc0	at isa? port 0x3f0 irq 6 drq 2	# standard PC floppy controllers
2191.27Snonaka#fd*	at fdc? drive ?
2201.1Snonaka
2211.1Snonaka# Network Interfaces
2221.1Snonaka
2231.1Snonaka# PCI network interfaces
2241.27Snonaka#ep*	at pci? dev ? function ?	# 3Com 3c59x
2251.27Snonaka#ex*	at pci? dev ? function ?	# 3Com 3c90x[BC]
2261.27Snonaka#fxp*	at pci? dev ? function ?	# Intel EtherExpress PRO 10+/100B
2271.27Snonaka#ne*	at pci? dev ? function ?	# NE2000-compatible Ethernet
2281.7Stsutsuipcn*	at pci? dev ? function ?	# AMD PCnet-PCI Ethernet
2291.27Snonaka#rtk*	at pci? dev ? function ?	# Realtek 8129/8139
2301.27Snonaka#sip*	at pci? dev ? function ?	# SiS 900/DP83815 Ethernet
2311.15Smycrofttlp*	at pci? dev ? function ?	# DECchip 21x4x and clones
2321.27Snonaka#vr*	at pci? dev ? function ?	# VIA Rhine Fast Ethernet
2331.1Snonaka
2341.5Snonaka# ISA network interfaces
2351.27Snonaka#ep*	at isa? port ? irq ?		# 3Com 3c509 Ethernet
2361.5Snonaka
2371.1Snonaka# ISA Plug-and-Play network intefaces
2381.27Snonaka#ep*	at isapnp?			# 3Com 3c509 Ethernet
2391.27Snonaka#ne*	at isapnp?			# NE2000-compatible Ethernet
2401.1Snonaka
2411.1Snonaka# PCMCIA network interfaces
2421.27Snonaka#ep*	at pcmcia? function ?		# 3Com 3c589 and 3c562 Ethernet
2431.27Snonaka#ne*	at pcmcia? function ?		# NE2000-compatible Ethernet
2441.1Snonaka
2451.1Snonaka# MII/PHY support
2461.27Snonaka#exphy*	at mii? phy ?			# 3Com internal PHYs
2471.27Snonaka#inphy*	at mii? phy ?			# Intel 82555 PHYs
2481.5Snonakansphy*	at mii? phy ?			# NS83840 PHYs
2491.27Snonaka#qsphy*	at mii? phy ?			# Quality Semiconductor QS6612 PHYs
2501.27Snonaka#sqphy*	at mii? phy ?			# Seeq 80220/80221/80223 PHYs
2511.1Snonakaukphy*	at mii? phy ?			# generic unknown PHYs
2521.1Snonaka
2531.1Snonaka
2541.1Snonaka# Pseudo-Devices
2551.1Snonaka
2561.1Snonaka# disk/mass storage pseudo-devices
2571.1Snonakapseudo-device	md		1	# memory disk device (ramdisk)
2581.30Shannken#pseudo-device	fss		4	# file system snapshot device
2591.1Snonaka
2601.1Snonaka# network pseudo-devices
2611.1Snonakapseudo-device	loop			# network loopback
2621.1Snonaka
2631.1Snonaka# miscellaneous pseudo-devices
2641.1Snonakapseudo-device	pty			# pseudo-terminals
2651.1Snonakapseudo-device	rnd			# /dev/random and in-kernel generator
2661.8Slukem#options 	RND_COM			# use "com" randomness as well
267