ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/web/www/libstatgrab/index.xhtml
Revision: 1.34
Committed: Thu Jan 20 20:32:36 2005 UTC (19 years, 11 months ago) by tdb
Branch: MAIN
Changes since 1.33: +1 -1 lines
Log Message:
& -> &

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