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