wire / wire-format / snmp-protocol
SNMP is a protocol for network management. Managers query agents on devices. Operations: Get (read), GetNext (read next), GetBulk (read many), Set (write), Trap (unsolicited notification), Inform (acknowledged notification). Data is organized in a MIB (Management Information Base) tree of OIDs (Object Identifiers). SNMPv3 adds authentication and encryption.
aka: SNMP (Simple Network Management Protocol)
spec: RFC 3411-3418 (SNMPv3)
SNMP is a protocol for network management. Managers query agents on devices. Operations: Get (read), GetNext (read next), GetBulk (read many), Set (write), Trap (unsolicited notification), Inform (acknowledged notification). Data is organized in a MIB (Management Information Base) tree of OIDs (Object Identifiers). SNMPv3 adds authentication and encryption.
| field | size | meaning |
|---|---|---|
| Get | PDU | Read a value: Get(varbind list). Returns the values. |
| GetNext | PDU | Read the next value in the MIB tree (lexicographic). Used for walking tables. |
| GetBulk | PDU (v2c/v3) | Read many values at once. More efficient than repeated GetNext. |
| Set | PDU | Write a value: Set(varbind list). Returns confirmation. |
| Trap | PDU | Unsolicited notification from agent to manager. E.g., linkDown, coldStart, authenticationFailure. |
| Inform | PDU (v2c/v3) | Acknowledged notification. Manager sends response. |
| OID | variable | Object Identifier: dotted decimal (e.g., 1.3.6.1.2.1.1.1.0 = sysDescr.0). Hierarchical tree. |
| Varbind | variable | Variable binding: OID + value (or NULL for Get). Value types: integer, string, counter, gauge, timeticks, OID, IP address, etc. |
| Community string | v1/v2c | Shared secret for authentication (plaintext, sent in every packet). 'public' is the default (insecure). |
| USM | v3 | User-based Security Model: username + auth protocol (MD5/SHA) + priv protocol (DES/AES). Replaces community strings. |
example:
00 00
SNMP (placeholder)
agent: curl -H 'accept: application/json' wire.phall.io/wire-format/snmp-protocol
or /wire-format/snmp-protocol.json