ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/web/www/libstatgrab/index.xhtml
Revision: 1.42
Committed: Wed Mar 8 15:19:17 2006 UTC (18 years, 9 months ago) by tdb
Branch: MAIN
Changes since 1.41: +1 -0 lines
Log Message:
And one more, image.

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