INSTALL revision 1.77
11.23Smycroft#	$NetBSD: INSTALL,v 1.77 1998/03/01 20:45:26 augustss Exp $
21.2Stls#
31.2Stls#	INSTALL - Installation kernel.
41.2Stls#
51.2Stls#	This kernel should be derived from GENERIC with some features
61.2Stls#	commented out.
71.2Stls#
81.2Stls#	This kernel does NOT support X, mice, audio devices, non-NetBSD
91.2Stls#	emulation.
101.2Stls#
111.2Stls
121.2Stlsinclude "arch/i386/conf/std.i386"
131.2Stls
141.2Stls# Enable the hooks used for initializing the root memory-disk.
151.2Stlsoptions 	MEMORY_DISK_HOOKS
161.20Smycroftoptions 	MEMORY_DISK_IS_ROOT	# force root on memory disk
171.7Sthorpejoptions 	MEMORY_DISK_SERVER=0	# no userspace memory disk support
181.7Sthorpejoptions 	MINIROOTSIZE=3074	# size of memory disk, in blocks
191.7Sthorpej#options 	MINIROOTSIZE=2880	# 1.44M, same as a floppy
201.7Sthorpej
211.7Sthorpejmaxusers	32		# estimated number of users
221.2Stls
231.2Stls# CPU support.  At least one is REQUIRED.
241.20Smycroftoptions 	I386_CPU
251.20Smycroftoptions 	I486_CPU
261.2Stlsoptions 	I586_CPU
271.2Stlsoptions 	I686_CPU	
281.2Stls
291.2Stls# CPU-related options.
301.2Stlsoptions 	MATH_EMULATE	# floating point emulation
311.2Stls#options 	VM86		# virtual 8086 emulation
321.2Stls#options 	USER_LDT	# user-settable LDT; used by WINE
331.2Stls# eliminate delay no-ops in I/O; recommended on all but very old machines
341.2Stls#options 	DUMMY_NOPS
351.2Stls
361.20Smycroft# Misc. i386-specific options
371.2Stls#options 	XSERVER		# X server support in console drivers
381.20Smycroft
391.20Smycroft# This option allows you to force a serial console at the specified
401.2Stls# I/O address.
411.20Smycroft#options 	"CONSDEVNAME=\"com\"",CONADDR=0x3f8,CONSPEED=9600
421.20Smycroft
431.20Smycroft# The following options override the memory sizes passed in from the boot
441.20Smycroft# block.  Use them *only* if the boot block is unable to determine the correct
451.20Smycroft# values.  Note that the BIOS may *correctly* report less than 640k of base
461.20Smycroft# memory if the extended BIOS data area is located at the top of base memory
471.20Smycroft# (as is the case on most recent systems).
481.2Stls#options 	REALBASEMEM=...	# size of base memory
491.10Sperry#options 	REALEXTMEM=...	# size of extended memory
501.20Smycroft
511.20Smycroft# Standard system options
521.20Smycroft
531.20Smycroft#options 	UCONSOLE	# users can use TIOCCONS (for xconsole)
541.20Smycroftoptions 	INSECURE	# disable kernel security levels
551.20Smycroft
561.20Smycroftoptions 	RTC_OFFSET=0	# hardware clock is this many mins. west of GMT
571.20Smycroft#options 	NTP		# NTP phase/frequency locked loop
581.23Smycroft
591.23Smycroft#options 	KTRACE		# system call tracing via ktrace(1)
601.23Smycroft
611.23Smycroft#options 	UVM		# Use UVM instead of Mach VM.
621.2Stls
631.20Smycroft#options 	SYSVMSG		# System V-like message queues
641.2Stls#options 	SYSVSEM		# System V-like semaphores
651.2Stls#options 	SYSVSHM		# System V-like memory sharing
661.2Stls#options 	SHMMAXPGS=1024	# 1024 pages is the default
671.20Smycroft
681.20Smycroft#options 	LKM		# loadable kernel modules
691.20Smycroft
701.2Stls# Diagnostic/debugging support options
711.2Stls#options 	DIAGNOSTIC	# cheap kernel consistency checks
721.20Smycroft#options 	DEBUG		# expensive debugging checks/support
731.2Stls#options 	KMEMSTATS	# kernel memory statistics (vmstat -m)
741.2Stls#options 	DDB		# in-kernel debugger
751.2Stls#options 	DDB_HISTORY_SIZE=100	# enable history editing in DDB
761.2Stls#options 	KGDB		# remote debugger
771.2Stls#options 	"KGDB_DEVNAME=\"com\"",KGDBADDR=0x3f8,KGDBRATE=9600
781.2Stls#makeoptions	DEBUG="-g"	# compile full symbol table
791.20Smycroft
801.20Smycroft# Compatibility options
811.20Smycroft#options 	COMPAT_NOMID	# compatibility with 386BSD, BSDI, NetBSD 0.8,
821.20Smycroft#options 	COMPAT_09	# NetBSD 0.9,
831.20Smycroftoptions 	COMPAT_10	# NetBSD 1.0,
841.2Stlsoptions 	COMPAT_11	# NetBSD 1.1,
851.20Smycroftoptions 	COMPAT_12	# NetBSD 1.2,
861.2Stlsoptions 	COMPAT_13	# NetBSD 1.3,
871.20Smycroft#options 	COMPAT_43	# and 4.3BSD
881.20Smycroft
891.20Smycroft#options 	COMPAT_SVR4	# binary compatibility with SVR4
901.20Smycroft#options 	COMPAT_IBCS2	# binary compatibility with SCO and ISC
911.20Smycroft#options 	COMPAT_LINUX	# binary compatibility with Linux
921.2Stls#options 	COMPAT_FREEBSD	# binary compatibility with FreeBSD
931.2Stls
941.2Stls# Executable format options
951.2Stls#options 	EXEC_ELF32	# 32-bit ELF executables (SVR4, Linux)
961.6Scgd
971.6Scgd# File systems
981.6Scgdfile-system 	FFS		# UFS
991.6Scgdfile-system 	EXT2FS		# second extended file system (linux)
1001.20Smycroft#file-system 	LFS		# log-structured file system
1011.20Smycroftfile-system 	MFS		# memory file system
1021.20Smycroftfile-system 	NFS		# Network File System client
1031.2Stlsfile-system 	CD9660		# ISO 9660 + Rock Ridge file system
1041.5Scgdfile-system 	MSDOSFS		# MS-DOS file system
1051.5Scgd#file-system 	FDESC		# /dev/fd
1061.5Scgdfile-system 	KERNFS		# /kern
1071.2Stls#file-system 	NULLFS		# loopback file system
1081.2Stls#file-system 	PORTAL		# portal filesystem (still experimental)
1091.2Stls#file-system 	PROCFS		# /proc
1101.2Stls#file-system 	UMAPFS		# NULLFS + uid and gid remapping
1111.2Stls#file-system 	UNION		# union file system
1121.2Stls
1131.2Stls# File system options
1141.2Stls#options 	QUOTA		# UFS quotas
1151.2Stls#options 	NFSSERVER	# Network File System server
1161.2Stlsoptions 	FIFO		# FIFOs; RECOMMENDED
1171.8Scgd#options 	EXT2FS_SYSTEM_FLAGS # makes ext2fs file flags (append and
1181.2Stls				# immutable) behave as system flags.
1191.2Stls
1201.2Stls# Networking options
1211.2Stls#options 	GATEWAY		# packet forwarding
1221.2Stlsoptions 	INET		# IP + ICMP + TCP + UDP
1231.2Stls#options 	MROUTING	# IP multicast routing
1241.2Stls#options 	NS		# XNS
1251.2Stls#options 	NSIP		# XNS tunneling over IP
1261.2Stls#options 	ISO,TPIP	# OSI
1271.2Stls#options 	EON		# OSI tunneling over IP
1281.2Stls#options 	CCITT,LLC,HDLC	# X.25
1291.20Smycroft#options 	NETATALK	# AppleTalk networking protocols
1301.20Smycroft#options 	PPP_BSDCOMP	# BSD-Compress compression support for PPP
1311.20Smycroft#options 	PPP_DEFLATE	# Deflate compression support for PPP
1321.20Smycroft#options 	PPP_FILTER	# Active filter support for PPP (requires bpf)
1331.20Smycroft#options 	PFIL_HOOKS	# pfil(9) packet filter hooks
1341.20Smycroft
1351.20Smycroft# Compatibility with 4.2BSD implementation of TCP/IP.  Not recommended.
1361.20Smycroft#options 	TCP_COMPAT_42
1371.20Smycroft
1381.20Smycroft# These options enable verbose messages for several subsystems.
1391.20Smycroft# Warning, these may compile large string tables into the kernel!
1401.20Smycroft#options 	EISAVERBOSE	# verbose EISA device autoconfig messages
1411.20Smycroft#options 	PCIVERBOSE	# verbose PCI device autoconfig messages
1421.20Smycroft#options 	PCMCIAVERBOSE	# verbose PCMCIA configuration messages
1431.20Smycroft#options 	SCSIVERBOSE	# human readable SCSI error messages
1441.20Smycroft
1451.20Smycroft# Kernel root file system and dump configuration.
1461.17Smycroftconfig		netbsd	root on ? type ?
1471.17Smycroft#config		netbsd	root on sd0a type ffs
1481.17Smycroft#config		netbsd	root on ? type nfs
1491.18Smycroft
1501.17Smycroft#
1511.5Scgd# Device configuration
1521.2Stls#
1531.2Stls
1541.2Stlsmainbus0 at root
1551.2Stls
1561.2Stls#apm0	at mainbus0			# Advanced power management
1571.17Smycroft
1581.2Stls
1591.11Smycroft# Basic Bus Support
1601.11Smycroft
1611.11Smycroft# PCI bus support
1621.2Stlspci*	at mainbus? bus ?
1631.2Stlspci*	at pchb? bus ?
1641.2Stlspci*	at ppb? bus ?
1651.2Stls
1661.2Stls# PCI bridges
1671.20Smycroftpchb*	at pci? dev ? function ?	# PCI-Host bridges
1681.20Smycroftpceb*	at pci? dev ? function ?	# PCI-EISA bridges
1691.2Stlspcib*	at pci? dev ? function ?	# PCI-ISA bridges
1701.2Stlsppb*	at pci? dev ? function ?	# PCI-PCI bridges
1711.2Stls
1721.2Stls# EISA bus support
1731.2Stlseisa*	at mainbus?
1741.20Smycrofteisa*	at pceb?
1751.20Smycroft
1761.2Stls# ISA bus support
1771.2Stlsisa*	at mainbus?
1781.2Stlsisa*	at pceb?
1791.2Stlsisa*	at pcib?
1801.2Stls
1811.2Stls# PCMCIA bus support
1821.2Stlspcmcia*	at pcic? controller ? socket ?
1831.2Stls
1841.2Stls# ISA PCMCIA controllers
1851.2Stlspcic0	at isa? port 0x3e0 iomem 0xd0000 iosiz 0x4000
1861.2Stlspcic1	at isa? port 0x3e2 iomem 0xd4000 iosiz 0x4000
1871.2Stls
1881.13Sscottr# ISA Plug-and-Play bus support
1891.13Sscottrisapnp0	at isa?
1901.2Stls
1911.12Sthorpej
1921.20Smycroft# Coprocessor Support
1931.5Scgd
1941.5Scgd# Math Coprocessor support
1951.5Scgdnpx0	at isa? port 0xf0 irq 13	# x86 math coprocessor
1961.20Smycroft
1971.20Smycroft
1981.20Smycroft# Console Devices
1991.20Smycroft
2001.20Smycroft# ISA console.  You can only configure one of these!
2011.20Smycroftpc0	at isa? port 0x60 irq 1		# pccons generic PC console driver
2021.20Smycroft#vt0	at isa? port 0x60 irq 1		# PCVT console driver
2031.20Smycroft
2041.20Smycroft
2051.20Smycroft# Serial Devices
2061.20Smycroft
2071.20Smycroft# PCI serial interfaces
2081.20Smycroft#cy*	at pci? dev ? function ?	# Cyclades Cyclom-Y serial boards
2091.21Smycroft
2101.22Smycroft# ISA Plug-and-Play serial interfaces
2111.2Stlscom*	at isapnp?			# Modems and serial boards
2121.2Stls
2131.20Smycroft# PCMCIA serial interfaces
2141.2Stlscom*	at pcmcia? function ?		# Modems and serial cards
2151.20Smycroft
2161.20Smycroft# ISA serial interfaces
2171.2Stls#options 	COM_HAYESP		# adds Hayes ESP serial board support
2181.2Stlscom0	at isa? port 0x3f8 irq 4	# Standard PC serial ports
2191.20Smycroftcom1	at isa? port 0x2f8 irq 3
2201.20Smycroftcom2	at isa? port 0x3e8 irq 5
2211.20Smycroft#com3	at isa? port 0x2e8 irq 9
222#ast0	at isa? port 0x1a0 irq 5	# AST 4-port serial cards
223#com*	at ast? slave ?
224#boca0	at isa? port 0x100 irq 5	# BOCA 8-port serial cards
225#com*	at boca? slave ?
226#rtfps0	at isa? port 0x1230 irq 10	# RT 4-port serial cards
227#com*	at rtfps? slave ?
228#cy0	at isa? iomem 0xd4000 irq 12	# Cyclades serial cards
229
230
231# Parallel Printer Interfaces
232
233# ISA parallel printer interfaces
234#lpt0	at isa? port 0x378 irq 7	# standard PC parallel ports
235#lpt1	at isa? port 0x278
236#lpt2	at isa? port 0x3bc
237
238
239# SCSI Controllers and Devices
240
241# PCI SCSI controllers
242ahc*	at pci? dev ? function ?	# Adaptec [23]94x, aic78x0 SCSI
243bha*	at pci? dev ? function ?	# BusLogic 9xx SCSI
244isp*	at pci? dev ? function ?	# Qlogic ISP [12]0x0 SCSI/FibreChannel
245ncr*	at pci? dev ? function ?	# NCR 53c8xx SCSI
246
247# EISA SCSI controllers
248ahb*	at eisa? slot ?			# Adaptec 174[02] SCSI
249ahc*	at eisa? slot ?			# Adaptec 274x, aic7770 SCSI
250bha*	at eisa? slot ?			# BusLogic 7xx SCSI
251uha*	at eisa? slot ?			# UltraStor 24f SCSI
252
253# PCMCIA SCSI controllers
254aic*	at pcmcia? function ?		# Adaptec APA-1460 SCSI
255
256# ISA SCSI controllers
257aha0	at isa? port 0x330 irq ? drq ?	# Adaptec 154[02] SCSI
258aha1	at isa? port 0x334 irq ? drq ?
259ahc0	at isa? port ? irq ?		# Adaptec 284x SCSI
260aic0	at isa? port 0x340 irq 11	# Adaptec 152[02] SCSI
261bha0	at isa? port 0x330 irq ? drq ?	# BusLogic [457]4X SCSI
262bha1	at isa? port 0x334 irq ? drq ?
263sea0	at isa? iomem 0xc8000 irq 5	# Seagate/Future Domain SCSI
264uha0	at isa? port 0x330 irq ? drq ?	# UltraStor [13]4f SCSI
265uha1	at isa? port 0x340 irq ? drq ?
266wds0	at isa? port 0x350 irq 15 drq 6	# WD7000 and TMC-7000 controllers
267wds1	at isa? port 0x358 irq 11 drq 5
268
269# SCSI bus support
270scsibus* at aha?
271scsibus* at ahb?
272scsibus* at ahc?
273scsibus* at aic?
274scsibus* at bha?
275scsibus* at isp?
276scsibus* at ncr?
277scsibus* at sea?
278scsibus* at uha?
279scsibus* at wds?
280
281# SCSI devices
282sd*	at scsibus? target ? lun ?	# SCSI disk drives
283st*	at scsibus? target ? lun ?	# SCSI tape drives
284cd*	at scsibus? target ? lun ?	# SCSI CD-ROM drives
285#ch*	at scsibus? target ? lun ?	# SCSI autochangers
286#ss*	at scsibus? target ? lun ?	# SCSI scanners
287#uk*	at scsibus? target ? lun ?	# SCSI unknown
288
289
290# IDE and Related Devices
291
292# ISA IDE controllers
293wdc0	at isa? port 0x1f0 irq 14	# ST506, ESDI, and IDE controllers
294wdc1	at isa? port 0x170 irq 15
295
296# IDE drives
297wd*	at wdc? drive ?			# the drives themselves
298
299# ATAPI bus support
300atapibus* at wdc?
301
302# ATAPI devices
303cd*	at atapibus? drive ?		# ATAPI CD-ROM drives
304sd*	at atapibus? drive ?		# ATAPI disk drives
305
306
307# Miscellaneous mass storage devices
308
309# ISA floppy
310fdc0	at isa? port 0x3f0 irq 6 drq 2	# standard PC floppy controllers
311#fdc1	at isa? port 0x370 irq ? drq ?
312fd*	at fdc? drive ?			# the drives themselves
313# some machines need you to do this instead of fd*
314#fd0	at fdc0 drive 0
315
316# ISA CD-ROM devices
317#mcd0	at isa? port 0x300 irq 10	# Mitsumi CD-ROM drives
318
319# ISA tape devices
320# note: the wt driver conflicts unpleasantly with ed devices at the
321# same I/O address. The probe reprograms their EEPROMs. Don't
322# uncomment it unless you are actually using it.
323#wt0	at isa? port 0x308 irq 5 drq 1	# Archive and Wangtek QIC tape drives
324
325
326# Network Interfaces
327
328# PCI network interfaces
329de*	at pci? dev ? function ?	# DEC 21x4x-based Ethernet
330en*	at pci? dev ? function ?	# ENI/Adaptec ATM
331ep*	at pci? dev ? function ?	# 3Com 3c59x/3c90x Ethernet
332fpa*	at pci? dev ? function ?	# DEC DEFPA FDDI
333fxp*	at pci? dev ? function ?	# Intel EtherExpress PRO 10+/100B
334le*	at pci? dev ? function ?	# PCnet-PCI Ethernet
335ne*	at pci? dev ? function ?	# NE2000-compatible Ethernet
336tl*	at pci? dev ? function ?	# ThunderLAN-based Ethernet
337
338# EISA network interfaces
339ep*	at eisa? slot ?			# 3Com 3c579 Ethernet
340fea*	at eisa? slot ?			# DEC DEFEA FDDI
341
342# ISA Plug-and-Play network interfaces
343ep*	at isapnp?			# 3Com 3c509 Ethernet
344ne*	at isapnp?			# NE2000-compatible Ethernet
345
346# PCMCIA network interfaces
347ep*	at pcmcia? function ?		# 3Com 3c589 and 3c562 Ethernet
348ne*	at pcmcia? function ?		# NE2000-compatible Ethernet
349sm*	at pcmcia? function ?		# Megahertz Ethernet
350
351# ISA network interfaces
352ec0	at isa? port 0x250 iomem 0xd8000 irq 9	# 3Com 3c503 Ethernet
353eg0	at isa? port 0x280 irq 9		# 3C505 ethernet cards
354el0	at isa? port 0x300 irq 9		# 3C501 ethernet cards
355ep0	at isa? port ? irq ?			# 3C509 ethernet cards
356fe0	at isa? port 0x2a0 irq ?		# AT1700
357ef0	at isa? port 0x360 iomem 0xd0000 irq 7	# 3C507
358ai0	at isa? port 0x360 iomem 0xd0000 irq 7	# StarLAN
359ix0	at isa? port 0x300 irq 10		# EtherExpress/16
360iy0	at isa? port 0x360 irq ?		# EtherExpress PRO 10 ISA
361lc0	at isa? port 0x320 iomem ? irq ?	# DEC EtherWORKS III (LEMAC)
362#le0	at isa? port 0x320 irq 10 drq 7		# IsoLan, NE2100, and DEPCA
363ne0	at isa? port 0x280 irq 9		# NE[12]000 ethernet cards
364ne1	at isa? port 0x300 irq 10
365sm0	at isa? port 0x300 irq 10		# SMC91C9x Ethernet
366we0	at isa? port 0x280 iomem 0xd0000 irq 9	# WD/SMC Ethernet
367we1	at isa? port 0x300 iomem 0xcc000 irq 10
368
369# MII bus support
370mii*	at tl?
371
372# MII PHY network interfaces
373tlphy*	at mii? dev ?			# ThunderLAN PHYs
374nsphy*	at mii? dev ?			# NS and compatible PHYs
375
376
377# Audio Devices
378
379# ISA Plug-and-Play audio devices
380#guspnp*	at isapnp?			# Gravis Ultra Sound PnP audio
381#sb*	at isapnp?			# SoundBlaster-compatible audio
382
383# ISA audio devices
384#gus0	at isa? port 0x220 irq 7 drq 1 drq2 6	# Gravis Ultra Sound
385#pas0	at isa? port 0x220 irq 7 drq 1		# ProAudio Spectrum
386#pss0	at isa? port 0x220 irq 7 drq 6  	# Personal Sound System
387#sp0	at pss0 port 0x530 irq 10 drq 0		# 	sound port driver
388#sb0	at isa? port 0x220 irq 7 drq 1 drq2 5	# SoundBlaster
389#wss0	at isa? port 0x530 irq 10 drq 0	drq2 1	# Windows Sound System
390
391# Audio support
392#audio*	at gus?
393#audio*	at guspnp?
394#audio*	at pas?
395#audio*	at sb?
396#audio*	at sp?
397#audio*	at wss?
398
399# The spkr driver provides a simple tone interface to the built in speaker.
400#spkr0	at pckbd? port 0x61		# PC speaker
401
402
403# Mice
404
405# ISA busmice
406#lms0	at isa? port 0x23c irq 5	# Logitech bus mouse
407#lms1	at isa? port 0x238 irq 5
408#mms0	at isa? port 0x23c irq 5	# Microsoft InPort mouse
409#mms1	at isa? port 0x238 irq 5
410#pms0	at pckbd? irq 12		# PS/2 auxiliary port mouse
411
412
413# Joysticks
414
415# ISA Plug-and-Play joysticks
416#joy*	at isapnp?			# Game ports (usually on audio cards)
417
418# ISA joysticks. Probe is a little strange; add only if you have one.
419#joy0	at isa? port 0x201
420
421
422# Miscellaneous Devices
423
424# Planetconnect Satellite receiver driver.
425#satlink0 at isa? port 0x300 drq 1
426
427
428# Pull in optional local configuration
429include	"arch/i386/conf/GENERIC.local"
430
431
432# Pseudo-Devices
433
434# disk/mass storage pseudo-devices
435#pseudo-device	ccd		4	# concatenated/striped disk devices
436pseudo-device	md		1	# memory disk device (ramdisk)
437#pseudo-device	vnd		4	# disk-like interface to files
438
439# network pseudo-devices
440#pseudo-device	bpfilter	8	# Berkeley packet filter
441#pseudo-device	ipfilter		# IP filter (firewall) and NAT
442pseudo-device	loop			# network loopback
443pseudo-device	ppp		2	# Point-to-Point Protocol
444pseudo-device	sl		2	# Serial Line IP
445#pseudo-device	strip		2	# Starmode Radio IP (Metricom)
446#pseudo-device	tun		2	# network tunneling over tty
447
448# miscellaneous pseudo-devices
449pseudo-device	pty		64	# pseudo-terminals
450#pseudo-device	tb		1	# tablet line discipline
451
452# rnd is EXPERIMENTAL at this point.
453#pseudo-device	rnd			# /dev/random and in-kernel generator
454#options 	RND_COM			# use "com" randomness as well (BROKEN)
455