IRQ / Time · Linux 6.18.37 LTS · source + diagram note

early_irq_init

Linux v6.18.37에서 early_irq_init()가 IRQ descriptor의 초기 틀을 만드는 순서를 읽습니다. CONFIG_SPARSE_IRQ 분기, descriptor 생성, 뒤따르는 아키텍처 IRQ 초기화를 구별합니다.

부팅 중 어디에 놓이는가

공통 부팅 코드의 순서는 early_irq_init() 다음 init_IRQ(), 그다음 tick_init()이다. init/main.c L1012–1017에 세 호출이 연속해 보인다. 초기 descriptor 준비를 실제 하드웨어 IRQ 처리나 domain mapping 전체로 확대하지 않는다.

그림 1. 초기 descriptor 준비와 아키텍처 IRQ 초기화의 순서
① early_irq_initgeneric IRQ descriptor의 초기 경로를 실행한다.init/main.c L1014 · 이 글의 첫 발췌
② init_IRQ아키텍처가 제공하는 초기화 진입점이다. arm64 예시는 IRQ stack/SCS 뒤 irqchip_init()을 호출한다.arm64 irq.c L110–114
③ tick_init공통 부팅 코드의 다음 호출이다. 내부 timer 동작은 이 글의 범위 밖이다.init/main.c L1016
이 그림은 부팅 호출 순서다. 장치 신호 → top half → bottom half 같은 IRQ 처리 경로를 early_irq_init() 자체의 수행 단계로 그리지 않는다.

코드와 근거의 경계

아래 두 블록은 고정 태그의 kernel/irq/irqdesc.c에서 각각 L549–575와 L432–450를 그대로 가져온 연속 원문이다. 첫 블록은 CONFIG_SPARSE_IRQ일 때의 early_irq_init() 전체, 둘째는 alloc_desc() 전체다. 둘째 함수가 호출하는 init_desc()와 초기 필드 설정은 별도 L210–237, L115–140에 있다.

버전 한계: 아래 source-bound 도해는 Linux v6.18.37의 irqdesc.c와 명시한 부팅 호출 순서만 설명한다. irq_desc의 Linux IRQ 번호와 irq-domain의 hardware IRQ 번호를 동일시하지 않는다. domain 구성, 특정 irqchip, 인터럽트 발생 이후 경로는 표시된 두 발췌 밖이다.

도식 참고와 독립 재작성: 문C 블로그의 Interrupts -12- (irq desc)에서 초기화 순서와 sparse/flat 비교 방식, Interrupts -2- (irq chip)에서 이후 컨트롤러 초기화와의 경계 설정을 참고했다. 두 글은 kernel v5.4 기준이다. 여기의 그림은 원도와 문장을 복제하지 않고, v6.18.37의 sparse_irqs maple tree와 위의 확인된 코드로 새로 구성했다. 옛 그림의 allocated_irqs bitmap·radix tree·플랫폼 예시는 이 버전의 근거로 쓰지 않는다.

같은 태그의 원본 파일: kernel/irq/irqdesc.c · kernel/irq/irqdomain.c · include/linux/irqdesc.h. 두 코드 발췌를 실제 대조한 파일은 irqdesc.c이고, 뒤의 두 링크는 더 읽을 위치다.

두 연속 코드 발췌

1. CONFIG_SPARSE_IRQ: early_irq_init 전체

kernel/irq/irqdesc.c:549–575 · 조건부 컴파일의 sparse 분기다. !CONFIG_SPARSE_IRQ에는 별도 L577–613 구현이 있다.

int __init early_irq_init(void)
{
	int i, initcnt, node = first_online_node;
	struct irq_desc *desc;

	init_irq_default_affinity();

	/* Let arch update nr_irqs and return the nr of preallocated irqs */
	initcnt = arch_probe_nr_irqs();
	printk(KERN_INFO "NR_IRQS: %d, nr_irqs: %d, preallocated irqs: %d\n",
	       NR_IRQS, nr_irqs, initcnt);

	if (WARN_ON(nr_irqs > MAX_SPARSE_IRQS))
		nr_irqs = MAX_SPARSE_IRQS;

	if (WARN_ON(initcnt > MAX_SPARSE_IRQS))
		initcnt = MAX_SPARSE_IRQS;

	if (initcnt > nr_irqs)
		nr_irqs = initcnt;

	for (i = 0; i < initcnt; i++) {
		desc = alloc_desc(i, node, 0, NULL, NULL);
		irq_insert_desc(i, desc);
	}
	return arch_early_irq_init();
}

기본 affinity 초기화, 아키텍처 사전 할당 개수 조사, MAX_SPARSE_IRQS 상한 처리, initcnt개 descriptor 할당·삽입, arch_early_irq_init() 반환 순서가 보인다. 이 sparse 루프 안에는 alloc_desc()의 NULL 반환을 검사하는 분기가 표시되지 않는다.

2. alloc_desc: 할당 후 init_desc에 위임

kernel/irq/irqdesc.c:432–450 · 기존 글이 이 함수 안에 놓았던 per-CPU accounting과 mask 초기화는 실제로 init_desc L210–237에 있다.

static struct irq_desc *alloc_desc(int irq, int node, unsigned int flags,
				   const struct cpumask *affinity,
				   struct module *owner)
{
	struct irq_desc *desc;
	int ret;

	desc = kzalloc_node(sizeof(*desc), GFP_KERNEL, node);
	if (!desc)
		return NULL;

	ret = init_desc(desc, irq, node, flags, affinity, owner);
	if (unlikely(ret)) {
		kfree(desc);
		return NULL;
	}

	return desc;
}

kzalloc_node()가 실패하면 NULL, init_desc()가 실패하면 kfree(desc) 뒤 NULL을 반환한다. 성공 시 descriptor를 반환하고, 호출자의 삽입은 첫 발췌 L572에서 별도로 수행된다.

컴파일 설정에 따라 갈라지는 초기화

early_irq_init()은 단일 상태 기계가 아니다. CONFIG_SPARSE_IRQ 분기는 번호별 동적 descriptor를 만들고, !CONFIG_SPARSE_IRQ 분기는 정적 배열의 각 descriptor를 초기화한다.

그림 2. sparse와 non-sparse를 나란히 읽기

CONFIG_SPARSE_IRQ · L549–575

상한과 사전 개수arch_probe_nr_irqs() 반환값 initcnt와 nr_irqs의 상한을 확인하고 필요하면 nr_irqs를 늘린다.L554–568
descriptor 삽입alloc_desc(i,...) 결과를 irq_insert_desc(i,desc)에 전달한다.L570–573 · maple tree 저장 L167–198
아키텍처 hookarch_early_irq_init()의 반환값을 그대로 반환한다.L574

!CONFIG_SPARSE_IRQ · L577–613

정적 descriptor 배열irq_desc[NR_IRQS]를 선언하고 기본 handler/depth/lock을 둔다.L579–585
init_desc 반복배열의 각 항목에 init_desc()를 호출한다.L596–602
실패 정리 또는 hook오류면 이전 항목의 masks·per-CPU 자료를 정리한다. 성공하면 같은 아키텍처 hook을 반환한다.L604–612
v6.18.37 sparse 번호 관리는 allocated_irqs bitmap이 아니라 sparse_irqs maple tree다. 이 그림의 두 열은 동시에 실행되는 단계가 아니다.
컴파일 경로descriptor 준비표시된 오류 처리근거
CONFIG_SPARSE_IRQinitcnt개를 alloc_desc()한 뒤 maple tree에 삽입표시된 루프에는 NULL 검사 없음; arch_early_irq_init() 반환L549–575, L194–198
!CONFIG_SPARSE_IRQ정적 irq_desc[NR_IRQS] 각 항목에 init_desc()초기화 실패 시 이전 항목의 masks·per-CPU 자료를 정리하고 ret 반환L577–613

초기 descriptor와 번호 저장소

irq_desc는 Linux 논리 IRQ를 위한 상태 객체다. 이 시점의 irq_data.irq는 Linux 번호를 기록하며, controller의 hardware IRQ 번호를 이 값과 동일시하지 않는다. sparse 빌드에서는 sparse_irqs maple tree가 번호에서 descriptor를 찾는 저장소이고, non-sparse 빌드에서는 irq_desc[NR_IRQS] 정적 배열을 쓴다.

요소초기화 시점의 의미고정 소스
sparse_irqssparse Linux IRQ 번호를 descriptor에 연결하는 maple tree. bitmap이 아니다.irqdesc.c L167–198
irq_data.irqdescriptor에 전달된 Linux IRQ 번호를 저장한다.L123–126
irq_data.chip, handle_irqno_irq_chip과 handle_bad_irq로 시작한다. 장치 handler 등록 완료가 아니다.L125–131
kstat_irqsv6.18.37에서는 per-CPU struct irqstat를 init_desc()가 할당한다.L210–222

descriptor가 어떤 기본값으로 시작하는가

둘째 발췌의 alloc_desc()는 내부에서 init_desc()를 부르고, 그 함수는 다시 desc_set_defaults()를 부른다. 이 연결은 L432–450, L210–237, L115–140에서 확인할 수 있다.

그림 3. sparse 번호와 descriptor 관계, 초기값 위임
alloc_desckzalloc_node()로 descriptor 메모리를 확보한다.L432–441
init_desckstat_irqs, CPU mask, lock·mutex·waitqueue를 준비한다.L210–237
desc_set_defaultsLinux IRQ 번호, no_irq_chip, disabled/masked 상태, handle_bad_irq를 기본값으로 둔다.L115–140

초기 descriptor를 번호로 찾는 sparse 저장 관계

Linux IRQ 번호 iearly_irq_init 루프 인자다.L570–572
sparse_irqs maple treeirq_insert_desc(i,desc)가 해당 번호 위치에 저장한다.L167–198
irq_desc기본값을 갖춘 Linux IRQ descriptor다.L123–140
이 관계는 hardware IRQ→Linux IRQ domain mapping이 아니다. kstat_irqs는 per-CPU struct irqstat로 할당된다.
필드/자원이 범위에서 직접 보이는 기본값·준비근거
irq_data.irq호출자가 준 Linux IRQ 번호 irq를 저장L123–126
irq_data.chip / 상태no_irq_chip; disabled·masked 비트 설정L125–131
handle_irq / depthhandle_bad_irq / 1L130–131
kstat_irqs / affinity masksper-CPU accounting 자료 할당 후 masks 준비; 실패하면 해당 자료를 정리L215–222

불변 조건과 실패 경계

컴파일 분기

sparse의 maple tree와 non-sparse의 정적 배열은 대체 경로다. 한 부팅에서 순서대로 실행되는 두 단계가 아니다.

사전 할당 범위

sparse 루프의 범위는 initcnt다. nr_irqs 전체 descriptor가 이미 생성됐다는 뜻이 아니다. 로그는 상한 조정 전에 출력된다.

비활성 기본값

no_irq_chip, handle_bad_irq, disabled·masked, depth=1은 실제 장치 IRQ enable 이전의 기본 상태다.

오류 전파

sparse 루프는 alloc_desc()의 NULL 결과를 검사하지 않는다. 반면 non-sparse의 init_desc() 실패에는 이전 항목 정리가 있다. start_kernel()은 반환값을 검사하지 않고 다음 호출로 넘어간다.

위 조건은 irqdesc.c L549–613와 init/main.c L1012–1016의 보이는 흐름에 한정된다.

이 시점에 관찰할 수 있는 것

표시된 sparse 함수의 printk는 NR_IRQS, nr_irqs, 사전 할당 개수 initcnt를 출력한다(L556–559). 이것은 이후 각 descriptor 초기화의 성공이나 실제 하드웨어 인터럽트 발생을 증명하지 않는다. /proc/interrupts와 irq_handler_entry 같은 런타임 관찰값도 초기 함수 내부의 세부 분기 위치를 직접 식별하는 자료로 취급하지 않는다.

early_irq_init()은 init/main.c L1012–1016에서 직접 호출된다. 추적을 계획할 때는 현재 설정이 sparse인지, arch_probe_nr_irqs() 및 arch_early_irq_init()에 어떤 아키텍처 구현이 쓰이는지 먼저 확인한다. 여기에는 검증되지 않은 tracefs 필터 명령을 제시하지 않는다.

이어서 읽을 위치

Linux IRQ 번호가 실제 controller의 hardware IRQ 번호로 연결되는 과정은 이 두 발췌 밖이다. 해당 보드의 init_IRQ(), irqchip driver와 irq-domain 설정을 같은 버전에서 함께 읽어야 한다. arm64 init_IRQ L110–124는 한 아키텍처 예시일 뿐 다른 아키텍처의 초기화 순서를 대신하지 않는다.