--- web/www/libstatgrab/index.xhtml 2003/10/11 15:34:16 1.8 +++ web/www/libstatgrab/index.xhtml 2014/07/14 16:00:44 1.61 @@ -1,155 +1,555 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> - -<!-- - $Author: tdb $ - $Id: index.xhtml,v 1.8 2003/10/11 15:34:16 tdb Exp $ ---> - -<html> - -<head> - <title>i-scream libstatgrab homepage</title> -</head> - -<body bgcolor="#ffffff" link="#0000ff" alink="#3333cc" vlink="#3333cc" text="#000066"> - -<table border="0" cellpadding="2" cellspacing="2"> - <tr> - <td valign="top"> -<!--#include virtual="../left.inc" --> - </td> - <td valign="top"> -<!--#include virtual="../title.inc" --> - -<font size="2" face="arial,sans-serif"> - -<h1>libstatgrab</h1> - -<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> - -<a name="news"><h2>News</h2></a> - -<p> -<b>Friday 10 October 2003</b><br><br> -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>. -This release includes some exciting new tools, support for FreeBSD -5.1, and documentation in manpages. Plus some major bugfixes and -packaging enhancements. -</p> - -<p> -<b>Tuesday 09 September 2003</b><br><br> -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> - -<p> -<b>Monday 25 August 2003</b><br><br> -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>. -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> - -<a name="what"><h2>What is libstatgrab?</h2></a> - -<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.4, and FreeBSD -4.x/5.x. 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> - -<a name="download"><h2>Downloading</h2></a> - -<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.shtml">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> - -<a name="documentation"><h2>Documentation</h2></a> - -<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: - -<ul> -<li><a href="statgrab.html">statgrab(3)</a></li> -</ul> -</p> - -<p> -Then we have the manual pages for each function: - -<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_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> -</p> - -<a name="screenshot"><h2>Screenshot</h2></a> - -<p> -Here's what saidar looks like when it's running: -</p> -<p> -<img src="saidar.png" alt="saidar screenshot"> -</p> - -</font> - -<!--#include virtual="../bottom.inc" --> - </td> - </tr> -</table> - -</body> +<!--#include virtual="/doctype.inc" --> + <head> + <title> + libstatgrab homepage + </title> +<!--#include virtual="/style.inc" --> + </head> + <body> + <div id="container"> + <div id="main"> +<!--#include virtual="/header.inc" --> + <div id="contents"> + <h1 class="top"> + libstatgrab homepage + </h1> + <div id="topnav"> + <ul> + <li> + <a href="#what">What is libstatgrab?</a> + </li> + <li> + <a href="#news">News</a> + </li> + <li> + <a href="#download">Downloading</a> + </li> + <li> + <a href="#bindings">Language Bindings</a> + </li> + <li> + <a href="#packages">Packages</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="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> + Friday 11 July 2014 + </h3> + <p> + Version 0.91 of libstatgrab has been released.<br /> + Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. + </p> + <p> + This release includes a number of bugfixes and new + features but is API compatible with 0.90. + </p> + <ul> + <li>Use /proc/mounts on Linux where available.</li> + <li>Add a new field named device_canonical to the filesystem + statistics.</li> + <li>Fix list miscounting in sg_set_valid_filesystems.</li> + <li>Fix buffer overrun when dealing with a larger number of + processes.</li> + <li>Fix divide by zero display problem in saidar.</li> + <li>When logging with log4cplus is enabled, properties files + are installed in to ${prefix}/etc.</li> + <li>Add Graphite output support in statgrab.</li> + </ul> + <p> + A full list of changes can be found in the + <a href="http://git.i-scream.org/?p=libstatgrab.git;a=blob;f=NEWS;h=3fbe52269637c4e68aab0d70b0419343889a4d4f;hb=d8d6c819ee007eb03bc95a48a614bcefec229b42">NEWS</a> + file contained within the release. + </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> + 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>. + Please note this and future releases are signed with a new + <a href="/pgpkey.xhtml">PGP key</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> + 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> + Version 0.11 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 HP-UX (version 11.11), and + also fixes a few other minor issues. + </p> + <h3> + Wednesday 25 August 2004 + </h3> + <p> + Version 0.10.3 of libstatgrab has been released.<br /> + Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. + </p> + <p> + 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. + </p> + <h3> + Tuesday 27 July 2004 + </h3> + <p> + Version 0.10.2 of libstatgrab has been released.<br /> + Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. + </p> + <p> + This release fixes a problem with the shared library + version number in the last release. + </p> + <h3> + Monday 26 July 2004 + </h3> + <p> + Version 0.10.1 of libstatgrab has been released.<br /> + Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. + </p> + <p> + 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. + </p> + <h3> + Thursday 20 May 2004 + </h3> + <p> + Version 0.10 of libstatgrab has been released.<br /> + Download it from one of our <a href="/mirrors.xhtml">mirrors</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 its + <a href="/pystatgrab/">project page</a>. + </p> + <h2> + <a id="download">Downloading</a> + </h2> + <p> + The latest version of libstatgrab can be downloaded from + our <a href="/mirrors.xhtml">mirror sites</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. + </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</a> + </li> + <li> + <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 in touch so we + can add a link here. + </p> + <h2> + <a id="packages">Packages of libstatgrab</a> + </h2> + <ul> + <li> + <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=libstatgrab">Gentoo Linux</a> + </li> + <li> + <a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a> + </li> + <li> + <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 + that you can get for your favourite operating system. If + we've missed any out, please let us know. + </p> + <p> + We've noticed that Google throws up some RPM's relating + to Mandrake and Suse, but no webpage for them. + </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. First are the + manual pages for the command line tools: + </p> + <ul> + <li> + <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 also have an overview page for the library: + </p> + <ul> + <li> + <a href="docs/statgrab.3.html">statgrab(3)</a> + </li> + </ul> + <p> + Then we have the manual pages for each function: + </p> + <ul> + <li> + <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="docs/sg_get_network_io_stats.3.html">sg_get_network_io_stats(3)</a> + </li> + <li> + <a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a> + </li> + <li> + <a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a> + </li> + <li> + <a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a> + </li> + <li> + <a href="docs/sg_init.3.html">sg_init(3)</a> + </li> + <li> + <a href="docs/sg_internal-intro.3.html">sg_internal-intro(3)</a> + </li> + <li> + <a href="docs/sg_intro.3.html">sg_intro(3)</a> + </li> + <li> + <a href="docs/sg_lock_mutex.3.html">sg_lock_mutex(3)</a> + </li> + <li> + <a href="docs/sg_set_error.3.html">sg_set_error(3)</a> + </li> + <li> + <a href="docs/sg_vector_create.3.html">sg_vector_create(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> +<!--#include virtual="/menu.inc" --> + </div> + </body> </html>