INSTALL revision 1.7
11.6Sminoura# $NetBSD: INSTALL,v 1.7 1998/09/07 14:11:08 minoura Exp $ 21.1Soki 31.1Soki# 41.7Sminoura# INSTALL -- installation kernel. 51.1Soki# 61.1Soki 71.7Sminourainclude "arch/x68k/conf/std.x68k" 81.1Soki 91.7Sminouramaxusers 16 101.1Soki 111.7Sminoura## Enable the hooks used for initializing the memory-disk. 121.7Sminouraoptions MEMORY_DISK_HOOKS 131.7Sminouraoptions MEMORY_DISK_IS_ROOT # Force root on memory-disk 141.7Sminouraoptions MEMORY_DISK_SERVER=0 # No user space hooks 151.7Sminouraoptions MINIROOTSIZE=3074 161.7Sminoura#options MINIROOTSIZE=2880 # 1.44M, same as a floppy 171.7Sminoura 181.7Sminoura## System kernel configuration. See options(4) for more detail. 191.7Sminoura 201.7Sminoura 211.7Sminoura## Options for variants of the m68k MPU 221.7Sminoura## you must have at least the correct one; REQUIRED 231.1Sokioptions M68030 241.1Sokioptions M68040 251.1Sokioptions M68060 261.1Soki 271.1Soki 281.7Sminoura#### System options specific to the x68k port 291.1Soki 301.7Sminoura#options UVM # new virtual memory system 311.7Sminoura#options MACHINE_NONCONTIG # support for noncontiguous memory 321.7Sminoura#options MACHINE_NEW_NONCONTIG # new i/f for noncontig memory support 331.7Sminouraoptions FPU_EMULATE # software fpu emulation for MC68030 341.7Sminouraoptions FPSP # floating point emulation for MC68040 351.1Sokioptions M060SP # int/fp emulation for MC68060 361.7Sminouraoptions JUPITER # support for "Jupiter-X" accelerator 371.1Sokioptions MAPPEDCOPY # use page mapping for large copyin/copyout 381.7Sminouraoptions EIOMAPSIZE=0 # do not map PCI address space 391.7Sminoura 401.1Soki 411.7Sminoura#### System options that are the same for all ports 421.1Soki 431.7Sminoura## Root device configuration: change the ?'s if you are going to use a 441.7Sminoura## nonstandard root partition (other than where the kernel is booted from) 451.7Sminoura## and/or nonstandard root type (not ffs or nfs). Normally this can be 461.7Sminoura## automagically determined at boot time. 471.1Soki 481.7Sminouraconfig netbsd root on ? type ? 491.7Sminoura 501.7Sminoura## RTC is offset from GMT; -540 means JST-9 511.7Sminouraoptions RTC_OFFSET=-540 # hardware clock is this many mins. west of GMT 521.7Sminoura 531.7Sminoura## System call tracing (see ktrace(1)). 541.7Sminoura#options KTRACE 551.7Sminoura 561.7Sminoura## Collect statistics on kernel malloc's and free's. This does have a 571.7Sminoura## significant performance hit on slower machines, so it is intended for 581.7Sminoura## diagnostic use only. 591.7Sminoura#options KMEMSTATS 601.7Sminoura 611.7Sminoura## System V compatible IPC subsystem. (msgctl(2), semctl(2), and shmctl(2)) 621.7Sminoura#options SYSVMSG # System V message queues 631.7Sminoura#options SYSVSEM # System V semaphores 641.7Sminoura#options SYSVSHM # System V shared memory 651.7Sminoura#options SHMMAXPGS=1024 # 1024 pages is the default 661.7Sminoura 671.7Sminoura## Loadable kernel module support 681.7Sminoura#options LKM 691.7Sminoura 701.7Sminoura## NFS boot options; not supported currently: needs nfsboot program 711.7Sminoura#options NFS_BOOT_BOOTPARAM 721.7Sminoura#options NFS_BOOT_BOOTP 731.7Sminoura#options NFS_BOOT_DHCP 741.7Sminoura 751.7Sminoura#### Debugging options 761.7Sminoura 771.7Sminoura## The DDB in-kernel debugger runs at panic (unless DDB_ONPANIC=0), or at 781.7Sminoura## serial console break or keyboard reset, where the PROM would normally 791.7Sminoura## intercept. DDB_HISTORY_SIZE adds up/down arrow command history. 801.7Sminoura#options DDB # kernel dynamic debugger 811.7Sminoura#options DDB_HISTORY_SIZE=100 # enable history editing in DDB 821.7Sminoura#options DDB_ONPANIC=1 # see also sysctl(8): `ddb.onpanic' 831.7Sminoura#options PANICBUTTON # interrupt switch invokes DDB 841.7Sminoura 851.7Sminoura## You may also use gdb, on another computer connected to this machine over 861.7Sminoura## a serial port. Both KGDBDEV and KGDBRATE should be specified; KGDBDEV is 871.7Sminoura## a dev_t encoded device number of the serial port to use. 881.7Sminoura## KGDB is not supported for now. 891.7Sminoura#options KGDB # support for kernel gdb 901.7Sminoura#options KGDBDEV=0xc00 # kgdb device number 911.7Sminoura#options KGDBRATE=9600 # baud rate 921.7Sminoura 931.7Sminoura## Compile the kernel with debugging symbols (`netbsd.gdb' is the debug file), 941.7Sminoura## such that gdb(1) can be used on a kernel coredump. 951.7Sminoura 961.7Sminoura#makeoptions DEBUG="-g" 971.7Sminoura 981.7Sminoura## Adds code to the kernel that does internal consistency checks, and will 991.7Sminoura## cause the kernel to panic if corruption of internal data structures 1001.7Sminoura## is detected. 1011.7Sminoura#options DIAGNOSTIC # extra kernel sanity checking 1021.7Sminoura 1031.7Sminoura## Enable (possibly expensive) debugging code that may also display messages 1041.7Sminoura## on the system console 1051.7Sminoura#options DEBUG 1061.7Sminoura 1071.7Sminoura## Make SCSI error messages more verbose when explaining their meanings. 1081.7Sminoura#options SCSIVERBOSE 1091.7Sminoura 1101.7Sminoura## `INSECURE' turns off the kernel security level (securelevel = 0 always). 1111.7Sminoura## This allows writing to /dev/mem, loading kernel modules while multi-user, 1121.7Sminoura## and other insecurities good only for development work. Do not use this 1131.7Sminoura## option on a production machine. 1141.7Sminoura#options INSECURE 1151.7Sminoura 1161.7Sminoura## Allow non-root users to grab /dev/console with programs such as xconsole. 1171.7Sminoura## `xconsole' therefore does not need setuid root with this option enabled. 1181.7Sminoura#options UCONSOLE 1191.7Sminoura 1201.7Sminoura## `FDSCRIPTS' allows non-readable but executable scripts by providing a 1211.7Sminoura## pre-opened opaque file to the script interpreter. `SETUIDSCRIPTS', 1221.7Sminoura## which implies FDSCRIPTS, allows scripts to be set-user-id using the same 1231.7Sminoura## opaque file mechanism. Perl calls this "secure setuid scripts." 1241.7Sminoura 1251.7Sminoura#options FDSCRIPTS 1261.7Sminoura#options SETUIDSCRIPTS 1271.7Sminoura 1281.7Sminoura## Options for compatibility with previous releases foreign system binaries. 1291.7Sminoura 1301.7Sminouraoptions COMPAT_43 # 4.3BSD system interfaces 1311.7Sminoura#options COMPAT_09 # NetBSD 0.9 binary compatibility 1321.7Sminoura#options COMPAT_10 # NetBSD 1.0 binary compatibility 1331.7Sminoura#options COMPAT_11 # NetBSD 1.1 binary compatibility 1341.7Sminoura#options COMPAT_12 # NetBSD 1.2 binary compatibility 1351.7Sminoura#options COMPAT_13 # NetBSD 1.3 binary compatibility 1361.7Sminoura#options COMPAT_M68K4K # NetBSD/m68k4k binaries 1371.7Sminoura#options COMPAT_SUNOS # SunOS 4.x binary compatibility; broken 1381.7Sminoura 1391.7Sminoura## File systems. 1401.7Sminourafile-system FFS # Berkeley Fast Filesystem 1411.7Sminourafile-system NFS # Sun NFS-compatible filesystem client 1421.7Sminourafile-system KERNFS # kernel data-structure filesystem 1431.7Sminoura#file-system NULLFS # NULL layered filesystem 1441.7Sminourafile-system MFS # memory-based filesystem 1451.7Sminoura#file-system FDESC # user file descriptor filesystem 1461.7Sminoura#file-system UMAPFS # uid/gid remapping filesystem 1471.7Sminoura#file-system LFS # Log-based filesystem (still experimental) 1481.7Sminoura#file-system PORTAL # portal filesystem (still experimental) 1491.7Sminourafile-system PROCFS # /proc 1501.7Sminourafile-system CD9660 # ISO 9660 + Rock Ridge file system 1511.7Sminoura#file-system UNION # union file system 1521.7Sminourafile-system MSDOSFS # MS-DOS FAT filesystem(s). 1531.7Sminoura#file-system ADOSFS # AmigaDOS filesystem 1541.7Sminoura 1551.7Sminoura## File system options. 1561.7Sminoura#options NFSSERVER # Sun NFS-compatible filesystem server 1571.7Sminoura#options QUOTA # FFS quotas 1581.7Sminoura#options FFS_EI # FFS Endian Independent support 1591.7Sminoura 1601.7Sminoura## Network protocol support. In most environments, INET is required. 1611.7Sminouraoptions INET # IP (Internet Protocol) v4 1621.7Sminouraoptions TCP_COMPAT_42 # 4.2BSD IP implementation compatibility 1631.7Sminoura#options GATEWAY # packet forwarding ("router switch") 1641.7Sminoura#options MROUTING # packet forwarding of multicast packets 1651.7Sminoura#options DIRECTED_BROADCAST # allow broadcasts through routers 1661.7Sminoura#options NS # Xerox NS networking 1671.7Sminoura#options NSIP # Xerox NS tunneling over IP 1681.7Sminoura#options ISO,TPIP # OSI networking 1691.7Sminoura#options EON # OSI tunneling over IP 1701.7Sminoura#options CCITT,LLC,HDLC # X.25 packet switched protocol 1711.7Sminoura#options NETATALK # AppleTalk (over Ethernet) protocol 1721.7Sminoura#options NTP # Network Time Protocol in-kernel support 1731.7Sminoura#options PPS_SYNC # Add serial line synchronization for NTP 1741.7Sminoura#options PFIL_HOOKS # Add pfil(9) hooks, intended for custom LKMs. 1751.7Sminoura#options IPFILTER_LOG # Add ipmon(8) logging for ipfilter device 1761.7Sminoura#options PPP_BSDCOMP # Add BSD compression to ppp device 1771.7Sminoura#options PPP_DEFLATE # Add deflate (libz) compression to ppp device 1781.7Sminoura#options PPP_FILTER # Add active filters for ppp (via bpf) 1791.7Sminoura 1801.7Sminoura 1811.7Sminoura 1821.7Sminoura#### Device configurations 1831.7Sminoura 1841.7Sminoura## Fundamental devices 1851.7Sminouramainbus0 at root # MANDATORY 1861.7Sminoura 1871.7Sminoura## Display devices and console 1881.7Sminouragrfbus0 at mainbus0 # bitmapped displays 1891.7Sminouragrf0 at grfbus0 # multiplane graphics 1901.7Sminoura#grf1 at grfbus0 # flexible graphics 1911.7Sminoura 1921.7Sminouraite0 at grf0 # internal terminal emulator 1931.7Sminourapseudo-device kbd # standard keyboard 1941.7Sminoura#pseudo-device pow 2 # software power switch 1951.7Sminoura 1961.7Sminoura## floppy disks 1971.7Sminourafdc0 at mainbus0 # floppy controller 1981.7Sminourafd* at fdc0 unit ? # builtin floppy drives 1991.7Sminoura 2001.7Sminoura## SCSI devices 2011.7Sminouraspc0 at mainbus0 # builtin scsi 2021.7Sminouraspc1 at mainbus0 # external scsi 2031.7Sminourascsibus* at spc? 2041.7Sminouramha0 at mainbus0 # MK-HA1 mach-2 SCSI 2051.7Sminourascsibus* at mha0 2061.1Soki 2071.1Sokisd* at scsibus? target ? lun ? # SCSI disks 2081.1Sokicd* at scsibus? target ? lun ? # SCSI CD-ROMs 2091.7Sminourast* at scsibus? target ? lun ? # SCSI tapes 2101.7Sminoura#ss* at scsibus? target ? lun ? # SCSI scanners 2111.7Sminoura#ch* at scsibus? target ? lun ? # SCSI changer devices 2121.7Sminoura#uk* at scsibus? target ? lun ? # SCSI unknown devices 2131.7Sminoura 2141.7Sminoura## Serial ports 2151.7Sminourazsc0 at mainbus0 2161.7Sminourazstty0 at zsc0 channel 0 # built-in RS-232C 2171.7Sminoura#ms0 at zsc0 channel 1 # standard mouse 2181.7Sminoura#zsc1 at mainbus0 2191.7Sminoura#zstty2 at zsc1 channel 0 2201.7Sminoura#zstty3 at zsc1 channel 1 2211.7Sminoura#zsc2 at mainbus0 2221.7Sminoura#zstty4 at zsc2 channel 0 2231.7Sminoura#zstty5 at zsc2 channel 1 2241.7Sminoura 2251.7Sminoura#xcom0 at mainbus0 # NS16550 fast serial 2261.7Sminoura#xcom1 at mainbus0 2271.7Sminoura 2281.7Sminoura#pseudo-device sram # battery-backuped static RAM 2291.7Sminoura#pseudo-device bell # OPM bell 2301.7Sminoura 2311.7Sminoura 2321.7Sminoura## Audio device; broken 2331.7Sminoura#okiadpcm0 at mainbus0 2341.7Sminoura#audio* at okiadpcm* 2351.7Sminoura 2361.7Sminoura## Network interfaces 2371.7Sminouraed0 at mainbus0 # Neptune-X 2381.7Sminoura#se0 at scsibus? target ? lun ? # Ether+; not supported 2391.7Sminoura 2401.7Sminoura 2411.7Sminoura#### Pseudo devices 2421.7Sminoura 2431.7Sminoura## A disk-like interface to files. Can be used to create floppy, CD, 2441.7Sminoura## miniroot images, etc. 2451.7Sminoura 2461.7Sminourapseudo-device vnd 4 2471.7Sminoura 2481.7Sminoura## Concatenated and striped disks; with this, you can create a software-based 2491.7Sminoura## disk array similar to a "RAID 0" setup. See ccd(4). 2501.7Sminoura 2511.7Sminourapseudo-device ccd 4 2521.7Sminoura 2531.7Sminoura## Memory disk device, used on boot floppies with compressed 2541.7Sminoura## kernel-plus-root-disk images. 2551.7Sminoura 2561.7Sminourapseudo-device md 1 2571.7Sminoura 2581.7Sminoura## Loopback network interface; required 2591.7Sminourapseudo-device loop 2601.7Sminoura 2611.7Sminoura## SLIP and CSLIP interfaces, for IP over a serial line. 2621.7Sminourapseudo-device sl 1 2631.7Sminoura 2641.7Sminoura## PPP, the successor to SLIP. See pppd(8). 2651.7Sminourapseudo-device ppp 1 2661.7Sminoura 2671.7Sminoura## Network "tunnel" device, allowing protocol stacks to run in the userland. 2681.7Sminoura## This is used by the third-party user-mode "ppp" program, and others. 2691.7Sminoura#pseudo-device tun 4 2701.7Sminoura 2711.7Sminoura## Berkeley Packet Filter, required to run RARPD. A generic C-language 2721.7Sminoura## interface that allows selective examining of incoming packets. 2731.7Sminoura#pseudo-device bpfilter 8 2741.7Sminoura 2751.7Sminoura## IP Filter, used in firewall and NAT applications. See ipnat(8) for 2761.7Sminoura## one example of the use of the IP Filter. 2771.7Sminoura#pseudo-device ipfilter 2781.7Sminoura 2791.7Sminoura 2801.7Sminoura#### Other device configuration 2811.7Sminoura 2821.7Sminoura## Pseudo ttys, required for network logins and programs like screen. 2831.7Sminoura## 32 is a good number for average systems; you may have as many as you 2841.7Sminoura## like, though 256 is more or less the upper limit. Increasing this 2851.7Sminoura## number still requires you to run /dev/MAKEDEV to create the files 2861.7Sminoura## for the ptys. 2871.7Sminoura 2881.7Sminourapseudo-device pty 8 # pseudo-ttys (for network, etc.) 2891.7Sminoura 2901.7Sminoura## Random device, used to implement /dev/random (a source of random noise), 2911.7Sminoura## and generate randomness for some kernel formulae. 2921.7Sminoura## THIS DEVICE IS EXPERIMENTAL; use at your own risk. 2931.1Soki 2941.7Sminoura#pseudo-device rnd 295