INSTALL revision 1.24
11.24Sminoura#	$NetBSD: INSTALL,v 1.24 2000/04/16 14:17:59 minoura Exp $
21.1Soki
31.1Soki#
41.7Sminoura#	INSTALL -- installation kernel.
51.1Soki#
61.1Soki
71.7Sminourainclude "arch/x68k/conf/std.x68k"
81.1Soki
91.24Sminoura#ident 		"INSTALL-$Revision: 1.24 $"
101.23Sminoura
111.9Sminouramaxusers	8
121.1Soki
131.7Sminoura## Enable the hooks used for initializing the memory-disk.
141.7Sminouraoptions 	MEMORY_DISK_HOOKS
151.7Sminouraoptions 	MEMORY_DISK_IS_ROOT     # Force root on memory-disk
161.7Sminouraoptions 	MEMORY_DISK_SERVER=0	# No user space hooks
171.22Sminoura#options 	MINIROOTSIZE=2400	# 1.2M, same as a 130mm floppy
181.22Sminouraoptions 	MINIROOTSIZE=2880	# 1.44M, same as a 90mm floppy
191.19Sminoura#options 	MINIROOTSIZE=2048
201.7Sminoura
211.7Sminoura## System kernel configuration.  See options(4) for more detail.
221.7Sminoura
231.7Sminoura
241.7Sminoura## Options for variants of the m68k MPU
251.7Sminoura## you must have at least the correct one; REQUIRED
261.1Sokioptions 	M68030
271.1Sokioptions 	M68040
281.1Sokioptions 	M68060
291.1Soki
301.1Soki
311.7Sminoura#### System options specific to the x68k port
321.1Soki
331.22Sminouraoptions 	EXTENDED_MEMORY		# support for >16MB memory
341.7Sminouraoptions 	FPU_EMULATE		# software fpu emulation for MC68030
351.7Sminouraoptions 	FPSP			# floating point emulation for MC68040
361.1Sokioptions 	M060SP			# int/fp emulation for MC68060
371.7Sminouraoptions 	JUPITER			# support for "Jupiter-X" accelerator
381.12Sminoura#options 	MAPPEDCOPY		# use page mapping for large copyin/copyout
391.9Sminoura#options 	ZSCONSOLE,ZSCN_SPEED="9600"	# use serial console
401.7Sminoura
411.1Soki
421.7Sminoura#### System options that are the same for all ports
431.1Soki
441.7Sminoura## Root device configuration: change the ?'s if you are going to use a
451.7Sminoura## nonstandard root partition (other than where the kernel is booted from)
461.7Sminoura## and/or nonstandard root type (not ffs or nfs).  Normally this can be
471.7Sminoura## automagically determined at boot time.
481.1Soki
491.7Sminouraconfig		netbsd	root on ? type ?
501.10Sminoura#config		netbsd	root on sd0 type ffs
511.7Sminoura
521.7Sminoura## RTC is offset from GMT; -540 means JST-9
531.7Sminouraoptions 	RTC_OFFSET=-540	# hardware clock is this many mins. west of GMT
541.7Sminoura
551.7Sminoura## System call tracing (see ktrace(1)).
561.7Sminoura#options 	KTRACE
571.7Sminoura
581.7Sminoura## Collect statistics on kernel malloc's and free's.  This does have a
591.7Sminoura## significant performance hit on slower machines, so it is intended for
601.7Sminoura## diagnostic use only.
611.7Sminoura#options 	KMEMSTATS
621.7Sminoura
631.7Sminoura## System V compatible IPC subsystem.  (msgctl(2), semctl(2), and shmctl(2))
641.7Sminoura#options 	SYSVMSG		# System V message queues
651.7Sminoura#options 	SYSVSEM		# System V semaphores
661.7Sminoura#options 	SYSVSHM		# System V shared memory
671.7Sminoura#options 	SHMMAXPGS=1024	# 1024 pages is the default
681.7Sminoura
691.7Sminoura## Loadable kernel module support
701.7Sminoura#options 	LKM
711.7Sminoura
721.7Sminoura## NFS boot options; not supported currently: needs nfsboot program
731.7Sminoura#options 	NFS_BOOT_BOOTPARAM
741.7Sminoura#options 	NFS_BOOT_BOOTP
751.7Sminoura#options 	NFS_BOOT_DHCP
761.7Sminoura
771.7Sminoura#### Debugging options
781.7Sminoura
791.7Sminoura## The DDB in-kernel debugger runs at panic (unless DDB_ONPANIC=0), or at
801.7Sminoura## serial console break or keyboard reset, where the PROM would normally
811.7Sminoura## intercept.  DDB_HISTORY_SIZE adds up/down arrow command history.
821.7Sminoura#options 	DDB			# kernel dynamic debugger
831.7Sminoura#options 	DDB_HISTORY_SIZE=100	# enable history editing in DDB
841.7Sminoura#options 	DDB_ONPANIC=1		# see also sysctl(8): `ddb.onpanic'
851.7Sminoura#options 	PANICBUTTON		# interrupt switch invokes DDB
861.7Sminoura
871.7Sminoura## You may also use gdb, on another computer connected to this machine over
881.7Sminoura## a serial port.  Both KGDBDEV and KGDBRATE should be specified; KGDBDEV is
891.7Sminoura## a dev_t encoded device number of the serial port to use.
901.7Sminoura## KGDB is not supported for now.
911.7Sminoura#options 	KGDB		# support for kernel gdb
921.7Sminoura#options 	KGDBDEV=0xc00	# kgdb device number
931.7Sminoura#options 	KGDBRATE=9600	# baud rate
941.7Sminoura
951.7Sminoura## Compile the kernel with debugging symbols (`netbsd.gdb' is the debug file),
961.7Sminoura## such that gdb(1) can be used on a kernel coredump.
971.7Sminoura
981.7Sminoura#makeoptions 	DEBUG="-g"
991.19Sminouramakeoptions	COPTS="-Os"
1001.7Sminoura
1011.7Sminoura## Adds code to the kernel that does internal consistency checks, and will
1021.7Sminoura## cause the kernel to panic if corruption of internal data structures
1031.7Sminoura## is detected.
1041.7Sminoura#options 	DIAGNOSTIC	# extra kernel sanity checking
1051.7Sminoura
1061.7Sminoura## Enable (possibly expensive) debugging code that may also display messages
1071.7Sminoura## on the system console
1081.7Sminoura#options 	DEBUG
1091.7Sminoura
1101.7Sminoura## Make SCSI error messages more verbose when explaining their meanings.
1111.7Sminoura#options 	SCSIVERBOSE
1121.7Sminoura
1131.7Sminoura## `INSECURE' turns off the kernel security level (securelevel = 0 always).
1141.7Sminoura## This allows writing to /dev/mem, loading kernel modules while multi-user,
1151.7Sminoura## and other insecurities good only for development work.  Do not use this
1161.7Sminoura## option on a production machine.
1171.7Sminoura#options 	INSECURE
1181.7Sminoura
1191.7Sminoura## Allow non-root users to grab /dev/console with programs such as xconsole.
1201.7Sminoura## `xconsole' therefore does not need setuid root with this option enabled.
1211.7Sminoura#options 	UCONSOLE
1221.7Sminoura
1231.7Sminoura## `FDSCRIPTS' allows non-readable but executable scripts by providing a
1241.7Sminoura## pre-opened opaque file to the script interpreter.  `SETUIDSCRIPTS',
1251.7Sminoura## which implies FDSCRIPTS, allows scripts to be set-user-id using the same
1261.7Sminoura## opaque file mechanism.  Perl calls this "secure setuid scripts."
1271.7Sminoura
1281.7Sminoura#options 	FDSCRIPTS
1291.7Sminoura#options 	SETUIDSCRIPTS
1301.7Sminoura
1311.7Sminoura## Options for compatibility with previous releases foreign system binaries.
1321.7Sminoura
1331.13Sminoura#options 	COMPAT_43	# 4.3BSD system interfaces
1341.7Sminoura#options 	COMPAT_09	# NetBSD 0.9 binary compatibility
1351.7Sminoura#options 	COMPAT_10	# NetBSD 1.0 binary compatibility
1361.7Sminoura#options 	COMPAT_11	# NetBSD 1.1 binary compatibility
1371.7Sminoura#options 	COMPAT_12	# NetBSD 1.2 binary compatibility
1381.7Sminoura#options 	COMPAT_13	# NetBSD 1.3 binary compatibility
1391.18Sminoura#options 	COMPAT_14	# NetBSD 1.4 binary compatibility
1401.7Sminoura#options 	COMPAT_M68K4K	# NetBSD/m68k4k binaries
1411.7Sminoura#options 	COMPAT_SUNOS	# SunOS 4.x binary compatibility; broken
1421.16Sminoura#options 	COMPAT_SVR4	# SVR4 binary compatibility; broken
1431.10Sminoura#options 	COMPAT_LINUX	# Linux/m68k binary compatibility
1441.16Sminoura#options 	EXEC_ELF32	# 32-bit ELF executables (Linux, SVR4)
1451.7Sminoura
1461.7Sminoura## File systems.
1471.7Sminourafile-system	FFS		# Berkeley Fast Filesystem
1481.7Sminourafile-system	NFS		# Sun NFS-compatible filesystem client
1491.7Sminourafile-system	KERNFS		# kernel data-structure filesystem
1501.16Sminoura#file-system	NULLFS		# NULL layered filesystem (buggy)
1511.23Sminoura#file-system 	OVERLAY		# overlay file system
1521.14Sminoura#file-system	MFS		# memory-based filesystem
1531.7Sminoura#file-system	FDESC		# user file descriptor filesystem
1541.7Sminoura#file-system	UMAPFS		# uid/gid remapping filesystem
1551.16Sminoura#file-system	LFS		# Log-structured filesystem (experimental)
1561.16Sminoura#file-system	PORTAL		# portal filesystem (experimental)
1571.13Sminoura#file-system	PROCFS		# /proc
1581.7Sminourafile-system	CD9660		# ISO 9660 + Rock Ridge file system
1591.16Sminoura#file-system	UNION		# union file system (a little buggy)
1601.7Sminourafile-system	MSDOSFS		# MS-DOS FAT filesystem(s).
1611.7Sminoura#file-system 	ADOSFS		# AmigaDOS filesystem
1621.7Sminoura
1631.7Sminoura## File system options.
1641.7Sminoura#options 	NFSSERVER	# Sun NFS-compatible filesystem server
1651.7Sminoura#options 	QUOTA		# FFS quotas
1661.7Sminoura#options 	FFS_EI		# FFS Endian Independent support
1671.20Sminoura#options 	SOFTDEP         # FFS soft updates support.
1681.7Sminoura
1691.22Sminoura# Pull in config fragments for kernel crypto.  This is required for
1701.22Sminoura# options IPSEC etc. to work. If you want to run with IPSEC, uncomment
1711.22Sminoura# one of these, based on whether you use crypto-us or crypto-intl, and
1721.22Sminoura# adjust the prefixes as necessary.
1731.22Sminoura
1741.22Sminoura#prefix ../crypto-us/sys
1751.22Sminoura#cinclude "conf/files.crypto-us"
1761.22Sminoura#prefix
1771.22Sminoura
1781.22Sminoura#prefix ../crypto-intl/sys
1791.22Sminoura#cinclude "conf/files.crypto-intl"
1801.22Sminoura#prefix
1811.22Sminoura
1821.7Sminoura## Network protocol support.  In most environments, INET is required.
1831.7Sminouraoptions 	INET		# IP (Internet Protocol) v4
1841.22Sminoura#options 	INET6		# IPV6
1851.22Sminoura#options 	IPSEC		# IP security
1861.22Sminoura#options 	IPSEC_ESP	# IP security (encryption part; define w/IPSEC)
1871.22Sminoura#options 	IPSEC_DEBUG	# debug for IP security
1881.7Sminouraoptions 	TCP_COMPAT_42	# 4.2BSD IP implementation compatibility
1891.7Sminoura#options 	GATEWAY		# packet forwarding ("router switch")
1901.7Sminoura#options 	MROUTING	# packet forwarding of multicast packets
1911.7Sminoura#options 	DIRECTED_BROADCAST	# allow broadcasts through routers
1921.7Sminoura#options 	NS		# Xerox NS networking
1931.7Sminoura#options 	NSIP		# Xerox NS tunneling over IP
1941.7Sminoura#options 	ISO,TPIP	# OSI networking
1951.7Sminoura#options 	EON		# OSI tunneling over IP
1961.7Sminoura#options 	CCITT,LLC,HDLC	# X.25 packet switched protocol
1971.7Sminoura#options 	NETATALK	# AppleTalk (over Ethernet) protocol
1981.7Sminoura#options 	NTP		# Network Time Protocol in-kernel support
1991.7Sminoura#options 	PPS_SYNC	# Add serial line synchronization for NTP
2001.7Sminoura#options 	PFIL_HOOKS	# Add pfil(9) hooks, intended for custom LKMs.
2011.7Sminoura#options 	IPFILTER_LOG	# Add ipmon(8) logging for ipfilter device
2021.7Sminoura#options 	PPP_BSDCOMP	# Add BSD compression to ppp device
2031.7Sminoura#options 	PPP_DEFLATE	# Add deflate (libz) compression to ppp device
2041.7Sminoura#options 	PPP_FILTER	# Add active filters for ppp (via bpf)
2051.7Sminoura
2061.7Sminoura
2071.7Sminoura
2081.7Sminoura#### Device configurations
2091.7Sminoura
2101.9Sminoura## Fundamental devices; see also std.x68k
2111.9Sminouradmac0	at intio0 addr 0xe84000		# DMA controler
2121.9Sminouraxel0	at intio0
2131.9Sminouraopm0	at intio0 addr 0xe90000		# OPM: required for fdc
2141.7Sminoura
2151.7Sminoura## Display devices and console
2161.7Sminouragrfbus0	at mainbus0			# bitmapped displays
2171.7Sminouragrf0	at grfbus0			# multiplane graphics
2181.7Sminoura#grf1	at grfbus0			# flexible graphics
2191.7Sminoura
2201.9Sminourakbd0	at mfp0				# standard keyboard
2211.7Sminouraite0	at grf0				# internal terminal emulator
2221.16Sminouraoptions 	ITE_KERNEL_ATTR=4	# bold for kernel messages
2231.9Sminoura					# see /sys/arch/x68k/dev/itevar.h
2241.12Sminoura#pseudo-device	pow		2	# software power switch
2251.7Sminoura
2261.7Sminoura## floppy disks
2271.9Sminourafdc0	at intio0 addr 0xe94000 intr 96 dma 0 dmaintr 100 # floppy controler
2281.7Sminourafd*	at fdc0 unit ?			# builtin floppy drives
2291.7Sminoura
2301.7Sminoura## SCSI devices
2311.9Sminourascsirom0 at intio0				# SCSI BIOS
2321.9Sminourascsirom1 at intio0				# SCSI BIOS
2331.9Sminouraspc*	at scsirom?				# genuin SCSI
2341.7Sminourascsibus* at spc?
2351.9Sminouramha0	at scsirom?				# Mankai MK-HA1 (Mach-2)
2361.7Sminourascsibus* at mha0
2371.1Soki
2381.1Sokisd*	at scsibus? target ? lun ?	# SCSI disks
2391.1Sokicd*	at scsibus? target ? lun ?	# SCSI CD-ROMs
2401.7Sminourast*	at scsibus? target ? lun ?	# SCSI tapes
2411.7Sminoura#ss*	at scsibus? target ? lun ?	# SCSI scanners
2421.7Sminoura#ch*	at scsibus? target ? lun ?	# SCSI changer devices
2431.7Sminoura#uk*	at scsibus? target ? lun ?	# SCSI unknown devices
2441.7Sminoura
2451.24Sminoura## Ports
2461.9Sminourazsc0	at intio0 addr 0xe98000 intr 112
2471.7Sminourazstty0	at zsc0 channel 0		# built-in RS-232C
2481.7Sminoura#ms0	at zsc0 channel 1		# standard mouse
2491.9Sminoura#zsc1	at intio0 addr 0xeafc00 intr 113
2501.7Sminoura#zstty2	at zsc1 channel 0
2511.7Sminoura#zstty3	at zsc1 channel 1
2521.9Sminoura#zsc2	at intio0 addr 0xeafc10 intr 114
2531.7Sminoura#zstty4	at zsc2 channel 0
2541.7Sminoura#zstty5	at zsc2 channel 1
2551.24Sminoura#par0	at intio0 addr 0xe8c000 	# Builtin printer port
2561.7Sminoura
2571.13Sminoura#pseudo-device	sram			# battery-backuped static RAM
2581.13Sminoura#pseudo-device	bell			# OPM bell
2591.9Sminoura
2601.7Sminoura#xcom0	at mainbus0			# NS16550 fast serial
2611.7Sminoura#xcom1	at mainbus0
2621.15Sminoura
2631.7Sminoura## Audio device; broken
2641.9Sminoura#okiadpcm0 at intio0 addr 0xe92000 intr 106 errintr 107 dma 3
2651.7Sminoura#audio*	at okiadpcm*
2661.7Sminoura
2671.7Sminoura## Network interfaces
2681.9Sminouraneptune0 at intio0 addr 0xece000 intr 249	# Neptune-X
2691.9Sminouraneptune1 at intio0 addr 0xece400 intr 249	# Neptune-X at alt. addr.
2701.9Sminourane0	at neptune? addr 0x300			# NE2000 or clone
2711.10Sminoura#se0	at scsibus? target ? lun ?		# Ether+; broken
2721.7Sminoura
2731.7Sminoura
2741.7Sminoura#### Pseudo devices
2751.7Sminoura
2761.7Sminoura## A disk-like interface to files.  Can be used to create floppy, CD,
2771.7Sminoura## miniroot images, etc.
2781.7Sminoura
2791.12Sminoura#pseudo-device	vnd	4
2801.7Sminoura
2811.7Sminoura## Concatenated and striped disks; with this, you can create a software-based
2821.7Sminoura## disk array similar to a "RAID 0" setup.  See ccd(4).
2831.7Sminoura
2841.22Sminourapseudo-device	ccd	4
2851.9Sminoura
2861.9Sminoura## RAIDframe disk driver: software RAID driver.  See raid(4).
2871.9Sminoura
2881.9Sminoura#pseudo-device	raid	4
2891.24Sminoura#options 	RAID_AUTOCONFIG		# auto-configuration of RAID components
2901.7Sminoura
2911.7Sminoura## Memory disk device, used on boot floppies with compressed
2921.7Sminoura## kernel-plus-root-disk images.
2931.7Sminoura
2941.7Sminourapseudo-device	md	1
2951.7Sminoura
2961.7Sminoura## Loopback network interface; required
2971.7Sminourapseudo-device	loop
2981.7Sminoura
2991.7Sminoura## SLIP and CSLIP interfaces, for IP over a serial line.
3001.7Sminourapseudo-device	sl		1
3011.7Sminoura
3021.7Sminoura## PPP, the successor to SLIP.  See pppd(8).
3031.13Sminoura#pseudo-device	ppp		1
3041.7Sminoura
3051.7Sminoura## Network "tunnel" device, allowing protocol stacks to run in the userland.
3061.7Sminoura## This is used by the third-party user-mode "ppp" program, and others.
3071.7Sminoura#pseudo-device	tun		4
3081.9Sminoura
3091.9Sminoura## Generic L3 over IP tunnel
3101.9Sminoura#pseudo-device	gre		2	# generic L3 over IP tunnel
3111.7Sminoura
3121.7Sminoura## Berkeley Packet Filter, required to run RARPD.  A generic C-language
3131.7Sminoura## interface that allows selective examining of incoming packets.
3141.7Sminoura#pseudo-device	bpfilter	8
3151.7Sminoura
3161.7Sminoura## IP Filter, used in firewall and NAT applications.  See ipnat(8) for
3171.7Sminoura## one example of the use of the IP Filter.
3181.7Sminoura#pseudo-device	ipfilter
3191.7Sminoura
3201.22Sminoura## for IPv6
3211.22Sminoura#pseudo-device	gif		4	# IPv[46] over IPv[46] tunnel (RFC1933)
3221.22Sminoura#pseudo-device	faith		1	# IPv[46] tcp relay translation i/f
3231.7Sminoura
3241.7Sminoura#### Other device configuration
3251.7Sminoura
3261.7Sminoura## Pseudo ttys, required for network logins and programs like screen.
3271.7Sminoura## 32 is a good number for average systems; you may have as many as you
3281.7Sminoura## like, though 256 is more or less the upper limit.  Increasing this
3291.7Sminoura## number still requires you to run /dev/MAKEDEV to create the files
3301.7Sminoura## for the ptys.
3311.16Sminoura
3321.22Sminourapseudo-device	pty		8	# pseudo-ttys (for network, etc.)
3331.7Sminoura
3341.7Sminoura## Random device, used to implement /dev/random (a source of random noise),
3351.7Sminoura## and generate randomness for some kernel formulae.
3361.16Sminoura
3371.7Sminoura#pseudo-device	rnd
338