← Documents Documentation/rust/index.rst GitHub 원문 ↗

Linux 6.18.37 · Rust

Rust 문서 색인

Rust 지원의 실험적 범위와 설치, 코딩 지침, 아키텍처 및 시험 문서의 읽기 순서를 안내합니다.

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

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

1. 요약·해설

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

요약·해설

index.rst:1-67

Rust 지원의 실험적 범위와 설치, 코딩 지침, 아키텍처 및 시험 문서의 읽기 순서를 안내합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0
2
3 Rust
4 ====
5
6 Documentation related to Rust within the kernel. To start using Rust
7 in the kernel, please read the quick-start.rst guide.
8
9
10 The Rust experiment
11 -------------------
12
13 The Rust support was merged in v6.1 into mainline in order to help in
14 determining whether Rust as a language was suitable for the kernel, i.e. worth
15 the tradeoffs.
16
17 Currently, the Rust support is primarily intended for kernel developers and
18 maintainers interested in the Rust support, so that they can start working on
19 abstractions and drivers, as well as helping the development of infrastructure
20 and tools.
21
22 If you are an end user, please note that there are currently no in-tree
23 drivers/modules suitable or intended for production use, and that the Rust
24 support is still in development/experimental, especially for certain kernel
25 configurations.
26
27
28 Code documentation
29 ------------------
30
31 Given a kernel configuration, the kernel may generate Rust code documentation,
32 i.e. HTML rendered by the ``rustdoc`` tool.
33
34 .. only:: rustdoc and html
35
36 This kernel documentation was built with `Rust code documentation
37 <rustdoc/kernel/index.html>`_.
38
39 .. only:: not rustdoc and html
40
41 This kernel documentation was not built with Rust code documentation.
42
43 A pregenerated version is provided at:
44
45 https://rust.docs.kernel.org
46
47 Please see the :ref:`Code documentation <rust_code_documentation>` section for
48 more details.
49
50 .. toctree::
51 :maxdepth: 1
52
53 quick-start
54 general-information
55 coding-guidelines
56 arch-support
57 testing
58
59 You can also find learning materials for Rust in its section in
60 :doc:`../process/kernel-docs`.
61
62 .. only:: subproject and html
63
64 Indices
65 =======
66
67 * :ref:`genindex`
68

3. 한국어 전문 번역

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

Rust 실험의 목적과 대상

1-27

이 페이지는 커널 안의 Rust 관련 문서를 모은 색인이다. 실제 사용을 시작하려면 먼저 `quick-start.rst`를 읽는다.

Rust 지원은 언어로서 Rust가 커널에 적합한지, 그 장단점과 비용을 감수할 가치가 있는지 판단하기 위해 v6.1에서 mainline에 병합되었다.

현재 주 대상은 Rust 지원에 관심 있는 커널 개발자와 유지관리자다. 이들은 추상화와 driver를 만들고 infrastructure와 tool 개발을 돕는다. End user 관점에서는 아직 production 용도에 적합하거나 그렇게 의도된 in-tree Rust driver/module이 없고, 일부 커널 구성에서는 특히 실험·개발 단계임을 유의해야 한다.

Rust 지원의 현재 단계
v6.1 mainline 병합언어 적합성과 tradeoff 평가추상화와 infrastructure 개발Driver와 도구 실험Production 적합성은 아직 아님

평가 목적의 병합에서 안전한 커널 구성요소와 도구 생태계를 확장하는 단계입니다.

.. SPDX-License-Identifier: GPL-2.0

Rust
====

Documentation related to Rust within the kernel. To start using Rust
in the kernel, please read the quick-start.rst guide.


The Rust experiment
-------------------

The Rust support was merged in v6.1 into mainline in order to help in
determining whether Rust as a language was suitable for the kernel, i.e. worth
the tradeoffs.

Currently, the Rust support is primarily intended for kernel developers and
maintainers interested in the Rust support, so that they can start working on
abstractions and drivers, as well as helping the development of infrastructure
and tools.

If you are an end user, please note that there are currently no in-tree
drivers/modules suitable or intended for production use, and that the Rust
support is still in development/experimental, especially for certain kernel
configurations.

코드 문서와 안내서 목록

28-67

커널은 주어진 configuration에 맞춰 `rustdoc` HTML 코드 문서를 생성할 수 있다. 현재 문서 빌드에 Rust 문서가 통합되었는지는 Sphinx의 `rustdoc and html` 조건에 따라 링크 또는 미포함 안내로 표시된다.

미리 생성한 문서는 `https://rust.docs.kernel.org`에서 제공하며 자세한 생성법은 `Code documentation` 절을 참고한다. 이 색인은 quick start, 일반 정보, 코딩 지침, 아키텍처 지원, 시험 문서를 순서대로 연결한다.

추가 Rust 학습 자료는 `Documentation/process/kernel-docs`의 Rust 절에서 찾을 수 있다. Subproject HTML 빌드에서는 일반 색인 `genindex`도 제공한다.

Rust 문서 읽기 순서
순서문서목적
1quick-start도구 설치와 첫 빌드
2general-informationno_std, 문서, 계층과 cfg
3coding-guidelines스타일, 안전성과 lint 규칙
4arch-support지원 아키텍처와 제약
5testingKUnit, host test와 Kselftest

설치에서 규칙, 지원 범위와 시험으로 이어지는 경로입니다.

Code documentation
------------------

Given a kernel configuration, the kernel may generate Rust code documentation,
i.e. HTML rendered by the ``rustdoc`` tool.

.. only:: rustdoc and html

        This kernel documentation was built with `Rust code documentation
        <rustdoc/kernel/index.html>`_.

.. only:: not rustdoc and html

        This kernel documentation was not built with Rust code documentation.

A pregenerated version is provided at:

        https://rust.docs.kernel.org

Please see the :ref:`Code documentation <rust_code_documentation>` section for
more details.

.. toctree::
    :maxdepth: 1

    quick-start
    general-information
    coding-guidelines
    arch-support
    testing

You can also find learning materials for Rust in its section in
:doc:`../process/kernel-docs`.

.. only::  subproject and html

   Indices
   =======

   * :ref:`genindex`