Add a NOTES file for the Alpha architecture.

1 files changed, 55 insertions, 158 deletions

diff --git a/sys/alpha/conf/NOTES b/sys/alpha/conf/NOTES
index acc7f70..63cfa0b 100644
--- a/sys/alpha/conf/NOTES
+++ b/sys/alpha/conf/NOTES
@@ -1,38 +1,36 @@
 #
-# GENERIC -- Generic kernel configuration file for FreeBSD/alpha
+# NOTES -- Lines that can be cut/pasted into kernel and hints configs.
 #
-# For more information on this file, please read the handbook section on
-# Kernel Configuration Files:
+# This file contains machine dependent kernel configuration notes.  For
+# machine independent notes, look in /sys/conf/NOTES.
 #
-#    http://www.FreeBSD.org/handbook/kernelconfig-config.html
-#
-# The handbook is also available locally in /usr/share/doc/handbook
-# if you've installed the doc distribution, otherwise always see the
-# FreeBSD World Wide Web server (http://www.FreeBSD.org/) for the
-# latest information.
+# $FreeBSD$
 #
-# An exhaustive list of options and more detailed explanations of the
-# device lines is also present in the ../../i386/conf/NOTES file. 
-# If you are in doubt as to the purpose or necessity of a line, check first 
-# in NOTES. Please note that this is the i386 NOTES, but it still contains
-# valuable info for alpha too.
+
 #
-# For hardware specific information check HARDWARE.TXT
+# This directive is mandatory.  It defines the architecture to be
+# configured for.  In this case, this kernel is for a machine using
+# Alpha processors.
 #
-# $FreeBSD$
-
 machine		alpha
+
+
+#####################################################################
+# CPU OPTIONS
+
+#
+# You must specify at least one CPU (the one you intend to run on);
+# deleting the specification for CPUs you don't need to use may make
+# parts of the system run faster.
+# XXX: On the Alpha, CPU types are never used.  This list also does
+# not include newer CPU types that are supported such as the EV6.
 cpu		EV4
 cpu		EV5
-ident		GENERIC
-maxusers	0
-
-#To statically compile in device wiring instead of /boot/device.hints
-#hints		"GENERIC.hints"
 
-makeoptions	DEBUG=-g		#Build kernel with gdb(1) debug symbols
+
+#####################################################################
+# PLATFORM OPTIONS
 
-# Platforms supported
 options 	API_UP1000		# UP1000, UP1100 (Nautilus)
 options 	DEC_AXPPCI_33		# UDB, Multia, AXPpci33, NoName
 options 	DEC_EB164		# EB164, PC164, PC164LX, PC164SX
@@ -46,144 +44,43 @@ options 	DEC_1000A		# AlphaServer 1000, 1000A, 800
 options 	DEC_KN8AE		# AlphaServer 8200/8400 (Turbolaser)
 options 	DEC_KN300		# AlphaServer 4100 (Rawhide), 1200 (Tincup)
 
-options 	INET			#InterNETworking
-options 	INET6			#IPv6 communications protocols
-options 	FFS			#Berkeley Fast Filesystem
-options 	SOFTUPDATES		#Enable FFS soft updates support
-options 	UFS_DIRHASH		#Improve performance on big directories
-options 	MD_ROOT			#MD is a potential root device
-options 	NFSCLIENT		#Network Filesystem Client
-options 	NFSSERVER		#Network Filesystem Server
-options 	NFS_ROOT		#NFS usable as root device
-options 	MSDOSFS			#MSDOS Filesystem
-options 	CD9660			#ISO 9660 Filesystem
-options 	PROCFS			#Process filesystem (requires PSEUDOFS)
-options 	PSEUDOFS		#Pseudo-filesystem framework
-options 	COMPAT_43		#Compatible with BSD 4.3 [KEEP THIS!]
-options 	COMPAT_FREEBSD4		#Compatible with FreeBSD4
-options 	SCSI_DELAY=15000	#Delay (in ms) before probing SCSI 
-options 	KTRACE			#ktrace(1) syscall trace support
-options 	SYSVSHM			#SYSV-style shared memory
-options 	SYSVMSG			#SYSV-style message queues
-options 	SYSVSEM			#SYSV-style semaphores
-options 	P1003_1B		#Posix P1003_1B real-time extentions
-options 	_KPOSIX_PRIORITY_SCHEDULING
-
-# Debugging for use in -current
-options 	DDB			#Enable the kernel debugger
-options 	INVARIANTS		#Enable calls of extra sanity checking
-options 	INVARIANT_SUPPORT	#Extra sanity checks of internal structures, required by INVARIANTS
-#options 	WITNESS			#Enable checks to detect deadlocks and cycles
-
-# To make an SMP kernel, the next line is needed
-options 	SMP			# Symmetric MultiProcessor Kernel
-
-# Standard busses
+
+#####################################################################
+# HARDWARE BUS CONFIGURATION
+
+#
+# ISA bus
+#
 device		isa
-device		pci
 
-# Floppy drives
-device		fdc
-
-# ATA and ATAPI devices
-device		ata
-device		atadisk		# ATA disk drives
-device		atapicd		# ATAPI CDROM drives
-device		atapifd		# ATAPI floppy drives
-device		atapist		# ATAPI tape drives
-
-# SCSI Controllers
-device		ahc		# AHA2940 and onboard AIC7xxx devices
-device		isp		# Qlogic family
-#device		ncr		# NCR/Symbios Logic
-device		sym		# NCR/Symbios Logic (newer chipsets + those of `ncr')
-
-# SCSI peripherals
-device		scbus		# SCSI bus (required)
-device		ch		# SCSI media changers
-device		da		# Direct Access (disks)
-device		sa		# Sequential Access (tape etc)
-device		cd		# CD
-device		pass		# Passthrough device (direct SCSI access)
-device		ses		# SCSI Environmental Services (and SAF-TE)
-
-# RAID controllers
-device		amr		# AMI MegaRAID
-device		mlx		# Mylex DAC960 family
-
-# atkbdc0 controls both the keyboard and the PS/2 mouse
-device		atkbdc	1	# At keyboard controller
-device		atkbd		# at keyboard
-device		psm		# psm mouse
-
-device		vga		# VGA screen
-device		tga		# TGA screen
+#
+# PCI bus
+#
+device		pci
 
-# splash screen/screen saver
-device		splash
+
+#####################################################################
+# HARDWARE DEVICE CONFIGURATION
 
-# syscons is the default console driver, resembling an SCO console
-device		sc	1
+#
+# Mandatory devices:
+#
 
-# real time clock
+# MC146818 real time clock device
 device		mcclock
 
-# Serial (COM) ports (required)
-device		sio		# 8250, 16[45]50 based serial ports
-
-# Parallel port
-device		ppc
-device		ppbus		# Parallel port bus (required)
-device		lpt		# Printer
-device		ppi		# Parallel port interface device
-#device		vpo		# Requires scbus and da
- 
-# PCI Ethernet NICs.
-device		de		# DEC/Intel DC21x4x (``Tulip'')
-device		txp		# 3Com 3cR990 (``Typhoon'')
-device		vx		# 3Com 3c590, 3c595 (``Vortex'')
-
-# PCI Ethernet NICs that use the common MII bus controller code.
-device		miibus		# MII bus support
-device		dc		# DEC/Intel 21143 and workalikes
-device		fxp		# Intel EtherExpress PRO/100B (82557, 82558)
-device		pcn		# AMD Am79C97x PCI 10/100 NICs
-device		rl		# RealTek 8129/8139
-device		sf		# Adaptec AIC-6915 (``Starfire'')
-device		sis		# Silicon Integrated Systems SiS 900/SiS 7016
-device		ste		# Sundance ST201 (D-Link DFE-550TX)
-device		tl		# Texas Instruments ThunderLAN
-device		vr		# VIA Rhine, Rhine II
-device		wb		# Winbond W89C840F
-device		xl		# 3Com 3c90x (``Boomerang'', ``Cyclone'')
-
-# Pseudo devices - the number indicates how many units to allocated.
-device		random		# Entropy device
-device		loop		# Network loopback
-device		ether		# Ethernet support
-device		sl		# Kernel SLIP
-device		ppp	1	# Kernel PPP
-device		tun		# Packet tunnel.
-device		pty		# Pseudo-ttys (telnet etc)
-device		md		# Memory "disks"
-device		gif		# IPv6 and IPv4 tunneling
-device		faith		# IPv6-to-IPv4 relaying/(translation)
-
-# The `bpf' device enables the Berkeley Packet Filter.
-# Be aware of the administrative consequences of enabling this!
-device		bpf		#Berkeley packet filter
-
-# USB support
-device		uhci		# UHCI PCI->USB interface
-device		ohci		# OHCI PCI->USB interface
-device		usb		# USB Bus (required)
-device		ugen		# Generic
-device		uhid		# "Human Interface Devices"
-device		ukbd		# Keyboard
-device		ulpt		# Printer
-device		umass		# Disks/Mass storage - Requires scbus and da0
-device		ums		# Mouse
-# USB Ethernet
-device		aue		# ADMtek USB ethernet
-device		cue		# CATC USB ethernet
-device		kue		# Kawasaki LSI USB ethernet
+#
+# Optional devices:
+#
+
+# Video card driver for TGA adapters.
+device		tga		# TGA screen
+
+
+#####################################################################
+# SIMULATOR OPTIONS
+
+# Include support for running under the SIMOS simulator.
+options 	SIMOS
+
+device		simos