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.14 of libstatgrab has been released.<br />
88 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
91 This release contains mainly bugfixes - see the NEWS file
92 in the distribution for a full list. It also brings a new
93 feature in saidar: colour support, which can be activated
94 with the -c runtime flag.
100 Version 0.13 of libstatgrab has been released.<br />
101 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
104 This release mainly includes a bunch of bug fixes, but
105 also brings preliminary support for WIN32. We've also
106 added a few lines to the header file to make C++ linking
107 easier. Please see the NEWS file in the distribution for
114 Version 0.12 of libstatgrab has been released.<br />
115 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
118 This release has some new features, bug fixes, and a minor
119 API change. More details have been added to the file
120 system statistics, linux partition detection has been
121 reworked, and compile errors on Linux 2.6 have been fixed.
122 Support has been added for Solaris 10 and FreeBSD 7.
123 There are also manual pages for all the tools.
126 The duplex value in the network interface statistics has
127 changed name from "dup" to "duplex" - this breaks the API.
128 We plan to stabilise the API for a 1.0 release. As before,
129 the old name is available if SG_ENABLE_DEPRECATED is
133 Tuesday 26 April 2005
136 Official libstatgrab packages for Debian now
137 <a href="http://packages.debian.org/unstable/source/libstatgrab">available</a>.
140 Thanks to the work of
141 <a href="mailto:fenio@debian.org">Bartosz Fenski</a>
142 libstatgrab is now available on debian. This replaces our
143 unofficial debian packages which will no longer be
147 Thursday 3 March 2005
150 Version 0.11.1 of libstatgrab has been released.<br />
151 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
154 This release fixes a handful of minor bugs. Duplex
155 settings were reported incorrectly on linux (half and
156 full duplex were swapped), saidar displayed negative
157 filesystem stats incorrectly, and NFS filesystems were
158 ignored. These have all been fixed.
161 Friday 12 November 2004
164 Version 0.11 of libstatgrab has been released.<br />
165 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
168 This release brings support for HP-UX (version 11.11), and
169 also fixes a few other minor issues.
172 Wednesday 25 August 2004
175 Version 0.10.3 of libstatgrab has been released.<br />
176 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
179 This release adds a handful of new features to statgrab, and
180 adds support for FreeBSD 6.0-CURRENT. See the NEWS file in
181 the tarball for more details.
187 Version 0.10.2 of libstatgrab has been released.<br />
188 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
191 This release fixes a problem with the shared library
192 version number in the last release.
198 Version 0.10.1 of libstatgrab has been released.<br />
199 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
202 This release consists almost entirely of bugfixes.
203 We've fixed compile-time errors for recent OpenBSD and
204 NetBSD platforms, and also a minor bug in statgrab
205 that broke network statistics on Solaris. New
206 variables have been added to the pkg-config file to
207 suggest ownership and permissions of binaries, and
208 we've added error reporting functions that store errno
209 values. There's also other minor fixes detailed in the
216 Version 0.10 of libstatgrab has been released.<br />
217 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
220 This release concentrates heavily on standardising the names
221 of functions and structures throughout libstatgrab. Although
222 this will mean changes for existing programs, in the long run
223 we hope it'll make things both clearer and easier. However,
224 for those who still need the old functions we have provided
225 compatibility wrappers. See the NEWS file for details.
228 The other main change in this release is a new function to
229 provide full details on currently running processes. See the
230 documentation for sg_get_process_stats for details. Along with
231 this there are compare functions for use with qsort for sorting
232 process, network, and disk io statistics. We've also introduced
233 error reporting functions that allow calling applications to
234 see why libstatgrab has returned a failure. See sg_get_error.
237 Finally, we've added support for NetBSD 2.0 and tidied up lots
238 of areas of the code. This release does not include the python
239 bindings - they're now available as their own project called
240 <a href="/pystatgrab/">pystatgrab</a>.
246 pystatgrab, a new package containing a set of Python
247 bindings, has been released. Check out its
248 <a href="/pystatgrab/">project page</a>.
251 <a id="download">Downloading</a>
254 The latest version of libstatgrab can be downloaded from
255 our <a href="/mirrors.xhtml">mirror sites</a>.
256 All downloads are pgp signed using our
257 <a href="/pgpkey.xhtml">PGP Key</a>.
260 For installation instructions see the README and INSTALL
261 files contained within the archive.
264 <a id="bindings">Language Bindings</a>
268 <a href="/pystatgrab/">Python</a>
271 <a href="http://pecl.php.net/statgrab/">PHP (external)</a>
274 <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl (external)</a>
278 Here are links to bindings for higher level languages
279 that provide access to libstatgrab. If you've written
280 a binding for another language, please get
281 <a href="mailto:support@i-scream.org">in touch</a> so we
285 <a id="packages">Packages of libstatgrab</a>
289 <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&stype=all">FreeBSD</a>
292 <a href="http://packages.gentoo.org/search/?sstring=libstatgrab">Gentoo Linux</a>
295 <a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a>
298 <a href="http://www.sunfreeware.com/">Solaris (SunFreeware)</a>
301 <a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a>
304 <a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a>
308 These are various pre-packaged versions of libstatgrab
309 that you can get for your favourite operating system. If
310 we've missed any out, please let us know.
313 We've noticed that google throws up some RPM's relating
314 to Mandrake and Suse, but no webpage for them.
317 Several attempts were made to submit a port to the
318 OpenBSD folk, but they didn't seem interested in taking
320 <a href="http://ftp.i-scream.org/pub/i-scream/tmp/libstatgrab-0.11-openbsd-port.tar.gz">
324 <a id="development">Development</a>
328 <a href="/cgi-bin/cvslog.cgi?period=thisweek&module=projects/libstatgrab">Commits this week</a>
332 We develop libstatgrab using the CVS revision control system.
333 Using this link you can see what changes we've made this week.
334 For more information on our CVS setup see our
335 <a href="/cvs.xhtml">CVS page</a>.
338 <a id="documentation">Documentation</a>
341 The only online documentation we have at the moment is the
342 manual pages converted in to HTML format. First are the
343 manual pages for the command line tools:
347 <a href="docs/saidar.1.html">saidar(1)</a>
350 <a href="docs/statgrab.1.html">statgrab(1)</a>
353 <a href="docs/statgrab-make-mrtg-config.1.html">statgrab-make-mrtg-config(1)</a>
356 <a href="docs/statgrab-make-mrtg-index.1.html">statgrab-make-mrtg-index(1)</a>
360 We also have an overview page for the library:
364 <a href="docs/statgrab.3.html">statgrab(3)</a>
368 Then we have the manual pages for each function:
372 <a href="docs/sg_get_cpu_stats.3.html">sg_get_cpu_stats(3)</a>
375 <a href="docs/sg_get_disk_io_stats.3.html">sg_get_disk_io_stats(3)</a>
378 <a href="docs/sg_get_fs_stats.3.html">sg_get_fs_stats(3)</a>
381 <a href="docs/sg_get_host_info.3.html">sg_get_host_info(3)</a>
384 <a href="docs/sg_get_load_stats.3.html">sg_get_load_stats(3)</a>
387 <a href="docs/sg_get_mem_stats.3.html">sg_get_mem_stats(3)</a>
390 <a href="docs/sg_get_network_iface_stats.3.html">sg_get_network_iface_stats(3)</a>
393 <a href="docs/sg_get_network_io_stats.3.html">sg_get_network_io_stats(3)</a>
396 <a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a>
399 <a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a>
402 <a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a>
406 <a id="screenshot">Screenshot</a>
409 Here's what saidar looks like when it's running:
412 <img src="saidar.png" alt="saidar screenshot" />
415 <!--#include virtual="/footer.inc" -->
417 <!--#include virtual="/menu.inc" -->