ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/web/www/libstatgrab/index.xhtml
Revision: 1.25
Committed: Sun Jun 20 14:29:29 2004 UTC (20 years, 6 months ago) by tdb
Branch: MAIN
Changes since 1.24: +26 -2 lines
Log Message:
Add section on language bindings, with links to other peoples stuff.

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