요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
===============
4
NIC SR-IOV APIs
5
===============
7
Modern NICs are strongly encouraged to focus on implementing the ``switchdev``
8
model (see :ref:`switchdev`) to configure forwarding and security of SR-IOV
9
functionality.
11
Legacy API
12
==========
14
The old SR-IOV API is implemented in ``rtnetlink`` Netlink family as part of
15
the ``RTM_GETLINK`` and ``RTM_SETLINK`` commands. On the driver side
16
it consists of a number of ``ndo_set_vf_*`` and ``ndo_get_vf_*`` callbacks.
18
Since the legacy APIs do not integrate well with the rest of the stack
19
the API is considered frozen; no new functionality or extensions
20
will be accepted. New drivers should not implement the uncommon callbacks;
21
namely the following callbacks are off limits:
23
- ``ndo_get_vf_port``
24
- ``ndo_set_vf_port``
25
- ``ndo_set_vf_rss_query_en``
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
신규 NIC의 switchdev 모델
1-9현대 NIC는 SR-IOV forwarding과 security를 구성할 때 `switchdev` 모델 구현에 집중하는 것이 강하게 권장됩니다. switchdev는 Linux 네트워킹 스택의 forwarding object와 정책 모델에 SR-IOV 기능을 통합합니다.
.. SPDX-License-Identifier: GPL-2.0
===============
NIC SR-IOV APIs
===============
Modern NICs are strongly encouraged to focus on implementing the ``switchdev``
model (see :ref:`switchdev`) to configure forwarding and security of SR-IOV
functionality.동결된 legacy API
10-25구형 SR-IOV API는 `rtnetlink` Netlink family의 `RTM_GETLINK`와 `RTM_SETLINK` 일부로 구현됩니다. 드라이버 쪽에는 여러 `ndo_set_vf_*`와 `ndo_get_vf_*` callback이 있습니다.
legacy API는 나머지 네트워킹 스택과 잘 통합되지 않아 동결된 상태이며 새 기능이나 확장을 받지 않습니다. 새 드라이버는 흔하지 않은 `ndo_get_vf_port`, `ndo_set_vf_port`, `ndo_set_vf_rss_query_en` callback을 구현하면 안 됩니다.
대상정책
신규 NIC driverswitchdev 모델 구현 권장
RTM_GETLINK/SETLINK legacy API동결, 확장 불가
희귀 ndo_* callback 3종신규 구현 금지
신규 드라이버와 legacy callback 정책을 구분합니다.
Legacy API
==========
The old SR-IOV API is implemented in ``rtnetlink`` Netlink family as part of
the ``RTM_GETLINK`` and ``RTM_SETLINK`` commands. On the driver side
it consists of a number of ``ndo_set_vf_*`` and ``ndo_get_vf_*`` callbacks.
Since the legacy APIs do not integrate well with the rest of the stack
the API is considered frozen; no new functionality or extensions
will be accepted. New drivers should not implement the uncommon callbacks;
namely the following callbacks are off limits:
- ``ndo_get_vf_port``
- ``ndo_set_vf_port``
- ``ndo_set_vf_rss_query_en``
요약·해설
sriov.rst:1-25신규 NIC의 switchdev 권장 사항과 동결된 legacy SR-IOV callback 정책을 설명합니다.