INSTALL revision 1.52
11.52Schristos# $NetBSD: INSTALL,v 1.52 2013/04/27 21:43:19 christos 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.44Stsutsui#
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.52Schristos#ident 		"INSTALL-$Revision: 1.52 $"
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.36Stsutsui#options 	KTRACE		# system call tracing support
221.36Stsutsui#options 	SYSVMSG		# System V message queues
231.36Stsutsui#options 	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.36Stsutsui#options 	SYSVSHM		# System V shared memory
291.1Scdi#options 	NTP		# network time protocol
301.36Stsutsui#options 	USERCONF	# userconf(4) support
311.36Stsutsuioptions 	PIPE_SOCKETPAIR	# smaller, but slower pipe(2)
321.1Scdi#options 	SYSCTL_INCLUDE_DESCR	# Include sysctl descriptions in kernel
331.1Scdi
341.44Stsutsui# Enable experimental buffer queue strategy for better responsiveness under
351.1Scdi# high disk I/O load. Use it with caution - it's not proven to be stable yet.
361.7Stsutsui#options 	BUFQ_READPRIO
371.7Stsutsui#options 	BUFQ_PRIOCSCAN
381.1Scdi
391.1Scdi# Debugging options
401.1Scdi#options 	DIAGNOSTIC	# extra kernel sanity checking
411.1Scdi#options 	DEBUG		# extra kernel debugging support
421.1Scdi#options 	KMEMSTATS	# kernel memory statistics (vmstat -m)
431.1Scdioptions 	DDB		# kernel dynamic debugger
441.1Scdi#options 	DDB_HISTORY_SIZE=100 # enable history editing in DDB
451.1Scdi#makeoptions	DEBUG="-g"	# compile full symbol table
461.1Scdi
471.1Scdi# Compatibility options
481.1Scdioptions 	COMPAT_43	# compatibility with 4.3BSD binaries
491.1Scdi#options 	COMPAT_09	# NetBSD 0.9 binary compatibility
501.1Scdi#options 	COMPAT_10	# NetBSD 1.0 binary compatibility
511.1Scdi#options 	COMPAT_11	# NetBSD 1.1 binary compatibility
521.1Scdi#options 	COMPAT_12	# NetBSD 1.2 binary compatibility
531.1Scdi#options 	COMPAT_13	# NetBSD 1.3 binary compatibility
541.1Scdi#options 	COMPAT_14	# NetBSD 1.4 binary compatibility
551.26Smanu#options 	COMPAT_15	# NetBSD 1.5 binary compatibility
561.1Scdioptions 	COMPAT_16	# NetBSD 1.6 binary compatibility
571.4Ssimonboptions 	COMPAT_20	# NetBSD 2.0 binary compatibility
581.9Schristosoptions 	COMPAT_30	# NetBSD 3.0 compatibility.
591.29Stsutsuioptions 	COMPAT_40	# NetBSD 4.0 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.36Stsutsui#file-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	PROCFS		# /proc
771.1Scdi#file-system	CD9660		# ISO 9660 + Rock Ridge file system
781.1Scdi#file-system	UNION		# union file system
791.1Scdi#file-system	MSDOSFS		# MS-DOS FAT filesystem(s).
801.1Scdi#file-system 	CODA		# Coda File System; also needs vcoda (below)
811.10Schristos#file-system	PTYFS		# /dev/pts/N support
821.1Scdi
831.1Scdi# File system options
841.1Scdi#options 	NFSSERVER	# Sun NFS-compatible filesystem server
851.43Sbouyer#options 	QUOTA		# legacy UFS quotas
861.43Sbouyer#options 	QUOTA2		# new, in-filesystem UFS quotas
871.45Swiz#options 	FFS_EI		# FFS Endian Independent support
881.47Sdhollandoptions 	WAPBL		# File system journaling support
891.15Stsutsuioptions 	FFS_NO_SNAPSHOT	# No FFS snapshot support
901.1Scdi#options 	EXT2FS_SYSTEM_FLAGS # makes ext2fs file flags (append and
911.1Scdi				# immutable) behave as system flags.
921.1Scdi
931.1Scdi# Networking options
941.1Scdi#options 	GATEWAY		# IP packet forwarding
951.1Scdioptions 	INET		# Internet protocols
961.1Scdi#options 	INET6		# IPV6
971.1Scdi#options 	IPSEC		# IP security
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 	NETATALK	# AppleTalk (over Ethernet) protocol
1031.1Scdi#options 	PPP_BSDCOMP	# BSD-Compress compression support for PPP
1041.1Scdi#options 	PPP_DEFLATE	# Deflate compression support for PPP
1051.1Scdi#options 	PPP_FILTER	# Active filter support for PPP (requires bpf)
1061.1Scdi#options 	PFIL_HOOKS	# pfil(9) packet filter hooks
1071.1Scdi#options 	IPFILTER_LOG	# ipmon(8) log support
1081.36Stsutsui#options 	IPFILTER_LOOKUP	# ippool(8) support
1091.1Scdi#options 	IPFILTER_DEFAULT_BLOCK	# block all packets by default
1101.1Scdi#options 	TCP_DEBUG	# Record last TCP_NDEBUG packets with SO_DEBUG
1111.1Scdi
1121.1Scdi#options 	ALTQ		# Manipulate network interfaces' output queues
1131.1Scdi#options 	ALTQ_BLUE	# Stochastic Fair Blue
1141.1Scdi#options 	ALTQ_CBQ	# Class-Based Queueing
1151.1Scdi#options 	ALTQ_CDNR	# Diffserv Traffic Conditioner
1161.1Scdi#options 	ALTQ_FIFOQ	# First-In First-Out Queue
1171.1Scdi#options 	ALTQ_FLOWVALVE	# RED/flow-valve (red-penalty-box)
1181.1Scdi#options 	ALTQ_HFSC	# Hierarchical Fair Service Curve
1191.1Scdi#options 	ALTQ_LOCALQ	# Local queueing discipline
1201.1Scdi#options 	ALTQ_PRIQ	# Priority Queueing
1211.1Scdi#options 	ALTQ_RED	# Random Early Detection
1221.1Scdi#options 	ALTQ_RIO	# RED with IN/OUT
1231.1Scdi#options 	ALTQ_WFQ	# Weighted Fair Queueing
1241.1Scdi
1251.1Scdi# These options enable verbose messages for several subsystems.
1261.1Scdi# Warning, these may compile large string tables into the kernel!
1271.1Scdi#options 	PCIVERBOSE	# verbose PCI device autoconfig messages
1281.1Scdi#options 	PCI_CONFIG_DUMP	# verbosely dump PCI config space
1291.1Scdi#options 	SCSIVERBOSE	# human readable SCSI error messages
1301.1Scdi#options 	MIIVERBOSE	# verbose PHY autoconfig messages
1311.1Scdi
1321.1Scdioptions 	NFS_BOOT_DHCP
1331.1Scdi
1341.35Stsutsuiconfig		netbsd	root on ? type ?
1351.1Scdi
1361.1Scdimainbus0 	at root
1371.1Scdi
1381.1Scdicpu0 		at mainbus?
1391.1Scdi
1401.19Stsutsuimcclock0	at mainbus? addr 0x10000070
1411.19Stsutsui
1421.1Scdicom0		at mainbus? addr 0x1c800000 level 3
1431.1Scdioptions 	COM_16650
1441.1Scdi
1451.33Stsutsuizsc0		at mainbus? addr 0x1c800000 irq 4
1461.33Stsutsuizstty0		at zsc0 channel 0
1471.36Stsutsui#zstty1		at zsc0 channel 1
1481.33Stsutsui
1491.1Scdipanel0 		at mainbus? addr 0x1f000000
1501.1Scdi
1511.1Scdigt0 		at mainbus? addr 0x14000000
1521.1Scdi
1531.1Scdipci* 		at gt0
1541.1Scdipchb* 		at pci? dev ? function ?
1551.1Scdipcib* 		at pci? dev ? function ?
1561.1Scdi
1571.5Stsutsuioptions 	PCI_NETBSD_CONFIGURE
1581.5Stsutsui
1591.1Scdi# Cryptographic Devices
1601.1Scdi
1611.1Scdi# PCI cryptographic devices
1621.1Scdi#hifn*	at pci? dev ? function ?	# Hifn 7755/7811/795x
1631.1Scdi#ubsec*	at pci? dev ? function ?	# Broadcom 5501/5601/580x/582x
1641.1Scdi
1651.1Scdi# PCI serial/parallel interfaces
1661.30Stsutsuipuc* 		at pci? dev ? function ? 	# PCI "universal" comm. cards
1671.30Stsutsuicom* 		at puc? port ?
1681.1Scdi#lpt* 		at puc? port ?
1691.1Scdi#cy* 		at pci? dev ? function ?	# Cyclades Cyclom-Y serial cards
1701.1Scdi
1711.1Scdi# PCI SCSI controllers
1721.1Scdi#adv*		at pci? dev ? function ?	# AdvanSys 1200[A,B], 9xx[U,UA]
1731.1Scdi#adw*		at pci? dev ? function ?	# AdvanSys 9xxUW SCSI
1741.1Scdi#ahc*		at pci? dev ? function ?	# Adaptec [23]94x, aic78x0 SCSI
1751.1Scdi#bha*		at pci? dev ? function ?	# BusLogic 9xx SCSI
1761.1Scdi#dpt*		at pci? dev ? function ?	# DPT SmartCache/SmartRAID
1771.1Scdi#isp*		at pci? dev ? function ?	# Qlogic ISP [12]0x0 SCSI/FC
1781.1Scdi#siop*		at pci? dev ? function ?	# NCR 53c8xx SCSI
1791.1Scdi#esiop*		at pci? dev ? function ?	# NCR 53c82s75xx SCSI and newer
1801.1Scdi#pcscp*		at pci? dev ? function ?	# AMD 53c974 PCscsi-PCI SCSI
1811.1Scdi
1821.1Scdi# SCSI bus support
1831.1Scdi#scsibus* 	at adv?
1841.1Scdi#scsibus* 	at adw?
1851.1Scdi#scsibus* 	at ahc?
1861.1Scdi#scsibus* 	at bha?
1871.1Scdi#scsibus* 	at dpt?
1881.1Scdi#scsibus* 	at isp?
1891.1Scdi#scsibus* 	at siop?
1901.1Scdi#scsibus* 	at esiop?
1911.1Scdi#scsibus* 	at pcscp?
1921.1Scdi
1931.1Scdi# SCSI devices
1941.1Scdi#sd*		at scsibus? target ? lun ?	# SCSI disk drives
1951.1Scdi#st*		at scsibus? target ? lun ?	# SCSI tape drives
1961.1Scdi#cd*		at scsibus? target ? lun ?	# SCSI CD-ROM drives
1971.1Scdi#ch*		at scsibus? target ? lun ?	# SCSI autochangers
1981.1Scdi#ss*		at scsibus? target ? lun ?	# SCSI scanners
1991.1Scdi#uk*		at scsibus? target ? lun ?	# SCSI unknown
2001.1Scdi
2011.1Scdi# RAID controllers and devices
2021.1Scdi#cac*		at pci? dev ? function ?	# Compaq array controller
2031.1Scdi#ca*		at cac? unit ?			# Compaq array disk device
2041.1Scdi
2051.1Scdi# IDE and related devices
2061.1Scdi# PCI IDE controllers - see pciide(4) for supported hardware.
2071.1Scdi# The 0x0001 flag force the driver to use DMA, even if the driver doesn't know
2081.1Scdi# how to set up DMA modes for this chip. This may work, or may cause
2091.1Scdi# a machine hang with some controllers.
2101.1Scdipciide* 	at pci? dev ? function ? flags 0x0000	# GENERIC pciide driver
2111.36Stsutsui#acardide*	at pci? dev ? function ?	# Acard IDE controllers
2121.31Stsutsui#aceride* 	at pci? dev ? function ?	# Acer Lab IDE controllers
2131.31Stsutsui#artsata*	at pci? dev ? function ?	# Intel i31244 SATA controller
2141.36Stsutsui#cmdide* 	at pci? dev ? function ?	# CMD tech IDE controllers
2151.31Stsutsui#cypide* 	at pci? dev ? function ?	# Cypress IDE controllers
2161.36Stsutsui#hptide* 	at pci? dev ? function ?	# Triones/HighPoint IDE controllers
2171.31Stsutsui#optiide* 	at pci? dev ? function ?	# Opti IDE controllers
2181.36Stsutsui#pdcide* 	at pci? dev ? function ?	# Promise IDE controllers
2191.36Stsutsui#pdcsata* 	at pci? dev ? function ?	# Promise SATA150 controllers
2201.36Stsutsui#satalink*	at pci? dev ? function ?	# SiI SATALink controllers
2211.31Stsutsui#siside* 	at pci? dev ? function ?	# SiS IDE controllers
2221.31Stsutsui#slide*  	at pci? dev ? function ?	# Symphony Labs IDE controllers
2231.1Scdiviaide* 	at pci? dev ? function ?	# VIA/AMD/Nvidia IDE controllers
2241.1Scdi
2251.1Scdi# ATA bus
2261.1Scdiatabus* 	at ata?
2271.1Scdi
2281.1Scdi# IDE drives
2291.1Scdi# Flags are used only with controllers that support DMA operations
2301.1Scdi# and mode settings (e.g. some pciide controllers)
2311.1Scdi# The lowest order four bits (rightmost digit) of the flags define the PIO
2321.1Scdi# mode to use, the next set of four bits the DMA mode and the third set the
2331.1Scdi# UltraDMA mode. For each set of four bits, the 3 lower bits define the mode
2341.1Scdi# to use, and the last bit must be 1 for this setting to be used.
2351.1Scdi# For DMA and UDMA, 0xf (1111) means 'disable'.
2361.1Scdi# 0x0fac means 'use PIO mode 4, DMA mode 2, disable UltraDMA'.
2371.1Scdi# (0xc=1100, 0xa=1010, 0xf=1111)
2381.1Scdi# 0x0000 means "use whatever the drive claims to support".
2391.1Scdiwd* 		at atabus? drive ? flags 0x0000
2401.1Scdi
2411.1Scdi# PCI network interfaces
2421.1Scdi#en*		at pci? dev ? function ?	# ENI/Adaptec ATM
2431.1Scdi#ep*		at pci? dev ? function ?	# 3Com 3c59x
2441.1Scdi#ex*		at pci? dev ? function ?	# 3Com 90x[BC]
2451.1Scdi#epic*		at pci? dev ? function ?	# SMC EPIC/100 Ethernet
2461.1Scdi#esh*		at pci? dev ? function ?	# Essential HIPPI card
2471.1Scdi#fpa*		at pci? dev ? function ?	# DEC DEFPA FDDI
2481.1Scdi#fxp*		at pci? dev ? function ?	# Intel EtherExpress PRO10+/100B
2491.1Scdi#le*		at pci? dev ? function ?	# PCnet-PCI Ethernet
2501.1Scdi#ne*		at pci? dev ? function ?	# NE2000-compatible Ethernet
2511.1Scdi#ntwoc*		at pci? dev ? function ?	# Riscom/N2 PCI Sync Serial
2521.1Scdi#sip*		at pci? dev ? function ?	# SiS 900 Ethernet
2531.1Scdi#tl*		at pci? dev ? function ?	# ThunderLAN-based Ethernet
2541.1Scditlp*		at pci? dev ? function ?	# DECchip 21x4x and clones
2551.1Scdi#vr*		at pci? dev ? function ?	# VIA Rhine Fast Ethernet
2561.1Scdi#lmc*		at pci? dev ? function ?	# Lan Media Corp SSI/HSSI/DS3
2571.1Scdi#rtk*		at pci? dev ? function ?	# Realtek 8129/8139
2581.1Scdi
2591.1Scdi# MII/PHY support
2601.1Scdi#exphy*		at mii? phy ?			# 3Com internal PHYs
2611.1Scdi#icsphy*		at mii? phy ?			# ICS189x PHYs
2621.1Scdi#inphy*		at mii? phy ?			# Intel 82555 PHYs
2631.1Scdi#iophy*		at mii? phy ?			# Intel 82553 PHYs
2641.1Scdilxtphy*		at mii? phy ?			# Level One LXT-970 PHYs
2651.1Scdi#nsphy*		at mii? phy ?			# NS83840 PHYs
2661.1Scdi#nsphyter* 	at mii? phy ?			# NS83843 PHYs
2671.1Scdi#qsphy*		at mii? phy ?			# Quality Semiconductor QS6612
2681.1Scdi#sqphy*		at mii? phy ?			# Seeq 80220/80221/80223 PHYs
2691.1Scdi#tlphy*		at mii? phy ?			# ThunderLAN PHYs
2701.1Scdi#tqphy*		at mii? phy ?			# TDK Semiconductor PHYs
2711.1Scdi#ukphy*		at mii? phy ?			# generic unknown PHYs
2721.1Scdi
2731.1Scdi# PCI audio devices
2741.1Scdi#clcs*		at pci? dev ? function ?	# Cirrus Logic CS4280
2751.1Scdi#eap*		at pci? dev ? function ?	# Ensoniq AudioPCI
2761.37Stsutsui#emuxki* 	at pci? dev ? function ?	# SoundBlaster Live!
2771.1Scdi#eso*		at pci? dev ? function ?	# ESS Solo-1 PCI AudioDrive
2781.1Scdi#fms*		at pci? dev ? function ?	# Forte Media FM801
2791.1Scdi#sv*		at pci? dev ? function ?	# S3 SonicVibes
2801.1Scdi
2811.37Stsutsui# Audio support
2821.37Stsutsui#audio*		at audiobus?
2831.37Stsutsui
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.51Schristos#pseudo-device	ccd				# concatenated disk devices
2911.51Schristos#pseudo-device	cgd				# cryptographic disk devices
2921.52Schristos#pseudo-device	raid				# 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.42Shannken#pseudo-device	md				# memory disk device (ramdisk)
3031.18Scube#pseudo-device	vnd				# disk-like interface to files
3041.1Scdi
3051.1Scdi# Network pseudo-devices
3061.32Stsutsuipseudo-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.36Stsutsuioptions 	NO_DEV_PTM
3261.1Scdi#pseudo-device	sequencer	1		# MIDI sequencer
3271.1Scdi#options 	RND_COM				# use "com" randomness (BROKEN)
3281.36Stsutsui#pseudo-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.52Schristos#pseudo-device	vcoda				# 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