INSTALL revision 1.40
11.40Sjym#	$NetBSD: INSTALL,v 1.40 2009/02/06 18:50:28 jym Exp $
21.1Sthorpej#
31.1Sthorpej#	Shark installation kernel
41.1Sthorpej#
51.1Sthorpej
61.1Sthorpejinclude	"arch/shark/conf/std.shark"
71.6Satatat
81.6Satatat#options 	INCLUDE_CONFIG_FILE	# embed config file in kernel binary
91.1Sthorpej
101.1Sthorpej# estimated number of users
111.1Sthorpej
121.1Sthorpejmaxusers	32
131.1Sthorpej
141.1Sthorpej# Standard system options
151.1Sthorpej
161.1Sthorpejoptions 	RTC_OFFSET=0	# hardware clock is this many mins. west of GMT
171.1Sthorpejoptions 	HZ=64
181.1Sthorpej#options 	NTP		# NTP phase/frequency locked loop
191.1Sthorpejoptions 	NMBCLUSTERS=1024 # XXX, temporarily required
201.1Sthorpej#options 	BOOT_QUIETLY	# twiddle instead of normal boot msg output
211.1Sthorpej
221.1Sthorpej# CPU options
231.1Sthorpej
241.1Sthorpejoptions 	CPU_SA110	# Support the SA110 core
251.2Sthorpejmakeoptions	COPTS="-Os"
261.1Sthorpej
271.1Sthorpej# Architecture options
281.1Sthorpej
291.1Sthorpejoptions 	SHARK		# We are a Shark
301.1Sthorpejoptions 	NSIO		# We are using the National Semi SuperIO
311.1Sthorpej
321.1Sthorpej# compatibility with old version of OFW, which may have incorrect
331.1Sthorpej# properties and/or may set up devices incorrectly.
341.1Sthorpejoptions 	COMPAT_OLD_OFW
351.1Sthorpej
361.1Sthorpej# FPA options
371.1Sthorpej
381.1Sthorpej#options 	ARMFPE		# ARM Ltd FPE
391.1Sthorpej
401.1Sthorpej# File systems
411.1Sthorpej
421.1Sthorpejfile-system	FFS		# UFS
431.1Sthorpej#file-system	LFS		# log-structured file system
441.1Sthorpejfile-system	MFS		# memory file system
451.1Sthorpejfile-system	NFS
461.1Sthorpej#file-system 	ADOSFS		# AmigaDOS-compatible file system
471.1Sthorpej#file-system 	EXT2FS		# second extended file system (linux)
481.1Sthorpej#file-system	CD9660		# ISO 9660 + Rock Ridge file system
491.1Sthorpejfile-system	MSDOSFS		# MS-DOS file system
501.1Sthorpej#file-system	FDESC		# /dev/fd
511.1Sthorpej#file-system	FILECORE	# Acorn filecore file system
521.1Sthorpejfile-system	KERNFS		# /kern
531.1Sthorpej#file-system	NULLFS		# loopback file system
541.1Sthorpej#file-system	PORTAL		# portal filesystem (still experimental)
551.1Sthorpej#file-system	PROCFS		# /proc
561.1Sthorpej#file-system	UMAPFS		# NULLFS + uid and gid remapping
571.1Sthorpej#file-system	UNION		# union file system
581.22Schristos#file-system	PTYFS		# /dev/pts/N support
591.1Sthorpej
601.1Sthorpej# File system options
611.1Sthorpej#options 	QUOTA		# UFS quotas
621.1Sthorpej#options 	FFS_EI		# FFS Endian Independant support
631.1Sthorpej#options 	NFSSERVER
641.23Stsutsui#options 	FFS_NO_SNAPSHOT	# No FFS snapshot support
651.38Ssimonboptions 	WAPBL		# File system journaling support - Experimental
661.1Sthorpej
671.1Sthorpej# Networking options
681.1Sthorpej
691.1Sthorpej#options 	GATEWAY		# packet forwarding
701.1Sthorpejoptions 	INET		# IP + ICMP + TCP + UDP
711.1Sthorpej#options 	MROUTING	# IP multicast routing
721.15Smanu#options 	PIM		# Protocol Independent Multicast
731.1Sthorpej#options 	ISO,TPIP	# OSI
741.1Sthorpej#options 	EON		# OSI tunneling over IP
751.1Sthorpej#options 	NETATALK	# AppleTalk networking
761.1Sthorpej#options 	PFIL_HOOKS	# pfil(9) packet filter hooks (Required
771.1Sthorpej				# if you enable the pseudo-device ipl).
781.1Sthorpej
791.1Sthorpej#options 	PPP_BSDCOMP	# BSD-Compress compression support for PPP
801.1Sthorpej#options 	PPP_DEFLATE	# Deflate compression support for PPP
811.1Sthorpej#options 	PPP_FILTER	# Active filter support for PPP (requires bpf)
821.1Sthorpejoptions 	NFS_BOOT_DHCP	# use NetBSD standard DHCP/NFS boot code
831.1Sthorpej#options 	TCP_DEBUG	# Record last TCP_NDEBUG packets with SO_DEBUG
841.1Sthorpej
851.1Sthorpej# Compatibility options
861.1Sthorpej
871.2Sthorpej#options 	COMPAT_43	# 4.3BSD compatibility.
881.37Stsutsui#options 	COMPAT_40	# NetBSD 4.0 compatibility.
891.21Schristos#options 	COMPAT_30	# NetBSD 3.0 compatibility.
901.20Ssimonb#options 	COMPAT_20	# NetBSD 2.0 compatibility.
911.20Ssimonb#options 	COMPAT_16	# NetBSD 1.6 compatibility.
921.29Smanu#options 	COMPAT_15	# NetBSD 1.5 compatibility.
931.2Sthorpej#options 	COMPAT_14	# NetBSD 1.4 compatibility.
941.2Sthorpej#options 	COMPAT_13	# NetBSD 1.3 compatibility.
951.2Sthorpej#options 	COMPAT_12	# NetBSD 1.2 compatibility.
961.1Sthorpej#options 	COMPAT_11	# NetBSD 1.1 compatibility.
971.1Sthorpej#options 	COMPAT_10	# NetBSD 1.0 compatibility.
981.1Sthorpej#options 	COMPAT_09	# NetBSD 0.9 compatibility.
991.1Sthorpej#options 	TCP_COMPAT_42	# 4.2BSD TCP/IP bug compat. Not recommended.
1001.16Schristosoptions		COMPAT_BSDPTY	# /dev/[pt]ty?? ptys.
1011.1Sthorpej
1021.1Sthorpej# Shared memory options
1031.1Sthorpej
1041.2Sthorpej#options 	SYSVMSG		# System V-like message queues
1051.2Sthorpej#options 	SYSVSEM		# System V-like semaphores
1061.2Sthorpej#options 	SYSVSHM		# System V-like memory sharing
1071.1Sthorpej#options 	SHMMAXPGS=1024	# 1024 pages is the default
1081.1Sthorpej
1091.1Sthorpej# Device options
1101.1Sthorpej
1111.1Sthorpejoptions 	MEMORY_DISK_HOOKS	# boottime setup of ramdisk
1121.1Sthorpejoptions 	MEMORY_DISK_IS_ROOT	# use memory disk as root
1131.4Slukemoptions 	MEMORY_DISK_ROOT_SIZE=7000	# Size in blocks (3.5MB)
1141.40Sjymoptions 	MEMORY_DISK_RBFLAGS=RB_SINGLE	# boot in single-user mode
1151.1Sthorpej
1161.1Sthorpejoptions 	INSECURE		# disable kernel securelevel
1171.1Sthorpej
1181.1Sthorpej# Use the following to force the serial to always be the console
1191.1Sthorpej# device.  19200 is what the serial gets set up as by the firmware
1201.1Sthorpej# when it hasn't fallen back from PC.  If it has fallen back then
1211.1Sthorpej# the speed will be set at 9600.
1221.1Sthorpej#options 	COMCONSOLE,CONADDR=0x3f8,CONUNIT=0,CONSPEED=19200
1231.1Sthorpej
1241.1Sthorpej# Miscellaneous kernel options
1251.2Sthorpej#options 	KTRACE		# system call tracing, a la ktrace(1)
1261.2Sthorpej#options 	IRQSTATS	# manage IRQ statistics, XXX temp required
1271.2Sthorpej#options 	KMEMSTATS	# kernel memory statistics, XXX temp required
1281.8Slukemoptions 	USERCONF	# userconf(4) support
1291.7Sabsoptions		PIPE_SOCKETPAIR		# smaller, but slower pipe(2)
1301.14Satatat#options 	SYSCTL_INCLUDE_DESCR	# Include sysctl descriptions in kernel
1311.1Sthorpej
1321.1Sthorpej# Development and Debugging options
1331.1Sthorpej
1341.1Sthorpej#options 	ARM700BUGTRACK	# track the ARM700 swi bug
1351.1Sthorpej#options 	PORTMASTER	# Enable PortMaster only options
1361.2Sthorpej#options 	DIAGNOSTIC	# internal consistency checks
1371.1Sthorpej#options 	PMAP_DEBUG	# Enable pmap_debug_level code
1381.1Sthorpejoptions 	DDB		# in-kernel debugger
1391.1Sthorpej#options 	DDB_ONPANIC=0	# don't run DDB at panictime
1401.1Sthorpej#options 	DDB_HISTORY_SIZE=100	# Enable history editing in DDB
1411.9Swiz#options 	KERNEL_DEBUG	# compile in kernel debugging capability
1421.1Sthorpej#makeoptions	DEBUG="-g"	# compile full symbol table
1431.1Sthorpej
1441.32Sjmmv#
1451.32Sjmmv# wscons options
1461.32Sjmmv#
1471.32Sjmmv# builtin terminal emulations
1481.32Sjmmv#options 	WSEMUL_SUN		# sun terminal emulation
1491.32Sjmmvoptions 	WSEMUL_VT100		# VT100 / VT220 emulation
1501.32Sjmmv# customization of console and kernel output - see dev/wscons/wsdisplayvar.h
1511.32Sjmmv#options 	WSDISPLAY_CUSTOM_OUTPUT	# color customization from wsconsctl(8)
1521.32Sjmmv#options 	WS_DEFAULT_FG=WSCOL_WHITE
1531.32Sjmmv#options 	WS_DEFAULT_BG=WSCOL_BLACK
1541.32Sjmmv#options 	WS_DEFAULT_COLATTR="(0)"
1551.32Sjmmv#options 	WS_DEFAULT_MONOATTR="(0)"
1561.32Sjmmv#options 	WS_KERNEL_FG=WSCOL_GREEN
1571.32Sjmmv#options 	WS_KERNEL_BG=WSCOL_BLACK
1581.32Sjmmv#options 	WS_KERNEL_COLATTR=""
1591.32Sjmmv#options 	WS_KERNEL_MONOATTR=""
1601.32Sjmmv# customization of console border color
1611.32Sjmmv#options 	WSDISPLAY_CUSTOM_BORDER	# border customization from wsconsctl(8)
1621.32Sjmmv#options 	WSDISPLAY_BORDER_COLOR=WSCOL_BLUE	# default color
1631.32Sjmmv# compatibility to other console drivers
1641.32Sjmmv#options 	WSDISPLAY_COMPAT_PCVT		# emulate some ioctls
1651.32Sjmmv#options 	WSDISPLAY_COMPAT_SYSCONS	# emulate some ioctls
1661.32Sjmmv#options 	WSDISPLAY_COMPAT_USL		# VT handling
1671.32Sjmmv#options 	WSDISPLAY_COMPAT_RAWKBD		# can get raw scancodes
1681.32Sjmmv# see dev/pckbport/wskbdmap_mfii.c for implemented layouts
1691.32Sjmmv#options 	PCKBD_LAYOUT="(KB_DE | KB_NODEAD)"
1701.32Sjmmv#options 	PCKBD_LAYOUT="(KB_US | KB_SWAPCTRLCAPS)"
1711.32Sjmmv# allocate a number of virtual screens at autoconfiguration time
1721.32Sjmmv#options 	WSDISPLAY_DEFAULTSCREENS=4
1731.32Sjmmv# use a large software cursor that doesn't blink
1741.32Sjmmv#options 	PCDISPLAY_SOFTCURSOR
1751.32Sjmmv# modify the screen type of the console; defaults to "80x25"
1761.32Sjmmv#options 	VGA_CONSOLE_SCREENTYPE="\"80x24\""
1771.32Sjmmv# console scrolling support.
1781.32Sjmmv#options 	WSDISPLAY_SCROLLSUPPORT
1791.32Sjmmv# enable VGA raster mode capable of displaying multilingual text on console
1801.32Sjmmv#options 	VGA_RASTERCONSOLE
1811.32Sjmmv
1821.1Sthorpejconfig		netbsd		root on ? type ffs	# root on miniroot
1831.1Sthorpej
1841.1Sthorpej# The main bus device
1851.1Sthorpejmainbus0 at root
1861.1Sthorpej
1871.13Swiz# The boot CPU
1881.1Sthorpejcpu0 at mainbus?
1891.1Sthorpej
1901.1Sthorpej# Open Firmware devices
1911.1Sthorpejofbus*		at root
1921.1Sthorpejofbus*		at ofbus?
1931.1Sthorpej#ofdisk* 	at ofbus?
1941.1Sthorpej#ofnet*		at ofbus?	# don't use with cs0
1951.1Sthorpej#ofcons* 	at ofbus?	# don't use with pc0
1961.1Sthorpejofrtc*		at ofisa?
1971.1Sthorpejofrom*		at ofbus?
1981.1Sthorpej
1991.1Sthorpejofisa*		at ofbus?
2001.1Sthorpejofbus*		at ofisa?
2011.1Sthorpej
2021.1Sthorpej# IDE/ATA disk
2031.1Sthorpejwdc*		at ofisa?
2041.12Sbouyeratabus* 	at wdc? channel ?
2051.12Sbouyerwd*		at atabus? drive ?
2061.1Sthorpej
2071.12Sbouyeratapibus*	at atabus?
2081.1Sthorpejcd*		at atapibus? drive?
2091.1Sthorpejsd*		at atapibus? drive?
2101.1Sthorpej
2111.1Sthorpej# PCCONS@OFW
2121.32Sjmmv#ofisapc*	at ofbus?
2131.32Sjmmv#pc*		at ofisapc?
2141.1Sthorpej
2151.1Sthorpej# PS/2 Mouse
2161.31Sjmmv#opms0		at spckbd? irq 12
2171.1Sthorpej
2181.32Sjmmv# wscons
2191.32Sjmmvpckbc*		at ofisa?
2201.32Sjmmvpckbd*		at pckbc?
2211.32Sjmmv#pms*		at pckbc?
2221.32Sjmmvvga*		at ofbus?
2231.32Sjmmv#igsfb*		at ofbus?
2241.32Sjmmvwsdisplay*	at wsemuldisplaydev?
2251.32Sjmmvwskbd*		at pckbd? console ?
2261.32Sjmmv#wsmouse*	at pms? mux 0
2271.32Sjmmv
2281.1Sthorpej# CS8900 Ethernet@OFW
2291.1Sthorpejcs*		at ofisa?
2301.1Sthorpej
2311.1Sthorpej# Serial @OFW
2321.1Sthorpejcom*		at ofisa?
2331.1Sthorpej
2341.1Sthorpej# Parallel @OFW
2351.1Sthorpejlpt*		at ofisa?
2361.1Sthorpej
2371.1Sthorpej# Smart Card
2381.1Sthorpejofisascr*	at ofisa?
2391.1Sthorpejscr*		at ofisascr?
2401.1Sthorpej
2411.1Sthorpej# ESS Sound@OFW
2421.2Sthorpej#ess*		at ofisa?
2431.2Sthorpej#audio*		at ess?
2441.2Sthorpej#opl*		at ess?
2451.2Sthorpej#midi*		at opl?
2461.1Sthorpej
2471.1Sthorpej# Joystick @OFW
2481.2Sthorpej#joy*		at ofisa?
2491.1Sthorpej
2501.1Sthorpejpseudo-device	loop	1		# network loopback
2511.26Srpaulopseudo-device	bpfilter		# packet filter
2521.27Scube#pseudo-device	sl			# CSLIP
2531.27Scube#pseudo-device	ppp			# PPP
2541.27Scube#pseudo-device	tun			# network tunneling over tty
2551.1Sthorpej#pseudo-device	ipfilter 1		# ip filter
2561.1Sthorpej
2571.1Sthorpejpseudo-device	pty			# pseudo-terminals
2581.27Scube#pseudo-device	vnd			# disk-like interface to files
2591.1Sthorpej#pseudo-device	ccd	2		# concatenated disk devices
2601.17Shannken#pseudo-device	fss	4		# file system snapshot device
2611.1Sthorpejpseudo-device	rnd			# /dev/random and /dev/urandom
2621.1Sthorpej
2631.1Sthorpejpseudo-device	md	1		# Ramdisk driver
2641.1Sthorpej#pseudo-device	profiler 1		# fiq based profiling device
2651.2Sthorpej#pseudo-device	sequencer 1		# MIDI sequencer
2661.32Sjmmvpseudo-device	wsmux			# mouse & keyboard multiplexor
2671.32Sjmmv#pseudo-device	wsfont
268