1 <!--#include virtual="/doctype.inc" -->
4 i-scream libstatgrab homepage
6 <!--#include virtual="/style.inc" -->
11 <!--#include virtual="/header.inc" -->
14 i-scream libstatgrab homepage
19 <a href="#what">What is libstatgrab?</a>
22 <a href="#news">News</a>
25 <a href="#download">Downloading</a>
28 <a href="#bindings">Language Bindings</a>
31 <a href="#packages">Packages</a>
34 <a href="#development">Development</a>
37 <a href="#documentation">Documentation</a>
40 <a href="#screenshot">Screenshot</a>
44 <!--#include virtual="/bannerad.inc" -->
46 <a id="what">What is libstatgrab?</a>
49 libstatgrab is a library that provides cross platform
50 access to statistics about the system on which it's run.
51 It's written in C and presents a selection of useful
52 interfaces which can be used to access key system
53 statistics. The current list of statistics includes CPU
54 usage, memory utilisation, disk usage, process counts,
55 network traffic, disk I/O, and more.
58 The current list of platforms is Solaris 2.x, Linux
59 2.2/2.4/2.6, FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x,
60 DragonFly BSD 1.0, HP-UX, and Cygwin. The aim is to extend
61 this to include as many operating systems as possible.
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
79 To get notifications of new libstatgrab releases why not
80 subscribe to our project over on
81 <a href="http://freshmeat.net/projects/libstatgrab/">freshmeat</a>?
87 Version 0.16 of libstatgrab has been released.<br />
88 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
91 This release fixes some minor build problems on Solaris
92 with Sun's compiler, and on the Debian "armel" port. Also
93 a minor fix to statgrab-make-mrtg-config on machines with
94 no swap, and added support for FreeBSD 8.
100 Version 0.15 of libstatgrab has been released.<br />
101 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
104 This release fixes a regression introduced on OpenBSD in
105 the last release - memory statistics were reported
106 incorrectly. Some other minor changes have been made, see
107 the NEWS file for more information.
110 Monday 8 January 2007
113 Version 0.14 of libstatgrab has been released.<br />
114 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
117 This release contains mainly bugfixes - see the NEWS file
118 in the distribution for a full list. It also brings a new
119 feature in saidar: colour support, which can be activated
120 with the -c runtime flag.
126 Version 0.13 of libstatgrab has been released.<br />
127 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
130 This release mainly includes a bunch of bug fixes, but
131 also brings preliminary support for WIN32. We've also
132 added a few lines to the header file to make C++ linking
133 easier. Please see the NEWS file in the distribution for
140 Version 0.12 of libstatgrab has been released.<br />
141 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
144 This release has some new features, bug fixes, and a minor
145 API change. More details have been added to the file
146 system statistics, linux partition detection has been
147 reworked, and compile errors on Linux 2.6 have been fixed.
148 Support has been added for Solaris 10 and FreeBSD 7.
149 There are also manual pages for all the tools.
152 The duplex value in the network interface statistics has
153 changed name from "dup" to "duplex" - this breaks the API.
154 We plan to stabilise the API for a 1.0 release. As before,
155 the old name is available if SG_ENABLE_DEPRECATED is
159 Tuesday 26 April 2005
162 Official libstatgrab packages for Debian now
163 <a href="http://packages.debian.org/unstable/source/libstatgrab">available</a>.
166 Thanks to the work of
167 <a href="mailto:fenio@debian.org">Bartosz Fenski</a>
168 libstatgrab is now available on debian. This replaces our
169 unofficial debian packages which will no longer be
173 Thursday 3 March 2005
176 Version 0.11.1 of libstatgrab has been released.<br />
177 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
180 This release fixes a handful of minor bugs. Duplex
181 settings were reported incorrectly on linux (half and
182 full duplex were swapped), saidar displayed negative
183 filesystem stats incorrectly, and NFS filesystems were
184 ignored. These have all been fixed.
187 Friday 12 November 2004
190 Version 0.11 of libstatgrab has been released.<br />
191 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
194 This release brings support for HP-UX (version 11.11), and
195 also fixes a few other minor issues.
198 Wednesday 25 August 2004
201 Version 0.10.3 of libstatgrab has been released.<br />
202 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
205 This release adds a handful of new features to statgrab, and
206 adds support for FreeBSD 6.0-CURRENT. See the NEWS file in
207 the tarball for more details.
213 Version 0.10.2 of libstatgrab has been released.<br />
214 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
217 This release fixes a problem with the shared library
218 version number in the last release.
224 Version 0.10.1 of libstatgrab has been released.<br />
225 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
228 This release consists almost entirely of bugfixes.
229 We've fixed compile-time errors for recent OpenBSD and
230 NetBSD platforms, and also a minor bug in statgrab
231 that broke network statistics on Solaris. New
232 variables have been added to the pkg-config file to
233 suggest ownership and permissions of binaries, and
234 we've added error reporting functions that store errno
235 values. There's also other minor fixes detailed in the
242 Version 0.10 of libstatgrab has been released.<br />
243 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
246 This release concentrates heavily on standardising the names
247 of functions and structures throughout libstatgrab. Although
248 this will mean changes for existing programs, in the long run
249 we hope it'll make things both clearer and easier. However,
250 for those who still need the old functions we have provided
251 compatibility wrappers. See the NEWS file for details.
254 The other main change in this release is a new function to
255 provide full details on currently running processes. See the
256 documentation for sg_get_process_stats for details. Along with
257 this there are compare functions for use with qsort for sorting
258 process, network, and disk io statistics. We've also introduced
259 error reporting functions that allow calling applications to
260 see why libstatgrab has returned a failure. See sg_get_error.
263 Finally, we've added support for NetBSD 2.0 and tidied up lots
264 of areas of the code. This release does not include the python
265 bindings - they're now available as their own project called
266 <a href="/pystatgrab/">pystatgrab</a>.
272 pystatgrab, a new package containing a set of Python
273 bindings, has been released. Check out its
274 <a href="/pystatgrab/">project page</a>.
277 <a id="download">Downloading</a>
280 The latest version of libstatgrab can be downloaded from
281 our <a href="/mirrors.xhtml">mirror sites</a>.
282 All downloads are pgp signed using our
283 <a href="/pgpkey.xhtml">PGP Key</a>.
286 For installation instructions see the README and INSTALL
287 files contained within the archive.
290 <a id="bindings">Language Bindings</a>
294 <a href="/pystatgrab/">Python</a>
297 <a href="http://pecl.php.net/statgrab/">PHP (external)</a>
300 <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl (external)</a>
304 Here are links to bindings for higher level languages
305 that provide access to libstatgrab. If you've written
306 a binding for another language, please get
307 <a href="mailto:support@i-scream.org">in touch</a> so we
311 <a id="packages">Packages of libstatgrab</a>
315 <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&stype=all">FreeBSD</a>
318 <a href="http://packages.gentoo.org/search/?sstring=libstatgrab">Gentoo Linux</a>
321 <a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a>
324 <a href="http://www.sunfreeware.com/">Solaris (SunFreeware)</a>
327 <a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a>
330 <a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a>
333 <a href="http://software.opensuse.org/download/home:/anagappan/">RPMs for various Linux distributions</a>
336 <a href="http://www.openbsd.org/cgi-bin/cvsweb/ports/sysutils/libstatgrab/">OpenBSD</a>
340 These are various pre-packaged versions of libstatgrab
341 that you can get for your favourite operating system. If
342 we've missed any out, please let us know.
345 We've noticed that google throws up some RPM's relating
346 to Mandrake and Suse, but no webpage for them.
349 <a id="development">Development</a>
353 <a href="/cgi-bin/cvslog.cgi?period=thisweek&module=projects/libstatgrab">Commits this week</a>
357 We develop libstatgrab using the CVS revision control system.
358 Using this link you can see what changes we've made this week.
359 For more information on our CVS setup see our
360 <a href="/cvs.xhtml">CVS page</a>.
363 <a id="documentation">Documentation</a>
366 The only online documentation we have at the moment is the
367 manual pages converted in to HTML format. First are the
368 manual pages for the command line tools:
372 <a href="docs/saidar.1.html">saidar(1)</a>
375 <a href="docs/statgrab.1.html">statgrab(1)</a>
378 <a href="docs/statgrab-make-mrtg-config.1.html">statgrab-make-mrtg-config(1)</a>
381 <a href="docs/statgrab-make-mrtg-index.1.html">statgrab-make-mrtg-index(1)</a>
385 We also have an overview page for the library:
389 <a href="docs/statgrab.3.html">statgrab(3)</a>
393 Then we have the manual pages for each function:
397 <a href="docs/sg_get_cpu_stats.3.html">sg_get_cpu_stats(3)</a>
400 <a href="docs/sg_get_disk_io_stats.3.html">sg_get_disk_io_stats(3)</a>
403 <a href="docs/sg_get_fs_stats.3.html">sg_get_fs_stats(3)</a>
406 <a href="docs/sg_get_host_info.3.html">sg_get_host_info(3)</a>
409 <a href="docs/sg_get_load_stats.3.html">sg_get_load_stats(3)</a>
412 <a href="docs/sg_get_mem_stats.3.html">sg_get_mem_stats(3)</a>
415 <a href="docs/sg_get_network_iface_stats.3.html">sg_get_network_iface_stats(3)</a>
418 <a href="docs/sg_get_network_io_stats.3.html">sg_get_network_io_stats(3)</a>
421 <a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a>
424 <a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a>
427 <a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a>
431 <a id="screenshot">Screenshot</a>
434 Here's what saidar looks like when it's running:
437 <img src="saidar.png" alt="saidar screenshot" />
440 <!--#include virtual="/footer.inc" -->
442 <!--#include virtual="/menu.inc" -->