요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
=========================
4
netdevsim devlink support
5
=========================
7
This document describes the ``devlink`` features supported by the
8
``netdevsim`` device driver.
10
Parameters
11
==========
13
.. list-table:: Generic parameters implemented
15
* - Name
16
- Mode
17
* - ``max_macs``
18
- driverinit
20
The ``netdevsim`` 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
* - ``test1``
31
- Boolean
32
- driverinit
33
- Test parameter used to show how a driver-specific devlink parameter
34
can be implemented.
36
The ``netdevsim`` driver supports reloading via ``DEVLINK_CMD_RELOAD``
38
Regions
39
=======
41
The ``netdevsim`` driver exposes a ``dummy`` region as an example of how the
42
devlink-region interfaces work. A snapshot is taken whenever the
43
``take_snapshot`` debugfs file is written to.
45
Resources
46
=========
48
The ``netdevsim`` driver exposes resources to control the number of FIB
49
entries, FIB rule entries and nexthops that the driver will allow.
51
.. code:: shell
53
$ devlink resource set netdevsim/netdevsim0 path /IPv4/fib size 96
54
$ devlink resource set netdevsim/netdevsim0 path /IPv4/fib-rules size 16
55
$ devlink resource set netdevsim/netdevsim0 path /IPv6/fib size 64
56
$ devlink resource set netdevsim/netdevsim0 path /IPv6/fib-rules size 16
57
$ devlink resource set netdevsim/netdevsim0 path /nexthops size 16
58
$ devlink dev reload netdevsim/netdevsim0
60
Rate objects
61
============
63
The ``netdevsim`` driver supports rate objects management, which includes:
65
- registering/unregistering leaf rate objects per VF devlink port;
66
- creation/deletion node rate objects;
67
- setting tx_share and tx_max rate values for any rate object type;
68
- setting parent node for any rate object type.
70
Rate nodes and their parameters are exposed in ``netdevsim`` debugfs in RO mode.
71
For example created rate node with name ``some_group``:
73
.. code:: shell
75
$ ls /sys/kernel/debug/netdevsim/netdevsim0/rate_groups/some_group
76
rate_parent tx_max tx_share
78
Same parameters are exposed for leaf objects in corresponding ports directories.
79
For ex.:
81
.. code:: shell
83
$ ls /sys/kernel/debug/netdevsim/netdevsim0/ports/1
84
dev ethtool rate_parent tx_max tx_share
86
Driver-specific Traps
87
=====================
89
.. list-table:: List of Driver-specific Traps Registered by ``netdevsim``
90
:widths: 5 5 90
92
* - Name
93
- Type
94
- Description
95
* - ``fid_miss``
96
- ``exception``
97
- When a packet enters the device it is classified to a filtering
98
identifier (FID) based on the ingress port and VLAN. This trap is used
99
to trap packets for which a FID could not be found
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
netdevsim devlink 지원
1-9이 문서는 `GPL-2.0` 라이선스를 따릅니다.
`netdevsim` 장치 드라이버가 지원하는 `devlink` 기능을 설명합니다.
.. SPDX-License-Identifier: GPL-2.0
=========================
netdevsim devlink support
=========================
This document describes the ``devlink`` features supported by the
``netdevsim`` device driver.
매개변수와 재로드
10-36매개변수
이름유형모드설명
`max_macs`공통driverinit드라이버가 허용하는 최대 MAC 주소 수를 설정합니다.
`test1`Booleandriverinit드라이버 전용 devlink 매개변수를 구현하는 방법을 보여 주는 시험용 매개변수입니다.
공통 MAC 한도와 드라이버 전용 시험 매개변수를 드라이버 초기화 시점에 설정합니다.
`netdevsim` 드라이버는 `DEVLINK_CMD_RELOAD`를 통한 재로드를 지원합니다.
Parameters
==========
.. list-table:: Generic parameters implemented
* - Name
- Mode
* - ``max_macs``
- driverinit
The ``netdevsim`` driver also implements the following driver-specific
parameters.
.. list-table:: Driver-specific parameters implemented
:widths: 5 5 5 85
* - Name
- Type
- Mode
- Description
* - ``test1``
- Boolean
- driverinit
- Test parameter used to show how a driver-specific devlink parameter
can be implemented.
The ``netdevsim`` driver supports reloading via ``DEVLINK_CMD_RELOAD``더미 영역과 스냅샷
37-44영역
`netdevsim` 드라이버는 devlink-region 인터페이스가 작동하는 방식을 보여 주는 예제로 `dummy` 영역을 노출합니다. `take_snapshot` debugfs 파일에 쓸 때마다 스냅샷을 생성합니다.
Regions
=======
The ``netdevsim`` driver exposes a ``dummy`` region as an example of how the
devlink-region interfaces work. A snapshot is taken whenever the
``take_snapshot`` debugfs file is written to.
FIB와 넥스트홉 자원
45-59자원
`netdevsim` 드라이버는 드라이버가 허용할 FIB 항목, FIB 규칙 항목, 넥스트홉 수를 제어하는 자원을 노출합니다.
$ devlink resource set netdevsim/netdevsim0 path /IPv4/fib size 96
$ devlink resource set netdevsim/netdevsim0 path /IPv4/fib-rules size 16
$ devlink resource set netdevsim/netdevsim0 path /IPv6/fib size 64
$ devlink resource set netdevsim/netdevsim0 path /IPv6/fib-rules size 16
$ devlink resource set netdevsim/netdevsim0 path /nexthops size 16
$ devlink dev reload netdevsim/netdevsim0Resources
=========
The ``netdevsim`` driver exposes resources to control the number of FIB
entries, FIB rule entries and nexthops that the driver will allow.
.. code:: shell
$ devlink resource set netdevsim/netdevsim0 path /IPv4/fib size 96
$ devlink resource set netdevsim/netdevsim0 path /IPv4/fib-rules size 16
$ devlink resource set netdevsim/netdevsim0 path /IPv6/fib size 64
$ devlink resource set netdevsim/netdevsim0 path /IPv6/fib-rules size 16
$ devlink resource set netdevsim/netdevsim0 path /nexthops size 16
$ devlink dev reload netdevsim/netdevsim0
속도 객체
60-85속도 객체
`netdevsim` 드라이버의 속도 객체 관리는 다음 기능을 포함합니다.
대상지원 작업
리프 속도 객체VF devlink 포트별 등록과 등록 해제
노드 속도 객체생성과 삭제
모든 속도 객체`tx_share`와 `tx_max` 속도 값 설정
모든 속도 객체부모 노드 설정
VF devlink 포트의 리프와 계층형 노드를 같은 객체 모델로 제어합니다.
속도 노드와 그 매개변수는 `netdevsim` debugfs에서 읽기 전용 모드로 노출됩니다. 다음은 `some_group`이라는 속도 노드를 만든 예입니다.
$ ls /sys/kernel/debug/netdevsim/netdevsim0/rate_groups/some_group
rate_parent tx_max tx_share리프 객체에도 대응하는 포트 디렉터리에서 같은 매개변수가 노출됩니다. 예를 들면 다음과 같습니다.
$ ls /sys/kernel/debug/netdevsim/netdevsim0/ports/1
dev ethtool rate_parent tx_max tx_shareRate objects
============
The ``netdevsim`` driver supports rate objects management, which includes:
- registering/unregistering leaf rate objects per VF devlink port;
- creation/deletion node rate objects;
- setting tx_share and tx_max rate values for any rate object type;
- setting parent node for any rate object type.
Rate nodes and their parameters are exposed in ``netdevsim`` debugfs in RO mode.
For example created rate node with name ``some_group``:
.. code:: shell
$ ls /sys/kernel/debug/netdevsim/netdevsim0/rate_groups/some_group
rate_parent tx_max tx_share
Same parameters are exposed for leaf objects in corresponding ports directories.
For ex.:
.. code:: shell
$ ls /sys/kernel/debug/netdevsim/netdevsim0/ports/1
dev ethtool rate_parent tx_max tx_share
FID 누락 트랩
86-99드라이버 전용 트랩
이름유형설명
`fid_miss``exception`패킷이 장치에 들어오면 수신 포트와 VLAN을 기준으로 필터링 식별자(FID)에 분류됩니다. 이 트랩은 대응하는 FID를 찾을 수 없는 패킷을 트랩하는 데 사용합니다.
수신 포트와 VLAN으로 결정해야 하는 필터링 식별자를 찾지 못한 패킷을 포착합니다.
Driver-specific Traps
=====================
.. list-table:: List of Driver-specific Traps Registered by ``netdevsim``
:widths: 5 5 90
* - Name
- Type
- Description
* - ``fid_miss``
- ``exception``
- When a packet enters the device it is classified to a filtering
identifier (FID) based on the ingress port and VLAN. This trap is used
to trap packets for which a FID could not be found
요약·해설
netdevsim.rst:1-99`netdevsim`은 실제 하드웨어 없이 devlink 인터페이스를 시험하는 기준 구현입니다. 매개변수와 재로드뿐 아니라 영역 스냅샷, IPv4·IPv6 FIB와 규칙·넥스트홉 자원, 계층형 속도 객체, FID 누락 예외 트랩을 한 장치에서 검증할 수 있습니다.