Linux kernel userspace API 안내서 | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

index.rst:1-76

Kernel tree가 제공하는 syscall, 보안, device I/O 및 기타 userspace API 문서의 상위 색인입니다.

원문의 경로, 함수명, symbol, 문서 링크, 표와 줄 좌표를 보존해 전문 번역했습니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 =====================================

2 The Linux kernel user-space API guide

3 =====================================

5 .. _man-pages: https://www.kernel.org/doc/man-pages/

7 While much of the kernel's user-space API is documented elsewhere

8 (particularly in the man-pages_ project), some user-space information can

9 also be found in the kernel tree itself. This manual is intended to be the

10 place where this information is gathered.

13 System calls

14 ============

16 .. toctree::

17 :maxdepth: 1

19 unshare

20 futex2

21 ebpf/index

22 ioctl/index

23 mseal

25 Security-related interfaces

26 ===========================

28 .. toctree::

29 :maxdepth: 1

31 no_new_privs

32 seccomp_filter

33 landlock

34 lsm

35 mfd_noexec

36 spec_ctrl

37 tee

38 check_exec

40 Devices and I/O

41 ===============

43 .. toctree::

44 :maxdepth: 1

46 accelerators/ocxl

47 dma-buf-heaps

48 dma-buf-alloc-exchange

49 fwctl/index

50 gpio/index

51 iommufd

52 media/index

53 dcdbas

54 vduse

55 isapnp

57 Everything else

58 ===============

60 .. toctree::

61 :maxdepth: 1

63 ELF

64 netlink/index

65 sysfs-platform_profile

66 vduse

67 futex2

68 perf_ring_buffer

69 ntsync

71 .. only:: subproject and html

73 Indices

74 =======

76 * :ref:`genindex`

3. 한국어 전문 번역

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

안내서의 범위

1-10

Kernel userspace API의 많은 부분은 특히 kernel.org의 `man-pages` 프로젝트에 문서화되어 있습니다. 이 안내서는 kernel source tree 안에 있는 userspace 관련 정보를 한곳에 모으는 진입점입니다.

따라서 이 페이지는 모든 syscall의 독립 명세가 아니라, kernel tree가 직접 유지하는 보충 설명과 subsystem별 ABI 문서의 탐색 구조를 제공합니다.

Userspace API 문서 출처

항목설명

man-pages일반 syscall과 libc 사용자 관점의 주된 설명

Kernel tree guideKernel과 함께 유지되는 subsystem·ABI 보충 문서

두 문서 집합의 역할이 서로 보완적입니다.

=====================================
The Linux kernel user-space API guide
=====================================

.. _man-pages: https://www.kernel.org/doc/man-pages/

While much of the kernel's user-space API is documented elsewhere
(particularly in the man-pages_ project), some user-space information can
also be found in the kernel tree itself.  This manual is intended to be the
place where this information is gathered.

System call 문서

11-24

System calls 절은 `unshare`, `futex2`, `ebpf/index`, `ioctl/index`, `mseal` 문서로 연결됩니다. 각 항목은 syscall 자체 또는 해당 userspace 제어 계층의 세부 ABI를 다룹니다.

System call 관련 항목

항목설명

unshare실행 context 분리

futex2새 futex userspace API

ebpf/indexeBPF userspace API

ioctl/indexioctl 규약과 문서

msealMemory sealing API

상위 색인에서 syscall 계열 문서로 이동합니다.



System calls
============

.. toctree::
   :maxdepth: 1

   unshare
   futex2
   ebpf/index
   ioctl/index
   mseal

보안 관련 인터페이스

25-39

Security-related interfaces 절은 privilege 제한, syscall filtering, sandboxing, LSM, executable 정책, speculation 제어, trusted execution과 실행 검사 문서를 묶습니다.

보안 관련 userspace API

항목설명

no_new_privs새 privilege 획득 차단

seccomp_filterSyscall filtering

landlock비특권 sandboxing

lsmLinux Security Module userspace ABI

mfd_noexecmemfd 실행 정책

spec_ctrlSpeculation control

teeTrusted Execution Environment

check_exec실행 검사 인터페이스

보안 경계와 실행 정책별 문서입니다.

Security-related interfaces
===========================

.. toctree::
   :maxdepth: 1

   no_new_privs
   seccomp_filter
   landlock
   lsm
   mfd_noexec
   spec_ctrl
   tee
   check_exec

Device와 I/O 인터페이스

40-56

Devices and I/O 절은 accelerator, DMA buffer, firmware control, GPIO, IOMMU file descriptor, media, Dell SMI, VDUSE와 ISA PnP userspace API를 연결합니다.

Device와 I/O 문서

항목설명

accelerators/ocxlOpenCAPI accelerator

dma-buf-heapsDMA-BUF heap

dma-buf-alloc-exchangeDMA-BUF allocation exchange

fwctl/indexFirmware control

gpio/indexGPIO character device와 레거시 API

iommufdIOMMU userspace control

media/indexMedia userspace API

dcdbasDell Systems Management Base

vduseVDPA userspace device

isapnpISA Plug and Play

장치 종류와 I/O 자원 관리별 진입점입니다.

Devices and I/O
===============

.. toctree::
   :maxdepth: 1

   accelerators/ocxl
   dma-buf-heaps
   dma-buf-alloc-exchange
   fwctl/index
   gpio/index
   iommufd
   media/index
   dcdbas
   vduse
   isapnp

기타 인터페이스와 HTML 색인

57-76

Everything else 절에는 `ELF`, netlink, platform profile, VDUSE, futex2, perf ring buffer와 NT synchronization primitive 문서가 있습니다. 일부 항목은 다른 분류에도 나타나며 이는 동일 문서로 가는 탐색 링크입니다.

Subproject HTML 빌드에서는 Sphinx의 일반 색인 `genindex`도 제공합니다. 이 링크는 생성된 문서 탐색 기능이며 kernel ABI 항목은 아닙니다.

기타 userspace API

항목설명

ELFExecutable and Linkable Format

netlink/indexNetlink userspace API

sysfs-platform_profilePlatform profile sysfs ABI

vduseUserspace vDPA device

futex2새 futex API

perf_ring_bufferPerf event ring buffer

ntsyncNT synchronization primitives

genindexSphinx 일반 색인

상위 세 분류에 맞지 않는 ABI와 형식을 모읍니다.

Everything else
===============

.. toctree::
   :maxdepth: 1

   ELF
   netlink/index
   sysfs-platform_profile
   vduse
   futex2
   perf_ring_buffer
   ntsync

.. only::  subproject and html

   Indices
   =======

   * :ref:`genindex`