- About
usi++ (UNIX Socket Interface) is a low-level network-library for sending/receiving
IP, IP6, ARP etc. packets directly on RAW or PACKET sockets. It can also be used for
network-monitoring and rapid development of pentesting tools. It requires libpcap
and libdnet if you want the Layer2 DNET provider.
- License
usi++ comes under the GPL. See file COPYING for more details.
A data-file for ethernet-MAC's is included. It was taken from arpwatch.
Since USI++ is GPL there is ABSOLUTELY NO WARRANTY. YOU USE IT AT YOUR OWN RISK.
- Install
$ cd src
$ autoconf
$ ./configure
$ make
# make install
Please note, if you have multiple libpcap installs for testing, the generated Makefile is
just a proposal. The configure script actually cannot know which include or lib path
you prefer. In such case, you have to edit the generated Makefile to point to it exactly,
as well as setting/unsetting the defines you need in config.h.
Having more than one libpcap install is not uncommon, since various functions such
as pcap_set_immediate_mode() or mmapped packet sockets just appeared recently.
- Compiling the examples
Usually like this:
# c++ -std=c++11 foo.cc -lusi++ -lpcap -L/usr/local/lib -I/usr/local/include
If you compiled usi++ with dnet support, which allows you to also
send packets at the datalink layer (not just RAW sockets), you also need to
link against -ldnet. Newer libpcap may already contain pcap_inject() so
you can also build usi++ without libdnet, as this function also
provides a portable way to send datalink frames.
- Function-description
Please look at the HTML-documentation (generated via doxygen) of libusi++ or at the samples.
- Supported Platforms
Linux, BSD, OSX.
- BUGS/TODO
None.
- Background for Layer 2
The linklevel handling has changed. Now all classes are derived from
Layer2 {} which contains a RX and a TX object which are used for
receiving and transmitting data. The class-declarations can be found
in the coresponding .h files. These classes are abstract, this means
you must derive your own to get it working. Look at the .h files
which functions you must implemet. USI++ ships with the classes
Pcap, TX_IP, TX_eth_dnet etc which let you capture/send packets. They give you
basic functionality so that you can use programs that work with USI++ 1.67 or
lower as normal.
By making RX and TX abstract we make sure that Layer2 can access
routines such as sendpack(). You are free to write your own RX/TX based
classes for different hardware (FDDI,...). You can change RX/TX behaivior at runtime,
so it is as flexible as possible. For example you could detect that you are
working with PPP and then you load PPP transimitter.
Have fun.