QUESTION
매칭 뒤 callback과 defer는 어떻게 갈라지는가?
match()가 후보 driver를 임시로 붙여 bus match를 확인한 뒤 device_probe()를 호출한다. 이 경로는 device 등록 또는 driver 등록 중에도 실행될 수 있다.
device_probe()는 feature gate를 확인하고 pinctrl·clock 기본 설정 함수를 호출한 뒤, callback 실행 전에 active 목록에 넣는다. callback 결과에 따라 남거나 deferred로 옮기거나 목록에서 뺀다.
STRUCTURE
match와 probe가 건드리는 객체
feature check→오류/FEATCTRL_GATED면 callback 전 반환 · L126–132active list←pinctrl·clock 호출 뒤 callback 전 삽입 · L138–141callback→bus->probe 우선, 아니면 driver->probe, 둘 다 없으면 0 · L143–148플랫폼 bus callback은 power domain attach 뒤 driver probe를 호출한다(platform.c L14–23). 모든 bus가 같은 준비 절차를 갖지는 않는다.
CALL PATH
callback 이전까지의 실행 순서
pinctrl_select_state_default()와 of_clk_set_defaults()의 반환값은 여기서 검사하지 않는다. provider 확보와 child/cdev 생성은 해당 callback의 일이다.
STATE LEDGER
callback 결과별 목록·driver 상태
| 결과 | device_probe 내부 | match 이후 |
|---|---|---|
| feature 오류 / gated | active 삽입 전 오류 또는 -ENODEV 반환 · L126–132 | driver 포인터 NULL; 다음 후보 가능 |
| callback 0 | active에 남고 0 반환 · L141, L153–154 | driver 유지, 후보 검색 중단 |
| -EPROBE_DEFER, 일반 | active node를 deferred로 이동 · L165–168 | driver NULL; late initcall 재시도 대상 |
| -EPROBE_DEFER, deep-probe 지원 | 즉시 영구 defer 보고, active에서 제거 · L160–162, L178 | driver NULL; deferred 목록에 추가 안 됨 |
| 그 밖의 실패 | -ENODEV/-ENXIO는 debug, 나머지는 error 로그; active 분리 · L169–180 | driver NULL; 다음 후보 가능 |
VISUAL WALKTHROUGH
active·deferred 목록의 상태 변화
active 목록에서 관찰된 순간만으로 callback 완료나 private state 유효성을 단정하지 않는다.
provider 등록 이벤트마다 즉시 독립 재시도하는 일반 Linux식 정책으로 설명하지 않는다.
UPSTREAM SOURCE
원본 코드
아래 코드는 Barebox v2026.06.1의 drivers/base/driver.c에서 97-185줄을 그대로 가져온 것이다.
97
98 free(str);
99
100 return dev;
101}
102
103int get_free_deviceid_from(const char *name_template, int id_from)
104{
105 while (1) {
106 if (!get_device_by_name_id(name_template, id_from))
107 return id_from;
108 id_from++;
109 };
110}
111
112static void dev_report_permanent_probe_deferral(struct device *dev)
113{
114 if (dev->deferred_probe_reason)
115 dev_err(dev, "probe permanently deferred (%s)\n",
116 dev->deferred_probe_reason);
117 else
118 dev_err(dev, "probe permanently deferred\n");
119}
120
121int device_probe(struct device *dev)
122{
123 static int depth = 0;
124 int ret;
125
126 ret = of_feature_controller_check(dev->of_node);
127 if (ret < 0)
128 return ret;
129 if (ret == FEATCTRL_GATED) {
130 dev_dbg(dev, "feature gated, skipping probe\n");
131 return -ENODEV;
132 }
133
134 depth++;
135
136 pr_report_probe("%*sprobe-> %s\n", depth * 4, "", dev_name(dev));
137
138 pinctrl_select_state_default(dev);
139 of_clk_set_defaults(dev->of_node, false);
140
141 list_add(&dev->active, &active_device_list);
142
143 if (dev->bus->probe)
144 ret = dev->bus->probe(dev);
145 else if (dev->driver->probe)
146 ret = dev->driver->probe(dev);
147 else
148 ret = 0;
149
150 depth--;
151
152 switch (ret) {
153 case 0:
154 return 0;
155 case -EPROBE_DEFER:
156 /*
157 * -EPROBE_DEFER should never appear on a deep-probe machine so
158 * inform the user immediately.
159 */
160 if (deep_probe_is_supported()) {
161 dev_report_permanent_probe_deferral(dev);
162 break;
163 }
164
165 list_move(&dev->active, &deferred);
166
167 dev_dbg(dev, "probe deferred\n");
168 return -EPROBE_DEFER;
169 case -ENODEV:
170 case -ENXIO:
171 dev_dbg(dev, "probe failed: %pe\n", ERR_PTR(ret));
172 break;
173 default:
174 dev_err(dev, "probe failed: %pe\n", ERR_PTR(ret));
175 break;
176 }
177
178 list_del_init(&dev->active);
179
180 return ret;
181}
182
183int device_detect(struct device *dev)
184{
185 if (!dev->detect)
READING CONTRACT
발췌 범위와 읽기 기준
원본 코드 97–185줄은 앞 문맥, device_probe() L121–181, device_detect() 시작을 포함한다. 보충 발췌 375–455줄에는 late deferred worker와 driver 등록이 함께 있다.
match() L223–242가 probe 오류를 -1로 접고 후보 driver를 비운다. 플랫폼 bus callback은 platform.c L14–23을 참조한다.
RELATED SOURCE
함께 읽어야 하는 원본 코드
첫 코드 조각만으로 동작이 완성되지 않는 경우 호출 매크로, 객체 정의와 실제 실행 목록을 같은 페이지에 묶었다. 각 조각은 같은 기준 commit에서 가져왔다.
01. late initcall의 deferred 재시도와 driver 등록 경로
drivers/base/driver.c 375-455줄이다.
375}
376EXPORT_SYMBOL(free_device);
377
378/*
379 * Loop over list of deferred devices as long as at least one
380 * device is successfully probed. Devices that again request
381 * deferral are re-added to deferred list in device_probe().
382 * For devices finally left in deferred list -EPROBE_DEFER
383 * becomes a fatal error.
384 */
385static int device_probe_deferred(void)
386{
387 struct device *dev, *tmp;
388 struct driver *drv;
389 bool success;
390
391 do {
392 success = false;
393
394 if (list_empty(&deferred))
395 return 0;
396
397 list_for_each_entry_safe(dev, tmp, &deferred, active) {
398 list_del(&dev->active);
399 INIT_LIST_HEAD(&dev->active);
400
401 dev_dbg(dev, "re-probe device\n");
402 bus_for_each_driver(dev->bus, drv) {
403 if (match(drv, dev))
404 continue;
405 success = true;
406 break;
407 }
408 }
409 } while (success);
410
411 list_for_each_entry(dev, &deferred, active)
412 dev_report_permanent_probe_deferral(dev);
413
414 return 0;
415}
416late_initcall(device_probe_deferred);
417
418struct driver *get_driver_by_name(const char *name)
419{
420 struct driver *drv;
421
422 for_each_driver(drv) {
423 if(!strcmp(name, drv->name))
424 return drv;
425 }
426
427 return NULL;
428}
429
430int register_driver(struct driver *drv)
431{
432 struct device *dev = NULL;
433
434 if (!drv->name)
435 return -EINVAL;
436
437 debug("register_driver: %s\n", drv->name);
438
439 BUG_ON(!drv->bus);
440
441 list_add_tail(&drv->list, &driver_list);
442 list_add_tail(&drv->bus_list, &drv->bus->driver_list);
443
444 bus_for_each_device(drv->bus, dev)
445 match(drv, dev);
446
447 return 0;
448}
449EXPORT_SYMBOL(register_driver);
450
451void unregister_driver(struct driver *drv)
452{
453 struct device *dev;
454
455 list_del(&drv->list);
DETAILS
고정 소스의 probe 순서
feature gate가 active보다 앞섬
of_feature_controller_check의 음수 오류는 그대로, FEATCTRL_GATED는 -ENODEV로 반환한다(L126–132). 두 경우 callback 실행과 active 연결이 없다.
기본 설정과 callback은 다른 단계
pinctrl_select_state_default와 of_clk_set_defaults는 호출만 하고 반환값을 검사하지 않는다(L138–139). active 삽입 뒤 bus callback이 있으면 우선 실행한다.
defer는 deep-probe 여부로 분기
일반 경로는 deferred 목록으로 이동한다. deep-probe 지원 경로는 즉시 영구 defer를 보고하고 active에서 분리한다(L155–178).
IMPLEMENTATION NOTES
callback 책임과 재시도 범위
bus callback이 driver callback보다 우선
L143–148은 bus->probe, driver->probe, callback 없음의 세 갈래다. 플랫폼 bus는 power domain attach 뒤 driver callback을 호출하지만 모든 bus의 공통 절차는 아니다.
core 오류 정리는 목록과 포인터 중심
device_probe는 오류 시 active node를 분리하고 match는 driver 포인터를 비운다. callback에서 만든 child/cdev/clock을 이 두 함수가 일괄 역순 해제하지는 않는다.
late deferred pass는 진행이 멈출 때 끝남
device_probe_deferred는 한 pass에서 성공이 있으면 다시 순회한다(L391–409). 성공 없는 pass 뒤 남은 device를 보고한다(L411–416).
OBJECT LIFETIME
probe 동안 바뀌는 참조와 목록
| 대상 | 진입/변화 | 성공/실패 후 |
|---|---|---|
| dev->driver | match가 후보를 먼저 대입 · L230 | 성공 유지; 실패 NULL · L239–241 |
| dev->active | callback 전에 active 목록 연결 · L141 | 성공 유지; 일반 defer는 이동; 기타 실패는 분리 |
| private state | bus/driver callback 구현에 따름 | core가 일괄 생성·해제하지 않음 |
| deferred 목록 | 일반 -EPROBE_DEFER에서 추가 | late initcall 재시도 뒤 남은 항목 보고 |
FAILURE PATH
실패 종류별 관찰점
| 조건 | core 동작 | 조사 범위 |
|---|---|---|
| feature 오류/차단 | callback 전 반환; active 변화 없음 | of_node와 feature controller |
| 일반 -EPROBE_DEFER | deferred 이동, match에서 driver NULL | provider와 late 재시도 |
| deep-probe에서 defer | 즉시 영구 defer 보고, active 분리 | deep-probe 의존성 |
| 다른 callback 오류 | active 분리, driver NULL | driver별 부분 초기화 정리 |
-ENODEV/-ENXIO는 debug, 다른 오류는 error 로그를 남긴다(L169–175). 로그 수준을 callback 실행 여부와 혼동하지 않는다.
EVIDENCE
빌드와 기기에서 볼 증거
| 목적 | 읽기 전용 확인 | 판정 |
|---|---|---|
| 심벌 | ${CROSS_COMPILE}nm -n barebox | grep -E ' (device_probe|device_probe_deferred)$' | 정적 함수 심벌은 빌드 옵션·최적화에 따라 다를 수 있다. |
| device/driver | devinfo; drvinfo | 등록, driver 결합, callback 성공을 로그와 대조. |
| defer 원인 | probe 로그 및 dev_err_probe 이유 | late pass 전후 결과를 분리. |
LAB
분기를 구별하는 관찰
- 01callback 전후 active 기록
L141과 L152에서 dev->active 연결 상태를 비교한다.
- 02defer와 일반 오류 분리
callback 반환값, deep-probe 지원 여부, deferred 이동과 driver 포인터를 한 줄로 기록한다.
- 03late deferred pass 수 확인
한 pass의 성공 여부와 남은 항목 수를 기록한다.
PRIMARY REFERENCES