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