INSTALL revision 1.49
11.49Sdholland#	$NetBSD: INSTALL,v 1.49 2011/12/18 05:49:32 dholland 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.1Sthorpej#options 	BOOT_QUIETLY	# twiddle instead of normal boot msg output
201.1Sthorpej
211.1Sthorpej# CPU options
221.1Sthorpej
231.1Sthorpejoptions 	CPU_SA110	# Support the SA110 core
241.2Sthorpejmakeoptions	COPTS="-Os"
251.1Sthorpej
261.1Sthorpej# Architecture options
271.1Sthorpej
281.1Sthorpejoptions 	SHARK		# We are a Shark
291.1Sthorpejoptions 	NSIO		# We are using the National Semi SuperIO
301.1Sthorpej
311.1Sthorpej# compatibility with old version of OFW, which may have incorrect
321.1Sthorpej# properties and/or may set up devices incorrectly.
331.1Sthorpejoptions 	COMPAT_OLD_OFW
341.1Sthorpej
351.1Sthorpej# FPA options
361.1Sthorpej
371.1Sthorpej#options 	ARMFPE		# ARM Ltd FPE
381.1Sthorpej
391.1Sthorpej# File systems
401.1Sthorpej
411.1Sthorpejfile-system	FFS		# UFS
421.1Sthorpej#file-system	LFS		# log-structured file system
431.1Sthorpejfile-system	MFS		# memory file system
441.1Sthorpejfile-system	NFS
451.1Sthorpej#file-system 	ADOSFS		# AmigaDOS-compatible file system
461.1Sthorpej#file-system 	EXT2FS		# second extended file system (linux)
471.1Sthorpej#file-system	CD9660		# ISO 9660 + Rock Ridge file system
481.1Sthorpejfile-system	MSDOSFS		# MS-DOS file system
491.1Sthorpej#file-system	FDESC		# /dev/fd
501.1Sthorpej#file-system	FILECORE	# Acorn filecore file system
511.1Sthorpejfile-system	KERNFS		# /kern
521.1Sthorpej#file-system	NULLFS		# loopback file system
531.1Sthorpej#file-system	PROCFS		# /proc
541.1Sthorpej#file-system	UMAPFS		# NULLFS + uid and gid remapping
551.1Sthorpej#file-system	UNION		# union file system
561.22Schristos#file-system	PTYFS		# /dev/pts/N support
571.1Sthorpej
581.1Sthorpej# File system options
591.46Sbouyer#options 	QUOTA		# legacy UFS quotas
601.46Sbouyer#options 	QUOTA2		# new, in-filesystem UFS quotas
611.47Swiz#options 	FFS_EI		# FFS Endian Independent support
621.1Sthorpej#options 	NFSSERVER
631.23Stsutsui#options 	FFS_NO_SNAPSHOT	# No FFS snapshot support
641.49Sdhollandoptions 	WAPBL		# File system journaling support
651.1Sthorpej
661.1Sthorpej# Networking options
671.1Sthorpej
681.1Sthorpej#options 	GATEWAY		# packet forwarding
691.1Sthorpejoptions 	INET		# IP + ICMP + TCP + UDP
701.1Sthorpej#options 	MROUTING	# IP multicast routing
711.15Smanu#options 	PIM		# Protocol Independent Multicast
721.1Sthorpej#options 	ISO,TPIP	# OSI
731.1Sthorpej#options 	EON		# OSI tunneling over IP
741.1Sthorpej#options 	NETATALK	# AppleTalk networking
751.1Sthorpej#options 	PFIL_HOOKS	# pfil(9) packet filter hooks (Required
761.1Sthorpej				# if you enable the pseudo-device ipl).
771.1Sthorpej
781.1Sthorpej#options 	PPP_BSDCOMP	# BSD-Compress compression support for PPP
791.1Sthorpej#options 	PPP_DEFLATE	# Deflate compression support for PPP
801.1Sthorpej#options 	PPP_FILTER	# Active filter support for PPP (requires bpf)
811.1Sthorpejoptions 	NFS_BOOT_DHCP	# use NetBSD standard DHCP/NFS boot code
821.1Sthorpej#options 	TCP_DEBUG	# Record last TCP_NDEBUG packets with SO_DEBUG
831.1Sthorpej
841.1Sthorpej# Compatibility options
851.1Sthorpej
861.2Sthorpej#options 	COMPAT_43	# 4.3BSD compatibility.
871.37Stsutsui#options 	COMPAT_40	# NetBSD 4.0 compatibility.
881.21Schristos#options 	COMPAT_30	# NetBSD 3.0 compatibility.
891.20Ssimonb#options 	COMPAT_20	# NetBSD 2.0 compatibility.
901.20Ssimonb#options 	COMPAT_16	# NetBSD 1.6 compatibility.
911.29Smanu#options 	COMPAT_15	# NetBSD 1.5 compatibility.
921.2Sthorpej#options 	COMPAT_14	# NetBSD 1.4 compatibility.
931.2Sthorpej#options 	COMPAT_13	# NetBSD 1.3 compatibility.
941.2Sthorpej#options 	COMPAT_12	# NetBSD 1.2 compatibility.
951.1Sthorpej#options 	COMPAT_11	# NetBSD 1.1 compatibility.
961.1Sthorpej#options 	COMPAT_10	# NetBSD 1.0 compatibility.
971.1Sthorpej#options 	COMPAT_09	# NetBSD 0.9 compatibility.
981.1Sthorpej#options 	TCP_COMPAT_42	# 4.2BSD TCP/IP bug compat. Not recommended.
991.16Schristosoptions		COMPAT_BSDPTY	# /dev/[pt]ty?? ptys.
1001.1Sthorpej
1011.1Sthorpej# Shared memory options
1021.1Sthorpej
1031.2Sthorpej#options 	SYSVMSG		# System V-like message queues
1041.2Sthorpej#options 	SYSVSEM		# System V-like semaphores
1051.2Sthorpej#options 	SYSVSHM		# System V-like memory sharing
1061.1Sthorpej
1071.1Sthorpej# Device options
1081.1Sthorpej
1091.1Sthorpejoptions 	MEMORY_DISK_HOOKS	# boottime setup of ramdisk
1101.1Sthorpejoptions 	MEMORY_DISK_IS_ROOT	# use memory disk as root
1111.4Slukemoptions 	MEMORY_DISK_ROOT_SIZE=7000	# Size in blocks (3.5MB)
1121.40Sjymoptions 	MEMORY_DISK_RBFLAGS=RB_SINGLE	# boot in single-user mode
1131.1Sthorpej
1141.1Sthorpejoptions 	INSECURE		# disable kernel securelevel
1151.1Sthorpej
1161.1Sthorpej# Use the following to force the serial to always be the console
1171.1Sthorpej# device.  19200 is what the serial gets set up as by the firmware
1181.1Sthorpej# when it hasn't fallen back from PC.  If it has fallen back then
1191.1Sthorpej# the speed will be set at 9600.
1201.1Sthorpej#options 	COMCONSOLE,CONADDR=0x3f8,CONUNIT=0,CONSPEED=19200
1211.1Sthorpej
1221.1Sthorpej# Miscellaneous kernel options
1231.2Sthorpej#options 	KTRACE		# system call tracing, a la ktrace(1)
1241.2Sthorpej#options 	IRQSTATS	# manage IRQ statistics, XXX temp required
1251.2Sthorpej#options 	KMEMSTATS	# kernel memory statistics, XXX temp required
1261.8Slukemoptions 	USERCONF	# userconf(4) support
1271.7Sabsoptions		PIPE_SOCKETPAIR		# smaller, but slower pipe(2)
1281.14Satatat#options 	SYSCTL_INCLUDE_DESCR	# Include sysctl descriptions in kernel
1291.1Sthorpej
1301.1Sthorpej# Development and Debugging options
1311.1Sthorpej
1321.1Sthorpej#options 	ARM700BUGTRACK	# track the ARM700 swi bug
1331.1Sthorpej#options 	PORTMASTER	# Enable PortMaster only options
1341.2Sthorpej#options 	DIAGNOSTIC	# internal consistency checks
1351.1Sthorpej#options 	PMAP_DEBUG	# Enable pmap_debug_level code
1361.1Sthorpejoptions 	DDB		# in-kernel debugger
1371.1Sthorpej#options 	DDB_ONPANIC=0	# don't run DDB at panictime
1381.1Sthorpej#options 	DDB_HISTORY_SIZE=100	# Enable history editing in DDB
1391.9Swiz#options 	KERNEL_DEBUG	# compile in kernel debugging capability
1401.1Sthorpej#makeoptions	DEBUG="-g"	# compile full symbol table
1411.1Sthorpej
1421.32Sjmmv#
1431.32Sjmmv# wscons options
1441.32Sjmmv#
1451.32Sjmmv# builtin terminal emulations
1461.32Sjmmv#options 	WSEMUL_SUN		# sun terminal emulation
1471.32Sjmmvoptions 	WSEMUL_VT100		# VT100 / VT220 emulation
1481.32Sjmmv# customization of console and kernel output - see dev/wscons/wsdisplayvar.h
1491.32Sjmmv#options 	WSDISPLAY_CUSTOM_OUTPUT	# color customization from wsconsctl(8)
1501.32Sjmmv#options 	WS_DEFAULT_FG=WSCOL_WHITE
1511.32Sjmmv#options 	WS_DEFAULT_BG=WSCOL_BLACK
1521.32Sjmmv#options 	WS_DEFAULT_COLATTR="(0)"
1531.32Sjmmv#options 	WS_DEFAULT_MONOATTR="(0)"
1541.32Sjmmv#options 	WS_KERNEL_FG=WSCOL_GREEN
1551.32Sjmmv#options 	WS_KERNEL_BG=WSCOL_BLACK
1561.32Sjmmv#options 	WS_KERNEL_COLATTR=""
1571.32Sjmmv#options 	WS_KERNEL_MONOATTR=""
1581.32Sjmmv# customization of console border color
1591.32Sjmmv#options 	WSDISPLAY_CUSTOM_BORDER	# border customization from wsconsctl(8)
1601.32Sjmmv#options 	WSDISPLAY_BORDER_COLOR=WSCOL_BLUE	# default color
1611.32Sjmmv# compatibility to other console drivers
1621.32Sjmmv#options 	WSDISPLAY_COMPAT_PCVT		# emulate some ioctls
1631.32Sjmmv#options 	WSDISPLAY_COMPAT_SYSCONS	# emulate some ioctls
1641.32Sjmmv#options 	WSDISPLAY_COMPAT_USL		# VT handling
1651.32Sjmmv#options 	WSDISPLAY_COMPAT_RAWKBD		# can get raw scancodes
1661.32Sjmmv# see dev/pckbport/wskbdmap_mfii.c for implemented layouts
1671.32Sjmmv#options 	PCKBD_LAYOUT="(KB_DE | KB_NODEAD)"
1681.32Sjmmv#options 	PCKBD_LAYOUT="(KB_US | KB_SWAPCTRLCAPS)"
1691.32Sjmmv# allocate a number of virtual screens at autoconfiguration time
1701.32Sjmmv#options 	WSDISPLAY_DEFAULTSCREENS=4
1711.32Sjmmv# use a large software cursor that doesn't blink
1721.32Sjmmv#options 	PCDISPLAY_SOFTCURSOR
1731.32Sjmmv# modify the screen type of the console; defaults to "80x25"
1741.32Sjmmv#options 	VGA_CONSOLE_SCREENTYPE="\"80x24\""
1751.32Sjmmv# console scrolling support.
1761.32Sjmmv#options 	WSDISPLAY_SCROLLSUPPORT
1771.32Sjmmv# enable VGA raster mode capable of displaying multilingual text on console
1781.32Sjmmv#options 	VGA_RASTERCONSOLE
1791.32Sjmmv
1801.1Sthorpejconfig		netbsd		root on ? type ffs	# root on miniroot
1811.1Sthorpej
1821.1Sthorpej# The main bus device
1831.1Sthorpejmainbus0 at root
1841.1Sthorpej
1851.13Swiz# The boot CPU
1861.1Sthorpejcpu0 at mainbus?
1871.1Sthorpej
1881.1Sthorpej# Open Firmware devices
1891.1Sthorpejofbus*		at root
1901.1Sthorpejofbus*		at ofbus?
1911.1Sthorpej#ofdisk* 	at ofbus?
1921.1Sthorpej#ofnet*		at ofbus?	# don't use with cs0
1931.1Sthorpej#ofcons* 	at ofbus?	# don't use with pc0
1941.1Sthorpejofrtc*		at ofisa?
1951.1Sthorpejofrom*		at ofbus?
1961.1Sthorpej
1971.1Sthorpejofisa*		at ofbus?
1981.1Sthorpejofbus*		at ofisa?
1991.1Sthorpej
2001.1Sthorpej# IDE/ATA disk
2011.1Sthorpejwdc*		at ofisa?
2021.12Sbouyeratabus* 	at wdc? channel ?
2031.12Sbouyerwd*		at atabus? drive ?
2041.1Sthorpej
2051.12Sbouyeratapibus*	at atabus?
2061.1Sthorpejcd*		at atapibus? drive?
2071.1Sthorpejsd*		at atapibus? drive?
2081.1Sthorpej
2091.1Sthorpej# PCCONS@OFW
2101.32Sjmmv#ofisapc*	at ofbus?
2111.32Sjmmv#pc*		at ofisapc?
2121.1Sthorpej
2131.1Sthorpej# PS/2 Mouse
2141.31Sjmmv#opms0		at spckbd? irq 12
2151.1Sthorpej
2161.32Sjmmv# wscons
2171.32Sjmmvpckbc*		at ofisa?
2181.32Sjmmvpckbd*		at pckbc?
2191.32Sjmmv#pms*		at pckbc?
2201.32Sjmmvvga*		at ofbus?
2211.32Sjmmv#igsfb*		at ofbus?
2221.32Sjmmvwsdisplay*	at wsemuldisplaydev?
2231.32Sjmmvwskbd*		at pckbd? console ?
2241.32Sjmmv#wsmouse*	at pms? mux 0
2251.32Sjmmv
2261.1Sthorpej# CS8900 Ethernet@OFW
2271.1Sthorpejcs*		at ofisa?
2281.1Sthorpej
2291.1Sthorpej# Serial @OFW
2301.1Sthorpejcom*		at ofisa?
2311.1Sthorpej
2321.1Sthorpej# Parallel @OFW
2331.1Sthorpejlpt*		at ofisa?
2341.1Sthorpej
2351.1Sthorpej# Smart Card
2361.1Sthorpejofisascr*	at ofisa?
2371.1Sthorpejscr*		at ofisascr?
2381.1Sthorpej
2391.1Sthorpej# ESS Sound@OFW
2401.2Sthorpej#ess*		at ofisa?
2411.2Sthorpej#audio*		at ess?
2421.2Sthorpej#opl*		at ess?
2431.2Sthorpej#midi*		at opl?
2441.1Sthorpej
2451.1Sthorpej# Joystick @OFW
2461.2Sthorpej#joy*		at ofisa?
2471.1Sthorpej
2481.1Sthorpejpseudo-device	loop	1		# network loopback
2491.26Srpaulopseudo-device	bpfilter		# packet filter
2501.27Scube#pseudo-device	sl			# CSLIP
2511.27Scube#pseudo-device	ppp			# PPP
2521.27Scube#pseudo-device	tun			# network tunneling over tty
2531.1Sthorpej#pseudo-device	ipfilter 1		# ip filter
2541.1Sthorpej
2551.1Sthorpejpseudo-device	pty			# pseudo-terminals
2561.27Scube#pseudo-device	vnd			# disk-like interface to files
2571.1Sthorpej#pseudo-device	ccd	2		# concatenated disk devices
2581.44Spooka#pseudo-device	fss			# file system snapshot device
2591.1Sthorpej
2601.45Shannkenpseudo-device	md			# Ramdisk driver
2611.1Sthorpej#pseudo-device	profiler 1		# fiq based profiling device
2621.2Sthorpej#pseudo-device	sequencer 1		# MIDI sequencer
2631.32Sjmmvpseudo-device	wsmux			# mouse & keyboard multiplexor
2641.32Sjmmv#pseudo-device	wsfont
265