]> git.ipfire.org Git - thirdparty/linux.git/blame - Documentation/s390/qeth.rst
Merge branch 'x86-urgent-for-linus' of git://git.kernel.org/pub/scm/linux/kernel...
[thirdparty/linux.git] / Documentation / s390 / qeth.rst
CommitLineData
8b4a503d 1=============================
b4d72c08 2IBM s390 QDIO Ethernet Driver
8b4a503d 3=============================
b4d72c08 4
9c23f4da 5OSA and HiperSockets Bridge Port Support
8b4a503d 6========================================
b4d72c08
EC
7
8Uevents
8b4a503d 9-------
b4d72c08
EC
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
9c23f4da 15When run on an OSA or HiperSockets Bridge Capable Port hardware, and the state
b4d72c08
EC
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
8b4a503d
MCC
20BRIDGEPORT=statechange
21 indicates that the Bridge Port device changed
b4d72c08
EC
22 its state.
23
8b4a503d
MCC
24ROLE={primary|secondary|none}
25 the role assigned to the port.
b4d72c08 26
8b4a503d
MCC
27STATE={active|standby|inactive}
28 the newly assumed state of the port.
9f48b9db
EC
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
8b4a503d
MCC
36BRIDGEDHOST={reset|register|deregister|abort}
37 host address
9f48b9db
EC
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
8b4a503d
MCC
42VLAN=numeric-vlan-id
43 VLAN ID on which the event occurred. Not included
9f48b9db
EC
44 if no VLAN is involved in the event.
45
8b4a503d
MCC
46MAC=xx:xx:xx:xx:xx:xx
47 MAC address of the host that is being registered
9f48b9db
EC
48 or deregistered from the HiperSockets channel. Not reported if the
49 event reports the creation or destruction of a VLAN.
50
8b4a503d
MCC
51NTOK_BUSID=x.y.zzzz
52 device bus ID (CSSID, SSID and device number).
9f48b9db 53
8b4a503d
MCC
54NTOK_IID=xx
55 device IID.
9f48b9db 56
8b4a503d
MCC
57NTOK_CHPID=xx
58 device CHPID.
9f48b9db 59
8b4a503d
MCC
60NTOK_CHID=xxxx
61 device channel ID.
9f48b9db 62
8b4a503d 63Note that the `NTOK_*` attributes refer to devices other than the one
9f48b9db 64connected to the system on which the OS is running.