0001 =============================
0002 IBM s390 QDIO Ethernet Driver
0003 =============================
0004
0005 OSA and HiperSockets Bridge Port Support
0006 ========================================
0007
0008 Uevents
0009 -------
0010
0011 To generate the events the device must be assigned a role of either
0012 a primary or a secondary Bridge Port. For more information, see
0013 "z/VM Connectivity, SC24-6174".
0014
0015 When run on an OSA or HiperSockets Bridge Capable Port hardware, and the state
0016 of some configured Bridge Port device on the channel changes, a udev
0017 event with ACTION=CHANGE is emitted on behalf of the corresponding
0018 ccwgroup device. The event has the following attributes:
0019
0020 BRIDGEPORT=statechange
0021 indicates that the Bridge Port device changed
0022 its state.
0023
0024 ROLE={primary|secondary|none}
0025 the role assigned to the port.
0026
0027 STATE={active|standby|inactive}
0028 the newly assumed state of the port.
0029
0030 When run on HiperSockets Bridge Capable Port hardware with host address
0031 notifications enabled, a udev event with ACTION=CHANGE is emitted.
0032 It is emitted on behalf of the corresponding ccwgroup device when a host
0033 or a VLAN is registered or unregistered on the network served by the device.
0034 The event has the following attributes:
0035
0036 BRIDGEDHOST={reset|register|deregister|abort}
0037 host address
0038 notifications are started afresh, a new host or VLAN is registered or
0039 deregistered on the Bridge Port HiperSockets channel, or address
0040 notifications are aborted.
0041
0042 VLAN=numeric-vlan-id
0043 VLAN ID on which the event occurred. Not included
0044 if no VLAN is involved in the event.
0045
0046 MAC=xx:xx:xx:xx:xx:xx
0047 MAC address of the host that is being registered
0048 or deregistered from the HiperSockets channel. Not reported if the
0049 event reports the creation or destruction of a VLAN.
0050
0051 NTOK_BUSID=x.y.zzzz
0052 device bus ID (CSSID, SSID and device number).
0053
0054 NTOK_IID=xx
0055 device IID.
0056
0057 NTOK_CHPID=xx
0058 device CHPID.
0059
0060 NTOK_CHID=xxxx
0061 device channel ID.
0062
0063 Note that the `NTOK_*` attributes refer to devices other than the one
0064 connected to the system on which the OS is running.
