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