--- web/www/libstatgrab/index.xhtml 2004/03/23 20:22:42 1.20 +++ web/www/libstatgrab/index.xhtml 2004/07/22 12:52:12 1.26 @@ -1,256 +1,379 @@ <!--#include virtual="/doctype.inc" --> - -<head> -<title>i-scream libstatgrab homepage</title> + <head> + <title> + i-scream libstatgrab homepage + </title> <!--#include virtual="/style.inc" --> -</head> - -<body> - -<div id="container"> - -<div id="main"> - + </head> + <body> + <div id="container"> + <div id="main"> <!--#include virtual="/header.inc" --> - -<div id="contents"> - -<h1 class="top">i-scream libstatgrab homepage</h1> - -<div id="topnav"> - <ul> - <li><a href="#news">News</a></li> - <li><a href="#what">What is libstatgrab?</a></li> - <li><a href="#download">Downloading</a></li> - <li><a href="#documentation">Documentation</a></li> - <li><a href="#screenshot">Screenshot</a></li> - </ul> -</div> - -<h2><a name="news">News</a></h2> - -<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>? -</p> - -<h3>Sunday 21 March 2004</h3> -<p> -pystatgrab, a new package containing a set of Python bindings, -has been released. Check out it's <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 -<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.9.tar.gz">here</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 -<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.2.tar.gz">here</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 -<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.1.tar.gz">here</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 -<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.tar.gz">here</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> - -<h3>Wednesday 22 October 2003</h3> -<p> -Version 0.7 of libstatgrab has been released.<br/> -Download it -<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.7.tar.gz">here</a>. -</p> -<p> -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. -</p> - -<h3>Saturday 18 October 2003</h3> -<p> -Version 0.6.1 of libstatgrab has been released.<br/> -Download it -<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.1.tar.gz">here</a>. -</p> -<p> -This release brings support for FreeBSD 5 on sparc 64, and some -bugfixes in FreeBSD memory statistics. Also, some fixes to saidar, -and statgrab. -</p> - -<h3>Friday 10 October 2003</h3> -<p> -Version 0.6 of libstatgrab has been released.<br/> -You can download it from our mirror site -<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.tar.gz">here</a>. -</p> -<p> -This release includes some exciting new tools, support for FreeBSD -5.1, and documentation in manpages. Plus some major bugfixes and -packaging enhancements. -</p> - -<h3>Tuesday 09 September 2003</h3> -<p> -We're pleased to announce a new release of libstatgrab.<br/> -You can download version 0.5.1 from -<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.1.tar.gz">here</a>. -</p> - -<h3>Monday 25 August 2003</h3> -<p> -We're pleased to announce a new release of libstatgrab.<br/> -You can download version 0.5 from -<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.tar.gz">here</a>. -</p> -<p> -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. -</p> - -<h2><a name="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, 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 name="download">Downloading</a></h2> - -<p> -The latest version of libstatgrab can be downloaded from our -primary download -<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/">mirror</a>. -All downloads are pgp signed using our <a href="/pgpkey.xhtml">PGP Key</a>. -</p> - -<p> -For installation instructions see the README and INSTALL files -contained within the archive. If you're using -<a href="http://www.freebsd.org">FreeBSD</a> you can make use of the -<a href="http://www.freshports.org/devel/libstatgrab">devel/libstatgrab</a> -port to install libstatgrab for you. -</p> - -<h2><a name="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: -</p> - -<ul> -<li><a href="statgrab.html">statgrab(3)</a></li> -</ul> - -<p> -Then we have the manual pages for each function: -</p> - -<ul> -<li><a href="cpu_percent_usage.html">cpu_percent_usage(3)</a></li> -<li><a href="get_diskio_stats.html">get_diskio_stats(3)</a></li> -<li><a href="get_general_stats.html">get_general_stats(3)</a></li> -<li><a href="get_load_stats.html">get_load_stats(3)</a></li> -<li><a href="get_memory_stats.html">get_memory_stats(3)</a></li> -<li><a href="get_network_iface_stats.html">get_network_iface_stats(3)</a></li> -<li><a href="get_network_stats.html">get_network_stats(3)</a></li> -<li><a href="get_page_stats.html">get_page_stats(3)</a></li> -<li><a href="get_process_stats.html">get_process_stats(3)</a></li> -<li><a href="get_user_stats.html">get_user_stats(3)</a></li> -</ul> - -<h2><a name="screenshot">Screenshot</a></h2> - -<p> -Here's what saidar looks like when it's running: -</p> -<p> -<img src="saidar.png" alt="saidar screenshot" /> -</p> -</div> - + <div id="contents"> + <h1 class="top"> + i-scream libstatgrab homepage + </h1> + <div id="topnav"> + <ul> + <li> + <a href="#news">News</a> + </li> + <li> + <a href="#what">What is libstatgrab?</a> + </li> + <li> + <a href="#download">Downloading</a> + </li> + <li> + <a href="#bindings">Language Bindings</a> + </li> + <li> + <a href="#development">Development</a> + </li> + <li> + <a href="#documentation">Documentation</a> + </li> + <li> + <a href="#screenshot">Screenshot</a> + </li> + </ul> + </div> + <h2> + <a id="news">News</a> + </h2> + <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>? + </p> + <h3> + Thursday 20 May 2004 + </h3> + <p> + Version 0.10 of libstatgrab has been released.<br /> + Download it + <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.10.tar.gz"> + here</a>. + </p> + <p> + 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. + </p> + <p> + 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. + </p> + <p> + 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 + <a href="/pystatgrab/">pystatgrab</a>. + </p> + <h3> + Sunday 21 March 2004 + </h3> + <p> + pystatgrab, a new package containing a set of Python + bindings, has been released. Check out it's + <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 + <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.9.tar.gz"> + here</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 + <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.2.tar.gz"> + here</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 + <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.1.tar.gz"> + here</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 + <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.tar.gz"> + here</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> + <h3> + Wednesday 22 October 2003 + </h3> + <p> + Version 0.7 of libstatgrab has been released.<br /> + Download it + <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.7.tar.gz"> + here</a>. + </p> + <p> + 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. + </p> + <h3> + Saturday 18 October 2003 + </h3> + <p> + Version 0.6.1 of libstatgrab has been released.<br /> + Download it + <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.1.tar.gz"> + here</a>. + </p> + <p> + This release brings support for FreeBSD 5 on sparc 64, and + some bugfixes in FreeBSD memory statistics. Also, some + fixes to saidar, and statgrab. + </p> + <h3> + Friday 10 October 2003 + </h3> + <p> + Version 0.6 of libstatgrab has been released.<br /> + You can download it from our mirror site + <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.tar.gz"> + here</a>. + </p> + <p> + This release includes some exciting new tools, support for + FreeBSD 5.1, and documentation in manpages. Plus some major + bugfixes and packaging enhancements. + </p> + <h3> + Tuesday 09 September 2003 + </h3> + <p> + We're pleased to announce a new release of + libstatgrab.<br /> + You can download version 0.5.1 from + <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.1.tar.gz"> + here</a>. + </p> + <h3> + Monday 25 August 2003 + </h3> + <p> + We're pleased to announce a new release of + libstatgrab.<br /> + You can download version 0.5 from + <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.tar.gz"> + here</a>. + </p> + <p> + 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. + </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, 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> + <p> + The latest version of libstatgrab can be downloaded from + our primary download + <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/"> + mirror</a>. All downloads are pgp signed using our + <a href="/pgpkey.xhtml">PGP Key</a>. + </p> + <p> + For installation instructions see the README and INSTALL + files contained within the archive. If you're using + <a href="http://www.freebsd.org">FreeBSD</a> you can make + use of the + <a href="http://www.freshports.org/devel/libstatgrab"> + devel/libstatgrab</a> port to install libstatgrab for you. + </p> + <h2> + <a id="bindings">Language Bindings</a> + </h2> + <ul> + <li> + <a href="/pystatgrab/">Python</a> + </li> + <li> + <a href="http://pecl.php.net/statgrab/">PHP (external)</a> + </li> + <li> + <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl (external)</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 + can add a link here. + </p> + <h2> + <a id="development">Development</a> + </h2> + <ul> + <li> + <a href="/cgi-bin/cvslog.cgi?period=thisweek&module=projects/libstatgrab">Commits this week</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: + </p> + <ul> + <li> + <a href="statgrab.html">statgrab(3)</a> + </li> + </ul> + <p> + Then we have the manual pages for each function: + </p> + <ul> + <li> + <a href="sg_get_cpu_stats.html">sg_get_cpu_stats(3)</a> + </li> + <li> + <a href="sg_get_disk_io_stats.html">sg_get_disk_io_stats(3)</a> + </li> + <li> + <a href="sg_get_fs_stats.html">sg_get_fs_stats(3)</a> + </li> + <li> + <a href="sg_get_host_info.html">sg_get_host_info(3)</a> + </li> + <li> + <a href="sg_get_load_stats.html">sg_get_load_stats(3)</a> + </li> + <li> + <a href="sg_get_mem_stats.html">sg_get_mem_stats(3)</a> + </li> + <li> + <a href="sg_get_network_iface_stats.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> + </li> + <li> + <a href="sg_get_page_stats.html">sg_get_page_stats(3)</a> + </li> + <li> + <a href="sg_get_process_stats.html">sg_get_process_stats(3)</a> + </li> + <li> + <a href="sg_get_user_stats.html">sg_get_user_stats(3)</a> + </li> + </ul> + <h2> + <a id="screenshot">Screenshot</a> + </h2> + <p> + Here's what saidar looks like when it's running: + </p> + <p> + <img src="saidar.png" alt="saidar screenshot" /> + </p> + </div> <!--#include virtual="/footer.inc" --> - -</div> - + </div> <!--#include virtual="/menu.inc" --> - -</div> - -</body> + </div> + </body> </html>