<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>
+ Sunday 21 February 2010
+ </h3>
+ <p>
+ Version 0.17 of libstatgrab has been released.<br />
+ Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
+ </p>
+ <p>
+ This release adds support for FreeBSD 9 and other systems
+ using utmpx. Also on FreeBSD it fixes an issue with large
+ quantities of memory and adds support for dynamically
+ getting a list of supported file systems. On Solaris ZFS
+ file systems will now be detected. And finally on Linux CPU
+ iowait information will be given where available.
+ </p>
+ <h3>
+ Friday 30 May 2008
+ </h3>
+ <p>
+ Dag Odenhall got in touch today to let us know he's written
+ <a href="http://statgrab.rubyforge.org/">Ruby bindings</a>
+ for libstatgrab. Thanks Dag!
+ </p>
+ <h3>
+ Monday 17 March 2008
+ </h3>
+ <p>
+ Version 0.16 of libstatgrab has been released.<br />
+ Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
+ </p>
+ <p>
+ This release fixes some minor build problems on Solaris
+ with Sun's compiler, and on the Debian "armel" port. Also
+ a minor fix to statgrab-make-mrtg-config on machines with
+ no swap, and added support for FreeBSD 8.
+ </p>
+ <h3>
+ Saturday 14 July 2007
+ </h3>
+ <p>
+ Version 0.15 of libstatgrab has been released.<br />
+ Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
+ </p>
+ <p>
+ This release fixes a regression introduced on OpenBSD in
+ the last release - memory statistics were reported
+ incorrectly. Some other minor changes have been made, see
+ the NEWS file for more information.
+ </p>
+ <h3>
+ Monday 8 January 2007
+ </h3>
+ <p>
+ Version 0.14 of libstatgrab has been released.<br />
+ Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
+ </p>
+ <p>
+ This release contains mainly bugfixes - see the NEWS file
+ in the distribution for a full list. It also brings a new
+ feature in saidar: colour support, which can be activated
+ with the -c runtime flag.
+ </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>
</h3>
<p>
pystatgrab, a new package containing a set of Python
- bindings, has been released. Check out it's
+ bindings, has been released. Check out its
<a href="/pystatgrab/">project page</a>.
</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>
<a href="/pystatgrab/">Python</a>
</li>
<li>
- <a href="http://pecl.php.net/statgrab/">PHP (external)</a>
+ <a href="http://pecl.php.net/statgrab/">PHP</a>
</li>
<li>
- <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl (external)</a>
+ <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl</a>
+ </li>
+ <li>
+ <a href="http://statgrab.rubyforge.org/">Ruby</a>
</li>
</ul>
<p>
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.freebsd.org/cgi/ports.cgi?query=statgrab&stype=all">FreeBSD</a>
</li>
<li>
- <a href="http://packages.gentoo.org/search/?sstring=statgrab">Gentoo Linux</a>
+ <a href="http://packages.gentoo.org/search/?sstring=libstatgrab">Gentoo Linux</a>
</li>
<li>
<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://www.sunfreeware.com/">Solaris (SunFreeware)</a>
+ </li>
+ <li>
+ <a href="http://www.opencsw.org/packages/libstatgrab/">Solaris (OpenCSW)</a>
+ </li>
+ <li>
+ <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>
</li>
+ <li>
+ <a href="http://software.opensuse.org/download/home:/anagappan/">RPMs for various Linux distributions</a>
+ </li>
+ <li>
+ <a href="http://www.openbsd.org/cgi-bin/cvsweb/ports/sysutils/libstatgrab/">OpenBSD</a>
+ </li>
</ul>
<p>
These are various pre-packaged versions of libstatgrab
We've noticed that google throws up some RPM's relating
to Mandrake and Suse, but no webpage for them.
</p>
- <p>
- Several attempts were made to submit a port to the
- OpenBSD folk, but they didn't seem interested in taking
- it. You can find it
- <a href="http://ftp.i-scream.org/pub/i-scream/tmp/libstatgrab-0.11-openbsd-port.tar.gz">
- here</a>.
- </p>
<h2>
<a id="development">Development</a>
</h2>
</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>