QUESTION
cdev와 /dev 파일 경계 단계에서 실제로 바뀌는 상태는 무엇인가?
Barebox shell에서 path로 장치를 다룰 수 있는 이유가 이 경계다. cdev offset/size와 partition child cdev의 상대 주소 계산을 확인한다.
파일 offset과 cdev 상대 offset을 block/byte 단위 혼동 없이 driver callback에 전달해야 한다. 이 문장을 기준으로 코드를 위에서 아래로 읽으면, 함수 이름을 외우는 대신 어느 시점에 어떤 상태를 신뢰할 수 있는지 판단할 수 있다.
STRUCTURE
객체와 주소가 놓이는 구조
struct cdev / devfs_inode / struct file를 중심에 놓고 왼쪽의 입력이 어떤 검사를 거쳐 오른쪽 결과로 공개되는지 표시했다. 실제 디버깅에서는 각 블록의 주소와 크기를 로그에 대입한다.
CALL PATH
실행 흐름
devfs_create()가 cdev를 목록에 넣는다. /dev node는 devfs 초기화가 끝났을 때 devfs_mknod()로 만들어진다. devfs_open()은 file에 cdev와 크기를 결합하고, devfs_read()가 cdev_read()에 offset을 전달한다. 단, devfs_mknod()는 void 함수여서 node 생성 오류를 로그로 남길 뿐 devfs_create()의 0 반환을 바꾸지 않는다. 목록 등록과 실제 /dev node 생성 성공은 따로 확인한다.
STATE LEDGER
단계별 입력과 출력
그림 2의 넓은 단계를 v2026.06.1의 실제 함수 경계로 나눴다. cdev_read() 자체는 크기 제한이나 file position 갱신을 수행하지 않는다.
| # | 실제 단계 | 진입 시 필요한 상태 | 성공 뒤 남는 상태 | 다음 소비자 |
|---|---|---|---|---|
| 01 | devfs_create() | 이름·크기·operations가 설정된 cdev | cdev_list에 등록 | devfs_mknod() 또는 후속 devfs_init() |
| 02 | devfs_mknod() | 등록된 cdev와 초기화된 devfs | /dev/<name> node | path lookup·devfs_open() |
| 03 | devfs_open() | inode가 가리키는 cdev 또는 이름으로 찾은 cdev | f_size=cdev_size(), private_data=cdev, 성공한 open count | fs/fs.c::__read() |
| 04 | __read() | f_pos, 요청 count, file size·flags | 유한 크기 파일이면 요청 길이를 EOF까지 제한 | devfs_read() |
| 05 | devfs_read() → cdev_read() | file의 cdev, 조정된 count와 f_pos | 선택된 callback에 cdev->offset + f_pos 전달 | 반환값 > 0이면 read()가 f_pos 갱신 |
중복 cdev 이름은 등록되지 않고 -EEXIST를 반환한다. devfs 초기화 전에는 node 생성을 보류한다. pread()는 임시 offset으로 읽은 뒤 기존 f_pos를 복원하며, FILE_SIZE_STREAM은 유한 크기 제한의 예외다.
VISUAL WALKTHROUGH
주소와 객체의 이동을 그림으로 읽기
아래 그림은 /dev path, 열린 file, cdev와 read callback 사이에서 값이 옮겨가는 시점을 표시한다. 실제 요청은 열린 file의 f_pos·f_size, cdev의 size·offset과 driver trace를 함께 기록해 확인한다.
호출 이름만 나열하지 않고, 각 단계가 다음 단계에 넘기는 상태를 기준으로 실행 순서를 표시한다.
왼쪽 생산자가 가운데 상태를 완성하고, 오른쪽 소비자가 그 상태를 처음 사용하는 관계다.
devfs_create→cdev_list→/dev nodeopen→struct file→cdev referenceread/write→offset + count→driver operation비-MTD partition→누적 child offset→master callbackdevfs_remove→cdev->open→열려 있으면 -EBUSYUPSTREAM SOURCE
원본 코드
원문 Barebox v2026.06.1 · fs/devfs-core.c의 480–546행입니다.
480static void devfs_mknod(struct cdev *cdev)
481{
482 char *path;
483 int ret;
484 struct cdev_alias *alias;
485
486 if (!devfs_initialized)
487 return;
488
489 path = xasprintf("/dev/%s", cdev->name);
490
491 cdev_for_each_alias(alias, cdev)
492 cdev_symlink(cdev, alias->name);
493
494 ret = mknod(path, S_IFCHR | 0600, cdev->name);
495
496 free(path);
497
498 if (ret) {
499 pr_err("Failed to create /dev/%s: %pe\n", cdev->name, ERR_PTR(ret));
500 dump_stack();
501 }
502}
503
504static void devfs_unlink(const char *name)
505{
506 char *path;
507
508 path = xasprintf("/dev/%s", name);
509
510 unlink(path);
511
512 free(path);
513}
514
515void devfs_init(void)
516{
517 struct cdev *cdev;
518
519 devfs_initialized = true;
520
521 for_each_cdev(cdev)
522 devfs_mknod(cdev);
523}
524
525int devfs_create(struct cdev *new)
526{
527 struct cdev *cdev;
528
529 cdev = cdev_by_name(new->name);
530 if (cdev)
531 return -EEXIST;
532
533 INIT_LIST_HEAD(&new->partitions);
534 INIT_LIST_HEAD(&new->aliases);
535
536 list_add_tail(&new->list, &cdev_list);
537 if (new->dev) {
538 list_add_tail(&new->devices_list, &new->dev->cdevs);
539 if (!new->device_node)
540 new->device_node = new->dev->of_node;
541 }
542
543 devfs_mknod(new);
544
545 return 0;
546}
READING CONTRACT
발췌 범위와 읽기 기준
원문 480–546행은 devfs_mknod(), devfs_init(), devfs_create()를 포함합니다. 등록 목록에 들어가는 시점과 /dev 노드가 생성되는 시점을 구분해서 읽습니다. 읽기·쓰기 콜백은 fs/devfs.c 39–55행에서 확인합니다.
Barebox shell에서 path로 장치를 다룰 수 있는 이유가 이 경계다. cdev offset/size와 partition child cdev의 상대 주소 계산을 확인한다.
devfs_mknod()의 mknod() 오류는 로그와 stack dump로만 보고된다. devfs_create()는 등록 목록을 되돌리지 않고 0을 반환하므로 node 존재를 따로 확인해야 한다. devfs_remove()도 unlink와 child 제거의 반환 오류를 이 호출자에게 전파하지 않는다.
RELATED SOURCE
함께 읽어야 하는 원본 코드
첫 코드 조각만으로 동작이 완성되지 않는 경우 호출 매크로, 객체 정의와 실제 실행 목록을 같은 페이지에 묶었다. 각 조각은 같은 기준 commit에서 가져왔다.
01. inode의 cdev를 open file에 결합하는 devfs_open
fs/devfs.c 92-158줄이다.
92 return cdev_discard_range(cdev, count, offset);
93}
94
95static int devfs_memmap(struct file *f, void **map, int flags)
96{
97 struct cdev *cdev = f->private_data;
98
99 return cdev_memmap(cdev, map, flags);
100}
101
102static int devfs_open(struct inode *inode, struct file *f)
103{
104 struct devfs_inode *node = container_of(inode, struct devfs_inode, inode);
105 struct cdev *cdev = node->cdev;
106
107 if (inode->cdevname) {
108 cdev = cdev_by_name(inode->cdevname);
109 if (!cdev)
110 return -ENOENT;
111 }
112
113 f->f_size = cdev_size(cdev);
114 f->private_data = cdev;
115
116 return cdev_open(cdev, f->f_flags);
117}
118
119static int devfs_close(struct inode *inode, struct file *f)
120{
121 struct cdev *cdev = f->private_data;
122
123 return cdev_close(cdev);
124}
125
126static int devfs_flush(struct file *f)
127{
128 struct cdev *cdev = f->private_data;
129
130 return cdev_flush(cdev);
131}
132
133static int devfs_ioctl(struct file *f, unsigned int request, void *buf)
134{
135 struct cdev *cdev = f->private_data;
136
137 return cdev_ioctl(cdev, request, buf);
138}
139
140static int devfs_truncate(struct file *f, loff_t size)
141{
142 struct cdev *cdev = f->private_data;
143
144 return cdev_truncate(cdev, size);
145}
146
147static const struct file_operations devfs_file_operations = {
148 .open = devfs_open,
149 .release = devfs_close,
150 .read = devfs_read,
151 .write = devfs_write,
152 .lseek = devfs_lseek,
153 .flush = devfs_flush,
154 .ioctl = devfs_ioctl,
155 .truncate = devfs_truncate,
156 .erase = devfs_erase,
157 .protect = devfs_protect,
158 .discard_range = devfs_discard_range,
DETAILS
내부 동작을 더 깊게 읽기
cdev 등록과 /dev node 생성은 구분한다
devfs_create()는 같은 이름이 있으면 -EEXIST를 반환한다. 성공하면 cdev를 목록에 넣고 devfs_mknod()를 부른다. devfs가 아직 초기화되지 않았다면 node 생성은 보류되며, 나중에 devfs_init()이 등록된 cdev를 순회해 만든다.
open에서 inode와 file을 연결한다
devfs_open()은 inode에 결합된 cdev를 사용하거나 cdevname으로 다시 찾는다. 찾지 못하면 -ENOENT다. 찾았다면 f_size=cdev_size(cdev)와 private_data=cdev를 설정하고 cdev_open()을 호출한다. open count는 driver의 open callback이 성공한 뒤 증가한다.
길이 제한과 file position 갱신은 다른 함수다
fs/fs.c::__read()는 쓰기 전용 file을 거부하고, 유한 크기라면 EOF를 넘는 count를 줄인다. 이어 devfs_read()가 현재 f_pos를 cdev_read()에 넘긴다. 일반 read()는 양수 반환분만큼 f_pos를 늘리지만, pread()는 임시 offset을 쓰고 원래 위치를 복원한다.
partition callback의 기준 offset을 구분한다
비-MTD partition은 child를 만들 때 parent의 누적 offset을 child의 offset에 포함한다. cdev_read()는 cdev->offset + f_pos를 callback에 넘기고, 이 경우 cdev_get_master()가 master cdev를 선택한다. MTD partition은 mtd_add_partition()을 사용하는 별도 경로이며 cdev_get_master()도 MTD cdev 자체를 반환한다.
close 뒤 제거 가능 여부를 확인한다
devfs_close()는 cdev_close()로 연결된다. close callback이 성공한 뒤 open count가 감소한다. devfs_remove()는 해당 cdev가 아직 열려 있으면 -EBUSY를 반환하고 목록과 /dev 이름을 그대로 둔다. 다른 경로가 driver private data를 먼저 해제하지 않는지도 별도 확인해야 한다.
함수 경계는 Barebox v2026.06.1의 fs/devfs.c, fs/devfs-core.c, fs/fs.c에 고정했다.
IMPLEMENTATION NOTES
구현을 읽을 때 놓치기 쉬운 부분
cdev가 hardware operation을 파일 offset으로 번역한다
devfs inode와 open file은 struct cdev를 참조하고 read/write offset과 count를 driver callback에 넘긴다. 비-MTD __devfs_add_partition()에서 child의 offset에 parent의 누적 offset이 이미 들어간다. cdev_read()가 이 child offset을 file offset에 한 번 더해 master callback에 넘기므로, parent offset을 수동으로 다시 더하면 다른 영역을 읽는다. MTD partition은 mtd_add_partition()을 호출하는 별도 분기다.
파일 offset, cdev base, parent base를 로그에 각각 남긴다.
open file과 cdev unregister가 경쟁한다
shell command가 file을 연 채 device를 제거할 수 있다면 cdev와 driver private data의 reference를 유지해야 한다. devfs_remove()는 해당 cdev의 open count가 0이 아니면 -EBUSY를 반환한다. driver private data를 별도로 해제하는 경로도 같은 수명을 지키는지 확인한다.
remove 중 read/write를 주입해 dangling pointer를 찾는다.
size와 operation 단위 계약을 맞춘다
cdev size는 byte인데 block backend는 sector 단위를 요구할 수 있다. short read, EOF와 alignment error를 devfs가 어떻게 반환하는지 확인한다.
hexdump의 요청 범위와 실제 driver trace range를 대조한다.
OBJECT LIFETIME
객체와 수명
등록 객체, path의 inode, 열린 file은 서로 다른 시점에 생긴다. 한 행으로 묶으면 해제 조건을 잘못 판단하기 쉽다.
| 대상 | 생성·연결 시점 | 유효 범위 | 근거와 확인 조건 |
|---|---|---|---|
struct cdev | driver가 준비한 뒤 devfs_create()가 목록에 등록 | devfs_remove() 성공 전까지 | 이름 중복은 -EEXIST; 열린 cdev 제거는 -EBUSY |
/dev inode | devfs_mknod(); 초기화 전 등록분은 devfs_init()에서 생성 | path가 제거될 때까지 | open에서 inode의 cdev 또는 cdevname으로 다시 찾는다 |
struct file | open 때 f_size와 private_data를 설정 | close 때까지 | cdev_open()/cdev_close()의 open count와 f_pos 확인 |
| 비-MTD partition child cdev | __devfs_add_partition()가 parent offset을 포함해 등록 | child가 제거될 때까지 | callback에는 master cdev와 child의 누적 offset이 전달된다 |
FAILURE PATH
실패 지점과 증상
| # | 조건 | 실제 경계·증상 | 먼저 볼 코드 |
|---|---|---|---|
| 01 | 유한 크기 파일의 EOF 근처에서 read | 요청 count를 남은 길이까지 줄이거나 0을 반환 | fs/fs.c::__read() |
| 02 | 비-MTD partition offset을 호출자가 다시 더함 | child의 누적 offset과 중복되어 master callback이 잘못된 위치를 읽음 | __devfs_add_partition()·cdev_read() |
| 03 | 열린 cdev를 제거하려 함 | devfs_remove()가 -EBUSY로 제거를 거부 | cdev_open()·cdev_close()·devfs_remove() |
다른 경로가 driver private data를 조기 해제하는 경우는 이 표의 devfs_remove() 보호 범위 밖이다. 실제 보드의 해제 순서를 따로 검증한다.
EVIDENCE
소스 밖에서 확인할 증거
v2026.06.1 소스의 경계는 고정됐지만 실제 cdev 이름·size·offset은 보드와 driver에 따라 다르다. 아래 관찰값을 같은 read 요청에 묶어 비교한다.
| # | 관찰 위치 | 기록할 값 | 소스와 대조할 조건 |
|---|---|---|---|
| 01 | cdev 등록과 /dev path | cdev 이름·size·offset, node 생성 시점 | 초기화 전 등록이면 devfs_init() 뒤 node가 보인다 |
| 02 | open file | f_size, private_data, f_pos | 선택한 cdev와 file이 일치한다 |
| 03 | read 요청과 반환 | 요청 count, 조정된 count, 실제 반환 바이트 | 유한 크기 EOF clipping과 stream 예외를 구분한다 |
| 04 | read callback | cdev offset, file f_pos, callback offset | callback offset = cdev offset + file offset; 비-MTD partition의 callback 대상은 master |
| 05 | 해제 경계 | open count와 devfs_remove() 반환값 | 열려 있으면 -EBUSY이며 path는 유지된다 |
LAB
직접 확인할 실험
- 01등록과 node 생성 시점 분리
cdev를 등록한 시점과
/dev/<name>이 보이는 시점을 비교한다. devfs 초기화 전 등록분은devfs_init()이 node를 만든다. - 02
read()와pread()의 file position 비교같은 file offset의 반환 바이트 수와 전후
f_pos를 기록한다.read()는 양수 반환분만 증가시키고pread()는 이전 위치로 되돌린다. - 03비-MTD partition offset을 master callback에서 확인
child cdev의 누적 offset과 file offset을 따로 기록하고, callback에 전달된 offset이 정확히 그 합인지 확인한다. MTD partition은 별도 분기로 기록한다.
PRIMARY REFERENCES