freebsd-dev/sys/alpha/conf/NOTES

# $FreeBSD$
#
# This file contains machine dependent kernel configuration notes.  For
# machine independent notes, look in /sys/conf/NOTES.

# This directive is mandatory.  It defines the architecture to be
# configured for.  In this case, this kernel is for a machine using
# Alpha processors.
#
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


#####################################################################
# PLATFORM OPTIONS

options 	API_UP1000		# UP1000, UP1100 (Nautilus)
options 	DEC_EB164		# EB164, PC164, PC164LX, PC164SX
options 	DEC_EB64PLUS		# EB64+, AlphaPC64, Aspen Alpine, etc
options 	DEC_2100_A50		# AlphaStation 200, 250, 255, 400
options 	DEC_2100_A500		# AlphaServer 2000, 2100, 2100A
options 	DEC_KN20AA		# AlphaStation 500, 600
options 	DEC_ST550		# Personal Workstation 433, 500, 600
options 	DEC_ST6600		# XP1000, DP264, DS20, DS10, family
options 	DEC_1000A		# AlphaServer 1000, 1000A, 800
options 	DEC_KN300		# AlphaServer 4100 (Rawhide),
					# AlphaServer 1200 (Tincup)


#####################################################################
# HARDWARE BUS CONFIGURATION

device		isa
device		eisa
device		pci


#####################################################################
# HARDWARE DEVICE CONFIGURATION

#
# Mandatory devices:
#

device		mcclock		# MC146818 real time clock device

#
# Optional devices:
#

device		tga		# TGA video card driver


#####################################################################
# ABI Emulation

# Enable OSF/1 ABI emulation
options 	COMPAT_OSF1

# Enable Linux ABI emulation (requires COMPAT_OSF1)
options 	COMPAT_LINUX

# Enable the linux-like proc filesystem support (requires COMPAT_LINUX
# and PSEUDOFS)
options 	LINPROCFS
-												Some style cleanups.

Submitted by:	bde

											
										
										
											2002-07-16 15:40:19 +00:00
+								# $FreeBSD$
-												Add initial support for the FreeBSD/alpha kernel.  This is very much a
work in progress and has never booted a real machine.  Initial
development and testing was done using SimOS (see
http://simos.stanford.edu for details).  On the SimOS simulator, this
port successfully reaches single-user mode and has been tested with
loads as high as one copy of /bin/ls :-).

Obtained from: partly from NetBSD/alpha

											
										
										
											1998-06-10 10:57:29 +00:00
+								#
-												Add a NOTES file for the Alpha architecture.

											
										
										
											2002-07-15 17:50:17 +00:00
+								# This file contains machine dependent kernel configuration notes.  For
 								# machine independent notes, look in /sys/conf/NOTES.
 								# This directive is mandatory.  It defines the architecture to be
 								# configured for.  In this case, this kernel is for a machine using
 								# Alpha processors.
-												Add initial support for the FreeBSD/alpha kernel.  This is very much a
work in progress and has never booted a real machine.  Initial
development and testing was done using SimOS (see
http://simos.stanford.edu for details).  On the SimOS simulator, this
port successfully reaches single-user mode and has been tested with
loads as high as one copy of /bin/ls :-).

Obtained from: partly from NetBSD/alpha

											
										
										
											1998-06-10 10:57:29 +00:00
+								#
-												Dequote like on the i386 configs.  Also remove some references to old
i386 isa drivers that used to be order sensitive.  The probe order of
those drivers is now determined by a list in isa_compat.c and config
file order is totally irrelevant.

											
										
										
											1999-06-29 18:24:09 +00:00
+								machine		alpha
-												Add a NOTES file for the Alpha architecture.

											
										
										
											2002-07-15 17:50:17 +00:00
 								#####################################################################
 								# 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.
-												Dequote like on the i386 configs.  Also remove some references to old
i386 isa drivers that used to be order sensitive.  The probe order of
those drivers is now determined by a list in isa_compat.c and config
file order is totally irrelevant.

											
										
										
											1999-06-29 18:24:09 +00:00
+								cpu		EV4
 								cpu		EV5
-												Borrow phk's axe and apply the next stage of config(8)'s evolution.

Use Warner Losh's "hint" driver to decode ascii strings to fill the
resource table at boot time.

config(8) no longer generates an ioconf.c table - ie: the configuration
no longer has to be compiled into the kernel.  You can reconfigure your
isa devices with the likes of this at loader(8) time:
  set hint.ed.0.port=0x320

userconfig will be rewritten to use this style interface one day and will
move to /boot/userconfig.4th or something like that.

It is still possible to statically compile in a set of hints into a kernel
if you do not wish to use loader(8).  See the "hints" directive in GENERIC
as an example.

All device wiring has been moved out of config(8).  There is a set of
helper scripts (see i386/conf/gethints.pl, and the same for alpha and pc98)
that extract the 'at isa? port foo irq bar' from the old files and produces
a hints file.  If you install this file as /boot/device.hints (and update
/boot/defaults/loader.conf - You can do a build/install in sys/boot) then
loader will load it automatically for you.  You can also compile in the
hints directly with:  hints "device.hints"  as well.

There are a few things that I'm not too happy with yet.  Under this scheme,
things like LINT would no longer be useful as "documentation" of settings.
I have renamed this file to 'NOTES' and stored the example hints strings
in it.  However... this is not something that config(8) understands, so
there is a script that extracts the build-specific data from the
documentation file (NOTES) to produce a LINT that can be config'ed and
built.  A stack of man4 pages will need updating. :-/

Also, since there is no longer a difference between 'device' and
'pseudo-device' I collapsed the two together, and the resulting 'device'
takes a 'number of units' for devices that still have it statically
allocated.  eg:  'device fe 4' will compile the fe driver with NFE set
to 4.  You can then set hints for 4 units (0 - 3).  Also note that
'device fe0' will be interpreted as "zero units of 'fe'" which would be
bad, so there is a config warning for this.  This is only needed for
old drivers that still have static limits on numbers of units.
All the statically limited drivers that I could find were marked.

Please exercise EXTREME CAUTION when transitioning!

Moral support by: phk, msmith, dfr, asmodai, imp, and others

											
										
										
											2000-06-13 22:28:50 +00:00
-												Add a NOTES file for the Alpha architecture.

											
										
										
											2002-07-15 17:50:17 +00:00
 								#####################################################################
 								# PLATFORM OPTIONS
-												Make the contents, layout, and comments match sys/i386/conf/GENERIC as
much as possible.  This commit also adds the `bpf' pseudo-device.

											
										
										
											1999-10-14 09:52:28 +00:00
-												Fix style nits.

											
										
										
											2001-08-17 16:54:09 +00:00
+								options 	API_UP1000		# UP1000, UP1100 (Nautilus)
-												Acutally our style is "options\x20\x09".

As BDE says:  "options\x09\x09foo" looks quite different from
"options\x20\x09foo" after adding a one or two character prefix.

Notice by:	BDE

											
										
										
											1999-10-15 07:07:43 +00:00
+								options 	DEC_EB164		# EB164, PC164, PC164LX, PC164SX
-												Add AlphaPC64 to comments. Correct names (ds10 -> DS10 etc)

											
										
										
											2001-09-30 12:09:50 +00:00
+								options 	DEC_EB64PLUS		# EB64+, AlphaPC64, Aspen Alpine, etc
-												Acutally our style is "options\x20\x09".

As BDE says:  "options\x09\x09foo" looks quite different from
"options\x20\x09foo" after adding a one or two character prefix.

Notice by:	BDE

											
										
										
											1999-10-15 07:07:43 +00:00
+								options 	DEC_2100_A50		# AlphaStation 200, 250, 255, 400
-												Add AlphaServer 2000 (demi-sable), 2100 (sable), and 2100A (lynx) support.
Only PCI and on-board ISA peripherials are supported at this time.

This support has been only lightly tested due to a lack of response to my
call for testers on the freebsd-alpha mailing list.  It works quite well
on the one AS2100 on which it has been tested, but it may not work on
an AS2100A and should therefore be regarded as experimental.

											
										
										
											2000-05-28 02:52:54 +00:00
+								options 	DEC_2100_A500		# AlphaServer 2000, 2100, 2100A
-												Acutally our style is "options\x20\x09".

As BDE says:  "options\x09\x09foo" looks quite different from
"options\x20\x09foo" after adding a one or two character prefix.

Notice by:	BDE

											
										
										
											1999-10-15 07:07:43 +00:00
+								options 	DEC_KN20AA		# AlphaStation 500, 600
 								options 	DEC_ST550		# Personal Workstation 433, 500, 600
-												Add AlphaPC64 to comments. Correct names (ds10 -> DS10 etc)

											
										
										
											2001-09-30 12:09:50 +00:00
+								options 	DEC_ST6600		# XP1000, DP264, DS20, DS10, family
-												A port of NetBSD's AlphaServer 1000 and 1000A support.  Thanks to Cristian
Angelini for allowing me to use his AS1000 to do the port.

Note that this is untested on AlphaServer 1000A hardware.

Reviewed by:	dfr
Tested by:   	Cristian Angelini <chr.ang@biella.alpcom.it>
Obtained From: 	NetBSD

											
										
										
											1999-12-01 15:25:04 +00:00
+								options 	DEC_1000A		# AlphaServer 1000, 1000A, 800
-												Some style cleanups.

Submitted by:	bde

											
										
										
											2002-07-16 15:40:19 +00:00
+								options 	DEC_KN300		# AlphaServer 4100 (Rawhide),
 													# AlphaServer 1200 (Tincup)
-												Add initial support for the FreeBSD/alpha kernel.  This is very much a
work in progress and has never booted a real machine.  Initial
development and testing was done using SimOS (see
http://simos.stanford.edu for details).  On the SimOS simulator, this
port successfully reaches single-user mode and has been tested with
loads as high as one copy of /bin/ls :-).

Obtained from: partly from NetBSD/alpha

											
										
										
											1998-06-10 10:57:29 +00:00
-												Add a NOTES file for the Alpha architecture.

											
										
										
											2002-07-15 17:50:17 +00:00
 								#####################################################################
 								# HARDWARE BUS CONFIGURATION
-												Update GENERIC/SIMOS to leave out the useless trailing digit in pci
and other unwired devices.

											
										
										
											2000-01-23 12:22:25 +00:00
+								device		isa
-												Enable eisa support on alpha.
We need eisa bridge support on some models, which now depends on having
eisa in the kernel.

											
										
										
											2003-07-21 19:15:25 +00:00
+								device		eisa
-												de-count pci now that ahc/ahd are taken care of.

											
										
										
											2002-07-23 06:36:23 +00:00
+								device		pci
-												Update the alpha port to use the new syscons.

Submitted by: Kazutaka YOKOTA <yokota@zodiac.mech.utsunomiya-u.ac.jp> (partly)

											
										
										
											1999-01-23 16:53:30 +00:00
-												Add a NOTES file for the Alpha architecture.

											
										
										
											2002-07-15 17:50:17 +00:00
 								#####################################################################
 								# HARDWARE DEVICE CONFIGURATION
-												Update the alpha port to use the new syscons.

Submitted by: Kazutaka YOKOTA <yokota@zodiac.mech.utsunomiya-u.ac.jp> (partly)

											
										
										
											1999-01-23 16:53:30 +00:00
-												Add a NOTES file for the Alpha architecture.

											
										
										
											2002-07-15 17:50:17 +00:00
+								#
 								# Mandatory devices:
 								#
-												Add initial support for the FreeBSD/alpha kernel.  This is very much a
work in progress and has never booted a real machine.  Initial
development and testing was done using SimOS (see
http://simos.stanford.edu for details).  On the SimOS simulator, this
port successfully reaches single-user mode and has been tested with
loads as high as one copy of /bin/ls :-).

Obtained from: partly from NetBSD/alpha

											
										
										
											1998-06-10 10:57:29 +00:00
-												Some style cleanups.

Submitted by:	bde

											
										
										
											2002-07-16 15:40:19 +00:00
+								device		mcclock		# MC146818 real time clock device
-												Make the contents, layout, and comments match sys/i386/conf/GENERIC as
much as possible.  This commit also adds the `bpf' pseudo-device.

											
										
										
											1999-10-14 09:52:28 +00:00
-												Add a NOTES file for the Alpha architecture.

											
										
										
											2002-07-15 17:50:17 +00:00
+								#
 								# Optional devices:
 								#
-												Some style cleanups.

Submitted by:	bde

											
										
										
											2002-07-16 15:40:19 +00:00
+								device		tga		# TGA video card driver
-												Add a NOTES file for the Alpha architecture.

											
										
										
											2002-07-15 17:50:17 +00:00
 								#####################################################################
-												Remove empty simulator options section and add an ABI emulation section.
Add COMPAT_OSF1, COMPAT_LINUX, and LINPROCFS options to the ABI emulation
section.

											
										
										
											2003-04-15 20:21:56 +00:00
+								# ABI Emulation
 								# Enable OSF/1 ABI emulation
 								options 	COMPAT_OSF1
 								# Enable Linux ABI emulation (requires COMPAT_OSF1)
 								options 	COMPAT_LINUX
 								# Enable the linux-like proc filesystem support (requires COMPAT_LINUX
 								# and PSEUDOFS)
 								options 	LINPROCFS