요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
3
=================
4
Devlink Selftests
5
=================
7
The ``devlink-selftests`` API allows executing selftests on the device.
9
Tests Mask
10
==========
11
The ``devlink-selftests`` command should be run with a mask indicating
12
the tests to be executed.
14
Tests Description
15
=================
16
The following is a list of tests that drivers may execute.
18
.. list-table:: List of tests
19
:widths: 5 90
21
* - Name
22
- Description
23
* - ``DEVLINK_SELFTEST_FLASH``
24
- Devices may have the firmware on non-volatile memory on the board, e.g.
25
flash. This particular test helps to run a flash selftest on the device.
26
Implementation of the test is left to the driver/firmware.
28
example usage
29
-------------
31
.. code:: shell
33
# Query selftests supported on the devlink device
34
$ devlink dev selftests show DEV
35
# Query selftests supported on all devlink devices
36
$ devlink dev selftests show
37
# Executes selftests on the device
38
$ devlink dev selftests run DEV id flash
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Devlink Selftests 소개와 test mask
1-13이 문서는 `GPL-2.0-only OR BSD-2-Clause` 이중 라이선스를 따릅니다.
Devlink Selftests
`devlink-selftests` API를 사용하면 장치에서 selftest를 실행할 수 있습니다.
Test mask
`devlink-selftests` 명령은 실행할 test를 나타내는 mask와 함께 실행해야 합니다.
.. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
=================
Devlink Selftests
=================
The ``devlink-selftests`` API allows executing selftests on the device.
Tests Mask
==========
The ``devlink-selftests`` command should be run with a mask indicating
the tests to be executed.
Test 설명
14-27Test 설명
다음은 driver가 실행할 수 있는 test 목록입니다.
이름설명
`DEVLINK_SELFTEST_FLASH`장치 board의 flash 같은 non-volatile memory에 저장된 firmware를 대상으로 flash selftest를 실행합니다. 구체적인 test 구현은 driver 또는 firmware가 담당합니다.
현재 정의된 devlink selftest 항목입니다.
Tests Description
=================
The following is a list of tests that drivers may execute.
.. list-table:: List of tests
:widths: 5 90
* - Name
- Description
* - ``DEVLINK_SELFTEST_FLASH``
- Devices may have the firmware on non-volatile memory on the board, e.g.
flash. This particular test helps to run a flash selftest on the device.
Implementation of the test is left to the driver/firmware.
사용 예
28-38사용 예
# devlink 장치가 지원하는 selftest 조회
$ devlink dev selftests show DEV
# 모든 devlink 장치가 지원하는 selftest 조회
$ devlink dev selftests show
# 장치에서 selftest 실행
$ devlink dev selftests run DEV id flashexample usage
-------------
.. code:: shell
# Query selftests supported on the devlink device
$ devlink dev selftests show DEV
# Query selftests supported on all devlink devices
$ devlink dev selftests show
# Executes selftests on the device
$ devlink dev selftests run DEV id flash
요약·해설
devlink-selftests.rst:1-38Devlink selftests API는 장치가 지원하는 진단 test를 조회하고 선택해 실행하는 공통 interface입니다. 현재 문서화된 `DEVLINK_SELFTEST_FLASH`의 구체적인 검사 절차는 driver 또는 firmware 구현에 달려 있습니다.
지원 목록을 먼저 확인한 뒤 필요한 test ID를 지정합니다.