GitHub - vincentbernat/ipoo: gather information about IP and hostnames (original) (raw)

• README

IPoo

IPoo is an application that should gather information from your network from some keyword. Currently, it is able to do the following tasks:

• resolve DNS names (direct and reverse)
• find which router is directly connected to an IP
• grab information from some HTTP database
• act as ipcalc

Those tasks can be extended using a simple plugin system.

IPoo is able to display those information using three interfaces:

• a simple web interface
• a Greasemonkey script
• an XMPP client (jabber)

A sample configuration can be found in doc/ipoo.cfg.sample

Installation

To user this application, you need the following Debian packages:

• python-twisted-core (Twisted - http://twistedmatrix.com)
• python-twisted-names (Twisted Names - http://twistedmatrix.com)
• python-twisted-words (Twisted Words - http://twistedmatrix.com)
• python-wokkel (Wokkel - https://wokkel.ik.nu/)
• python-nevow (Nevow - http://divmod.org/trac/wiki/DivmodNevow)
• python-netaddr (netaddr - https://github.com/drkjam/netaddr)
• python-yaml (PyYAML - http://pyyaml.org/)

You need to write a "ipoo.cfg" that should be put in "/etc/ipoo".

You can install the application with: python setup.py build sudo python setup.py install

If you do not wish to install the application, you still need to compile the module to build SNMP queries. This can be done with: python setup.py build_ext --inplace

You can launch the application by hand twistd -no ipoo or twistd -no ipoo --config=/etc/ipoo/ipoo.cfg

Point your browser to http://localhost:8096.

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.

See LICENSE file for the complete text. Moreover, to avoid any problem with SNMP bindings using NetSNMP which may be linked with OpenSSL, there is an exception for OpenSSL:

In addition, as a special exception, a permission to link the code with the OpenSSL project's "OpenSSL" library (or with modified versions of it that use the same license as the "OpenSSL" library), and distribute the linked executables is given. You must obey the GNU General Public License in all respects for all of the code used other than "OpenSSL". If you modify this file, you may extend this exception to your version of the file, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.

snmp.c is licensed under MIT/X11 license. See the license at the top of the file.