Struct Agent 

pub struct Agent { /* private fields */ }

SNMP Agent.

Listens for and responds to SNMP requests (GET, GETNEXT, GETBULK, SET).

Example

use async_snmp::agent::Agent;
use async_snmp::oid;

let agent = Agent::builder()
    .bind("0.0.0.0:161")
    .community(b"public")
    .build()
    .await?;

agent.run().await

Implementations

impl Agent

pub fn builder() -> AgentBuilder

Create a builder for configuring the agent.

pub fn local_addr(&self) -> SocketAddr

Get the local address the agent is bound to.

pub fn engine_id(&self) -> &[u8]

Get the engine ID.

pub fn cancel(&self) -> CancellationToken

Get the cancellation token for this agent.

Call token.cancel() to initiate graceful shutdown.

pub fn snmp_invalid_msgs(&self) -> u32

Get the snmpInvalidMsgs counter value.

This counter tracks messages with invalid msgFlags, such as privacy-without-authentication (RFC 3412 Section 7.2 Step 5d).

OID: 1.3.6.1.6.3.11.2.1.2

pub fn snmp_unknown_security_models(&self) -> u32

Get the snmpUnknownSecurityModels counter value.

This counter tracks messages with unrecognized security models (RFC 3412 Section 7.2 Step 2).

OID: 1.3.6.1.6.3.11.2.1.1

pub fn snmp_silent_drops(&self) -> u32

Get the snmpSilentDrops counter value.

This counter tracks confirmed-class PDUs (GetRequest, GetNextRequest, GetBulkRequest, SetRequest, InformRequest) that were silently dropped because even an empty Response-PDU would exceed the maximum message size constraint (RFC 3412 Section 7.1).

OID: 1.3.6.1.6.3.11.2.1.3

pub fn usm_unknown_engine_ids(&self) -> u32

Get the usmStatsUnknownEngineIDs counter value.

This counter tracks messages with unknown engine IDs. Incremented when a non-discovery request arrives with an engine ID that does not match the local engine (RFC 3414 Section 3.2 Step 3).

OID: 1.3.6.1.6.3.15.1.1.4

pub fn usm_unknown_usernames(&self) -> u32

Get the usmStatsUnknownUserNames counter value.

This counter tracks messages with unknown user names. Incremented when a message arrives with a user name not in the local user database (RFC 3414 Section 3.2 Step 1).

OID: 1.3.6.1.6.3.15.1.1.3

pub fn usm_wrong_digests(&self) -> u32

Get the usmStatsWrongDigests counter value.

This counter tracks messages with incorrect authentication digests, as well as messages where the user has no auth key configured. (RFC 3414 Section 3.2 Steps 6 and 7).

OID: 1.3.6.1.6.3.15.1.1.5

pub fn usm_not_in_time_windows(&self) -> u32

Get the usmStatsNotInTimeWindows counter value.

This counter tracks messages that fall outside the time window. Incremented when the message time differs from the local time by more than 150 seconds (RFC 3414 Section 3.2 Step 8).

OID: 1.3.6.1.6.3.15.1.1.2

pub async fn run(&self) -> Result<()>

Run the agent, processing requests concurrently.

Requests are processed in parallel up to the configured max_concurrent_requests limit (default: 1000). This method runs until the cancellation token is triggered.

Trait Implementations

impl Clone for Agent

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.