mlxsw devlink support | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

mlxsw.rst:1-105

`mlxsw` devlink 지원은 펌웨어 로드 정책과 ACL 영역 재해시 주기를 제어하고, 본체와 라인 카드의 하드웨어·INI·펌웨어 버전을 구분해 보고합니다. 라우터 인터페이스를 해체하는 동안 비활성 RIF 때문에 폐기되는 패킷은 `irif_disabled`와 `erif_disabled` 트랩으로 관찰할 수 있습니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 .. SPDX-License-Identifier: GPL-2.0

3 =====================

4 mlxsw devlink support

5 =====================

7 This document describes the devlink features implemented by the ``mlxsw``

8 device driver.

10 Parameters

11 ==========

13 .. list-table:: Generic parameters implemented

15 * - Name

16 - Mode

17 * - ``fw_load_policy``

18 - driverinit

20 The ``mlxsw`` driver also implements the following driver-specific

21 parameters.

23 .. list-table:: Driver-specific parameters implemented

24 :widths: 5 5 5 85

26 * - Name

27 - Type

28 - Mode

29 - Description

30 * - ``acl_region_rehash_interval``

31 - u32

32 - runtime

33 - Sets an interval for periodic ACL region rehashes. The value is

34 specified in milliseconds, with a minimum of ``3000``. The value of

35 ``0`` disables periodic work entirely. The first rehash will be run

36 immediately after the value is set.

38 The ``mlxsw`` driver supports reloading via ``DEVLINK_CMD_RELOAD``

40 Info versions

41 =============

43 The ``mlxsw`` driver reports the following versions

45 .. list-table:: devlink info versions implemented

46 :widths: 5 5 90

48 * - Name

49 - Type

50 - Description

51 * - ``hw.revision``

52 - fixed

53 - The hardware revision for this board

54 * - ``fw.psid``

55 - fixed

56 - Firmware PSID

57 * - ``fw.version``

58 - running

59 - Three digit firmware version

61 Line card auxiliary device info versions

62 ========================================

64 The ``mlxsw`` driver reports the following versions for line card auxiliary device

66 .. list-table:: devlink info versions implemented

67 :widths: 5 5 90

69 * - Name

70 - Type

71 - Description

72 * - ``hw.revision``

73 - fixed

74 - The hardware revision for this line card

75 * - ``ini.version``

76 - running

77 - Version of line card INI loaded

78 * - ``fw.psid``

79 - fixed

80 - Line card device PSID

81 * - ``fw.version``

82 - running

83 - Three digit firmware version of line card device

85 Driver-specific Traps

86 =====================

88 .. list-table:: List of Driver-specific Traps Registered by ``mlxsw``

89 :widths: 5 5 90

91 * - Name

92 - Type

93 - Description

94 * - ``irif_disabled``

95 - ``drop``

96 - Traps packets that the device decided to drop because they need to be

97 routed from a disabled router interface (RIF). This can happen during

98 RIF dismantle, when the RIF is first disabled before being removed

99 completely

100 * - ``erif_disabled``

101 - ``drop``

102 - Traps packets that the device decided to drop because they need to be

103 routed through a disabled router interface (RIF). This can happen during

104 RIF dismantle, when the RIF is first disabled before being removed

105 completely

106

3. 한국어 전문 번역

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

mlxsw devlink 지원

1-9

이 문서는 `GPL-2.0` 라이선스를 따릅니다.

`mlxsw` 장치 드라이버가 구현한 devlink 기능을 설명합니다.

.. SPDX-License-Identifier: GPL-2.0

=====================
mlxsw devlink support
=====================

This document describes the devlink features implemented by the ``mlxsw``
device driver.

매개변수와 재로드

10-38

매개변수

mlxsw devlink 매개변수

이름형식모드설명

`fw_load_policy`공통driverinit드라이버 초기화 때 적용하는 펌웨어 로드 정책입니다.

`acl_region_rehash_interval`u32runtimeACL 영역을 주기적으로 재해시하는 간격을 밀리초 단위로 설정합니다. 최솟값은 `3000`이고 `0`은 주기 작업을 완전히 끕니다. 값을 설정하면 첫 재해시를 즉시 수행합니다.

공통 펌웨어 로드 정책과 드라이버 전용 ACL 영역 재해시 주기를 구분합니다.

`mlxsw` 드라이버는 `DEVLINK_CMD_RELOAD`를 통한 재로드를 지원합니다.

Parameters
==========

.. list-table:: Generic parameters implemented

   * - Name
     - Mode
   * - ``fw_load_policy``
     - driverinit

The ``mlxsw`` driver also implements the following driver-specific
parameters.

.. list-table:: Driver-specific parameters implemented
   :widths: 5 5 5 85

   * - Name
     - Type
     - Mode
     - Description
   * - ``acl_region_rehash_interval``
     - u32
     - runtime
     - Sets an interval for periodic ACL region rehashes. The value is
       specified in milliseconds, with a minimum of ``3000``. The value of
       ``0`` disables periodic work entirely. The first rehash will be run
       immediately after the value is set.

The ``mlxsw`` driver supports reloading via ``DEVLINK_CMD_RELOAD``

장치 정보 버전

39-60

정보 버전

`mlxsw` 드라이버는 다음 장치 버전 정보를 보고합니다.

mlxsw 장치 devlink 정보

이름유형설명

`hw.revision`fixed이 보드의 하드웨어 리비전

`fw.psid`fixed펌웨어 PSID

`fw.version`running세 자리 펌웨어 버전

고정 하드웨어 정보와 현재 실행 중인 펌웨어 버전을 구분합니다.


Info versions
=============

The ``mlxsw`` driver reports the following versions

.. list-table:: devlink info versions implemented
   :widths: 5 5 90

   * - Name
     - Type
     - Description
   * - ``hw.revision``
     - fixed
     - The hardware revision for this board
   * - ``fw.psid``
     - fixed
     - Firmware PSID
   * - ``fw.version``
     - running
     - Three digit firmware version

라인 카드 보조 장치 정보

61-84

라인 카드 보조 장치 정보 버전

`mlxsw` 드라이버는 라인 카드 보조 장치에 대해 다음 버전을 보고합니다.

라인 카드 devlink 정보

이름유형설명

`hw.revision`fixed이 라인 카드의 하드웨어 리비전

`ini.version`running적재된 라인 카드 INI 버전

`fw.psid`fixed라인 카드 장치 PSID

`fw.version`running라인 카드 장치의 세 자리 펌웨어 버전

라인 카드의 고정 식별 정보와 현재 적재된 INI·펌웨어 버전입니다.

Line card auxiliary device info versions
========================================

The ``mlxsw`` driver reports the following versions for line card auxiliary device

.. list-table:: devlink info versions implemented
   :widths: 5 5 90

   * - Name
     - Type
     - Description
   * - ``hw.revision``
     - fixed
     - The hardware revision for this line card
   * - ``ini.version``
     - running
     - Version of line card INI loaded
   * - ``fw.psid``
     - fixed
     - Line card device PSID
   * - ``fw.version``
     - running
     - Three digit firmware version of line card device

드라이버 전용 트랩

85-105

드라이버 전용 트랩

mlxsw 드라이버 전용 트랩

이름유형설명

`irif_disabled``drop`비활성화된 라우터 인터페이스(RIF)에서 라우팅해야 하므로 장치가 폐기하기로 한 패킷을 트랩합니다. RIF 해체 과정에서 완전히 제거하기 전에 RIF를 먼저 비활성화할 때 발생할 수 있습니다.

`erif_disabled``drop`비활성화된 라우터 인터페이스(RIF)를 통해 라우팅해야 하므로 장치가 폐기하기로 한 패킷을 트랩합니다. RIF 해체 과정에서 완전히 제거하기 전에 RIF를 먼저 비활성화할 때 발생할 수 있습니다.

비활성화된 라우터 인터페이스 때문에 폐기되는 패킷을 포착합니다.

Driver-specific Traps
=====================

.. list-table:: List of Driver-specific Traps Registered by ``mlxsw``
   :widths: 5 5 90

   * - Name
     - Type
     - Description
   * - ``irif_disabled``
     - ``drop``
     - Traps packets that the device decided to drop because they need to be
       routed from a disabled router interface (RIF). This can happen during
       RIF dismantle, when the RIF is first disabled before being removed
       completely
   * - ``erif_disabled``
     - ``drop``
     - Traps packets that the device decided to drop because they need to be
       routed through a disabled router interface (RIF). This can happen during
       RIF dismantle, when the RIF is first disabled before being removed
       completely