← Architecture 비교

Linux 6.18.37 LTS · Architecture comparison 09/21

IRQ controller: GICv3, local APIC/IOAPIC와 RISC-V INTC

device가 interrupt line이나 MSI를 올린 뒤 CPU가 interrupt ID를 읽고 irq_desc handler를 실행하고 EOI하는 전체 경로를 controller 관점에서 비교합니다.

비교 대상
arm64 / x86-64 / RISC-V
실제 원본
파일 4개 · 원문 175줄
기준 태그
Linux v6.18.37
분석 축
상태 · 접근 순서 · 객체 수명 · 지연 시간

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된다.

지연 시간 관점interrupt latency는 controller routing, priority masking, CPU interrupt-off 구간, irq_desc contention과 threaded handler wakeup으로 나뉜다. 최악값은 같은 priority의 폭주와 긴 hardirq-disabled section이 만든다.

02 · CONTRACT

공통 규약과 아키텍처별 구현

architecture핵심 mechanism실패 형태확인할 상태
arm64GICv3 distributor, redistributor와 ICC system register interfacespurious INTID를 정상 IRQ로 처리하거나 level source를 clear하기 전에 deactivate하면 같은 interrupt가 연속 재진입한다.INTID, group/priority, redistributor affinity, pending/active bit, irq_desc depth와 device status를 같은 timestamp로 남긴다.
x86-64local APIC vector, IOAPIC redirection과 IDT/FRED dispatchvector를 재사용하기 전에 이전 CPU의 in-flight interrupt를 drain하지 않으면 다른 device irq_desc를 호출할 수 있다.APIC mode xAPIC/x2APIC, vector, destination, IOAPIC RTE, remote IRR, IRTE와 irq migration status를 본다.
RISC-VS-mode local interrupt와 external APLIC/PLIC/IMSIC domainSCAUSE 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

세 그림으로 먼저 읽기

그림 1. 같은 기능을 구현하는 서로 다른 방식각 명령어 집합(ISA)에서 추적할 상태와 확인할 항목을 나란히 정리했습니다.

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-CPU vector_irq mapping에서 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를 별도로 기록한다.
그림 2. 공통 커널 코드와 아키텍처별 함수의 역할공통 커널 코드와 아키텍처별 코드가 각각 담당하는 일을 구분했습니다.
리눅스 공통 규약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마다 다르다.
arm64GICv3 distributor, redistributor와 ICC system register interfaceEOImode 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을 생략한다.
x86-64local APIC vector, IOAPIC redirection과 IDT/FRED dispatchAPIC EOI와 level-triggered IOAPIC remote IRR, interrupt remapping의 ordering이 affinity 이동 중 중복/손실을 막는다.
RISC-VS-mode local interrupt와 external APLIC/PLIC/IMSIC domainPLIC level 경로는 claim 뒤 handler와 complete write를 거치고 threshold를 사용한다. PLIC edge quirk는 irq_ack에서 complete한다. APLIC direct는 CLAIMI 읽기가 pending을 지우며, IMSIC은 TOPEI로 claim/ack한다. 후자 두 경로에 PLIC complete/threshold를 적용하지 않는다.
객체 수명 관리irqdomain mapping과 irq_desc는 device가 IRQ를 요청한 동안 유지된다. hot-unplug은 affinity 이동, synchronize_irq와 pending interrupt drain 뒤 mapping을 해제해야 한다.
그림 3. 같은 EOI가 항상 같은 시점은 아니다GIC EOI mode, PLIC flow, APLIC direct, IMSIC별로 claim·priority drop·deactivate를 나눴습니다.
GIC mode 0IAR에서 INTID 읽기→generic_handle_domain_irq()와 device handler→보통 ICC_EOIR1_EL1로 priority drop·deactivate; erratum 우회 시 GICD_ICACTIVER도 사용
GIC mode 1IAR → 이른 ICC_EOIR1_EL1 priority drop→device handler 실행→보통 ICC_DIR_EL1, erratum 우회 시 GICD_ICACTIVER로 deactivate; LPI·forwarded는 생략
PLIC levelclaim register에서 ID 읽기→handle_fasteoi_irq()와 device handler→plic_irq_eoi()가 ID를 claim register에 써 complete
PLIC edge quirkclaim register에서 ID 읽기→handle_edge_irq()의 irq_ack에서 complete→device handler; level 경로와 완료 시점이 다름
APLIC directCLAIMI 읽기가 pending을 지움→domain handler 실행→APLIC irqchip의 irq_eoi는 빈 callback
IMSICCSR_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개 구문에 설명을 붙였습니다.

L964static void __exception_irq_entry gic_handle_irq(struct pt_regs *regs)

arm64 예외 진입 코드가 호출하는 GIC의 최상위 IRQ 처리기입니다. 중단된 레지스터 상태를 보고 일반 IRQ 진입과 IRQ-off NMI 진입을 구분합니다.

L966 if (unlikely(gic_supports_nmi() && !interrupts_enabled(regs)))

GIC가 NMI를 지원하면서 중단된 문맥의 IRQ가 꺼져 있었다면 NMI 전용 경로를 선택합니다. 일반 IRQ를 허용하던 문맥과 PMR·NMI 진입 처리 방식이 다르기 때문입니다.

L967 __gic_handle_irq_from_irqsoff(regs);

NMI를 지원하고 중단된 문맥의 IRQ가 꺼져 있으면 IRQ-off 전용 진입 경로를 사용합니다. 일반 IRQ를 NMI 문맥에서 처리하지 않도록 PMR 관리가 달라집니다.

L968 else

NMI 전용 IRQ-off 조건이 아니면 일반 GIC 진입 함수로 진행합니다. 그 함수가 읽은 요청의 우선순위를 보고 필요한 처리를 수행합니다.

L969 __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개 구문에 설명을 붙였습니다.

L909 irqnr = gic_read_iar();

IAR를 읽어 인터럽트 번호를 얻습니다.

L911 is_nmi = gic_rpr_is_nmi_prio();

현재 우선순위가 pseudo-NMI에 해당하는지 판별합니다.

L925 __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개 구문에 설명을 붙였습니다.

L869 if (gic_irqnr_is_special(irqnr))

특수 INTID는 일반 IRQ 도메인에 전달하지 않습니다.

L872 gic_complete_ack(irqnr);

일반 IRQ의 acknowledge 후속 처리를 수행합니다.

L874 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개 구문에 설명을 붙였습니다.

L325 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개 구문에 설명을 붙였습니다.

L275 struct irq_desc *desc = __this_cpu_read(vector_irq[vector]);

현재 CPU의 vector_irq 테이블에서 수신한 vector에 대응하는 irq_desc를 읽는다.

L304 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개 구문에 설명을 붙였습니다.

L1355void __init apic_intr_mode_init(void)

부팅 때 선택된 PIC·virtual wire·symmetric I/O 방식에 맞춰 APIC를 초기화하는 함수입니다. 모드별 예외를 정한 뒤 공통 부트 CPU 설정으로 이어집니다.

L1357 bool upmode = IS_ENABLED(CONFIG_UP_LATE_INIT);

단일 CPU 커널의 늦은 APIC 초기화 설정이 켜져 있으면 upmode를 참으로 시작합니다. 뒤의 apic_bsp_setup은 이 값에 따라 부트 CPU만 사용하는 APIC 준비를 추가하며, 구성 정보가 없는 virtual wire 경로에서도 이 값을 참으로 바꿉니다.

L1359 switch (apic_intr_mode) {

앞서 결정한 인터럽트 전달 방식에 따라 APIC 설정을 계속할지와 단일 CPU 준비가 필요한지를 선택합니다.

L1360 case APIC_PIC:

기존 8259 PIC만 사용하는 모드입니다. APIC 모드로 전환하지 않고 로그 후 반환합니다.

L1361 pr_info("APIC: Keep in PIC mode(8259)\n");

선택된 인터럽트 방식이 기존 8259 PIC임을 알립니다. 바로 반환하므로 아래의 APIC 설정으로 전환하지 않습니다.

L1362 return;

PIC 방식 유지를 선택했으므로 APIC 드라이버 탐지와 부트 APIC 설정을 건너뜁니다.

L1363 case APIC_VIRTUAL_WIRE:

기존 PIC의 인터럽트를 로컬 APIC의 ExtINT 입력으로 받는 virtual wire 모드를 선택합니다.

L1364 pr_info("APIC: Switch to virtual wire mode setup\n");

기존 PIC의 인터럽트를 로컬 APIC를 통해 받는 virtual wire 설정을 선택했음을 알립니다. 실제 설정은 switch 뒤의 공통 APIC 초기화에서 진행합니다.

L1365 break;

virtual wire 선택 로그를 마친 뒤 switch 밖의 공통 APIC 준비로 진행합니다.

L1366 case APIC_VIRTUAL_WIRE_NO_CONFIG:

APIC 구성 정보를 얻지 못한 virtual wire 모드입니다. 단일 CPU 기준으로 부트 APIC를 준비해야 합니다.

L1367 pr_info("APIC: Switch to virtual wire mode setup with no configuration\n");

정상적인 APIC 구성 정보가 없는 virtual wire 경로임을 알립니다. 이어서 upmode를 켜 단일 CPU에 맞는 초기화를 선택합니다.

L1368 upmode = true;

구성 정보가 없는 경로에서는 upmode를 켭니다. 뒤의 부트 CPU APIC 설정이 단일 CPU 초기화를 포함하도록 합니다.

L1369 break;

구성 정보 없는 virtual wire의 추가 결정을 마치고 공통 APIC 초기화로 이어갑니다.

L1370 case APIC_SYMMETRIC_IO:

I/O APIC가 장치 인터럽트를 CPU의 로컬 APIC로 분배하는 symmetric I/O 모드입니다.

L1371 pr_info("APIC: Switch to symmetric I/O mode setup\n");

I/O APIC를 사용하는 symmetric I/O 방식으로 초기화할 예정임을 로그에 남깁니다.

L1372 break;

symmetric I/O 모드 선택을 끝내고 공통 APIC 설정으로 진행합니다.

L1373 case APIC_SYMMETRIC_IO_NO_ROUTING:

대칭 I/O 모드는 사용하되 SMP 라우팅 구성을 적용하지 않는 경우입니다. 이 구분을 로그에 남긴 뒤 APIC 준비를 계속합니다.

L1374 pr_info("APIC: Switch to symmetric I/O mode setup in no SMP routine\n");

SMP 라우팅 구성을 사용하지 않는 symmetric I/O 경로를 선택했음을 알립니다. 로그 출력 자체가 인터럽트 라우팅을 프로그래밍하지는 않습니다.

L1375 break;

라우팅 없는 symmetric I/O 분기를 마치고 공통 APIC 초기화로 이동합니다.

L1378 x86_64_probe_apic();

64비트 x86 환경에 맞는 APIC 드라이버를 탐지·선택합니다. 이후 공통 APIC 호출이 실제 시스템의 APIC 방식으로 연결되도록 합니다.

L1380 if (x86_platform.apic_post_init)

플랫폼 전용 APIC 후처리 함수가 등록되어 있을 때만 호출합니다. NULL이면 추가 동작 없이 부트 CPU 설정으로 진행합니다.

L1381 x86_platform.apic_post_init();

플랫폼이 등록한 APIC 후처리 콜백이 있으면 실행합니다. 일반 APIC 선택만으로 처리되지 않는 플랫폼별 초기 설정을 삽입하는 지점입니다.

L1383 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개 구문에 설명을 붙였습니다.

L22#include <asm/hwcap.h>

RISC-V ISA 확장 식별과 지원 여부 확인에 필요한 정의를 가져옵니다. 로컬 인터럽트 컨트롤러가 지원하는 하드웨어 기능에 맞춰 CSR 처리 방식을 고르는 근거입니다. 전처리 단계에서 헤더 내용을 포함하며, CPU가 실행 중 헤더를 호출하는 동작은 없습니다.

L24static struct irq_domain *intc_domain;

hart 로컬 인터럽트 원인 번호와 Linux IRQ를 연결하는 domain을 보관합니다. 진입 처리기는 이 domain으로 원인 번호를 전달합니다.

L25static unsigned int riscv_intc_nr_irqs __ro_after_init = BITS_PER_LONG;

기본 로컬 인터럽트 원인 수를 레지스터 폭인 32개 또는 64개로 시작합니다. 초기화 때 하드웨어에 맞게 조정한 뒤 __ro_after_init으로 읽기 전용이 됩니다.

L26static unsigned int riscv_intc_custom_base __ro_after_init = BITS_PER_LONG;

기본 범위를 넘어서는 사용자 정의 로컬 인터럽트의 시작 번호입니다. 초기값은 기본 원인 수 바로 다음 번호이며 초기화 후에는 변경하지 않습니다.

L27static unsigned int riscv_intc_custom_nr_irqs __ro_after_init;

추가로 제공되는 사용자 정의 인터럽트의 개수를 저장합니다. 초기화에서 정하고 이후에는 읽기 전용 상태로 유지합니다.

L29static void riscv_intc_irq(struct pt_regs *regs)

일반 RISC-V 로컬 IRQ 진입 함수입니다. 저장된 cause에서 IRQ 표시 비트를 제거한 뒤 원인 번호를 IRQ domain에 전달합니다.

L31 unsigned long cause = regs->cause & ~CAUSE_IRQ_FLAG;

cause의 최상위 IRQ 표시 비트를 지워 순수한 인터럽트 원인 번호만 얻습니다. 예외인지 IRQ인지 나타내는 표시는 domain 인덱스에 포함하지 않습니다.

L33 if (generic_handle_domain_irq(intc_domain, cause))

원인 번호에 해당하는 Linux IRQ 처리를 요청하고 반환값이 오류인지 확인합니다. 성공은 0이므로 실패할 때만 아래의 빈도 제한 경고를 출력합니다.

L34 pr_warn_ratelimited("Failed to handle interrupt (cause: %ld)\n", cause);

해당 cause를 로컬 IRQ domain으로 처리하지 못하면 원인 번호를 경고합니다. 같은 실패가 반복되어도 로그가 쏟아지지 않도록 출력 빈도를 제한합니다.

L37static void riscv_intc_aia_irq(struct pt_regs *regs)

AIA를 사용하는 hart의 로컬 IRQ 진입 함수입니다. 저장된 cause 하나만 처리하지 않고 TOPI를 반복해서 읽어 현재 최우선 요청들을 처리합니다.

L39 unsigned long topi;

TOPI에서 읽은 인터럽트 ID와 우선순위 정보를 담을 레지스터 폭의 값입니다. 0이면 현재 처리할 요청이 없습니다.

L41 while ((topi = csr_read(CSR_TOPI)))

TOPI가 0이 될 때까지 현재 최우선 인터럽트를 읽고 처리합니다. 하나를 처리한 뒤 다시 읽어 새 최우선 요청을 이어서 처리합니다.

L42 generic_handle_domain_irq(intc_domain, topi >> TOPI_IID_SHIFT);

AIA top interrupt 값에서 인터럽트 식별자를 추출해 로컬 IRQ domain의 처리기로 전달합니다. 하드웨어 원인 번호를 Linux IRQ 처리와 연결합니다.

L52static void riscv_intc_irq_mask(struct irq_data *d)

irq_data가 가리키는 현재 hart의 로컬 IRQ를 마스크하는 함수입니다. 해당 원인의 허용 비트만 지우므로 다른 로컬 IRQ에는 영향을 주지 않습니다.

L54 if (IS_ENABLED(CONFIG_32BIT) && d->hwirq >= BITS_PER_LONG)

32비트 빌드에서 IRQ 번호가 기본 레지스터 폭 이상이면 상위 허용 레지스터 IEH를 사용합니다. 나머지 원인은 기본 IE 안의 비트로 다룹니다.

L55 csr_clear(CSR_IEH, BIT(d->hwirq - BITS_PER_LONG));

32비트 RISC-V에서 상위 번호 인터럽트의 CSR_IEH 비트를 지워 마스크합니다. BITS_PER_LONG을 빼 상위 CSR 안에서의 비트 위치로 바꿉니다.

L56 else

상위 32비트 전용 처리가 필요하지 않으면 기본 IE 레지스터에서 해당 원인 비트를 지웁니다.

L57 csr_clear(CSR_IE, BIT(d->hwirq));

해당 로컬 인터럽트 번호의 CSR_IE 비트를 지워 수신을 막습니다. 특정 원인만 비활성화하며 전체 인터럽트 허용 상태를 끄는 것은 아닙니다.

L60static void riscv_intc_irq_unmask(struct irq_data *d)

현재 hart의 특정 로컬 IRQ 마스크를 해제하는 함수입니다. 해당 원인의 인터럽트 허용 비트를 다시 켭니다.

L62 if (IS_ENABLED(CONFIG_32BIT) && d->hwirq >= BITS_PER_LONG)

32비트에서 기본 IE에 담기지 않는 상위 IRQ인지 확인합니다. 상위 번호는 IEH, 그 외는 IE에 허용 비트를 설정합니다.

L63 csr_set(CSR_IEH, BIT(d->hwirq - BITS_PER_LONG));

32비트 RISC-V의 상위 로컬 인터럽트 허용 비트를 CSR_IEH에 설정합니다. 상위 레지스터 내부 비트 번호로 변환한 값을 사용합니다.

L64 else

기본 IE에 들어가는 IRQ이므로 IE의 해당 비트를 켜는 경로입니다.

L65 csr_set(CSR_IE, BIT(d->hwirq));

CSR_IE에서 해당 인터럽트 원인의 비트를 켭니다. 마스크했던 CPU 로컬 인터럽트가 다시 전달될 수 있게 합니다.

L68static void andes_intc_irq_mask(struct irq_data *d)

Andes 전용 로컬 IRQ까지 포함해 마스크하는 함수입니다. 기본 원인은 IE, 256부터 시작하는 Andes 원인은 별도의 SLIE 레지스터에서 끕니다.

05 · WORKED EXAMPLE

숫자로 검산하기

01

level-triggered device IRQ가 종료되는 조건

device status bit가 1인 동안 line을 계속 assert하는 network device를 가정한다.

  1. acceptcontroller가 pending을 active로 옮기고 CPU가 INTID/vector/claim ID를 읽는다.
  2. servicedriver가 device status를 읽고 RX descriptor를 처리한 뒤 MMIO write로 원인을 clear한다.
  3. orderingposted MMIO write가 device에 도달하기 전에 controller를 deactivate하면 line이 아직 높아 재pending될 수 있다.
  4. finish필요한 readback/barrier 뒤 EOI/complete를 수행하고 unmask한다.

결론EOI는 device 원인을 지우는 연산이 아니다. device 상태와 controller active state 두 축이 모두 끝나야 interrupt가 종료된다.

06 · DEEP DIVE

주요 동작 상세 분석

01

공통 커널 코드와 아키텍처별 함수의 역할 구분

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

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로 남긴다.

03

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를 본다.

04

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를 별도로 기록한다.

05

객체를 사용하고 해제하는 주체와 시점을 확인한다

irqdomain mapping과 irq_desc는 device가 IRQ를 요청한 동안 유지된다. hot-unplug은 affinity 이동, synchronize_irq와 pending interrupt drain 뒤 mapping을 해제해야 한다.

주소나 레지스터 값만 확인하면 갱신되지 않은 상태를 놓칠 수 있다. 상태를 만드는 코드, 다른 코드에 전달하는 시점, 사용하는 코드, 해제하는 시점을 함께 기록한다.

06

최대 지연 시간은 명령 하나의 실행 시간만으로 결정되지 않는다

interrupt latency는 controller routing, priority masking, CPU interrupt-off 구간, irq_desc contention과 threaded handler wakeup으로 나뉜다. 최악값은 같은 priority의 폭주와 긴 hardirq-disabled section이 만든다.

평균값뿐 아니라 인터럽트를 비활성화한 시간, 다른 CPU의 응답 시간, 펌웨어 호출 시간, 재시도 횟수를 따로 확인해야 최대 지연의 원인을 찾을 수 있다.

07 · FAILURE

실패를 어떤 증거로 나눌 것인가

분류관찰되는 결과첫 확인값
arm64spurious INTID를 정상 IRQ로 처리하거나 level source를 clear하기 전에 deactivate하면 같은 interrupt가 연속 재진입한다.INTID, group/priority, redistributor affinity, pending/active bit, irq_desc depth와 device status를 같은 timestamp로 남긴다.
x86-64vector를 재사용하기 전에 이전 CPU의 in-flight interrupt를 drain하지 않으면 다른 device irq_desc를 호출할 수 있다.APIC mode xAPIC/x2APIC, vector, destination, IOAPIC RTE, remote IRR, IRTE와 irq migration status를 본다.
RISC-VSCAUSE 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

재현과 계측 절차

  1. irqsoff tracer와 controller register dump를 결합해 interrupt assertion부터 handler 시작까지 최대 지연을 측정한다.
  2. affinity를 반복 이동하면서 MSI/vector/INTID와 irq_desc mapping이 언제 바뀌는지 추적한다.
  3. 동일한 workload에서 세 architecture의 tracepoint 이름, CPU 번호, PC, stack pointer와 address-space identifier를 같은 열로 기록한다.
  4. 소스만 읽고 끝내지 않고 최종 vmlinux의 objdump -dr, readelf -SW 결과로 선택된 alternative와 section 배치를 확인한다.

09 · REFERENCES

원문 위치

Linux kernel source: GPL-2.0-only. 이 글의 코드 발췌는 Linux v6.18.37 원문을 기준으로 하며, 분석 문장은 해당 코드의 실행 조건과 상태 경계를 설명합니다.