xref: /openbmc/linux/Documentation/arch/s390/qeth.rst (revision 37002bc6)
1*37002bc6SCosta Shulyupin=============================
2*37002bc6SCosta ShulyupinIBM s390 QDIO Ethernet Driver
3*37002bc6SCosta Shulyupin=============================
4*37002bc6SCosta Shulyupin
5*37002bc6SCosta ShulyupinOSA and HiperSockets Bridge Port Support
6*37002bc6SCosta Shulyupin========================================
7*37002bc6SCosta Shulyupin
8*37002bc6SCosta ShulyupinUevents
9*37002bc6SCosta Shulyupin-------
10*37002bc6SCosta Shulyupin
11*37002bc6SCosta ShulyupinTo generate the events the device must be assigned a role of either
12*37002bc6SCosta Shulyupina primary or a secondary Bridge Port. For more information, see
13*37002bc6SCosta Shulyupin"z/VM Connectivity, SC24-6174".
14*37002bc6SCosta Shulyupin
15*37002bc6SCosta ShulyupinWhen run on an OSA or HiperSockets Bridge Capable Port hardware, and the state
16*37002bc6SCosta Shulyupinof some configured Bridge Port device on the channel changes, a udev
17*37002bc6SCosta Shulyupinevent with ACTION=CHANGE is emitted on behalf of the corresponding
18*37002bc6SCosta Shulyupinccwgroup device. The event has the following attributes:
19*37002bc6SCosta Shulyupin
20*37002bc6SCosta ShulyupinBRIDGEPORT=statechange
21*37002bc6SCosta Shulyupin  indicates that the Bridge Port device changed
22*37002bc6SCosta Shulyupin  its state.
23*37002bc6SCosta Shulyupin
24*37002bc6SCosta ShulyupinROLE={primary|secondary|none}
25*37002bc6SCosta Shulyupin  the role assigned to the port.
26*37002bc6SCosta Shulyupin
27*37002bc6SCosta ShulyupinSTATE={active|standby|inactive}
28*37002bc6SCosta Shulyupin  the newly assumed state of the port.
29*37002bc6SCosta Shulyupin
30*37002bc6SCosta ShulyupinWhen run on HiperSockets Bridge Capable Port hardware with host address
31*37002bc6SCosta Shulyupinnotifications enabled, a udev event with ACTION=CHANGE is emitted.
32*37002bc6SCosta ShulyupinIt is emitted on behalf of the corresponding ccwgroup device when a host
33*37002bc6SCosta Shulyupinor a VLAN is registered or unregistered on the network served by the device.
34*37002bc6SCosta ShulyupinThe event has the following attributes:
35*37002bc6SCosta Shulyupin
36*37002bc6SCosta ShulyupinBRIDGEDHOST={reset|register|deregister|abort}
37*37002bc6SCosta Shulyupin  host address
38*37002bc6SCosta Shulyupin  notifications are started afresh, a new host or VLAN is registered or
39*37002bc6SCosta Shulyupin  deregistered on the Bridge Port HiperSockets channel, or address
40*37002bc6SCosta Shulyupin  notifications are aborted.
41*37002bc6SCosta Shulyupin
42*37002bc6SCosta ShulyupinVLAN=numeric-vlan-id
43*37002bc6SCosta Shulyupin  VLAN ID on which the event occurred. Not included
44*37002bc6SCosta Shulyupin  if no VLAN is involved in the event.
45*37002bc6SCosta Shulyupin
46*37002bc6SCosta ShulyupinMAC=xx:xx:xx:xx:xx:xx
47*37002bc6SCosta Shulyupin  MAC address of the host that is being registered
48*37002bc6SCosta Shulyupin  or deregistered from the HiperSockets channel. Not reported if the
49*37002bc6SCosta Shulyupin  event reports the creation or destruction of a VLAN.
50*37002bc6SCosta Shulyupin
51*37002bc6SCosta ShulyupinNTOK_BUSID=x.y.zzzz
52*37002bc6SCosta Shulyupin  device bus ID (CSSID, SSID and device number).
53*37002bc6SCosta Shulyupin
54*37002bc6SCosta ShulyupinNTOK_IID=xx
55*37002bc6SCosta Shulyupin  device IID.
56*37002bc6SCosta Shulyupin
57*37002bc6SCosta ShulyupinNTOK_CHPID=xx
58*37002bc6SCosta Shulyupin  device CHPID.
59*37002bc6SCosta Shulyupin
60*37002bc6SCosta ShulyupinNTOK_CHID=xxxx
61*37002bc6SCosta Shulyupin  device channel ID.
62*37002bc6SCosta Shulyupin
63*37002bc6SCosta ShulyupinNote that the `NTOK_*` attributes refer to devices other than  the one
64*37002bc6SCosta Shulyupinconnected to the system on which the OS is running.
65