LINK="#0000bb" VLINK="#551a8b" ALINK="#ff0000">

Multiple-session, synchronous I/O engine

The pysnmp.mapping.udp.bulkrole module implements network transport that performat synchronous, blocking I/O over multiple BSD sockets at a time. This code is intended to be used in situations where a large number of SNMP entities need to be talked with at about the same time (consider a poll against multiple routers for gathering statistics at a specific time as an example).

This module defines the following items:

class manager([iface])

Returns a new instance of manager class, representing a bulk of synchronous SNMP managers, each of which can be running against its own SNMP agent.

The instances of manager class expose a standard list interface, where list items must be tuples of (address, data, ctx) where:

  • address represents either destination or source address of SNMP party (in socket module notation)
  • data represents either request or response octet-stream (string)
  • ctx represents a reference to opaque user context to be passed back and forth on request submission and retrieval.

The iface parameter, if given, specifies the interface and port on local machine to bind() to. This argument must follow the socket module notation. All further requests would then be originated from the given interface/port.

The default for iface is ('', 0) what stands for binding to a primary interface at the local machine.

Methods of the above classes may raise exceptions based on error.SnmpOverUdpError base class.