Barebox · source analysis

cdev와 /dev 파일 경계

character device가 devfs inode로 노출되고 read/write가 driver operation으로 전달되는 구조를 읽습니다.

Barebox v2026.06.1은 이 글의 코드 분석 기준입니다. 제품에 적용할 때는 해당 Barebox 릴리스와 실제 보드 설정을 확인하세요.

Series
09 / 19
Baseline
v2026.06.1
Commit
314c679eea2d
Source
fs/devfs-core.c:480-546 (발췌 범위)

cdev와 /dev 파일 경계 단계에서 실제로 바뀌는 상태는 무엇인가?

Barebox shell에서 path로 장치를 다룰 수 있는 이유가 이 경계다. cdev offset/size와 partition child cdev의 상대 주소 계산을 확인한다.

파일 offset과 cdev 상대 offset을 block/byte 단위 혼동 없이 driver callback에 전달해야 한다. 이 문장을 기준으로 코드를 위에서 아래로 읽으면, 함수 이름을 외우는 대신 어느 시점에 어떤 상태를 신뢰할 수 있는지 판단할 수 있다.

객체와 주소가 놓이는 구조

그림 1. cdev와 /dev 파일 경계에서 입력, 내부 상태, 출력의 경계
입력과 전제내부 상태외부로 공개되는 결과
01struct cdev
02devfs inode
03struct file
04driver callbacks

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

실행 흐름

그림 2. 정상 경로의 주요 호출과 상태 전달
driver registers cdev
/dev node
open file
devfs_read
cdev operation

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 생성 성공은 따로 확인한다.

단계별 입력과 출력

그림 2의 넓은 단계를 v2026.06.1의 실제 함수 경계로 나눴다. cdev_read() 자체는 크기 제한이나 file position 갱신을 수행하지 않는다.

#실제 단계진입 시 필요한 상태성공 뒤 남는 상태다음 소비자
01devfs_create()이름·크기·operations가 설정된 cdevcdev_list에 등록devfs_mknod() 또는 후속 devfs_init()
02devfs_mknod()등록된 cdev와 초기화된 devfs/dev/<name> nodepath lookup·devfs_open()
03devfs_open()inode가 가리키는 cdev 또는 이름으로 찾은 cdevf_size=cdev_size(), private_data=cdev, 성공한 open countfs/fs.c::__read()
04__read()f_pos, 요청 count, file size·flags유한 크기 파일이면 요청 길이를 EOF까지 제한devfs_read()
05devfs_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은 유한 크기 제한의 예외다.

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

아래 그림은 /dev path, 열린 file, cdev와 read callback 사이에서 값이 옮겨가는 시점을 표시한다. 실제 요청은 열린 file의 f_pos·f_size, cdev의 size·offset과 driver trace를 함께 기록해 확인한다.

그림 3. /dev 경로의 read가 driver callback까지 내려가는 과정

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

01path lookup
02devfs inode
03file offset
04VFS의 유한 크기 제한
05partition offset 보정
06cdev->ops->read
07read()의 f_pos 갱신
그림 4. devfs·cdev·driver 객체의 연결

왼쪽 생산자가 가운데 상태를 완성하고, 오른쪽 소비자가 그 상태를 처음 사용하는 관계다.

01devfs_createcdev_list/dev node
02openstruct filecdev reference
03read/writeoffset + countdriver operation
04비-MTD partition누적 child offsetmaster callback
05devfs_removecdev->open열려 있으면 -EBUSY

원본 코드

원문 Barebox v2026.06.1 · fs/devfs-core.c의 480–546행입니다.

commit314c679eea2d0ca847c64d1b646a1cf91225c0ecanchor · L525int devfs_create(struct cdev *new)
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}

발췌 범위와 읽기 기준

원문 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 제거의 반환 오류를 이 호출자에게 전파하지 않는다.

함께 읽어야 하는 원본 코드

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

01. inode의 cdev를 open file에 결합하는 devfs_open

fs/devfs.c 92-158줄이다.

filefs/devfs.canchor · L102static int devfs_open
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,

내부 동작을 더 깊게 읽기

01

cdev 등록과 /dev node 생성은 구분한다

devfs_create()는 같은 이름이 있으면 -EEXIST를 반환한다. 성공하면 cdev를 목록에 넣고 devfs_mknod()를 부른다. devfs가 아직 초기화되지 않았다면 node 생성은 보류되며, 나중에 devfs_init()이 등록된 cdev를 순회해 만든다.

02

open에서 inode와 file을 연결한다

devfs_open()은 inode에 결합된 cdev를 사용하거나 cdevname으로 다시 찾는다. 찾지 못하면 -ENOENT다. 찾았다면 f_size=cdev_size(cdev)와 private_data=cdev를 설정하고 cdev_open()을 호출한다. open count는 driver의 open callback이 성공한 뒤 증가한다.

03

길이 제한과 file position 갱신은 다른 함수다

fs/fs.c::__read()는 쓰기 전용 file을 거부하고, 유한 크기라면 EOF를 넘는 count를 줄인다. 이어 devfs_read()가 현재 f_pos를 cdev_read()에 넘긴다. 일반 read()는 양수 반환분만큼 f_pos를 늘리지만, pread()는 임시 offset을 쓰고 원래 위치를 복원한다.

04

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 자체를 반환한다.

05

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에 고정했다.

구현을 읽을 때 놓치기 쉬운 부분

01

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를 로그에 각각 남긴다.

02

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를 찾는다.

03

size와 operation 단위 계약을 맞춘다

cdev size는 byte인데 block backend는 sector 단위를 요구할 수 있다. short read, EOF와 alignment error를 devfs가 어떻게 반환하는지 확인한다.

hexdump의 요청 범위와 실제 driver trace range를 대조한다.

객체와 수명

등록 객체, path의 inode, 열린 file은 서로 다른 시점에 생긴다. 한 행으로 묶으면 해제 조건을 잘못 판단하기 쉽다.

대상생성·연결 시점유효 범위근거와 확인 조건
struct cdevdriver가 준비한 뒤 devfs_create()가 목록에 등록devfs_remove() 성공 전까지이름 중복은 -EEXIST; 열린 cdev 제거는 -EBUSY
/dev inodedevfs_mknod(); 초기화 전 등록분은 devfs_init()에서 생성path가 제거될 때까지open에서 inode의 cdev 또는 cdevname으로 다시 찾는다
struct fileopen 때 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이 전달된다

실패 지점과 증상

#조건실제 경계·증상먼저 볼 코드
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() 보호 범위 밖이다. 실제 보드의 해제 순서를 따로 검증한다.

소스 밖에서 확인할 증거

v2026.06.1 소스의 경계는 고정됐지만 실제 cdev 이름·size·offset은 보드와 driver에 따라 다르다. 아래 관찰값을 같은 read 요청에 묶어 비교한다.

#관찰 위치기록할 값소스와 대조할 조건
01cdev 등록과 /dev pathcdev 이름·size·offset, node 생성 시점초기화 전 등록이면 devfs_init() 뒤 node가 보인다
02open filef_size, private_data, f_pos선택한 cdev와 file이 일치한다
03read 요청과 반환요청 count, 조정된 count, 실제 반환 바이트유한 크기 EOF clipping과 stream 예외를 구분한다
04read callbackcdev offset, file f_pos, callback offsetcallback offset = cdev offset + file offset; 비-MTD partition의 callback 대상은 master
05해제 경계open count와 devfs_remove() 반환값열려 있으면 -EBUSY이며 path는 유지된다

직접 확인할 실험

  1. 01
    등록과 node 생성 시점 분리

    cdev를 등록한 시점과 /dev/<name>이 보이는 시점을 비교한다. devfs 초기화 전 등록분은 devfs_init()이 node를 만든다.

  2. 02
    read()와 pread()의 file position 비교

    같은 file offset의 반환 바이트 수와 전후 f_pos를 기록한다. read()는 양수 반환분만 증가시키고 pread()는 이전 위치로 되돌린다.

  3. 03
    비-MTD partition offset을 master callback에서 확인

    child cdev의 누적 offset과 file offset을 따로 기록하고, callback에 전달된 offset이 정확히 그 합인지 확인한다. MTD partition은 별도 분기로 기록한다.

원문과 다음 글