xref: /openbmc/linux/Documentation/arch/s390/qeth.rst (revision 22b6e7f3)
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.
65