1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
7 <title>i-scream libstatgrab homepage</title>
8 <!--#include virtual="/style.inc" -->
17 <!--#include virtual="/header.inc" -->
21 <h1 class="top">i-scream libstatgrab homepage</h1>
25 <li><a href="#news">News</a></li>
26 <li><a href="#what">What is libstatgrab?</a></li>
27 <li><a href="#download">Downloading</a></li>
28 <li><a href="#documentation">Documentation</a></li>
29 <li><a href="#screenshot">Screenshot</a></li>
33 <h2><a name="news">News</a></h2>
36 To get notifications of new libstatgrab releases why not subscribe
37 to our project over on <a href="http://freshmeat.net/projects/libstatgrab/">
41 <h3>Sunday 21 March 2004</h3>
43 pystatgrab, a new package containing a set of Python bindings,
44 has been released. Check out it's <a href="/pystatgrab/">project
48 <h3>Wednesday 10 March 2004</h3>
50 Version 0.9 of libstatgrab has been released.<br/>
52 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.9.tar.gz">here</a>.
55 This release brings new features and new platforms. We've added
56 information about network interfaces (duplex, speed, etc) along
57 with further statistics such as i/o packets, i/o errors, and
58 collisions. Support has also been added for OpenBSD and DragonFly
59 BSD. Finally some work has been done to reduce the platforms on
60 which libstatgrab needs elevated privileges. See the NEWS file for
64 <h3>Wednesday 11 February 2004</h3>
66 Version 0.8.2 of libstatgrab has been released.<br/>
68 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.2.tar.gz">here</a>.
71 The main focus of this release is adding support for Solaris 6.
72 We've also added Python bindings so you can use libstatgrab directly
73 from Python (see the extras directory). Finally, we've tidied up a
77 <h3>Wednesday 21 January 2004</h3>
79 Version 0.8.1 of libstatgrab has been released.<br/>
81 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.1.tar.gz">here</a>.
84 This release primarily fixes bugs. On Linux a file descriptor leak was
85 fixed. On Solaris some significant speed increases were made to the
86 disk mapping code, along with some bug fixes for Solaris 7 platforms.
87 Also, the library part of libstatgrab (but not the tools) is now
88 released under the LGPL instead of the GPL.
91 <h3>Tuesday 6 January 2004</h3>
93 Version 0.8 of libstatgrab has been released.<br/>
95 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.tar.gz">here</a>.
98 This release brings support for Linux 2.6 and partial support for Cygwin.
99 On Solaris libstatgrab now returns disk names using cNtNdNsN names rather
100 than the older sdN names. There are also a bunch of fixes and optimisations
101 in various places. Finally, a new function has been added to make it
102 quicker to drop any elevated privileges libstatgrab may require on some
106 <h3>Wednesday 22 October 2003</h3>
108 Version 0.7 of libstatgrab has been released.<br/>
110 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.7.tar.gz">here</a>.
113 The most significant change in this release is support for NetBSD
114 1.6.x. Parts of the FreeBSD code have been optimised, and an initialise
115 function has been added to allow programs to drop any extra privileges
116 libstatgrab needs. The list of known file systems has been increased,
117 and libstatgrab has been tested on even more platforms. Finally,
118 saidar has been tweaked to work even if it can't get all the
122 <h3>Saturday 18 October 2003</h3>
124 Version 0.6.1 of libstatgrab has been released.<br/>
126 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.1.tar.gz">here</a>.
129 This release brings support for FreeBSD 5 on sparc 64, and some
130 bugfixes in FreeBSD memory statistics. Also, some fixes to saidar,
134 <h3>Friday 10 October 2003</h3>
136 Version 0.6 of libstatgrab has been released.<br/>
137 You can download it from our mirror site
138 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.tar.gz">here</a>.
141 This release includes some exciting new tools, support for FreeBSD
142 5.1, and documentation in manpages. Plus some major bugfixes and
143 packaging enhancements.
146 <h3>Tuesday 09 September 2003</h3>
148 We're pleased to announce a new release of libstatgrab.<br/>
149 You can download version 0.5.1 from
150 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.1.tar.gz">here</a>.
153 <h3>Monday 25 August 2003</h3>
155 We're pleased to announce a new release of libstatgrab.<br/>
156 You can download version 0.5 from
157 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.tar.gz">here</a>.
160 This release provides both documentation and examples, which
161 we hope will make the package more useable. Stay tuned for the
162 next release with some useful tools.
165 <h2><a name="what">What is libstatgrab?</a></h2>
168 libstatgrab is a library that provides cross platform access to
169 statistics about the system on which it's run. It's written in C and
170 presents a selection of useful interfaces which can be used to access
171 key system statistics. The current list of statistics includes CPU
172 usage, memory utilisation, disk usage, process counts, network
173 traffic, disk I/O, and more.
177 The current list of platforms is Solaris 2.x, Linux 2.2/2.4/2.6,
178 FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x, DragonFly BSD 1.0, and
179 Cygwin. The aim is to extend this to include as many operating
184 The package also includes a couple of useful tools. The first,
185 <a href="#screenshot">saidar</a>, provides a curses-based interface to
186 viewing the current state of the system. The second, statgrab, gives a
187 sysctl-style interface to the statistics gathered by libstatgrab. This
188 extends the use of libstatgrab to people writing scripts or anything
189 else that can't easily make C function calls. Included with statgrab is
190 a script to generate an <a href="http://www.mrtg.org">MRTG</a>
191 configuration file to use statgrab.
194 <h2><a name="download">Downloading</a></h2>
197 The latest version of libstatgrab can be downloaded from our
199 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/">mirror</a>.
200 All downloads are pgp signed using our <a href="/pgpkey.shtml">PGP Key</a>.
204 For installation instructions see the README and INSTALL files
205 contained within the archive. If you're using
206 <a href="http://www.freebsd.org">FreeBSD</a> you can make use of the
207 <a href="http://www.freshports.org/devel/libstatgrab">devel/libstatgrab</a>
208 port to install libstatgrab for you.
211 <h2><a name="documentation">Documentation</a></h2>
214 The only online documentation we have at the moment is the manual
215 pages converted in to HTML format. It's probably best to start with
216 the overview manual page:
220 <li><a href="statgrab.html">statgrab(3)</a></li>
224 Then we have the manual pages for each function:
228 <li><a href="cpu_percent_usage.html">cpu_percent_usage(3)</a></li>
229 <li><a href="get_diskio_stats.html">get_diskio_stats(3)</a></li>
230 <li><a href="get_general_stats.html">get_general_stats(3)</a></li>
231 <li><a href="get_load_stats.html">get_load_stats(3)</a></li>
232 <li><a href="get_memory_stats.html">get_memory_stats(3)</a></li>
233 <li><a href="get_network_iface_stats.html">get_network_iface_stats(3)</a></li>
234 <li><a href="get_network_stats.html">get_network_stats(3)</a></li>
235 <li><a href="get_page_stats.html">get_page_stats(3)</a></li>
236 <li><a href="get_process_stats.html">get_process_stats(3)</a></li>
237 <li><a href="get_user_stats.html">get_user_stats(3)</a></li>
240 <h2><a name="screenshot">Screenshot</a></h2>
243 Here's what saidar looks like when it's running:
246 <img src="saidar.png" alt="saidar screenshot" />
250 <!--#include virtual="/footer.inc" -->
254 <!--#include virtual="/menu.inc" -->