<!--#include virtual="/doctype.inc" -->
<head>
<title>
- i-scream libstatgrab homepage
+ libstatgrab homepage
</title>
<!--#include virtual="/style.inc" -->
</head>
<!--#include virtual="/header.inc" -->
<div id="contents">
<h1 class="top">
- i-scream libstatgrab homepage
+ libstatgrab homepage
</h1>
<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>
+ <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 supported and tested platforms
+ includes FreeBSD, Linux, NetBSD, OpenBSD, Solaris,
+ DragonFly BSD, HP-UX and AIX. We are always happy to
+ accept patches to extend support to other operating
+ systems.
+ </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>
+ <h3>
+ Thursday 8 August 2013
+ </h3>
+ <p>
+ Version 0.90 of libstatgrab has been released.<br />
+ Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
+ </p>
+ <p>
+ Please note that the API in 0.90 has changed, so
+ applications using libstatgrab will need to be updated to
+ support the changes.
+ </p>
+ <p>
+ There are a large number of changes in this version of
+ libstatgrab. Here is an overview:
+ </p>
+ <ul>
+ <li>Thread safety and reentrant functions.</li>
+ <li>API unification (every stats call is now able to
+ return multiple entries).</li>
+ <li>Complete rewrite of internal memory management (eases
+ future extensions).</li>
+ <li>Add experimental support for tracing using log4cplus.</li>
+ <li>Complete the ports for AIX, HP-UX and most of the
+ widely used BSD-based operating systems.</li>
+ <li>Complete the port for Darwin/MacOS X including basic
+ Mach.</li>
+ <li>Clean up the FreeBSD and Solaris implementations.</li>
+ <li>Clean up the FreeBSD and Solaris implementations.</li>
+ </ul>
+ <p>
+ This release is the result of a significant amount of work
+ by the newest member of the libstatgrab team - Jens
+ Rehsack. Welcome to the team Jens!
+ </p>
+ <p>
+ If you find any bugs in the release please report them
+ over at our
+ <a href="https://github.com/i-scream/libstatgrab/issues">Issue
+ Tracker</a> on GitHub.
+ </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>
<p>
- To get notifications of new libstatgrab releases why not
- subscribe to our project over on
- <a href="http://freshmeat.net/projects/libstatgrab/">freshmeat</a>?
+ 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>
<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>
- <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>
<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 binding for another language, please get in touch so we
can add a link here.
</p>
<h2>
</h2>
<ul>
<li>
- <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&stype=all">FreeBSD</a>
+ <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 missed any out, please let us know.
</p>
<p>
- We've noticed that google throws up some RPM's relating
+ 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.
- </p>
<h2>
- <a id="development">Development</a>
+ <a id="documentation">Documentation</a>
</h2>
+ <em>These need updating for the 0.90 release.</em>
+ <p>
+ The only online documentation we have at the moment is the
+ manual pages converted in to HTML format. First are the
+ manual pages for the command line tools:
+ </p>
<ul>
<li>
- <a href="/cgi-bin/cvslog.cgi?period=thisweek&module=projects/libstatgrab">Commits this week</a>
+ <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 develop libstatgrab using the CVS revision control system.
- Using this link you can see what changes we've made this week.
- For more information on our CVS setup see our
- <a href="/cvs.xhtml">CVS page</a>.
- </p>
- <h2>
- <a id="documentation">Documentation</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:
+ 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_comp_init.3.html">sg_comp_init(3)</a>
+ </li>
+ <li>
+ <a href="docs/sg_get_cpu_stats.3.html">sg_get_cpu_stats(3)</a>
+ </li>
+ <li>
+ <a href="docs/sg_get_disk_io_stats.3.html">sg_get_disk_io_stats(3)</a>
+ </li>
+ <li>
+ <a href="docs/sg_get_error.3.html">sg_get_error(3)</a>
+ </li>
+ <li>
+ <a href="docs/sg_get_fs_stats.3.html">sg_get_fs_stats(3)</a>
+ </li>
+ <li>
+ <a href="docs/sg_get_host_info.3.html">sg_get_host_info(3)</a>
+ </li>
+ <li>
+ <a href="docs/sg_get_load_stats.3.html">sg_get_load_stats(3)</a>
+ </li>
+ <li>
+ <a href="docs/sg_get_mem_stats.3.html">sg_get_mem_stats(3)</a>
+ </li>
+ <li>
+ <a href="docs/sg_get_network_iface_stats.3.html">sg_get_network_iface_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_network_io_stats.3.html">sg_get_network_io_stats(3)</a>
</li>
<li>
- <a href="sg_get_fs_stats.html">sg_get_fs_stats(3)</a>
+ <a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a>
</li>
<li>
- <a href="sg_get_host_info.html">sg_get_host_info(3)</a>
+ <a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a>
</li>
<li>
- <a href="sg_get_load_stats.html">sg_get_load_stats(3)</a>
+ <a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a>
</li>
<li>
- <a href="sg_get_mem_stats.html">sg_get_mem_stats(3)</a>
+ <a href="docs/sg_init.3.html">sg_init(3)</a>
</li>
<li>
- <a href="sg_get_network_iface_stats.html">sg_get_network_iface_stats(3)</a>
+ <a href="docs/sg_internal-intro.3.html">sg_internal-intro(3)</a>
</li>
<li>
- <a href="sg_get_network_io_stats.html">sg_get_network_io_stats(3)</a>
+ <a href="docs/sg_intro.3.html">sg_intro(3)</a>
</li>
<li>
- <a href="sg_get_page_stats.html">sg_get_page_stats(3)</a>
+ <a href="docs/sg_lock_mutex.3.html">sg_lock_mutex(3)</a>
</li>
<li>
- <a href="sg_get_process_stats.html">sg_get_process_stats(3)</a>
+ <a href="docs/sg_set_error.3.html">sg_set_error(3)</a>
</li>
<li>
- <a href="sg_get_user_stats.html">sg_get_user_stats(3)</a>
+ <a href="docs/sg_vector_create.3.html">sg_vector_create(3)</a>
</li>
</ul>
<h2>
i-scream / www.i-scream.org.git / blobdiff