Module Name: src
Committed By: jruoho
Date: Thu Jan 13 21:05:51 UTC 2011
Modified Files:
src/distrib/sets/lists/man: mi
src/share/man/man4/man4.x86: Makefile
Added Files:
src/share/man/man4/man4.x86: ioapic.4
Log Message:
Add ioapic(4). XXX: Needs some work; I'll try to revisit this later.
To generate a diff of this commit:
cvs rdiff -u -r1.1275 -r1.1276 src/distrib/sets/lists/man/mi
cvs rdiff -u -r1.4 -r1.5 src/share/man/man4/man4.x86/Makefile
cvs rdiff -u -r0 -r1.1 src/share/man/man4/man4.x86/ioapic.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/distrib/sets/lists/man/mi
diff -u src/distrib/sets/lists/man/mi:1.1275 src/distrib/sets/lists/man/mi:1.1276
--- src/distrib/sets/lists/man/mi:1.1275 Wed Jan 12 16:18:58 2011
+++ src/distrib/sets/lists/man/mi Thu Jan 13 21:05:49 2011
@@ -1,4 +1,4 @@
-# $NetBSD: mi,v 1.1275 2011/01/12 16:18:58 pooka Exp $
+# $NetBSD: mi,v 1.1276 2011/01/13 21:05:49 jruoho Exp $
#
# Note: don't delete entries from here - mark them as "obsolete" instead.
#
@@ -1767,6 +1767,7 @@
./usr/share/man/cat4/x86/fwhrng.0 man-sys-catman .cat
./usr/share/man/cat4/x86/hpet.0 man-sys-catman .cat
./usr/share/man/cat4/x86/ichlpcib.0 man-sys-catman .cat
+./usr/share/man/cat4/x86/ioapic.0 man-sys-catman .cat
./usr/share/man/cat4/xbd.0 man-sys-catman .cat
./usr/share/man/cat4/xbdback.0 man-sys-catman .cat
./usr/share/man/cat4/xbox.0 man-sys-catman .cat
@@ -4422,6 +4423,7 @@
./usr/share/man/html4/x86/fwhrng.html man-sys-htmlman html
./usr/share/man/html4/x86/hpet.html man-sys-htmlman html
./usr/share/man/html4/x86/ichlpcib.html man-sys-htmlman html
+./usr/share/man/html4/x86/ioapic.html man-sys-htmlman html
./usr/share/man/html4/xbd.html man-sys-htmlman html
./usr/share/man/html4/xbdback.html man-sys-htmlman html
./usr/share/man/html4/xbox.html man-sys-htmlman html
@@ -7015,6 +7017,7 @@
./usr/share/man/man4/x86/fwhrng.4 man-sys-man .man
./usr/share/man/man4/x86/hpet.4 man-sys-man .man
./usr/share/man/man4/x86/ichlpcib.4 man-sys-man .man
+./usr/share/man/man4/x86/ioapic.4 man-sys-man .man
./usr/share/man/man4/xbd.4 man-sys-man .man
./usr/share/man/man4/xbdback.4 man-sys-man .man
./usr/share/man/man4/xbox.4 man-sys-man .man
Index: src/share/man/man4/man4.x86/Makefile
diff -u src/share/man/man4/man4.x86/Makefile:1.4 src/share/man/man4/man4.x86/Makefile:1.5
--- src/share/man/man4/man4.x86/Makefile:1.4 Fri Aug 6 17:00:13 2010
+++ src/share/man/man4/man4.x86/Makefile Thu Jan 13 21:05:51 2011
@@ -1,6 +1,6 @@
-# $NetBSD: Makefile,v 1.4 2010/08/06 17:00:13 jruoho Exp $
+# $NetBSD: Makefile,v 1.5 2011/01/13 21:05:51 jruoho Exp $
-MAN= amdpcib.4 balloon.4 fwhrng.4 hpet.4 ichlpcib.4
+MAN= amdpcib.4 balloon.4 fwhrng.4 hpet.4 ichlpcib.4 ioapic.4
MANSUBDIR=/x86
Added files:
Index: src/share/man/man4/man4.x86/ioapic.4
diff -u /dev/null src/share/man/man4/man4.x86/ioapic.4:1.1
--- /dev/null Thu Jan 13 21:05:51 2011
+++ src/share/man/man4/man4.x86/ioapic.4 Thu Jan 13 21:05:51 2011
@@ -0,0 +1,143 @@
+.\" $NetBSD: ioapic.4,v 1.1 2011/01/13 21:05:51 jruoho Exp $
+.\"
+.\" Copyright (c) 2011 Jukka Ruohonen <[email protected]>
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Neither the name of the author nor the names of any
+.\" contributors may be used to endorse or promote products derived
+.\" from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd January 13, 2011
+.Dt IOAPIC 4 x86
+.Os
+.Sh NAME
+.Nm ioapic
+.Nd Intel APIC Architecture
+.Sh SYNOPSIS
+.Cd "ioapic* at mainbus*"
+.Sh DESCRIPTION
+The
+.Nm
+provides basis for a system of advanced programmable interrupt controllers
+.Pq Tn APICs
+originally designed by Intel but now widely used on all x86 systems.
+.Pp
+There are two elements in the architecture, the local
+.Tn APIC
+.Pq Tn LAPIC
+and the
+.Tn I/O APIC .
+Historically these were connected by a dedicated 3-wire
+.Dq APIC bus ,
+but the system bus is used for communication today.
+The configuration is increasingly dependent on
+.Tn ACPI .
+.Pp
+Typically each
+.Tn CPU
+in the system contains one
+.Tn LAPIC
+that performs two primary functions:
+.Bl -enum -offset indent
+.It
+It receives interrupts both from internal sources and from the external
+.Tn I/O APIC .
+The interrupt sources include
+.Tn I/O
+devices, the programmable
+.Tn APIC
+timer, performance monitoring counters,
+thermal sensor interrupts, and others.
+.It
+In multiprocessor
+.Pq Tn MP
+systems a
+.Tn LAPIC
+receives and sends interprocessor interrupts
+.Pq Tn IPIs
+from and to other processors in the system.
+.Tn IPIs
+are used to provide software interrupts,
+interrupt forwarding, or preemptive scheduling.
+Against this, the architecture can be generally seen as an attempt
+to solve the interrupt routing efficiency issues in
+.Tn MP
+systems.
+.El
+.Pp
+There is typically one
+.Tn I/O APIC
+for each peripheral bus in the system.
+Each
+.Tn I/O APIC
+has a series of interrupt inputs to external interrupt sources.
+The architecture usually contains a redirection table which can be used
+to route the interrupts that an
+.Tn I/O APIC
+receives to one or more local
+.Tn APICs .
+When a
+.Tn LAPIC
+is able to accept an interrupt, it will signal the
+.Tn CPU .
+Without an
+.Tn I/O APIC ,
+the local
+.Tn APICs
+are therefore mostly useless; one of the primary functions
+of the architecture is no longer achievable, interrupts can
+not be distributed to different
+.Tn CPUs .
+.Pp
+The 8259
+.Tn PIC
+has coexisted with the architecture since its introduction.
+It is still possible to disable the
+.Tn APIC
+system and revert back to a 8259-compatible
+.Tn PIC .
+But the widespread use of
+.Tn MP
+systems has made this mainly a fallback option.
+.Sh SEE ALSO
+.Xr acpi 4 ,
+.Xr mainbus 4 ,
+.Xr ichlpcib 4
+.Rs
+.%A Intel Corporation
+.%T Intel 64 and IA-32 Architectures Software Developer's Manual
+.%V Volume 3A: System Programming Guide, Part 1
+.%P Chapter 10
+.%D January, 2011
+.%U http://www.intel.com/Assets/PDF/manual/253668.pdf
+.Re
+.Rs
+.%A Intel Corporation
+.%T Intel 82093AA I/O Advanced Programmable
+.%T Interrupt Controller (I/O APIC) Datasheet
+.%D May, 1996
+.%U http://www.intel.com/design/chipsets/datashts/29056601.pdf
+.Re
+.Rs
+.%A Intel Corporation
+.%T 8259A, Programmable Interrupt Controller
+.%D December, 1988
+.%U http://pdos.csail.mit.edu/6.828/2005/readings/hardware/8259A.pdf
+.Re
