| David Brazdil | 0f672f6 | 2019-12-10 10:32:29 +0000 | [diff] [blame^] | 1 | ============================= |
| 2 | IBM s390 QDIO Ethernet Driver |
| 3 | ============================= |
| 4 | |
| 5 | OSA and HiperSockets Bridge Port Support |
| 6 | ======================================== |
| 7 | |
| 8 | Uevents |
| 9 | ------- |
| 10 | |
| 11 | To generate the events the device must be assigned a role of either |
| 12 | a primary or a secondary Bridge Port. For more information, see |
| 13 | "z/VM Connectivity, SC24-6174". |
| 14 | |
| 15 | When run on an OSA or HiperSockets Bridge Capable Port hardware, and the state |
| 16 | of some configured Bridge Port device on the channel changes, a udev |
| 17 | event with ACTION=CHANGE is emitted on behalf of the corresponding |
| 18 | ccwgroup device. The event has the following attributes: |
| 19 | |
| 20 | BRIDGEPORT=statechange |
| 21 | indicates that the Bridge Port device changed |
| 22 | its state. |
| 23 | |
| 24 | ROLE={primary|secondary|none} |
| 25 | the role assigned to the port. |
| 26 | |
| 27 | STATE={active|standby|inactive} |
| 28 | the newly assumed state of the port. |
| 29 | |
| 30 | When run on HiperSockets Bridge Capable Port hardware with host address |
| 31 | notifications enabled, a udev event with ACTION=CHANGE is emitted. |
| 32 | It is emitted on behalf of the corresponding ccwgroup device when a host |
| 33 | or a VLAN is registered or unregistered on the network served by the device. |
| 34 | The event has the following attributes: |
| 35 | |
| 36 | BRIDGEDHOST={reset|register|deregister|abort} |
| 37 | host address |
| 38 | notifications are started afresh, a new host or VLAN is registered or |
| 39 | deregistered on the Bridge Port HiperSockets channel, or address |
| 40 | notifications are aborted. |
| 41 | |
| 42 | VLAN=numeric-vlan-id |
| 43 | VLAN ID on which the event occurred. Not included |
| 44 | if no VLAN is involved in the event. |
| 45 | |
| 46 | MAC=xx:xx:xx:xx:xx:xx |
| 47 | MAC address of the host that is being registered |
| 48 | or deregistered from the HiperSockets channel. Not reported if the |
| 49 | event reports the creation or destruction of a VLAN. |
| 50 | |
| 51 | NTOK_BUSID=x.y.zzzz |
| 52 | device bus ID (CSSID, SSID and device number). |
| 53 | |
| 54 | NTOK_IID=xx |
| 55 | device IID. |
| 56 | |
| 57 | NTOK_CHPID=xx |
| 58 | device CHPID. |
| 59 | |
| 60 | NTOK_CHID=xxxx |
| 61 | device channel ID. |
| 62 | |
| 63 | Note that the `NTOK_*` attributes refer to devices other than the one |
| 64 | connected to the system on which the OS is running. |