mib-rs 0.10.0

SNMP MIB parser and resolver
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

//! Shared resolver fallback rules used by resolution and structured tracing.

use crate::types::{ResolutionDomain, ResolverStrictness};

pub(crate) fn intrinsic_foundation_module(
    domain: ResolutionDomain,
    symbol: &str,
) -> Option<&'static str> {
    match domain {
        ResolutionDomain::Type
            if matches!(
                symbol,
                "INTEGER" | "OCTET STRING" | "OBJECT IDENTIFIER" | "BITS"
            ) =>
        {
            Some("SNMPv2-SMI")
        }
        ResolutionDomain::Oid if matches!(symbol, "iso" | "ccitt" | "joint-iso-ccitt") => {
            Some("SNMPv2-SMI")
        }
        _ => None,
    }
}

pub(crate) fn constrained_foundation_modules(
    domain: ResolutionDomain,
    strictness: ResolverStrictness,
) -> &'static [&'static str] {
    if !strictness.allow_constrained_fallbacks() {
        return &[];
    }
    match domain {
        ResolutionDomain::Type => &["SNMPv2-SMI", "RFC1155-SMI", "SNMPv2-TC"],
        ResolutionDomain::Oid => &["SNMPv2-SMI", "RFC1155-SMI"],
        ResolutionDomain::Object
        | ResolutionDomain::GroupMember
        | ResolutionDomain::Index
        | ResolutionDomain::NotificationObject
        | ResolutionDomain::Conformance => &[],
    }
}

pub(crate) fn allows_global_fallback(
    domain: ResolutionDomain,
    strictness: ResolverStrictness,
) -> bool {
    strictness.allow_global_fallbacks()
        && matches!(
            domain,
            ResolutionDomain::Object
                | ResolutionDomain::GroupMember
                | ResolutionDomain::Index
                | ResolutionDomain::NotificationObject
                | ResolutionDomain::Conformance
        )
}

pub(crate) fn is_bare_index_type(symbol: &str) -> bool {
    matches!(
        symbol,
        "INTEGER"
            | "OCTET STRING"
            | "BITS"
            | "Integer32"
            | "Counter32"
            | "Counter64"
            | "Gauge32"
            | "Unsigned32"
            | "TimeTicks"
            | "IpAddress"
            | "Opaque"
            | "Counter"
            | "Gauge"
            | "NetworkAddress"
    )
}

pub(crate) fn fallback_domain(domain: ResolutionDomain, symbol: &str) -> ResolutionDomain {
    if domain == ResolutionDomain::Index && is_bare_index_type(symbol) {
        ResolutionDomain::Type
    } else {
        domain
    }
}

pub(crate) fn allows_trap_enterprise_fallback(strictness: ResolverStrictness) -> bool {
    strictness.allow_constrained_fallbacks()
}