ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/web/www/libstatgrab/index.xhtml
Revision: 1.45
Committed: Mon Jan 8 00:06:26 2007 UTC (17 years, 3 months ago) by tdb
Branch: MAIN
Changes since 1.44: +14 -2 lines
Log Message:
Add libstatgrab 0.14 release notes.

File Contents

# User Rev Content
1 tdb 1.20 <!--#include virtual="/doctype.inc" -->
2 tdb 1.21 <head>
3     <title>
4     i-scream libstatgrab homepage
5     </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     i-scream libstatgrab homepage
15     </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 tdb 1.42 <!--#include virtual="/bannerad.inc" -->
45 tdb 1.21 <h2>
46 tdb 1.37 <a id="what">What is libstatgrab?</a>
47     </h2>
48     <p>
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.
56     </p>
57     <p>
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.
62     </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     <p>
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>?
82     </p>
83     <h3>
84 tdb 1.45 Monday 8 January 2007
85     </h3>
86     <p>
87     Version 0.14 of libstatgrab has been released.<br />
88     Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
89     </p>
90     <p>
91     This release contains mainly bugfixes - see the NEWS file
92     for a full list. The only new feature is colour support in
93     saidar which can be activated with the -c runtime flag.
94     </p>
95     <h3>
96 tdb 1.43 Monday 20 March 2006
97     </h3>
98     <p>
99     Version 0.13 of libstatgrab has been released.<br />
100     Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
101     </p>
102     <p>
103     This release mainly includes a bunch of bug fixes, but
104     also brings preliminary support for WIN32. We've also
105     added a few lines to the header file to make C++ linking
106     easier. Please see the NEWS file in the distribution for
107     full details.
108     </p>
109     <h3>
110 tdb 1.40 Sunday 31 July 2005
111     </h3>
112     <p>
113     Version 0.12 of libstatgrab has been released.<br />
114     Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
115     </p>
116     <p>
117     This release has some new features, bug fixes, and a minor
118     API change. More details have been added to the file
119     system statistics, linux partition detection has been
120     reworked, and compile errors on Linux 2.6 have been fixed.
121     Support has been added for Solaris 10 and FreeBSD 7.
122     There are also manual pages for all the tools.
123     </p>
124     <p>
125     The duplex value in the network interface statistics has
126     changed name from "dup" to "duplex" - this breaks the API.
127     We plan to stabilise the API for a 1.0 release. As before,
128     the old name is available if SG_ENABLE_DEPRECATED is
129     defined.
130     </p>
131     <h3>
132 tdb 1.38 Tuesday 26 April 2005
133     </h3>
134     <p>
135     Official libstatgrab packages for Debian now
136 tdb 1.39 <a href="http://packages.debian.org/unstable/source/libstatgrab">available</a>.
137 tdb 1.38 </p>
138     <p>
139     Thanks to the work of
140     <a href="mailto:fenio@debian.org">Bartosz Fenski</a>
141     libstatgrab is now available on debian. This replaces our
142     unofficial debian packages which will no longer be
143     updated.
144     </p>
145     <h3>
146 tdb 1.36 Thursday 3 March 2005
147     </h3>
148     <p>
149     Version 0.11.1 of libstatgrab has been released.<br />
150     Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
151     </p>
152     <p>
153     This release fixes a handful of minor bugs. Duplex
154     settings were reported incorrectly on linux (half and
155     full duplex were swapped), saidar displayed negative
156     filesystem stats incorrectly, and NFS filesystems were
157     ignored. These have all been fixed.
158     </p>
159     <h3>
160 tdb 1.31 Friday 12 November 2004
161     </h3>
162     <p>
163     Version 0.11 of libstatgrab has been released.<br />
164     Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
165     </p>
166     <p>
167     This release brings support for HP-UX (version 11.11), and
168     also fixes a few other minor issues.
169     </p>
170     <h3>
171 tdb 1.30 Wednesday 25 August 2004
172     </h3>
173     <p>
174     Version 0.10.3 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 adds a handful of new features to statgrab, and
179     adds support for FreeBSD 6.0-CURRENT. See the NEWS file in
180     the tarball for more details.
181     </p>
182     <h3>
183 tdb 1.28 Tuesday 27 July 2004
184     </h3>
185     <p>
186     Version 0.10.2 of libstatgrab has been released.<br />
187 tdb 1.29 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
188 tdb 1.28 </p>
189     <p>
190     This release fixes a problem with the shared library
191     version number in the last release.
192     </p>
193     <h3>
194 tdb 1.27 Monday 26 July 2004
195     </h3>
196     <p>
197     Version 0.10.1 of libstatgrab has been released.<br />
198 tdb 1.29 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
199 tdb 1.27 </p>
200     <p>
201     This release consists almost entirely of bugfixes.
202     We've fixed compile-time errors for recent OpenBSD and
203     NetBSD platforms, and also a minor bug in statgrab
204     that broke network statistics on Solaris. New
205     variables have been added to the pkg-config file to
206     suggest ownership and permissions of binaries, and
207     we've added error reporting functions that store errno
208     values. There's also other minor fixes detailed in the
209     NEWS file.
210     </p>
211     <h3>
212 tdb 1.24 Thursday 20 May 2004
213     </h3>
214     <p>
215     Version 0.10 of libstatgrab has been released.<br />
216 tdb 1.29 Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
217 tdb 1.24 </p>
218     <p>
219     This release concentrates heavily on standardising the names
220     of functions and structures throughout libstatgrab. Although
221     this will mean changes for existing programs, in the long run
222     we hope it'll make things both clearer and easier. However,
223     for those who still need the old functions we have provided
224     compatibility wrappers. See the NEWS file for details.
225     </p>
226     <p>
227     The other main change in this release is a new function to
228     provide full details on currently running processes. See the
229     documentation for sg_get_process_stats for details. Along with
230     this there are compare functions for use with qsort for sorting
231     process, network, and disk io statistics. We've also introduced
232     error reporting functions that allow calling applications to
233     see why libstatgrab has returned a failure. See sg_get_error.
234     </p>
235     <p>
236     Finally, we've added support for NetBSD 2.0 and tidied up lots
237     of areas of the code. This release does not include the python
238     bindings - they're now available as their own project called
239     <a href="/pystatgrab/">pystatgrab</a>.
240     </p>
241     <h3>
242 tdb 1.21 Sunday 21 March 2004
243     </h3>
244     <p>
245     pystatgrab, a new package containing a set of Python
246 tdb 1.45 bindings, has been released. Check out its
247 tdb 1.21 <a href="/pystatgrab/">project page</a>.
248     </p>
249     <h2>
250     <a id="download">Downloading</a>
251     </h2>
252     <p>
253     The latest version of libstatgrab can be downloaded from
254 tdb 1.29 our <a href="/mirrors.xhtml">mirror sites</a>.
255     All downloads are pgp signed using our
256 tdb 1.21 <a href="/pgpkey.xhtml">PGP Key</a>.
257     </p>
258     <p>
259     For installation instructions see the README and INSTALL
260 tdb 1.33 files contained within the archive.
261 tdb 1.22 </p>
262     <h2>
263 tdb 1.25 <a id="bindings">Language Bindings</a>
264     </h2>
265     <ul>
266     <li>
267     <a href="/pystatgrab/">Python</a>
268     </li>
269     <li>
270     <a href="http://pecl.php.net/statgrab/">PHP (external)</a>
271     </li>
272     <li>
273     <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl (external)</a>
274     </li>
275     </ul>
276     <p>
277     Here are links to bindings for higher level languages
278     that provide access to libstatgrab. If you've written
279     a binding for another language, please get
280 tdb 1.41 <a href="mailto:support@i-scream.org">in touch</a> so we
281 tdb 1.25 can add a link here.
282 tdb 1.33 </p>
283     <h2>
284     <a id="packages">Packages of libstatgrab</a>
285     </h2>
286     <ul>
287     <li>
288 tdb 1.34 <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&amp;stype=all">FreeBSD</a>
289 tdb 1.33 </li>
290     <li>
291 tdb 1.45 <a href="http://packages.gentoo.org/search/?sstring=libstatgrab">Gentoo Linux</a>
292 tdb 1.33 </li>
293     <li>
294     <a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a>
295     </li>
296     <li>
297 tdb 1.44 <a href="http://www.sunfreeware.com/">Solaris (SunFreeware)</a>
298     </li>
299     <li>
300 tdb 1.39 <a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a>
301 tdb 1.33 </li>
302     <li>
303     <a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a>
304     </li>
305     </ul>
306     <p>
307     These are various pre-packaged versions of libstatgrab
308     that you can get for your favourite operating system. If
309     we've missed any out, please let us know.
310     </p>
311     <p>
312     We've noticed that google throws up some RPM's relating
313     to Mandrake and Suse, but no webpage for them.
314     </p>
315     <p>
316     Several attempts were made to submit a port to the
317     OpenBSD folk, but they didn't seem interested in taking
318     it. You can find it
319     <a href="http://ftp.i-scream.org/pub/i-scream/tmp/libstatgrab-0.11-openbsd-port.tar.gz">
320 tdb 1.35 here</a>.
321 tdb 1.25 </p>
322     <h2>
323 tdb 1.22 <a id="development">Development</a>
324     </h2>
325     <ul>
326     <li>
327 tdb 1.23 <a href="/cgi-bin/cvslog.cgi?period=thisweek&amp;module=projects/libstatgrab">Commits this week</a>
328 tdb 1.22 </li>
329     </ul>
330     <p>
331 tdb 1.25 We develop libstatgrab using the CVS revision control system.
332 tdb 1.22 Using this link you can see what changes we've made this week.
333 tdb 1.25 For more information on our CVS setup see our
334 tdb 1.22 <a href="/cvs.xhtml">CVS page</a>.
335 tdb 1.21 </p>
336     <h2>
337     <a id="documentation">Documentation</a>
338     </h2>
339     <p>
340     The only online documentation we have at the moment is the
341 tdb 1.43 manual pages converted in to HTML format. First are the
342     manual pages for the command line tools:
343     </p>
344     <ul>
345     <li>
346     <a href="docs/saidar.1.html">saidar(1)</a>
347     </li>
348     <li>
349     <a href="docs/statgrab.1.html">statgrab(1)</a>
350     </li>
351     <li>
352     <a href="docs/statgrab-make-mrtg-config.1.html">statgrab-make-mrtg-config(1)</a>
353     </li>
354     <li>
355     <a href="docs/statgrab-make-mrtg-index.1.html">statgrab-make-mrtg-index(1)</a>
356     </li>
357     </ul>
358     <p>
359     We also have an overview page for the library:
360 tdb 1.21 </p>
361     <ul>
362     <li>
363 tdb 1.43 <a href="docs/statgrab.3.html">statgrab(3)</a>
364 tdb 1.21 </li>
365     </ul>
366     <p>
367     Then we have the manual pages for each function:
368     </p>
369     <ul>
370     <li>
371 tdb 1.43 <a href="docs/sg_get_cpu_stats.3.html">sg_get_cpu_stats(3)</a>
372 tdb 1.24 </li>
373     <li>
374 tdb 1.43 <a href="docs/sg_get_disk_io_stats.3.html">sg_get_disk_io_stats(3)</a>
375 tdb 1.21 </li>
376     <li>
377 tdb 1.43 <a href="docs/sg_get_fs_stats.3.html">sg_get_fs_stats(3)</a>
378 tdb 1.21 </li>
379     <li>
380 tdb 1.43 <a href="docs/sg_get_host_info.3.html">sg_get_host_info(3)</a>
381 tdb 1.21 </li>
382     <li>
383 tdb 1.43 <a href="docs/sg_get_load_stats.3.html">sg_get_load_stats(3)</a>
384 tdb 1.21 </li>
385     <li>
386 tdb 1.43 <a href="docs/sg_get_mem_stats.3.html">sg_get_mem_stats(3)</a>
387 tdb 1.21 </li>
388     <li>
389 tdb 1.43 <a href="docs/sg_get_network_iface_stats.3.html">sg_get_network_iface_stats(3)</a>
390 tdb 1.21 </li>
391     <li>
392 tdb 1.43 <a href="docs/sg_get_network_io_stats.3.html">sg_get_network_io_stats(3)</a>
393 tdb 1.21 </li>
394     <li>
395 tdb 1.43 <a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a>
396 tdb 1.21 </li>
397     <li>
398 tdb 1.43 <a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a>
399 tdb 1.21 </li>
400     <li>
401 tdb 1.43 <a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a>
402 tdb 1.21 </li>
403     </ul>
404     <h2>
405     <a id="screenshot">Screenshot</a>
406     </h2>
407     <p>
408     Here's what saidar looks like when it's running:
409     </p>
410     <p>
411     <img src="saidar.png" alt="saidar screenshot" />
412     </p>
413     </div>
414 tdb 1.19 <!--#include virtual="/footer.inc" -->
415 tdb 1.21 </div>
416 tdb 1.19 <!--#include virtual="/menu.inc" -->
417 tdb 1.21 </div>
418     </body>
419 tdb 1.1 </html>