ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/cvsroot/AnyEvent-SNMP/README
(Generate patch)

Comparing cvsroot/AnyEvent-SNMP/README (file contents):
Revision 1.3 by root, Sun Apr 19 11:06:21 2009 UTC vs.
Revision 1.5 by root, Wed Jan 6 10:43:20 2010 UTC

1NAME 1NAME
2 AnyEvent::SNMP - adaptor to integrate Net::SNMP into Anyevent. 2 AnyEvent::SNMP - adaptor to integrate Net::SNMP into AnyEvent.
3 3
4SYNOPSIS 4SYNOPSIS
5 use AnyEvent::SNMP; 5 use AnyEvent::SNMP;
6 use Net::SNMP; 6 use Net::SNMP;
7 7
42 requests with Net::SNMP*. It is recommended but not required to load 42 requests with Net::SNMP*. It is recommended but not required to load
43 this module before "Net::SNMP". 43 this module before "Net::SNMP".
44 44
45GLOBAL VARIABLES 45GLOBAL VARIABLES
46 $AnyEvent::SNMP::MAX_OUTSTANDING (default: 50, dynamic) 46 $AnyEvent::SNMP::MAX_OUTSTANDING (default: 50, dynamic)
47 AnyEvent::SNMP::set_max_outstanding $new_value
47 Use this package variable to restrict the number of outstanding SNMP 48 Use this package variable to restrict the number of outstanding SNMP
48 requests at any point in time. 49 requests at any point in time.
49 50
50 Net::SNMP is very fast at creating and sending SNMP requests, but 51 Net::SNMP is very fast at creating and sending SNMP requests, but
51 much slower at parsing (big, bulk) responses. This makes it easy to 52 much slower at parsing (big, bulk) responses. This makes it easy to
65 latency and the speed of your SNMP agents. 66 latency and the speed of your SNMP agents.
66 67
67 AnyEvent::SNMP tries to dynamically adjust this number dynamically 68 AnyEvent::SNMP tries to dynamically adjust this number dynamically
68 upwards and downwards. 69 upwards and downwards.
69 70
71 Increasing $MAX_OUTSTANDING will not automatically use the extra
72 request slots. To increase $MAX_OUTSTANDING and make
73 "AnyEvent::SNMP" make use of the extra paralellity, call
74 "AnyEvent::SNMP::set_max_outstanding" with the new value, e.g.:
75
76 AnyEvent::SNMP::set_max_outstanding 500;
77
78 Although due to the dynamic adjustment, this might have little
79 lasting effect.
80
70 Note that you can use Net::SNMP::XS to speed up parsing of responses 81 Note that you can use Net::SNMP::XS to speed up parsing of responses
71 considerably. 82 considerably.
72 83
73 $AnyEvent::SNMP::MIN_RECVQUEUE (default: 4) 84 $AnyEvent::SNMP::MIN_RECVQUEUE (default: 8)
74 $AnyEvent::SNMP::MAX_RECVQUEUE (default: 64) 85 $AnyEvent::SNMP::MAX_RECVQUEUE (default: 64)
75 These values specify the minimum and maximum receive queue length 86 These values specify the minimum and maximum receive queue length
76 (in units of one response packet). 87 (in units of one response packet).
77 88
78 When AnyEvent::SNMP handles $MAX_RECVQUEUE or more packets per 89 When AnyEvent::SNMP handles $MAX_RECVQUEUE or more packets per

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines