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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

//! Table navigation: rows, columns, indexes, and object kind predicates.

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");

    // -- Find all tables --
    println!("=== Tables ===");
    for table in mib.tables() {
        println!("  {} ({})", table.name(), table.node().oid());
    }

    // -- Table structure --
    let table = mib.object("exIfTable").unwrap();
    println!("\n=== exIfTable structure ===");
    println!("  Is table:  {}", table.is_table());
    println!("  Kind:      {:?}", table.kind());

    // Get the row entry
    let row = table.row().expect("table should have a row");
    println!("\n  Row: {}", row.name());
    println!("    Is row:  {}", row.is_row());

    // Navigate back to the table from the row
    let back = row.table().expect("row should reference table");
    assert_eq!(back.name(), table.name());

    // -- Columns --
    println!("\n  Columns:");
    for col in table.columns() {
        let ty = col.ty().map(|t| t.name().to_string()).unwrap_or_default();
        println!(
            "    {:<20} {:?} type={:<20} index={}",
            col.name(),
            col.access(),
            ty,
            col.is_index(),
        );
        assert!(col.is_column());
    }

    // Navigate from a column back to its row and table.
    let col = mib.object("exIfName").unwrap();
    let col_row = col.row().expect("column should have a row");
    let col_table = col.table().expect("column should have a table");
    println!(
        "\n  exIfName -> row={}, table={}",
        col_row.name(),
        col_table.name()
    );

    // -- Indexes --
    println!("\n=== Indexes ===");
    let indexes: Vec<_> = row.effective_indexes().collect();
    for idx in &indexes {
        let obj = idx.object().expect("index object");
        let ty = idx.ty().expect("index type");
        println!("  {}", idx.name());
        println!("    Object:   {}", obj.name());
        println!(
            "    Type:     {} (base={:?})",
            ty.name(),
            ty.effective_base()
        );
        println!("    Implied:  {}", idx.implied());
        println!("    Encoding: {:?}", idx.encoding());
        println!("    Row:      {}", idx.row().name());
    }

    // -- All scalars --
    println!("\n=== Scalars ===");
    for scalar in mib.scalars() {
        let ty_name = scalar
            .ty()
            .map(|t| t.name().to_string())
            .unwrap_or_default();
        println!(
            "  {:<20} {:<20} {:?}",
            scalar.name(),
            ty_name,
            scalar.access(),
        );
        assert!(scalar.is_scalar());
    }

    // -- All rows --
    println!("\n=== Rows ===");
    for row in mib.rows() {
        let idx_names: Vec<_> = row
            .effective_indexes()
            .map(|i| i.name().to_string())
            .collect();
        println!("  {:<20} indexes=[{}]", row.name(), idx_names.join(", "));
    }

    // -- All columns --
    println!("\n=== All columns ===");
    for col in mib.columns() {
        println!(
            "  {:<20} table={}",
            col.name(),
            col.table()
                .map(|t| t.name().to_string())
                .unwrap_or_default(),
        );
    }

    // -- Object kind filtering --
    println!("\n=== Object counts by kind ===");
    println!("  Tables:  {}", mib.tables().count());
    println!("  Rows:    {}", mib.rows().count());
    println!("  Columns: {}", mib.columns().count());
    println!("  Scalars: {}", mib.scalars().count());
}