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 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.