]> i-scream Git - www.i-scream.org.git/blobdiff - www/libstatgrab/index.xhtml
Add libstatgrab 0.14 release notes.
[www.i-scream.org.git] / www / libstatgrab / index.xhtml
index 0b3d32d3873e84278a1ad179a7000d7a1379c2b7..c0755e6cda8c5edf763e3f4e80df8e1fe6be929f 100644 (file)
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-
-<!--
-    $Author$
-    $Id$
--->
-
-<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>
-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>
-
-<p>
-<b>Wednesday 22 October 2003</b><br><br>
-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>.
-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>
-
-<p>
-<b>Saturday 18 October 2003</b><br><br>
-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>.
-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>
-
-<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, FreeBSD
-4.x/5.x, and NetBSD 1.6.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>
+      i-scream 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">
+            i-scream 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>
+<!--#include virtual="/bannerad.inc" -->
+          <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, HP-UX, 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="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>
+            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
+            for a full list. The only new feature is colour support in
+            saidar 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 (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:support@i-scream.org">in touch</a> 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&amp;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://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>
+          </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>
+          <p>
+            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
+            <a href="http://ftp.i-scream.org/pub/i-scream/tmp/libstatgrab-0.11-openbsd-port.tar.gz">
+            here</a>.
+          </p>
+          <h2>
+            <a id="development">Development</a>
+          </h2>
+          <ul>
+            <li>
+              <a href="/cgi-bin/cvslog.cgi?period=thisweek&amp;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. 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_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_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>
+          </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>