<div id="topnav">
<ul>
<li>
- <a href="#news">News</a>
+ <a href="#what">What is libstatgrab?</a>
</li>
<li>
- <a href="#what">What is libstatgrab?</a>
+ <a href="#news">News</a>
</li>
<li>
<a href="#download">Downloading</a>
</li>
</ul>
</div>
+<!--#include virtual="/bannerad.inc" -->
+ <h2>
+ <a id="what">What is libstatgrab?</a>
+ </h2>
+ <p>
+ libstatgrab is a library that provides cross platform
+ access to statistics about the system on which it's run.
+ It's written in C and presents a selection of useful
+ interfaces which can be used to access key system
+ statistics. The current list of statistics includes CPU
+ usage, memory utilisation, disk usage, process counts,
+ network traffic, disk I/O, and more.
+ </p>
+ <p>
+ The current list of platforms is Solaris 2.x, Linux
+ 2.2/2.4/2.6, FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x,
+ DragonFly BSD 1.0, HP-UX, and Cygwin. The aim is to extend
+ this to include as many operating systems as possible.
+ </p>
+ <p>
+ The package also includes a couple of useful tools. The
+ first, <a href="#screenshot">saidar</a>, provides a
+ curses-based interface to viewing the current state of the
+ system. The second, statgrab, gives a sysctl-style
+ interface to the statistics gathered by libstatgrab. This
+ extends the use of libstatgrab to people writing scripts or
+ anything else that can't easily make C function calls.
+ Included with statgrab is a script to generate an
+ <a href="http://www.mrtg.org">MRTG</a> configuration file
+ to use statgrab.
+ </p>
<h2>
<a id="news">News</a>
</h2>
subscribe to our project over on
<a href="http://freshmeat.net/projects/libstatgrab/">freshmeat</a>?
</p>
+ <h3>
+ Monday 20 March 2006
+ </h3>
+ <p>
+ Version 0.13 of libstatgrab has been released.<br />
+ Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
+ </p>
+ <p>
+ This release mainly includes a bunch of bug fixes, but
+ also brings preliminary support for WIN32. We've also
+ added a few lines to the header file to make C++ linking
+ easier. Please see the NEWS file in the distribution for
+ full details.
+ </p>
+ <h3>
+ Sunday 31 July 2005
+ </h3>
+ <p>
+ Version 0.12 of libstatgrab has been released.<br />
+ Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
+ </p>
+ <p>
+ This release has some new features, bug fixes, and a minor
+ API change. More details have been added to the file
+ system statistics, linux partition detection has been
+ reworked, and compile errors on Linux 2.6 have been fixed.
+ Support has been added for Solaris 10 and FreeBSD 7.
+ There are also manual pages for all the tools.
+ </p>
+ <p>
+ The duplex value in the network interface statistics has
+ changed name from "dup" to "duplex" - this breaks the API.
+ We plan to stabilise the API for a 1.0 release. As before,
+ the old name is available if SG_ENABLE_DEPRECATED is
+ defined.
+ </p>
+ <h3>
+ Tuesday 26 April 2005
+ </h3>
+ <p>
+ Official libstatgrab packages for Debian now
+ <a href="http://packages.debian.org/unstable/source/libstatgrab">available</a>.
+ </p>
+ <p>
+ Thanks to the work of
+ <a href="mailto:fenio@debian.org">Bartosz Fenski</a>
+ libstatgrab is now available on debian. This replaces our
+ unofficial debian packages which will no longer be
+ updated.
+ </p>
+ <h3>
+ Thursday 3 March 2005
+ </h3>
+ <p>
+ Version 0.11.1 of libstatgrab has been released.<br />
+ Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
+ </p>
+ <p>
+ This release fixes a handful of minor bugs. Duplex
+ settings were reported incorrectly on linux (half and
+ full duplex were swapped), saidar displayed negative
+ filesystem stats incorrectly, and NFS filesystems were
+ ignored. These have all been fixed.
+ </p>
<h3>
Friday 12 November 2004
</h3>
bindings, has been released. Check out it's
<a href="/pystatgrab/">project page</a>.
</p>
- <h3>
- Wednesday 10 March 2004
- </h3>
- <p>
- Version 0.9 of libstatgrab has been released.<br />
- Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
- </p>
- <p>
- This release brings new features and new platforms. We've
- added information about network interfaces (duplex, speed,
- etc) along with further statistics such as i/o packets, i/o
- errors, and collisions. Support has also been added for
- OpenBSD and DragonFly BSD. Finally some work has been done
- to reduce the platforms on which libstatgrab needs elevated
- privileges. See the NEWS file for more information.
- </p>
- <h3>
- Wednesday 11 February 2004
- </h3>
- <p>
- Version 0.8.2 of libstatgrab has been released.<br />
- Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
- </p>
- <p>
- The main focus of this release is adding support for
- Solaris 6. We've also added Python bindings so you can use
- libstatgrab directly from Python (see the extras
- directory). Finally, we've tidied up a few bits of the
- code.
- </p>
- <h3>
- Wednesday 21 January 2004
- </h3>
- <p>
- Version 0.8.1 of libstatgrab has been released.<br />
- Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
- </p>
- <p>
- This release primarily fixes bugs. On Linux a file
- descriptor leak was fixed. On Solaris some significant
- speed increases were made to the disk mapping code, along
- with some bug fixes for Solaris 7 platforms. Also, the
- library part of libstatgrab (but not the tools) is now
- released under the LGPL instead of the GPL.
- </p>
- <h3>
- Tuesday 6 January 2004
- </h3>
- <p>
- Version 0.8 of libstatgrab has been released.<br />
- Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
- </p>
- <p>
- This release brings support for Linux 2.6 and partial
- support for Cygwin. On Solaris libstatgrab now returns disk
- names using cNtNdNsN names rather than the older sdN names.
- There are also a bunch of fixes and optimisations in
- various places. Finally, a new function has been added to
- make it quicker to drop any elevated privileges libstatgrab
- may require on some operating systems.
- </p>
- <h2>
- <a id="what">What is libstatgrab?</a>
- </h2>
- <p>
- libstatgrab is a library that provides cross platform
- access to statistics about the system on which it's run.
- It's written in C and presents a selection of useful
- interfaces which can be used to access key system
- statistics. The current list of statistics includes CPU
- usage, memory utilisation, disk usage, process counts,
- network traffic, disk I/O, and more.
- </p>
- <p>
- The current list of platforms is Solaris 2.x, Linux
- 2.2/2.4/2.6, FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x,
- DragonFly BSD 1.0, HP-UX, and Cygwin. The aim is to extend
- this to include as many operating systems as possible.
- </p>
- <p>
- The package also includes a couple of useful tools. The
- first, <a href="#screenshot">saidar</a>, provides a
- curses-based interface to viewing the current state of the
- system. The second, statgrab, gives a sysctl-style
- interface to the statistics gathered by libstatgrab. This
- extends the use of libstatgrab to people writing scripts or
- anything else that can't easily make C function calls.
- Included with statgrab is a script to generate an
- <a href="http://www.mrtg.org">MRTG</a> configuration file
- to use statgrab.
- </p>
<h2>
<a id="download">Downloading</a>
</h2>
Here are links to bindings for higher level languages
that provide access to libstatgrab. If you've written
a binding for another language, please get
- <a href="mailto:dev@i-scream.org">in touch</a> so we
+ <a href="mailto:support@i-scream.org">in touch</a> so we
can add a link here.
</p>
<h2>
<a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a>
</li>
<li>
- <a href="http://ftp.i-scream.org/pub/i-scream/packages/debian/">Debian (unofficial)</a>
+ <a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a>
</li>
<li>
<a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a>
</h2>
<p>
The only online documentation we have at the moment is the
- manual pages converted in to HTML format. It's probably
- best to start with the overview manual page:
+ manual pages converted in to HTML format. First are the
+ manual pages for the command line tools:
+ </p>
+ <ul>
+ <li>
+ <a href="docs/saidar.1.html">saidar(1)</a>
+ </li>
+ <li>
+ <a href="docs/statgrab.1.html">statgrab(1)</a>
+ </li>
+ <li>
+ <a href="docs/statgrab-make-mrtg-config.1.html">statgrab-make-mrtg-config(1)</a>
+ </li>
+ <li>
+ <a href="docs/statgrab-make-mrtg-index.1.html">statgrab-make-mrtg-index(1)</a>
+ </li>
+ </ul>
+ <p>
+ We also have an overview page for the library:
</p>
<ul>
<li>
- <a href="statgrab.html">statgrab(3)</a>
+ <a href="docs/statgrab.3.html">statgrab(3)</a>
</li>
</ul>
<p>
</p>
<ul>
<li>
- <a href="sg_get_cpu_stats.html">sg_get_cpu_stats(3)</a>
+ <a href="docs/sg_get_cpu_stats.3.html">sg_get_cpu_stats(3)</a>
</li>
<li>
- <a href="sg_get_disk_io_stats.html">sg_get_disk_io_stats(3)</a>
+ <a href="docs/sg_get_disk_io_stats.3.html">sg_get_disk_io_stats(3)</a>
</li>
<li>
- <a href="sg_get_fs_stats.html">sg_get_fs_stats(3)</a>
+ <a href="docs/sg_get_fs_stats.3.html">sg_get_fs_stats(3)</a>
</li>
<li>
- <a href="sg_get_host_info.html">sg_get_host_info(3)</a>
+ <a href="docs/sg_get_host_info.3.html">sg_get_host_info(3)</a>
</li>
<li>
- <a href="sg_get_load_stats.html">sg_get_load_stats(3)</a>
+ <a href="docs/sg_get_load_stats.3.html">sg_get_load_stats(3)</a>
</li>
<li>
- <a href="sg_get_mem_stats.html">sg_get_mem_stats(3)</a>
+ <a href="docs/sg_get_mem_stats.3.html">sg_get_mem_stats(3)</a>
</li>
<li>
- <a href="sg_get_network_iface_stats.html">sg_get_network_iface_stats(3)</a>
+ <a href="docs/sg_get_network_iface_stats.3.html">sg_get_network_iface_stats(3)</a>
</li>
<li>
- <a href="sg_get_network_io_stats.html">sg_get_network_io_stats(3)</a>
+ <a href="docs/sg_get_network_io_stats.3.html">sg_get_network_io_stats(3)</a>
</li>
<li>
- <a href="sg_get_page_stats.html">sg_get_page_stats(3)</a>
+ <a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a>
</li>
<li>
- <a href="sg_get_process_stats.html">sg_get_process_stats(3)</a>
+ <a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a>
</li>
<li>
- <a href="sg_get_user_stats.html">sg_get_user_stats(3)</a>
+ <a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a>
</li>
</ul>
<h2>