INSTALL revision 1.46
11.46Sisaki# $NetBSD: INSTALL,v 1.46 2002/01/14 04:27:13 isaki Exp $ 21.1Soki 31.1Soki# 41.7Sminoura# INSTALL -- installation kernel. 51.1Soki# 61.1Soki 71.7Sminourainclude "arch/x68k/conf/std.x68k" 81.1Soki 91.46Sisaki#ident "INSTALL-$Revision: 1.46 $" 101.33Sabs 111.42Slukemmakeoptions COPTS="-Os" # Optimise for space. Implies -O2 121.23Sminoura 131.28Sminouramaxusers 4 141.1Soki 151.7Sminoura## Enable the hooks used for initializing the memory-disk. 161.7Sminouraoptions MEMORY_DISK_HOOKS 171.42Slukemoptions MEMORY_DISK_IS_ROOT # Force root on memory-disk 181.7Sminouraoptions MEMORY_DISK_SERVER=0 # No user space hooks 191.29Sminoura#options MINIROOTSIZE=2400 # 1.2M, same as a 130mm floppy 201.27Sminoura#options MINIROOTSIZE=2880 # 1.44M, same as a 90mm floppy 211.45Sminouraoptions MINIROOTSIZE=2550 221.7Sminoura 231.7Sminoura## System kernel configuration. See options(4) for more detail. 241.7Sminoura 251.7Sminoura 261.7Sminoura## Options for variants of the m68k MPU 271.7Sminoura## you must have at least the correct one; REQUIRED 281.1Sokioptions M68030 291.1Sokioptions M68040 301.1Sokioptions M68060 311.37Sminoura## If you want an optimized kernel for a specific processor, use either: 321.37Sminoura#makeoptions CMACHFLAGS="-m68030" 331.37Sminoura#makeoptions CMACHFLAGS="-m68040 -Wa,-m68030 -Wa,-m68851" 341.37Sminoura#makeoptions CMACHFLAGS="-m68060 -Wa,-m68030 -Wa,-m68851" 351.1Soki 361.1Soki 371.7Sminoura#### System options specific to the x68k port 381.1Soki 391.22Sminouraoptions EXTENDED_MEMORY # support for >16MB memory 401.7Sminouraoptions FPU_EMULATE # software fpu emulation for MC68030 411.7Sminouraoptions FPSP # floating point emulation for MC68040 421.1Sokioptions M060SP # int/fp emulation for MC68060 431.38Sminoura#options JUPITER # support for "Jupiter-X" accelerator 441.12Sminoura#options MAPPEDCOPY # use page mapping for large copyin/copyout 451.9Sminoura#options ZSCONSOLE,ZSCN_SPEED="9600" # use serial console 461.7Sminoura 471.1Soki 481.7Sminoura#### System options that are the same for all ports 491.1Soki 501.7Sminoura## Root device configuration: change the ?'s if you are going to use a 511.7Sminoura## nonstandard root partition (other than where the kernel is booted from) 521.7Sminoura## and/or nonstandard root type (not ffs or nfs). Normally this can be 531.7Sminoura## automagically determined at boot time. 541.1Soki 551.7Sminouraconfig netbsd root on ? type ? 561.10Sminoura#config netbsd root on sd0 type ffs 571.7Sminoura 581.7Sminoura## RTC is offset from GMT; -540 means JST-9 591.7Sminouraoptions RTC_OFFSET=-540 # hardware clock is this many mins. west of GMT 601.7Sminoura 611.7Sminoura## System call tracing (see ktrace(1)). 621.7Sminoura#options KTRACE 631.7Sminoura 641.7Sminoura## Collect statistics on kernel malloc's and free's. This does have a 651.7Sminoura## significant performance hit on slower machines, so it is intended for 661.7Sminoura## diagnostic use only. 671.7Sminoura#options KMEMSTATS 681.7Sminoura 691.7Sminoura## System V compatible IPC subsystem. (msgctl(2), semctl(2), and shmctl(2)) 701.7Sminoura#options SYSVMSG # System V message queues 711.7Sminoura#options SYSVSEM # System V semaphores 721.7Sminoura#options SYSVSHM # System V shared memory 731.7Sminoura#options SHMMAXPGS=1024 # 1024 pages is the default 741.7Sminoura 751.7Sminoura## Loadable kernel module support 761.7Sminoura#options LKM 771.7Sminoura 781.7Sminoura## NFS boot options; not supported currently: needs nfsboot program 791.7Sminoura#options NFS_BOOT_BOOTPARAM 801.7Sminoura#options NFS_BOOT_BOOTP 811.7Sminoura#options NFS_BOOT_DHCP 821.7Sminoura 831.7Sminoura#### Debugging options 841.7Sminoura 851.7Sminoura## The DDB in-kernel debugger runs at panic (unless DDB_ONPANIC=0), or at 861.7Sminoura## serial console break or keyboard reset, where the PROM would normally 871.7Sminoura## intercept. DDB_HISTORY_SIZE adds up/down arrow command history. 881.7Sminoura#options DDB # kernel dynamic debugger 891.7Sminoura#options DDB_HISTORY_SIZE=100 # enable history editing in DDB 901.7Sminoura#options DDB_ONPANIC=1 # see also sysctl(8): `ddb.onpanic' 911.7Sminoura#options PANICBUTTON # interrupt switch invokes DDB 921.7Sminoura 931.7Sminoura## You may also use gdb, on another computer connected to this machine over 941.41Slukem## a serial port. Both KGDB_DEV and KGDB_DEVRATE should be specified; 951.41Slukem## KGDB_DEV is a dev_t encoded device number of the serial port to use. 961.7Sminoura## KGDB is not supported for now. 971.41Slukem#options KGDB # support for kernel gdb 981.41Slukem#options KGDB_DEV=0xc00 # kgdb device number 991.41Slukem#options KGDB_DEVRATE=9600 # baud rate 1001.7Sminoura 1011.7Sminoura## Compile the kernel with debugging symbols (`netbsd.gdb' is the debug file), 1021.7Sminoura## such that gdb(1) can be used on a kernel coredump. 1031.7Sminoura 1041.42Slukem#makeoptions DEBUG="-g" 1051.7Sminoura 1061.7Sminoura## Adds code to the kernel that does internal consistency checks, and will 1071.7Sminoura## cause the kernel to panic if corruption of internal data structures 1081.7Sminoura## is detected. 1091.7Sminoura#options DIAGNOSTIC # extra kernel sanity checking 1101.7Sminoura 1111.7Sminoura## Enable (possibly expensive) debugging code that may also display messages 1121.7Sminoura## on the system console 1131.7Sminoura#options DEBUG 1141.7Sminoura 1151.7Sminoura## Make SCSI error messages more verbose when explaining their meanings. 1161.7Sminoura#options SCSIVERBOSE 1171.7Sminoura 1181.7Sminoura## `INSECURE' turns off the kernel security level (securelevel = 0 always). 1191.7Sminoura## This allows writing to /dev/mem, loading kernel modules while multi-user, 1201.7Sminoura## and other insecurities good only for development work. Do not use this 1211.7Sminoura## option on a production machine. 1221.7Sminoura#options INSECURE 1231.7Sminoura 1241.7Sminoura## Allow non-root users to grab /dev/console with programs such as xconsole. 1251.7Sminoura## `xconsole' therefore does not need setuid root with this option enabled. 1261.7Sminoura#options UCONSOLE 1271.7Sminoura 1281.7Sminoura## `FDSCRIPTS' allows non-readable but executable scripts by providing a 1291.7Sminoura## pre-opened opaque file to the script interpreter. `SETUIDSCRIPTS', 1301.7Sminoura## which implies FDSCRIPTS, allows scripts to be set-user-id using the same 1311.7Sminoura## opaque file mechanism. Perl calls this "secure setuid scripts." 1321.7Sminoura 1331.7Sminoura#options FDSCRIPTS 1341.7Sminoura#options SETUIDSCRIPTS 1351.7Sminoura 1361.7Sminoura## Options for compatibility with previous releases foreign system binaries. 1371.7Sminoura 1381.13Sminoura#options COMPAT_43 # 4.3BSD system interfaces 1391.7Sminoura#options COMPAT_09 # NetBSD 0.9 binary compatibility 1401.7Sminoura#options COMPAT_10 # NetBSD 1.0 binary compatibility 1411.7Sminoura#options COMPAT_11 # NetBSD 1.1 binary compatibility 1421.7Sminoura#options COMPAT_12 # NetBSD 1.2 binary compatibility 1431.7Sminoura#options COMPAT_13 # NetBSD 1.3 binary compatibility 1441.18Sminoura#options COMPAT_14 # NetBSD 1.4 binary compatibility 1451.45Sminoura#options COMPAT_AOUT_M68K # compatibility with NetBSD/m68k a.out 1461.7Sminoura#options COMPAT_M68K4K # NetBSD/m68k4k binaries 1471.7Sminoura#options COMPAT_SUNOS # SunOS 4.x binary compatibility; broken 1481.16Sminoura#options COMPAT_SVR4 # SVR4 binary compatibility; broken 1491.10Sminoura#options COMPAT_LINUX # Linux/m68k binary compatibility 1501.40Sabs#options TCP_COMPAT_42 # 4.2BSD TCP/IP bug compat. Not recommended. 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.16Sminoura#file-system NULLFS # NULL layered filesystem (buggy) 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.16Sminoura#file-system PORTAL # portal filesystem (experimental) 1631.13Sminoura#file-system PROCFS # /proc 1641.7Sminourafile-system CD9660 # ISO 9660 + Rock Ridge file system 1651.16Sminoura#file-system UNION # union file system (a little buggy) 1661.7Sminourafile-system MSDOSFS # MS-DOS FAT filesystem(s). 1671.7Sminoura#file-system ADOSFS # AmigaDOS filesystem 1681.7Sminoura 1691.44Sisaki## File system options. 1701.7Sminoura#options NFSSERVER # Sun NFS-compatible filesystem server 1711.7Sminoura#options QUOTA # FFS quotas 1721.7Sminoura#options FFS_EI # FFS Endian Independent support 1731.42Slukem#options SOFTDEP # FFS soft updates support. 1741.34Sabs#options NFS_V2_ONLY # Exclude NFS3 and NQNFS code to save space 1751.34Sabs#options VNODE_OP_NOINLINE # Save space by not inlining vnode op calls 1761.22Sminoura 1771.7Sminoura## Network protocol support. In most environments, INET is required. 1781.7Sminouraoptions INET # IP (Internet Protocol) v4 1791.26Sminouraoptions INET6 # IPV6 1801.22Sminoura#options IPSEC # IP security 1811.22Sminoura#options IPSEC_ESP # IP security (encryption part; define w/IPSEC) 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.7Sminoura#options DIRECTED_BROADCAST # allow broadcasts through routers 1861.7Sminoura#options NS # Xerox NS networking 1871.7Sminoura#options NSIP # Xerox NS tunneling over IP 1881.7Sminoura#options ISO,TPIP # OSI networking 1891.7Sminoura#options EON # OSI tunneling over IP 1901.7Sminoura#options CCITT,LLC,HDLC # X.25 packet switched protocol 1911.7Sminoura#options NETATALK # AppleTalk (over Ethernet) protocol 1921.7Sminoura#options NTP # Network Time Protocol in-kernel support 1931.7Sminoura#options PPS_SYNC # Add serial line synchronization for NTP 1941.7Sminoura#options PFIL_HOOKS # Add pfil(9) hooks, intended for custom LKMs. 1951.7Sminoura#options IPFILTER_LOG # Add ipmon(8) logging for ipfilter device 1961.7Sminoura#options PPP_BSDCOMP # Add BSD compression to ppp device 1971.7Sminoura#options PPP_DEFLATE # Add deflate (libz) compression to ppp device 1981.7Sminoura#options PPP_FILTER # Add active filters for ppp (via bpf) 1991.40Sabs#options TCP_DEBUG # Record last TCP_NDEBUG packets with SO_DEBUG 2001.7Sminoura 2011.7Sminoura 2021.7Sminoura#### Device configurations 2031.7Sminoura 2041.9Sminoura## Fundamental devices; see also std.x68k 2051.9Sminouradmac0 at intio0 addr 0xe84000 # DMA controler 2061.9Sminouraxel0 at intio0 2071.9Sminouraopm0 at intio0 addr 0xe90000 # OPM: required for fdc 2081.7Sminoura 2091.7Sminoura## Display devices and console 2101.7Sminouragrfbus0 at mainbus0 # bitmapped displays 2111.7Sminouragrf0 at grfbus0 # multiplane graphics 2121.7Sminoura#grf1 at grfbus0 # flexible graphics 2131.7Sminoura 2141.9Sminourakbd0 at mfp0 # standard keyboard 2151.7Sminouraite0 at grf0 # internal terminal emulator 2161.16Sminouraoptions ITE_KERNEL_ATTR=4 # bold for kernel messages 2171.9Sminoura # see /sys/arch/x68k/dev/itevar.h 2181.12Sminoura#pseudo-device pow 2 # software power switch 2191.7Sminoura 2201.7Sminoura## floppy disks 2211.9Sminourafdc0 at intio0 addr 0xe94000 intr 96 dma 0 dmaintr 100 # floppy controler 2221.7Sminourafd* at fdc0 unit ? # builtin floppy drives 2231.7Sminoura 2241.7Sminoura## SCSI devices 2251.9Sminourascsirom0 at intio0 # SCSI BIOS 2261.9Sminourascsirom1 at intio0 # SCSI BIOS 2271.9Sminouraspc* at scsirom? # genuin SCSI 2281.7Sminourascsibus* at spc? 2291.9Sminouramha0 at scsirom? # Mankai MK-HA1 (Mach-2) 2301.7Sminourascsibus* at mha0 2311.1Soki 2321.1Sokisd* at scsibus? target ? lun ? # SCSI disks 2331.1Sokicd* at scsibus? target ? lun ? # SCSI CD-ROMs 2341.7Sminourast* at scsibus? target ? lun ? # SCSI tapes 2351.7Sminoura#ss* at scsibus? target ? lun ? # SCSI scanners 2361.7Sminoura#ch* at scsibus? target ? lun ? # SCSI changer devices 2371.7Sminoura#uk* at scsibus? target ? lun ? # SCSI unknown devices 2381.7Sminoura 2391.24Sminoura## Ports 2401.9Sminourazsc0 at intio0 addr 0xe98000 intr 112 2411.7Sminourazstty0 at zsc0 channel 0 # built-in RS-232C 2421.7Sminoura#ms0 at zsc0 channel 1 # standard mouse 2431.9Sminoura#zsc1 at intio0 addr 0xeafc00 intr 113 2441.7Sminoura#zstty2 at zsc1 channel 0 2451.7Sminoura#zstty3 at zsc1 channel 1 2461.9Sminoura#zsc2 at intio0 addr 0xeafc10 intr 114 2471.7Sminoura#zstty4 at zsc2 channel 0 2481.7Sminoura#zstty5 at zsc2 channel 1 2491.24Sminoura#par0 at intio0 addr 0xe8c000 # Builtin printer port 2501.7Sminoura 2511.30Sminourapseudo-device sram # battery-backuped static RAM 2521.13Sminoura#pseudo-device bell # OPM bell 2531.9Sminoura 2541.7Sminoura#xcom0 at mainbus0 # NS16550 fast serial 2551.7Sminoura#xcom1 at mainbus0 2561.15Sminoura 2571.39Sminoura## Audio device 2581.39Sminoura#vs0 at intio0 addr 0xe92000 dma 3 dmaintr 106 2591.39Sminoura#audio* at vs? 2601.7Sminoura 2611.7Sminoura## Network interfaces 2621.43Sisakine* at intio0 addr 0xece300 intr 249 # Nereid Ethernet 2631.46Sisakine* at intio0 addr 0xeceb00 intr 248 # Nereid Ethernet 2641.9Sminouraneptune0 at intio0 addr 0xece000 intr 249 # Neptune-X 2651.9Sminouraneptune1 at intio0 addr 0xece400 intr 249 # Neptune-X at alt. addr. 2661.43Sisakine* at neptune? addr 0x300 # NE2000 or clone 2671.7Sminoura 2681.7Sminoura 2691.7Sminoura#### Pseudo devices 2701.7Sminoura 2711.7Sminoura## A disk-like interface to files. Can be used to create floppy, CD, 2721.7Sminoura## miniroot images, etc. 2731.7Sminoura 2741.12Sminoura#pseudo-device vnd 4 2751.7Sminoura 2761.7Sminoura## Concatenated and striped disks; with this, you can create a software-based 2771.7Sminoura## disk array similar to a "RAID 0" setup. See ccd(4). 2781.7Sminoura 2791.28Sminoura#pseudo-device ccd 4 2801.9Sminoura 2811.9Sminoura## RAIDframe disk driver: software RAID driver. See raid(4). 2821.9Sminoura 2831.9Sminoura#pseudo-device raid 4 2841.24Sminoura#options RAID_AUTOCONFIG # auto-configuration of RAID components 2851.7Sminoura 2861.7Sminoura## Memory disk device, used on boot floppies with compressed 2871.7Sminoura## kernel-plus-root-disk images. 2881.7Sminoura 2891.7Sminourapseudo-device md 1 2901.7Sminoura 2911.7Sminoura## Loopback network interface; required 2921.7Sminourapseudo-device loop 2931.7Sminoura 2941.7Sminoura## SLIP and CSLIP interfaces, for IP over a serial line. 2951.7Sminourapseudo-device sl 1 2961.7Sminoura 2971.7Sminoura## PPP, the successor to SLIP. See pppd(8). 2981.13Sminoura#pseudo-device ppp 1 2991.7Sminoura 3001.7Sminoura## Network "tunnel" device, allowing protocol stacks to run in the userland. 3011.7Sminoura## This is used by the third-party user-mode "ppp" program, and others. 3021.7Sminoura#pseudo-device tun 4 3031.9Sminoura 3041.9Sminoura## Generic L3 over IP tunnel 3051.9Sminoura#pseudo-device gre 2 # generic L3 over IP tunnel 3061.7Sminoura 3071.7Sminoura## Berkeley Packet Filter, required to run RARPD. A generic C-language 3081.7Sminoura## interface that allows selective examining of incoming packets. 3091.44Sisaki#pseudo-device bpfilter 4 3101.7Sminoura 3111.7Sminoura## IP Filter, used in firewall and NAT applications. See ipnat(8) for 3121.7Sminoura## one example of the use of the IP Filter. 3131.7Sminoura#pseudo-device ipfilter 3141.7Sminoura 3151.22Sminoura## for IPv6 3161.44Sisaki#pseudo-device gif 1 # IPv[46] over IPv[46] tunnel (RFC1933) 3171.22Sminoura#pseudo-device faith 1 # IPv[46] tcp relay translation i/f 3181.28Sminoura#pseudo-device stf 1 # 6to4 IPv6 over IPv4 encapsulation 3191.44Sisaki 3201.44Sisaki## IEEE 802.1Q Virtual LAN encapsulation, see vlan(4). 3211.44Sisaki#pseudo-device vlan 3221.44Sisaki 3231.44Sisaki## Simple inter-network traffic bridging 3241.44Sisaki#pseudo-device bridge 3251.7Sminoura 3261.7Sminoura#### Other device configuration 3271.7Sminoura 3281.7Sminoura## Pseudo ttys, required for network logins and programs like screen. 3291.16Sminoura 3301.35Sabspseudo-device pty 2 # pseudo-terminals (Sysinst needs two) 3311.7Sminoura 3321.7Sminoura## Random device, used to implement /dev/random (a source of random noise), 3331.7Sminoura## and generate randomness for some kernel formulae. 3341.16Sminoura 3351.7Sminoura#pseudo-device rnd 336