ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/web/www/libstatgrab/index.xhtml
Revision: 1.61
Committed: Mon Jul 14 16:00:44 2014 UTC (10 years, 5 months ago) by tdb
Branch: MAIN
CVS Tags: HEAD
Changes since 1.60: +34 -0 lines
Log Message:
Release libstatgrab 0.91 and pystatgrab 0.6.

File Contents

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