Documentation/driver-api/surface_aggregator/internal-api.rst GitHub 원문 ↗

Linux 6.18.37 · Driver API

Surface Aggregator Internal API

Surface Aggregator packet·request transport, controller, client bus, core, trace helper의 internal kernel-doc source를 연결하는 색인 전문 번역입니다.

Source pathDocumentation/driver-api/surface_aggregator/internal-api.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

internal-api.rst:1-67

이 페이지는 Surface Aggregator 내부 구현의 packet parser·buffer·transport, request layer, controller, client bus, core, trace helper API를 각 source의 kernel-doc에서 조립합니다.

문서 구성
원문 줄내용
1-10문서 머리말과 목차
11-29Packet Transport Layer
30-39Request Transport Layer
40-56Controller와 Client Device Bus
57-67Core와 Trace Helpers

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0+
2
3 ==========================
4 Internal API Documentation
5 ==========================
6
7 .. contents::
8 :depth: 2
9
10
11 Packet Transport Layer
12 ======================
13
14 .. kernel-doc:: drivers/platform/surface/aggregator/ssh_parser.h
15 :internal:
16
17 .. kernel-doc:: drivers/platform/surface/aggregator/ssh_parser.c
18 :internal:
19
20 .. kernel-doc:: drivers/platform/surface/aggregator/ssh_msgb.h
21 :internal:
22
23 .. kernel-doc:: drivers/platform/surface/aggregator/ssh_packet_layer.h
24 :internal:
25
26 .. kernel-doc:: drivers/platform/surface/aggregator/ssh_packet_layer.c
27 :internal:
28
29
30 Request Transport Layer
31 =======================
32
33 .. kernel-doc:: drivers/platform/surface/aggregator/ssh_request_layer.h
34 :internal:
35
36 .. kernel-doc:: drivers/platform/surface/aggregator/ssh_request_layer.c
37 :internal:
38
39
40 Controller
41 ==========
42
43 .. kernel-doc:: drivers/platform/surface/aggregator/controller.h
44 :internal:
45
46 .. kernel-doc:: drivers/platform/surface/aggregator/controller.c
47 :internal:
48
49
50 Client Device Bus
51 =================
52
53 .. kernel-doc:: drivers/platform/surface/aggregator/bus.c
54 :internal:
55
56
57 Core
58 ====
59
60 .. kernel-doc:: drivers/platform/surface/aggregator/core.c
61 :internal:
62
63
64 Trace Helpers
65 =============
66
67 .. kernel-doc:: drivers/platform/surface/aggregator/trace.h
68

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

Internal API 문서 머리말

1-10

이 페이지는 `GPL-2.0+` SPDX license를 사용하는 Surface Aggregator internal API 문서입니다.

`contents` 지시문은 절 목차를 두 단계 깊이까지 구성합니다.

문서 머리말
항목값
TitleInternal API Documentation
Contents depth2
LicenseGPL-2.0+

.. SPDX-License-Identifier: GPL-2.0+

==========================
Internal API Documentation
==========================

.. contents::
    :depth: 2

Packet Transport Layer

11-29

Packet Transport Layer 영역은 SSH parser, message buffer, packet layer의 header와 implementation에서 internal kernel-doc을 추출합니다.

Packet transport kernel-doc 입력
Source path범위
drivers/platform/surface/aggregator/ssh_parser.h:internal:
drivers/platform/surface/aggregator/ssh_parser.c:internal:
drivers/platform/surface/aggregator/ssh_msgb.h:internal:
drivers/platform/surface/aggregator/ssh_packet_layer.h:internal:
drivers/platform/surface/aggregator/ssh_packet_layer.c:internal:

Packet Transport Layer
======================

.. kernel-doc:: drivers/platform/surface/aggregator/ssh_parser.h
    :internal:

.. kernel-doc:: drivers/platform/surface/aggregator/ssh_parser.c
    :internal:

.. kernel-doc:: drivers/platform/surface/aggregator/ssh_msgb.h
    :internal:

.. kernel-doc:: drivers/platform/surface/aggregator/ssh_packet_layer.h
    :internal:

.. kernel-doc:: drivers/platform/surface/aggregator/ssh_packet_layer.c
    :internal:

Request Transport Layer

30-39

Request Transport Layer 영역은 SSH request layer의 header와 implementation에 있는 internal API를 포함합니다.

Request transport kernel-doc 입력
Source path범위
drivers/platform/surface/aggregator/ssh_request_layer.h:internal:
drivers/platform/surface/aggregator/ssh_request_layer.c:internal:

Request Transport Layer
=======================

.. kernel-doc:: drivers/platform/surface/aggregator/ssh_request_layer.h
    :internal:

.. kernel-doc:: drivers/platform/surface/aggregator/ssh_request_layer.c
    :internal:

Controller internal API

40-49

Controller 영역은 Surface Aggregator controller header와 implementation의 internal kernel-doc을 포함합니다.

Controller kernel-doc 입력
Source path범위
drivers/platform/surface/aggregator/controller.h:internal:
drivers/platform/surface/aggregator/controller.c:internal:

Controller
==========

.. kernel-doc:: drivers/platform/surface/aggregator/controller.h
    :internal:

.. kernel-doc:: drivers/platform/surface/aggregator/controller.c
    :internal:

Client Device Bus internal API

50-56

Client Device Bus 영역은 `drivers/platform/surface/aggregator/bus.c`의 internal API를 추출합니다.

Client bus kernel-doc 입력
Source path범위
drivers/platform/surface/aggregator/bus.c:internal:

Client Device Bus
=================

.. kernel-doc:: drivers/platform/surface/aggregator/bus.c
    :internal:

Core internal API

57-63

Core 영역은 `drivers/platform/surface/aggregator/core.c`의 internal API를 추출합니다.

Core kernel-doc 입력
Source path범위
drivers/platform/surface/aggregator/core.c:internal:

Core
====

.. kernel-doc:: drivers/platform/surface/aggregator/core.c
    :internal:

Trace helper API

64-67

Trace Helpers 영역은 `drivers/platform/surface/aggregator/trace.h`의 kernel-doc을 포함합니다.

Trace kernel-doc 입력
Source path범위
drivers/platform/surface/aggregator/trace.hTrace helpers

Trace Helpers
=============

.. kernel-doc:: drivers/platform/surface/aggregator/trace.h