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