INSTALL revision 1.7.6.7       1  1.7.6.7  minoura #	$NetBSD: INSTALL,v 1.7.6.7 1999/03/14 12:25:03 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.7.6.1  minoura maxusers	8
     10      1.1      oki 
     11      1.7  minoura ## Enable the hooks used for initializing the memory-disk.
     12      1.7  minoura options 	MEMORY_DISK_HOOKS
     13      1.7  minoura options 	MEMORY_DISK_IS_ROOT     # Force root on memory-disk
     14      1.7  minoura options 	MEMORY_DISK_SERVER=0	# No user space hooks
     15      1.7  minoura options 	MINIROOTSIZE=3074
     16      1.7  minoura #options 	MINIROOTSIZE=2880	# 1.44M, same as a floppy
     17      1.7  minoura 
     18      1.7  minoura ## System kernel configuration.  See options(4) for more detail.
     19      1.7  minoura 
     20      1.7  minoura 
     21      1.7  minoura ## Options for variants of the m68k MPU
     22      1.7  minoura ## you must have at least the correct one; REQUIRED
     23      1.1      oki options 	M68030
     24      1.1      oki options 	M68040
     25      1.1      oki options 	M68060
     26      1.1      oki 
     27      1.1      oki 
     28      1.7  minoura #### System options specific to the x68k port
     29      1.1      oki 
     30  1.7.6.1  minoura options 	UVM			# new virtual memory system
     31      1.7  minoura #options 	MACHINE_NONCONTIG	# support for noncontiguous memory
     32      1.7  minoura options 	FPU_EMULATE		# software fpu emulation for MC68030
     33      1.7  minoura options 	FPSP			# floating point emulation for MC68040
     34      1.1      oki options 	M060SP			# int/fp emulation for MC68060
     35      1.7  minoura options 	JUPITER			# support for "Jupiter-X" accelerator
     36      1.1      oki options 	MAPPEDCOPY		# use page mapping for large copyin/copyout
     37  1.7.6.1  minoura #options 	ZSCONSOLE,ZSCN_SPEED="9600"	# use serial console
     38      1.7  minoura 
     39      1.1      oki 
     40      1.7  minoura #### System options that are the same for all ports
     41      1.1      oki 
     42      1.7  minoura ## Root device configuration: change the ?'s if you are going to use a
     43      1.7  minoura ## nonstandard root partition (other than where the kernel is booted from)
     44      1.7  minoura ## and/or nonstandard root type (not ffs or nfs).  Normally this can be
     45      1.7  minoura ## automagically determined at boot time.
     46      1.1      oki 
     47      1.7  minoura config		netbsd	root on ? type ?
     48      1.7  minoura 
     49      1.7  minoura ## RTC is offset from GMT; -540 means JST-9
     50      1.7  minoura options 	RTC_OFFSET=-540	# hardware clock is this many mins. west of GMT
     51      1.7  minoura 
     52      1.7  minoura ## System call tracing (see ktrace(1)).
     53      1.7  minoura #options 	KTRACE
     54      1.7  minoura 
     55      1.7  minoura ## Collect statistics on kernel malloc's and free's.  This does have a
     56      1.7  minoura ## significant performance hit on slower machines, so it is intended for
     57      1.7  minoura ## diagnostic use only.
     58      1.7  minoura #options 	KMEMSTATS
     59      1.7  minoura 
     60      1.7  minoura ## System V compatible IPC subsystem.  (msgctl(2), semctl(2), and shmctl(2))
     61      1.7  minoura #options 	SYSVMSG		# System V message queues
     62      1.7  minoura #options 	SYSVSEM		# System V semaphores
     63      1.7  minoura #options 	SYSVSHM		# System V shared memory
     64      1.7  minoura #options 	SHMMAXPGS=1024	# 1024 pages is the default
     65      1.7  minoura 
     66      1.7  minoura ## Loadable kernel module support
     67      1.7  minoura #options 	LKM
     68      1.7  minoura 
     69      1.7  minoura ## NFS boot options; not supported currently: needs nfsboot program
     70      1.7  minoura #options 	NFS_BOOT_BOOTPARAM
     71      1.7  minoura #options 	NFS_BOOT_BOOTP
     72      1.7  minoura #options 	NFS_BOOT_DHCP
     73      1.7  minoura 
     74      1.7  minoura #### Debugging options
     75      1.7  minoura 
     76      1.7  minoura ## The DDB in-kernel debugger runs at panic (unless DDB_ONPANIC=0), or at
     77      1.7  minoura ## serial console break or keyboard reset, where the PROM would normally
     78      1.7  minoura ## intercept.  DDB_HISTORY_SIZE adds up/down arrow command history.
     79      1.7  minoura #options 	DDB			# kernel dynamic debugger
     80      1.7  minoura #options 	DDB_HISTORY_SIZE=100	# enable history editing in DDB
     81      1.7  minoura #options 	DDB_ONPANIC=1		# see also sysctl(8): `ddb.onpanic'
     82      1.7  minoura #options 	PANICBUTTON		# interrupt switch invokes DDB
     83      1.7  minoura 
     84      1.7  minoura ## You may also use gdb, on another computer connected to this machine over
     85      1.7  minoura ## a serial port.  Both KGDBDEV and KGDBRATE should be specified; KGDBDEV is
     86      1.7  minoura ## a dev_t encoded device number of the serial port to use.
     87      1.7  minoura ## KGDB is not supported for now.
     88      1.7  minoura #options 	KGDB		# support for kernel gdb
     89      1.7  minoura #options 	KGDBDEV=0xc00	# kgdb device number
     90      1.7  minoura #options 	KGDBRATE=9600	# baud rate
     91      1.7  minoura 
     92      1.7  minoura ## Compile the kernel with debugging symbols (`netbsd.gdb' is the debug file),
     93      1.7  minoura ## such that gdb(1) can be used on a kernel coredump.
     94      1.7  minoura 
     95      1.7  minoura #makeoptions 	DEBUG="-g"
     96      1.7  minoura 
     97      1.7  minoura ## Adds code to the kernel that does internal consistency checks, and will
     98      1.7  minoura ## cause the kernel to panic if corruption of internal data structures
     99      1.7  minoura ## is detected.
    100      1.7  minoura #options 	DIAGNOSTIC	# extra kernel sanity checking
    101      1.7  minoura 
    102      1.7  minoura ## Enable (possibly expensive) debugging code that may also display messages
    103      1.7  minoura ## on the system console
    104      1.7  minoura #options 	DEBUG
    105      1.7  minoura 
    106      1.7  minoura ## Make SCSI error messages more verbose when explaining their meanings.
    107      1.7  minoura #options 	SCSIVERBOSE
    108      1.7  minoura 
    109      1.7  minoura ## `INSECURE' turns off the kernel security level (securelevel = 0 always).
    110      1.7  minoura ## This allows writing to /dev/mem, loading kernel modules while multi-user,
    111      1.7  minoura ## and other insecurities good only for development work.  Do not use this
    112      1.7  minoura ## option on a production machine.
    113      1.7  minoura #options 	INSECURE
    114      1.7  minoura 
    115      1.7  minoura ## Allow non-root users to grab /dev/console with programs such as xconsole.
    116      1.7  minoura ## `xconsole' therefore does not need setuid root with this option enabled.
    117      1.7  minoura #options 	UCONSOLE
    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.7  minoura options 	COMPAT_43	# 4.3BSD system interfaces
    130      1.7  minoura #options 	COMPAT_09	# NetBSD 0.9 binary compatibility
    131      1.7  minoura #options 	COMPAT_10	# NetBSD 1.0 binary compatibility
    132      1.7  minoura #options 	COMPAT_11	# NetBSD 1.1 binary compatibility
    133      1.7  minoura #options 	COMPAT_12	# NetBSD 1.2 binary compatibility
    134      1.7  minoura #options 	COMPAT_13	# NetBSD 1.3 binary compatibility
    135      1.7  minoura #options 	COMPAT_M68K4K	# NetBSD/m68k4k binaries
    136      1.7  minoura #options 	COMPAT_SUNOS	# SunOS 4.x binary compatibility; broken
    137      1.7  minoura 
    138      1.7  minoura ## File systems.
    139      1.7  minoura file-system	FFS		# Berkeley Fast Filesystem
    140      1.7  minoura file-system	NFS		# Sun NFS-compatible filesystem client
    141      1.7  minoura file-system	KERNFS		# kernel data-structure filesystem
    142      1.7  minoura #file-system	NULLFS		# NULL layered filesystem
    143      1.7  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.7  minoura #file-system	LFS		# Log-based filesystem (still experimental)
    147      1.7  minoura #file-system	PORTAL		# portal filesystem (still experimental)
    148      1.7  minoura file-system	PROCFS		# /proc
    149      1.7  minoura file-system	CD9660		# ISO 9660 + Rock Ridge file system
    150      1.7  minoura #file-system	UNION		# union file system
    151      1.7  minoura file-system	MSDOSFS		# MS-DOS FAT filesystem(s).
    152      1.7  minoura #file-system 	ADOSFS		# AmigaDOS filesystem
    153      1.7  minoura 
    154      1.7  minoura ## File system options.
    155      1.7  minoura #options 	NFSSERVER	# Sun NFS-compatible filesystem server
    156      1.7  minoura #options 	QUOTA		# FFS quotas
    157      1.7  minoura #options 	FFS_EI		# FFS Endian Independent support
    158      1.7  minoura 
    159      1.7  minoura ## Network protocol support.  In most environments, INET is required.
    160      1.7  minoura options 	INET		# IP (Internet Protocol) v4
    161      1.7  minoura options 	TCP_COMPAT_42	# 4.2BSD IP implementation compatibility
    162      1.7  minoura #options 	GATEWAY		# packet forwarding ("router switch")
    163      1.7  minoura #options 	MROUTING	# packet forwarding of multicast packets
    164      1.7  minoura #options 	DIRECTED_BROADCAST	# allow broadcasts through routers
    165      1.7  minoura #options 	NS		# Xerox NS networking
    166      1.7  minoura #options 	NSIP		# Xerox NS tunneling over IP
    167      1.7  minoura #options 	ISO,TPIP	# OSI networking
    168      1.7  minoura #options 	EON		# OSI tunneling over IP
    169      1.7  minoura #options 	CCITT,LLC,HDLC	# X.25 packet switched protocol
    170      1.7  minoura #options 	NETATALK	# AppleTalk (over Ethernet) protocol
    171      1.7  minoura #options 	NTP		# Network Time Protocol in-kernel support
    172      1.7  minoura #options 	PPS_SYNC	# Add serial line synchronization for NTP
    173      1.7  minoura #options 	PFIL_HOOKS	# Add pfil(9) hooks, intended for custom LKMs.
    174      1.7  minoura #options 	IPFILTER_LOG	# Add ipmon(8) logging for ipfilter device
    175      1.7  minoura #options 	PPP_BSDCOMP	# Add BSD compression to ppp device
    176      1.7  minoura #options 	PPP_DEFLATE	# Add deflate (libz) compression to ppp device
    177      1.7  minoura #options 	PPP_FILTER	# Add active filters for ppp (via bpf)
    178      1.7  minoura 
    179      1.7  minoura 
    180      1.7  minoura 
    181      1.7  minoura #### Device configurations
    182      1.7  minoura 
    183  1.7.6.1  minoura ## Fundamental devices; see also std.x68k
    184  1.7.6.4  minoura dmac0	at intio0 addr 0xe84000		# DMA controler
    185  1.7.6.2  minoura xel0	at intio0
    186  1.7.6.4  minoura opm0	at intio0 addr 0xe90000		# OPM: required for fdc
    187      1.7  minoura 
    188      1.7  minoura ## Display devices and console
    189      1.7  minoura grfbus0	at mainbus0			# bitmapped displays
    190      1.7  minoura grf0	at grfbus0			# multiplane graphics
    191      1.7  minoura #grf1	at grfbus0			# flexible graphics
    192      1.7  minoura 
    193  1.7.6.1  minoura kbd0	at mfp0				# standard keyboard
    194      1.7  minoura ite0	at grf0				# internal terminal emulator
    195  1.7.6.7  minoura #options 	ITE_KERNEL_ATTR=4	# bold for kernel messages
    196  1.7.6.7  minoura 					# see /sys/arch/x68k/dev/itevar.h
    197  1.7.6.1  minoura #!pow0	at mfp0 flags 0			# power switch status; intr enabled
    198  1.7.6.1  minoura #!pow1	at mfp0 flags 1			# power switch status; read only
    199  1.7.6.1  minoura pseudo-device	pow		2	#! software power switch
    200      1.7  minoura 
    201      1.7  minoura ## floppy disks
    202  1.7.6.4  minoura fdc0	at intio0 addr 0xe94000 intr 96 dma 0 dmaintr 100 # floppy controler
    203      1.7  minoura fd*	at fdc0 unit ?			# builtin floppy drives
    204      1.7  minoura 
    205      1.7  minoura ## SCSI devices
    206  1.7.6.6  minoura scsirom0 at intio0				# SCSI BIOS
    207  1.7.6.6  minoura scsirom1 at intio0				# SCSI BIOS
    208  1.7.6.6  minoura spc*	at scsirom?				# genuin SCSI
    209      1.7  minoura scsibus* at spc?
    210  1.7.6.6  minoura mha0	at scsirom?				# Mankai MK-HA1 (Mach-2)
    211      1.7  minoura scsibus* at mha0
    212      1.1      oki 
    213      1.1      oki sd*	at scsibus? target ? lun ?	# SCSI disks
    214      1.1      oki cd*	at scsibus? target ? lun ?	# SCSI CD-ROMs
    215      1.7  minoura st*	at scsibus? target ? lun ?	# SCSI tapes
    216      1.7  minoura #ss*	at scsibus? target ? lun ?	# SCSI scanners
    217      1.7  minoura #ch*	at scsibus? target ? lun ?	# SCSI changer devices
    218      1.7  minoura #uk*	at scsibus? target ? lun ?	# SCSI unknown devices
    219      1.7  minoura 
    220      1.7  minoura ## Serial ports
    221  1.7.6.1  minoura zsc0	at intio0 addr 0xe98000 intr 112
    222      1.7  minoura zstty0	at zsc0 channel 0		# built-in RS-232C
    223      1.7  minoura #ms0	at zsc0 channel 1		# standard mouse
    224  1.7.6.1  minoura #zsc1	at intio0 addr 0xeafc00 intr 113
    225      1.7  minoura #zstty2	at zsc1 channel 0
    226      1.7  minoura #zstty3	at zsc1 channel 1
    227  1.7.6.1  minoura #zsc2	at intio0 addr 0xeafc10 intr 114
    228      1.7  minoura #zstty4	at zsc2 channel 0
    229      1.7  minoura #zstty5	at zsc2 channel 1
    230      1.7  minoura 
    231  1.7.6.1  minoura pseudo-device	sram			#! battery-backuped static RAM
    232  1.7.6.1  minoura pseudo-device	bell			#! OPM bell
    233  1.7.6.1  minoura 
    234      1.7  minoura #xcom0	at mainbus0			# NS16550 fast serial
    235      1.7  minoura #xcom1	at mainbus0
    236      1.7  minoura 
    237      1.7  minoura ## Audio device; broken
    238  1.7.6.1  minoura #okiadpcm0 at intio0 addr 0xe92000 intr 106 errintr 107 dma 3
    239      1.7  minoura #audio*	at okiadpcm*
    240      1.7  minoura 
    241      1.7  minoura ## Network interfaces
    242  1.7.6.1  minoura neptune0 at intio0 addr 0xece000 intr 249	# Neptune-X
    243  1.7.6.1  minoura neptune1 at intio0 addr 0xece400 intr 249	# Neptune-X at alt. addr.
    244  1.7.6.1  minoura ne0	at neptune? addr 0x300			# NE2000 or clone
    245      1.7  minoura #se0	at scsibus? target ? lun ?		# Ether+; not supported
    246      1.7  minoura 
    247      1.7  minoura 
    248      1.7  minoura #### Pseudo devices
    249      1.7  minoura 
    250      1.7  minoura ## A disk-like interface to files.  Can be used to create floppy, CD,
    251      1.7  minoura ## miniroot images, etc.
    252      1.7  minoura 
    253      1.7  minoura pseudo-device	vnd	4
    254      1.7  minoura 
    255      1.7  minoura ## Concatenated and striped disks; with this, you can create a software-based
    256      1.7  minoura ## disk array similar to a "RAID 0" setup.  See ccd(4).
    257      1.7  minoura 
    258  1.7.6.1  minoura #pseudo-device	ccd	4
    259  1.7.6.1  minoura 
    260  1.7.6.1  minoura ## RAIDframe disk driver: software RAID driver.  See raid(4).
    261  1.7.6.1  minoura 
    262  1.7.6.1  minoura #pseudo-device	raid	4
    263      1.7  minoura 
    264      1.7  minoura ## Memory disk device, used on boot floppies with compressed
    265      1.7  minoura ## kernel-plus-root-disk images.
    266      1.7  minoura 
    267      1.7  minoura pseudo-device	md	1
    268      1.7  minoura 
    269      1.7  minoura ## Loopback network interface; required
    270      1.7  minoura pseudo-device	loop
    271      1.7  minoura 
    272      1.7  minoura ## SLIP and CSLIP interfaces, for IP over a serial line.
    273      1.7  minoura pseudo-device	sl		1
    274      1.7  minoura 
    275      1.7  minoura ## PPP, the successor to SLIP.  See pppd(8).
    276      1.7  minoura pseudo-device	ppp		1
    277      1.7  minoura 
    278      1.7  minoura ## Network "tunnel" device, allowing protocol stacks to run in the userland.
    279      1.7  minoura ## This is used by the third-party user-mode "ppp" program, and others.
    280      1.7  minoura #pseudo-device	tun		4
    281  1.7.6.1  minoura 
    282  1.7.6.1  minoura ## Generic L3 over IP tunnel
    283  1.7.6.1  minoura #pseudo-device	gre		2	# generic L3 over IP tunnel
    284      1.7  minoura 
    285      1.7  minoura ## Berkeley Packet Filter, required to run RARPD.  A generic C-language
    286      1.7  minoura ## interface that allows selective examining of incoming packets.
    287      1.7  minoura #pseudo-device	bpfilter	8
    288      1.7  minoura 
    289      1.7  minoura ## IP Filter, used in firewall and NAT applications.  See ipnat(8) for
    290      1.7  minoura ## one example of the use of the IP Filter.
    291      1.7  minoura #pseudo-device	ipfilter
    292      1.7  minoura 
    293      1.7  minoura 
    294      1.7  minoura #### Other device configuration
    295      1.7  minoura 
    296      1.7  minoura ## Pseudo ttys, required for network logins and programs like screen.
    297      1.7  minoura ## 32 is a good number for average systems; you may have as many as you
    298      1.7  minoura ## like, though 256 is more or less the upper limit.  Increasing this
    299      1.7  minoura ## number still requires you to run /dev/MAKEDEV to create the files
    300      1.7  minoura ## for the ptys.
    301      1.7  minoura 
    302      1.7  minoura pseudo-device	pty		8	# pseudo-ttys (for network, etc.)
    303      1.7  minoura 
    304      1.7  minoura ## Random device, used to implement /dev/random (a source of random noise),
    305      1.7  minoura ## and generate randomness for some kernel formulae.
    306      1.7  minoura ## THIS DEVICE IS EXPERIMENTAL; use at your own risk.
    307      1.1      oki 
    308      1.7  minoura #pseudo-device	rnd
    309