1 <!--#include virtual="/doctype.inc" -->
6 <!--#include virtual="/style.inc" -->
11 <!--#include virtual="/header.inc" -->
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 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
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 Thursday 8 August 2013
82 Version 0.90 of libstatgrab has been released.<br />
83 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
84 Please note this and future releases are signed with a new
85 <a href="/pgpkey.xhtml">PGP key</a>.
88 Please note that the API in 0.90 has changed, so
89 applications using libstatgrab will need to be updated to
93 There are a large number of changes in this version of
94 libstatgrab. Here is an overview:
97 <li>Thread safety and reentrant functions.</li>
98 <li>API unification (every stats call is now able to
99 return multiple entries).</li>
100 <li>Complete rewrite of internal memory management (eases
101 future extensions).</li>
102 <li>Add experimental support for tracing using log4cplus.</li>
103 <li>Complete the ports for AIX, HP-UX and most of the
104 widely used BSD-based operating systems.</li>
105 <li>Complete the port for Darwin/MacOS X including basic
107 <li>Clean up the FreeBSD and Solaris implementations.</li>
108 <li>Clean up the FreeBSD and Solaris implementations.</li>
111 This release is the result of a significant amount of work
112 by the newest member of the libstatgrab team - Jens
113 Rehsack. Welcome to the team Jens!
116 If you find any bugs in the release please report them
118 <a href="https://github.com/i-scream/libstatgrab/issues">Issue
119 Tracker</a> on GitHub.
122 Sunday 21 February 2010
125 Version 0.17 of libstatgrab has been released.<br />
126 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
129 This release adds support for FreeBSD 9 and other systems
130 using utmpx. Also on FreeBSD it fixes an issue with large
131 quantities of memory and adds support for dynamically
132 getting a list of supported file systems. On Solaris ZFS
133 file systems will now be detected. And finally on Linux CPU
134 iowait information will be given where available.
140 Dag Odenhall got in touch today to let us know he's written
141 <a href="http://statgrab.rubyforge.org/">Ruby bindings</a>
142 for libstatgrab. Thanks Dag!
148 Version 0.16 of libstatgrab has been released.<br />
149 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
152 This release fixes some minor build problems on Solaris
153 with Sun's compiler, and on the Debian "armel" port. Also
154 a minor fix to statgrab-make-mrtg-config on machines with
155 no swap, and added support for FreeBSD 8.
158 Saturday 14 July 2007
161 Version 0.15 of libstatgrab has been released.<br />
162 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
165 This release fixes a regression introduced on OpenBSD in
166 the last release - memory statistics were reported
167 incorrectly. Some other minor changes have been made, see
168 the NEWS file for more information.
171 Monday 8 January 2007
174 Version 0.14 of libstatgrab has been released.<br />
175 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
178 This release contains mainly bugfixes - see the NEWS file
179 in the distribution for a full list. It also brings a new
180 feature in saidar: colour support, which can be activated
181 with the -c runtime flag.
187 Version 0.13 of libstatgrab has been released.<br />
188 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
191 This release mainly includes a bunch of bug fixes, but
192 also brings preliminary support for WIN32. We've also
193 added a few lines to the header file to make C++ linking
194 easier. Please see the NEWS file in the distribution for
201 Version 0.12 of libstatgrab has been released.<br />
202 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
205 This release has some new features, bug fixes, and a minor
206 API change. More details have been added to the file
207 system statistics, linux partition detection has been
208 reworked, and compile errors on Linux 2.6 have been fixed.
209 Support has been added for Solaris 10 and FreeBSD 7.
210 There are also manual pages for all the tools.
213 The duplex value in the network interface statistics has
214 changed name from "dup" to "duplex" - this breaks the API.
215 We plan to stabilise the API for a 1.0 release. As before,
216 the old name is available if SG_ENABLE_DEPRECATED is
220 Tuesday 26 April 2005
223 Official libstatgrab packages for Debian now
224 <a href="http://packages.debian.org/unstable/source/libstatgrab">available</a>.
227 Thanks to the work of
228 <a href="mailto:fenio@debian.org">Bartosz Fenski</a>
229 libstatgrab is now available on debian. This replaces our
230 unofficial debian packages which will no longer be
234 Thursday 3 March 2005
237 Version 0.11.1 of libstatgrab has been released.<br />
238 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
241 This release fixes a handful of minor bugs. Duplex
242 settings were reported incorrectly on linux (half and
243 full duplex were swapped), saidar displayed negative
244 filesystem stats incorrectly, and NFS filesystems were
245 ignored. These have all been fixed.
248 Friday 12 November 2004
251 Version 0.11 of libstatgrab has been released.<br />
252 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
255 This release brings support for HP-UX (version 11.11), and
256 also fixes a few other minor issues.
259 Wednesday 25 August 2004
262 Version 0.10.3 of libstatgrab has been released.<br />
263 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
266 This release adds a handful of new features to statgrab, and
267 adds support for FreeBSD 6.0-CURRENT. See the NEWS file in
268 the tarball for more details.
274 Version 0.10.2 of libstatgrab has been released.<br />
275 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
278 This release fixes a problem with the shared library
279 version number in the last release.
285 Version 0.10.1 of libstatgrab has been released.<br />
286 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
289 This release consists almost entirely of bugfixes.
290 We've fixed compile-time errors for recent OpenBSD and
291 NetBSD platforms, and also a minor bug in statgrab
292 that broke network statistics on Solaris. New
293 variables have been added to the pkg-config file to
294 suggest ownership and permissions of binaries, and
295 we've added error reporting functions that store errno
296 values. There's also other minor fixes detailed in the
303 Version 0.10 of libstatgrab has been released.<br />
304 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
307 This release concentrates heavily on standardising the names
308 of functions and structures throughout libstatgrab. Although
309 this will mean changes for existing programs, in the long run
310 we hope it'll make things both clearer and easier. However,
311 for those who still need the old functions we have provided
312 compatibility wrappers. See the NEWS file for details.
315 The other main change in this release is a new function to
316 provide full details on currently running processes. See the
317 documentation for sg_get_process_stats for details. Along with
318 this there are compare functions for use with qsort for sorting
319 process, network, and disk io statistics. We've also introduced
320 error reporting functions that allow calling applications to
321 see why libstatgrab has returned a failure. See sg_get_error.
324 Finally, we've added support for NetBSD 2.0 and tidied up lots
325 of areas of the code. This release does not include the python
326 bindings - they're now available as their own project called
327 <a href="/pystatgrab/">pystatgrab</a>.
333 pystatgrab, a new package containing a set of Python
334 bindings, has been released. Check out its
335 <a href="/pystatgrab/">project page</a>.
338 <a id="download">Downloading</a>
341 The latest version of libstatgrab can be downloaded from
342 our <a href="/mirrors.xhtml">mirror sites</a>.
343 All downloads are pgp signed using our
344 <a href="/pgpkey.xhtml">PGP Key</a>.
347 For installation instructions see the README and INSTALL
348 files contained within the archive.
351 <a id="bindings">Language Bindings</a>
355 <a href="/pystatgrab/">Python</a>
358 <a href="http://pecl.php.net/statgrab/">PHP</a>
361 <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl</a>
364 <a href="http://statgrab.rubyforge.org/">Ruby</a>
368 Here are links to bindings for higher level languages
369 that provide access to libstatgrab. If you've written
370 a binding for another language, please get in touch so we
374 <a id="packages">Packages of libstatgrab</a>
378 <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&stype=all">FreeBSD</a>
381 <a href="http://packages.gentoo.org/search/?sstring=libstatgrab">Gentoo Linux</a>
384 <a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a>
387 <a href="http://www.sunfreeware.com/">Solaris (SunFreeware)</a>
390 <a href="http://www.opencsw.org/packages/libstatgrab/">Solaris (OpenCSW)</a>
393 <a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a>
396 <a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a>
399 <a href="http://software.opensuse.org/download/home:/anagappan/">RPMs for various Linux distributions</a>
402 <a href="http://www.openbsd.org/cgi-bin/cvsweb/ports/sysutils/libstatgrab/">OpenBSD</a>
406 These are various pre-packaged versions of libstatgrab
407 that you can get for your favourite operating system. If
408 we've missed any out, please let us know.
411 We've noticed that Google throws up some RPM's relating
412 to Mandrake and Suse, but no webpage for them.
415 <a id="documentation">Documentation</a>
418 The only online documentation we have at the moment is the
419 manual pages converted in to HTML format. First are the
420 manual pages for the command line tools:
424 <a href="docs/saidar.1.html">saidar(1)</a>
427 <a href="docs/statgrab.1.html">statgrab(1)</a>
430 <a href="docs/statgrab-make-mrtg-config.1.html">statgrab-make-mrtg-config(1)</a>
433 <a href="docs/statgrab-make-mrtg-index.1.html">statgrab-make-mrtg-index(1)</a>
437 We also have an overview page for the library:
441 <a href="docs/statgrab.3.html">statgrab(3)</a>
445 Then we have the manual pages for each function:
449 <a href="docs/sg_comp_init.3.html">sg_comp_init(3)</a>
452 <a href="docs/sg_get_cpu_stats.3.html">sg_get_cpu_stats(3)</a>
455 <a href="docs/sg_get_disk_io_stats.3.html">sg_get_disk_io_stats(3)</a>
458 <a href="docs/sg_get_error.3.html">sg_get_error(3)</a>
461 <a href="docs/sg_get_fs_stats.3.html">sg_get_fs_stats(3)</a>
464 <a href="docs/sg_get_host_info.3.html">sg_get_host_info(3)</a>
467 <a href="docs/sg_get_load_stats.3.html">sg_get_load_stats(3)</a>
470 <a href="docs/sg_get_mem_stats.3.html">sg_get_mem_stats(3)</a>
473 <a href="docs/sg_get_network_iface_stats.3.html">sg_get_network_iface_stats(3)</a>
476 <a href="docs/sg_get_network_io_stats.3.html">sg_get_network_io_stats(3)</a>
479 <a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a>
482 <a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a>
485 <a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a>
488 <a href="docs/sg_init.3.html">sg_init(3)</a>
491 <a href="docs/sg_internal-intro.3.html">sg_internal-intro(3)</a>
494 <a href="docs/sg_intro.3.html">sg_intro(3)</a>
497 <a href="docs/sg_lock_mutex.3.html">sg_lock_mutex(3)</a>
500 <a href="docs/sg_set_error.3.html">sg_set_error(3)</a>
503 <a href="docs/sg_vector_create.3.html">sg_vector_create(3)</a>
507 <a id="screenshot">Screenshot</a>
510 Here's what saidar looks like when it's running:
513 <img src="saidar.png" alt="saidar screenshot" />
516 <!--#include virtual="/footer.inc" -->
518 <!--#include virtual="/menu.inc" -->