01 · QUESTION
무엇을 확인할 것인가
hardware pending bit가 Linux IRQ number와 irq_desc로 변환되고, level interrupt가 다시 들어오지 않도록 mask와 EOI를 어떤 순서로 다루는가?
irqdomain은 hardware interrupt number를 Linux virtual IRQ에 매핑한다. 각 irqchip은 필요한 mask·unmask·ack·eoi·affinity callback을 선택해 구현하고, flow handler는 edge/level 설정에 맞춰 irq_desc와 device action chain을 실행한다. ack와 eoi가 호출되는 시점은 chip·flow handler마다 다르다.
controller acknowledge로 active state를 얻는 구간, generic_handle_domain_irq가 driver handler를 호출하는 구간, EOI/deactivate 구간을 분리한다. level source는 device status를 먼저 지우지 않으면 즉시 재assert된다.
02 · CONTRACT
공통 규약과 아키텍처별 구현
| architecture | 핵심 mechanism | 실패 형태 | 확인할 상태 |
|---|---|---|---|
| arm64 | GICv3 distributor, redistributor와 ICC system register interface | spurious INTID를 정상 IRQ로 처리하거나 level source를 clear하기 전에 deactivate하면 같은 interrupt가 연속 재진입한다. | INTID, group/priority, redistributor affinity, pending/active bit, irq_desc depth와 device status를 같은 timestamp로 남긴다. |
| x86-64 | local APIC vector, IOAPIC redirection과 IDT/FRED dispatch | vector를 재사용하기 전에 이전 CPU의 in-flight interrupt를 drain하지 않으면 다른 device irq_desc를 호출할 수 있다. | APIC mode xAPIC/x2APIC, vector, destination, IOAPIC RTE, remote IRR, IRTE와 irq migration status를 본다. |
| RISC-V | S-mode local interrupt와 external APLIC/PLIC/IMSIC domain | SCAUSE code를 Linux hwirq로 잘못 변환하거나 PLIC complete를 빼면 해당 source가 막히거나 계속 pending 상태로 남는다. | hart ID·SCAUSE·SIE/SIP와 parent domain을 확인하고, PLIC이면 claim ID·threshold, APLIC direct이면 CLAIMI, IMSIC이면 TOPEI EIID를 별도로 기록한다. |
03 · DIAGRAMS
세 그림으로 먼저 읽기
arm64
- mechanism
- GICv3 distributor, redistributor와 ICC system register interface
- state
- CPU는 ICC_IAR1_EL1에서 INTID를 acknowledge하고 irqdomain을 통해 irq_desc로 보낸다. SPI는 distributor, PPI/SGI는 redistributor의 per-CPU 상태를 사용하며 EOImode에 따라 priority drop과 deactivate가 나뉜다.
- checkpoint
- INTID, group/priority, redistributor affinity, pending/active bit, irq_desc depth와 device status를 같은 timestamp로 남긴다.
x86-64
- mechanism
- local APIC vector, IOAPIC redirection과 IDT/FRED dispatch
- state
- IOAPIC pin 또는 MSI message가 destination APIC ID와 vector를 선택한다. local APIC가 vector를 accept하면 IDT 경로는 vector stub으로, FRED 경로는
fred_extint()로 진입한다. 두 경로의 일반 device IRQ는common_interrupt()로 모여 per-CPUvector_irqmapping에서 irq_desc를 찾는다. - checkpoint
- APIC mode xAPIC/x2APIC, vector, destination, IOAPIC RTE, remote IRR, IRTE와 irq migration status를 본다.
RISC-V
- mechanism
- S-mode local interrupt와 external APLIC/PLIC/IMSIC domain
- state
riscv_intc는 SCAUSE의 local cause를 per-hart domain으로 넘긴다. external device IRQ는 PLIC의 claim/complete, APLIC direct의 CLAIMI, 또는 APLIC MSI→IMSIC의 TOPEI EIID 중 실제 controller 경로에서 해석된다. APLIC direct는 IMSIC을 필수로 거치지 않는다.- checkpoint
- hart ID·SCAUSE·SIE/SIP와 parent domain을 확인하고, PLIC이면 claim ID·threshold, APLIC direct이면 CLAIMI, IMSIC이면 TOPEI EIID를 별도로 기록한다.
gic_complete_ack()의 이른 EOIR(priority drop)→handler→DIR(deactivate) 순서다. 단 ARM64 erratum 2941627 우회 시 deactivate에 GICD_ICACTIVER를 쓰고, mode 1의 LPI·vCPU forwarding에는 DIR을 생략한다.irq_ack에서 complete한다. APLIC direct는 CLAIMI 읽기가 pending을 지우며, IMSIC은 TOPEI로 claim/ack한다. 후자 두 경로에 PLIC complete/threshold를 적용하지 않는다.generic_handle_domain_irq()와 device handler→보통 ICC_EOIR1_EL1로 priority drop·deactivate; erratum 우회 시 GICD_ICACTIVER도 사용ICC_EOIR1_EL1 priority drop→device handler 실행→보통 ICC_DIR_EL1, erratum 우회 시 GICD_ICACTIVER로 deactivate; LPI·forwarded는 생략handle_fasteoi_irq()와 device handler→plic_irq_eoi()가 ID를 claim register에 써 completehandle_edge_irq()의 irq_ack에서 complete→device handler; level 경로와 완료 시점이 다름CLAIMI 읽기가 pending을 지움→domain handler 실행→APLIC irqchip의 irq_eoi는 빈 callbackCSR_TOPEI 읽기/0 쓰기로 EIID claim·ack→domain handler 실행→PLIC claim register complete 없음04 · SOURCE
Linux 6.18.37 원본 코드와 주요 구문 해설
Linux v6.18.37의 고정 원문입니다. arm64에서는 최상위 진입, IAR 읽기와 IRQ 도메인 전달을, x86-64에서는 device IRQ 처리와 부팅 시 APIC 초기화를 함수별로 확인합니다.
arm64 · Linux 6.18.37
GICv3 distributor, redistributor와 ICC system register interface
CPU는 ICC_IAR1_EL1에서 INTID를 acknowledge하고 irqdomain을 통해 irq_desc로 보낸다. SPI는 distributor, PPI/SGI는 redistributor의 per-CPU 상태를 사용하며 EOImode에 따라 priority drop과 deactivate가 나뉜다.
최상위 진입: IRQ 문맥에 따라 경로 선택
원본 코드: drivers/irqchip/irq-gic-v3.c:964-970
964static void __exception_irq_entry gic_handle_irq(struct pt_regs *regs)
965{
966 if (unlikely(gic_supports_nmi() && !interrupts_enabled(regs)))
967 __gic_handle_irq_from_irqsoff(regs);
968 else
969 __gic_handle_irq_from_irqson(regs);
970}주요 구문 해설
원본 7줄은 그대로 표시하며, 검토한 5개 구문에 설명을 붙였습니다.
static void __exception_irq_entry gic_handle_irq(struct pt_regs *regs)arm64 예외 진입 코드가 호출하는 GIC의 최상위 IRQ 처리기입니다. 중단된 레지스터 상태를 보고 일반 IRQ 진입과 IRQ-off NMI 진입을 구분합니다.
if (unlikely(gic_supports_nmi() && !interrupts_enabled(regs)))GIC가 NMI를 지원하면서 중단된 문맥의 IRQ가 꺼져 있었다면 NMI 전용 경로를 선택합니다. 일반 IRQ를 허용하던 문맥과 PMR·NMI 진입 처리 방식이 다르기 때문입니다.
__gic_handle_irq_from_irqsoff(regs);NMI를 지원하고 중단된 문맥의 IRQ가 꺼져 있으면 IRQ-off 전용 진입 경로를 사용합니다. 일반 IRQ를 NMI 문맥에서 처리하지 않도록 PMR 관리가 달라집니다.
elseNMI 전용 IRQ-off 조건이 아니면 일반 GIC 진입 함수로 진행합니다. 그 함수가 읽은 요청의 우선순위를 보고 필요한 처리를 수행합니다.
__gic_handle_irq_from_irqson(regs);NMI 전용 IRQ-off 경로에 해당하지 않으면 일반 GIC 진입 경로로 들어갑니다. 이 함수가 IAR에서 요청 번호를 읽고, NMI 지원 시스템에서는 우선순위도 확인하여 일반 IRQ와 NMI 처리를 구분합니다.
IRQ가 허용된 문맥에서 IAR 읽기
원본 코드: drivers/irqchip/irq-gic-v3.c:904-926
904static void __gic_handle_irq_from_irqson(struct pt_regs *regs)
905{
906 bool is_nmi;
907 u32 irqnr;
908
909 irqnr = gic_read_iar();
910
911 is_nmi = gic_rpr_is_nmi_prio();
912
913 if (is_nmi) {
914 nmi_enter();
915 __gic_handle_nmi(irqnr, regs);
916 nmi_exit();
917 }
918
919 if (gic_prio_masking_enabled()) {
920 gic_pmr_mask_irqs();
921 gic_arch_enable_irqs();
922 }
923
924 if (!is_nmi)
925 __gic_handle_irq(irqnr, regs);
926}주요 구문 해설
원본 23줄은 그대로 표시하며, 검토한 3개 구문에 설명을 붙였습니다.
irqnr = gic_read_iar();IAR를 읽어 인터럽트 번호를 얻습니다.
is_nmi = gic_rpr_is_nmi_prio();현재 우선순위가 pseudo-NMI에 해당하는지 판별합니다.
__gic_handle_irq(irqnr, regs);pseudo-NMI가 아니면 일반 IRQ 처리에 인터럽트 번호를 넘깁니다.
일반 IRQ를 Linux IRQ 도메인에 전달
원본 코드: drivers/irqchip/irq-gic-v3.c:867-878
867static void __gic_handle_irq(u32 irqnr, struct pt_regs *regs)
868{
869 if (gic_irqnr_is_special(irqnr))
870 return;
871
872 gic_complete_ack(irqnr);
873
874 if (generic_handle_domain_irq(gic_data.domain, irqnr)) {
875 WARN_ONCE(true, "Unexpected interrupt (irqnr %u)\n", irqnr);
876 gic_deactivate_unhandled(irqnr);
877 }
878}주요 구문 해설
원본 12줄은 그대로 표시하며, 검토한 3개 구문에 설명을 붙였습니다.
if (gic_irqnr_is_special(irqnr))특수 INTID는 일반 IRQ 도메인에 전달하지 않습니다.
gic_complete_ack(irqnr);일반 IRQ의 acknowledge 후속 처리를 수행합니다.
if (generic_handle_domain_irq(gic_data.domain, irqnr)) {GIC의 INTID를 도메인에서 해석하고 해당 Linux IRQ 처리 경로를 호출합니다.
x86-64 · Linux 6.18.37
local APIC vector, IOAPIC redirection과 IDT/FRED dispatch
IOAPIC pin 또는 MSI message가 destination APIC ID와 vector를 선택한다. local APIC가 vector를 accept하면 IDT 경로는 vector stub으로, FRED 경로는 fred_extint()로 진입한다. 두 경로의 일반 device IRQ는 common_interrupt()로 모여 per-CPU vector_irq mapping에서 irq_desc를 찾는다.
x86-64 device IRQ 진입점
원본 코드: arch/x86/kernel/irq.c:318-329
318DEFINE_IDTENTRY_IRQ(common_interrupt)
319{
320 struct pt_regs *old_regs = set_irq_regs(regs);
321
322 /* entry code tells RCU that we're not quiescent. Check it. */
323 RCU_LOCKDEP_WARN(!rcu_is_watching(), "IRQ failed to wake up RCU");
324
325 if (unlikely(!call_irq_handler(vector, regs)))
326 apic_eoi();
327
328 set_irq_regs(old_regs);
329}주요 구문 해설
원본 12줄은 그대로 표시하며, 검토한 1개 구문에 설명을 붙였습니다.
if (unlikely(!call_irq_handler(vector, regs)))수신한 vector를 처리기에 넘긴다. 대응하는 IRQ 처리기를 찾지 못하면 여기서 APIC EOI를 보낸다.
현재 CPU의 vector 조회와 IRQ 처리기 호출
원본 코드: arch/x86/kernel/irq.c:273-312
273static __always_inline bool call_irq_handler(int vector, struct pt_regs *regs)
274{
275 struct irq_desc *desc = __this_cpu_read(vector_irq[vector]);
276
277 if (likely(!IS_ERR_OR_NULL(desc))) {
278 handle_irq(desc, regs);
279 return true;
280 }
281
282 /*
283 * Reevaluate with vector_lock held to prevent a race against
284 * request_irq() setting up the vector:
285 *
286 * CPU0 CPU1
287 * interrupt is raised in APIC IRR
288 * but not handled
289 * free_irq()
290 * per_cpu(vector_irq, CPU1)[vector] = VECTOR_SHUTDOWN;
291 *
292 * request_irq() common_interrupt()
293 * d = this_cpu_read(vector_irq[vector]);
294 *
295 * per_cpu(vector_irq, CPU1)[vector] = desc;
296 *
297 * if (d == VECTOR_SHUTDOWN)
298 * this_cpu_write(vector_irq[vector], VECTOR_UNUSED);
299 *
300 * This requires that the same vector on the same target CPU is
301 * handed out or that a spurious interrupt hits that CPU/vector.
302 */
303 lock_vector_lock();
304 desc = reevaluate_vector(vector);
305 unlock_vector_lock();
306
307 if (!desc)
308 return false;
309
310 handle_irq(desc, regs);
311 return true;
312}주요 구문 해설
원본 40줄은 그대로 표시하며, 검토한 2개 구문에 설명을 붙였습니다.
struct irq_desc *desc = __this_cpu_read(vector_irq[vector]);현재 CPU의 vector_irq 테이블에서 수신한 vector에 대응하는 irq_desc를 읽는다.
desc = reevaluate_vector(vector);일반 매핑이 없으면 vector_lock을 잡고 매핑을 다시 확인한다.
부팅 시 APIC 인터럽트 모드 초기화
원본 코드: arch/x86/kernel/apic/apic.c:1355-1384
1355void __init apic_intr_mode_init(void)
1356{
1357 bool upmode = IS_ENABLED(CONFIG_UP_LATE_INIT);
1358
1359 switch (apic_intr_mode) {
1360 case APIC_PIC:
1361 pr_info("APIC: Keep in PIC mode(8259)\n");
1362 return;
1363 case APIC_VIRTUAL_WIRE:
1364 pr_info("APIC: Switch to virtual wire mode setup\n");
1365 break;
1366 case APIC_VIRTUAL_WIRE_NO_CONFIG:
1367 pr_info("APIC: Switch to virtual wire mode setup with no configuration\n");
1368 upmode = true;
1369 break;
1370 case APIC_SYMMETRIC_IO:
1371 pr_info("APIC: Switch to symmetric I/O mode setup\n");
1372 break;
1373 case APIC_SYMMETRIC_IO_NO_ROUTING:
1374 pr_info("APIC: Switch to symmetric I/O mode setup in no SMP routine\n");
1375 break;
1376 }
1377
1378 x86_64_probe_apic();
1379
1380 if (x86_platform.apic_post_init)
1381 x86_platform.apic_post_init();
1382
1383 apic_bsp_setup(upmode);
1384}주요 구문 해설
원본 30줄은 그대로 표시하며, 검토한 23개 구문에 설명을 붙였습니다.
void __init apic_intr_mode_init(void)부팅 때 선택된 PIC·virtual wire·symmetric I/O 방식에 맞춰 APIC를 초기화하는 함수입니다. 모드별 예외를 정한 뒤 공통 부트 CPU 설정으로 이어집니다.
bool upmode = IS_ENABLED(CONFIG_UP_LATE_INIT);단일 CPU 커널의 늦은 APIC 초기화 설정이 켜져 있으면 upmode를 참으로 시작합니다. 뒤의 apic_bsp_setup은 이 값에 따라 부트 CPU만 사용하는 APIC 준비를 추가하며, 구성 정보가 없는 virtual wire 경로에서도 이 값을 참으로 바꿉니다.
switch (apic_intr_mode) {앞서 결정한 인터럽트 전달 방식에 따라 APIC 설정을 계속할지와 단일 CPU 준비가 필요한지를 선택합니다.
case APIC_PIC:기존 8259 PIC만 사용하는 모드입니다. APIC 모드로 전환하지 않고 로그 후 반환합니다.
pr_info("APIC: Keep in PIC mode(8259)\n");선택된 인터럽트 방식이 기존 8259 PIC임을 알립니다. 바로 반환하므로 아래의 APIC 설정으로 전환하지 않습니다.
return;PIC 방식 유지를 선택했으므로 APIC 드라이버 탐지와 부트 APIC 설정을 건너뜁니다.
case APIC_VIRTUAL_WIRE:기존 PIC의 인터럽트를 로컬 APIC의 ExtINT 입력으로 받는 virtual wire 모드를 선택합니다.
pr_info("APIC: Switch to virtual wire mode setup\n");기존 PIC의 인터럽트를 로컬 APIC를 통해 받는 virtual wire 설정을 선택했음을 알립니다. 실제 설정은 switch 뒤의 공통 APIC 초기화에서 진행합니다.
break;virtual wire 선택 로그를 마친 뒤 switch 밖의 공통 APIC 준비로 진행합니다.
case APIC_VIRTUAL_WIRE_NO_CONFIG:APIC 구성 정보를 얻지 못한 virtual wire 모드입니다. 단일 CPU 기준으로 부트 APIC를 준비해야 합니다.
pr_info("APIC: Switch to virtual wire mode setup with no configuration\n");정상적인 APIC 구성 정보가 없는 virtual wire 경로임을 알립니다. 이어서 upmode를 켜 단일 CPU에 맞는 초기화를 선택합니다.
upmode = true;구성 정보가 없는 경로에서는 upmode를 켭니다. 뒤의 부트 CPU APIC 설정이 단일 CPU 초기화를 포함하도록 합니다.
break;구성 정보 없는 virtual wire의 추가 결정을 마치고 공통 APIC 초기화로 이어갑니다.
case APIC_SYMMETRIC_IO:I/O APIC가 장치 인터럽트를 CPU의 로컬 APIC로 분배하는 symmetric I/O 모드입니다.
pr_info("APIC: Switch to symmetric I/O mode setup\n");I/O APIC를 사용하는 symmetric I/O 방식으로 초기화할 예정임을 로그에 남깁니다.
break;symmetric I/O 모드 선택을 끝내고 공통 APIC 설정으로 진행합니다.
case APIC_SYMMETRIC_IO_NO_ROUTING:대칭 I/O 모드는 사용하되 SMP 라우팅 구성을 적용하지 않는 경우입니다. 이 구분을 로그에 남긴 뒤 APIC 준비를 계속합니다.
pr_info("APIC: Switch to symmetric I/O mode setup in no SMP routine\n");SMP 라우팅 구성을 사용하지 않는 symmetric I/O 경로를 선택했음을 알립니다. 로그 출력 자체가 인터럽트 라우팅을 프로그래밍하지는 않습니다.
break;라우팅 없는 symmetric I/O 분기를 마치고 공통 APIC 초기화로 이동합니다.
x86_64_probe_apic();64비트 x86 환경에 맞는 APIC 드라이버를 탐지·선택합니다. 이후 공통 APIC 호출이 실제 시스템의 APIC 방식으로 연결되도록 합니다.
if (x86_platform.apic_post_init)플랫폼 전용 APIC 후처리 함수가 등록되어 있을 때만 호출합니다. NULL이면 추가 동작 없이 부트 CPU 설정으로 진행합니다.
x86_platform.apic_post_init();플랫폼이 등록한 APIC 후처리 콜백이 있으면 실행합니다. 일반 APIC 선택만으로 처리되지 않는 플랫폼별 초기 설정을 삽입하는 지점입니다.
apic_bsp_setup(upmode);부트 CPU의 로컬 APIC와 I/O APIC를 준비하고 오류 인터럽트·레거시 IRQ 벡터 설정을 마무리합니다. upmode가 참이면 단일 CPU 환경에 필요한 부트 APIC 설정도 먼저 수행합니다.
RISC-V · Linux 6.18.37
S-mode local interrupt와 external APLIC/PLIC/IMSIC domain
riscv_intc는 SCAUSE의 local cause를 per-hart domain으로 넘긴다. external device IRQ는 PLIC의 claim/complete, APLIC direct의 CLAIMI, 또는 APLIC MSI→IMSIC의 TOPEI EIID 중 실제 controller 경로에서 해석된다. APLIC direct는 IMSIC을 필수로 거치지 않는다.
원본 코드: drivers/irqchip/irq-riscv-intc.c:21-71
21
22#include <asm/hwcap.h>
23
24static struct irq_domain *intc_domain;
25static unsigned int riscv_intc_nr_irqs __ro_after_init = BITS_PER_LONG;
26static unsigned int riscv_intc_custom_base __ro_after_init = BITS_PER_LONG;
27static unsigned int riscv_intc_custom_nr_irqs __ro_after_init;
28
29static void riscv_intc_irq(struct pt_regs *regs)
30{
31 unsigned long cause = regs->cause & ~CAUSE_IRQ_FLAG;
32
33 if (generic_handle_domain_irq(intc_domain, cause))
34 pr_warn_ratelimited("Failed to handle interrupt (cause: %ld)\n", cause);
35}
36
37static void riscv_intc_aia_irq(struct pt_regs *regs)
38{
39 unsigned long topi;
40
41 while ((topi = csr_read(CSR_TOPI)))
42 generic_handle_domain_irq(intc_domain, topi >> TOPI_IID_SHIFT);
43}
44
45/*
46 * On RISC-V systems local interrupts are masked or unmasked by writing
47 * the SIE (Supervisor Interrupt Enable) CSR. As CSRs can only be written
48 * on the local hart, these functions can only be called on the hart that
49 * corresponds to the IRQ chip.
50 */
51
52static void riscv_intc_irq_mask(struct irq_data *d)
53{
54 if (IS_ENABLED(CONFIG_32BIT) && d->hwirq >= BITS_PER_LONG)
55 csr_clear(CSR_IEH, BIT(d->hwirq - BITS_PER_LONG));
56 else
57 csr_clear(CSR_IE, BIT(d->hwirq));
58}
59
60static void riscv_intc_irq_unmask(struct irq_data *d)
61{
62 if (IS_ENABLED(CONFIG_32BIT) && d->hwirq >= BITS_PER_LONG)
63 csr_set(CSR_IEH, BIT(d->hwirq - BITS_PER_LONG));
64 else
65 csr_set(CSR_IE, BIT(d->hwirq));
66}
67
68static void andes_intc_irq_mask(struct irq_data *d)
69{
70 /*
71 * Andes specific S-mode local interrupt causes (hwirq)주요 구문 해설
원본 51줄은 그대로 표시하며, 검토한 24개 구문에 설명을 붙였습니다.
#include <asm/hwcap.h>RISC-V ISA 확장 식별과 지원 여부 확인에 필요한 정의를 가져옵니다. 로컬 인터럽트 컨트롤러가 지원하는 하드웨어 기능에 맞춰 CSR 처리 방식을 고르는 근거입니다. 전처리 단계에서 헤더 내용을 포함하며, CPU가 실행 중 헤더를 호출하는 동작은 없습니다.
static struct irq_domain *intc_domain;hart 로컬 인터럽트 원인 번호와 Linux IRQ를 연결하는 domain을 보관합니다. 진입 처리기는 이 domain으로 원인 번호를 전달합니다.
static unsigned int riscv_intc_nr_irqs __ro_after_init = BITS_PER_LONG;기본 로컬 인터럽트 원인 수를 레지스터 폭인 32개 또는 64개로 시작합니다. 초기화 때 하드웨어에 맞게 조정한 뒤 __ro_after_init으로 읽기 전용이 됩니다.
static unsigned int riscv_intc_custom_base __ro_after_init = BITS_PER_LONG;기본 범위를 넘어서는 사용자 정의 로컬 인터럽트의 시작 번호입니다. 초기값은 기본 원인 수 바로 다음 번호이며 초기화 후에는 변경하지 않습니다.
static unsigned int riscv_intc_custom_nr_irqs __ro_after_init;추가로 제공되는 사용자 정의 인터럽트의 개수를 저장합니다. 초기화에서 정하고 이후에는 읽기 전용 상태로 유지합니다.
static void riscv_intc_irq(struct pt_regs *regs)일반 RISC-V 로컬 IRQ 진입 함수입니다. 저장된 cause에서 IRQ 표시 비트를 제거한 뒤 원인 번호를 IRQ domain에 전달합니다.
unsigned long cause = regs->cause & ~CAUSE_IRQ_FLAG;cause의 최상위 IRQ 표시 비트를 지워 순수한 인터럽트 원인 번호만 얻습니다. 예외인지 IRQ인지 나타내는 표시는 domain 인덱스에 포함하지 않습니다.
if (generic_handle_domain_irq(intc_domain, cause))원인 번호에 해당하는 Linux IRQ 처리를 요청하고 반환값이 오류인지 확인합니다. 성공은 0이므로 실패할 때만 아래의 빈도 제한 경고를 출력합니다.
pr_warn_ratelimited("Failed to handle interrupt (cause: %ld)\n", cause);해당 cause를 로컬 IRQ domain으로 처리하지 못하면 원인 번호를 경고합니다. 같은 실패가 반복되어도 로그가 쏟아지지 않도록 출력 빈도를 제한합니다.
static void riscv_intc_aia_irq(struct pt_regs *regs)AIA를 사용하는 hart의 로컬 IRQ 진입 함수입니다. 저장된 cause 하나만 처리하지 않고 TOPI를 반복해서 읽어 현재 최우선 요청들을 처리합니다.
unsigned long topi;TOPI에서 읽은 인터럽트 ID와 우선순위 정보를 담을 레지스터 폭의 값입니다. 0이면 현재 처리할 요청이 없습니다.
while ((topi = csr_read(CSR_TOPI)))TOPI가 0이 될 때까지 현재 최우선 인터럽트를 읽고 처리합니다. 하나를 처리한 뒤 다시 읽어 새 최우선 요청을 이어서 처리합니다.
generic_handle_domain_irq(intc_domain, topi >> TOPI_IID_SHIFT);AIA top interrupt 값에서 인터럽트 식별자를 추출해 로컬 IRQ domain의 처리기로 전달합니다. 하드웨어 원인 번호를 Linux IRQ 처리와 연결합니다.
static void riscv_intc_irq_mask(struct irq_data *d)irq_data가 가리키는 현재 hart의 로컬 IRQ를 마스크하는 함수입니다. 해당 원인의 허용 비트만 지우므로 다른 로컬 IRQ에는 영향을 주지 않습니다.
if (IS_ENABLED(CONFIG_32BIT) && d->hwirq >= BITS_PER_LONG)32비트 빌드에서 IRQ 번호가 기본 레지스터 폭 이상이면 상위 허용 레지스터 IEH를 사용합니다. 나머지 원인은 기본 IE 안의 비트로 다룹니다.
csr_clear(CSR_IEH, BIT(d->hwirq - BITS_PER_LONG));32비트 RISC-V에서 상위 번호 인터럽트의 CSR_IEH 비트를 지워 마스크합니다. BITS_PER_LONG을 빼 상위 CSR 안에서의 비트 위치로 바꿉니다.
else상위 32비트 전용 처리가 필요하지 않으면 기본 IE 레지스터에서 해당 원인 비트를 지웁니다.
csr_clear(CSR_IE, BIT(d->hwirq));해당 로컬 인터럽트 번호의 CSR_IE 비트를 지워 수신을 막습니다. 특정 원인만 비활성화하며 전체 인터럽트 허용 상태를 끄는 것은 아닙니다.
static void riscv_intc_irq_unmask(struct irq_data *d)현재 hart의 특정 로컬 IRQ 마스크를 해제하는 함수입니다. 해당 원인의 인터럽트 허용 비트를 다시 켭니다.
if (IS_ENABLED(CONFIG_32BIT) && d->hwirq >= BITS_PER_LONG)32비트에서 기본 IE에 담기지 않는 상위 IRQ인지 확인합니다. 상위 번호는 IEH, 그 외는 IE에 허용 비트를 설정합니다.
csr_set(CSR_IEH, BIT(d->hwirq - BITS_PER_LONG));32비트 RISC-V의 상위 로컬 인터럽트 허용 비트를 CSR_IEH에 설정합니다. 상위 레지스터 내부 비트 번호로 변환한 값을 사용합니다.
else기본 IE에 들어가는 IRQ이므로 IE의 해당 비트를 켜는 경로입니다.
csr_set(CSR_IE, BIT(d->hwirq));CSR_IE에서 해당 인터럽트 원인의 비트를 켭니다. 마스크했던 CPU 로컬 인터럽트가 다시 전달될 수 있게 합니다.
static void andes_intc_irq_mask(struct irq_data *d)Andes 전용 로컬 IRQ까지 포함해 마스크하는 함수입니다. 기본 원인은 IE, 256부터 시작하는 Andes 원인은 별도의 SLIE 레지스터에서 끕니다.
05 · WORKED EXAMPLE
숫자로 검산하기
level-triggered device IRQ가 종료되는 조건
device status bit가 1인 동안 line을 계속 assert하는 network device를 가정한다.
- acceptcontroller가 pending을 active로 옮기고 CPU가 INTID/vector/claim ID를 읽는다.
- servicedriver가 device status를 읽고 RX descriptor를 처리한 뒤 MMIO write로 원인을 clear한다.
- orderingposted MMIO write가 device에 도달하기 전에 controller를 deactivate하면 line이 아직 높아 재pending될 수 있다.
- finish필요한 readback/barrier 뒤 EOI/complete를 수행하고 unmask한다.
결론EOI는 device 원인을 지우는 연산이 아니다. device 상태와 controller active state 두 축이 모두 끝나야 interrupt가 종료된다.
06 · DEEP DIVE
주요 동작 상세 분석
공통 커널 코드와 아키텍처별 함수의 역할 구분
irqdomain은 hardware interrupt number를 Linux virtual IRQ에 매핑한다. 각 irqchip은 필요한 mask·unmask·ack·eoi·affinity callback을 선택해 구현하고, flow handler는 edge/level 설정에 맞춰 irq_desc와 device action chain을 실행한다. ack와 eoi가 호출되는 시점은 chip·flow handler마다 다르다.
controller acknowledge로 active state를 얻는 구간, generic_handle_domain_irq가 driver handler를 호출하는 구간, EOI/deactivate 구간을 분리한다. level source는 device status를 먼저 지우지 않으면 즉시 재assert된다.
arm64: GICv3 distributor, redistributor와 ICC system register interface
CPU는 ICC_IAR1_EL1에서 INTID를 acknowledge하고 irqdomain을 통해 irq_desc로 보낸다. SPI는 distributor, PPI/SGI는 redistributor의 per-CPU 상태를 사용하며 EOImode에 따라 priority drop과 deactivate가 나뉜다.
EOImode 0은 보통 IAR→handler→EOIR(priority drop·deactivate)이다. EOImode 1은 IAR→gic_complete_ack()의 이른 EOIR(priority drop)→handler→DIR(deactivate) 순서다. 단 ARM64 erratum 2941627 우회 시 deactivate에 GICD_ICACTIVER를 쓰고, mode 1의 LPI·vCPU forwarding에는 DIR을 생략한다. 디버깅할 때는 INTID, group/priority, redistributor affinity, pending/active bit, irq_desc depth와 device status를 같은 timestamp로 남긴다.
x86-64: local APIC vector, IOAPIC redirection과 IDT/FRED dispatch
IOAPIC pin 또는 MSI message가 destination APIC ID와 vector를 선택한다. local APIC가 vector를 accept하면 IDT 경로는 vector stub으로, FRED 경로는 fred_extint()로 진입한다. 두 경로의 일반 device IRQ는 common_interrupt()로 모여 per-CPU vector_irq mapping에서 irq_desc를 찾는다.
APIC EOI와 level-triggered IOAPIC remote IRR, interrupt remapping의 ordering이 affinity 이동 중 중복/손실을 막는다. 디버깅할 때는 APIC mode xAPIC/x2APIC, vector, destination, IOAPIC RTE, remote IRR, IRTE와 irq migration status를 본다.
RISC-V: S-mode local interrupt와 external APLIC/PLIC/IMSIC domain
riscv_intc는 SCAUSE의 local cause를 per-hart domain으로 넘긴다. external device IRQ는 PLIC의 claim/complete, APLIC direct의 CLAIMI, 또는 APLIC MSI→IMSIC의 TOPEI EIID 중 실제 controller 경로에서 해석된다. APLIC direct는 IMSIC을 필수로 거치지 않는다.
PLIC level 경로는 claim 뒤 handler와 complete write를 거치고 threshold를 사용한다. PLIC edge quirk는 irq_ack에서 complete한다. APLIC direct는 CLAIMI 읽기가 pending을 지우며, IMSIC은 TOPEI로 claim/ack한다. 후자 두 경로에 PLIC complete/threshold를 적용하지 않는다. 디버깅할 때는 hart ID·SCAUSE·SIE/SIP와 parent domain을 확인하고, PLIC이면 claim ID·threshold, APLIC direct이면 CLAIMI, IMSIC이면 TOPEI EIID를 별도로 기록한다.
객체를 사용하고 해제하는 주체와 시점을 확인한다
irqdomain mapping과 irq_desc는 device가 IRQ를 요청한 동안 유지된다. hot-unplug은 affinity 이동, synchronize_irq와 pending interrupt drain 뒤 mapping을 해제해야 한다.
주소나 레지스터 값만 확인하면 갱신되지 않은 상태를 놓칠 수 있다. 상태를 만드는 코드, 다른 코드에 전달하는 시점, 사용하는 코드, 해제하는 시점을 함께 기록한다.
최대 지연 시간은 명령 하나의 실행 시간만으로 결정되지 않는다
interrupt latency는 controller routing, priority masking, CPU interrupt-off 구간, irq_desc contention과 threaded handler wakeup으로 나뉜다. 최악값은 같은 priority의 폭주와 긴 hardirq-disabled section이 만든다.
평균값뿐 아니라 인터럽트를 비활성화한 시간, 다른 CPU의 응답 시간, 펌웨어 호출 시간, 재시도 횟수를 따로 확인해야 최대 지연의 원인을 찾을 수 있다.
07 · FAILURE
실패를 어떤 증거로 나눌 것인가
| 분류 | 관찰되는 결과 | 첫 확인값 |
|---|---|---|
| arm64 | spurious INTID를 정상 IRQ로 처리하거나 level source를 clear하기 전에 deactivate하면 같은 interrupt가 연속 재진입한다. | INTID, group/priority, redistributor affinity, pending/active bit, irq_desc depth와 device status를 같은 timestamp로 남긴다. |
| x86-64 | vector를 재사용하기 전에 이전 CPU의 in-flight interrupt를 drain하지 않으면 다른 device irq_desc를 호출할 수 있다. | APIC mode xAPIC/x2APIC, vector, destination, IOAPIC RTE, remote IRR, IRTE와 irq migration status를 본다. |
| RISC-V | SCAUSE code를 Linux hwirq로 잘못 변환하거나 PLIC complete를 빼면 해당 source가 막히거나 계속 pending 상태로 남는다. | hart ID·SCAUSE·SIE/SIP와 parent domain을 확인하고, PLIC이면 claim ID·threshold, APLIC direct이면 CLAIMI, IMSIC이면 TOPEI EIID를 별도로 기록한다. |
08 · LAB
재현과 계측 절차
- irqsoff tracer와 controller register dump를 결합해 interrupt assertion부터 handler 시작까지 최대 지연을 측정한다.
- affinity를 반복 이동하면서 MSI/vector/INTID와 irq_desc mapping이 언제 바뀌는지 추적한다.
- 동일한 workload에서 세 architecture의 tracepoint 이름, CPU 번호, PC, stack pointer와 address-space identifier를 같은 열로 기록한다.
- 소스만 읽고 끝내지 않고 최종
vmlinux의objdump -dr,readelf -SW결과로 선택된 alternative와 section 배치를 확인한다.
09 · REFERENCES
원문 위치
- arm64drivers/irqchip/irq-gic-v3.c:964-970
- arm64drivers/irqchip/irq-gic-v3.c:904-926
- arm64drivers/irqchip/irq-gic-v3.c:867-878
- x86-64arch/x86/kernel/irq.c:318-329
- x86-64arch/x86/kernel/irq.c:273-312
- x86-64arch/x86/kernel/apic/apic.c:1355-1384
- RISC-Vdrivers/irqchip/irq-riscv-intc.c:21-71
- GIC EOI 경로irq-gic-v3.c:700-748irq-gic-v3.c:829-880
- PLIC level/edgeirq-sifive-plic.c:157-247irq-sifive-plic.c:380-408
- APLIC directirq-riscv-aplic-direct.c:42-48irq-riscv-aplic-direct.c:129-164
- IMSICirq-riscv-imsic-early.c:109-133
- x86 device dispatcharch/x86/kernel/irq.c:318-329entry_fred.c:157-175
Linux kernel source: GPL-2.0-only. 이 글의 코드 발췌는 Linux v6.18.37 원문을 기준으로 하며, 분석 문장은 해당 코드의 실행 조건과 상태 경계를 설명합니다.