Content
Description
liboping is a C library to generate
ICMP echo requests, better known as "ping packets". It
is intended for use in network monitoring applications or
applications that would otherwise need to fork
ping(1) frequently. Included is a sample
application, called oping,
which demonstrates the library's abilities. It is like ping,
ping6, and fping rolled into one. Since people are curious you
might want to see an example
output.
liboping was inspired by ping, libping (homepage vanished) and fping: It differs from these existing solutions in that it can `ping' multiple hosts in parallel using IPv4 or IPv6 transparently. Other design principles were an object oriented interface, simplicity and extensibility: Is simple because there are only a few interface functions and no external dependencies. It's extensible since all (internal) data is kept in "opaque data types", so the storage may change or be extended without applications noticing it.
Since version 1.0 has not yet been reached the interface is not yet stable. However, huge changes are not to be expected.
News
- 2008-01-26 A first version of
Net::Oping has been uploaded to
CPAN.
This Perl module provides a high-level interface to
liboping, so you can use the library from within Perl. - 2007-03-27 Version
0.3.5 fixes an issue with the file
descriptor not being closed. Thanks to Esteban Sanchez
for submitting the patch. Also, Alex Brooks has pointed
our the
<sys/types.h>should be included and thatextern "C" { ... }would be nice to have included automatically. - 2006-12-01 Version
0.3.4 fixes an error in
ping_host_removewhich would lead to the wrong host being removed. Thanks to Wojtek for reporting this. - 2006-07-16 Version
0.3.3 improves error reporting:
ping_sendtodoesn't complain aboutEHOSTUNREACHandENETUNREACHanymore. - 2006-07-13 Version 0.3.2 improves the build system, to make it easier to link against liboping.
- 2006-07-10 Version
0.3.1 gets rid of
libltdlsince it's not used. Also other, minor build issues have been resolved. - 2006-07-09 Version 0.3.0 adds the ability to set the source address of generated packets. The oping application has been updated to make use of this feature.
- 2006-06-05 Version 0.2.2 improves oping: It now exits with an error message if no hosts could be resolved. Prior to this release it would just sit there and wait for no one in particular..
- 2006-06-01 Version 0.2.1 fixes problems when building under FreeBSD and Mac OS X.
- 2006-05-29 Version 0.2.0 has been released. You can now set the data sent to the remote host yourself and query the data returned from the remote side. The sample application, oping, has been beautified: It calculates the standard-deviation now and is even more ping-like.
- 2006-05-08 Version 0.1.1 has been released. It fixes a nasty bug with the sequence checking of returning packets. Internally the sequence is stored in an integer which did not overflow after 65535. This caused liboping to detect a sequence mismatch and discard the packet.
- 2006-05-08 Version 0.1.0 has been released.
Download
- liboping-0.3.5.tar.bz2 (source tarball)
- liboping-0.3.5.tar.gz (source tarball)
Debian package
Users of Debian Etch can install liboping using apt and their favorite Debian-mirror. Users of Debian Sarge can use the package provided by backports.org.
Development version
The development files are kept in a Git repository. You can "clone" it with the following command. Patches are welcome anytime. :)
Documentation
The only documentation right now are the manpages. You can find online versions here:
- liboping(3)
- oping(8)
- ping_construct(3)
- ping_get_error(3)
- ping_host_add(3)
- ping_iterator_get_context(3)
- ping_iterator_get(3)
- ping_iterator_get_info(3)
- ping_send(3)
- ping_setopt(3)
License information
liboping is distributed under the GPL, version 2. The license can also be found in the file "COPYING" in the source tarball.
