ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/web/www/libstatgrab/index.xhtml
Revision: 1.41
Committed: Wed Mar 8 13:04:07 2006 UTC (18 years, 8 months ago) by tdb
Branch: MAIN
Changes since 1.40: +1 -1 lines
Log Message:
And a bunch more dev@ addresses.

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