xref: /OK3568_Linux_fs/kernel/Documentation/s390/qeth.rst (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun=============================
2*4882a593SmuzhiyunIBM s390 QDIO Ethernet Driver
3*4882a593Smuzhiyun=============================
4*4882a593Smuzhiyun
5*4882a593SmuzhiyunOSA and HiperSockets Bridge Port Support
6*4882a593Smuzhiyun========================================
7*4882a593Smuzhiyun
8*4882a593SmuzhiyunUevents
9*4882a593Smuzhiyun-------
10*4882a593Smuzhiyun
11*4882a593SmuzhiyunTo generate the events the device must be assigned a role of either
12*4882a593Smuzhiyuna primary or a secondary Bridge Port. For more information, see
13*4882a593Smuzhiyun"z/VM Connectivity, SC24-6174".
14*4882a593Smuzhiyun
15*4882a593SmuzhiyunWhen run on an OSA or HiperSockets Bridge Capable Port hardware, and the state
16*4882a593Smuzhiyunof some configured Bridge Port device on the channel changes, a udev
17*4882a593Smuzhiyunevent with ACTION=CHANGE is emitted on behalf of the corresponding
18*4882a593Smuzhiyunccwgroup device. The event has the following attributes:
19*4882a593Smuzhiyun
20*4882a593SmuzhiyunBRIDGEPORT=statechange
21*4882a593Smuzhiyun  indicates that the Bridge Port device changed
22*4882a593Smuzhiyun  its state.
23*4882a593Smuzhiyun
24*4882a593SmuzhiyunROLE={primary|secondary|none}
25*4882a593Smuzhiyun  the role assigned to the port.
26*4882a593Smuzhiyun
27*4882a593SmuzhiyunSTATE={active|standby|inactive}
28*4882a593Smuzhiyun  the newly assumed state of the port.
29*4882a593Smuzhiyun
30*4882a593SmuzhiyunWhen run on HiperSockets Bridge Capable Port hardware with host address
31*4882a593Smuzhiyunnotifications enabled, a udev event with ACTION=CHANGE is emitted.
32*4882a593SmuzhiyunIt is emitted on behalf of the corresponding ccwgroup device when a host
33*4882a593Smuzhiyunor a VLAN is registered or unregistered on the network served by the device.
34*4882a593SmuzhiyunThe event has the following attributes:
35*4882a593Smuzhiyun
36*4882a593SmuzhiyunBRIDGEDHOST={reset|register|deregister|abort}
37*4882a593Smuzhiyun  host address
38*4882a593Smuzhiyun  notifications are started afresh, a new host or VLAN is registered or
39*4882a593Smuzhiyun  deregistered on the Bridge Port HiperSockets channel, or address
40*4882a593Smuzhiyun  notifications are aborted.
41*4882a593Smuzhiyun
42*4882a593SmuzhiyunVLAN=numeric-vlan-id
43*4882a593Smuzhiyun  VLAN ID on which the event occurred. Not included
44*4882a593Smuzhiyun  if no VLAN is involved in the event.
45*4882a593Smuzhiyun
46*4882a593SmuzhiyunMAC=xx:xx:xx:xx:xx:xx
47*4882a593Smuzhiyun  MAC address of the host that is being registered
48*4882a593Smuzhiyun  or deregistered from the HiperSockets channel. Not reported if the
49*4882a593Smuzhiyun  event reports the creation or destruction of a VLAN.
50*4882a593Smuzhiyun
51*4882a593SmuzhiyunNTOK_BUSID=x.y.zzzz
52*4882a593Smuzhiyun  device bus ID (CSSID, SSID and device number).
53*4882a593Smuzhiyun
54*4882a593SmuzhiyunNTOK_IID=xx
55*4882a593Smuzhiyun  device IID.
56*4882a593Smuzhiyun
57*4882a593SmuzhiyunNTOK_CHPID=xx
58*4882a593Smuzhiyun  device CHPID.
59*4882a593Smuzhiyun
60*4882a593SmuzhiyunNTOK_CHID=xxxx
61*4882a593Smuzhiyun  device channel ID.
62*4882a593Smuzhiyun
63*4882a593SmuzhiyunNote that the `NTOK_*` attributes refer to devices other than  the one
64*4882a593Smuzhiyunconnected to the system on which the OS is running.
65