ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/web/www/libstatgrab/index.xhtml
Revision: 1.51
Committed: Fri May 30 20:57:18 2008 UTC (16 years, 5 months ago) by tdb
Branch: MAIN
Changes since 1.50: +13 -2 lines
Log Message:
Add link to Ruby bindings and news item about them.

File Contents

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