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>
45 <a id="what">What is libstatgrab?</a>
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.
57 The current list of platforms is Solaris 2.x, Linux
58 2.2/2.4/2.6, FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x,
59 DragonFly BSD 1.0, HP-UX, and Cygwin. The aim is to extend
60 this to include as many operating systems as possible.
63 The package also includes a couple of useful tools. The
64 first, <a href="#screenshot">saidar</a>, provides a
65 curses-based interface to viewing the current state of the
66 system. The second, statgrab, gives a sysctl-style
67 interface to the statistics gathered by libstatgrab. This
68 extends the use of libstatgrab to people writing scripts or
69 anything else that can't easily make C function calls.
70 Included with statgrab is a script to generate an
71 <a href="http://www.mrtg.org">MRTG</a> configuration file
78 To get notifications of new libstatgrab releases why not
79 subscribe to our project over on
80 <a href="http://freshmeat.net/projects/libstatgrab/">freshmeat</a>?
83 Sunday 21 February 2010
86 Version 0.17 of libstatgrab has been released.<br />
87 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
90 This release adds support for FreeBSD 9 and other systems
91 using utmpx. Also on FreeBSD it fixes an issue with large
92 quantities of memory and adds support for dynamically
93 getting a list of supported file systems. On Solaris ZFS
94 file systems will now be detected. And finally on Linux CPU
95 iowait information will be given where available.
101 Dag Odenhall got in touch today to let us know he's written
102 <a href="http://statgrab.rubyforge.org/">Ruby bindings</a>
103 for libstatgrab. Thanks Dag!
109 Version 0.16 of libstatgrab has been released.<br />
110 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
113 This release fixes some minor build problems on Solaris
114 with Sun's compiler, and on the Debian "armel" port. Also
115 a minor fix to statgrab-make-mrtg-config on machines with
116 no swap, and added support for FreeBSD 8.
119 Saturday 14 July 2007
122 Version 0.15 of libstatgrab has been released.<br />
123 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
126 This release fixes a regression introduced on OpenBSD in
127 the last release - memory statistics were reported
128 incorrectly. Some other minor changes have been made, see
129 the NEWS file for more information.
132 Monday 8 January 2007
135 Version 0.14 of libstatgrab has been released.<br />
136 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
139 This release contains mainly bugfixes - see the NEWS file
140 in the distribution for a full list. It also brings a new
141 feature in saidar: colour support, which can be activated
142 with the -c runtime flag.
148 Version 0.13 of libstatgrab has been released.<br />
149 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
152 This release mainly includes a bunch of bug fixes, but
153 also brings preliminary support for WIN32. We've also
154 added a few lines to the header file to make C++ linking
155 easier. Please see the NEWS file in the distribution for
162 Version 0.12 of libstatgrab has been released.<br />
163 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
166 This release has some new features, bug fixes, and a minor
167 API change. More details have been added to the file
168 system statistics, linux partition detection has been
169 reworked, and compile errors on Linux 2.6 have been fixed.
170 Support has been added for Solaris 10 and FreeBSD 7.
171 There are also manual pages for all the tools.
174 The duplex value in the network interface statistics has
175 changed name from "dup" to "duplex" - this breaks the API.
176 We plan to stabilise the API for a 1.0 release. As before,
177 the old name is available if SG_ENABLE_DEPRECATED is
181 Tuesday 26 April 2005
184 Official libstatgrab packages for Debian now
185 <a href="http://packages.debian.org/unstable/source/libstatgrab">available</a>.
188 Thanks to the work of
189 <a href="mailto:fenio@debian.org">Bartosz Fenski</a>
190 libstatgrab is now available on debian. This replaces our
191 unofficial debian packages which will no longer be
195 Thursday 3 March 2005
198 Version 0.11.1 of libstatgrab has been released.<br />
199 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
202 This release fixes a handful of minor bugs. Duplex
203 settings were reported incorrectly on linux (half and
204 full duplex were swapped), saidar displayed negative
205 filesystem stats incorrectly, and NFS filesystems were
206 ignored. These have all been fixed.
209 Friday 12 November 2004
212 Version 0.11 of libstatgrab has been released.<br />
213 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
216 This release brings support for HP-UX (version 11.11), and
217 also fixes a few other minor issues.
220 Wednesday 25 August 2004
223 Version 0.10.3 of libstatgrab has been released.<br />
224 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
227 This release adds a handful of new features to statgrab, and
228 adds support for FreeBSD 6.0-CURRENT. See the NEWS file in
229 the tarball for more details.
235 Version 0.10.2 of libstatgrab has been released.<br />
236 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
239 This release fixes a problem with the shared library
240 version number in the last release.
246 Version 0.10.1 of libstatgrab has been released.<br />
247 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
250 This release consists almost entirely of bugfixes.
251 We've fixed compile-time errors for recent OpenBSD and
252 NetBSD platforms, and also a minor bug in statgrab
253 that broke network statistics on Solaris. New
254 variables have been added to the pkg-config file to
255 suggest ownership and permissions of binaries, and
256 we've added error reporting functions that store errno
257 values. There's also other minor fixes detailed in the
264 Version 0.10 of libstatgrab has been released.<br />
265 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
268 This release concentrates heavily on standardising the names
269 of functions and structures throughout libstatgrab. Although
270 this will mean changes for existing programs, in the long run
271 we hope it'll make things both clearer and easier. However,
272 for those who still need the old functions we have provided
273 compatibility wrappers. See the NEWS file for details.
276 The other main change in this release is a new function to
277 provide full details on currently running processes. See the
278 documentation for sg_get_process_stats for details. Along with
279 this there are compare functions for use with qsort for sorting
280 process, network, and disk io statistics. We've also introduced
281 error reporting functions that allow calling applications to
282 see why libstatgrab has returned a failure. See sg_get_error.
285 Finally, we've added support for NetBSD 2.0 and tidied up lots
286 of areas of the code. This release does not include the python
287 bindings - they're now available as their own project called
288 <a href="/pystatgrab/">pystatgrab</a>.
294 pystatgrab, a new package containing a set of Python
295 bindings, has been released. Check out its
296 <a href="/pystatgrab/">project page</a>.
299 <a id="download">Downloading</a>
302 The latest version of libstatgrab can be downloaded from
303 our <a href="/mirrors.xhtml">mirror sites</a>.
304 All downloads are pgp signed using our
305 <a href="/pgpkey.xhtml">PGP Key</a>.
308 For installation instructions see the README and INSTALL
309 files contained within the archive.
312 <a id="bindings">Language Bindings</a>
316 <a href="/pystatgrab/">Python</a>
319 <a href="http://pecl.php.net/statgrab/">PHP</a>
322 <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl</a>
325 <a href="http://statgrab.rubyforge.org/">Ruby</a>
329 Here are links to bindings for higher level languages
330 that provide access to libstatgrab. If you've written
331 a binding for another language, please get
332 <a href="mailto:support@i-scream.org">in touch</a> so we
336 <a id="packages">Packages of libstatgrab</a>
340 <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&stype=all">FreeBSD</a>
343 <a href="http://packages.gentoo.org/search/?sstring=libstatgrab">Gentoo Linux</a>
346 <a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a>
349 <a href="http://www.sunfreeware.com/">Solaris (SunFreeware)</a>
352 <a href="http://www.opencsw.org/packages/libstatgrab/">Solaris (OpenCSW)</a>
355 <a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a>
358 <a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a>
361 <a href="http://software.opensuse.org/download/home:/anagappan/">RPMs for various Linux distributions</a>
364 <a href="http://www.openbsd.org/cgi-bin/cvsweb/ports/sysutils/libstatgrab/">OpenBSD</a>
368 These are various pre-packaged versions of libstatgrab
369 that you can get for your favourite operating system. If
370 we've missed any out, please let us know.
373 We've noticed that google throws up some RPM's relating
374 to Mandrake and Suse, but no webpage for them.
377 <a id="development">Development</a>
381 <a href="/cgi-bin/cvslog.cgi?period=thisweek&module=projects/libstatgrab">Commits this week</a>
385 We develop libstatgrab using the CVS revision control system.
386 Using this link you can see what changes we've made this week.
387 For more information on our CVS setup see our
388 <a href="/cvs.xhtml">CVS page</a>.
391 <a id="documentation">Documentation</a>
394 The only online documentation we have at the moment is the
395 manual pages converted in to HTML format. First are the
396 manual pages for the command line tools:
400 <a href="docs/saidar.1.html">saidar(1)</a>
403 <a href="docs/statgrab.1.html">statgrab(1)</a>
406 <a href="docs/statgrab-make-mrtg-config.1.html">statgrab-make-mrtg-config(1)</a>
409 <a href="docs/statgrab-make-mrtg-index.1.html">statgrab-make-mrtg-index(1)</a>
413 We also have an overview page for the library:
417 <a href="docs/statgrab.3.html">statgrab(3)</a>
421 Then we have the manual pages for each function:
425 <a href="docs/sg_get_cpu_stats.3.html">sg_get_cpu_stats(3)</a>
428 <a href="docs/sg_get_disk_io_stats.3.html">sg_get_disk_io_stats(3)</a>
431 <a href="docs/sg_get_fs_stats.3.html">sg_get_fs_stats(3)</a>
434 <a href="docs/sg_get_host_info.3.html">sg_get_host_info(3)</a>
437 <a href="docs/sg_get_load_stats.3.html">sg_get_load_stats(3)</a>
440 <a href="docs/sg_get_mem_stats.3.html">sg_get_mem_stats(3)</a>
443 <a href="docs/sg_get_network_iface_stats.3.html">sg_get_network_iface_stats(3)</a>
446 <a href="docs/sg_get_network_io_stats.3.html">sg_get_network_io_stats(3)</a>
449 <a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a>
452 <a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a>
455 <a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a>
459 <a id="screenshot">Screenshot</a>
462 Here's what saidar looks like when it's running:
465 <img src="saidar.png" alt="saidar screenshot" />
468 <!--#include virtual="/footer.inc" -->
470 <!--#include virtual="/menu.inc" -->