요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: (LGPL-2.1 OR BSD-2-Clause)
.. _libbpf:
======
libbpf
======
If you are looking to develop BPF applications using the libbpf library, this
directory contains important documentation that you should read.
To get started, it is recommended to begin with the :doc:`libbpf Overview
<libbpf_overview>` document, which provides a high-level understanding of the
libbpf APIs and their usage. This will give you a solid foundation to start
exploring and utilizing the various features of libbpf to develop your BPF
applications.
.. toctree::
:maxdepth: 1
libbpf_overview
API Documentation <https://libbpf.readthedocs.io/en/latest/api.html>
program_types
libbpf_naming_convention
libbpf_build
All general BPF questions, including kernel functionality, libbpf APIs and their
application, should be sent to bpf@vger.kernel.org mailing list. You can
`subscribe <http://vger.kernel.org/vger-lists.html#bpf>`_ to the mailing list
search its `archive <https://lore.kernel.org/bpf/>`_. Please search the archive
before asking new questions. It may be that this was already addressed or
answered before.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
libbpf 문서 시작점
1-17이 문서는 `(LGPL-2.1 OR BSD-2-Clause)` license를 따르며 `libbpf` anchor에서 libbpf documentation을 소개합니다.
Libbpf library로 BPF application을 개발하려는 독자가 읽어야 할 중요 documentation을 이 directory에 모아 두었습니다.
시작할 때는 libbpf API와 사용법을 high-level로 설명하는 `libbpf Overview <libbpf_overview>` 문서를 먼저 읽는 것이 좋습니다. 이 문서는 libbpf의 여러 feature를 탐색하고 활용해 BPF application을 개발할 탄탄한 기초를 제공합니다.
libbpf 문서 목차
18-26다음 항목을 max depth 1의 toctree로 구성합니다.
- `libbpf_overview`
- [`API Documentation`](https://libbpf.readthedocs.io/en/latest/api.html)
- `program_types`
- `libbpf_naming_convention`
- `libbpf_build`
BPF mailing list와 archive
27-33Kernel functionality, libbpf API와 그 적용을 포함한 모든 일반 BPF 질문은 `bpf@vger.kernel.org` mailing list로 보내야 합니다.
Mailing list는 [subscription page](http://vger.kernel.org/vger-lists.html#bpf)에서 구독할 수 있고 [archive](https://lore.kernel.org/bpf/)를 검색할 수 있습니다. 새 질문을 올리기 전에 archive를 먼저 검색해야 합니다. 같은 내용이 이미 논의되거나 답변됐을 수 있습니다.
요약과 해설
index.rst:1-33Libbpf 기반 BPF application 개발자는 먼저 `libbpf_overview`에서 API의 전체 구조와 사용법을 익힌 뒤 program type, naming convention, build 문서와 API reference로 확장할 수 있습니다.
일반 BPF 질문은 `bpf@vger.kernel.org`에서 논의합니다. 중복 질문을 피하려면 먼저 lore.kernel.org의 BPF archive를 검색하는 것이 원문이 권장하는 순서입니다.