INSTALL revision 1.8
11.8Stron# $NetBSD: INSTALL,v 1.8 2005/07/07 17:05:47 tron Exp $
21.1Scdi#
31.1Scdi# INSTALL -- installation and rescue kernel.
41.1Scdi#
51.1Scdi# This kernel should be derived from GENERIC with most features
61.1Scdi# commented out to shoehorn into Cobalt kernel size limitations.
71.1Scdi# 
81.1Scdi
91.1Scdiinclude 	"arch/cobalt/conf/std.cobalt"
101.1Scdi
111.1Scdioptions 	INCLUDE_CONFIG_FILE	# embed config file in kernel binary
121.1Scdi
131.8Stron#ident 		"GENERIC-$Revision: 1.8 $"
141.1Scdi
151.1Scdimakeoptions     COPTS="-Os"
161.1Scdi
171.1Scdimaxusers	32
181.1Scdi
191.1Scdi# Standard system options
201.1Scdioptions 	KTRACE		# system call tracing support
211.1Scdioptions 	SYSTRACE	# system call vetting via systrace(1)
221.1Scdioptions 	SYSVMSG		# System V message queues
231.1Scdioptions 	SYSVSEM		# System V semaphores
241.1Scdi#options 	SEMMNI=10	# number of semaphore identifiers
251.1Scdi#options 	SEMMNS=60	# number of semaphores in system
261.1Scdi#options 	SEMUME=10	# max number of undo entries per process
271.1Scdi#options 	SEMMNU=30	# number of undo structures in system
281.1Scdioptions 	SYSVSHM		# System V shared memory
291.1Scdi#options 	SHMMAXPGS=1024	# 1024 pages is the default
301.1Scdioptions 	P1003_1B_SEMAPHORE # p1003.1b semaphore support
311.1Scdi#options 	LKM		# loadable kernel modules
321.1Scdi#options 	NTP		# network time protocol
331.1Scdioptions 	USERCONF	# userconf(4) support
341.1Scdi#options	PIPE_SOCKETPAIR	# smaller, but slower pipe(2)
351.1Scdi#options 	SYSCTL_INCLUDE_DESCR	# Include sysctl descriptions in kernel
361.1Scdi
371.1Scdi# Enable experimental buffer queue strategy for better responsiveness under 
381.1Scdi# high disk I/O load. Use it with caution - it's not proven to be stable yet.
391.7Stsutsui#options 	BUFQ_READPRIO
401.7Stsutsui#options 	BUFQ_PRIOCSCAN
411.1Scdi
421.1Scdi# Debugging options
431.1Scdi#options 	DIAGNOSTIC	# extra kernel sanity checking
441.1Scdi#options 	DEBUG		# extra kernel debugging support
451.1Scdi#options 	KMEMSTATS	# kernel memory statistics (vmstat -m)
461.1Scdioptions 	DDB		# kernel dynamic debugger
471.1Scdi#options 	DDB_HISTORY_SIZE=100 # enable history editing in DDB
481.1Scdi#makeoptions	DEBUG="-g"	# compile full symbol table
491.1Scdi
501.1Scdi# Compatibility options
511.1Scdioptions 	COMPAT_43	# compatibility with 4.3BSD binaries
521.1Scdi#options 	COMPAT_09	# NetBSD 0.9 binary compatibility
531.1Scdi#options 	COMPAT_10	# NetBSD 1.0 binary compatibility
541.1Scdi#options 	COMPAT_11	# NetBSD 1.1 binary compatibility
551.1Scdi#options 	COMPAT_12	# NetBSD 1.2 binary compatibility
561.1Scdi#options 	COMPAT_13	# NetBSD 1.3 binary compatibility
571.1Scdi#options 	COMPAT_14	# NetBSD 1.4 binary compatibility
581.1Scdioptions 	COMPAT_16	# NetBSD 1.6 binary compatibility
591.4Ssimonboptions 	COMPAT_20	# NetBSD 2.0 binary compatibility
601.1Scdi#options 	EXEC_ECOFF	# exec ECOFF binaries
611.1Scdi#options 	COMPAT_ULTRIX	# binary compatibility with Ultrix
621.1Scdi#options 	TCP_COMPAT_42	# 4.2BSD TCP/IP bug compat. Not recommended.
631.1Scdioptions		COMPAT_BSDPTY	# /dev/[pt]ty?? ptys.
641.1Scdi
651.1Scdi# File systems
661.1Scdifile-system	FFS		# Berkeley Fast Filesystem
671.1Scdifile-system 	EXT2FS		# second extended file system (linux)
681.1Scdifile-system	NFS		# Sun NFS-compatible filesystem client
691.1Scdi#file-system	KERNFS		# kernel data-structure filesystem
701.1Scdi#file-system	NULLFS		# NULL layered filesystem
711.1Scdi#file-system 	OVERLAY		# overlay file system
721.1Scdifile-system	MFS		# memory-based filesystem
731.1Scdifile-system	FDESC		# user file descriptor filesystem
741.1Scdi#file-system	UMAPFS		# uid/gid remapping filesystem
751.1Scdi#file-system	LFS		# Log-based filesystem (still experimental)
761.1Scdi#file-system	PORTAL		# portal filesystem (still experimental)
771.1Scdi#file-system	PROCFS		# /proc
781.1Scdi#file-system	CD9660		# ISO 9660 + Rock Ridge file system
791.1Scdi#file-system	UNION		# union file system
801.1Scdi#file-system	MSDOSFS		# MS-DOS FAT filesystem(s).
811.1Scdi#file-system 	CODA		# Coda File System; also needs vcoda (below)
821.1Scdi
831.1Scdi# File system options
841.1Scdi#options 	NFSSERVER	# Sun NFS-compatible filesystem server
851.1Scdi#options 	QUOTA		# FFS quotas
861.1Scdi#options 	FFS_EI		# FFS Endian Independant support
871.1Scdi#options 	SOFTDEP		# FFS soft updates support.
881.3Sdsloptions 	FFS_NO_SNAPSHOT	# ffs snapshots
891.1Scdi#options 	EXT2FS_SYSTEM_FLAGS # makes ext2fs file flags (append and
901.1Scdi				# immutable) behave as system flags.
911.1Scdi
921.1Scdi# Networking options
931.1Scdi#options 	GATEWAY		# IP packet forwarding
941.1Scdioptions 	INET		# Internet protocols
951.1Scdi#options 	INET6		# IPV6
961.1Scdi#options 	IPSEC		# IP security
971.1Scdi#options 	IPSEC_ESP	# IP security (encryption part; define w/IPSEC)
981.8Stron#options 	IPSEC_NAT_T	# IPsec NAT traversal (NAT-T)
991.1Scdi#options 	IPSEC_DEBUG	# debug for IP security
1001.1Scdi#options 	MROUTING	# packet forwarding of multicast packets
1011.1Scdi#options 	PIM		# Protocol Independent Multicast
1021.1Scdi#options 	NS		# Xerox NS networking
1031.1Scdi#options 	NSIP		# Xerox NS tunneling over IP
1041.1Scdi#options 	ISO,TPIP	# OSI networking
1051.1Scdi#options 	EON		# OSI tunneling over IP
1061.1Scdi#options 	CCITT,LLC,HDLC	# X.25
1071.1Scdi#options 	NETATALK	# AppleTalk (over Ethernet) protocol
1081.1Scdi#options 	PPP_BSDCOMP	# BSD-Compress compression support for PPP
1091.1Scdi#options 	PPP_DEFLATE	# Deflate compression support for PPP
1101.1Scdi#options 	PPP_FILTER	# Active filter support for PPP (requires bpf)
1111.1Scdi#options 	PFIL_HOOKS	# pfil(9) packet filter hooks
1121.1Scdi#options 	IPFILTER_LOG	# ipmon(8) log support
1131.1Scdi#options 	IPFILTER_DEFAULT_BLOCK	# block all packets by default
1141.1Scdi#options 	TCP_DEBUG	# Record last TCP_NDEBUG packets with SO_DEBUG
1151.1Scdi
1161.1Scdi#options 	ALTQ		# Manipulate network interfaces' output queues
1171.1Scdi#options 	ALTQ_BLUE	# Stochastic Fair Blue
1181.1Scdi#options 	ALTQ_CBQ	# Class-Based Queueing
1191.1Scdi#options 	ALTQ_CDNR	# Diffserv Traffic Conditioner
1201.1Scdi#options 	ALTQ_FIFOQ	# First-In First-Out Queue
1211.1Scdi#options 	ALTQ_FLOWVALVE	# RED/flow-valve (red-penalty-box)
1221.1Scdi#options 	ALTQ_HFSC	# Hierarchical Fair Service Curve
1231.1Scdi#options 	ALTQ_LOCALQ	# Local queueing discipline
1241.1Scdi#options 	ALTQ_PRIQ	# Priority Queueing
1251.1Scdi#options 	ALTQ_RED	# Random Early Detection
1261.1Scdi#options 	ALTQ_RIO	# RED with IN/OUT
1271.1Scdi#options 	ALTQ_WFQ	# Weighted Fair Queueing
1281.1Scdi
1291.1Scdi# These options enable verbose messages for several subsystems.
1301.1Scdi# Warning, these may compile large string tables into the kernel!
1311.1Scdi#options 	PCIVERBOSE	# verbose PCI device autoconfig messages
1321.1Scdi#options 	PCI_CONFIG_DUMP	# verbosely dump PCI config space
1331.1Scdi#options 	SCSIVERBOSE	# human readable SCSI error messages
1341.1Scdi#options 	MIIVERBOSE	# verbose PHY autoconfig messages
1351.1Scdi
1361.1Scdioptions 	NFS_BOOT_DHCP
1371.1Scdi
1381.1Scdiconfig		netbsd	root on ? type nfs
1391.1Scdi
1401.1Scdimainbus0 	at root
1411.1Scdi
1421.1Scdicpu0 		at mainbus?
1431.1Scdi
1441.1Scdicom0		at mainbus? addr 0x1c800000 level 3
1451.1Scdioptions 	COM_16650
1461.1Scdi
1471.1Scdipanel0 		at mainbus? addr 0x1f000000
1481.1Scdi
1491.1Scdigt0 		at mainbus? addr 0x14000000
1501.1Scdi
1511.1Scdipci* 		at gt0
1521.1Scdipchb* 		at pci? dev ? function ?
1531.1Scdipcib* 		at pci? dev ? function ?
1541.1Scdi
1551.5Stsutsuioptions 	PCI_NETBSD_CONFIGURE
1561.5Stsutsui
1571.1Scdi# Cryptographic Devices
1581.1Scdi
1591.1Scdi# PCI cryptographic devices
1601.1Scdi#hifn*	at pci? dev ? function ?	# Hifn 7755/7811/795x
1611.1Scdi#ubsec*	at pci? dev ? function ?	# Broadcom 5501/5601/580x/582x
1621.1Scdi
1631.1Scdi# PCI serial/parallel interfaces
1641.1Scdi#puc* 		at pci? dev ? function ? 	# PCI "universal" comm. cards
1651.1Scdi#com* 		at puc? port ?
1661.1Scdi#lpt* 		at puc? port ?
1671.1Scdi#cy* 		at pci? dev ? function ?	# Cyclades Cyclom-Y serial cards
1681.1Scdi
1691.1Scdi# PCI SCSI controllers
1701.1Scdi#adv*		at pci? dev ? function ?	# AdvanSys 1200[A,B], 9xx[U,UA]
1711.1Scdi#adw*		at pci? dev ? function ?	# AdvanSys 9xxUW SCSI
1721.1Scdi#ahc*		at pci? dev ? function ?	# Adaptec [23]94x, aic78x0 SCSI
1731.1Scdi#bha*		at pci? dev ? function ?	# BusLogic 9xx SCSI
1741.1Scdi#dpt*		at pci? dev ? function ?	# DPT SmartCache/SmartRAID
1751.1Scdi#isp*		at pci? dev ? function ?	# Qlogic ISP [12]0x0 SCSI/FC
1761.1Scdi#siop*		at pci? dev ? function ?	# NCR 53c8xx SCSI
1771.1Scdi#esiop*		at pci? dev ? function ?	# NCR 53c82s75xx SCSI and newer
1781.1Scdi#pcscp*		at pci? dev ? function ?	# AMD 53c974 PCscsi-PCI SCSI
1791.1Scdi
1801.1Scdi# SCSI bus support
1811.1Scdi#scsibus* 	at adv?
1821.1Scdi#scsibus* 	at adw?
1831.1Scdi#scsibus* 	at ahc?
1841.1Scdi#scsibus* 	at bha?
1851.1Scdi#scsibus* 	at dpt?
1861.1Scdi#scsibus* 	at isp?
1871.1Scdi#scsibus* 	at siop?
1881.1Scdi#scsibus* 	at esiop?
1891.1Scdi#scsibus* 	at pcscp?
1901.1Scdi
1911.1Scdi# SCSI devices
1921.1Scdi#sd*		at scsibus? target ? lun ?	# SCSI disk drives
1931.1Scdi#st*		at scsibus? target ? lun ?	# SCSI tape drives
1941.1Scdi#cd*		at scsibus? target ? lun ?	# SCSI CD-ROM drives
1951.1Scdi#ch*		at scsibus? target ? lun ?	# SCSI autochangers
1961.1Scdi#ss*		at scsibus? target ? lun ?	# SCSI scanners
1971.1Scdi#uk*		at scsibus? target ? lun ?	# SCSI unknown
1981.1Scdi
1991.1Scdi# RAID controllers and devices
2001.1Scdi#cac*		at pci? dev ? function ?	# Compaq array controller
2011.1Scdi#ca*		at cac? unit ?			# Compaq array disk device
2021.1Scdi
2031.1Scdi# IDE and related devices
2041.1Scdi# PCI IDE controllers - see pciide(4) for supported hardware.
2051.1Scdi# The 0x0001 flag force the driver to use DMA, even if the driver doesn't know
2061.1Scdi# how to set up DMA modes for this chip. This may work, or may cause
2071.1Scdi# a machine hang with some controllers.
2081.1Scdipciide* 	at pci? dev ? function ? flags 0x0000	# GENERIC pciide driver
2091.1Scdiacardide*	at pci? dev ? function ?	# Acard IDE controllers
2101.1Scdiaceride* 	at pci? dev ? function ?	# Acer Lab IDE controllers
2111.1Scdiartsata*	at pci? dev ? function ?	# Intel i31244 SATA controller
2121.1Scdicmdide* 	at pci? dev ? function ?	# CMD tech IDE controllers
2131.1Scdicypide* 	at pci? dev ? function ?	# Cypress IDE controllers
2141.1Scdihptide* 	at pci? dev ? function ?	# Triones/HighPoint IDE controllers
2151.1Scdioptiide* 	at pci? dev ? function ?	# Opti IDE controllers
2161.1Scdipdcide* 	at pci? dev ? function ?	# Promise IDE controllers
2171.1Scdipdcsata* 	at pci? dev ? function ?	# Promise SATA150 controllers
2181.1Scdisatalink*	at pci? dev ? function ?	# SiI SATALink controllers
2191.1Scdisiside* 	at pci? dev ? function ?	# SiS IDE controllers
2201.1Scdislide*  	at pci? dev ? function ?	# Symphony Labs IDE controllers
2211.1Scdiviaide* 	at pci? dev ? function ?	# VIA/AMD/Nvidia IDE controllers
2221.1Scdi
2231.1Scdi# ATA bus
2241.1Scdiatabus* 	at ata?
2251.1Scdi
2261.1Scdi# IDE drives
2271.1Scdi# Flags are used only with controllers that support DMA operations
2281.1Scdi# and mode settings (e.g. some pciide controllers)
2291.1Scdi# The lowest order four bits (rightmost digit) of the flags define the PIO
2301.1Scdi# mode to use, the next set of four bits the DMA mode and the third set the
2311.1Scdi# UltraDMA mode. For each set of four bits, the 3 lower bits define the mode
2321.1Scdi# to use, and the last bit must be 1 for this setting to be used.
2331.1Scdi# For DMA and UDMA, 0xf (1111) means 'disable'.
2341.1Scdi# 0x0fac means 'use PIO mode 4, DMA mode 2, disable UltraDMA'.
2351.1Scdi# (0xc=1100, 0xa=1010, 0xf=1111)
2361.1Scdi# 0x0000 means "use whatever the drive claims to support".
2371.1Scdiwd* 		at atabus? drive ? flags 0x0000
2381.1Scdi
2391.1Scdi# PCI network interfaces
2401.1Scdi#en*		at pci? dev ? function ?	# ENI/Adaptec ATM
2411.1Scdi#ep*		at pci? dev ? function ?	# 3Com 3c59x
2421.1Scdi#ex*		at pci? dev ? function ?	# 3Com 90x[BC]
2431.1Scdi#epic*		at pci? dev ? function ?	# SMC EPIC/100 Ethernet
2441.1Scdi#esh*		at pci? dev ? function ?	# Essential HIPPI card
2451.1Scdi#fpa*		at pci? dev ? function ?	# DEC DEFPA FDDI
2461.1Scdi#fxp*		at pci? dev ? function ?	# Intel EtherExpress PRO10+/100B
2471.1Scdi#le*		at pci? dev ? function ?	# PCnet-PCI Ethernet
2481.1Scdi#ne*		at pci? dev ? function ?	# NE2000-compatible Ethernet
2491.1Scdi#ntwoc*		at pci? dev ? function ?	# Riscom/N2 PCI Sync Serial
2501.1Scdi#sip*		at pci? dev ? function ?	# SiS 900 Ethernet
2511.1Scdi#tl*		at pci? dev ? function ?	# ThunderLAN-based Ethernet
2521.1Scditlp*		at pci? dev ? function ?	# DECchip 21x4x and clones
2531.1Scdi#vr*		at pci? dev ? function ?	# VIA Rhine Fast Ethernet
2541.1Scdi#lmc*		at pci? dev ? function ?	# Lan Media Corp SSI/HSSI/DS3
2551.1Scdi#rtk*		at pci? dev ? function ?	# Realtek 8129/8139
2561.1Scdi
2571.1Scdi# MII/PHY support
2581.1Scdi#exphy*		at mii? phy ?			# 3Com internal PHYs
2591.1Scdi#icsphy*		at mii? phy ?			# ICS189x PHYs
2601.1Scdi#inphy*		at mii? phy ?			# Intel 82555 PHYs
2611.1Scdi#iophy*		at mii? phy ?			# Intel 82553 PHYs
2621.1Scdilxtphy*		at mii? phy ?			# Level One LXT-970 PHYs
2631.1Scdi#nsphy*		at mii? phy ?			# NS83840 PHYs
2641.1Scdi#nsphyter* 	at mii? phy ?			# NS83843 PHYs
2651.1Scdi#qsphy*		at mii? phy ?			# Quality Semiconductor QS6612
2661.1Scdi#sqphy*		at mii? phy ?			# Seeq 80220/80221/80223 PHYs
2671.1Scdi#tlphy*		at mii? phy ?			# ThunderLAN PHYs
2681.1Scdi#tqphy*		at mii? phy ?			# TDK Semiconductor PHYs
2691.1Scdi#ukphy*		at mii? phy ?			# generic unknown PHYs
2701.1Scdi
2711.1Scdi# PCI audio devices
2721.1Scdi#clcs*		at pci? dev ? function ?	# Cirrus Logic CS4280
2731.1Scdi#eap*		at pci? dev ? function ?	# Ensoniq AudioPCI
2741.1Scdi#eso*		at pci? dev ? function ?	# ESS Solo-1 PCI AudioDrive
2751.1Scdi#fms*		at pci? dev ? function ?	# Forte Media FM801
2761.1Scdi#sbl*		at pci? dev ? function ?	# SoundBlaster Live!
2771.1Scdi#sv*		at pci? dev ? function ?	# S3 SonicVibes
2781.1Scdi
2791.1Scdi# Pseudo-devices
2801.1Scdi
2811.1Scdi#pseudo-device 	crypto				# opencrypto framework
2821.1Scdi
2831.1Scdi# Disk/mass storage pseudo-devices
2841.1Scdi#pseudo-device	ccd		4		# concatenated disk devices
2851.1Scdi#pseudo-device	cgd		4		# cryptographic disk devices
2861.1Scdi#pseudo-device	raid		8		# RAIDframe disk driver
2871.1Scdi#options 	RAID_AUTOCONFIG			# auto-configuration of RAID
2881.1Scdi# Options to enable various other RAIDframe RAID types.
2891.1Scdi# options	RF_INCLUDE_EVENODD=1
2901.1Scdi# options	RF_INCLUDE_RAID5_RS=1
2911.1Scdi# options	RF_INCLUDE_PARITYLOGGING=1
2921.1Scdi# options	RF_INCLUDE_CHAINDECLUSTER=1
2931.1Scdi# options	RF_INCLUDE_INTERDECLUSTER=1
2941.1Scdi# options 	RF_INCLUDE_PARITY_DECLUSTERING=1
2951.1Scdi# options	RF_INCLUDE_PARITY_DECLUSTERING_DS=1
2961.1Scdi#pseudo-device	md		1		# memory disk device (ramdisk)
2971.1Scdi#pseudo-device	vnd		4		# disk-like interface to files
2981.1Scdi
2991.1Scdi# Network pseudo-devices
3001.1Scdi#pseudo-device	bpfilter	8		# Berkeley packet filter
3011.1Scdi#pseudo-device	ipfilter			# IP filter (firewall) and NAT
3021.1Scdipseudo-device	loop				# network loopback
3031.1Scdi#pseudo-device	ppp		2		# Point-to-Point Protocol
3041.1Scdi#pseudo-device	pppoe				# PPP over Ethernet (RFC 2516)
3051.1Scdi#pseudo-device	sl		2		# Serial Line IP
3061.1Scdi#pseudo-device	strip		2		# Starmode Radio IP (Metricom)
3071.1Scdi#pseudo-device	tun		2		# network tunneling over tty
3081.1Scdi#pseudo-device	tap				# virtual Ethernet
3091.1Scdi#pseudo-device	gre		2		# generic L3 over IP tunnel
3101.1Scdi#pseudo-device	gif		4		# RFC1933 tunnel
3111.1Scdi#pseudo-device	faith		1		# IPv[46] tcp relay translation
3121.1Scdi#pseudo-device	stf		1		# 6to4 IPv6 over IPv4 encapsulation
3131.1Scdi#pseudo-device	vlan			# IEEE 802.1q encapsulation
3141.1Scdi#pseudo-device	bridge			# simple inter-network bridging
3151.1Scdi#options	BRIDGE_IPF		# bridge uses IP/IPv6 pfil hooks too
3161.1Scdi
3171.1Scdi# Miscellaneous pseudo-devices
3181.1Scdipseudo-device	pty				# pseudo-terminals
3191.1Scdi#pseudo-device	tb		1		# tablet line discipline
3201.1Scdi#pseudo-device	sequencer	1		# MIDI sequencer
3211.1Scdipseudo-device	rnd				# /dev/random & kernel generator
3221.1Scdi#options 	RND_COM				# use "com" randomness (BROKEN)
3231.1Scdipseudo-device	clockctl		# user control of clock subsystem
3241.1Scdipseudo-device	nullcons			# no-op console
3251.1Scdi
3261.1Scdi# A pseudo device needed for Coda		# also needs CODA (above)
3271.1Scdi#pseudo-device	vcoda		4		# coda minicache <-> venus comm.
3281.1Scdi#pseudo-device	ksyms				# /dev/ksyms
3291.1Scdi#pseudo-device	pf			# PF packet filter
3301.1Scdi#pseudo-device	pflog			# PF log if
331