요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
==========================
4
Devlink E-Switch Attribute
5
==========================
7
Devlink E-Switch supports two modes of operation: legacy and switchdev.
8
Legacy mode operates based on traditional MAC/VLAN steering rules. Switching
9
decisions are made based on MAC addresses, VLANs, etc. There is limited ability
10
to offload switching rules to hardware.
12
On the other hand, switchdev mode allows for more advanced offloading
13
capabilities of the E-Switch to hardware. In switchdev mode, more switching
14
rules and logic can be offloaded to the hardware switch ASIC. It enables
15
representor netdevices that represent the slow path of virtual functions (VFs)
16
or scalable-functions (SFs) of the device. See more information about
17
:ref:`Documentation/networking/switchdev.rst <switchdev>` and
18
:ref:`Documentation/networking/representors.rst <representors>`.
20
In addition, the devlink E-Switch also comes with other attributes listed
21
in the following section.
23
Attributes Description
24
======================
26
The following is a list of E-Switch attributes.
28
.. list-table:: E-Switch attributes
29
:widths: 8 5 45
31
* - Name
32
- Type
33
- Description
34
* - ``mode``
35
- enum
36
- The mode of the device. The mode can be one of the following:
38
* ``legacy`` operates based on traditional MAC/VLAN steering
39
rules.
40
* ``switchdev`` allows for more advanced offloading capabilities of
41
the E-Switch to hardware.
42
* - ``inline-mode``
43
- enum
44
- Some HWs need the VF driver to put part of the packet
45
headers on the TX descriptor so the e-switch can do proper
46
matching and steering. Support for both switchdev mode and legacy mode.
48
* ``none`` none.
49
* ``link`` L2 mode.
50
* ``network`` L3 mode.
51
* ``transport`` L4 mode.
52
* - ``encap-mode``
53
- enum
54
- The encapsulation mode of the device. Support for both switchdev mode
55
and legacy mode. The mode can be one of the following:
57
* ``none`` Disable encapsulation support.
58
* ``basic`` Enable encapsulation support.
60
Example Usage
61
=============
63
.. code:: shell
65
# enable switchdev mode
66
$ devlink dev eswitch set pci/0000:08:00.0 mode switchdev
68
# set inline-mode and encap-mode
69
$ devlink dev eswitch set pci/0000:08:00.0 inline-mode none encap-mode basic
71
# display devlink device eswitch attributes
72
$ devlink dev eswitch show pci/0000:08:00.0
73
pci/0000:08:00.0: mode switchdev inline-mode none encap-mode basic
75
# enable encap-mode with legacy mode
76
$ devlink dev eswitch set pci/0000:08:00.0 mode legacy inline-mode none encap-mode basic
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Devlink E-Switch mode
1-22이 문서는 `GPL-2.0` 라이선스를 따릅니다.
Devlink E-Switch attribute
Devlink E-Switch는 `legacy`와 `switchdev`라는 두 가지 동작 mode를 지원합니다.
`legacy` mode는 전통적인 MAC/VLAN steering rule에 따라 동작합니다. MAC address, VLAN 등을 기준으로 switching을 결정하며 switching rule을 hardware로 offload하는 능력은 제한적입니다.
반면 `switchdev` mode는 E-Switch의 고급 기능을 hardware로 offload할 수 있습니다. 더 많은 switching rule과 logic을 hardware switch ASIC으로 넘길 수 있고, 장치의 VF(virtual function) 또는 SF(scalable function) slow path를 나타내는 representor netdevice를 활성화합니다.
자세한 내용은 `Documentation/networking/switchdev.rst`와 `Documentation/networking/representors.rst`를 참조하십시오.
devlink E-Switch에는 다음 절에서 설명하는 다른 attribute도 있습니다.
modesteeringhardware offloadrepresentor
`legacy`MAC/VLAN 중심제한적사용하지 않음
`switchdev`고급 switching rule확장됨VF·SF slow path 표현
두 mode는 hardware offload 범위와 representor 제공 여부가 다릅니다.
.. SPDX-License-Identifier: GPL-2.0
==========================
Devlink E-Switch Attribute
==========================
Devlink E-Switch supports two modes of operation: legacy and switchdev.
Legacy mode operates based on traditional MAC/VLAN steering rules. Switching
decisions are made based on MAC addresses, VLANs, etc. There is limited ability
to offload switching rules to hardware.
On the other hand, switchdev mode allows for more advanced offloading
capabilities of the E-Switch to hardware. In switchdev mode, more switching
rules and logic can be offloaded to the hardware switch ASIC. It enables
representor netdevices that represent the slow path of virtual functions (VFs)
or scalable-functions (SFs) of the device. See more information about
:ref:`Documentation/networking/switchdev.rst <switchdev>` and
:ref:`Documentation/networking/representors.rst <representors>`.
In addition, the devlink E-Switch also comes with other attributes listed
in the following section.
E-Switch attribute 설명
23-59Attribute 설명
다음은 E-Switch attribute 목록입니다.
이름형식설명값
`mode`enum장치 동작 mode`legacy`: 전통적 MAC/VLAN steering, `switchdev`: 고급 hardware offload
`inline-mode`enumE-Switch가 올바르게 match하고 steering하도록 VF driver가 TX descriptor에 넣는 packet header 범위. switchdev와 legacy mode 모두 지원`none`, `link`(L2), `network`(L3), `transport`(L4)
`encap-mode`enum장치의 encapsulation mode. switchdev와 legacy mode 모두 지원`none`: encapsulation 비활성화, `basic`: encapsulation 활성화
mode, TX descriptor의 inline header 범위, encapsulation 지원을 설정합니다.
Attributes Description
======================
The following is a list of E-Switch attributes.
.. list-table:: E-Switch attributes
:widths: 8 5 45
* - Name
- Type
- Description
* - ``mode``
- enum
- The mode of the device. The mode can be one of the following:
* ``legacy`` operates based on traditional MAC/VLAN steering
rules.
* ``switchdev`` allows for more advanced offloading capabilities of
the E-Switch to hardware.
* - ``inline-mode``
- enum
- Some HWs need the VF driver to put part of the packet
headers on the TX descriptor so the e-switch can do proper
matching and steering. Support for both switchdev mode and legacy mode.
* ``none`` none.
* ``link`` L2 mode.
* ``network`` L3 mode.
* ``transport`` L4 mode.
* - ``encap-mode``
- enum
- The encapsulation mode of the device. Support for both switchdev mode
and legacy mode. The mode can be one of the following:
* ``none`` Disable encapsulation support.
* ``basic`` Enable encapsulation support.
E-Switch 사용 예
60-76사용 예
다음 명령은 PCI 장치를 `switchdev` mode로 전환하고 `inline-mode`와 `encap-mode`를 설정한 뒤 현재 attribute를 표시합니다. 마지막 명령처럼 `legacy` mode에서도 encapsulation을 활성화할 수 있습니다.
# enable switchdev mode
$ devlink dev eswitch set pci/0000:08:00.0 mode switchdev
# set inline-mode and encap-mode
$ devlink dev eswitch set pci/0000:08:00.0 inline-mode none encap-mode basic
# display devlink device eswitch attributes
$ devlink dev eswitch show pci/0000:08:00.0
pci/0000:08:00.0: mode switchdev inline-mode none encap-mode basic
# enable encap-mode with legacy mode
$ devlink dev eswitch set pci/0000:08:00.0 mode legacy inline-mode none encap-mode basicExample Usage
=============
.. code:: shell
# enable switchdev mode
$ devlink dev eswitch set pci/0000:08:00.0 mode switchdev
# set inline-mode and encap-mode
$ devlink dev eswitch set pci/0000:08:00.0 inline-mode none encap-mode basic
# display devlink device eswitch attributes
$ devlink dev eswitch show pci/0000:08:00.0
pci/0000:08:00.0: mode switchdev inline-mode none encap-mode basic
# enable encap-mode with legacy mode
$ devlink dev eswitch set pci/0000:08:00.0 mode legacy inline-mode none encap-mode basic
요약·해설
devlink-eswitch-attr.rst:1-76`legacy`는 MAC/VLAN 중심의 제한적인 offload mode이고, `switchdev`는 VF·SF representor와 더 넓은 ASIC offload를 제공합니다. `inline-mode`는 TX descriptor가 제공할 header 계층을, `encap-mode`는 encapsulation 지원을 정합니다.
동작 mode와 packet metadata·encapsulation 설정을 분리합니다.