ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/web/www/libstatgrab/index.xhtml
Revision: 1.55
Committed: Fri Jun 21 16:50:18 2013 UTC (11 years, 4 months ago) by tdb
Branch: MAIN
Changes since 1.54: +3 -23 lines
Log Message:
Various website updates.

The main change is the removal of RT email addresses.

File Contents

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