INSTALL revision 1.51
11.51Sdholland# $NetBSD: INSTALL,v 1.51 2011/12/18 05:49:33 dholland Exp $
21.1Sgwr#
31.1Sgwr# INSTALL - Installation kernel for the Sun3
41.1Sgwr#
51.1Sgwr# This kernel is derived from GENERIC with some features commented out.
61.1Sgwr#
71.1Sgwr# This kernel does NOT support X, mice, non-NetBSD emulation, etc.
81.1Sgwr#
91.1Sgwr
101.1Sgwrinclude "arch/sun3/conf/std.sun3"
111.17Satatat
121.17Satatat#options 	INCLUDE_CONFIG_FILE	# embed config file in kernel binary
131.6Sabs
141.14Slukemmakeoptions	COPTS="-Os"	# Optimise for space. Implies -O2
151.1Sgwr
161.1Sgwr# Machines to be supported by this kernel
171.1Sgwroptions 	FPU_EMULATE
181.14Slukemoptions 	HAVECACHE	# Sun3/260 VAC
191.1Sgwr
201.1Sgwr# Needs to be set per system.  i.e change these as you see fit
211.1Sgwrmaxusers	2
221.1Sgwr
231.1Sgwr# Standard system options
241.1Sgwr#options 	KTRACE		# system call tracing
251.1Sgwr#options 	SYSVMSG		# System V message queues
261.1Sgwr#options 	SYSVSEM		# System V semaphores
271.1Sgwr#options 	SYSVSHM		# System V shared memory
281.1Sgwr#options 	INSECURE	# disable kernel security level
291.19Slukemoptions 	USERCONF	# userconf(4) support
301.40Stsutsuioptions 	PIPE_SOCKETPAIR		# smaller, but slower pipe(2)
311.23Satatat#options 	SYSCTL_INCLUDE_DESCR	# Include sysctl descriptions in kernel
321.1Sgwr
331.1Sgwr# Which kernel debugger?  Uncomment either this:
341.1Sgwr#options 	DDB
351.1Sgwr# ... or these for KGDB (gdb remote target)
361.14Slukem#makeoptions	DEBUG="-g"	# debugging symbols for gdb
371.1Sgwr#options 	KGDB
381.13Slukem#options 	KGDB_DEV=0x0C01	# ttya=0C00 ttyb=0C01
391.1Sgwr
401.1Sgwr# Other debugging options
411.1Sgwr#options 	DDB_HISTORY_SIZE=100	# enable history editing in DDB
421.1Sgwr#options 	DEBUG		# kernel debugging code
431.1Sgwr#options 	DIAGNOSTIC	# extra kernel sanity checking
441.1Sgwr#options 	KMEMSTATS	# kernel memory statistics (vmstat -m)
451.1Sgwr#options 	PMAP_DEBUG
461.1Sgwr#options 	SCSIDEBUG
471.1Sgwr#options 	SCSIVERBOSE		# Verbose SCSI errors
481.1Sgwr
491.11Swiz# Compatibility options
501.1Sgwr#options 	COMPAT_SUNOS	# can run SunOS 4.1.1 executables
511.1Sgwr#options 	COMPAT_43	# and 4.3BSD and ...
521.1Sgwr#options 	COMPAT_10	# NetBSD 1.0
531.1Sgwr#options 	COMPAT_11	# NetBSD 1.1
541.3Sgwr#options 	COMPAT_12	# NetBSD 1.2
551.1Sgwroptions 	COMPAT_13	# NetBSD 1.3
561.4Saugustssoptions 	COMPAT_14	# NetBSD 1.4
571.37Smanuoptions 	COMPAT_15	# NetBSD 1.5
581.22Scloptions 	COMPAT_16	# NetBSD 1.6
591.25Stsutsuioptions 	COMPAT_20	# NetBSD 2.0
601.40Stsutsuioptions 	COMPAT_30	# NetBSD 3.0
611.44Stsutsuioptions 	COMPAT_40	# NetBSD 4.0
621.44Stsutsuioptions 	COMPAT_50	# NetBSD 5.0 compatibility.
631.3Sgwr#options 	COMPAT_LINUX	# can run Linux/m68k executables
641.12Sabs#options 	TCP_COMPAT_42	# 4.2BSD TCP/IP bug compat. Not recommended.
651.40Stsutsuioptions 	COMPAT_BSDPTY	# /dev/[pt]ty?? ptys.
661.1Sgwr
671.7Sabs# File systems
681.1Sgwrfile-system	FFS		# Berkeley Fast Filesystem
691.1Sgwrfile-system	NFS		# Sun NFS client support
701.1Sgwrfile-system	CD9660		# ISO 9660 + Rock Ridge file system
711.1Sgwr#file-system	FDESC		# /dev/fd/*
721.1Sgwrfile-system	KERNFS		# /kern
731.1Sgwr#file-system	NULLFS		# loopback file system
741.1Sgwr#file-system	PROCFS		# /proc
751.1Sgwr#file-system	UNION		# union file system
761.3Sgwr#file-system	MFS		# memory-based filesystem
771.30Schristos#file-system	PTYFS		# /dev/pts/N support
781.1Sgwr
791.7Sabs# Filesystem options
801.1Sgwr#options 	NFSSERVER	# nfs server support
811.48Sbouyer#options 	QUOTA		# legacy UFS quotas
821.48Sbouyer#options 	QUOTA2		# new, in-filesystem UFS quotas
831.49Swiz#options 	FFS_EI		# FFS Endian Independent support
841.39Syamt#options 	NFS_V2_ONLY	# Exclude NFS3 code to save space
851.32Stsutsuioptions 	FFS_NO_SNAPSHOT	# No FFS snapshot support
861.51Sdhollandoptions 	WAPBL		# File system journaling support
871.1Sgwr
881.1Sgwr# Networking options
891.31Sisakioptions 	INET		# IP protocol stack support
901.1Sgwr#options 	GATEWAY		# IP packet forwarding
911.1Sgwr#options 	ISO,TPIP	# OSI networking
921.1Sgwr#options 	EON		# OSI tunneling over IP
931.1Sgwr#options 	PFIL_HOOKS	# pfil(9) packet filter hooks.
941.12Sabs#options 	TCP_DEBUG	# Record last TCP_NDEBUG packets with SO_DEBUG
951.1Sgwr
961.1Sgwr# Work-around for root on slow servers (insurance...)
971.1Sgwroptions 	NFS_BOOT_RWSIZE=1024
981.1Sgwroptions 	NFS_BOOT_BOOTPARAM
991.1Sgwr
1001.1Sgwrconfig		netbsd root on ? type ?
1011.1Sgwr
1021.1Sgwr# On-board I/O space (required)
1031.1Sgwrinclude "arch/sun3/conf/obio.sun3"
1041.1Sgwr
1051.1Sgwr# On-board memory (optional)
1061.1Sgwr# See frame-buffers
1071.1Sgwr# obmem0 at mainbus?
1081.1Sgwr
1091.1Sgwr# VME bus support (optional)
1101.1Sgwr# One unit for each address space
1111.1Sgwrvme0 at mainbus? # A16/D16
1121.1Sgwrvme1 at mainbus? # A16/D32
1131.1Sgwrvme2 at mainbus? # A24/D16
1141.1Sgwrvme3 at mainbus? # A24/D32
1151.1Sgwrvme4 at mainbus? # A32/D16
1161.1Sgwrvme5 at mainbus? # A32/D32
1171.1Sgwr
1181.1Sgwr#
1191.1Sgwr# Serial ports
1201.1Sgwr#
1211.1Sgwrzstty0	at zsc1 channel 0	# ttya
1221.1Sgwrzstty1	at zsc1 channel 1	# ttyb
1231.1Sgwr
1241.1Sgwrkbd0	at zsc0 channel 0	# keyboard
1251.1Sgwr#ms0	at zsc0 channel 1	# mouse
1261.1Sgwr
1271.1Sgwr#
1281.1Sgwr# Network devices
1291.1Sgwr#
1301.1Sgwr
1311.1Sgwr# Intel Ethernet (onboard, or VME)
1321.1Sgwrie0 at obio0 addr 0x0C0000 ipl 3
1331.14Slukemie1 at vme2 addr 0xe88000 ipl 3 vect 0x75
1341.1Sgwr
1351.1Sgwr# Lance Ethernet (only onboard)
1361.1Sgwrle0 at obio0 addr 0x120000 ipl 3
1371.1Sgwr
1381.1Sgwr# All Sun3 machines with an "le" (3/50, 3/60) should be
1391.1Sgwr# presumed to have the old, buggy LANCE chip. (Rev. C)
1401.1Sgwroptions 	LANCE_REVC_BUG
1411.1Sgwr
1421.1Sgwr#
1431.1Sgwr# Disk and tape devices
1441.1Sgwr#
1451.1Sgwr
1461.1Sgwr# Sun3 "si" SCSI controller (NCR 5380)
1471.1Sgwr# See GENERIC for the flags description.
1481.1Sgwrsi0 at obio0 addr 0x140000 ipl 2
1491.14Slukemsi0 at vme2 addr 0x200000 ipl 2 vect 0x40
1501.14Slukemsi1 at vme2 addr 0x204000 ipl 2 vect 0x41
1511.1Sgwr
1521.1Sgwr# Xylogics 450/451 controllers (VME A16/D16)
1531.1Sgwrxyc0 at vme0 addr 0xee40 ipl 2 vect 0x48
1541.1Sgwrxyc1 at vme0 addr 0xee48 ipl 2 vect 0x49
1551.1Sgwrxy* at xyc? drive ?
1561.1Sgwr
1571.1Sgwr# Xylogics 7053 controllers (VME A16/D32)
1581.1Sgwrxdc0 at vme1 addr 0xee80 ipl 2 vect 0x44
1591.1Sgwrxdc1 at vme1 addr 0xee90 ipl 2 vect 0x45
1601.1Sgwrxd* at xdc? drive ?
1611.1Sgwr
1621.1Sgwr# Xylogics 472 tape controllers?
1631.1Sgwr
1641.1Sgwr# Sun3/E SCSI+Ethernet board (VME A24/D16)
1651.1Sgwr# Note: the board uses vect and vect+1
1661.1Sgwrsebuf0 at vme2 addr 0x300000 ipl 2 vect 0x74 # and 0x75
1671.1Sgwrsebuf1 at vme2 addr 0x340000 ipl 2 vect 0x76 # and 0x77
1681.1Sgwrsi* at sebuf?
1691.1Sgwrie* at sebuf?
1701.1Sgwr
1711.1Sgwr#
1721.1Sgwr# Frame buffer devices
1731.1Sgwr# (Not needed for installation kernels.)
1741.1Sgwr
1751.1Sgwr#
1761.1Sgwr# SCSI infrastructure
1771.1Sgwr#
1781.1Sgwrscsibus* at scsi?
1791.1Sgwr
1801.1Sgwrsd* at scsibus? target ? lun ?		# SCSI disks
1811.1Sgwrst* at scsibus? target ? lun ?		# SCSI tapes
1821.1Sgwrcd* at scsibus? target ? lun ?		# SCSI CD-ROMs
1831.1Sgwr#ch* at scsibus? target ? lun ?		# SCSI changer devices
1841.1Sgwr#ss* at scsibus? target ? lun ?		# SCSI scanners
1851.1Sgwr#uk* at scsibus? target ? lun ?		# unknown SCSI devices
1861.1Sgwr
1871.1Sgwr# Memory-disk drivers
1881.47Shannken#pseudo-device	md		
1891.1Sgwr
1901.1Sgwr# Misc.
1911.1Sgwrpseudo-device	loop		1	# network loopback
1921.34Srpaulo#pseudo-device	bpfilter		# packet filter
1931.35Scubepseudo-device	sl			# CSLIP
1941.35Scubepseudo-device	ppp			# PPP
1951.35Scubepseudo-device	tun			# network tunneling over tty
1961.35Scube#pseudo-device	gre			# generic L3 over IP tunnel
1971.1Sgwr#pseudo-device	ipfilter		# ip filter
1981.1Sgwr
1991.8Sabspseudo-device	pty		2	# pseudo-terminals (Sysinst needs two)
2001.35Scube#pseudo-device	vnd			# paging to files
2011.1Sgwr#pseudo-device	ccd		4	# concatenated disks
2021.46Spooka#pseudo-device	fss			# file system snapshot device
203