QUESTION
block cache와 partition 등록 단계에서 실제로 바뀌는 상태는 무엇인가?
block size, cache unit과 partition start unit을 구분한다. GPT backup header와 DOS extended partition의 탐색 범위도 오류 경로에서 확인한다.
child partition의 byte range는 parent block device 안에 있고 서로 허용되지 않은 방식으로 겹치지 않아야 한다. 이 문장을 기준으로 코드를 위에서 아래로 읽으면, 함수 이름을 외우는 대신 어느 시점에 어떤 상태를 신뢰할 수 있는지 판단할 수 있다.
STRUCTURE
객체와 주소가 놓이는 구조
block_device / partition_desc / child cdev를 중심에 놓고 왼쪽의 입력이 어떤 검사를 거쳐 오른쪽 결과로 공개되는지 표시했다. 실제 디버깅에서는 각 블록의 주소와 크기를 로그에 대입한다.
CALL PATH
실행 흐름
화살표는 단순 호출 순서만 뜻하지 않는다. 각 단계가 성공을 반환할 때 다음 단계가 읽을 수 있는 상태가 무엇인지 함께 확인한다. 파서가 descriptor를 만들지 못하면 child 등록을 시작하지 않는다. 반면 child 등록 실패는 로그를 남긴 뒤 다음 항목으로 진행하므로, 이 화살표는 전체 성공이나 일괄 rollback을 보장하지 않는다.
STATE LEDGER
파싱과 등록의 서로 다른 성공 기준
| 단계 | 입력과 처리 | 남는 상태 |
|---|---|---|
| partition_table_read | 선두 2개 block을 읽어 형식을 판별하고 등록된 parser 선택 | 읽기·형식·parse 실패 시 descriptor 없음 |
| parser | GPT 또는 DOS 형식별 entry 수집 | 임시 partition_desc와 partition 목록 |
| register_one_partition | first_sec·size에 SECTOR_SIZE(512 B)를 곱해 byte 범위 구성 | 각 child cdev를 개별 등록; 실패해도 다음 entry 처리 |
| partition_table_free | parser가 만든 임시 descriptor 해제 | 이미 등록한 child cdev는 남음 |
| 재탐색 | 열린 child가 있으면 -EBUSY; 없으면 table-origin child 삭제 후 다시 parse | 이전 목록과 새 목록을 원자적으로 교체하는 transaction 아님 |
VISUAL WALKTHROUGH
주소와 객체의 이동을 그림으로 읽기
아래 그림은 주소, 객체를 사용하는 기간, 제어권을 넘기는 시점을 중심으로 정리했다. 실제 시작 위치와 크기는 파티션 표의 sector 값 및 등록된 child cdev의 byte 범위를 대조한다.
크기는 개념 비율이며 LBA와 byte offset은 아래로 증가한다. GPT 영역은 GPT를 사용할 때에만 나타난다.
호출 이름만 나열하지 않고, 각 단계가 다음 단계에 넘기는 상태를 기준으로 실행 순서를 표시한다.
UPSTREAM SOURCE
원본 코드
아래 코드는 Barebox v2026.06.1의 common/partitions.c에서 423-460줄을 그대로 가져온 것이다.
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");
READING CONTRACT
발췌 범위와 읽기 기준
원문 423-460줄에는 앞뒤 문맥이 포함됩니다. 기준 구문 static int partitions_init(void)은 L447에 있습니다. 발췌 첫 줄을 함수 정의의 시작으로 해석하지 않습니다.
block size, cache unit과 partition start unit을 구분한다. GPT backup header와 DOS extended partition의 탐색 범위도 오류 경로에서 확인한다.
RELATED SOURCE
함께 읽어야 하는 원본 코드
첫 코드 조각만으로 동작이 완성되지 않는 경우 호출 매크로, 객체 정의와 실제 실행 목록을 같은 페이지에 묶었다. 각 조각은 같은 기준 commit에서 가져왔다.
01. partition table 형식을 판별하고 child cdev를 등록
common/partitions.c 292-366줄이다.
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 */
DETAILS
고정 버전의 파싱·등록 경계
형식 선택과 내용 검증은 다르다
partition_table_read()는 선두 두 block을 읽고 GPT를 우선 탐지한다. 해당 parser가 없으면 MBR 방식도 시도한다. DOS MBR의 0x55AA 표식은 형식 판별에서 확인하며, EBR 표식은 extended chain을 따라갈 때 확인한다. 형식 표식만으로 모든 entry가 유효하다는 결론을 내릴 수 없다.
GPT backup 탐색은 조건부다
is_gpt_valid()는 header signature·크기·CRC·my_lba·usable 범위와 entry-array CRC를 검사한다. primary가 유효하면 그 alternate_lba를 검사하고, backup이 유효하지 않으며 force_gpt이면 디스크 마지막 LBA를 추가 검사한다. primary가 깨졌다고 항상 backup으로 자동 복구되는 것은 아니다.
LBA와 child byte 범위를 분리한다
register_one_partition()의 offset·size 변환은 SECTOR_SIZE = 512를 사용한다. 블록 I/O의 blockbits와 cache chunk 크기를 같은 단위로 간주하지 않는다. __devfs_add_partition()는 parent 범위와 겹침을 검사한다. 동일 범위는 기존 cdev를 재사용해 별칭을 추가할 수 있고, 허용되지 않은 겹침은 실패한다.
개별 등록 실패는 전체 rollback이 아니다
parse_partition_table()는 entry마다 등록하고 실패를 기록한 뒤 루프를 계속한다. 각 반복에서 -ENODEV 이외 결과는 rc=0으로 정리하며, 다음 반복은 rc를 덮어쓴다. 반환값 0만으로 모든 entry가 등록됐다고 판단할 수 없다. 이미 성공한 child를 일괄 제거하는 unwind도 없다.
반환 뒤에도 등록된 child는 유지된다
임시 partition_desc와 entries를 해제하는 것과 devfs의 child cdev 삭제는 별개다. 이 경로는 호출자에게 반환하는 파티션 관리이며, 다음 OS로 비복귀 분기하는 boot handoff가 아니다.
IMPLEMENTATION NOTES
캐시 쓰기와 재탐색의 완료 조건
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 실패 시 이전 목록을 자동 복구하는 동작은 이 함수에 없다.
OBJECT LIFETIME
임시 파싱 객체와 공개된 cdev의 수명
| 객체 | 생성·사용 | 종료 경계 |
|---|---|---|
| 선두 block buffer | partition_table_read가 할당, parser에 전달 | partition_table_read 반환 전 해제 |
| partition_desc·entries | 형식별 parser가 구성, 등록 루프가 소비 | partition_table_free가 parser의 해제 함수 호출 |
| child cdev | 범위 검사 뒤 parent의 ops·priv와 offset을 연결해 개별 공개 | 임시 descriptor 해제와 별개; 명시적 삭제·장치 해제 등 관리 경로에 따름 |
| cache chunk | read 시 채우고 write 시 dirty 표시 | writeback 및 장치의 캐시 관리에 따름; parser buffer와 다름 |
FAILURE PATH
실패 지점과 증상
| # | 조건 | 관찰되는 증상 | 먼저 볼 단계 |
|---|---|---|---|
| 01 | LBA/byte 혼동 | offset 배수 오류 | sector cache |
| 02 | GPT CRC 실패 무시 | 잘못된 table 사용 | partition parser |
| 03 | cache flush 누락 | update 후 오래된 data | child cdev |
로그가 끊긴 함수뿐 아니라 그 함수에 주소, 크기, 플래그를 전달한 앞 단계도 조사한다. 오류 처리 후 등록된 객체나 하드웨어 설정이 그대로 남아 있는지도 확인한다.
EVIDENCE
쓰기 없이 소스와 결과를 대조하기
고정 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 범위·겹침·개별 실패 로그를 비교한다. 여기서는 매체 수정이나 부팅 명령을 검증 절차로 요구하지 않는다.
LAB
저장된 자료로 검산할 세 가지 사례
- 동일한 start·size의 두 entry가 별도 장치 두 개가 되는지, 기존 cdev의 별칭이 되는지 등록 경로를 추적한다.
- primary GPT 유효 여부와 force_gpt를 나누어 backup 검사 분기를 표로 적는다. 실제 디스크의 header를 손상시킬 필요는 없다.
- 한 entry의 범위 검사가 실패하고 다음 entry는 성공하는 입력에서 최종 rc와 남는 child 목록을 추적한다. 반환값과 개별 등록 증거를 구분한다.
PRIMARY REFERENCES