salt.beacons.network_settings

Beacon to monitor network adapter setting changes on Linux

class salt.beacons.network_settings.Hashabledict

Helper class that implements a hash function for a dictionary

salt.beacons.network_settings.beacon(config)

Watch for changes on network settings

By default, the beacon will emit when there is a value change on one of the settings on watch. The config also support the onvalue parameter for each setting, which instruct the beacon to only emit if the setting changed to the value defined.

Example Config

beacons:
  network_settings:
    - interfaces:
        eth0:
          ipaddr:
          promiscuity:
            onvalue: 1
        eth1:
          linkmode:

The config above will check for value changes on eth0 ipaddr and eth1 linkmode. It will also emit if the promiscuity value changes to 1.

Beacon items can use the * wildcard to make a definition apply to several interfaces. For example an eth* would apply to all ethernet interfaces.

Setting the argument coalesce = True will combine all the beacon results on a single event. The example below shows how to trigger coalesced results:

beacons:
  network_settings:
    - coalesce: True
    - interfaces:
        eth0:
          ipaddr:
          promiscuity:

salt.beacons.network_settings.validate(config)

Validate the beacon configuration