ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/cvsroot/AnyEvent-Porttracker/Porttracker.pm
(Generate patch)

Comparing cvsroot/AnyEvent-Porttracker/Porttracker.pm (file contents):
Revision 1.17 by root, Mon Mar 11 08:43:53 2013 UTC vs.
Revision 1.18 by root, Wed Jan 7 01:41:33 2015 UTC

1=head1 NAME 1=head1 NAME
2 2
3AnyEvent::Porttracker - Porttracker/PortIQ API client interface. 3AnyEvent::Porttracker - Porttracker API client interface.
4 4
5=head1 SYNOPSIS 5=head1 SYNOPSIS
6 6
7 use AnyEvent::Porttracker; 7 use AnyEvent::Porttracker;
8 8
… …
67other things) scans switches and routers in a network and gives a coherent 67other things) scans switches and routers in a network and gives a coherent
68view of which end devices are connected to which switch ports on which 68view of which end devices are connected to which switch ports on which
69switches and routers. It also offers a JSON-based client API, for which 69switches and routers. It also offers a JSON-based client API, for which
70this module is an implementation. 70this module is an implementation.
71 71
72In addition to Porttracker, the PortIQ product is also supported, as it
73uses the same protocol.
74
75If you do not have access to either a Porttracker or PortIQ box then this 72If you do not have access to a Porttracker box then this module will be of
76module will be of little value to you. 73little value to you.
77 74
78This module is an L<AnyEvent> user, you need to make sure that you use and 75This module is an L<AnyEvent> user, you need to make sure that you use and
79run a supported event loop. 76run a supported event loop.
80 77
81To quickly understand how this module works you should read how to 78To quickly understand how this module works you should read how to
… …
155 152
156Enables or disables TLS (default: disables). When enabled, then the 153Enables or disables TLS (default: disables). When enabled, then the
157connection will try to handshake a TLS connection before logging in. If 154connection will try to handshake a TLS connection before logging in. If
158unsuccessful a fatal error will be raised. 155unsuccessful a fatal error will be raised.
159 156
160Since most Porttracker/PortIQ boxes will not have a sensible/verifiable 157Since most Porttracker boxes will not have a sensible/verifiable
161certificate, no attempt at verifying it will be done (which means 158certificate, no attempt at verifying it will be done (which means
162man-in-the-middle-attacks will be trivial). If you want some form of 159man-in-the-middle-attacks will be trivial). If you want some form of
163verification you need to provide your own C<tls_ctx> object with C<< 160verification you need to provide your own C<tls_ctx> object with C<<
164verify => 1, verify_peername => [1, 1, 1] >> or whatever verification mode 161verify => 1, verify_peername => [1, 1, 1] >> or whatever verification mode
165you wish to use. 162you wish to use.
… …
586 583
587=back 584=back
588 585
589=head1 SEE ALSO 586=head1 SEE ALSO
590 587
591L<AnyEvent>, L<http://www.porttracker.com/>, L<http://www.infoblox.com/en/products/portiq.html>. 588L<AnyEvent>, L<http://www.porttracker.com/>.
592 589
593=head1 AUTHOR 590=head1 AUTHOR
594 591
595 Marc Lehmann <marc@nethype.de> 592 Marc Lehmann <marc@nethype.de>
596 593

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines