요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
=================================
target and iSCSI Interfaces Guide
=================================
Introduction and Overview
=========================
TBD
Target core device interfaces
=============================
This section is blank because no kerneldoc comments have been added to
drivers/target/target_core_device.c.
Target core transport interfaces
================================
.. kernel-doc:: drivers/target/target_core_transport.c
:export:
Target-supported userspace I/O
==============================
.. kernel-doc:: drivers/target/target_core_user.c
:doc: Userspace I/O
.. kernel-doc:: include/uapi/linux/target_core_user.h
:doc: Ring Design
iSCSI helper functions
======================
.. kernel-doc:: drivers/scsi/libiscsi.c
:export:
iSCSI boot information
======================
.. kernel-doc:: drivers/scsi/iscsi_boot_sysfs.c
:export:
iSCSI TCP interfaces
====================
.. kernel-doc:: drivers/scsi/iscsi_tcp.c
:internal:
.. kernel-doc:: drivers/scsi/libiscsi_tcp.c
:export:
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Target와 iSCSI interface guide 개요
1-9이 문서는 Linux target core와 iSCSI interface를 안내합니다.
Introduction and Overview 절의 본문은 현재 `TBD`로 남아 있어 아직 작성되지 않았습니다.
=================================
target and iSCSI Interfaces Guide
=================================
Introduction and Overview
=========================
TBD
Target core device interface
10-15이 절은 `drivers/target/target_core_device.c`에 kernel-doc comment가 추가되지 않았기 때문에 비어 있습니다.
Target core device interfaces
=============================
This section is blank because no kerneldoc comments have been added to
drivers/target/target_core_device.c.
Target core transport interface
16-21Target core transport interface 문서는 `drivers/target/target_core_transport.c`의 exported kernel-doc API에서 생성합니다.
Target core transport interfaces
================================
.. kernel-doc:: drivers/target/target_core_transport.c
:export:
Target-supported userspace I/O
22-30Target가 지원하는 userspace I/O 설명은 두 kernel-doc source에서 조립합니다.
`drivers/target/target_core_user.c`에서는 `Userspace I/O` 문서 block을, UAPI header `include/uapi/linux/target_core_user.h`에서는 `Ring Design` 문서 block을 포함합니다.
Target-supported userspace I/O
==============================
.. kernel-doc:: drivers/target/target_core_user.c
:doc: Userspace I/O
.. kernel-doc:: include/uapi/linux/target_core_user.h
:doc: Ring Design
iSCSI helper function
31-37iSCSI helper function 절은 `drivers/scsi/libiscsi.c`에 정의된 exported kernel-doc API를 포함합니다.
iSCSI helper functions
======================
.. kernel-doc:: drivers/scsi/libiscsi.c
:export:
iSCSI boot information
38-43iSCSI boot information 절은 `drivers/scsi/iscsi_boot_sysfs.c`의 exported kernel-doc API를 포함합니다.
iSCSI boot information
======================
.. kernel-doc:: drivers/scsi/iscsi_boot_sysfs.c
:export:
iSCSI TCP interface
44-52iSCSI TCP interface 절은 `drivers/scsi/iscsi_tcp.c`의 internal kernel-doc와 `drivers/scsi/libiscsi_tcp.c`의 exported kernel-doc를 함께 포함합니다.
iSCSI TCP interfaces
====================
.. kernel-doc:: drivers/scsi/iscsi_tcp.c
:internal:
.. kernel-doc:: drivers/scsi/libiscsi_tcp.c
:export:
요약과 해설
target.rst:1-52이 문서는 target core와 iSCSI의 구현 source에서 kernel-doc를 조립하는 index입니다. Overview와 device interface는 아직 미작성 상태이며, transport·userspace ring·iSCSI helper·boot sysfs·TCP API source와 공개 범위를 명시합니다.