← Documents Documentation/core-api/index.rst GitHub 원문 ↗

Linux 6.18.37 · Core API

Core API Documentation

Linux 핵심 API 문서를 유틸리티, 자료구조, 동시성, 하드웨어, 메모리 관리, 디버깅 등의 주제별로 안내하는 최상위 색인입니다.

Source pathDocumentation/core-api/index.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약과 해설

index.rst:1-148

이 페이지는 핵심 커널 API 문서의 목차입니다. 일반 유틸리티와 자료구조에서 시작해 저수준 진입 경로, 동시성, 하드웨어 관리, 메모리 관리, 디버깅 인터페이스로 탐색할 수 있습니다.

각 `toctree` 항목은 해당 주제의 상세 문서로 연결됩니다. 동시성의 더 넓은 범위는 `Documentation/locking/index.rst`, 메모리 관리의 더 넓은 범위는 `Documentation/mm/index.rst`에서 이어집니다.

마지막 절은 아직 별도 범주로 정리되지 않은 문서와 HTML 빌드에서 제공하는 전체 색인을 포함합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 ======================
2 Core API Documentation
3 ======================
4
5 This is the beginning of a manual for core kernel APIs. The conversion
6 (and writing!) of documents for this manual is much appreciated!
7
8 Core utilities
9 ==============
10
11 This section has general and "core core" documentation. The first is a
12 massive grab-bag of kerneldoc info left over from the docbook days; it
13 should really be broken up someday when somebody finds the energy to do
14 it.
15
16 .. toctree::
17 :maxdepth: 1
18
19 kernel-api
20 workqueue
21 watch_queue
22 printk-basics
23 printk-formats
24 printk-index
25 symbol-namespaces
26 asm-annotations
27 real-time/index
28
29 Data structures and low-level utilities
30 =======================================
31
32 Library functionality that is used throughout the kernel.
33
34 .. toctree::
35 :maxdepth: 1
36
37 kobject
38 kref
39 cleanup
40 assoc_array
41 folio_queue
42 xarray
43 maple_tree
44 idr
45 circular-buffers
46 rbtree
47 generic-radix-tree
48 packing
49 this_cpu_ops
50 timekeeping
51 errseq
52 wrappers/atomic_t
53 wrappers/atomic_bitops
54 floating-point
55 union_find
56 min_heap
57 parser
58 list
59
60 Low level entry and exit
61 ========================
62
63 .. toctree::
64 :maxdepth: 1
65
66 entry
67
68 Concurrency primitives
69 ======================
70
71 How Linux keeps everything from happening at the same time. See
72 Documentation/locking/index.rst for more related documentation.
73
74 .. toctree::
75 :maxdepth: 1
76
77 refcount-vs-atomic
78 irq/index
79 local_ops
80 padata
81 ../RCU/index
82 wrappers/memory-barriers.rst
83
84 Low-level hardware management
85 =============================
86
87 Cache management, managing CPU hotplug, etc.
88
89 .. toctree::
90 :maxdepth: 1
91
92 cachetlb
93 cpu_hotplug
94 memory-hotplug
95 genericirq
96 protection-keys
97
98 Memory management
99 =================
100
101 How to allocate and use memory in the kernel. Note that there is a lot
102 more memory-management documentation in Documentation/mm/index.rst.
103
104 .. toctree::
105 :maxdepth: 1
106
107 memory-allocation
108 unaligned-memory-access
109 dma-api
110 dma-api-howto
111 dma-attributes
112 dma-isa-lpc
113 swiotlb
114 mm-api
115 cgroup
116 genalloc
117 pin_user_pages
118 boot-time-mm
119 gfp_mask-from-fs-io
120 kho/index
121
122 Interfaces for kernel debugging
123 ===============================
124
125 .. toctree::
126 :maxdepth: 1
127
128 debug-objects
129 tracepoint
130 debugging-via-ohci1394
131
132 Everything else
133 ===============
134
135 Documents that don't fit elsewhere or which have yet to be categorized.
136
137 .. toctree::
138 :maxdepth: 1
139
140 librs
141 netlink
142
143 .. only:: subproject and html
144
145 Indices
146 =======
147
148 * :ref:`genindex`
149

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Core API 문서 소개

1-7

Core API 문서 (Core API Documentation)

이 문서는 핵심 커널 API 설명서의 시작점입니다. 이 설명서에 포함할 문서를 변환하고 새로 작성하는 기여를 적극 환영합니다.

핵심 유틸리티

8-28

이 절에는 일반적인 핵심 문서와 이른바 "핵심 중의 핵심" 문서가 있습니다. 첫 항목은 DocBook 시절부터 남은 방대한 kernel-doc 정보를 한데 모은 것으로, 여력이 생기면 언젠가 주제별로 나누는 것이 바람직합니다.

.. toctree::
   :maxdepth: 1

   kernel-api
   workqueue
   watch_queue
   printk-basics
   printk-formats
   printk-index
   symbol-namespaces
   asm-annotations
   real-time/index

자료구조와 저수준 유틸리티

29-59

커널 전반에서 사용하는 라이브러리 기능을 다룹니다.

.. toctree::
   :maxdepth: 1

   kobject
   kref
   cleanup
   assoc_array
   folio_queue
   xarray
   maple_tree
   idr
   circular-buffers
   rbtree
   generic-radix-tree
   packing
   this_cpu_ops
   timekeeping
   errseq
   wrappers/atomic_t
   wrappers/atomic_bitops
   floating-point
   union_find
   min_heap
   parser
   list

저수준 진입과 종료

60-67

커널의 저수준 진입 및 종료 경로 문서로 연결합니다.

.. toctree::
   :maxdepth: 1

   entry

동시성 기본 요소

68-83

Linux가 모든 작업을 동시에 실행하지 않도록 조정하는 방법을 다룹니다. 관련 문서는 `Documentation/locking/index.rst`에도 더 있습니다.

.. toctree::
   :maxdepth: 1

   refcount-vs-atomic
   irq/index
   local_ops
   padata
   ../RCU/index
   wrappers/memory-barriers.rst

저수준 하드웨어 관리

84-97

캐시 관리와 CPU hotplug 관리 등을 다룹니다.

.. toctree::
   :maxdepth: 1

   cachetlb
   cpu_hotplug
   memory-hotplug
   genericirq
   protection-keys

메모리 관리

98-121

커널에서 메모리를 할당하고 사용하는 방법을 다룹니다. 메모리 관리에 관한 문서는 `Documentation/mm/index.rst`에도 많이 있습니다.

.. toctree::
   :maxdepth: 1

   memory-allocation
   unaligned-memory-access
   dma-api
   dma-api-howto
   dma-attributes
   dma-isa-lpc
   swiotlb
   mm-api
   cgroup
   genalloc
   pin_user_pages
   boot-time-mm
   gfp_mask-from-fs-io
   kho/index

커널 디버깅 인터페이스

122-131

커널 디버깅에 사용하는 핵심 인터페이스 문서로 연결합니다.

.. toctree::
   :maxdepth: 1

   debug-objects
   tracepoint
   debugging-via-ohci1394

그 밖의 문서와 색인

132-148

다른 범주에 맞지 않거나 아직 분류되지 않은 문서를 모았습니다.

.. toctree::
   :maxdepth: 1

   librs
   netlink
.. only:: subproject and html

   Indices
   =======

   * :ref:`genindex`