freebsd-dev/sys/ia64/conf/NOTES

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

# directive: cpu
# You must specify at least one CPU (the one you intend to run on). Deleting
# the support for CPUs you don't need to use may make parts of the system run
# faster. There's currently no special code for the different CPUs. Note also
# that the cpu declares the family. We may need to add support for specifying
# particular models.
cpu		ITANIUM
cpu		ITANIUM2

# option: COMPAT_IA32
# This option enables the support for execution of i386 (32-bit) programs on
# ia64. It is based on the ia32 emulation in the processor.
options		COMPAT_IA32

# option: LOG2_ID_PAGE_SIZE
# Specify the log2 size of the identity (direct) mappings in regions 6 and 7
# of the virtual address space.
options 	LOG2_ID_PAGE_SIZE=27		# 128M

# option: LOG2_PAGE_SIZE
# Specify the log2 size of the page to be used for virtual memory management.
# The page size being equal to 1<<LOG2_PAGE_SIZE.
options		LOG2_PAGE_SIZE=15		# 32K

# option: SKI
# Build support for running under the ski simulator.
options		SKI

# option: UWX_TRACE_ENABLE
# Build the unwinder with tracing support. This option is used to debug the
# unwinder itself and the glue around it.
options		UWX_TRACE_ENABLE

# MI options
options		ACPI_DEBUG
options		KSTACK_PAGES=3

device		acpi

device		agp
device		isa
device		pci

# PS/2 mouse
device		psm
hint.psm.0.at="atkbdc"
hint.psm.0.irq="12"

# Options for psm:
options 	PSM_HOOKRESUME		#hook the system resume event, useful
					#for some laptops
options 	PSM_RESETAFTERSUSPEND	#reset the device at the resume event

# The keyboard controller; it controls the keyboard and the PS/2 mouse.
device		atkbdc
hint.atkbdc.0.at="isa"
hint.atkbdc.0.port="0x060"

# The AT keyboard
device		atkbd
hint.atkbd.0.at="atkbdc"
hint.atkbd.0.irq="1"

# Options for atkbd:
options 	ATKBD_DFLT_KEYMAP	# specify the built-in keymap
makeoptions	ATKBD_DFLT_KEYMAP=jp.106

# `flags' for atkbd:
#       0x01    Force detection of keyboard, else we always assume a keyboard
#       0x02    Don't reset keyboard, useful for some newer ThinkPads
#	0x03	Force detection and avoid reset, might help with certain
#		dockingstations
#       0x04    Old-style (XT) keyboard support, useful for older ThinkPads

# Video card driver for VGA adapters.
device		vga
hint.vga.0.at="isa"

# Options for vga:
# Try the following option if the mouse pointer is not drawn correctly
# or font does not seem to be loaded properly.  May cause flicker on
# some systems.
options 	VGA_ALT_SEQACCESS

# If you can dispense with some vga driver features, you may want to
# use the following options to save some memory.
#options 	VGA_NO_FONT_LOADING	# don't save/load font
#options 	VGA_NO_MODE_CHANGE	# don't change video modes

# Older video cards may require this option for proper operation.
options 	VGA_SLOW_IOACCESS	# do byte-wide i/o's to TS and GDC regs

# The following option probably won't work with the LCD displays.
options 	VGA_WIDTH90		# support 90 column modes

# Debugging.
options 	VGA_DEBUG

# AGP debugging.
options		AGP_DEBUG

# The following devices are not supported.
nodevice	fdc
nooption	FDC_DEBUG
Add the bits for a LINT kernel. It has been verified to compile. We may need to polish this. 2003-08-23 21:47:33 +00:00			`# $FreeBSD$`
			`#`
			`# This file contains machine dependent kernel configuration notes. For`
			`# machine independent notes, look in /sys/conf/NOTES.`

			`# directive: cpu`
			`# You must specify at least one CPU (the one you intend to run on). Deleting`
			`# the support for CPUs you don't need to use may make parts of the system run`
			`# faster. There's currently no special code for the different CPUs. Note also`
			`# that the cpu declares the family. We may need to add support for specifying`
			`# particular models.`
			`cpu ITANIUM`
			`cpu ITANIUM2`

Catch up with the drive-by renaming of IA32 to COMPAT_IA32. Missed 11 days ago when all the other places were fixed and finally caught by the tinderbox run... 2004-08-27 21:57:00 +00:00			`# option: COMPAT_IA32`
Add the bits for a LINT kernel. It has been verified to compile. We may need to polish this. 2003-08-23 21:47:33 +00:00			`# This option enables the support for execution of i386 (32-bit) programs on`
			`# ia64. It is based on the ia32 emulation in the processor.`
Catch up with the drive-by renaming of IA32 to COMPAT_IA32. Missed 11 days ago when all the other places were fixed and finally caught by the tinderbox run... 2004-08-27 21:57:00 +00:00			`options COMPAT_IA32`
Add the bits for a LINT kernel. It has been verified to compile. We may need to polish this. 2003-08-23 21:47:33 +00:00
Introduce IA64_ID_PAGE_{MASK\|SHIFT\|SIZE} and LOG2_ID_PAGE_SIZE. The latter is a kernel option for IA64_ID_PAGE_SHIFT, which in turn determines IA64_ID_PAGE_MASK and IA64_ID_PAGE_SIZE. The constants are used instead of the literal hardcoding (in its various forms) of the size of the direct mappings created in region 6 and 7. The default and probably only workable size is still 256M, but for kicks we use 128M for LINT. 2003-09-09 05:59:09 +00:00			`# option: LOG2_ID_PAGE_SIZE`
			`# Specify the log2 size of the identity (direct) mappings in regions 6 and 7`
			`# of the virtual address space.`
			`options LOG2_ID_PAGE_SIZE=27 # 128M`

Add the bits for a LINT kernel. It has been verified to compile. We may need to polish this. 2003-08-23 21:47:33 +00:00			`# option: LOG2_PAGE_SIZE`
			`# Specify the log2 size of the page to be used for virtual memory management.`
			`# The page size being equal to 1<<LOG2_PAGE_SIZE.`
Change LOG2_PAGE_SIZE from 14 to 15 bits. This will cause the CTASSERT in vm_page.h to be reached and thus slightly increases the overall coverage of LINT on ia64. 2003-08-25 20:02:18 +00:00			`options LOG2_PAGE_SIZE=15 # 32K`
Add the bits for a LINT kernel. It has been verified to compile. We may need to polish this. 2003-08-23 21:47:33 +00:00
			`# option: SKI`
			`# Build support for running under the ski simulator.`
			`options SKI`

			`# option: UWX_TRACE_ENABLE`
			`# Build the unwinder with tracing support. This option is used to debug the`
			`# unwinder itself and the glue around it.`
			`options UWX_TRACE_ENABLE`

			`# MI options`
			`options ACPI_DEBUG`
			`options KSTACK_PAGES=3`

			`device acpi`
Build cpufreq and acpi_perf on platforms that are likely to be able to use them. 2005-02-05 21:01:09 +00:00
Add the bits for a LINT kernel. It has been verified to compile. We may need to polish this. 2003-08-23 21:47:33 +00:00			`device agp`
			`device isa`
			`device pci`
filter out the fdc(4) and sio(4) devices and corresponding options. Note that cy(4) uses COM_MULTIPORT, so we need to keep that option. 2004-05-17 07:03:01 +00:00
Move more MD devices and options out of MI NOTES. 2006-10-20 09:52:27 +00:00			`# PS/2 mouse`
			`device psm`
			`hint.psm.0.at="atkbdc"`
			`hint.psm.0.irq="12"`

			`# Options for psm:`
			`options PSM_HOOKRESUME #hook the system resume event, useful`
			`#for some laptops`
			`options PSM_RESETAFTERSUSPEND #reset the device at the resume event`

			`# The keyboard controller; it controls the keyboard and the PS/2 mouse.`
			`device atkbdc`
			`hint.atkbdc.0.at="isa"`
			`hint.atkbdc.0.port="0x060"`

			`# The AT keyboard`
			`device atkbd`
			`hint.atkbd.0.at="atkbdc"`
			`hint.atkbd.0.irq="1"`

			`# Options for atkbd:`
			`options ATKBD_DFLT_KEYMAP # specify the built-in keymap`
			`makeoptions ATKBD_DFLT_KEYMAP=jp.106`

			# `flags' for atkbd:
			`# 0x01 Force detection of keyboard, else we always assume a keyboard`
			`# 0x02 Don't reset keyboard, useful for some newer ThinkPads`
			`# 0x03 Force detection and avoid reset, might help with certain`
			`# dockingstations`
			`# 0x04 Old-style (XT) keyboard support, useful for older ThinkPads`

			`# Video card driver for VGA adapters.`
			`device vga`
			`hint.vga.0.at="isa"`

			`# Options for vga:`
			`# Try the following option if the mouse pointer is not drawn correctly`
			`# or font does not seem to be loaded properly. May cause flicker on`
			`# some systems.`
			`options VGA_ALT_SEQACCESS`

			`# If you can dispense with some vga driver features, you may want to`
			`# use the following options to save some memory.`
			`#options VGA_NO_FONT_LOADING # don't save/load font`
			`#options VGA_NO_MODE_CHANGE # don't change video modes`

			`# Older video cards may require this option for proper operation.`
			`options VGA_SLOW_IOACCESS # do byte-wide i/o's to TS and GDC regs`

			`# The following option probably won't work with the LCD displays.`
			`options VGA_WIDTH90 # support 90 column modes`

			`# Debugging.`
			`options VGA_DEBUG`

Don't forget to create opt_agp.h on ia64, which also uses agp(4). 2009-02-07 09:57:14 +00:00			`# AGP debugging.`
			`options AGP_DEBUG`

Fix typo in comment. While here, end the sentence with a period and remove the empty line between the fdc and sio devices. The empty line suggests that the comment applies to fdc only while it applies to all following devices and options. Typo spotted by: ru@ 2004-05-17 18:36:14 +00:00			`# The following devices are not supported.`
filter out the fdc(4) and sio(4) devices and corresponding options. Note that cy(4) uses COM_MULTIPORT, so we need to keep that option. 2004-05-17 07:03:01 +00:00			`nodevice fdc`
			`nooption FDC_DEBUG`