mib-rs 0.8.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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

//! Notifications, groups, and compliance statements.

use mib_rs::Loader;

fn main() {
    let source = mib_rs::source::memory(
        "EXAMPLE-FULL-MIB",
        include_bytes!("../tests/data/example-full-mib.txt").as_slice(),
    );

    let mib = Loader::new()
        .source(source)
        .modules(["EXAMPLE-FULL-MIB"])
        .load()
        .expect("should load");

    // -- Notifications --
    println!("=== Notifications ===");

    // Look up a notification by name.
    let notif = mib
        .notification("exStatusChange")
        .expect("notification exists");
    println!("  {}", notif.name());
    println!("    OID:         {}", notif.node().unwrap().oid());
    println!("    Status:      {:?}", notif.status());
    println!("    Description: {}", notif.description());
    println!("    Objects:");
    for obj in notif.objects() {
        println!("      {}", obj.name());
    }

    let notif2 = mib
        .notification("exIfStatusChange")
        .expect("notification exists");
    println!("\n  {}", notif2.name());
    println!("    OID:     {}", notif2.node().unwrap().oid());
    println!(
        "    Objects: {:?}",
        notif2.objects().map(|o| o.name()).collect::<Vec<_>>()
    );

    // -- Enumerate all notifications in the user module --
    println!("\n  All notifications:");
    for notif in mib.notifications() {
        if notif.module().map(|m| m.name()) == Some("EXAMPLE-FULL-MIB") {
            println!("    {}", notif.name());
        }
    }

    // -- Object Groups --
    println!("\n=== Object Groups ===");
    let group = mib.group("exScalarGroup").expect("group exists");
    println!("  {}", group.name());
    println!("    OID:         {}", group.node().unwrap().oid());
    println!("    Status:      {:?}", group.status());
    println!("    Description: {}", group.description());
    println!(
        "    Is notification group: {}",
        group.is_notification_group()
    );
    println!("    Members:");
    for member in group.members() {
        println!("      {}", member.name());
    }

    // -- Notification Group --
    let ngroup = mib.group("exNotifGroup").expect("group exists");
    println!("\n  {}", ngroup.name());
    println!(
        "    Is notification group: {}",
        ngroup.is_notification_group()
    );
    println!("    Members:");
    for member in ngroup.members() {
        println!("      {}", member.name());
    }

    // -- Compliance --
    let compliance = mib
        .compliance("exBasicCompliance")
        .expect("compliance exists");
    println!("\n=== Compliance ===");
    println!("  {}", compliance.name());
    println!("    OID:         {}", compliance.node().unwrap().oid());
    println!("    Status:      {:?}", compliance.status());
    println!("    Description: {}", compliance.description());
    println!("    MODULE clauses: {}", compliance.modules().len());

    // -- Node-level cross references --
    // Nodes can tell you what's attached to them.
    let node = mib.resolve_node("exStatusChange").unwrap();
    println!("\n=== Node cross-references ===");
    println!("  Node: {}", node.name());
    println!("    Has notification: {}", node.notification().is_some());
    println!("    Has object:       {}", node.object().is_some());
    println!("    Has group:        {}", node.group().is_some());

    let node = mib.resolve_node("exScalarGroup").unwrap();
    println!("  Node: {}", node.name());
    println!("    Has group:        {}", node.group().is_some());

    let node = mib.resolve_node("exBasicCompliance").unwrap();
    println!("  Node: {}", node.name());
    println!("    Has compliance:   {}", node.compliance().is_some());
}