--- web/www/libstatgrab/index.xhtml 2005/01/20 20:30:46 1.33 +++ web/www/libstatgrab/index.xhtml 2007/07/13 21:56:52 1.48 @@ -16,10 +16,10 @@
+

+ 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

@@ -50,6 +81,96 @@ freshmeat?

+ Saturday 14 July 2007 +

+

+ Version 0.15 of libstatgrab has been released.
+ Download it from one of our mirrors. +

+

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

+

+ Monday 8 January 2007 +

+

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

+

+ Monday 20 March 2006 +

+

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

+

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

+

+ Sunday 31 July 2005 +

+

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

+

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

+

+ Tuesday 26 April 2005 +

+

+ Official libstatgrab packages for Debian now + available. +

+

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

+

+ Thursday 3 March 2005 +

+

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

+

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

+

Friday 12 November 2004

@@ -136,101 +257,10 @@

pystatgrab, a new package containing a set of Python - bindings, has been released. Check out it's + bindings, has been released. Check out its project page.

-

- Wednesday 10 March 2004 -

-

- Version 0.9 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. -

-

- Wednesday 11 February 2004 -

-

- Version 0.8.2 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. -

-

- Wednesday 21 January 2004 -

-

- Version 0.8.1 of libstatgrab has been released.
- Download it from one of our mirrors. -

-

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

-

- Tuesday 6 January 2004 -

-

- Version 0.8 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. -

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

-

Downloading

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

@@ -269,20 +299,26 @@

These are various pre-packaged versions of libstatgrab @@ -298,7 +334,7 @@ OpenBSD folk, but they didn't seem interested in taking it. You can find it - here. + here.

Development @@ -319,50 +355,67 @@

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: