Launching scripts depending on you direct neighbors
MindYourNeighbors basically parse the ip-neighbor and, if results are found that are not excluded by the configuration, a configured command will be launched once.
The original use case :
A linux box used as a router as well as a home server. On this box runs several pieces of software which can be very bandwith consuming (ie: transmission). I wanted to shut down this software when other users were using the network.
MindYourNeighbors behavior's can be controlled through configuration file placed either in ~/.config/mind_your_neighbords.conf or in /etc/mind_your_neighbords.conf.
The configuration file is organized in sections. The DEFAULT section holds the default options which will be inherited by all the other sections (except for the logging level and the cache file path). All the other section will be read one by one ; each time the condition defined in filter_on is matched and isn't excluded by those defined in exclude the cache will be filled with either a marker neighbor or a marker no neighbor.
Cache length can't exceed the threshold, as only the REACHABLE lines in the result of the ip neigh command are taken in account and as those lines vary quite a bit, the threshold parameter allows you to configure how quickly a change of state can occure.
When the cache is filled the only neighbor or no neighbor markers, the corresponding command is executed once.
loglevel: allows you to choose the verbosity level in the syslog between DEBUG, INFO, WARN, ERROR and FATAL.cache_file: the path to the file where MindYourNeighbors will store its cache.threshold: the number of consecutive matches (or un matches) it takes for MindYourNeighbors to execute the "match" or "no match" command.filter_on: a regex to filters lines from the ip neigh command.exclude: a comma separated list of string. If one of those string should be found in a ip neigh line, it should be excluded.command_match: A command to execute when the cache has been filed with neighbor marker.command_no_match: A command to execute when the cache has been filed with no neighbor marker.device: if none provide the ip neigh command will be parsed else ip neigh show dev <device>.enable: a boolean (true or false), enabling or disabling a section.nslookup: a boolean (true or false), making MindYourNeighbors looking up domain names for IP it'll print in the logs. Can be useful for debuging.error_on_stderr: a boolean (true or false); if true and the command print something on stderr, the command will be ignored and executed again.