octeontx2 devlink support | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

octeontx2.rst:1-79

`octeontx2` devlink 매개변수는 PF·VF의 ntuple MCAM 할당, AF의 송신 DWRR quantum과 NPC 우선순위·카운터, NIX LF 한도, PF 유니캐스트 필터 수를 실행 중에 조정합니다. 희소한 MCAM과 카운터를 실제 인터페이스 수요에 맞게 배분하는 것이 핵심입니다.

2. 영어 원문 전체

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

원문 전체 펼치기

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

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

4 octeontx2 devlink support

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

7 This document describes the devlink features implemented by the ``octeontx2 AF, PF and VF``

8 device drivers.

10 Parameters

11 ==========

13 The ``octeontx2 PF and VF`` drivers implement the following driver-specific parameters.

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

16 :widths: 5 5 5 85

18 * - Name

19 - Type

20 - Mode

21 - Description

22 * - ``mcam_count``

23 - u16

24 - runtime

25 - Select number of match CAM entries to be allocated for an interface.

26 The same is used for ntuple filters of the interface. Supported by

27 PF and VF drivers.

29 The ``octeontx2 AF`` driver implements the following driver-specific parameters.

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

32 :widths: 5 5 5 85

34 * - Name

35 - Type

36 - Mode

37 - Description

38 * - ``dwrr_mtu``

39 - u32

40 - runtime

41 - Use to set the quantum which hardware uses for scheduling among transmit queues.

42 Hardware uses weighted DWRR algorithm to schedule among all transmit queues.

43 * - ``npc_mcam_high_zone_percent``

44 - u8

45 - runtime

46 - Use to set the number of high priority zone entries in NPC MCAM that can be allocated

47 by a user, out of the three priority zone categories high, mid and low.

48 * - ``npc_def_rule_cntr``

49 - bool

50 - runtime

51 - Use to enable or disable hit counters for the default rules in NPC MCAM.

52 Its not guaranteed that counters gets enabled and mapped to all the default rules,

53 since the counters are scarce and driver follows a best effort approach.

54 The default rule serves as the primary packet steering rule for a specific PF or VF,

55 based on its DMAC address which is installed by AF driver as part of its initialization.

56 Sample command to read hit counters for default rule from debugfs is as follows,

57 cat /sys/kernel/debug/cn10k/npc/mcam_rules

58 * - ``nix_maxlf``

59 - u16

60 - runtime

61 - Use to set the maximum number of LFs in NIX hardware block. This would be useful

62 to increase the availability of default resources allocated to enabled LFs like

63 MCAM entries for example.

65 The ``octeontx2 PF`` driver implements the following driver-specific parameters.

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

68 :widths: 5 5 5 85

70 * - Name

71 - Type

72 - Mode

73 - Description

74 * - ``unicast_filter_count``

75 - u8

76 - runtime

77 - Set the maximum number of unicast filters that can be programmed for

78 the device. This can be used to achieve better device resource

79 utilization, avoiding over consumption of unused MCAM table entries.

3. 한국어 전문 번역

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

octeontx2 devlink 지원

1-9

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

`octeontx2 AF, PF, VF` 장치 드라이버가 구현한 devlink 기능을 설명합니다.

.. SPDX-License-Identifier: GPL-2.0

=========================
octeontx2 devlink support
=========================

This document describes the devlink features implemented by the ``octeontx2 AF, PF and VF``
device drivers.

PF와 VF의 MCAM 할당

10-28

매개변수

`octeontx2 PF 및 VF` 드라이버는 다음 드라이버 전용 매개변수를 구현합니다.

PF·VF devlink 매개변수

이름유형모드설명

`mcam_count`u16runtime인터페이스에 할당할 match CAM 항목 수를 선택합니다. 같은 항목을 인터페이스의 ntuple 필터에 사용하며 PF와 VF 드라이버가 모두 지원합니다.

인터페이스의 ntuple 필터가 사용할 match CAM 항목 수를 실행 중에 조정합니다.

Parameters
==========

The ``octeontx2 PF and VF`` drivers implement the following driver-specific parameters.

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

   * - Name
     - Type
     - Mode
     - Description
   * - ``mcam_count``
     - u16
     - runtime
     - Select number of match CAM entries to be allocated for an interface.
       The same is used for ntuple filters of the interface. Supported by
       PF and VF drivers.

AF 스케줄링과 NPC·NIX 자원

29-64

`octeontx2 AF` 드라이버는 다음 드라이버 전용 매개변수를 구현합니다.

AF devlink 매개변수

이름유형모드설명

`dwrr_mtu`u32runtime하드웨어가 송신 큐 사이를 스케줄링할 때 사용하는 quantum을 설정합니다. 하드웨어는 모든 송신 큐에 가중 DWRR 알고리즘을 적용합니다.

`npc_mcam_high_zone_percent`u8runtimeNPC MCAM의 high·mid·low 세 우선순위 영역 가운데 사용자가 할당할 수 있는 high 우선순위 영역 항목 비율을 설정합니다.

`npc_def_rule_cntr`boolruntimeNPC MCAM 기본 규칙의 hit counter를 켜거나 끕니다. 카운터가 부족하므로 모든 기본 규칙에 카운터를 활성화하고 매핑한다고 보장하지 않으며 드라이버는 최선 노력 방식으로 처리합니다. 기본 규칙은 AF 드라이버 초기화 때 설치한 DMAC 주소를 기준으로 특정 PF나 VF의 주 패킷 조정 규칙 역할을 합니다.

`nix_maxlf`u16runtimeNIX 하드웨어 블록의 최대 LF 수를 설정합니다. LF 수를 제한하면 MCAM 항목처럼 활성 LF에 기본으로 할당하는 자원의 가용성을 높일 수 있습니다.

송신 스케줄링 quantum, NPC MCAM 우선순위·카운터, NIX LF 수를 실행 중에 제어합니다.

debugfs에서 기본 규칙의 hit counter를 읽는 예는 다음과 같습니다.

cat /sys/kernel/debug/cn10k/npc/mcam_rules

The ``octeontx2 AF`` driver implements the following driver-specific parameters.

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

   * - Name
     - Type
     - Mode
     - Description
   * - ``dwrr_mtu``
     - u32
     - runtime
     - Use to set the quantum which hardware uses for scheduling among transmit queues.
       Hardware uses weighted DWRR algorithm to schedule among all transmit queues.
   * - ``npc_mcam_high_zone_percent``
     - u8
     - runtime
     - Use to set the number of high priority zone entries in NPC MCAM that can be allocated
       by a user, out of the three priority zone categories high, mid and low.
   * - ``npc_def_rule_cntr``
     - bool
     - runtime
     - Use to enable or disable hit counters for the default rules in NPC MCAM.
       Its not guaranteed that counters gets enabled and mapped to all the default rules,
       since the counters are scarce and driver follows a best effort approach.
       The default rule serves as the primary packet steering rule for a specific PF or VF,
       based on its DMAC address which is installed by AF driver as part of its initialization.
       Sample command to read hit counters for default rule from debugfs is as follows,
       cat /sys/kernel/debug/cn10k/npc/mcam_rules
   * - ``nix_maxlf``
     - u16
     - runtime
     - Use to set the maximum number of LFs in NIX hardware block. This would be useful
       to increase the availability of default resources allocated to enabled LFs like
       MCAM entries for example.

PF 유니캐스트 필터 한도

65-79

`octeontx2 PF` 드라이버는 다음 드라이버 전용 매개변수를 구현합니다.

PF devlink 매개변수

이름유형모드설명

`unicast_filter_count`u8runtime장치에 프로그래밍할 수 있는 유니캐스트 필터의 최대 수를 설정합니다. 사용하지 않는 MCAM 표 항목의 과소비를 피하면서 장치 자원 활용도를 높일 수 있습니다.

사용하지 않는 MCAM 표 항목을 과도하게 소비하지 않도록 유니캐스트 필터 수를 제한합니다.

The ``octeontx2 PF`` driver implements the following driver-specific parameters.

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

   * - Name
     - Type
     - Mode
     - Description
   * - ``unicast_filter_count``
     - u8
     - runtime
     - Set the maximum number of unicast filters that can be programmed for
       the device. This can be used to achieve better device resource
       utilization, avoiding over consumption of unused MCAM table entries.