INSTALL revision 1.41
11.41Swiz# $NetBSD: INSTALL,v 1.41 2011/06/30 20:09:37 wiz Exp $
21.1Sfredette
31.1Sfredette# INSTALL Sun2 (2/120, 2/170, 2/50, ...)
41.1Sfredette
51.1Sfredetteinclude "arch/sun2/conf/std.sun2"
61.1Sfredette
71.12Satatat#options 	INCLUDE_CONFIG_FILE	# embed config file in kernel binary
81.12Satatat
91.41Swiz#ident 		"INSTALL-$Revision: 1.41 $"
101.33Stsutsui
111.33Stsutsuimakeoptions	COPTS="-Os"	# optimize for size
121.1Sfredette
131.1Sfredette# Machines to be supported by this kernel
141.1Sfredette#options 	FPU_EMULATE
151.1Sfredette
161.1Sfredette# Needs to be set per system.  i.e change these as you see fit
171.1Sfredettemaxusers	2
181.1Sfredette
191.1Sfredette# Standard system options
201.1Sfredette#options 	KTRACE		# system call tracing
211.1Sfredette#options 	SYSVMSG		# System V message queues
221.1Sfredette#options 	SYSVSEM		# System V semaphores
231.1Sfredette#options 	SYSVSHM		# System V shared memory
241.1Sfredette#options 	INSECURE	# disable kernel security level
251.13Sabsoptions		PIPE_SOCKETPAIR		# smaller, but slower pipe(2)
261.17Satatat#options 	SYSCTL_INCLUDE_DESCR	# Include sysctl descriptions in kernel
271.1Sfredette
281.1Sfredette# Which kernel debugger?  Uncomment either this:
291.1Sfredette#options 	DDB
301.1Sfredette# ... or these for KGDB (gdb remote target)
311.6Slukem#makeoptions	DEBUG="-g"	# debugging symbols for gdb
321.1Sfredette#options 	KGDB
331.5Slukem#options 	KGDB_DEV=0x0C00	# ttya=0C00 ttyb=0C01
341.1Sfredette
351.1Sfredette# Other debugging options
361.1Sfredette#options 	DDB_HISTORY_SIZE=100	# enable history editing in DDB
371.1Sfredette#options 	DEBUG		# kernel debugging code
381.1Sfredette#options 	DIAGNOSTIC	# extra kernel sanity checking
391.14Slukemoptions 	USERCONF	# userconf(4) support
401.1Sfredette#options 	KMEMSTATS	# kernel memory statistics (vmstat -m)
411.1Sfredette#options 	PMAP_DEBUG
421.1Sfredette#options 	SCSIDEBUG
431.1Sfredette#options 	SCSIVERBOSE		# Verbose SCSI errors
441.1Sfredette
451.2Swiz# Compatibility options
461.1Sfredette#options 	COMPAT_SUNOS	# can run SunOS 4.1.1 executables
471.1Sfredette#options 	COMPAT_43	# and 4.3BSD and ...
481.7Sfredette#options 	COMPAT_AOUT_M68K # support for NetBSD a.out executables
491.7Sfredette#options 	TCP_COMPAT_42	# 4.2BSD TCP/IP bug compat. Not recommended.
501.6Slukemoptions 	EXEC_AOUT	# support for a.out executables
511.18Schristosoptions		COMPAT_BSDPTY	# /dev/[pt]ty?? ptys.
521.1Sfredette
531.1Sfredette# Filesystem options
541.1Sfredettefile-system	FFS		# Berkeley Fast Filesystem
551.1Sfredettefile-system	NFS		# Sun NFS client support
561.1Sfredettefile-system	CD9660		# ISO 9660 + Rock Ridge file system
571.1Sfredette#file-system	FDESC		# /dev/fd/*
581.9Sfredettefile-system	KERNFS		# /kern
591.1Sfredette#file-system	NULLFS		# loopback file system
601.1Sfredette#file-system	OVERLAY		# overlay file system
611.1Sfredette#file-system	PROCFS		# /proc
621.1Sfredette#file-system	UNION		# union file system
631.1Sfredette#file-system	MFS		# memory-based filesystem
641.23Schristos#file-system	PTYFS		# /dev/pts/N support
651.1Sfredette
661.1Sfredette#options 	NFSSERVER	# nfs server support
671.40Sbouyer#options 	QUOTA		# legacy UFS quotas
681.40Sbouyer#options 	QUOTA2		# new, in-filesystem UFS quotas
691.41Swiz#options 	FFS_EI		# FFS Endian Independent support
701.35Stsutsuioptions 	NFS_V2_ONLY	# Exclude NFS3 code to save space
711.25Stsutsuioptions 	FFS_NO_SNAPSHOT	# No FFS snapshot support
721.1Sfredette
731.1Sfredette# Networking options
741.24Sisakioptions 	INET		# IP protocol stack support
751.1Sfredette#options 	INET6		# IPV6
761.1Sfredette#options 	IPSEC		# IP security
771.1Sfredette#options 	IPSEC_ESP	# IP security (encryption part; define w/IPSEC)
781.22Stron#options 	IPSEC_NAT_T	# IPsec NAT traversal (NAT-T)
791.1Sfredette#options 	IPSEC_DEBUG	# debug for IP security
801.1Sfredette#options 	GATEWAY		# IP packet forwarding
811.1Sfredette#options 	ISO,TPIP	# OSI networking
821.1Sfredette#options 	EON		# OSI tunneling over IP
831.1Sfredette#options 	PFIL_HOOKS	# pfil(9) packet filter hooks.
841.4Sabs#options 	TCP_DEBUG	# Record last TCP_NDEBUG packets with SO_DEBUG
851.1Sfredette
861.1Sfredette# Work-around for root on slow servers (insurance...)
871.1Sfredetteoptions 	NFS_BOOT_RWSIZE=1024
881.1Sfredetteoptions 	NFS_BOOT_BOOTPARAM
891.1Sfredette
901.1Sfredetteconfig		netbsd root on ? type ?
911.1Sfredette
921.1Sfredette#### Main bus.
931.1Sfredettemainbus0 at root
941.1Sfredette
951.1Sfredette#### Bus types.
961.1Sfredette
971.1Sfredetteobio0	at mainbus? 		# all Sun-2
981.1Sfredetteobmem0	at mainbus?		# all Sun-2
991.1Sfredettembmem0	at mainbus?		# 2/120, 2/170
1001.1Sfredettembio0	at mainbus?		# 2/120, 2/170
1011.3Sfredettesun68kvme0	at mainbus?	# 2/50, 2/130, 2/160
1021.3Sfredettevme0	at sun68kvme0		# mi VME attachment
1031.1Sfredette
1041.1Sfredette#### Standard system devices.
1051.1Sfredette
1061.1Sfredette## The AM9513 clock chip.
1071.6Slukemclock0	at obio0 addr 0x002800	# 2/120, 2/170
1081.6Slukemclock0	at obio0 addr 0x7f2800	# 2/50, 2/130, 2/160
1091.1Sfredette
1101.1Sfredette## The MM58167 time-of-day chip.
1111.6Slukemtod0	at obio0 addr 0x003800	# 2/120, 2/170
1121.3Sfredettetod0	at vme0 addr 0x200800	# 2/50, 2/130, 2/160
1131.1Sfredette
1141.1Sfredette#### Serial port configuration.
1151.1Sfredette
1161.3Sfredette## Zilog 8530 serial chips.  Each has two channels.
1171.1Sfredette## zs0 is ttya and ttyb.  zs1 is the keyboard and mouse.
1181.1Sfredette## zs0 is REQUIRED to use KGDB.
1191.1Sfredettezs0	at obio0 addr 0x002000	# 2/120, 2/170
1201.3Sfredettezs0	at obio0 addr 0x7f2000	# 2/50
1211.1Sfredettezs1	at obmem0 addr 0x780000	# 2/120, 2/170
1221.3Sfredettezs1	at obio0 addr 0x7f1800	# 2/50
1231.9Sfredette#zs2	at mbmem0 addr 0x080800	# 2/120, 2/170 (first sc SCSI)
1241.9Sfredette#zs3	at mbmem0 addr 0x081000	# 2/120, 2/170 (first sc SCSI)
1251.9Sfredette#zs4	at mbmem0 addr 0x084800	# 2/120, 2/170 (second sc SCSI)
1261.9Sfredette#zs5	at mbmem0 addr 0x085000	# 2/120, 2/170 (second sc SCSI)
1271.3Sfredettezstty*	at zs? channel ?	# ttya
1281.3Sfredettekbd0	at zstty?		# keyboard
1291.3Sfredette#ms0	at zstty?		# mouse
1301.1Sfredette
1311.1Sfredette#### Disk controllers and disks.
1321.1Sfredette
1331.1Sfredette## PAL+logic-based "Sun SCSI 2" Multibus/VME SCSI controller.
1341.1Sfredette## This driver has several flags which may be enabled using
1351.1Sfredette## the "flags" directive.  Valid flags are:
1361.1Sfredette##
1371.1Sfredette## 0x0ff		Set (1<<target) to disable parity checking
1381.1Sfredette## 0x100		Set this bit to disable DMA interrupts (poll)
1391.1Sfredette## 0x200		Set this bit to disable DMA entirely (use PIO)
1401.1Sfredette##
1411.1Sfredette## For example: "flags 0x10f" would disable DMA interrupts,
1421.1Sfredette## and disable parity for targets 0-3
1431.1Sfredette
1441.1Sfredettesc0	at mbmem0 addr 0x80000 ipl 2 flags 0xff
1451.6Slukemsc0	at vme0 addr 0x200000 irq 2 vect 0x40 flags 0xff
1461.1Sfredettesc1	at mbmem0 addr 0x84000 ipl 2 flags 0xff
1471.1Sfredette
1481.1Sfredette## NCR5380-based "Sun SCSI 3" VME SCSI controller.
1491.1Sfredette## This driver has several flags which may be enabled by OR'ing
1501.1Sfredette## the values and using the "flags" directive.
1511.1Sfredette## Valid flags are:
1521.1Sfredette##
1531.1Sfredette##	0x01		Use DMA (may be polled)
1541.1Sfredette##	0x02		Use DMA completion interrupts
1551.1Sfredette##	0x04		Allow disconnect/reselect
1561.1Sfredette##
1571.1Sfredette## E.g. the following would enable DMA, interrupts, and reselect:
1581.1Sfredette## si0	at vme0 addr 0x200000 ipl 3 vect 0x40 flags 0x07
1591.1Sfredette##
1601.1Sfredette## By default, DMA is enabled in the driver.
1611.1Sfredette
1621.3Sfredettesi0	at vme0 addr 0x200000 irq 2 vect 0x40
1631.1Sfredette
1641.1Sfredette## These entries find devices on all SCSI busses and assign
1651.1Sfredette## unit numbers dynamically.
1661.1Sfredettescsibus* at sc?
1671.3Sfredettescsibus* at si?
1681.1Sfredettesd*	at scsibus? target ? lun ?		# SCSI disks
1691.1Sfredettest*	at scsibus? target ? lun ?		# SCSI tapes
1701.1Sfredettecd*	at scsibus? target ? lun ?		# SCSI CD-ROMs
1711.1Sfredette#ch*	at scsibus? target ? lun ?		# SCSI changer devices
1721.1Sfredette#ss*	at scsibus? target ? lun ?		# SCSI scanners
1731.1Sfredette#ses*	at scsibus? target ? lun ?		# SCSI SES/SAF-TE
1741.1Sfredette#uk*	at scsibus? target ? lun ?		# unknown SCSI
1751.8Sfredette
1761.8Sfredette# support old SCSI devices that don't understand the INQUIRY command
1771.8Sfredetteoptions 	SCSI_OLD_NOINQUIRY
1781.1Sfredette
1791.1Sfredette## Xylogics 450 or 451 Multibus/VME SMD disk controllers and disks.
1801.6Slukem#xyc0	at mbio0 addr 0xee40 ipl 2
1811.3Sfredettexyc0	at vme0 addr 0xee40 irq 2 vect 0x48
1821.6Slukem#xyc1	at mbio0 addr 0xee48 ipl 2
1831.3Sfredettexyc1	at vme0 addr 0xee48 irq 2 vect 0x49
1841.3Sfredettexy*	at xyc? drive ?
1851.1Sfredette
1861.1Sfredette## Memory-disk device.
1871.39Shannken#pseudo-device	md		
1881.1Sfredette
1891.1Sfredette#### Network interfaces.
1901.1Sfredette
1911.1Sfredette## Intel Ethernet (onboard, or Multibus/VME)
1921.3Sfredetteie0	at obio0 addr 0x7f0800 ipl 3		# 2/50
1931.1Sfredetteie0	at mbmem0 addr 0x88000 ipl 3
1941.3Sfredetteie1	at mbmem0 addr 0x8c000 ipl 3
1951.3Sfredette## VME: the first [addr,len] pair specifies the device registers;
1961.3Sfredette##	the second pair specifies the on-board memory buffer
1971.3Sfredetteie1	at vme0 addr 0xe88000,0xe00000 len -1,0x40000 irq 3 vect 0x75
1981.3Sfredette
1991.3Sfredette## 3Com Ethernet (Multibus only)
2001.3Sfredetteec0	at mbmem0 addr 0xe0000 ipl 3
2011.3Sfredetteec1	at mbmem0 addr 0xe2000 ipl 3
2021.31Stsutsui# limit NFS R/W size for poor ec(4) interfaces
2031.31Stsutsuioptions 	NFS_RSIZE=1024,NFS_WSIZE=1024
2041.1Sfredette
2051.1Sfredette## Frame buffers.
2061.1Sfredette
2071.1Sfredette## Sun "bwtwo" black and white framebuffer.
2081.6Slukembwtwo0	at obmem0 addr 0x700000	# 2/120, 2/170
2091.3Sfredettebwtwo0	at obio0 addr 0x0	# 2/50
2101.3Sfredette
2111.3Sfredette## PROM console driver -- if all else fails
2121.3Sfredettepcons0	at mainbus0			# PROM console
2131.1Sfredette
2141.1Sfredette#### Miscellaneous.
2151.1Sfredettepseudo-device	loop		1	# network loopback
2161.27Srpaulo#pseudo-device	bpfilter		# packet filter
2171.28Scube#pseudo-device	sl			# CSLIP
2181.28Scube#pseudo-device	ppp			# PPP
2191.28Scube#pseudo-device	tun			# network tunneling over tty
2201.28Scube#pseudo-device	gre			# generic L3 over IP tunnel
2211.1Sfredette#pseudo-device	ipfilter		# ip filter
2221.28Scube#pseudo-device	gif			# IPv[46] over IPv[46] tunnel (RFC1933)
2231.28Scube#pseudo-device	faith			# IPv[46] tcp relay translation i/f
2241.28Scube#pseudo-device	stf			# 6to4 IPv6 over IPv4 encapsulation
2251.16Sitojunpseudo-device	rnd			# /dev/random and in-kernel generator
2261.1Sfredette
2271.1Sfredettepseudo-device	pty		4	# pseudo-terminals
2281.28Scube#pseudo-device	vnd			# paging to files
2291.1Sfredette#pseudo-device	ccd		4	# concatenated disks
2301.1Sfredette#pseudo-device	raid		4	# RAIDframe disk driver
2311.1Sfredette#options 	RAID_AUTOCONFIG		# auto-configuration of RAID components
2321.38Spooka#pseudo-device	fss			# file system snapshot device
233