Struct RequestContext 

pub struct RequestContext {
    pub source: SocketAddr,
    pub version: Version,
    pub security_model: SecurityModel,
    pub security_name: Bytes,
    pub security_level: SecurityLevel,
    pub context_name: Bytes,
    pub request_id: i32,
    pub pdu_type: PduType,
    pub group_name: Option<Bytes>,
    pub read_view: Option<Bytes>,
    pub write_view: Option<Bytes>,
    pub msg_max_size: Option<u32>,
}

Request context passed to MIB handlers.

Contains information about the incoming request for authorization decisions, including VACM-resolved access control information when VACM is enabled.

Fields

The context provides:

• Request origin: Source address and request ID
• Security info: Version, model, level, and security name (community/username)
• VACM info: Group name and view names (when VACM is configured)

Example

use async_snmp::handler::{MibHandler, RequestContext, GetResult, BoxFuture};
use async_snmp::{Oid, Value, oid};

struct LoggingHandler;

impl MibHandler for LoggingHandler {
    fn get<'a>(&'a self, ctx: &'a RequestContext, oid: &'a Oid) -> BoxFuture<'a, GetResult> {
        Box::pin(async move {
            // Log request details
            println!(
                "GET {} from {} (user: {:?}, version: {:?})",
                oid, ctx.source, ctx.security_name, ctx.version
            );

            if oid == &oid!(1, 3, 6, 1, 4, 1, 99999, 1, 0) {
                GetResult::Value(Value::Integer(42))
            } else {
                GetResult::NoSuchObject
            }
        })
    }

    fn get_next<'a>(
        &'a self,
        _ctx: &'a RequestContext,
        _oid: &'a Oid,
    ) -> BoxFuture<'a, async_snmp::handler::GetNextResult> {
        Box::pin(async { async_snmp::handler::GetNextResult::EndOfMibView })
    }
}

Fields

source: SocketAddr

Source address of the request.

Use this for logging or additional access control beyond VACM.

version: Version

SNMP version (V1, V2c, or V3).

security_model: SecurityModel

Security model used for this request.

• V1 for SNMPv1 community-based
• V2c for SNMPv2c community-based
• Usm for SNMPv3 User-based Security Model

security_name: Bytes

Security name (community string or USM username).

For v1/v2c: the community string For v3: the USM username

security_level: SecurityLevel

Security level (v3 only, NoAuthNoPriv for v1/v2c).

Indicates whether authentication and/or privacy were used.

context_name: Bytes

Context name (v3 only, empty for v1/v2c).

SNMPv3 contexts allow partitioning MIB views.

request_id: i32

Request ID from the PDU.

Useful for correlating requests with responses in logs.

pdu_type: PduType

PDU type (GetRequest, GetNextRequest, SetRequest, etc.).

group_name: Option<Bytes>

Resolved group name (if VACM enabled).

Set when VACM successfully maps the security name to a group.

read_view: Option<Bytes>

Read view name (if VACM enabled).

The view that controls which OIDs can be read.

write_view: Option<Bytes>

Write view name (if VACM enabled).

The view that controls which OIDs can be written.

msg_max_size: Option<u32>

Client-advertised maximum message size (V3 only).

For SNMPv3 requests, this is the msgMaxSize from the V3 message header, indicating the largest message the client can accept. The agent should limit response sizes to min(agent_max, msg_max_size).

None for v1/v2c requests (no msgMaxSize field in those versions).

Implementations

impl RequestContext

pub fn test_context() -> Self

Create a minimal context for unit testing.

Trait Implementations

impl Clone for RequestContext

fn clone(&self) -> RequestContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.