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.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.