Documentation/s390/qeth.rst

   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.