QUESTION파일이 열리는 시점과 TA 핸들이 공개되는 시점은 왜 다른가?
OP-TEE 4.10.0의 syscall_storage_obj_open()은 storage backend, 현재 TA UUID, 복사한 object ID로 persistent object를 찾는다. tee_obj_add()는 header를 읽기 전에 내부 목록에 객체를 연결하지만, TA-visible reference는 읽기와 metadata 해석이 성공한 뒤에만 기록한다.
이 글은 공통 storage syscall의 검사 순서와 객체 수명을 다룬다. backend가 반환한 성공을 시스템 전체의 암호화·rollback 방지·전원 차단 내구성 검증으로 확대하지 않는다. 해당 보장은 선택한 backend와 제품 설정을 별도로 검토해야 한다.
STRUCTURE
객체와 주소가 놓이는 구조
tee_obj / tee_file_handle / storage backend를 중심에 놓고 왼쪽의 입력이 어떤 검사를 거쳐 오른쪽 결과로 공개되는지 표시했다. 실제 디버깅에서는 각 블록의 주소와 크기를 로그에 대입한다.
CALL PATH
실행 흐름
tee_obj_add(utc, o)는 검증 전에 secure-world 내부 목록에 연결한다. TA가 받는 reference는 header/attribute 검사 성공 뒤 copy_kaddr_to_uref(obj, o)에서 기록된다. 실패 시에는 결과 코드에 따라 내부 객체를 닫거나 손상 객체를 제거한다.
STATE LEDGER
단계별 입력과 출력
같은 함수의 정상 경로에서 내부 포인터와 TA에 반환되는 reference를 구분한다. 줄 번호는 고정 4.10.0 발췌와 원문을 기준으로 한다.
| # | 실행 단계 | 입력 | 성공 뒤 상태 | 소스 |
|---|---|---|---|---|
| 01 | fops 선택·입력 검사 | storage_id, flags, ID 길이 | backend ops 포인터; 잘못된 값은 즉시 오류 | L171–190 |
| 02 | ID 복사·tee_pobj_get() | 현재 session UUID, ID, flags, fops | po; 임시 oid_bbuf는 즉시 해제 | L193–202 |
| 03 | tee_obj_alloc()·tee_obj_add() | po, 요청 TA의 utc | o->pobj와 내부 object 목록 연결; 아직 TA 반환값 없음 | L204–214 |
| 04 | tee_svc_storage_read_head() | o와 backend ops | o->fh 열림, header/attribute 크기와 metadata 처리 | L216–225 및 관련 원본 |
| 05 | copy_kaddr_to_uref() | 검사에 성공한 o | 호출 TA에 opaque object reference 반환 | 고정 원문 L227–244 |
분석 범위의 전제와 비교하되, 내부 목록 연결과 TA-visible handle 반환을 별개 사건으로 추적한다.
VISUAL WALKTHROUGH
주소와 객체의 이동을 그림으로 읽기
아래 그림은 주소, 객체를 사용하는 기간, 제어권을 넘기는 시점을 중심으로 정리했다. 실제 secure-world 포인터와 크기는 해당 OP-TEE 빌드의 로그·맵·링커 심벌로 확인한다.
고정 4.10.0 syscall_storage_obj_open()의 성공 경로다.
fops 선택·검사tee_pobj_get()tee_obj_add(utc, o)read_head(o)입력·생산·소비 관계이며 backend 내부의 암호화 구현 순서를 단정하지 않는다.
storage_id→tee_svc_storage_file_ops()→fopsTA UUID + secure ID copy→tee_pobj_get()→popo + utc→tee_obj_add()→내부 tee_obj 목록검사 성공한 o→copy_kaddr_to_uref()→TA opaque referenceUPSTREAM SOURCE
원본 코드
아래 코드는 OP-TEE OS 4.10.0의 core/tee/tee_svc_storage.c에서 138-226줄을 그대로 가져온 것이다.
138 if (res != TEE_SUCCESS)
139 goto exit;
140 if (bytes != head.attr_size) {
141 res = TEE_ERROR_CORRUPT_OBJECT;
142 goto exit;
143 }
144 }
145
146 res = tee_obj_attr_from_binary(o, attr, head.attr_size);
147 if (res != TEE_SUCCESS)
148 goto exit;
149
150 o->info.dataSize = size - sizeof(head) - head.attr_size;
151 o->info.objectSize = head.objectSize;
152 o->pobj->obj_info_usage = head.objectUsage;
153 o->info.objectType = head.objectType;
154 o->have_attrs = head.have_attrs;
155
156exit:
157 free(attr);
158
159 return res;
160}
161
162TEE_Result syscall_storage_obj_open(unsigned long storage_id, void *object_id,
163 size_t object_id_len, unsigned long flags,
164 uint32_t *obj)
165{
166 const unsigned long valid_flags = TEE_DATA_FLAG_ACCESS_READ |
167 TEE_DATA_FLAG_ACCESS_WRITE |
168 TEE_DATA_FLAG_ACCESS_WRITE_META |
169 TEE_DATA_FLAG_SHARE_READ |
170 TEE_DATA_FLAG_SHARE_WRITE;
171 const struct tee_file_operations *fops =
172 tee_svc_storage_file_ops(storage_id);
173 struct ts_session *sess = ts_get_current_session();
174 struct user_ta_ctx *utc = to_user_ta_ctx(sess->ctx);
175 TEE_Result res = TEE_SUCCESS;
176 struct tee_pobj *po = NULL;
177 struct tee_obj *o = NULL;
178 void *oid_bbuf = NULL;
179
180 if (flags & ~valid_flags)
181 return TEE_ERROR_BAD_PARAMETERS;
182
183 if (!fops) {
184 res = TEE_ERROR_ITEM_NOT_FOUND;
185 goto exit;
186 }
187
188 if (object_id_len > TEE_OBJECT_ID_MAX_LEN) {
189 res = TEE_ERROR_BAD_PARAMETERS;
190 goto exit;
191 }
192
193 res = bb_memdup_user_private(object_id, object_id_len, &oid_bbuf);
194 if (res)
195 goto exit;
196
197 res = tee_pobj_get((void *)&sess->ctx->uuid, oid_bbuf,
198 object_id_len, flags, TEE_POBJ_USAGE_OPEN, fops,
199 &po);
200 bb_free(oid_bbuf, object_id_len);
201 if (res != TEE_SUCCESS)
202 goto err;
203
204 o = tee_obj_alloc();
205 if (o == NULL) {
206 tee_pobj_release(po);
207 res = TEE_ERROR_OUT_OF_MEMORY;
208 goto err;
209 }
210
211 o->info.handleFlags = TEE_HANDLE_FLAG_PERSISTENT |
212 TEE_HANDLE_FLAG_INITIALIZED | flags;
213 o->pobj = po;
214 tee_obj_add(utc, o);
215
216 tee_pobj_lock_usage(o->pobj);
217 res = tee_svc_storage_read_head(o);
218 tee_pobj_unlock_usage(o->pobj);
219 if (res != TEE_SUCCESS) {
220 if (res == TEE_ERROR_CORRUPT_OBJECT) {
221 EMSG("Object corrupt");
222 goto err;
223 }
224 goto oclose;
225 }
226
READING CONTRACT세 발췌와 전체 함수의 경계
첫 발췌 L138–226은 이전 함수의 끝과 open L162–226을 포함하며, reference 복사와 정리는 잘려 있다. copy_kaddr_to_uref()와 오류 경로는 L227–244에서 이어진다.
L297–413은 파일 초기화의 끝과 create의 일부다. L73–169에는 remove_corrupt_obj() L76–81, tee_svc_storage_read_head() L83–159, open의 시작이 함께 있다. 세 상자는 하나의 연속 실행 경로가 아니다.
RELATED SOURCE
함께 읽어야 하는 원본 코드
첫 코드 조각만으로 동작이 완성되지 않는 경우 호출 매크로, 객체 정의와 실제 실행 목록을 같은 페이지에 묶었다. 각 조각은 같은 기준 commit에서 가져왔다.
01. 새 secure object와 backing file을 생성
core/tee/tee_svc_storage.c 297-413줄이다.
297 res = fops->create(o->pobj, overwrite, &head, sizeof(head), attr,
298 attr_size, NULL, data, len, &o->fh);
299
300 if (res)
301 o->ds_pos = 0;
302 else
303 o->info.dataSize = len;
304exit:
305 free(attr);
306 return res;
307}
308
309TEE_Result syscall_storage_obj_create(unsigned long storage_id, void *object_id,
310 size_t object_id_len, unsigned long flags,
311 unsigned long attr, void *data, size_t len,
312 uint32_t *obj)
313{
314 const unsigned long valid_flags = TEE_DATA_FLAG_ACCESS_READ |
315 TEE_DATA_FLAG_ACCESS_WRITE |
316 TEE_DATA_FLAG_ACCESS_WRITE_META |
317 TEE_DATA_FLAG_SHARE_READ |
318 TEE_DATA_FLAG_SHARE_WRITE |
319 TEE_DATA_FLAG_OVERWRITE;
320 const struct tee_file_operations *fops =
321 tee_svc_storage_file_ops(storage_id);
322 struct ts_session *sess = ts_get_current_session();
323 struct user_ta_ctx *utc = to_user_ta_ctx(sess->ctx);
324 struct tee_obj *attr_o = NULL;
325 TEE_Result res = TEE_SUCCESS;
326 struct tee_pobj *po = NULL;
327 struct tee_obj *o = NULL;
328 void *oid_bbuf = NULL;
329
330 if (flags & ~valid_flags)
331 return TEE_ERROR_BAD_PARAMETERS;
332
333 if (!fops)
334 return TEE_ERROR_ITEM_NOT_FOUND;
335
336 if (object_id_len > TEE_OBJECT_ID_MAX_LEN)
337 return TEE_ERROR_BAD_PARAMETERS;
338
339 object_id = memtag_strip_tag(object_id);
340 data = memtag_strip_tag(data);
341
342 /* Check presence of optional buffer */
343 if (len && !data)
344 return TEE_ERROR_BAD_PARAMETERS;
345
346 res = bb_memdup_user_private(object_id, object_id_len, &oid_bbuf);
347 if (res)
348 return res;
349
350 res = tee_pobj_get((void *)&sess->ctx->uuid, oid_bbuf,
351 object_id_len, flags, TEE_POBJ_USAGE_CREATE,
352 fops, &po);
353 bb_free(oid_bbuf, object_id_len);
354 if (res != TEE_SUCCESS)
355 goto err;
356
357 if (attr != TEE_HANDLE_NULL) {
358 res = tee_obj_get(utc, uref_to_vaddr(attr), &attr_o);
359 if (res != TEE_SUCCESS)
360 goto err;
361 /* The supplied handle must be one of an initialized object */
362 if (!(attr_o->info.handleFlags & TEE_HANDLE_FLAG_INITIALIZED)) {
363 res = TEE_ERROR_BAD_PARAMETERS;
364 goto err;
365 }
366 }
367
368 if (!obj && attr_o &&
369 !(attr_o->info.handleFlags & TEE_HANDLE_FLAG_PERSISTENT)) {
370 /*
371 * The caller expects the supplied attributes handle to be
372 * transformed into a persistent object.
373 *
374 * Persistent object keeps the objectUsage field in the
375 * pobj so move the field below.
376 */
377 uint32_t saved_flags = attr_o->info.handleFlags;
378
379 attr_o->info.handleFlags = TEE_HANDLE_FLAG_PERSISTENT |
380 TEE_HANDLE_FLAG_INITIALIZED | flags;
381 attr_o->pobj = po;
382 po->obj_info_usage = attr_o->info.objectUsage;
383 res = tee_svc_storage_init_file(attr_o,
384 flags & TEE_DATA_FLAG_OVERWRITE,
385 attr_o, data, len);
386 if (res) {
387 attr_o->info.handleFlags = saved_flags;
388 attr_o->pobj = NULL;
389 goto err;
390 }
391 attr_o->info.objectUsage = 0;
392 } else {
393 o = tee_obj_alloc();
394 if (!o) {
395 res = TEE_ERROR_OUT_OF_MEMORY;
396 goto err;
397 }
398
399 o->info.handleFlags = TEE_HANDLE_FLAG_PERSISTENT |
400 TEE_HANDLE_FLAG_INITIALIZED | flags;
401 o->pobj = po;
402
403 res = tee_svc_storage_init_file(o,
404 flags & TEE_DATA_FLAG_OVERWRITE,
405 attr_o, data, len);
406 if (res != TEE_SUCCESS)
407 goto err;
408
409 po = NULL; /* o owns it from now on */
410 tee_obj_add(utc, o);
411
412 if (obj) {
413 res = copy_kaddr_to_uref(obj, o);
02. persistent object header와 attribute를 검증해 읽는 함수
core/tee/tee_svc_storage.c 73-169줄이다.
73 return TEE_SUCCESS;
74}
75
76static void remove_corrupt_obj(struct user_ta_ctx *utc, struct tee_obj *o)
77{
78 o->pobj->fops->remove(o->pobj);
79 if (!(utc->ta_ctx.flags & TA_FLAG_DONT_CLOSE_HANDLE_ON_CORRUPT_OBJECT))
80 tee_obj_close(utc, o);
81}
82
83static TEE_Result tee_svc_storage_read_head(struct tee_obj *o)
84{
85 TEE_Result res = TEE_SUCCESS;
86 size_t bytes;
87 struct tee_svc_storage_head head;
88 const struct tee_file_operations *fops = o->pobj->fops;
89 void *attr = NULL;
90 size_t size;
91 size_t tmp = 0;
92
93 assert(!o->fh);
94 res = fops->open(o->pobj, &size, &o->fh);
95 if (res != TEE_SUCCESS)
96 goto exit;
97
98 /* read head */
99 bytes = sizeof(struct tee_svc_storage_head);
100 res = fops->read(o->fh, 0, &head, NULL, &bytes);
101 if (res != TEE_SUCCESS) {
102 if (res == TEE_ERROR_CORRUPT_OBJECT)
103 EMSG("Head corrupt");
104 goto exit;
105 }
106
107 if (ADD_OVERFLOW(sizeof(head), head.attr_size, &tmp)) {
108 res = TEE_ERROR_OVERFLOW;
109 goto exit;
110 }
111 if (tmp > size) {
112 res = TEE_ERROR_CORRUPT_OBJECT;
113 goto exit;
114 }
115
116 if (bytes != sizeof(struct tee_svc_storage_head)) {
117 res = TEE_ERROR_BAD_FORMAT;
118 goto exit;
119 }
120
121 res = tee_obj_set_type(o, head.objectType, head.maxObjectSize);
122 if (res != TEE_SUCCESS)
123 goto exit;
124
125 o->ds_pos = tmp;
126
127 if (head.attr_size) {
128 attr = malloc(head.attr_size);
129 if (!attr) {
130 res = TEE_ERROR_OUT_OF_MEMORY;
131 goto exit;
132 }
133
134 /* read meta */
135 bytes = head.attr_size;
136 res = fops->read(o->fh, sizeof(struct tee_svc_storage_head),
137 attr, NULL, &bytes);
138 if (res != TEE_SUCCESS)
139 goto exit;
140 if (bytes != head.attr_size) {
141 res = TEE_ERROR_CORRUPT_OBJECT;
142 goto exit;
143 }
144 }
145
146 res = tee_obj_attr_from_binary(o, attr, head.attr_size);
147 if (res != TEE_SUCCESS)
148 goto exit;
149
150 o->info.dataSize = size - sizeof(head) - head.attr_size;
151 o->info.objectSize = head.objectSize;
152 o->pobj->obj_info_usage = head.objectUsage;
153 o->info.objectType = head.objectType;
154 o->have_attrs = head.have_attrs;
155
156exit:
157 free(attr);
158
159 return res;
160}
161
162TEE_Result syscall_storage_obj_open(unsigned long storage_id, void *object_id,
163 size_t object_id_len, unsigned long flags,
164 uint32_t *obj)
165{
166 const unsigned long valid_flags = TEE_DATA_FLAG_ACCESS_READ |
167 TEE_DATA_FLAG_ACCESS_WRITE |
168 TEE_DATA_FLAG_ACCESS_WRITE_META |
169 TEE_DATA_FLAG_SHARE_READ |
DETAILSopen의 검사와 소유권 전달
| 순서 | 실제 동작 | 아직 보장되지 않는 것 |
|---|---|---|
| 1 | fops를 구한 뒤 flags → backend 지원 → ID 길이를 검사한다. | 파일 존재나 접근 공유 조건은 아직 검사하지 않았다. |
| 2 | bb_memdup_user_private()로 ID를 복사하고 TA UUID·ID·flags·fops로 tee_pobj_get()을 호출한다. | 임시 ID buffer는 호출 직후 해제한다. |
| 3 | tee_obj_alloc() 후 persistent/initialized flags와 pobj를 설정하고 내부 목록에 연결한다. | INITIALIZED 비트나 목록 등록만으로 header 검사 성공을 뜻하지 않는다. |
| 4 | tee_pobj_lock_usage() 동안 read_head()를 실행하고 성공·실패 모두 unlock한다. | backend open/read와 metadata 해석은 여기서 실패할 수 있다. |
| 5 | copy_kaddr_to_uref(obj, o) 성공 후 반환한다. | TA reference 복사 자체도 실패할 수 있고 이때 객체를 닫는다. |
IMPLEMENTATION NOTESheader 크기 검사와 오류 정리를 구별한다
read_head()는 backend open()으로 파일 크기와 o->fh를 얻고 fixed header를 읽는다. 소스 순서는 read 결과 검사 → sizeof(head) + head.attr_size 덧셈 overflow → 파일 크기 초과 → header 반환 byte 수 검사다. short read를 모든 header 필드 사용보다 먼저 검사한다고 설명하면 이 버전과 다르다.
객체 type 설정 후 o->ds_pos는 header와 attribute 영역 뒤를 가리킨다. attribute가 있으면 정확한 크기로 읽고 tee_obj_attr_from_binary()로 해석한다. 성공 때만 dataSize·objectSize·usage·type·have_attrs를 갱신하며 임시 attribute buffer는 공통 exit에서 해제한다.
open에서 일반 읽기 오류와 reference 복사 오류는 oclose로 가서 객체를 닫고 o = NULL로 만든다. 반면 read_head가 직접 TEE_ERROR_CORRUPT_OBJECT를 반환하면 err로 가서 remove_corrupt_obj()를 부른다. 따라서 모든 실패가 동일한 close/remove 순서를 거치는 것은 아니다.
DEEP ANALYSIS손상 오류, backend, create를 분리해서 읽는다
fops 선택storage_id에서 backend ops 포인터를 얻는다.
허용 비트 밖이면 BAD_PARAMETERS.
fops 검사지원하지 않는 ID면 ITEM_NOT_FOUND.
최대 길이를 확인하고 user ID를 secure buffer로 복사한다.
tee_pobj_get()TA UUID, ID, flags, fops를 사용해 po를 얻는다.
화살표는 이 함수의 검사·호출 순서다. fops 포인터는 flags 검사보다 먼저 계산되지만, 지원 여부는 flags 검사 뒤에 판정한다.
| 입력 또는 실패 | 반환·정리 | 주의 |
|---|---|---|
| 허용되지 않은 flags / 긴 ID | BAD_PARAMETERS | 객체 생성 전 |
| backend 미지원 | ITEM_NOT_FOUND | 파일 부재와 같은 코드일 수 있으므로 실패 위치도 기록 |
| tee_obj_alloc 실패 | po release 후 OUT_OF_MEMORY | 아직 내부 목록에 연결되지 않음 |
| header 합산 overflow | OVERFLOW; oclose | 이 syscall이 모든 산술 오류를 CORRUPT로 바꾸지 않음 |
| read_head의 NO_DATA/BAD_FORMAT | oclose 후 CORRUPT_OBJECT로 정규화 | o는 NULL이므로 뒤의 remove_corrupt_obj 조건은 실행되지 않음 |
| read_head의 CORRUPT_OBJECT | remove_corrupt_obj에서 backend remove 요청 | remove 반환값은 검사하지 않으며, TA_FLAG_DONT_CLOSE_HANDLE_ON_CORRUPT_OBJECT가 있으면 여기서 close하지 않음 |
| reference 복사 실패 | oclose 후 오류 반환 | TA에 정상 핸들이 공개되지 않음 |
암호화, hash tree, RPMB counter, rollback 방지는 fops->open/read/create/remove 뒤의 backend 계약이다. 이 공통 함수만으로 REE와 RPMB의 보장 수준이 같다고 결론내릴 수 없다. 이 글에서는 확인하지 않은 설정명이나 전원 차단 성공을 보장하지 않는다.
create는 open과 다르다. 새 객체 경로에서는 tee_svc_storage_init_file() 성공 후 내부 목록에 연결한다. obj == NULL이고 attr가 transient object이면 기존 attr 객체를 persistent로 바꾸는 별도 분기를 사용하며, 초기화 실패 시 저장한 flags와 pobj를 복구한다. 새 객체 성공 경로의 tee_pobj_create_final()과 선택적 close는 L418–421에 있어 기존 발췌 밖이다.
OBJECT LIFETIME객체별 수명
| 대상 | 생성·확보 | 종료 또는 공개 |
|---|---|---|
| fops | storage_id로 선택 | backend callback table; 이번 syscall의 임시 buffer가 아님 |
| oid_bbuf | user-private ID 복사 | tee_pobj_get 직후 bb_free |
| po | UUID·ID·flags·fops로 확보 | open의 o에 연결하거나 할당 실패 시 release |
| tee_obj | alloc 후 내부 목록 등록 | 일반 실패는 close; 직접 CORRUPT 오류는 remove와 조건부 close |
| o->fh | read_head의 fops->open | backend handle; read 실패도 정리 경로를 추적해야 함 |
| attr 임시 buffer | head.attr_size가 있을 때 malloc | read_head 공통 exit에서 free |
| TA reference | copy_kaddr_to_uref 성공 | 내부 포인터와 구분; 이후 TA의 정상 close/오류 정책에 따름 |
FAILURE PATH오류 코드만으로 원인을 합치지 않는다
동일한 CORRUPT_OBJECT라도 backend가 직접 반환했는지, short header의 BAD_FORMAT이 뒤에서 변환됐는지에 따라 정리 경로가 다르다. 반환 코드와 함께 실패한 호출, o 존재 여부, remove 요청, TA close-on-corrupt flag를 구분한다.
저장장치 실패를 항상 panic으로 설명하지 않는다. 이 syscall의 주된 결과는 TEE_Result 반환이며, backend 내부 panic 여부나 원자성·복구 성질은 별도 구현의 증거가 필요하다.
EVIDENCE소스 검토와 실측을 구분한다
고정 소스와 문서만 대조했으며 OP-TEE 빌드, 저장장치 쓰기, 키 provisioning, 파일 변조, 전원 차단 실험은 실행하지 않았다. 이미 존재하는 동일 빌드의 자료로 아래 항목을 대조할 수 있다.
| 자료 | 읽기 예시 또는 기록값 | 한계 |
|---|---|---|
| ELF symbol | nm -an out/arm/core/tee.elf | grep -E ' (syscall_storage_obj_open|tee_svc_storage_read_head)$' | C 선언문이 아니라 실제 symbol 이름; 최적화에 따라 일부 없음 |
| ELF/설정 | readelf -W -lS out/arm/core/tee.elf 및 동일 빌드 설정 | runtime backend 동작 자체를 증명하지 않음 |
| 기존 secure trace | flags, storage_id, ID 길이, 호출별 결과와 close/remove 여부 | object ID·UUID·secure 주소 원문은 공개 로그에 노출하지 않음 |
| 기존 backend 시험 결과 | 사용 backend/장치/실패 주입 조건/재시작 뒤 결과 | open 함수 검토와 내구성 시험 결과를 합쳐 완료라고 하지 않음 |
LAB격리된 시험 환경에서 비교할 경계
별도 시험이 허용된 환경에서 invalid flags, unsupported ID, header short read, attribute short read, reference 복사 실패를 각각 구분한다. tee_obj_add() 이전·이후, close/remove 호출, 최종 TA reference 유무를 같은 기준으로 기록한다.
손상 객체 flag를 켠 경우와 끈 경우를 비교하고, open과 create의 성공·실패를 섞지 않는다. 운영 저장소 변조나 장치 reset은 이 문서 검토의 일부가 아니다.
PRIMARY REFERENCES