What does "A valid specification for SNMP device detection" mean?

I’m looking at the help documentation for the plugin API on this page:
/check_mk/plugin-api/cmk.base.plugins.agent_based.agent_based_api/v1.html

This page shows all the options for the API. For the first items listed (“all_of” thru “matches”), the return value listed is:
“A valid specification for SNMP device detection”

What does that even mean? All eight of those items have the same return value? This seems odd (as well as confusing).

These all are used inside the detect function for SNMP services.
Here are a small example.

DETECT_2930M = matches(".1.3.6.1.2.1.1.1.0", "Aruba.+2930M.*")

register.snmp_section(
    name="aruba_fan_status",
    detect=all_of(
        DETECT_2930M,
        exists(".1.3.6.1.4.1.11.2.14.11.5.1.54.2.1.1.*"),
    ),
....

You see, it checks if an OID exists or has some defined content. “all_of” says nothing else that, all included conditions must be met.
Point 8.4 and following describe the whole detection process.

1 Like