Home | History | Annotate | Line # | Download | only in conf
INSTALL revision 1.124
      1  1.124   thorpej #	$NetBSD: INSTALL,v 1.124 2026/08/05 01:01:47 thorpej Exp $
      2    1.1       oki 
      3    1.1       oki #
      4    1.7   minoura #	INSTALL -- installation kernel.
      5    1.1       oki #
      6    1.1       oki 
      7    1.7   minoura include "arch/x68k/conf/std.x68k"
      8    1.1       oki 
      9   1.51    atatat #options 	INCLUDE_CONFIG_FILE	# embed config file in kernel binary
     10   1.51    atatat 
     11  1.124   thorpej #ident 		"INSTALL-$Revision: 1.124 $"
     12   1.33       abs 
     13  1.121   tsutsui makeoptions	COPTS="-Os -fno-unwind-tables" # Optimise for space. Implies -O2
     14   1.23   minoura 
     15   1.28   minoura maxusers	4
     16    1.1       oki 
     17    1.7   minoura ## Enable the hooks used for initializing the memory-disk.
     18    1.7   minoura options 	MEMORY_DISK_HOOKS
     19   1.42     lukem options 	MEMORY_DISK_IS_ROOT	# Force root on memory-disk
     20    1.7   minoura options 	MEMORY_DISK_SERVER=0	# No user space hooks
     21  1.119       rin options 	MEMORY_DISK_ROOT_SIZE=3600	# size of memory disk, in blocks
     22   1.86       jym options 	MEMORY_DISK_RBFLAGS=RB_SINGLE	# boot in single-user mode
     23    1.7   minoura 
     24    1.7   minoura ## System kernel configuration.  See options(4) for more detail.
     25    1.7   minoura 
     26    1.7   minoura 
     27    1.7   minoura ## Options for variants of the m68k MPU
     28    1.7   minoura ## you must have at least the correct one; REQUIRED
     29    1.1       oki options 	M68030
     30    1.1       oki options 	M68040
     31    1.1       oki options 	M68060
     32   1.37   minoura ## If you want an optimized kernel for a specific processor, use either:
     33   1.37   minoura #makeoptions	CMACHFLAGS="-m68030"
     34   1.37   minoura #makeoptions	CMACHFLAGS="-m68040 -Wa,-m68030 -Wa,-m68851"
     35   1.37   minoura #makeoptions	CMACHFLAGS="-m68060 -Wa,-m68030 -Wa,-m68851"
     36    1.1       oki 
     37    1.1       oki 
     38    1.7   minoura #### System options specific to the x68k port
     39    1.1       oki 
     40   1.22   minoura options 	EXTENDED_MEMORY		# support for >16MB memory
     41    1.7   minoura options 	FPU_EMULATE		# software fpu emulation for MC68030
     42   1.38   minoura #options 	JUPITER			# support for "Jupiter-X" accelerator
     43    1.9   minoura #options 	ZSCONSOLE,ZSCN_SPEED="9600"	# use serial console
     44    1.7   minoura 
     45    1.1       oki 
     46    1.7   minoura #### System options that are the same for all ports
     47    1.1       oki 
     48    1.7   minoura ## Root device configuration: change the ?'s if you are going to use a
     49    1.7   minoura ## nonstandard root partition (other than where the kernel is booted from)
     50    1.7   minoura ## and/or nonstandard root type (not ffs or nfs).  Normally this can be
     51    1.7   minoura ## automagically determined at boot time.
     52    1.1       oki 
     53    1.7   minoura config		netbsd	root on ? type ?
     54   1.10   minoura #config		netbsd	root on sd0 type ffs
     55    1.7   minoura 
     56    1.7   minoura ## RTC is offset from GMT; -540 means JST-9
     57    1.7   minoura options 	RTC_OFFSET=-540	# hardware clock is this many mins. west of GMT
     58    1.7   minoura 
     59    1.7   minoura ## System call tracing (see ktrace(1)).
     60    1.7   minoura #options 	KTRACE
     61    1.7   minoura 
     62    1.7   minoura ## System V compatible IPC subsystem.  (msgctl(2), semctl(2), and shmctl(2))
     63    1.7   minoura #options 	SYSVMSG		# System V message queues
     64    1.7   minoura #options 	SYSVSEM		# System V semaphores
     65    1.7   minoura #options 	SYSVSHM		# System V shared memory
     66    1.7   minoura 
     67    1.7   minoura ## Loadable kernel module support
     68   1.47  jdolecek 
     69   1.53     lukem options 	USERCONF		# userconf(4) support
     70   1.77     isaki options 	PIPE_SOCKETPAIR		# smaller, but slower pipe(2)
     71   1.58    atatat #options 	SYSCTL_INCLUDE_DESCR	# Include sysctl descriptions in kernel
     72    1.7   minoura 
     73    1.7   minoura ## NFS boot options; not supported currently: needs nfsboot program
     74    1.7   minoura #options 	NFS_BOOT_BOOTPARAM
     75    1.7   minoura #options 	NFS_BOOT_BOOTP
     76    1.7   minoura #options 	NFS_BOOT_DHCP
     77    1.7   minoura 
     78    1.7   minoura #### Debugging options
     79    1.7   minoura 
     80    1.7   minoura ## The DDB in-kernel debugger runs at panic (unless DDB_ONPANIC=0), or at
     81    1.7   minoura ## serial console break or keyboard reset, where the PROM would normally
     82    1.7   minoura ## intercept.  DDB_HISTORY_SIZE adds up/down arrow command history.
     83    1.7   minoura #options 	DDB			# kernel dynamic debugger
     84    1.7   minoura #options 	DDB_HISTORY_SIZE=100	# enable history editing in DDB
     85  1.105  szptvlfn #options 	DDB_ONPANIC=1		# see also sysctl(7): `ddb.onpanic'
     86    1.7   minoura #options 	PANICBUTTON		# interrupt switch invokes DDB
     87    1.7   minoura 
     88    1.7   minoura ## You may also use gdb, on another computer connected to this machine over
     89   1.41     lukem ## a serial port.  Both KGDB_DEV and KGDB_DEVRATE should be specified;
     90   1.41     lukem ## KGDB_DEV is a dev_t encoded device number of the serial port to use.
     91    1.7   minoura ## KGDB is not supported for now.
     92   1.41     lukem #options 	KGDB			# support for kernel gdb
     93   1.41     lukem #options 	KGDB_DEV=0xc00		# kgdb device number
     94   1.41     lukem #options 	KGDB_DEVRATE=9600	# baud rate
     95    1.7   minoura 
     96    1.7   minoura ## Compile the kernel with debugging symbols (`netbsd.gdb' is the debug file),
     97    1.7   minoura ## such that gdb(1) can be used on a kernel coredump.
     98    1.7   minoura 
     99   1.42     lukem #makeoptions	DEBUG="-g"
    100    1.7   minoura 
    101    1.7   minoura ## Adds code to the kernel that does internal consistency checks, and will
    102    1.7   minoura ## cause the kernel to panic if corruption of internal data structures
    103    1.7   minoura ## is detected.
    104    1.7   minoura #options 	DIAGNOSTIC	# extra kernel sanity checking
    105    1.7   minoura 
    106    1.7   minoura ## Enable (possibly expensive) debugging code that may also display messages
    107    1.7   minoura ## on the system console
    108    1.7   minoura #options 	DEBUG
    109    1.7   minoura 
    110    1.7   minoura ## Make SCSI error messages more verbose when explaining their meanings.
    111    1.7   minoura #options 	SCSIVERBOSE
    112    1.7   minoura 
    113    1.7   minoura ## `INSECURE' turns off the kernel security level (securelevel = 0 always).
    114    1.7   minoura ## This allows writing to /dev/mem, loading kernel modules while multi-user,
    115    1.7   minoura ## and other insecurities good only for development work.  Do not use this
    116    1.7   minoura ## option on a production machine.
    117    1.7   minoura #options 	INSECURE
    118    1.7   minoura 
    119    1.7   minoura ## `FDSCRIPTS' allows non-readable but executable scripts by providing a
    120    1.7   minoura ## pre-opened opaque file to the script interpreter.  `SETUIDSCRIPTS',
    121    1.7   minoura ## which implies FDSCRIPTS, allows scripts to be set-user-id using the same
    122    1.7   minoura ## opaque file mechanism.  Perl calls this "secure setuid scripts."
    123    1.7   minoura 
    124    1.7   minoura #options 	FDSCRIPTS
    125    1.7   minoura #options 	SETUIDSCRIPTS
    126    1.7   minoura 
    127    1.7   minoura ## Options for compatibility with previous releases foreign system binaries.
    128    1.7   minoura 
    129  1.114       mrg include 	"conf/compat_netbsd30.config"
    130  1.114       mrg 
    131   1.45   minoura #options 	COMPAT_AOUT_M68K # compatibility with NetBSD/m68k a.out
    132    1.7   minoura #options 	COMPAT_M68K4K	# NetBSD/m68k4k binaries
    133    1.7   minoura #options 	COMPAT_SUNOS	# SunOS 4.x binary compatibility; broken
    134   1.10   minoura #options 	COMPAT_LINUX	# Linux/m68k binary compatibility
    135  1.120       nia #options 	COMPAT_OSSAUDIO	# Linux/m68k binary compatibility
    136    1.7   minoura 
    137   1.44     isaki ## File systems.
    138    1.7   minoura file-system	FFS		# Berkeley Fast Filesystem
    139    1.7   minoura file-system	NFS		# Sun NFS-compatible filesystem client
    140   1.28   minoura #file-system	KERNFS		# kernel data-structure filesystem
    141  1.104     isaki #file-system	NULLFS		# NULL layered filesystem
    142  1.122     isaki #file-system	OVERLAY		# overlay file system
    143   1.14   minoura #file-system	MFS		# memory-based filesystem
    144    1.7   minoura #file-system	FDESC		# user file descriptor filesystem
    145    1.7   minoura #file-system	UMAPFS		# uid/gid remapping filesystem
    146   1.16   minoura #file-system	LFS		# Log-structured filesystem (experimental)
    147   1.13   minoura #file-system	PROCFS		# /proc
    148    1.7   minoura file-system	CD9660		# ISO 9660 + Rock Ridge file system
    149   1.16   minoura #file-system	UNION		# union file system (a little buggy)
    150    1.7   minoura file-system	MSDOSFS		# MS-DOS FAT filesystem(s).
    151  1.122     isaki #file-system	ADOSFS		# AmigaDOS filesystem
    152   1.70  christos #file-system	PTYFS		# /dev/pts/N support
    153    1.7   minoura 
    154   1.44     isaki ## File system options.
    155    1.7   minoura #options 	NFSSERVER	# Sun NFS-compatible filesystem server
    156   1.91    bouyer #options 	QUOTA		# legacy UFS quotas
    157   1.91    bouyer #options 	QUOTA2		# new, in-filesystem UFS quotas
    158    1.7   minoura #options 	FFS_EI		# FFS Endian Independent support
    159   1.94  dholland options 	WAPBL		# File system journaling support
    160   1.76      yamt #options 	NFS_V2_ONLY	# Exclude NFS3 code to save space
    161   1.71   tsutsui options 	FFS_NO_SNAPSHOT	# No FFS snapshot support
    162   1.22   minoura 
    163    1.7   minoura ## Network protocol support.  In most environments, INET is required.
    164    1.7   minoura options 	INET		# IP (Internet Protocol) v4
    165   1.26   minoura options 	INET6		# IPV6
    166   1.22   minoura #options 	IPSEC		# IP security
    167   1.22   minoura #options 	IPSEC_DEBUG	# debug for IP security
    168    1.7   minoura #options 	GATEWAY		# packet forwarding ("router switch")
    169    1.7   minoura #options 	MROUTING	# packet forwarding of multicast packets
    170   1.59      manu #options 	PIM		# Protocol Independent Multicast
    171    1.7   minoura #options 	NETATALK	# AppleTalk (over Ethernet) protocol
    172    1.7   minoura #options 	NTP		# Network Time Protocol in-kernel support
    173    1.7   minoura #options 	PPS_SYNC	# Add serial line synchronization for NTP
    174    1.7   minoura #options 	PPP_BSDCOMP	# Add BSD compression to ppp device
    175    1.7   minoura #options 	PPP_DEFLATE	# Add deflate (libz) compression to ppp device
    176    1.7   minoura #options 	PPP_FILTER	# Add active filters for ppp (via bpf)
    177   1.40       abs #options 	TCP_DEBUG	# Record last TCP_NDEBUG packets with SO_DEBUG
    178    1.7   minoura 
    179    1.7   minoura 
    180    1.7   minoura #### Device configurations
    181    1.7   minoura 
    182    1.9   minoura ## Fundamental devices; see also std.x68k
    183   1.57       wiz dmac0	at intio0 addr 0xe84000		# DMA controller
    184    1.9   minoura xel0	at intio0
    185    1.9   minoura opm0	at intio0 addr 0xe90000		# OPM: required for fdc
    186    1.7   minoura 
    187    1.7   minoura ## Display devices and console
    188    1.7   minoura grfbus0	at mainbus0			# bitmapped displays
    189   1.62       chs grf0	at grfbus0 addr 0		# multiplane graphics
    190   1.62       chs #grf1	at grfbus0 addr 1		# flexible graphics
    191    1.7   minoura 
    192    1.9   minoura kbd0	at mfp0				# standard keyboard
    193   1.62       chs ite0	at grf0 grfaddr 0		# internal terminal emulator
    194   1.16   minoura options 	ITE_KERNEL_ATTR=4	# bold for kernel messages
    195    1.9   minoura 					# see /sys/arch/x68k/dev/itevar.h
    196    1.7   minoura 
    197    1.7   minoura ## floppy disks
    198   1.57       wiz fdc0	at intio0 addr 0xe94000 intr 96 dma 0 dmaintr 100 # floppy controller
    199    1.7   minoura fd*	at fdc0 unit ?			# builtin floppy drives
    200    1.7   minoura 
    201    1.7   minoura ## SCSI devices
    202    1.9   minoura scsirom0 at intio0				# SCSI BIOS
    203    1.9   minoura scsirom1 at intio0				# SCSI BIOS
    204  1.123    andvar spc*	at scsirom?				# genuine SCSI
    205    1.7   minoura scsibus* at spc?
    206    1.9   minoura mha0	at scsirom?				# Mankai MK-HA1 (Mach-2)
    207    1.7   minoura scsibus* at mha0
    208    1.1       oki 
    209    1.1       oki sd*	at scsibus? target ? lun ?	# SCSI disks
    210    1.1       oki cd*	at scsibus? target ? lun ?	# SCSI CD-ROMs
    211    1.7   minoura st*	at scsibus? target ? lun ?	# SCSI tapes
    212    1.7   minoura #ss*	at scsibus? target ? lun ?	# SCSI scanners
    213    1.7   minoura #ch*	at scsibus? target ? lun ?	# SCSI changer devices
    214    1.7   minoura #uk*	at scsibus? target ? lun ?	# SCSI unknown devices
    215    1.7   minoura 
    216   1.24   minoura ## Ports
    217    1.9   minoura zsc0	at intio0 addr 0xe98000 intr 112
    218    1.7   minoura zstty0	at zsc0 channel 0		# built-in RS-232C
    219    1.7   minoura #ms0	at zsc0 channel 1		# standard mouse
    220    1.9   minoura #zsc1	at intio0 addr 0xeafc00 intr 113
    221    1.7   minoura #zstty2	at zsc1 channel 0
    222    1.7   minoura #zstty3	at zsc1 channel 1
    223    1.9   minoura #zsc2	at intio0 addr 0xeafc10 intr 114
    224    1.7   minoura #zstty4	at zsc2 channel 0
    225    1.7   minoura #zstty5	at zsc2 channel 1
    226  1.122     isaki #par0	at intio0 addr 0xe8c000		# Builtin printer port
    227    1.7   minoura 
    228   1.84     isaki sram0	at intio0 addr 0xed0000		# battery-backuped static RAM
    229   1.13   minoura #pseudo-device	bell			# OPM bell
    230    1.9   minoura 
    231   1.95   tsutsui #com0	at intio0 addr 0xefff00 intr 240	# PSX16550, port1
    232   1.95   tsutsui #com1	at intio0 addr 0xefff10 intr 241	# PSX16550, port2
    233   1.15   minoura 
    234   1.39   minoura ## Audio device
    235   1.39   minoura #vs0 at intio0 addr 0xe92000 dma 3 dmaintr 106
    236   1.39   minoura #audio*	at vs?
    237    1.7   minoura 
    238  1.112  christos #spkr*	at audio?				# PC speaker (synthesized)
    239  1.110       nat 
    240    1.7   minoura ## Network interfaces
    241   1.43     isaki ne*	at intio0 addr 0xece300 intr 249	# Nereid Ethernet
    242   1.46     isaki ne*	at intio0 addr 0xeceb00 intr 248	# Nereid Ethernet
    243    1.9   minoura neptune0 at intio0 addr 0xece000 intr 249	# Neptune-X
    244    1.9   minoura neptune1 at intio0 addr 0xece400 intr 249	# Neptune-X at alt. addr.
    245   1.43     isaki ne*	at neptune? addr 0x300			# NE2000 or clone
    246    1.7   minoura 
    247    1.7   minoura 
    248    1.7   minoura #### Pseudo devices
    249    1.7   minoura 
    250   1.90   hannken pseudo-device	md			# boot floppy image
    251    1.7   minoura pseudo-device	loop
    252   1.96   tsutsui pseudo-device	bpfilter
    253  1.122     isaki pseudo-device	sl
    254   1.99  christos pseudo-device	pty			# pseudo-terminals
    255