Barebox · source analysis

block cache와 partition 등록

block device read/write cache 위에 GPT/DOS parser가 child cdev를 등록하는 과정을 읽습니다.

Series
10 / 19
Baseline
v2026.06.1
Commit
314c679eea2d
Source
common/partitions.c:423-460 (발췌 범위)

block cache와 partition 등록 단계에서 실제로 바뀌는 상태는 무엇인가?

block size, cache unit과 partition start unit을 구분한다. GPT backup header와 DOS extended partition의 탐색 범위도 오류 경로에서 확인한다.

child partition의 byte range는 parent block device 안에 있고 서로 허용되지 않은 방식으로 겹치지 않아야 한다. 이 문장을 기준으로 코드를 위에서 아래로 읽으면, 함수 이름을 외우는 대신 어느 시점에 어떤 상태를 신뢰할 수 있는지 판단할 수 있다.

객체와 주소가 놓이는 구조

그림 1. block cache와 partition 등록에서 입력, 내부 상태, 출력의 경계
입력과 전제내부 상태외부로 공개되는 결과
01block_device
02cache blocks
03partition_desc
04partition cdevs

block_device / partition_desc / child cdev를 중심에 놓고 왼쪽의 입력이 어떤 검사를 거쳐 오른쪽 결과로 공개되는지 표시했다. 실제 디버깅에서는 각 블록의 주소와 크기를 로그에 대입한다.

실행 흐름

그림 2. 정상 경로의 주요 호출과 상태 전달
block device
sector cache
partition parser
child cdev
filesystem/boot entry

화살표는 단순 호출 순서만 뜻하지 않는다. 각 단계가 성공을 반환할 때 다음 단계가 읽을 수 있는 상태가 무엇인지 함께 확인한다. 파서가 descriptor를 만들지 못하면 child 등록을 시작하지 않는다. 반면 child 등록 실패는 로그를 남긴 뒤 다음 항목으로 진행하므로, 이 화살표는 전체 성공이나 일괄 rollback을 보장하지 않는다.

파싱과 등록의 서로 다른 성공 기준

단계입력과 처리남는 상태
partition_table_read선두 2개 block을 읽어 형식을 판별하고 등록된 parser 선택읽기·형식·parse 실패 시 descriptor 없음
parserGPT 또는 DOS 형식별 entry 수집임시 partition_desc와 partition 목록
register_one_partitionfirst_sec·size에 SECTOR_SIZE(512 B)를 곱해 byte 범위 구성각 child cdev를 개별 등록; 실패해도 다음 entry 처리
partition_table_freeparser가 만든 임시 descriptor 해제이미 등록한 child cdev는 남음
재탐색열린 child가 있으면 -EBUSY; 없으면 table-origin child 삭제 후 다시 parse이전 목록과 새 목록을 원자적으로 교체하는 transaction 아님

주소와 객체의 이동을 그림으로 읽기

아래 그림은 주소, 객체를 사용하는 기간, 제어권을 넘기는 시점을 중심으로 정리했다. 실제 시작 위치와 크기는 파티션 표의 sector 값 및 등록된 child cdev의 byte 범위를 대조한다.

그림 3. block device에서 child partition cdev가 잘리는 방식

크기는 개념 비율이며 LBA와 byte offset은 아래로 증가한다. GPT 영역은 GPT를 사용할 때에만 나타난다.

낮은 LBA↓ LBA·byte offset 증가
LBA 0DOS MBR 또는 GPT protective MBR
GPT header·entries(선택)LBA 1 이후, GPT일 때
partition A cdevparent offset + range
free/unallocatedchild cdev 없음
partition B cdevfilesystem 또는 state
backup GPT(선택)GPT일 때 disk end LBA
높은 LBAdisk end 방향
그림 4. partition scan과 child cdev 등록

호출 이름만 나열하지 않고, 각 단계가 다음 단계에 넘기는 상태를 기준으로 실행 순서를 표시한다.

01block device probe
02선두 2개 block read
03table type detect
04초기 형식 검증
05entry iteration
06LBA→byte range
07child cdev 등록

원본 코드

아래 코드는 Barebox v2026.06.1의 common/partitions.c에서 423-460줄을 그대로 가져온 것이다.

commit314c679eea2d0ca847c64d1b646a1cf91225c0ecanchor · L447static int partitions_init(void)
423
424	return start;
425}
426
427static uint64_t first_usable_dma = SZ_8M / SECTOR_SIZE;
428
429uint64_t partition_first_usable_lba(void)
430{
431	return first_usable_dma;
432}
433
434static int set_first_usable_lba(struct param_d *p, void *priv)
435{
436	if (first_usable_dma < 1) {
437		pr_err("Minimum is 1\n");
438		return -EINVAL;
439	}
440
441	if (first_usable_dma % (SZ_1M / SECTOR_SIZE))
442		pr_warn("recommended to align to 1MiB\n");
443
444	return 0;
445}
446
447static int partitions_init(void)
448{
449	struct param_d *p = NULL;
450
451	if (IS_ENABLED(CONFIG_GLOBALVAR))
452		p = dev_add_param_uint64(&global_device, "partitions.first_usable_lba",
453					 set_first_usable_lba, NULL,
454					 &first_usable_dma, "%llu", NULL);
455
456	return PTR_ERR_OR_ZERO(p);
457}
458core_initcall(partitions_init);
459
460BAREBOX_MAGICVAR(global.partitions.first_usable_lba, "first usable LBA used for creating partitions");

발췌 범위와 읽기 기준

원문 423-460줄에는 앞뒤 문맥이 포함됩니다. 기준 구문 static int partitions_init(void)은 L447에 있습니다. 발췌 첫 줄을 함수 정의의 시작으로 해석하지 않습니다.

block size, cache unit과 partition start unit을 구분한다. GPT backup header와 DOS extended partition의 탐색 범위도 오류 경로에서 확인한다.

함께 읽어야 하는 원본 코드

첫 코드 조각만으로 동작이 완성되지 않는 경우 호출 매크로, 객체 정의와 실제 실행 목록을 같은 페이지에 묶었다. 각 조각은 같은 기준 commit에서 가져왔다.

01. partition table 형식을 판별하고 child cdev를 등록

common/partitions.c 292-366줄이다.

filecommon/partitions.canchor · L302int parse_partition_table(struct block_device *blk)
292	INIT_LIST_HEAD(&pd->partitions);
293}
294
295/**
296 * Try to collect partition information on the given block device
297 * @param blk Block device to examine
298 * @return 0 most of the time, negative value else
299 *
300 * It is not a failure if no partition information is found
301 */
302int parse_partition_table(struct block_device *blk)
303{
304	int i = 0;
305	int rc = 0;
306	struct partition *part;
307	struct partition_desc *pdesc;
308
309	pdesc = partition_table_read(blk);
310	if (!pdesc)
311		return 0;
312
313	/* at least one partition description found */
314	list_for_each_entry(part, &pdesc->partitions, list) {
315		rc = register_one_partition(blk, part);
316		if (rc != 0)
317			dev_err(blk->dev,
318				"Failed to register partition %d on %s (%d)\n",
319				i, blk->cdev.name, rc);
320		if (rc != -ENODEV)
321			rc = 0;
322
323		i++;
324	}
325
326	partition_table_free(pdesc);
327
328	return rc;
329}
330
331#ifdef CONFIG_PARTITION_MANIPULATION
332int reparse_partition_table(struct block_device *blk)
333{
334	struct cdev *cdev = &blk->cdev;
335	struct cdev *c, *tmp;
336
337	list_for_each_entry(c, &cdev->partitions, partition_entry) {
338		if (c->open) {
339			pr_warn("%s is busy, will continue to use old partition table\n", c->name);
340			return -EBUSY;
341		}
342	}
343
344	list_for_each_entry_safe(c, tmp, &cdev->partitions, partition_entry) {
345		if (c->flags & DEVFS_PARTITION_FROM_TABLE)
346			cdevfs_del_partition(c);
347	}
348
349	return parse_partition_table(blk);
350}
351#endif
352
353int partition_parser_register(struct partition_parser *p)
354{
355	list_add_tail(&p->list, &partition_parser_list);
356
357	return 0;
358}
359
360/**
361 * Try to collect partition information on the given block device
362 * @param blk Block device to examine
363 * @return 0 most of the time, negative value else
364 *
365 * It is not a failure if no partition information is found
366 */

고정 버전의 파싱·등록 경계

01

형식 선택과 내용 검증은 다르다

partition_table_read()는 선두 두 block을 읽고 GPT를 우선 탐지한다. 해당 parser가 없으면 MBR 방식도 시도한다. DOS MBR의 0x55AA 표식은 형식 판별에서 확인하며, EBR 표식은 extended chain을 따라갈 때 확인한다. 형식 표식만으로 모든 entry가 유효하다는 결론을 내릴 수 없다.

02

GPT backup 탐색은 조건부다

is_gpt_valid()는 header signature·크기·CRC·my_lba·usable 범위와 entry-array CRC를 검사한다. primary가 유효하면 그 alternate_lba를 검사하고, backup이 유효하지 않으며 force_gpt이면 디스크 마지막 LBA를 추가 검사한다. primary가 깨졌다고 항상 backup으로 자동 복구되는 것은 아니다.

03

LBA와 child byte 범위를 분리한다

register_one_partition()의 offset·size 변환은 SECTOR_SIZE = 512를 사용한다. 블록 I/O의 blockbits와 cache chunk 크기를 같은 단위로 간주하지 않는다. __devfs_add_partition()는 parent 범위와 겹침을 검사한다. 동일 범위는 기존 cdev를 재사용해 별칭을 추가할 수 있고, 허용되지 않은 겹침은 실패한다.

04

개별 등록 실패는 전체 rollback이 아니다

parse_partition_table()는 entry마다 등록하고 실패를 기록한 뒤 루프를 계속한다. 각 반복에서 -ENODEV 이외 결과는 rc=0으로 정리하며, 다음 반복은 rc를 덮어쓴다. 반환값 0만으로 모든 entry가 등록됐다고 판단할 수 없다. 이미 성공한 child를 일괄 제거하는 unwind도 없다.

05

반환 뒤에도 등록된 child는 유지된다

임시 partition_desc와 entries를 해제하는 것과 devfs의 child cdev 삭제는 별개다. 이 경로는 호출자에게 반환하는 파티션 관리이며, 다음 OS로 비복귀 분기하는 boot handoff가 아니다.

캐시 쓰기와 재탐색의 완료 조건

block_put()는 cache의 내용을 바꾸고 dirty를 표시한다. writebuffer_flush()는 dirty chunk를 장치 write로 보내고, 제공된 경우 장치 flush callback을 호출한다. cache에서 다시 읽은 값이 새 값이라는 사실만으로 매체에 영속화됐다고 볼 수 없다.

선두 두 sector 영역에 대한 쓰기는 need_reparse를 설정한다. block_op_close()는 먼저 flush하고 필요하면 재탐색하지만, 두 반환값을 검사하지 않고 0을 반환한다. 따라서 close 성공과 파티션 목록 갱신 성공은 별도 확인 대상이다.

reparse_partition_table()는 열린 child가 있으면 기존 목록을 유지하며 -EBUSY를 반환한다. 그렇지 않으면 table에서 만든 child를 먼저 지우고 새 표를 해석한다. 새 parse 실패 시 이전 목록을 자동 복구하는 동작은 이 함수에 없다.

임시 파싱 객체와 공개된 cdev의 수명

객체생성·사용종료 경계
선두 block bufferpartition_table_read가 할당, parser에 전달partition_table_read 반환 전 해제
partition_desc·entries형식별 parser가 구성, 등록 루프가 소비partition_table_free가 parser의 해제 함수 호출
child cdev범위 검사 뒤 parent의 ops·priv와 offset을 연결해 개별 공개임시 descriptor 해제와 별개; 명시적 삭제·장치 해제 등 관리 경로에 따름
cache chunkread 시 채우고 write 시 dirty 표시writeback 및 장치의 캐시 관리에 따름; parser buffer와 다름

실패 지점과 증상

#조건관찰되는 증상먼저 볼 단계
01LBA/byte 혼동offset 배수 오류sector cache
02GPT CRC 실패 무시잘못된 table 사용partition parser
03cache flush 누락update 후 오래된 datachild cdev

로그가 끊긴 함수뿐 아니라 그 함수에 주소, 크기, 플래그를 전달한 앞 단계도 조사한다. 오류 처리 후 등록된 객체나 하드웨어 설정이 그대로 남아 있는지도 확인한다.

쓰기 없이 소스와 결과를 대조하기

고정 v2026.06.1의 common/partitions.c, common/partitions/efi.c, common/partitions/dos.c, fs/devfs-core.c, common/block.c를 함께 읽는다. 빌드 심벌은 C 함수 선언 전체가 아니라 이름으로 찾는다.

${CROSS_COMPILE}nm -n barebox | grep -E ' (partitions_init|parse_partition_table)$'

최적화·심벌 제거 설정에 따라 검색 결과가 없을 수 있으므로 map과 빌드 설정을 함께 확인한다. 저장된 파티션 표와 등록 로그에서 first_sec × 512, size × 512를 계산해 parent 범위·겹침·개별 실패 로그를 비교한다. 여기서는 매체 수정이나 부팅 명령을 검증 절차로 요구하지 않는다.

저장된 자료로 검산할 세 가지 사례

  1. 동일한 start·size의 두 entry가 별도 장치 두 개가 되는지, 기존 cdev의 별칭이 되는지 등록 경로를 추적한다.
  2. primary GPT 유효 여부와 force_gpt를 나누어 backup 검사 분기를 표로 적는다. 실제 디스크의 header를 손상시킬 필요는 없다.
  3. 한 entry의 범위 검사가 실패하고 다음 entry는 성공하는 입력에서 최종 rc와 남는 child 목록을 추적한다. 반환값과 개별 등록 증거를 구분한다.

원문과 다음 글