ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/web/www/libstatgrab/index.xhtml
Revision: 1.48
Committed: Fri Jul 13 21:56:52 2007 UTC (17 years, 3 months ago) by tdb
Branch: MAIN
Changes since 1.47: +13 -0 lines
Log Message:
Libstatgrab 0.15. Ok, so it's not *quite* Saturday yet... ;-)

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