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