INSTALL revision 1.112
11.112Schristos# $NetBSD: INSTALL,v 1.112 2016/12/13 20:42:21 christos Exp $ 21.1Soki 31.1Soki# 41.7Sminoura# INSTALL -- installation kernel. 51.1Soki# 61.1Soki 71.7Sminourainclude "arch/x68k/conf/std.x68k" 81.1Soki 91.51Satatat#options INCLUDE_CONFIG_FILE # embed config file in kernel binary 101.51Satatat 111.112Schristos#ident "INSTALL-$Revision: 1.112 $" 121.33Sabs 131.42Slukemmakeoptions COPTS="-Os" # Optimise for space. Implies -O2 141.23Sminoura 151.28Sminouramaxusers 4 161.1Soki 171.7Sminoura## Enable the hooks used for initializing the memory-disk. 181.7Sminouraoptions MEMORY_DISK_HOOKS 191.42Slukemoptions MEMORY_DISK_IS_ROOT # Force root on memory-disk 201.7Sminouraoptions MEMORY_DISK_SERVER=0 # No user space hooks 211.109Schristosoptions MEMORY_DISK_ROOT_SIZE=3600 # 1.8 Mbytes 221.86Sjymoptions MEMORY_DISK_RBFLAGS=RB_SINGLE # boot in single-user mode 231.7Sminoura 241.7Sminoura## System kernel configuration. See options(4) for more detail. 251.7Sminoura 261.7Sminoura 271.7Sminoura## Options for variants of the m68k MPU 281.7Sminoura## you must have at least the correct one; REQUIRED 291.1Sokioptions M68030 301.1Sokioptions M68040 311.1Sokioptions M68060 321.37Sminoura## If you want an optimized kernel for a specific processor, use either: 331.37Sminoura#makeoptions CMACHFLAGS="-m68030" 341.37Sminoura#makeoptions CMACHFLAGS="-m68040 -Wa,-m68030 -Wa,-m68851" 351.37Sminoura#makeoptions CMACHFLAGS="-m68060 -Wa,-m68030 -Wa,-m68851" 361.1Soki 371.1Soki 381.7Sminoura#### System options specific to the x68k port 391.1Soki 401.22Sminouraoptions EXTENDED_MEMORY # support for >16MB memory 411.7Sminouraoptions FPU_EMULATE # software fpu emulation for MC68030 421.7Sminouraoptions FPSP # floating point emulation for MC68040 431.1Sokioptions M060SP # int/fp emulation for MC68060 441.38Sminoura#options JUPITER # support for "Jupiter-X" accelerator 451.12Sminoura#options MAPPEDCOPY # use page mapping for large copyin/copyout 461.9Sminoura#options ZSCONSOLE,ZSCN_SPEED="9600" # use serial console 471.7Sminoura 481.1Soki 491.7Sminoura#### System options that are the same for all ports 501.1Soki 511.7Sminoura## Root device configuration: change the ?'s if you are going to use a 521.7Sminoura## nonstandard root partition (other than where the kernel is booted from) 531.7Sminoura## and/or nonstandard root type (not ffs or nfs). Normally this can be 541.7Sminoura## automagically determined at boot time. 551.1Soki 561.7Sminouraconfig netbsd root on ? type ? 571.10Sminoura#config netbsd root on sd0 type ffs 581.7Sminoura 591.7Sminoura## RTC is offset from GMT; -540 means JST-9 601.7Sminouraoptions RTC_OFFSET=-540 # hardware clock is this many mins. west of GMT 611.7Sminoura 621.7Sminoura## System call tracing (see ktrace(1)). 631.7Sminoura#options KTRACE 641.7Sminoura 651.7Sminoura## System V compatible IPC subsystem. (msgctl(2), semctl(2), and shmctl(2)) 661.7Sminoura#options SYSVMSG # System V message queues 671.7Sminoura#options SYSVSEM # System V semaphores 681.7Sminoura#options SYSVSHM # System V shared memory 691.7Sminoura 701.7Sminoura## Loadable kernel module support 711.47Sjdolecek 721.53Slukemoptions USERCONF # userconf(4) support 731.77Sisakioptions PIPE_SOCKETPAIR # smaller, but slower pipe(2) 741.58Satatat#options SYSCTL_INCLUDE_DESCR # Include sysctl descriptions in kernel 751.7Sminoura 761.7Sminoura## NFS boot options; not supported currently: needs nfsboot program 771.7Sminoura#options NFS_BOOT_BOOTPARAM 781.7Sminoura#options NFS_BOOT_BOOTP 791.7Sminoura#options NFS_BOOT_DHCP 801.7Sminoura 811.7Sminoura#### Debugging options 821.7Sminoura 831.7Sminoura## The DDB in-kernel debugger runs at panic (unless DDB_ONPANIC=0), or at 841.7Sminoura## serial console break or keyboard reset, where the PROM would normally 851.7Sminoura## intercept. DDB_HISTORY_SIZE adds up/down arrow command history. 861.7Sminoura#options DDB # kernel dynamic debugger 871.7Sminoura#options DDB_HISTORY_SIZE=100 # enable history editing in DDB 881.105Sszptvlfn#options DDB_ONPANIC=1 # see also sysctl(7): `ddb.onpanic' 891.7Sminoura#options PANICBUTTON # interrupt switch invokes DDB 901.7Sminoura 911.7Sminoura## You may also use gdb, on another computer connected to this machine over 921.41Slukem## a serial port. Both KGDB_DEV and KGDB_DEVRATE should be specified; 931.41Slukem## KGDB_DEV is a dev_t encoded device number of the serial port to use. 941.7Sminoura## KGDB is not supported for now. 951.41Slukem#options KGDB # support for kernel gdb 961.41Slukem#options KGDB_DEV=0xc00 # kgdb device number 971.41Slukem#options KGDB_DEVRATE=9600 # baud rate 981.7Sminoura 991.7Sminoura## Compile the kernel with debugging symbols (`netbsd.gdb' is the debug file), 1001.7Sminoura## such that gdb(1) can be used on a kernel coredump. 1011.7Sminoura 1021.42Slukem#makeoptions DEBUG="-g" 1031.7Sminoura 1041.7Sminoura## Adds code to the kernel that does internal consistency checks, and will 1051.7Sminoura## cause the kernel to panic if corruption of internal data structures 1061.7Sminoura## is detected. 1071.7Sminoura#options DIAGNOSTIC # extra kernel sanity checking 1081.7Sminoura 1091.7Sminoura## Enable (possibly expensive) debugging code that may also display messages 1101.7Sminoura## on the system console 1111.7Sminoura#options DEBUG 1121.7Sminoura 1131.7Sminoura## Make SCSI error messages more verbose when explaining their meanings. 1141.7Sminoura#options SCSIVERBOSE 1151.7Sminoura 1161.7Sminoura## `INSECURE' turns off the kernel security level (securelevel = 0 always). 1171.7Sminoura## This allows writing to /dev/mem, loading kernel modules while multi-user, 1181.7Sminoura## and other insecurities good only for development work. Do not use this 1191.7Sminoura## option on a production machine. 1201.7Sminoura#options INSECURE 1211.7Sminoura 1221.7Sminoura## `FDSCRIPTS' allows non-readable but executable scripts by providing a 1231.7Sminoura## pre-opened opaque file to the script interpreter. `SETUIDSCRIPTS', 1241.7Sminoura## which implies FDSCRIPTS, allows scripts to be set-user-id using the same 1251.7Sminoura## opaque file mechanism. Perl calls this "secure setuid scripts." 1261.7Sminoura 1271.7Sminoura#options FDSCRIPTS 1281.7Sminoura#options SETUIDSCRIPTS 1291.7Sminoura 1301.7Sminoura## Options for compatibility with previous releases foreign system binaries. 1311.7Sminoura 1321.13Sminoura#options COMPAT_43 # 4.3BSD system interfaces 1331.107Sdholland#options COMPAT_09 # NetBSD 0.9, 1341.107Sdholland#options COMPAT_10 # NetBSD 1.0, 1351.107Sdholland#options COMPAT_11 # NetBSD 1.1, 1361.107Sdholland#options COMPAT_12 # NetBSD 1.2, 1371.107Sdholland#options COMPAT_13 # NetBSD 1.3, 1381.107Sdholland#options COMPAT_14 # NetBSD 1.4, 1391.107Sdholland#options COMPAT_15 # NetBSD 1.5, 1401.107Sdholland#options COMPAT_16 # NetBSD 1.6, 1411.107Sdholland#options COMPAT_20 # NetBSD 2.0, 1421.107Sdhollandoptions COMPAT_30 # NetBSD 3.0, and 1431.107Sdhollandoptions COMPAT_40 # NetBSD 4.0 binary compatibility. 1441.45Sminoura#options COMPAT_AOUT_M68K # compatibility with NetBSD/m68k a.out 1451.7Sminoura#options COMPAT_M68K4K # NetBSD/m68k4k binaries 1461.7Sminoura#options COMPAT_SUNOS # SunOS 4.x binary compatibility; broken 1471.16Sminoura#options COMPAT_SVR4 # SVR4 binary compatibility; broken 1481.10Sminoura#options COMPAT_LINUX # Linux/m68k binary compatibility 1491.40Sabs#options TCP_COMPAT_42 # 4.2BSD TCP/IP bug compat. Not recommended. 1501.77Sisakioptions COMPAT_BSDPTY # /dev/[pt]ty?? ptys. 1511.7Sminoura 1521.44Sisaki## File systems. 1531.7Sminourafile-system FFS # Berkeley Fast Filesystem 1541.7Sminourafile-system NFS # Sun NFS-compatible filesystem client 1551.28Sminoura#file-system KERNFS # kernel data-structure filesystem 1561.104Sisaki#file-system NULLFS # NULL layered filesystem 1571.23Sminoura#file-system OVERLAY # overlay file system 1581.14Sminoura#file-system MFS # memory-based filesystem 1591.7Sminoura#file-system FDESC # user file descriptor filesystem 1601.7Sminoura#file-system UMAPFS # uid/gid remapping filesystem 1611.16Sminoura#file-system LFS # Log-structured filesystem (experimental) 1621.13Sminoura#file-system PROCFS # /proc 1631.7Sminourafile-system CD9660 # ISO 9660 + Rock Ridge file system 1641.16Sminoura#file-system UNION # union file system (a little buggy) 1651.7Sminourafile-system MSDOSFS # MS-DOS FAT filesystem(s). 1661.7Sminoura#file-system ADOSFS # AmigaDOS filesystem 1671.70Schristos#file-system PTYFS # /dev/pts/N support 1681.7Sminoura 1691.44Sisaki## File system options. 1701.7Sminoura#options NFSSERVER # Sun NFS-compatible filesystem server 1711.91Sbouyer#options QUOTA # legacy UFS quotas 1721.91Sbouyer#options QUOTA2 # new, in-filesystem UFS quotas 1731.7Sminoura#options FFS_EI # FFS Endian Independent support 1741.94Sdhollandoptions WAPBL # File system journaling support 1751.76Syamt#options NFS_V2_ONLY # Exclude NFS3 code to save space 1761.71Stsutsuioptions FFS_NO_SNAPSHOT # No FFS snapshot support 1771.22Sminoura 1781.7Sminoura## Network protocol support. In most environments, INET is required. 1791.7Sminouraoptions INET # IP (Internet Protocol) v4 1801.26Sminouraoptions INET6 # IPV6 1811.22Sminoura#options IPSEC # IP security 1821.22Sminoura#options IPSEC_DEBUG # debug for IP security 1831.7Sminoura#options GATEWAY # packet forwarding ("router switch") 1841.7Sminoura#options MROUTING # packet forwarding of multicast packets 1851.59Smanu#options PIM # Protocol Independent Multicast 1861.7Sminoura#options DIRECTED_BROADCAST # allow broadcasts through routers 1871.7Sminoura#options NETATALK # AppleTalk (over Ethernet) protocol 1881.7Sminoura#options NTP # Network Time Protocol in-kernel support 1891.7Sminoura#options PPS_SYNC # Add serial line synchronization for NTP 1901.7Sminoura#options IPFILTER_LOG # Add ipmon(8) logging for ipfilter device 1911.74Schristos#options IPFILTER_LOOKUP # ippool(8) support 1921.89Smrg#options IPFILTER_COMPAT # Compat for IP-Filter 1931.89Smrg#options IPFILTER_DEFAULT_BLOCK # block all packets by default 1941.7Sminoura#options PPP_BSDCOMP # Add BSD compression to ppp device 1951.7Sminoura#options PPP_DEFLATE # Add deflate (libz) compression to ppp device 1961.7Sminoura#options PPP_FILTER # Add active filters for ppp (via bpf) 1971.40Sabs#options TCP_DEBUG # Record last TCP_NDEBUG packets with SO_DEBUG 1981.7Sminoura 1991.7Sminoura 2001.7Sminoura#### Device configurations 2011.7Sminoura 2021.9Sminoura## Fundamental devices; see also std.x68k 2031.57Swizdmac0 at intio0 addr 0xe84000 # DMA controller 2041.9Sminouraxel0 at intio0 2051.9Sminouraopm0 at intio0 addr 0xe90000 # OPM: required for fdc 2061.7Sminoura 2071.7Sminoura## Display devices and console 2081.7Sminouragrfbus0 at mainbus0 # bitmapped displays 2091.62Schsgrf0 at grfbus0 addr 0 # multiplane graphics 2101.62Schs#grf1 at grfbus0 addr 1 # flexible graphics 2111.7Sminoura 2121.9Sminourakbd0 at mfp0 # standard keyboard 2131.62Schsite0 at grf0 grfaddr 0 # internal terminal emulator 2141.16Sminouraoptions ITE_KERNEL_ATTR=4 # bold for kernel messages 2151.9Sminoura # see /sys/arch/x68k/dev/itevar.h 2161.7Sminoura 2171.7Sminoura## floppy disks 2181.57Swizfdc0 at intio0 addr 0xe94000 intr 96 dma 0 dmaintr 100 # floppy controller 2191.7Sminourafd* at fdc0 unit ? # builtin floppy drives 2201.7Sminoura 2211.7Sminoura## SCSI devices 2221.9Sminourascsirom0 at intio0 # SCSI BIOS 2231.9Sminourascsirom1 at intio0 # SCSI BIOS 2241.9Sminouraspc* at scsirom? # genuin SCSI 2251.7Sminourascsibus* at spc? 2261.9Sminouramha0 at scsirom? # Mankai MK-HA1 (Mach-2) 2271.7Sminourascsibus* at mha0 2281.1Soki 2291.1Sokisd* at scsibus? target ? lun ? # SCSI disks 2301.1Sokicd* at scsibus? target ? lun ? # SCSI CD-ROMs 2311.7Sminourast* at scsibus? target ? lun ? # SCSI tapes 2321.7Sminoura#ss* at scsibus? target ? lun ? # SCSI scanners 2331.7Sminoura#ch* at scsibus? target ? lun ? # SCSI changer devices 2341.7Sminoura#uk* at scsibus? target ? lun ? # SCSI unknown devices 2351.7Sminoura 2361.24Sminoura## Ports 2371.9Sminourazsc0 at intio0 addr 0xe98000 intr 112 2381.7Sminourazstty0 at zsc0 channel 0 # built-in RS-232C 2391.7Sminoura#ms0 at zsc0 channel 1 # standard mouse 2401.9Sminoura#zsc1 at intio0 addr 0xeafc00 intr 113 2411.7Sminoura#zstty2 at zsc1 channel 0 2421.7Sminoura#zstty3 at zsc1 channel 1 2431.9Sminoura#zsc2 at intio0 addr 0xeafc10 intr 114 2441.7Sminoura#zstty4 at zsc2 channel 0 2451.7Sminoura#zstty5 at zsc2 channel 1 2461.24Sminoura#par0 at intio0 addr 0xe8c000 # Builtin printer port 2471.7Sminoura 2481.84Sisakisram0 at intio0 addr 0xed0000 # battery-backuped static RAM 2491.13Sminoura#pseudo-device bell # OPM bell 2501.9Sminoura 2511.95Stsutsui#com0 at intio0 addr 0xefff00 intr 240 # PSX16550, port1 2521.95Stsutsui#com1 at intio0 addr 0xefff10 intr 241 # PSX16550, port2 2531.15Sminoura 2541.39Sminoura## Audio device 2551.39Sminoura#vs0 at intio0 addr 0xe92000 dma 3 dmaintr 106 2561.39Sminoura#audio* at vs? 2571.7Sminoura 2581.112Schristos#spkr* at audio? # PC speaker (synthesized) 2591.110Snat 2601.7Sminoura## Network interfaces 2611.43Sisakine* at intio0 addr 0xece300 intr 249 # Nereid Ethernet 2621.46Sisakine* at intio0 addr 0xeceb00 intr 248 # Nereid Ethernet 2631.9Sminouraneptune0 at intio0 addr 0xece000 intr 249 # Neptune-X 2641.9Sminouraneptune1 at intio0 addr 0xece400 intr 249 # Neptune-X at alt. addr. 2651.43Sisakine* at neptune? addr 0x300 # NE2000 or clone 2661.7Sminoura 2671.7Sminoura 2681.7Sminoura#### Pseudo devices 2691.7Sminoura 2701.90Shannkenpseudo-device md # boot floppy image 2711.7Sminourapseudo-device loop 2721.96Stsutsuipseudo-device bpfilter 2731.73Scubepseudo-device sl 2741.99Schristospseudo-device pty # pseudo-terminals 275