qeth.rst 2.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. =============================
  2. IBM s390 QDIO Ethernet Driver
  3. =============================
  4. OSA and HiperSockets Bridge Port Support
  5. ========================================
  6. Uevents
  7. -------
  8. To generate the events the device must be assigned a role of either
  9. a primary or a secondary Bridge Port. For more information, see
  10. "z/VM Connectivity, SC24-6174".
  11. When run on an OSA or HiperSockets Bridge Capable Port hardware, and the state
  12. of some configured Bridge Port device on the channel changes, a udev
  13. event with ACTION=CHANGE is emitted on behalf of the corresponding
  14. ccwgroup device. The event has the following attributes:
  15. BRIDGEPORT=statechange
  16. indicates that the Bridge Port device changed
  17. its state.
  18. ROLE={primary|secondary|none}
  19. the role assigned to the port.
  20. STATE={active|standby|inactive}
  21. the newly assumed state of the port.
  22. When run on HiperSockets Bridge Capable Port hardware with host address
  23. notifications enabled, a udev event with ACTION=CHANGE is emitted.
  24. It is emitted on behalf of the corresponding ccwgroup device when a host
  25. or a VLAN is registered or unregistered on the network served by the device.
  26. The event has the following attributes:
  27. BRIDGEDHOST={reset|register|deregister|abort}
  28. host address
  29. notifications are started afresh, a new host or VLAN is registered or
  30. deregistered on the Bridge Port HiperSockets channel, or address
  31. notifications are aborted.
  32. VLAN=numeric-vlan-id
  33. VLAN ID on which the event occurred. Not included
  34. if no VLAN is involved in the event.
  35. MAC=xx:xx:xx:xx:xx:xx
  36. MAC address of the host that is being registered
  37. or deregistered from the HiperSockets channel. Not reported if the
  38. event reports the creation or destruction of a VLAN.
  39. NTOK_BUSID=x.y.zzzz
  40. device bus ID (CSSID, SSID and device number).
  41. NTOK_IID=xx
  42. device IID.
  43. NTOK_CHPID=xx
  44. device CHPID.
  45. NTOK_CHID=xxxx
  46. device channel ID.
  47. Note that the `NTOK_*` attributes refer to devices other than the one
  48. connected to the system on which the OS is running.