INSTALL revision 1.24 1 1.24 minoura # $NetBSD: INSTALL,v 1.24 2000/04/16 14:17:59 minoura 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.24 minoura #ident "INSTALL-$Revision: 1.24 $"
10 1.23 minoura
11 1.9 minoura maxusers 8
12 1.1 oki
13 1.7 minoura ## Enable the hooks used for initializing the memory-disk.
14 1.7 minoura options MEMORY_DISK_HOOKS
15 1.7 minoura options MEMORY_DISK_IS_ROOT # Force root on memory-disk
16 1.7 minoura options MEMORY_DISK_SERVER=0 # No user space hooks
17 1.22 minoura #options MINIROOTSIZE=2400 # 1.2M, same as a 130mm floppy
18 1.22 minoura options MINIROOTSIZE=2880 # 1.44M, same as a 90mm floppy
19 1.19 minoura #options MINIROOTSIZE=2048
20 1.7 minoura
21 1.7 minoura ## System kernel configuration. See options(4) for more detail.
22 1.7 minoura
23 1.7 minoura
24 1.7 minoura ## Options for variants of the m68k MPU
25 1.7 minoura ## you must have at least the correct one; REQUIRED
26 1.1 oki options M68030
27 1.1 oki options M68040
28 1.1 oki options M68060
29 1.1 oki
30 1.1 oki
31 1.7 minoura #### System options specific to the x68k port
32 1.1 oki
33 1.22 minoura options EXTENDED_MEMORY # support for >16MB memory
34 1.7 minoura options FPU_EMULATE # software fpu emulation for MC68030
35 1.7 minoura options FPSP # floating point emulation for MC68040
36 1.1 oki options M060SP # int/fp emulation for MC68060
37 1.7 minoura options JUPITER # support for "Jupiter-X" accelerator
38 1.12 minoura #options MAPPEDCOPY # use page mapping for large copyin/copyout
39 1.9 minoura #options ZSCONSOLE,ZSCN_SPEED="9600" # use serial console
40 1.7 minoura
41 1.1 oki
42 1.7 minoura #### System options that are the same for all ports
43 1.1 oki
44 1.7 minoura ## Root device configuration: change the ?'s if you are going to use a
45 1.7 minoura ## nonstandard root partition (other than where the kernel is booted from)
46 1.7 minoura ## and/or nonstandard root type (not ffs or nfs). Normally this can be
47 1.7 minoura ## automagically determined at boot time.
48 1.1 oki
49 1.7 minoura config netbsd root on ? type ?
50 1.10 minoura #config netbsd root on sd0 type ffs
51 1.7 minoura
52 1.7 minoura ## RTC is offset from GMT; -540 means JST-9
53 1.7 minoura options RTC_OFFSET=-540 # hardware clock is this many mins. west of GMT
54 1.7 minoura
55 1.7 minoura ## System call tracing (see ktrace(1)).
56 1.7 minoura #options KTRACE
57 1.7 minoura
58 1.7 minoura ## Collect statistics on kernel malloc's and free's. This does have a
59 1.7 minoura ## significant performance hit on slower machines, so it is intended for
60 1.7 minoura ## diagnostic use only.
61 1.7 minoura #options KMEMSTATS
62 1.7 minoura
63 1.7 minoura ## System V compatible IPC subsystem. (msgctl(2), semctl(2), and shmctl(2))
64 1.7 minoura #options SYSVMSG # System V message queues
65 1.7 minoura #options SYSVSEM # System V semaphores
66 1.7 minoura #options SYSVSHM # System V shared memory
67 1.7 minoura #options SHMMAXPGS=1024 # 1024 pages is the default
68 1.7 minoura
69 1.7 minoura ## Loadable kernel module support
70 1.7 minoura #options LKM
71 1.7 minoura
72 1.7 minoura ## NFS boot options; not supported currently: needs nfsboot program
73 1.7 minoura #options NFS_BOOT_BOOTPARAM
74 1.7 minoura #options NFS_BOOT_BOOTP
75 1.7 minoura #options NFS_BOOT_DHCP
76 1.7 minoura
77 1.7 minoura #### Debugging options
78 1.7 minoura
79 1.7 minoura ## The DDB in-kernel debugger runs at panic (unless DDB_ONPANIC=0), or at
80 1.7 minoura ## serial console break or keyboard reset, where the PROM would normally
81 1.7 minoura ## intercept. DDB_HISTORY_SIZE adds up/down arrow command history.
82 1.7 minoura #options DDB # kernel dynamic debugger
83 1.7 minoura #options DDB_HISTORY_SIZE=100 # enable history editing in DDB
84 1.7 minoura #options DDB_ONPANIC=1 # see also sysctl(8): `ddb.onpanic'
85 1.7 minoura #options PANICBUTTON # interrupt switch invokes DDB
86 1.7 minoura
87 1.7 minoura ## You may also use gdb, on another computer connected to this machine over
88 1.7 minoura ## a serial port. Both KGDBDEV and KGDBRATE should be specified; KGDBDEV is
89 1.7 minoura ## a dev_t encoded device number of the serial port to use.
90 1.7 minoura ## KGDB is not supported for now.
91 1.7 minoura #options KGDB # support for kernel gdb
92 1.7 minoura #options KGDBDEV=0xc00 # kgdb device number
93 1.7 minoura #options KGDBRATE=9600 # baud rate
94 1.7 minoura
95 1.7 minoura ## Compile the kernel with debugging symbols (`netbsd.gdb' is the debug file),
96 1.7 minoura ## such that gdb(1) can be used on a kernel coredump.
97 1.7 minoura
98 1.7 minoura #makeoptions DEBUG="-g"
99 1.19 minoura makeoptions COPTS="-Os"
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 ## Allow non-root users to grab /dev/console with programs such as xconsole.
120 1.7 minoura ## `xconsole' therefore does not need setuid root with this option enabled.
121 1.7 minoura #options UCONSOLE
122 1.7 minoura
123 1.7 minoura ## `FDSCRIPTS' allows non-readable but executable scripts by providing a
124 1.7 minoura ## pre-opened opaque file to the script interpreter. `SETUIDSCRIPTS',
125 1.7 minoura ## which implies FDSCRIPTS, allows scripts to be set-user-id using the same
126 1.7 minoura ## opaque file mechanism. Perl calls this "secure setuid scripts."
127 1.7 minoura
128 1.7 minoura #options FDSCRIPTS
129 1.7 minoura #options SETUIDSCRIPTS
130 1.7 minoura
131 1.7 minoura ## Options for compatibility with previous releases foreign system binaries.
132 1.7 minoura
133 1.13 minoura #options COMPAT_43 # 4.3BSD system interfaces
134 1.7 minoura #options COMPAT_09 # NetBSD 0.9 binary compatibility
135 1.7 minoura #options COMPAT_10 # NetBSD 1.0 binary compatibility
136 1.7 minoura #options COMPAT_11 # NetBSD 1.1 binary compatibility
137 1.7 minoura #options COMPAT_12 # NetBSD 1.2 binary compatibility
138 1.7 minoura #options COMPAT_13 # NetBSD 1.3 binary compatibility
139 1.18 minoura #options COMPAT_14 # NetBSD 1.4 binary compatibility
140 1.7 minoura #options COMPAT_M68K4K # NetBSD/m68k4k binaries
141 1.7 minoura #options COMPAT_SUNOS # SunOS 4.x binary compatibility; broken
142 1.16 minoura #options COMPAT_SVR4 # SVR4 binary compatibility; broken
143 1.10 minoura #options COMPAT_LINUX # Linux/m68k binary compatibility
144 1.16 minoura #options EXEC_ELF32 # 32-bit ELF executables (Linux, SVR4)
145 1.7 minoura
146 1.7 minoura ## File systems.
147 1.7 minoura file-system FFS # Berkeley Fast Filesystem
148 1.7 minoura file-system NFS # Sun NFS-compatible filesystem client
149 1.7 minoura file-system KERNFS # kernel data-structure filesystem
150 1.16 minoura #file-system NULLFS # NULL layered filesystem (buggy)
151 1.23 minoura #file-system OVERLAY # overlay file system
152 1.14 minoura #file-system MFS # memory-based filesystem
153 1.7 minoura #file-system FDESC # user file descriptor filesystem
154 1.7 minoura #file-system UMAPFS # uid/gid remapping filesystem
155 1.16 minoura #file-system LFS # Log-structured filesystem (experimental)
156 1.16 minoura #file-system PORTAL # portal filesystem (experimental)
157 1.13 minoura #file-system PROCFS # /proc
158 1.7 minoura file-system CD9660 # ISO 9660 + Rock Ridge file system
159 1.16 minoura #file-system UNION # union file system (a little buggy)
160 1.7 minoura file-system MSDOSFS # MS-DOS FAT filesystem(s).
161 1.7 minoura #file-system ADOSFS # AmigaDOS filesystem
162 1.7 minoura
163 1.7 minoura ## File system options.
164 1.7 minoura #options NFSSERVER # Sun NFS-compatible filesystem server
165 1.7 minoura #options QUOTA # FFS quotas
166 1.7 minoura #options FFS_EI # FFS Endian Independent support
167 1.20 minoura #options SOFTDEP # FFS soft updates support.
168 1.7 minoura
169 1.22 minoura # Pull in config fragments for kernel crypto. This is required for
170 1.22 minoura # options IPSEC etc. to work. If you want to run with IPSEC, uncomment
171 1.22 minoura # one of these, based on whether you use crypto-us or crypto-intl, and
172 1.22 minoura # adjust the prefixes as necessary.
173 1.22 minoura
174 1.22 minoura #prefix ../crypto-us/sys
175 1.22 minoura #cinclude "conf/files.crypto-us"
176 1.22 minoura #prefix
177 1.22 minoura
178 1.22 minoura #prefix ../crypto-intl/sys
179 1.22 minoura #cinclude "conf/files.crypto-intl"
180 1.22 minoura #prefix
181 1.22 minoura
182 1.7 minoura ## Network protocol support. In most environments, INET is required.
183 1.7 minoura options INET # IP (Internet Protocol) v4
184 1.22 minoura #options INET6 # IPV6
185 1.22 minoura #options IPSEC # IP security
186 1.22 minoura #options IPSEC_ESP # IP security (encryption part; define w/IPSEC)
187 1.22 minoura #options IPSEC_DEBUG # debug for IP security
188 1.7 minoura options TCP_COMPAT_42 # 4.2BSD IP implementation compatibility
189 1.7 minoura #options GATEWAY # packet forwarding ("router switch")
190 1.7 minoura #options MROUTING # packet forwarding of multicast packets
191 1.7 minoura #options DIRECTED_BROADCAST # allow broadcasts through routers
192 1.7 minoura #options NS # Xerox NS networking
193 1.7 minoura #options NSIP # Xerox NS tunneling over IP
194 1.7 minoura #options ISO,TPIP # OSI networking
195 1.7 minoura #options EON # OSI tunneling over IP
196 1.7 minoura #options CCITT,LLC,HDLC # X.25 packet switched protocol
197 1.7 minoura #options NETATALK # AppleTalk (over Ethernet) protocol
198 1.7 minoura #options NTP # Network Time Protocol in-kernel support
199 1.7 minoura #options PPS_SYNC # Add serial line synchronization for NTP
200 1.7 minoura #options PFIL_HOOKS # Add pfil(9) hooks, intended for custom LKMs.
201 1.7 minoura #options IPFILTER_LOG # Add ipmon(8) logging for ipfilter device
202 1.7 minoura #options PPP_BSDCOMP # Add BSD compression to ppp device
203 1.7 minoura #options PPP_DEFLATE # Add deflate (libz) compression to ppp device
204 1.7 minoura #options PPP_FILTER # Add active filters for ppp (via bpf)
205 1.7 minoura
206 1.7 minoura
207 1.7 minoura
208 1.7 minoura #### Device configurations
209 1.7 minoura
210 1.9 minoura ## Fundamental devices; see also std.x68k
211 1.9 minoura dmac0 at intio0 addr 0xe84000 # DMA controler
212 1.9 minoura xel0 at intio0
213 1.9 minoura opm0 at intio0 addr 0xe90000 # OPM: required for fdc
214 1.7 minoura
215 1.7 minoura ## Display devices and console
216 1.7 minoura grfbus0 at mainbus0 # bitmapped displays
217 1.7 minoura grf0 at grfbus0 # multiplane graphics
218 1.7 minoura #grf1 at grfbus0 # flexible graphics
219 1.7 minoura
220 1.9 minoura kbd0 at mfp0 # standard keyboard
221 1.7 minoura ite0 at grf0 # internal terminal emulator
222 1.16 minoura options ITE_KERNEL_ATTR=4 # bold for kernel messages
223 1.9 minoura # see /sys/arch/x68k/dev/itevar.h
224 1.12 minoura #pseudo-device pow 2 # software power switch
225 1.7 minoura
226 1.7 minoura ## floppy disks
227 1.9 minoura fdc0 at intio0 addr 0xe94000 intr 96 dma 0 dmaintr 100 # floppy controler
228 1.7 minoura fd* at fdc0 unit ? # builtin floppy drives
229 1.7 minoura
230 1.7 minoura ## SCSI devices
231 1.9 minoura scsirom0 at intio0 # SCSI BIOS
232 1.9 minoura scsirom1 at intio0 # SCSI BIOS
233 1.9 minoura spc* at scsirom? # genuin SCSI
234 1.7 minoura scsibus* at spc?
235 1.9 minoura mha0 at scsirom? # Mankai MK-HA1 (Mach-2)
236 1.7 minoura scsibus* at mha0
237 1.1 oki
238 1.1 oki sd* at scsibus? target ? lun ? # SCSI disks
239 1.1 oki cd* at scsibus? target ? lun ? # SCSI CD-ROMs
240 1.7 minoura st* at scsibus? target ? lun ? # SCSI tapes
241 1.7 minoura #ss* at scsibus? target ? lun ? # SCSI scanners
242 1.7 minoura #ch* at scsibus? target ? lun ? # SCSI changer devices
243 1.7 minoura #uk* at scsibus? target ? lun ? # SCSI unknown devices
244 1.7 minoura
245 1.24 minoura ## Ports
246 1.9 minoura zsc0 at intio0 addr 0xe98000 intr 112
247 1.7 minoura zstty0 at zsc0 channel 0 # built-in RS-232C
248 1.7 minoura #ms0 at zsc0 channel 1 # standard mouse
249 1.9 minoura #zsc1 at intio0 addr 0xeafc00 intr 113
250 1.7 minoura #zstty2 at zsc1 channel 0
251 1.7 minoura #zstty3 at zsc1 channel 1
252 1.9 minoura #zsc2 at intio0 addr 0xeafc10 intr 114
253 1.7 minoura #zstty4 at zsc2 channel 0
254 1.7 minoura #zstty5 at zsc2 channel 1
255 1.24 minoura #par0 at intio0 addr 0xe8c000 # Builtin printer port
256 1.7 minoura
257 1.13 minoura #pseudo-device sram # battery-backuped static RAM
258 1.13 minoura #pseudo-device bell # OPM bell
259 1.9 minoura
260 1.7 minoura #xcom0 at mainbus0 # NS16550 fast serial
261 1.7 minoura #xcom1 at mainbus0
262 1.15 minoura
263 1.7 minoura ## Audio device; broken
264 1.9 minoura #okiadpcm0 at intio0 addr 0xe92000 intr 106 errintr 107 dma 3
265 1.7 minoura #audio* at okiadpcm*
266 1.7 minoura
267 1.7 minoura ## Network interfaces
268 1.9 minoura neptune0 at intio0 addr 0xece000 intr 249 # Neptune-X
269 1.9 minoura neptune1 at intio0 addr 0xece400 intr 249 # Neptune-X at alt. addr.
270 1.9 minoura ne0 at neptune? addr 0x300 # NE2000 or clone
271 1.10 minoura #se0 at scsibus? target ? lun ? # Ether+; broken
272 1.7 minoura
273 1.7 minoura
274 1.7 minoura #### Pseudo devices
275 1.7 minoura
276 1.7 minoura ## A disk-like interface to files. Can be used to create floppy, CD,
277 1.7 minoura ## miniroot images, etc.
278 1.7 minoura
279 1.12 minoura #pseudo-device vnd 4
280 1.7 minoura
281 1.7 minoura ## Concatenated and striped disks; with this, you can create a software-based
282 1.7 minoura ## disk array similar to a "RAID 0" setup. See ccd(4).
283 1.7 minoura
284 1.22 minoura pseudo-device ccd 4
285 1.9 minoura
286 1.9 minoura ## RAIDframe disk driver: software RAID driver. See raid(4).
287 1.9 minoura
288 1.9 minoura #pseudo-device raid 4
289 1.24 minoura #options RAID_AUTOCONFIG # auto-configuration of RAID components
290 1.7 minoura
291 1.7 minoura ## Memory disk device, used on boot floppies with compressed
292 1.7 minoura ## kernel-plus-root-disk images.
293 1.7 minoura
294 1.7 minoura pseudo-device md 1
295 1.7 minoura
296 1.7 minoura ## Loopback network interface; required
297 1.7 minoura pseudo-device loop
298 1.7 minoura
299 1.7 minoura ## SLIP and CSLIP interfaces, for IP over a serial line.
300 1.7 minoura pseudo-device sl 1
301 1.7 minoura
302 1.7 minoura ## PPP, the successor to SLIP. See pppd(8).
303 1.13 minoura #pseudo-device ppp 1
304 1.7 minoura
305 1.7 minoura ## Network "tunnel" device, allowing protocol stacks to run in the userland.
306 1.7 minoura ## This is used by the third-party user-mode "ppp" program, and others.
307 1.7 minoura #pseudo-device tun 4
308 1.9 minoura
309 1.9 minoura ## Generic L3 over IP tunnel
310 1.9 minoura #pseudo-device gre 2 # generic L3 over IP tunnel
311 1.7 minoura
312 1.7 minoura ## Berkeley Packet Filter, required to run RARPD. A generic C-language
313 1.7 minoura ## interface that allows selective examining of incoming packets.
314 1.7 minoura #pseudo-device bpfilter 8
315 1.7 minoura
316 1.7 minoura ## IP Filter, used in firewall and NAT applications. See ipnat(8) for
317 1.7 minoura ## one example of the use of the IP Filter.
318 1.7 minoura #pseudo-device ipfilter
319 1.7 minoura
320 1.22 minoura ## for IPv6
321 1.22 minoura #pseudo-device gif 4 # IPv[46] over IPv[46] tunnel (RFC1933)
322 1.22 minoura #pseudo-device faith 1 # IPv[46] tcp relay translation i/f
323 1.7 minoura
324 1.7 minoura #### Other device configuration
325 1.7 minoura
326 1.7 minoura ## Pseudo ttys, required for network logins and programs like screen.
327 1.7 minoura ## 32 is a good number for average systems; you may have as many as you
328 1.7 minoura ## like, though 256 is more or less the upper limit. Increasing this
329 1.7 minoura ## number still requires you to run /dev/MAKEDEV to create the files
330 1.7 minoura ## for the ptys.
331 1.16 minoura
332 1.22 minoura pseudo-device pty 8 # pseudo-ttys (for network, etc.)
333 1.7 minoura
334 1.7 minoura ## Random device, used to implement /dev/random (a source of random noise),
335 1.7 minoura ## and generate randomness for some kernel formulae.
336 1.16 minoura
337 1.7 minoura #pseudo-device rnd
338