| … | |
… | |
| 23 | my @result = $cv->wait; |
23 | my @result = $cv->wait; |
| 24 | |
24 | |
| 25 | =head1 DESCRIPTION |
25 | =head1 DESCRIPTION |
| 26 | |
26 | |
| 27 | This module implements an alternative "event dispatcher" for Net::SNMP, |
27 | This module implements an alternative "event dispatcher" for Net::SNMP, |
| 28 | using AnyEvent as a backend. |
28 | using AnyEvent as a backend. This integrates Net::SNMP into AnyEvent. That |
| 29 | |
29 | means you can make non-blocking Net::SNMP calls and as long as other |
| 30 | This integrates Net::SNMP into AnyEvent: You can make non-blocking |
30 | parts of your program also use AnyEvent (or some event loop supported by |
| 31 | Net::SNMP calls and as long as other parts of your program also use |
31 | AnyEvent), they will run in parallel. |
| 32 | AnyEvent (or some event loop supported by AnyEvent), they will run in |
|
|
| 33 | parallel. |
|
|
| 34 | |
32 | |
| 35 | Also, the Net::SNMP scheduler is very inefficient with respect to both CPU |
33 | Also, the Net::SNMP scheduler is very inefficient with respect to both CPU |
| 36 | and memory usage. Most AnyEvent backends (including the pure-perl backend) |
34 | and memory usage. Most AnyEvent backends (including the pure-perl backend) |
| 37 | fare much better than the Net::SNMP dispatcher. |
35 | fare much better than the Net::SNMP dispatcher. |
| 38 | |
36 | |
|
|
37 | Another major added fetaure of this module over Net::SNMP is automatic |
|
|
38 | rate-adjustments: Net::SNMP is so slow that firing a few thousand |
|
|
39 | requests can cause many timeouts simply because Net::SNMP cannot process |
|
|
40 | the replies in time. This module automatically adapts the send rate to |
|
|
41 | avoid false timeouts caused by slow reply processing. |
|
|
42 | |
| 39 | A potential disadvantage is that replacing the dispatcher is not at all |
43 | A potential disadvantage of this module is that replacing the dispatcher |
| 40 | a documented thing to do, so future changes in Net::SNP might break this |
44 | is not at all a documented thing to do, so future changes in Net::SNP |
| 41 | module (or the many similar ones). |
45 | might break this module (or the many similar ones). |
| 42 | |
46 | |
| 43 | This module does not export anything and does not require you to do |
47 | This module does not export anything and does not require you to do |
| 44 | anything special apart from loading it I<before doing any non-blocking |
48 | anything special apart from loading it I<before doing any non-blocking |
| 45 | requests with Net::SNMP>. It is recommended but not required to load this |
49 | requests with Net::SNMP>. It is recommended but not required to load this |
| 46 | module before C<Net::SNMP>. |
50 | module before C<Net::SNMP>. |
