요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
====================
4
mlx4 devlink support
5
====================
7
This document describes the devlink features implemented by the ``mlx4``
8
device driver.
10
Parameters
11
==========
13
.. list-table:: Generic parameters implemented
15
* - Name
16
- Mode
17
* - ``internal_err_reset``
18
- driverinit, runtime
19
* - ``max_macs``
20
- driverinit
21
* - ``region_snapshot_enable``
22
- driverinit, runtime
24
The ``mlx4`` driver also implements the following driver-specific
25
parameters.
27
.. list-table:: Driver-specific parameters implemented
28
:widths: 5 5 5 85
30
* - Name
31
- Type
32
- Mode
33
- Description
34
* - ``enable_64b_cqe_eqe``
35
- Boolean
36
- driverinit
37
- Enable 64 byte CQEs/EQEs, if the FW supports it.
38
* - ``enable_4k_uar``
39
- Boolean
40
- driverinit
41
- Enable using the 4k UAR.
43
The ``mlx4`` driver supports reloading via ``DEVLINK_CMD_RELOAD``
45
Regions
46
=======
48
The ``mlx4`` driver supports dumping the firmware PCI crspace and health
49
buffer during a critical firmware issue.
51
In case a firmware command times out, firmware getting stuck, or a non zero
52
value on the catastrophic buffer, a snapshot will be taken by the driver.
54
The ``cr-space`` region will contain the firmware PCI crspace contents. The
55
``fw-health`` region will contain the device firmware's health buffer.
56
Snapshots for both of these regions are taken on the same event triggers.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
mlx4 devlink 지원
1-9이 문서는 `GPL-2.0` 라이선스를 따릅니다.
mlx4 devlink 지원
이 문서는 `mlx4` 장치 드라이버가 구현한 devlink 기능을 설명합니다.
.. SPDX-License-Identifier: GPL-2.0
====================
mlx4 devlink support
====================
This document describes the devlink features implemented by the ``mlx4``
device driver.
매개변수
10-42매개변수
이름모드
`internal_err_reset`driverinit, runtime
`max_macs`driverinit
`region_snapshot_enable`driverinit, runtime
초기 드라이버 설정과 실행 중 설정에서 사용할 수 있는 devlink 공통 매개변수입니다.
`mlx4` 드라이버는 다음과 같은 드라이버 전용 매개변수도 구현합니다.
이름유형모드설명
`enable_64b_cqe_eqe`Booleandriverinit펌웨어가 지원하는 경우 64바이트 CQE/EQE를 활성화합니다.
`enable_4k_uar`Booleandriverinit4K UAR 사용을 활성화합니다.
펌웨어가 지원하는 큐 항목 크기와 UAR 페이지 크기를 드라이버 초기화 시 선택합니다.
Parameters
==========
.. list-table:: Generic parameters implemented
* - Name
- Mode
* - ``internal_err_reset``
- driverinit, runtime
* - ``max_macs``
- driverinit
* - ``region_snapshot_enable``
- driverinit, runtime
The ``mlx4`` driver also implements the following driver-specific
parameters.
.. list-table:: Driver-specific parameters implemented
:widths: 5 5 5 85
* - Name
- Type
- Mode
- Description
* - ``enable_64b_cqe_eqe``
- Boolean
- driverinit
- Enable 64 byte CQEs/EQEs, if the FW supports it.
* - ``enable_4k_uar``
- Boolean
- driverinit
- Enable using the 4k UAR.
다시 불러오기
43-44`mlx4` 드라이버는 `DEVLINK_CMD_RELOAD`를 통한 다시 불러오기를 지원합니다.
The ``mlx4`` driver supports reloading via ``DEVLINK_CMD_RELOAD``
영역
45-56영역
`mlx4` 드라이버는 심각한 펌웨어 문제가 발생했을 때 펌웨어 PCI crspace와 상태 버퍼를 덤프할 수 있습니다.
펌웨어 명령이 시간 초과되거나 펌웨어가 멈추거나 catastrophic buffer에 0이 아닌 값이 나타나면 드라이버가 스냅샷을 생성합니다.
이름내용
`cr-space`펌웨어 PCI crspace 내용입니다.
`fw-health`장치 펌웨어의 상태 버퍼입니다.
같은 장애 이벤트가 두 영역의 스냅샷을 함께 생성합니다.
두 영역의 스냅샷은 동일한 이벤트 트리거에서 생성됩니다.
Regions
=======
The ``mlx4`` driver supports dumping the firmware PCI crspace and health
buffer during a critical firmware issue.
In case a firmware command times out, firmware getting stuck, or a non zero
value on the catastrophic buffer, a snapshot will be taken by the driver.
The ``cr-space`` region will contain the firmware PCI crspace contents. The
``fw-health`` region will contain the device firmware's health buffer.
Snapshots for both of these regions are taken on the same event triggers.
요약·해설
mlx4.rst:1-56`mlx4`는 내부 오류 재설정, MAC 수, 영역 스냅샷 같은 공통 설정과 64바이트 CQE/EQE 및 4K UAR 선택을 제공합니다. 펌웨어 명령 시간 초과나 정지, catastrophic buffer 오류가 발생하면 `cr-space`와 `fw-health` 스냅샷을 같은 트리거에서 생성합니다.
펌웨어 장애 신호가 두 진단 영역의 동시 스냅샷으로 이어집니다.