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.