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