--- web/www/libstatgrab/index.xhtml 2004/03/23 23:43:36 1.21 +++ web/www/libstatgrab/index.xhtml 2007/01/08 00:15:23 1.46 @@ -16,15 +16,24 @@
+

+ What is libstatgrab? +

+

+ 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. +

+

+ 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. +

+

+ The package also includes a couple of useful tools. The + first, saidar, 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 + MRTG configuration file + to use statgrab. +

+

News

@@ -41,248 +81,325 @@ freshmeat?

- Sunday 21 March 2004 + Monday 8 January 2007

- pystatgrab, a new package containing a set of Python - bindings, has been released. Check out it's - project page. + Version 0.14 of libstatgrab has been released.
+ Download it from one of our mirrors.

+

+ 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. +

- Wednesday 10 March 2004 + Monday 20 March 2006

- Version 0.9 of libstatgrab has been released.
- Download it - - here. + Version 0.13 of libstatgrab has been released.
+ Download it from one of our mirrors.

- 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. + 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.

- Wednesday 11 February 2004 + Sunday 31 July 2005

- Version 0.8.2 of libstatgrab has been released.
- Download it - - here. + Version 0.12 of libstatgrab has been released.
+ Download it from one of our mirrors.

- 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. + 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.

+

+ 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. +

- Wednesday 21 January 2004 + Tuesday 26 April 2005

- Version 0.8.1 of libstatgrab has been released.
- Download it - - here. + Official libstatgrab packages for Debian now + available.

- 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. + Thanks to the work of + Bartosz Fenski + libstatgrab is now available on debian. This replaces our + unofficial debian packages which will no longer be + updated.

- Tuesday 6 January 2004 + Thursday 3 March 2005

- Version 0.8 of libstatgrab has been released.
- Download it - - here. + Version 0.11.1 of libstatgrab has been released.
+ Download it from one of our mirrors.

- 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. + 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.

- Wednesday 22 October 2003 + Friday 12 November 2004

- Version 0.7 of libstatgrab has been released.
- Download it - - here. + Version 0.11 of libstatgrab has been released.
+ Download it from one of our mirrors.

- The most significant change in this release is support for - NetBSD 1.6.x. Parts of the FreeBSD code have been - optimised, and an initialise function has been added to - allow programs to drop any extra privileges libstatgrab - needs. The list of known file systems has been increased, - and libstatgrab has been tested on even more platforms. - Finally, saidar has been tweaked to work even if it can't - get all the statistics. + This release brings support for HP-UX (version 11.11), and + also fixes a few other minor issues.

- Saturday 18 October 2003 + Wednesday 25 August 2004

- Version 0.6.1 of libstatgrab has been released.
- Download it - - here. + Version 0.10.3 of libstatgrab has been released.
+ Download it from one of our mirrors.

- This release brings support for FreeBSD 5 on sparc 64, and - some bugfixes in FreeBSD memory statistics. Also, some - fixes to saidar, and statgrab. + This release adds a handful of new features to statgrab, and + adds support for FreeBSD 6.0-CURRENT. See the NEWS file in + the tarball for more details.

- Friday 10 October 2003 + Tuesday 27 July 2004

- Version 0.6 of libstatgrab has been released.
- You can download it from our mirror site - - here. + Version 0.10.2 of libstatgrab has been released.
+ Download it from one of our mirrors.

- This release includes some exciting new tools, support for - FreeBSD 5.1, and documentation in manpages. Plus some major - bugfixes and packaging enhancements. + This release fixes a problem with the shared library + version number in the last release.

- Tuesday 09 September 2003 + Monday 26 July 2004

- We're pleased to announce a new release of - libstatgrab.
- You can download version 0.5.1 from - - here. + Version 0.10.1 of libstatgrab has been released.
+ Download it from one of our mirrors.

+

+ This release consists almost entirely of bugfixes. + We've fixed compile-time errors for recent OpenBSD and + NetBSD platforms, and also a minor bug in statgrab + that broke network statistics on Solaris. New + variables have been added to the pkg-config file to + suggest ownership and permissions of binaries, and + we've added error reporting functions that store errno + values. There's also other minor fixes detailed in the + NEWS file. +

- Monday 25 August 2003 + Thursday 20 May 2004

- We're pleased to announce a new release of - libstatgrab.
- You can download version 0.5 from - - here. + Version 0.10 of libstatgrab has been released.
+ Download it from one of our mirrors.

- This release provides both documentation and examples, - which we hope will make the package more useable. Stay - tuned for the next release with some useful tools. + This release concentrates heavily on standardising the names + of functions and structures throughout libstatgrab. Although + this will mean changes for existing programs, in the long run + we hope it'll make things both clearer and easier. However, + for those who still need the old functions we have provided + compatibility wrappers. See the NEWS file for details.

-

- What is libstatgrab? -

- 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. + The other main change in this release is a new function to + provide full details on currently running processes. See the + documentation for sg_get_process_stats for details. Along with + this there are compare functions for use with qsort for sorting + process, network, and disk io statistics. We've also introduced + error reporting functions that allow calling applications to + see why libstatgrab has returned a failure. See sg_get_error.

- 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, and Cygwin. The aim is to extend this to - include as many operating systems as possible. + Finally, we've added support for NetBSD 2.0 and tidied up lots + of areas of the code. This release does not include the python + bindings - they're now available as their own project called + pystatgrab.

+

+ Sunday 21 March 2004 +

- The package also includes a couple of useful tools. The - first, saidar, 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 - MRTG configuration file - to use statgrab. + pystatgrab, a new package containing a set of Python + bindings, has been released. Check out its + project page.

Downloading

The latest version of libstatgrab can be downloaded from - our primary download - - mirror. All downloads are pgp signed using our + our mirror sites. + All downloads are pgp signed using our PGP Key.

For installation instructions see the README and INSTALL - files contained within the archive. If you're using - FreeBSD you can make - use of the - - devel/libstatgrab port to install libstatgrab for you. + files contained within the archive.

+ Language Bindings +

+ +

+ 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 + in touch so we + can add a link here. +

+

+ Packages of libstatgrab +

+ +

+ These are various pre-packaged versions of libstatgrab + that you can get for your favourite operating system. If + we've missed any out, please let us know. +

+

+ We've noticed that google throws up some RPM's relating + to Mandrake and Suse, but no webpage for them. +

+

+ 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 + + here. +

+

+ Development +

+ +

+ 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 + CVS page. +

+

Documentation

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:

+ We also have an overview page for the library: +

+ +

Then we have the manual pages for each function: