요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
=============================
IBM s390 QDIO Ethernet Driver
=============================
OSA and HiperSockets Bridge Port Support
========================================
Uevents
-------
To generate the events the device must be assigned a role of either
a primary or a secondary Bridge Port. For more information, see
"z/VM Connectivity, SC24-6174".
When run on an OSA or HiperSockets Bridge Capable Port hardware, and the state
of some configured Bridge Port device on the channel changes, a udev
event with ACTION=CHANGE is emitted on behalf of the corresponding
ccwgroup device. The event has the following attributes:
BRIDGEPORT=statechange
indicates that the Bridge Port device changed
its state.
ROLE={primary|secondary|none}
the role assigned to the port.
STATE={active|standby|inactive}
the newly assumed state of the port.
When run on HiperSockets Bridge Capable Port hardware with host address
notifications enabled, a udev event with ACTION=CHANGE is emitted.
It is emitted on behalf of the corresponding ccwgroup device when a host
or a VLAN is registered or unregistered on the network served by the device.
The event has the following attributes:
BRIDGEDHOST={reset|register|deregister|abort}
host address
notifications are started afresh, a new host or VLAN is registered or
deregistered on the Bridge Port HiperSockets channel, or address
notifications are aborted.
VLAN=numeric-vlan-id
VLAN ID on which the event occurred. Not included
if no VLAN is involved in the event.
MAC=xx:xx:xx:xx:xx:xx
MAC address of the host that is being registered
or deregistered from the HiperSockets channel. Not reported if the
event reports the creation or destruction of a VLAN.
NTOK_BUSID=x.y.zzzz
device bus ID (CSSID, SSID and device number).
NTOK_IID=xx
device IID.
NTOK_CHPID=xx
device CHPID.
NTOK_CHID=xxxx
device channel ID.
Note that the `NTOK_*` attributes refer to devices other than the one
connected to the system on which the OS is running.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
IBM s390 QDIO Ethernet Driver
1-7이 문서는 IBM s390 QDIO Ethernet Driver의 OSA 및 HiperSockets Bridge Port 지원을 설명합니다.
uevent 생성 조건
8-14event를 생성하려면 장치에 primary 또는 secondary Bridge Port 역할을 지정해야 합니다. 자세한 내용은 "z/VM Connectivity, SC24-6174"를 참조하십시오.
Bridge Port 상태 변경 event
15-29OSA 또는 HiperSockets Bridge Capable Port hardware에서 channel의 구성된 Bridge Port 장치 상태가 바뀌면 대응 `ccwgroup` 장치를 대신해 `ACTION=CHANGE`인 udev event가 발생합니다.
| 속성 | 의미 |
|---|---|
| `BRIDGEPORT=statechange` | Bridge Port 장치가 상태를 변경했음을 나타냅니다. |
| `ROLE={primary|secondary|none}` | port에 지정된 역할입니다. |
| `STATE={active|standby|inactive}` | port가 새로 전환된 상태입니다. |
host 주소 알림 event
30-64host 주소 알림을 활성화한 HiperSockets Bridge Capable Port hardware에서는 장치가 제공하는 network에 host 또는 VLAN을 등록하거나 등록 해제할 때 대응 `ccwgroup` 장치를 대신해 `ACTION=CHANGE` udev event가 발생합니다.
| 속성 | 의미 |
|---|---|
| `BRIDGEDHOST={reset|register|deregister|abort}` | host 주소 알림을 새로 시작했거나, 새 host/VLAN을 Bridge Port HiperSockets channel에 등록 또는 등록 해제했거나, 주소 알림을 중단했음을 나타냅니다. |
| `VLAN=numeric-vlan-id` | event가 발생한 VLAN ID입니다. VLAN이 관련되지 않으면 포함하지 않습니다. |
| `MAC=xx:xx:xx:xx:xx:xx` | HiperSockets channel에 등록하거나 등록 해제하는 host의 MAC 주소입니다. VLAN 생성 또는 제거 event에는 보고하지 않습니다. |
| `NTOK_BUSID=x.y.zzzz` | 장치 bus ID로 CSSID, SSID, device number를 담습니다. |
| `NTOK_IID=xx` | 장치 IID입니다. |
| `NTOK_CHPID=xx` | 장치 CHPID입니다. |
| `NTOK_CHID=xxxx` | 장치 channel ID입니다. |
`NTOK_*` 속성은 운영체제가 실행 중인 시스템에 연결된 장치가 아니라 다른 장치를 가리킵니다.
요약과 해설
qeth.rst:1-64qeth는 Bridge Port 상태가 바뀌거나 HiperSockets network에서 host 또는 VLAN을 등록·해제할 때 `ACTION=CHANGE` uevent를 발생시킵니다. 상태 event와 주소 알림 event는 서로 다른 속성 집합을 사용합니다.
`ROLE`과 `STATE`는 로컬 Bridge Port 상태를 설명하고, `BRIDGEDHOST`, `VLAN`, `MAC`, `NTOK_*`는 network의 다른 장치에 관한 주소 변경을 설명합니다.