ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/web/www/libstatgrab/index.xhtml
Revision: 1.59
Committed: Fri Aug 9 15:54:48 2013 UTC (11 years, 3 months ago) by tdb
Branch: MAIN
Changes since 1.58: +2 -0 lines
Log Message:
Mention 0.90 uses a new key.

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.56 Thursday 8 August 2013
80     </h3>
81     <p>
82     Version 0.90 of libstatgrab has been released.<br />
83     Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
84 tdb 1.59 Please note this and future releases are signed with a new
85     <a href="/pgpkeys.xhtml">PGP key</a>.
86 tdb 1.56 </p>
87     <p>
88     Please note that the API in 0.90 has changed, so
89     applications using libstatgrab will need to be updated to
90     support the changes.
91     </p>
92     <p>
93     There are a large number of changes in this version of
94     libstatgrab. Here is an overview:
95     </p>
96     <ul>
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
106     Mach.</li>
107     <li>Clean up the FreeBSD and Solaris implementations.</li>
108     <li>Clean up the FreeBSD and Solaris implementations.</li>
109     </ul>
110     <p>
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!
114     </p>
115     <p>
116     If you find any bugs in the release please report them
117     over at our
118     <a href="https://github.com/i-scream/libstatgrab/issues">Issue
119     Tracker</a> on GitHub.
120     </p>
121     <h3>
122 tdb 1.52 Sunday 21 February 2010
123     </h3>
124     <p>
125     Version 0.17 of libstatgrab has been released.<br />
126     Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
127     </p>
128     <p>
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.
135     </p>
136     <h3>
137 tdb 1.51 Friday 30 May 2008
138     </h3>
139     <p>
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!
143     </p>
144     <h3>
145 tdb 1.50 Monday 17 March 2008
146     </h3>
147     <p>
148     Version 0.16 of libstatgrab has been released.<br />
149     Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
150     </p>
151     <p>
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.
156     </p>
157     <h3>
158 tdb 1.48 Saturday 14 July 2007
159     </h3>
160     <p>
161     Version 0.15 of libstatgrab has been released.<br />
162     Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
163     </p>
164     <p>
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.
169     </p>
170     <h3>
171 tdb 1.45 Monday 8 January 2007
172     </h3>
173     <p>
174     Version 0.14 of libstatgrab has been released.<br />
175     Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
176     </p>
177     <p>
178     This release contains mainly bugfixes - see the NEWS file
179 tdb 1.46 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.
182 tdb 1.45 </p>
183     <h3>
184 tdb 1.43 Monday 20 March 2006
185     </h3>
186     <p>
187     Version 0.13 of libstatgrab has been released.<br />
188     Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
189     </p>
190     <p>
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
195     full details.
196     </p>
197     <h3>
198 tdb 1.40 Sunday 31 July 2005
199     </h3>
200     <p>
201     Version 0.12 of libstatgrab has been released.<br />
202     Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
203     </p>
204     <p>
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.
211     </p>
212     <p>
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
217     defined.
218     </p>
219     <h3>
220 tdb 1.38 Tuesday 26 April 2005
221     </h3>
222     <p>
223     Official libstatgrab packages for Debian now
224 tdb 1.39 <a href="http://packages.debian.org/unstable/source/libstatgrab">available</a>.
225 tdb 1.38 </p>
226     <p>
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
231     updated.
232     </p>
233     <h3>
234 tdb 1.36 Thursday 3 March 2005
235     </h3>
236     <p>
237     Version 0.11.1 of libstatgrab has been released.<br />
238     Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
239     </p>
240     <p>
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.
246     </p>
247     <h3>
248 tdb 1.31 Friday 12 November 2004
249     </h3>
250     <p>
251     Version 0.11 of libstatgrab has been released.<br />
252     Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
253     </p>
254     <p>
255     This release brings support for HP-UX (version 11.11), and
256     also fixes a few other minor issues.
257     </p>
258     <h3>
259 tdb 1.30 Wednesday 25 August 2004
260     </h3>
261     <p>
262     Version 0.10.3 of libstatgrab has been released.<br />
263     Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
264     </p>
265     <p>
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.
269     </p>
270     <h3>
271 tdb 1.28 Tuesday 27 July 2004
272     </h3>
273     <p>
274     Version 0.10.2 of libstatgrab has been released.<br />
275 tdb 1.29 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
276 tdb 1.28 </p>
277     <p>
278     This release fixes a problem with the shared library
279     version number in the last release.
280     </p>
281     <h3>
282 tdb 1.27 Monday 26 July 2004
283     </h3>
284     <p>
285     Version 0.10.1 of libstatgrab has been released.<br />
286 tdb 1.29 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
287 tdb 1.27 </p>
288     <p>
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
297     NEWS file.
298     </p>
299     <h3>
300 tdb 1.24 Thursday 20 May 2004
301     </h3>
302     <p>
303     Version 0.10 of libstatgrab has been released.<br />
304 tdb 1.29 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
305 tdb 1.24 </p>
306     <p>
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.
313     </p>
314     <p>
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.
322     </p>
323     <p>
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>.
328     </p>
329     <h3>
330 tdb 1.21 Sunday 21 March 2004
331     </h3>
332     <p>
333     pystatgrab, a new package containing a set of Python
334 tdb 1.45 bindings, has been released. Check out its
335 tdb 1.21 <a href="/pystatgrab/">project page</a>.
336     </p>
337     <h2>
338     <a id="download">Downloading</a>
339     </h2>
340     <p>
341     The latest version of libstatgrab can be downloaded from
342 tdb 1.29 our <a href="/mirrors.xhtml">mirror sites</a>.
343     All downloads are pgp signed using our
344 tdb 1.21 <a href="/pgpkey.xhtml">PGP Key</a>.
345     </p>
346     <p>
347     For installation instructions see the README and INSTALL
348 tdb 1.33 files contained within the archive.
349 tdb 1.22 </p>
350     <h2>
351 tdb 1.25 <a id="bindings">Language Bindings</a>
352     </h2>
353     <ul>
354     <li>
355     <a href="/pystatgrab/">Python</a>
356     </li>
357     <li>
358 tdb 1.51 <a href="http://pecl.php.net/statgrab/">PHP</a>
359     </li>
360     <li>
361     <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl</a>
362 tdb 1.25 </li>
363     <li>
364 tdb 1.51 <a href="http://statgrab.rubyforge.org/">Ruby</a>
365 tdb 1.25 </li>
366     </ul>
367     <p>
368     Here are links to bindings for higher level languages
369     that provide access to libstatgrab. If you've written
370 tdb 1.55 a binding for another language, please get in touch so we
371 tdb 1.25 can add a link here.
372 tdb 1.33 </p>
373     <h2>
374     <a id="packages">Packages of libstatgrab</a>
375     </h2>
376     <ul>
377     <li>
378 tdb 1.34 <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&amp;stype=all">FreeBSD</a>
379 tdb 1.33 </li>
380     <li>
381 tdb 1.45 <a href="http://packages.gentoo.org/search/?sstring=libstatgrab">Gentoo Linux</a>
382 tdb 1.33 </li>
383     <li>
384     <a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a>
385     </li>
386     <li>
387 tdb 1.44 <a href="http://www.sunfreeware.com/">Solaris (SunFreeware)</a>
388     </li>
389     <li>
390 tdb 1.53 <a href="http://www.opencsw.org/packages/libstatgrab/">Solaris (OpenCSW)</a>
391     </li>
392     <li>
393 tdb 1.39 <a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a>
394 tdb 1.33 </li>
395     <li>
396     <a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a>
397     </li>
398 tdb 1.47 <li>
399     <a href="http://software.opensuse.org/download/home:/anagappan/">RPMs for various Linux distributions</a>
400     </li>
401 tdb 1.49 <li>
402     <a href="http://www.openbsd.org/cgi-bin/cvsweb/ports/sysutils/libstatgrab/">OpenBSD</a>
403     </li>
404 tdb 1.33 </ul>
405     <p>
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.
409     </p>
410     <p>
411 tdb 1.56 We've noticed that Google throws up some RPM's relating
412 tdb 1.33 to Mandrake and Suse, but no webpage for them.
413     </p>
414 tdb 1.25 <h2>
415 tdb 1.21 <a id="documentation">Documentation</a>
416     </h2>
417     <p>
418     The only online documentation we have at the moment is the
419 tdb 1.43 manual pages converted in to HTML format. First are the
420     manual pages for the command line tools:
421     </p>
422     <ul>
423     <li>
424     <a href="docs/saidar.1.html">saidar(1)</a>
425     </li>
426     <li>
427     <a href="docs/statgrab.1.html">statgrab(1)</a>
428     </li>
429     <li>
430     <a href="docs/statgrab-make-mrtg-config.1.html">statgrab-make-mrtg-config(1)</a>
431     </li>
432     <li>
433     <a href="docs/statgrab-make-mrtg-index.1.html">statgrab-make-mrtg-index(1)</a>
434     </li>
435     </ul>
436     <p>
437     We also have an overview page for the library:
438 tdb 1.21 </p>
439     <ul>
440     <li>
441 tdb 1.43 <a href="docs/statgrab.3.html">statgrab(3)</a>
442 tdb 1.21 </li>
443     </ul>
444     <p>
445     Then we have the manual pages for each function:
446     </p>
447     <ul>
448     <li>
449 tdb 1.57 <a href="docs/sg_comp_init.3.html">sg_comp_init(3)</a>
450     </li>
451     <li>
452 tdb 1.43 <a href="docs/sg_get_cpu_stats.3.html">sg_get_cpu_stats(3)</a>
453 tdb 1.24 </li>
454     <li>
455 tdb 1.43 <a href="docs/sg_get_disk_io_stats.3.html">sg_get_disk_io_stats(3)</a>
456 tdb 1.21 </li>
457     <li>
458 tdb 1.57 <a href="docs/sg_get_error.3.html">sg_get_error(3)</a>
459     </li>
460     <li>
461 tdb 1.43 <a href="docs/sg_get_fs_stats.3.html">sg_get_fs_stats(3)</a>
462 tdb 1.21 </li>
463     <li>
464 tdb 1.43 <a href="docs/sg_get_host_info.3.html">sg_get_host_info(3)</a>
465 tdb 1.21 </li>
466     <li>
467 tdb 1.43 <a href="docs/sg_get_load_stats.3.html">sg_get_load_stats(3)</a>
468 tdb 1.21 </li>
469     <li>
470 tdb 1.43 <a href="docs/sg_get_mem_stats.3.html">sg_get_mem_stats(3)</a>
471 tdb 1.21 </li>
472     <li>
473 tdb 1.43 <a href="docs/sg_get_network_iface_stats.3.html">sg_get_network_iface_stats(3)</a>
474 tdb 1.21 </li>
475     <li>
476 tdb 1.43 <a href="docs/sg_get_network_io_stats.3.html">sg_get_network_io_stats(3)</a>
477 tdb 1.21 </li>
478     <li>
479 tdb 1.43 <a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a>
480 tdb 1.21 </li>
481     <li>
482 tdb 1.43 <a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a>
483 tdb 1.21 </li>
484     <li>
485 tdb 1.43 <a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a>
486 tdb 1.21 </li>
487 tdb 1.57 <li>
488     <a href="docs/sg_init.3.html">sg_init(3)</a>
489     </li>
490     <li>
491     <a href="docs/sg_internal-intro.3.html">sg_internal-intro(3)</a>
492     </li>
493     <li>
494     <a href="docs/sg_intro.3.html">sg_intro(3)</a>
495     </li>
496     <li>
497     <a href="docs/sg_lock_mutex.3.html">sg_lock_mutex(3)</a>
498     </li>
499     <li>
500     <a href="docs/sg_set_error.3.html">sg_set_error(3)</a>
501     </li>
502     <li>
503     <a href="docs/sg_vector_create.3.html">sg_vector_create(3)</a>
504     </li>
505 tdb 1.21 </ul>
506     <h2>
507     <a id="screenshot">Screenshot</a>
508     </h2>
509     <p>
510     Here's what saidar looks like when it's running:
511     </p>
512     <p>
513     <img src="saidar.png" alt="saidar screenshot" />
514     </p>
515     </div>
516 tdb 1.19 <!--#include virtual="/footer.inc" -->
517 tdb 1.21 </div>
518 tdb 1.19 <!--#include virtual="/menu.inc" -->
519 tdb 1.21 </div>
520     </body>
521 tdb 1.1 </html>