11.122Sisaki#	$NetBSD: INSTALL,v 1.122 2024/01/07 07:58:33 isaki Exp $
21.1Soki
31.1Soki#
41.7Sminoura#	INSTALL -- installation kernel.
51.1Soki#
61.1Soki
71.7Sminourainclude "arch/x68k/conf/std.x68k"
81.1Soki
91.51Satatat#options 	INCLUDE_CONFIG_FILE	# embed config file in kernel binary
101.51Satatat
111.122Sisaki#ident 		"INSTALL-$Revision: 1.122 $"
121.33Sabs
131.121Stsutsuimakeoptions	COPTS="-Os -fno-unwind-tables" # Optimise for space. Implies -O2
141.23Sminoura
151.28Sminouramaxusers	4
161.1Soki
171.7Sminoura## Enable the hooks used for initializing the memory-disk.
181.7Sminouraoptions 	MEMORY_DISK_HOOKS
191.42Slukemoptions 	MEMORY_DISK_IS_ROOT	# Force root on memory-disk
201.7Sminouraoptions 	MEMORY_DISK_SERVER=0	# No user space hooks
211.119Srinoptions 	MEMORY_DISK_ROOT_SIZE=3600	# size of memory disk, in blocks
221.86Sjymoptions 	MEMORY_DISK_RBFLAGS=RB_SINGLE	# boot in single-user mode
231.7Sminoura
241.7Sminoura## System kernel configuration.  See options(4) for more detail.
251.7Sminoura
261.7Sminoura
271.7Sminoura## Options for variants of the m68k MPU
281.7Sminoura## you must have at least the correct one; REQUIRED
291.1Sokioptions 	M68030
301.1Sokioptions 	M68040
311.1Sokioptions 	M68060
321.37Sminoura## If you want an optimized kernel for a specific processor, use either:
331.37Sminoura#makeoptions	CMACHFLAGS="-m68030"
341.37Sminoura#makeoptions	CMACHFLAGS="-m68040 -Wa,-m68030 -Wa,-m68851"
351.37Sminoura#makeoptions	CMACHFLAGS="-m68060 -Wa,-m68030 -Wa,-m68851"
361.1Soki
371.1Soki
381.7Sminoura#### System options specific to the x68k port
391.1Soki
401.22Sminouraoptions 	EXTENDED_MEMORY		# support for >16MB memory
411.7Sminouraoptions 	FPU_EMULATE		# software fpu emulation for MC68030
421.7Sminouraoptions 	FPSP			# floating point emulation for MC68040
431.1Sokioptions 	M060SP			# int/fp emulation for MC68060
441.38Sminoura#options 	JUPITER			# support for "Jupiter-X" accelerator
451.9Sminoura#options 	ZSCONSOLE,ZSCN_SPEED="9600"	# use serial console
461.7Sminoura
471.1Soki
481.7Sminoura#### System options that are the same for all ports
491.1Soki
501.7Sminoura## Root device configuration: change the ?'s if you are going to use a
511.7Sminoura## nonstandard root partition (other than where the kernel is booted from)
521.7Sminoura## and/or nonstandard root type (not ffs or nfs).  Normally this can be
531.7Sminoura## automagically determined at boot time.
541.1Soki
551.7Sminouraconfig		netbsd	root on ? type ?
561.10Sminoura#config		netbsd	root on sd0 type ffs
571.7Sminoura
581.7Sminoura## RTC is offset from GMT; -540 means JST-9
591.7Sminouraoptions 	RTC_OFFSET=-540	# hardware clock is this many mins. west of GMT
601.7Sminoura
611.7Sminoura## System call tracing (see ktrace(1)).
621.7Sminoura#options 	KTRACE
631.7Sminoura
641.7Sminoura## System V compatible IPC subsystem.  (msgctl(2), semctl(2), and shmctl(2))
651.7Sminoura#options 	SYSVMSG		# System V message queues
661.7Sminoura#options 	SYSVSEM		# System V semaphores
671.7Sminoura#options 	SYSVSHM		# System V shared memory
681.7Sminoura
691.7Sminoura## Loadable kernel module support
701.47Sjdolecek
711.53Slukemoptions 	USERCONF		# userconf(4) support
721.77Sisakioptions 	PIPE_SOCKETPAIR		# smaller, but slower pipe(2)
731.58Satatat#options 	SYSCTL_INCLUDE_DESCR	# Include sysctl descriptions in kernel
741.7Sminoura
751.7Sminoura## NFS boot options; not supported currently: needs nfsboot program
761.7Sminoura#options 	NFS_BOOT_BOOTPARAM
771.7Sminoura#options 	NFS_BOOT_BOOTP
781.7Sminoura#options 	NFS_BOOT_DHCP
791.7Sminoura
801.7Sminoura#### Debugging options
811.7Sminoura
821.7Sminoura## The DDB in-kernel debugger runs at panic (unless DDB_ONPANIC=0), or at
831.7Sminoura## serial console break or keyboard reset, where the PROM would normally
841.7Sminoura## intercept.  DDB_HISTORY_SIZE adds up/down arrow command history.
851.7Sminoura#options 	DDB			# kernel dynamic debugger
861.7Sminoura#options 	DDB_HISTORY_SIZE=100	# enable history editing in DDB
871.105Sszptvlfn#options 	DDB_ONPANIC=1		# see also sysctl(7): `ddb.onpanic'
881.7Sminoura#options 	PANICBUTTON		# interrupt switch invokes DDB
891.7Sminoura
901.7Sminoura## You may also use gdb, on another computer connected to this machine over
911.41Slukem## a serial port.  Both KGDB_DEV and KGDB_DEVRATE should be specified;
921.41Slukem## KGDB_DEV is a dev_t encoded device number of the serial port to use.
931.7Sminoura## KGDB is not supported for now.
941.41Slukem#options 	KGDB			# support for kernel gdb
951.41Slukem#options 	KGDB_DEV=0xc00		# kgdb device number
961.41Slukem#options 	KGDB_DEVRATE=9600	# baud rate
971.7Sminoura
981.7Sminoura## Compile the kernel with debugging symbols (`netbsd.gdb' is the debug file),
991.7Sminoura## such that gdb(1) can be used on a kernel coredump.
1001.7Sminoura
1011.42Slukem#makeoptions	DEBUG="-g"
1021.7Sminoura
1031.7Sminoura## Adds code to the kernel that does internal consistency checks, and will
1041.7Sminoura## cause the kernel to panic if corruption of internal data structures
1051.7Sminoura## is detected.
1061.7Sminoura#options 	DIAGNOSTIC	# extra kernel sanity checking
1071.7Sminoura
1081.7Sminoura## Enable (possibly expensive) debugging code that may also display messages
1091.7Sminoura## on the system console
1101.7Sminoura#options 	DEBUG
1111.7Sminoura
1121.7Sminoura## Make SCSI error messages more verbose when explaining their meanings.
1131.7Sminoura#options 	SCSIVERBOSE
1141.7Sminoura
1151.7Sminoura## `INSECURE' turns off the kernel security level (securelevel = 0 always).
1161.7Sminoura## This allows writing to /dev/mem, loading kernel modules while multi-user,
1171.7Sminoura## and other insecurities good only for development work.  Do not use this
1181.7Sminoura## option on a production machine.
1191.7Sminoura#options 	INSECURE
1201.7Sminoura
1211.7Sminoura## `FDSCRIPTS' allows non-readable but executable scripts by providing a
1221.7Sminoura## pre-opened opaque file to the script interpreter.  `SETUIDSCRIPTS',
1231.7Sminoura## which implies FDSCRIPTS, allows scripts to be set-user-id using the same
1241.7Sminoura## opaque file mechanism.  Perl calls this "secure setuid scripts."
1251.7Sminoura
1261.7Sminoura#options 	FDSCRIPTS
1271.7Sminoura#options 	SETUIDSCRIPTS
1281.7Sminoura
1291.7Sminoura## Options for compatibility with previous releases foreign system binaries.
1301.7Sminoura
1311.114Smrginclude 	"conf/compat_netbsd30.config"
1321.114Smrg
1331.45Sminoura#options 	COMPAT_AOUT_M68K # compatibility with NetBSD/m68k a.out
1341.7Sminoura#options 	COMPAT_M68K4K	# NetBSD/m68k4k binaries
1351.7Sminoura#options 	COMPAT_SUNOS	# SunOS 4.x binary compatibility; broken
1361.10Sminoura#options 	COMPAT_LINUX	# Linux/m68k binary compatibility
1371.120Snia#options 	COMPAT_OSSAUDIO	# Linux/m68k binary compatibility
1381.7Sminoura
1391.44Sisaki## File systems.
1401.7Sminourafile-system	FFS		# Berkeley Fast Filesystem
1411.7Sminourafile-system	NFS		# Sun NFS-compatible filesystem client
1421.28Sminoura#file-system	KERNFS		# kernel data-structure filesystem
1431.104Sisaki#file-system	NULLFS		# NULL layered filesystem
1441.122Sisaki#file-system	OVERLAY		# overlay file system
1451.14Sminoura#file-system	MFS		# memory-based filesystem
1461.7Sminoura#file-system	FDESC		# user file descriptor filesystem
1471.7Sminoura#file-system	UMAPFS		# uid/gid remapping filesystem
1481.16Sminoura#file-system	LFS		# Log-structured filesystem (experimental)
1491.13Sminoura#file-system	PROCFS		# /proc
1501.7Sminourafile-system	CD9660		# ISO 9660 + Rock Ridge file system
1511.16Sminoura#file-system	UNION		# union file system (a little buggy)
1521.7Sminourafile-system	MSDOSFS		# MS-DOS FAT filesystem(s).
1531.122Sisaki#file-system	ADOSFS		# AmigaDOS filesystem
1541.70Schristos#file-system	PTYFS		# /dev/pts/N support
1551.7Sminoura
1561.44Sisaki## File system options.
1571.7Sminoura#options 	NFSSERVER	# Sun NFS-compatible filesystem server
1581.91Sbouyer#options 	QUOTA		# legacy UFS quotas
1591.91Sbouyer#options 	QUOTA2		# new, in-filesystem UFS quotas
1601.7Sminoura#options 	FFS_EI		# FFS Endian Independent support
1611.94Sdhollandoptions 	WAPBL		# File system journaling support
1621.76Syamt#options 	NFS_V2_ONLY	# Exclude NFS3 code to save space
1631.71Stsutsuioptions 	FFS_NO_SNAPSHOT	# No FFS snapshot support
1641.22Sminoura
1651.7Sminoura## Network protocol support.  In most environments, INET is required.
1661.7Sminouraoptions 	INET		# IP (Internet Protocol) v4
1671.26Sminouraoptions 	INET6		# IPV6
1681.22Sminoura#options 	IPSEC		# IP security
1691.22Sminoura#options 	IPSEC_DEBUG	# debug for IP security
1701.7Sminoura#options 	GATEWAY		# packet forwarding ("router switch")
1711.7Sminoura#options 	MROUTING	# packet forwarding of multicast packets
1721.59Smanu#options 	PIM		# Protocol Independent Multicast
1731.7Sminoura#options 	NETATALK	# AppleTalk (over Ethernet) protocol
1741.7Sminoura#options 	NTP		# Network Time Protocol in-kernel support
1751.7Sminoura#options 	PPS_SYNC	# Add serial line synchronization for NTP
1761.7Sminoura#options 	PPP_BSDCOMP	# Add BSD compression to ppp device
1771.7Sminoura#options 	PPP_DEFLATE	# Add deflate (libz) compression to ppp device
1781.7Sminoura#options 	PPP_FILTER	# Add active filters for ppp (via bpf)
1791.40Sabs#options 	TCP_DEBUG	# Record last TCP_NDEBUG packets with SO_DEBUG
1801.7Sminoura
1811.7Sminoura
1821.7Sminoura#### Device configurations
1831.7Sminoura
1841.9Sminoura## Fundamental devices; see also std.x68k
1851.57Swizdmac0	at intio0 addr 0xe84000		# DMA controller
1861.9Sminouraxel0	at intio0
1871.9Sminouraopm0	at intio0 addr 0xe90000		# OPM: required for fdc
1881.7Sminoura
1891.7Sminoura## Display devices and console
1901.7Sminouragrfbus0	at mainbus0			# bitmapped displays
1911.62Schsgrf0	at grfbus0 addr 0		# multiplane graphics
1921.62Schs#grf1	at grfbus0 addr 1		# flexible graphics
1931.7Sminoura
1941.9Sminourakbd0	at mfp0				# standard keyboard
1951.62Schsite0	at grf0 grfaddr 0		# internal terminal emulator
1961.16Sminouraoptions 	ITE_KERNEL_ATTR=4	# bold for kernel messages
1971.9Sminoura					# see /sys/arch/x68k/dev/itevar.h
1981.7Sminoura
1991.7Sminoura## floppy disks
2001.57Swizfdc0	at intio0 addr 0xe94000 intr 96 dma 0 dmaintr 100 # floppy controller
2011.7Sminourafd*	at fdc0 unit ?			# builtin floppy drives
2021.7Sminoura
2031.7Sminoura## SCSI devices
2041.9Sminourascsirom0 at intio0				# SCSI BIOS
2051.9Sminourascsirom1 at intio0				# SCSI BIOS
2061.9Sminouraspc*	at scsirom?				# genuin SCSI
2071.7Sminourascsibus* at spc?
2081.9Sminouramha0	at scsirom?				# Mankai MK-HA1 (Mach-2)
2091.7Sminourascsibus* at mha0
2101.1Soki
2111.1Sokisd*	at scsibus? target ? lun ?	# SCSI disks
2121.1Sokicd*	at scsibus? target ? lun ?	# SCSI CD-ROMs
2131.7Sminourast*	at scsibus? target ? lun ?	# SCSI tapes
2141.7Sminoura#ss*	at scsibus? target ? lun ?	# SCSI scanners
2151.7Sminoura#ch*	at scsibus? target ? lun ?	# SCSI changer devices
2161.7Sminoura#uk*	at scsibus? target ? lun ?	# SCSI unknown devices
2171.7Sminoura
2181.24Sminoura## Ports
2191.9Sminourazsc0	at intio0 addr 0xe98000 intr 112
2201.7Sminourazstty0	at zsc0 channel 0		# built-in RS-232C
2211.7Sminoura#ms0	at zsc0 channel 1		# standard mouse
2221.9Sminoura#zsc1	at intio0 addr 0xeafc00 intr 113
2231.7Sminoura#zstty2	at zsc1 channel 0
2241.7Sminoura#zstty3	at zsc1 channel 1
2251.9Sminoura#zsc2	at intio0 addr 0xeafc10 intr 114
2261.7Sminoura#zstty4	at zsc2 channel 0
2271.7Sminoura#zstty5	at zsc2 channel 1
2281.122Sisaki#par0	at intio0 addr 0xe8c000		# Builtin printer port
2291.7Sminoura
2301.84Sisakisram0	at intio0 addr 0xed0000		# battery-backuped static RAM
2311.13Sminoura#pseudo-device	bell			# OPM bell
2321.9Sminoura
2331.95Stsutsui#com0	at intio0 addr 0xefff00 intr 240	# PSX16550, port1
2341.95Stsutsui#com1	at intio0 addr 0xefff10 intr 241	# PSX16550, port2
2351.15Sminoura
2361.39Sminoura## Audio device
2371.39Sminoura#vs0 at intio0 addr 0xe92000 dma 3 dmaintr 106
2381.39Sminoura#audio*	at vs?
2391.7Sminoura
2401.112Schristos#spkr*	at audio?				# PC speaker (synthesized)
2411.110Snat
2421.7Sminoura## Network interfaces
2431.43Sisakine*	at intio0 addr 0xece300 intr 249	# Nereid Ethernet
2441.46Sisakine*	at intio0 addr 0xeceb00 intr 248	# Nereid Ethernet
2451.9Sminouraneptune0 at intio0 addr 0xece000 intr 249	# Neptune-X
2461.9Sminouraneptune1 at intio0 addr 0xece400 intr 249	# Neptune-X at alt. addr.
2471.43Sisakine*	at neptune? addr 0x300			# NE2000 or clone
2481.7Sminoura
2491.7Sminoura
2501.7Sminoura#### Pseudo devices
2511.7Sminoura
2521.90Shannkenpseudo-device	md			# boot floppy image
2531.7Sminourapseudo-device	loop
2541.96Stsutsuipseudo-device	bpfilter
2551.122Sisakipseudo-device	sl
2561.99Schristospseudo-device	pty			# pseudo-terminals
257