snmp_notify.h File Reference

Notifications: the SNMPv2-Trap-PDU and the InformRequest-PDU (PROTOCORE_ENABLE_SNMP_TRAP). More...

#include "protocore_config.h"

Go to the source code of this file.

Detailed Description

Notifications: the SNMPv2-Trap-PDU and the InformRequest-PDU (PROTOCORE_ENABLE_SNMP_TRAP).

The notification originator side of the agent: an event is pushed to a notification receiver instead of waiting to be polled.

RFC 3416 sec 4.2.6 defines the SNMPv2-Trap-PDU and sec 4.2.7 the InformRequest-PDU. Both carry the same two mandatory first variable-bindings: sysUpTime.0 and snmpTrapOID.0 (RFC 3418 sec 2), followed by whatever bindings the caller adds. The two differ in confirmation, not in shape: a trap is unacknowledged, while an InformRequest-PDU is answered by a Response-PDU that echoes its request-id, so its sender owns the retransmission.

RFC 3417 sec 3.2 suggests notification receivers listen on UDP port 162.

The build calls are pure: message octets in a caller buffer, no socket and no clock, so they are unit-tested with no network stack under them. The send calls add the address parse and the datagram. SNMPv3 USM notifications are the v3 layer's, reached through ::SnmpV3.

Author

Douglas Quigg (dstroy0)

Date

2026

Definition in file snmp_notify.h.