--- web/www/libstatgrab/index.xhtml 2005/01/20 20:35:02 1.35 +++ web/www/libstatgrab/index.xhtml 2010/02/22 08:15:57 1.52 @@ -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,132 @@ freshmeat?

+ Sunday 21 February 2010 +

+

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

+

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

+

+ Friday 30 May 2008 +

+

+ Dag Odenhall got in touch today to let us know he's written + Ruby bindings + for libstatgrab. Thanks Dag! +

+

+ Monday 17 March 2008 +

+

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

+

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

+

+ 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 +293,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

@@ -251,17 +317,20 @@ Python

  • - PHP (external) + PHP
  • - Perl (external) + Perl
  • +
  • + Ruby +
  • 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.

    @@ -272,17 +341,26 @@ FreeBSD
  • - Gentoo Linux + Gentoo Linux
  • Solaris (Blastwave)
  • - Debian (unofficial) + Solaris (SunFreeware)
  • + Debian +
  • +
  • NetBSD
  • +
  • + RPMs for various Linux distributions +
  • +
  • + OpenBSD +
  • These are various pre-packaged versions of libstatgrab @@ -293,13 +371,6 @@ 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

    @@ -319,50 +390,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: