Changelog#

Revision 0.4.5, released 16-07-2024#

Copyright notice bumped up to year 2019
Fixed pysnmp/pyasn1 debugging flags print out in –help to work with newer pyasn1/pysnmp

Default daemon syslog service destination to a local socket
Updated documentation on daemons command-line options
Added snmpfwd, syslog and null destinations to the logger plugin, most parameters has been defaulted
Fixed timed log file rotation to respect log file creation time when computing next rotation time
Fixed possible file permission issues by initializing logger and plugin subsystems under reduced user privileges

SNMP error logging improved
Fixed snmpfwd-server crash when multiple SNMP credentials are configured for a single transport endpoint

Added IPv6 support to SNMP engines built into snmpfwd server and client effectively allowing IP version translation of the SNMP traffic
Added IPv6 support to trunk connections
Missing snmp-security-engine-id option implemented in the server part to make SNMPv3 TRAP forwarding operational
Added SNMPv2c->SNMPv3 command forwarder example configuration
TRAP forwarding examples made more versatile
Bumped upper Python version to 3.7
Fixed v1->v2c TRAP PDU translation in snmpfwd server

HMAC-SHA-2 authentication and strong AES encryption protocols support added
The pycryptodome dependency replaced with pycryptodomex as it is recommended by the upstream to avoid unwanted interference
Migrated references from SourceForge
Fixed crash during TRAPv1 handling at the server part
Sphinx docs layout updated

GETBULK PDU support added to the oidfilter plugin
Two-digit subsecond precision implemented across all logs
Unique, system-wide request identifier implemented under the name of callflow-id
System logging reworked for uniformity and usability
Fix to catch errors coming from SNMP engine when sending malformed message SNMP
Fix to snmp-peer-timeout option documentation and examples
Fix to the server to handle the case of missing response PDU coming from client

Built-in logging at different verbosity levels implemented (via new –log-level option)
Log SNMP authentication failures
Optionally log denied OIDs at the oidfilter plugin
Added timestamping to file log
The plugin-options setting fixed to support a list of options, as its name suggests
Fixed malformed timestamp logging at the logger plugin

Server message classifiers made available at the client side for message routing purposes
Trunk keep-alive service implemented
Client-side plugins support implemented
Examples and docs on transparent proxy mode and running at secondary interfaces added
Performance of the “oidfilter” plugin improved on large access lists by introducing dichotomy search and operating on built-in “tuple” type
Enforced “oidfilter” configuration consistency by adding a bunch of load-time checks

SNMP TRAP PDU forwarding implemented
SNMP PDU OIDs filtering plugin implemented
The “rewrite” plugin reworked to match OIDs and regexp values
The “logger” plugin refactored to understand more macros; macro names used for logging and system configuration options unified
Single SNMP request scope context is now served to the plugins (plugin API version bumped)
The ${config-dir} macro support added to some configuration options
Sphinx documentation added

Multiple fixes supporting Python 2.4-3.4 compatibility.
Configuration options renamed for better clarity.
Both source and destination network addresses of SNMP entities can now be used for message routing and address spoofing.
Transparent proxy operation and secondary network interface support implemented
Client-side SNMP timeout/retries now configurable
Switched to the latest pysnmp API
snmpEngineId and contextEngineId are always treated as hex in config
contextEngineId and contextName now configured separately from SNMP authentication credentials
Dead trunk detection implemented
Switched to Python logging module
SNMP request PDU type and request OIDs can now be used for request routing
Fix to SNMPv3 operation on the Client part.