www/libstatgrab/index.xhtml

<!--#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>
            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>.
          </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&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://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>
Revision:	1.58
Committed:	Thu Aug 8 20:06:11 2013 UTC (11 years, 2 months ago) by tdb
Branch:	MAIN
Changes since 1.57:	+0 -1 lines
Log Message:	Docs are now updated.
#	User	Rev	Content
1	tdb	1.20	<!--#include virtual="/doctype.inc" -->
2	tdb	1.21	<head>
3			<title>
4	tdb	1.55	libstatgrab homepage
5	tdb	1.21	</title>
6	tdb	1.19	<!--#include virtual="/style.inc" -->
7	tdb	1.21	</head>
8			<body>
9			<div id="container">
10			<div id="main">
11	tdb	1.19	<!--#include virtual="/header.inc" -->
12	tdb	1.21	<div id="contents">
13			<h1 class="top">
14	tdb	1.55	libstatgrab homepage
15	tdb	1.21	</h1>
16			<div id="topnav">
17			<ul>
18			<li>
19	tdb	1.37	<a href="#what">What is libstatgrab?</a>
20	tdb	1.21	</li>
21			<li>
22	tdb	1.37	<a href="#news">News</a>
23	tdb	1.21	</li>
24			<li>
25			<a href="#download">Downloading</a>
26			</li>
27			<li>
28	tdb	1.25	<a href="#bindings">Language Bindings</a>
29			</li>
30			<li>
31	tdb	1.33	<a href="#packages">Packages</a>
32			</li>
33			<li>
34	tdb	1.22	<a href="#development">Development</a>
35			</li>
36			<li>
37	tdb	1.21	<a href="#documentation">Documentation</a>
38			</li>
39			<li>
40			<a href="#screenshot">Screenshot</a>
41			</li>
42			</ul>
43			</div>
44			<h2>
45	tdb	1.37	<a id="what">What is libstatgrab?</a>
46			</h2>
47			<p>
48			libstatgrab is a library that provides cross platform
49			access to statistics about the system on which it's run.
50			It's written in C and presents a selection of useful
51			interfaces which can be used to access key system
52			statistics. The current list of statistics includes CPU
53			usage, memory utilisation, disk usage, process counts,
54			network traffic, disk I/O, and more.
55			</p>
56			<p>
57	tdb	1.56	The current list of supported and tested platforms
58			includes FreeBSD, Linux, NetBSD, OpenBSD, Solaris,
59			DragonFly BSD, HP-UX and AIX. We are always happy to
60			accept patches to extend support to other operating
61			systems.
62	tdb	1.37	</p>
63			<p>
64			The package also includes a couple of useful tools. The
65			first, <a href="#screenshot">saidar</a>, provides a
66			curses-based interface to viewing the current state of the
67			system. The second, statgrab, gives a sysctl-style
68			interface to the statistics gathered by libstatgrab. This
69			extends the use of libstatgrab to people writing scripts or
70			anything else that can't easily make C function calls.
71			Included with statgrab is a script to generate an
72			<a href="http://www.mrtg.org">MRTG</a> configuration file
73			to use statgrab.
74			</p>
75			<h2>
76	tdb	1.21	<a id="news">News</a>
77			</h2>
78			<h3>
79	tdb	1.56	Thursday 8 August 2013
80			</h3>
81			<p>
82			Version 0.90 of libstatgrab has been released.<br />
83			Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
84			</p>
85			<p>
86			Please note that the API in 0.90 has changed, so
87			applications using libstatgrab will need to be updated to
88			support the changes.
89			</p>
90			<p>
91			There are a large number of changes in this version of
92			libstatgrab. Here is an overview:
93			</p>
94			<ul>
95			<li>Thread safety and reentrant functions.</li>
96			<li>API unification (every stats call is now able to
97			return multiple entries).</li>
98			<li>Complete rewrite of internal memory management (eases
99			future extensions).</li>
100			<li>Add experimental support for tracing using log4cplus.</li>
101			<li>Complete the ports for AIX, HP-UX and most of the
102			widely used BSD-based operating systems.</li>
103			<li>Complete the port for Darwin/MacOS X including basic
104			Mach.</li>
105			<li>Clean up the FreeBSD and Solaris implementations.</li>
106			<li>Clean up the FreeBSD and Solaris implementations.</li>
107			</ul>
108			<p>
109			This release is the result of a significant amount of work
110			by the newest member of the libstatgrab team - Jens
111			Rehsack. Welcome to the team Jens!
112			</p>
113			<p>
114			If you find any bugs in the release please report them
115			over at our
116			<a href="https://github.com/i-scream/libstatgrab/issues">Issue
117			Tracker</a> on GitHub.
118			</p>
119			<h3>
120	tdb	1.52	Sunday 21 February 2010
121			</h3>
122			<p>
123			Version 0.17 of libstatgrab has been released.<br />
124			Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
125			</p>
126			<p>
127			This release adds support for FreeBSD 9 and other systems
128			using utmpx. Also on FreeBSD it fixes an issue with large
129			quantities of memory and adds support for dynamically
130			getting a list of supported file systems. On Solaris ZFS
131			file systems will now be detected. And finally on Linux CPU
132			iowait information will be given where available.
133			</p>
134			<h3>
135	tdb	1.51	Friday 30 May 2008
136			</h3>
137			<p>
138			Dag Odenhall got in touch today to let us know he's written
139			<a href="http://statgrab.rubyforge.org/">Ruby bindings</a>
140			for libstatgrab. Thanks Dag!
141			</p>
142			<h3>
143	tdb	1.50	Monday 17 March 2008
144			</h3>
145			<p>
146			Version 0.16 of libstatgrab has been released.<br />
147			Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
148			</p>
149			<p>
150			This release fixes some minor build problems on Solaris
151			with Sun's compiler, and on the Debian "armel" port. Also
152			a minor fix to statgrab-make-mrtg-config on machines with
153			no swap, and added support for FreeBSD 8.
154			</p>
155			<h3>
156	tdb	1.48	Saturday 14 July 2007
157			</h3>
158			<p>
159			Version 0.15 of libstatgrab has been released.<br />
160			Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
161			</p>
162			<p>
163			This release fixes a regression introduced on OpenBSD in
164			the last release - memory statistics were reported
165			incorrectly. Some other minor changes have been made, see
166			the NEWS file for more information.
167			</p>
168			<h3>
169	tdb	1.45	Monday 8 January 2007
170			</h3>
171			<p>
172			Version 0.14 of libstatgrab has been released.<br />
173			Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
174			</p>
175			<p>
176			This release contains mainly bugfixes - see the NEWS file
177	tdb	1.46	in the distribution for a full list. It also brings a new
178			feature in saidar: colour support, which can be activated
179			with the -c runtime flag.
180	tdb	1.45	</p>
181			<h3>
182	tdb	1.43	Monday 20 March 2006
183			</h3>
184			<p>
185			Version 0.13 of libstatgrab has been released.<br />
186			Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
187			</p>
188			<p>
189			This release mainly includes a bunch of bug fixes, but
190			also brings preliminary support for WIN32. We've also
191			added a few lines to the header file to make C++ linking
192			easier. Please see the NEWS file in the distribution for
193			full details.
194			</p>
195			<h3>
196	tdb	1.40	Sunday 31 July 2005
197			</h3>
198			<p>
199			Version 0.12 of libstatgrab has been released.<br />
200			Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
201			</p>
202			<p>
203			This release has some new features, bug fixes, and a minor
204			API change. More details have been added to the file
205			system statistics, linux partition detection has been
206			reworked, and compile errors on Linux 2.6 have been fixed.
207			Support has been added for Solaris 10 and FreeBSD 7.
208			There are also manual pages for all the tools.
209			</p>
210			<p>
211			The duplex value in the network interface statistics has
212			changed name from "dup" to "duplex" - this breaks the API.
213			We plan to stabilise the API for a 1.0 release. As before,
214			the old name is available if SG_ENABLE_DEPRECATED is
215			defined.
216			</p>
217			<h3>
218	tdb	1.38	Tuesday 26 April 2005
219			</h3>
220			<p>
221			Official libstatgrab packages for Debian now
222	tdb	1.39	<a href="http://packages.debian.org/unstable/source/libstatgrab">available</a>.
223	tdb	1.38	</p>
224			<p>
225			Thanks to the work of
226			<a href="mailto:fenio@debian.org">Bartosz Fenski</a>
227			libstatgrab is now available on debian. This replaces our
228			unofficial debian packages which will no longer be
229			updated.
230			</p>
231			<h3>
232	tdb	1.36	Thursday 3 March 2005
233			</h3>
234			<p>
235			Version 0.11.1 of libstatgrab has been released.<br />
236			Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
237			</p>
238			<p>
239			This release fixes a handful of minor bugs. Duplex
240			settings were reported incorrectly on linux (half and
241			full duplex were swapped), saidar displayed negative
242			filesystem stats incorrectly, and NFS filesystems were
243			ignored. These have all been fixed.
244			</p>
245			<h3>
246	tdb	1.31	Friday 12 November 2004
247			</h3>
248			<p>
249			Version 0.11 of libstatgrab has been released.<br />
250			Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
251			</p>
252			<p>
253			This release brings support for HP-UX (version 11.11), and
254			also fixes a few other minor issues.
255			</p>
256			<h3>
257	tdb	1.30	Wednesday 25 August 2004
258			</h3>
259			<p>
260			Version 0.10.3 of libstatgrab has been released.<br />
261			Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
262			</p>
263			<p>
264			This release adds a handful of new features to statgrab, and
265			adds support for FreeBSD 6.0-CURRENT. See the NEWS file in
266			the tarball for more details.
267			</p>
268			<h3>
269	tdb	1.28	Tuesday 27 July 2004
270			</h3>
271			<p>
272			Version 0.10.2 of libstatgrab has been released.<br />
273	tdb	1.29	Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
274	tdb	1.28	</p>
275			<p>
276			This release fixes a problem with the shared library
277			version number in the last release.
278			</p>
279			<h3>
280	tdb	1.27	Monday 26 July 2004
281			</h3>
282			<p>
283			Version 0.10.1 of libstatgrab has been released.<br />
284	tdb	1.29	Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
285	tdb	1.27	</p>
286			<p>
287			This release consists almost entirely of bugfixes.
288			We've fixed compile-time errors for recent OpenBSD and
289			NetBSD platforms, and also a minor bug in statgrab
290			that broke network statistics on Solaris. New
291			variables have been added to the pkg-config file to
292			suggest ownership and permissions of binaries, and
293			we've added error reporting functions that store errno
294			values. There's also other minor fixes detailed in the
295			NEWS file.
296			</p>
297			<h3>
298	tdb	1.24	Thursday 20 May 2004
299			</h3>
300			<p>
301			Version 0.10 of libstatgrab has been released.<br />
302	tdb	1.29	Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
303	tdb	1.24	</p>
304			<p>
305			This release concentrates heavily on standardising the names
306			of functions and structures throughout libstatgrab. Although
307			this will mean changes for existing programs, in the long run
308			we hope it'll make things both clearer and easier. However,
309			for those who still need the old functions we have provided
310			compatibility wrappers. See the NEWS file for details.
311			</p>
312			<p>
313			The other main change in this release is a new function to
314			provide full details on currently running processes. See the
315			documentation for sg_get_process_stats for details. Along with
316			this there are compare functions for use with qsort for sorting
317			process, network, and disk io statistics. We've also introduced
318			error reporting functions that allow calling applications to
319			see why libstatgrab has returned a failure. See sg_get_error.
320			</p>
321			<p>
322			Finally, we've added support for NetBSD 2.0 and tidied up lots
323			of areas of the code. This release does not include the python
324			bindings - they're now available as their own project called
325			<a href="/pystatgrab/">pystatgrab</a>.
326			</p>
327			<h3>
328	tdb	1.21	Sunday 21 March 2004
329			</h3>
330			<p>
331			pystatgrab, a new package containing a set of Python
332	tdb	1.45	bindings, has been released. Check out its
333	tdb	1.21	<a href="/pystatgrab/">project page</a>.
334			</p>
335			<h2>
336			<a id="download">Downloading</a>
337			</h2>
338			<p>
339			The latest version of libstatgrab can be downloaded from
340	tdb	1.29	our <a href="/mirrors.xhtml">mirror sites</a>.
341			All downloads are pgp signed using our
342	tdb	1.21	<a href="/pgpkey.xhtml">PGP Key</a>.
343			</p>
344			<p>
345			For installation instructions see the README and INSTALL
346	tdb	1.33	files contained within the archive.
347	tdb	1.22	</p>
348			<h2>
349	tdb	1.25	<a id="bindings">Language Bindings</a>
350			</h2>
351			<ul>
352			<li>
353			<a href="/pystatgrab/">Python</a>
354			</li>
355			<li>
356	tdb	1.51	<a href="http://pecl.php.net/statgrab/">PHP</a>
357			</li>
358			<li>
359			<a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl</a>
360	tdb	1.25	</li>
361			<li>
362	tdb	1.51	<a href="http://statgrab.rubyforge.org/">Ruby</a>
363	tdb	1.25	</li>
364			</ul>
365			<p>
366			Here are links to bindings for higher level languages
367			that provide access to libstatgrab. If you've written
368	tdb	1.55	a binding for another language, please get in touch so we
369	tdb	1.25	can add a link here.
370	tdb	1.33	</p>
371			<h2>
372			<a id="packages">Packages of libstatgrab</a>
373			</h2>
374			<ul>
375			<li>
376	tdb	1.34	<a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&stype=all">FreeBSD</a>
377	tdb	1.33	</li>
378			<li>
379	tdb	1.45	<a href="http://packages.gentoo.org/search/?sstring=libstatgrab">Gentoo Linux</a>
380	tdb	1.33	</li>
381			<li>
382			<a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a>
383			</li>
384			<li>
385	tdb	1.44	<a href="http://www.sunfreeware.com/">Solaris (SunFreeware)</a>
386			</li>
387			<li>
388	tdb	1.53	<a href="http://www.opencsw.org/packages/libstatgrab/">Solaris (OpenCSW)</a>
389			</li>
390			<li>
391	tdb	1.39	<a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a>
392	tdb	1.33	</li>
393			<li>
394			<a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a>
395			</li>
396	tdb	1.47	<li>
397			<a href="http://software.opensuse.org/download/home:/anagappan/">RPMs for various Linux distributions</a>
398			</li>
399	tdb	1.49	<li>
400			<a href="http://www.openbsd.org/cgi-bin/cvsweb/ports/sysutils/libstatgrab/">OpenBSD</a>
401			</li>
402	tdb	1.33	</ul>
403			<p>
404			These are various pre-packaged versions of libstatgrab
405			that you can get for your favourite operating system. If
406			we've missed any out, please let us know.
407			</p>
408			<p>
409	tdb	1.56	We've noticed that Google throws up some RPM's relating
410	tdb	1.33	to Mandrake and Suse, but no webpage for them.
411			</p>
412	tdb	1.25	<h2>
413	tdb	1.21	<a id="documentation">Documentation</a>
414			</h2>
415			<p>
416			The only online documentation we have at the moment is the
417	tdb	1.43	manual pages converted in to HTML format. First are the
418			manual pages for the command line tools:
419			</p>
420			<ul>
421			<li>
422			<a href="docs/saidar.1.html">saidar(1)</a>
423			</li>
424			<li>
425			<a href="docs/statgrab.1.html">statgrab(1)</a>
426			</li>
427			<li>
428			<a href="docs/statgrab-make-mrtg-config.1.html">statgrab-make-mrtg-config(1)</a>
429			</li>
430			<li>
431			<a href="docs/statgrab-make-mrtg-index.1.html">statgrab-make-mrtg-index(1)</a>
432			</li>
433			</ul>
434			<p>
435			We also have an overview page for the library:
436	tdb	1.21	</p>
437			<ul>
438			<li>
439	tdb	1.43	<a href="docs/statgrab.3.html">statgrab(3)</a>
440	tdb	1.21	</li>
441			</ul>
442			<p>
443			Then we have the manual pages for each function:
444			</p>
445			<ul>
446			<li>
447	tdb	1.57	<a href="docs/sg_comp_init.3.html">sg_comp_init(3)</a>
448			</li>
449			<li>
450	tdb	1.43	<a href="docs/sg_get_cpu_stats.3.html">sg_get_cpu_stats(3)</a>
451	tdb	1.24	</li>
452			<li>
453	tdb	1.43	<a href="docs/sg_get_disk_io_stats.3.html">sg_get_disk_io_stats(3)</a>
454	tdb	1.21	</li>
455			<li>
456	tdb	1.57	<a href="docs/sg_get_error.3.html">sg_get_error(3)</a>
457			</li>
458			<li>
459	tdb	1.43	<a href="docs/sg_get_fs_stats.3.html">sg_get_fs_stats(3)</a>
460	tdb	1.21	</li>
461			<li>
462	tdb	1.43	<a href="docs/sg_get_host_info.3.html">sg_get_host_info(3)</a>
463	tdb	1.21	</li>
464			<li>
465	tdb	1.43	<a href="docs/sg_get_load_stats.3.html">sg_get_load_stats(3)</a>
466	tdb	1.21	</li>
467			<li>
468	tdb	1.43	<a href="docs/sg_get_mem_stats.3.html">sg_get_mem_stats(3)</a>
469	tdb	1.21	</li>
470			<li>
471	tdb	1.43	<a href="docs/sg_get_network_iface_stats.3.html">sg_get_network_iface_stats(3)</a>
472	tdb	1.21	</li>
473			<li>
474	tdb	1.43	<a href="docs/sg_get_network_io_stats.3.html">sg_get_network_io_stats(3)</a>
475	tdb	1.21	</li>
476			<li>
477	tdb	1.43	<a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a>
478	tdb	1.21	</li>
479			<li>
480	tdb	1.43	<a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a>
481	tdb	1.21	</li>
482			<li>
483	tdb	1.43	<a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a>
484	tdb	1.21	</li>
485	tdb	1.57	<li>
486			<a href="docs/sg_init.3.html">sg_init(3)</a>
487			</li>
488			<li>
489			<a href="docs/sg_internal-intro.3.html">sg_internal-intro(3)</a>
490			</li>
491			<li>
492			<a href="docs/sg_intro.3.html">sg_intro(3)</a>
493			</li>
494			<li>
495			<a href="docs/sg_lock_mutex.3.html">sg_lock_mutex(3)</a>
496			</li>
497			<li>
498			<a href="docs/sg_set_error.3.html">sg_set_error(3)</a>
499			</li>
500			<li>
501			<a href="docs/sg_vector_create.3.html">sg_vector_create(3)</a>
502			</li>
503	tdb	1.21	</ul>
504			<h2>
505			<a id="screenshot">Screenshot</a>
506			</h2>
507			<p>
508			Here's what saidar looks like when it's running:
509			</p>
510			<p>
511			<img src="saidar.png" alt="saidar screenshot" />
512			</p>
513			</div>
514	tdb	1.19	<!--#include virtual="/footer.inc" -->
515	tdb	1.21	</div>
516	tdb	1.19	<!--#include virtual="/menu.inc" -->
517	tdb	1.21	</div>
518			</body>
519	tdb	1.1	</html>