요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
====================
4
i40e devlink support
5
====================
7
This document describes the devlink features implemented by the ``i40e``
8
device driver.
10
Info versions
11
=============
13
The ``i40e`` driver reports the following versions
15
.. list-table:: devlink info versions implemented
16
:widths: 5 5 5 90
18
* - Name
19
- Type
20
- Example
21
- Description
22
* - ``board.id``
23
- fixed
24
- K15190-000
25
- The Product Board Assembly (PBA) identifier of the board.
26
* - ``fw.mgmt``
27
- running
28
- 9.130
29
- 2-digit version number of the management firmware that controls the
30
PHY, link, etc.
31
* - ``fw.mgmt.api``
32
- running
33
- 1.15
34
- 2-digit version number of the API exported over the AdminQ by the
35
management firmware. Used by the driver to identify what commands
36
are supported.
37
* - ``fw.mgmt.build``
38
- running
39
- 73618
40
- Build number of the source for the management firmware.
41
* - ``fw.undi``
42
- running
43
- 1.3429.0
44
- Version of the Option ROM containing the UEFI driver. The version is
45
reported in ``major.minor.patch`` format. The major version is
46
incremented whenever a major breaking change occurs, or when the
47
minor version would overflow. The minor version is incremented for
48
non-breaking changes and reset to 1 when the major version is
49
incremented. The patch version is normally 0 but is incremented when
50
a fix is delivered as a patch against an older base Option ROM.
51
* - ``fw.psid.api``
52
- running
53
- 9.30
54
- Version defining the format of the flash contents.
55
* - ``fw.bundle_id``
56
- running
57
- 0x8000e5f3
58
- Unique identifier of the firmware image file that was loaded onto
59
the device. Also referred to as the EETRACK identifier of the NVM.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
i40e devlink 지원
1-9이 문서는 `GPL-2.0` 라이선스를 따릅니다.
i40e devlink 지원
이 문서는 `i40e` device driver가 구현한 devlink 기능을 설명합니다.
.. SPDX-License-Identifier: GPL-2.0
====================
i40e devlink support
====================
This document describes the devlink features implemented by the ``i40e``
device driver.
Info version
10-59Info version
`i40e` driver는 다음 version을 보고합니다.
이름type예설명
`board.id`fixed`K15190-000`Board의 PBA(Product Board Assembly) 식별자입니다.
`fw.mgmt`running`9.130`PHY, link 등을 제어하는 management firmware의 두 자리 version number입니다.
`fw.mgmt.api`running`1.15`Management firmware가 AdminQ를 통해 export하는 API의 두 자리 version number입니다. Driver는 이 값으로 지원 command를 식별합니다.
`fw.mgmt.build`running`73618`Management firmware source의 build number입니다.
`fw.undi`running`1.3429.0`UEFI driver를 포함하는 Option ROM version입니다. `major.minor.patch` 형식으로 보고합니다. 호환성을 깨는 큰 변경이나 minor overflow 때 major가 증가하고, 호환성을 유지하는 변경에는 minor가 증가합니다. Major가 증가하면 minor는 1로 reset됩니다. Patch는 보통 0이며 오래된 base Option ROM에 수정 사항을 patch로 제공할 때 증가합니다.
`fw.psid.api`running`9.30`Flash content 형식을 정의하는 version입니다.
`fw.bundle_id`running`0x8000e5f3`장치에 load된 firmware image file의 고유 식별자입니다. NVM의 EETRACK identifier라고도 합니다.
Board 식별자, management firmware·API·build, Option ROM, flash format과 image ID를 제공합니다.
Info versions
=============
The ``i40e`` driver reports the following versions
.. list-table:: devlink info versions implemented
:widths: 5 5 5 90
* - Name
- Type
- Example
- Description
* - ``board.id``
- fixed
- K15190-000
- The Product Board Assembly (PBA) identifier of the board.
* - ``fw.mgmt``
- running
- 9.130
- 2-digit version number of the management firmware that controls the
PHY, link, etc.
* - ``fw.mgmt.api``
- running
- 1.15
- 2-digit version number of the API exported over the AdminQ by the
management firmware. Used by the driver to identify what commands
are supported.
* - ``fw.mgmt.build``
- running
- 73618
- Build number of the source for the management firmware.
* - ``fw.undi``
- running
- 1.3429.0
- Version of the Option ROM containing the UEFI driver. The version is
reported in ``major.minor.patch`` format. The major version is
incremented whenever a major breaking change occurs, or when the
minor version would overflow. The minor version is incremented for
non-breaking changes and reset to 1 when the major version is
incremented. The patch version is normally 0 but is incremented when
a fix is delivered as a patch against an older base Option ROM.
* - ``fw.psid.api``
- running
- 9.30
- Version defining the format of the flash contents.
* - ``fw.bundle_id``
- running
- 0x8000e5f3
- Unique identifier of the firmware image file that was loaded onto
the device. Also referred to as the EETRACK identifier of the NVM.
요약·해설
i40e.rst:1-59`i40e` devlink info는 hardware board 식별자와 실행 중인 firmware stack의 여러 version을 분리해 보여 줍니다. 장애 분석이나 update 검증 시 management firmware, AdminQ API, Option ROM, flash format, bundle ID를 함께 기록하면 장치 image를 정확히 식별할 수 있습니다.
각 값이 식별하는 firmware·hardware 범위입니다.