1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
11 <title>i-scream libstatgrab homepage</title>
14 <body bgcolor="#ffffff" link="#0000ff" alink="#3333cc" vlink="#3333cc" text="#000066">
16 <table border="0" cellpadding="2" cellspacing="2">
19 <!--#include virtual="../left.inc" -->
22 <!--#include virtual="../title.inc" -->
24 <font size="2" face="arial,sans-serif">
29 <li><a href="#news">News</a></li>
30 <li><a href="#what">What is libstatgrab?</a></li>
31 <li><a href="#download">Downloading</a></li>
32 <li><a href="#documentation">Documentation</a></li>
33 <li><a href="#screenshot">Screenshot</a></li>
36 <a name="news"><h2>News</h2></a>
39 To get notifications of new libstatgrab releases why not subscribe
40 to our project over on <a href="http://freshmeat.net/projects/libstatgrab/">
45 <b>Wednesday 10 March 2004</b><br><br>
46 Version 0.9 of libstatgrab has been released.<br>
48 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.9.tar.gz">here</a>.
49 This release brings new features and new platforms. We've added
50 information about network interfaces (duplex, speed, etc) along
51 with further statistics such as i/o packets and i/o errors. Support
52 has also been added for OpenBSD and DragonFly BSD. Finally some
53 work has been done to reduce the platforms on which libstatgrab
54 needs elevated privileges. See the NEWS file for more information.
58 <b>Wednesday 11 February 2004</b><br><br>
59 Version 0.8.2 of libstatgrab has been released.<br>
61 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.2.tar.gz">here</a>.
62 The main focus of this release is adding support for Solaris 6.
63 We've also added python bindings so you can use libstatgrab directly
64 from python (see the extras directory). Finally, we've tidied up a
69 <b>Wednesday 21 January 2004</b><br><br>
70 Version 0.8.1 of libstatgrab has been released.<br>
72 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.1.tar.gz">here</a>.
73 This release primarily fixes bugs. On Linux a file descriptor leak was
74 fixed. On Solaris some significant speed increases were made to the
75 disk mapping code, along with some bug fixes for Solaris 7 platforms.
76 Also, the library part of libstatgrab (but not the tools) is now
77 released under the LGPL instead of the GPL.
81 <b>Tuesday 6 January 2004</b><br><br>
82 Version 0.8 of libstatgrab has been released.<br>
84 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.tar.gz">here</a>.
85 This release brings support for Linux 2.6 and partial support for Cygwin.
86 On Solaris libstatgrab now returns disk names using cNtNdNsN names rather
87 than the older sdN names. There are also a bunch of fixes and optimisations
88 in various places. Finally, a new function has been added to make it
89 quicker to drop any elevated privileges libstatgrab may require on some
94 <b>Wednesday 22 October 2003</b><br><br>
95 Version 0.7 of libstatgrab has been released.<br>
97 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.7.tar.gz">here</a>.
98 The most significant change in this release is support for NetBSD
99 1.6.x. Parts of the FreeBSD code have been optimised, and an initialise
100 function has been added to allow programs to drop any extra privileges
101 libstatgrab needs. The list of known file systems has been increased,
102 and libstatgrab has been tested on even more platforms. Finally,
103 saidar has been tweaked to work even if it can't get all the
108 <b>Saturday 18 October 2003</b><br><br>
109 Version 0.6.1 of libstatgrab has been released.<br>
111 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.1.tar.gz">here</a>.
112 This release brings support for FreeBSD 5 on sparc 64, and some
113 bugfixes in FreeBSD memory statistics. Also, some fixes to saidar,
118 <b>Friday 10 October 2003</b><br><br>
119 Version 0.6 of libstatgrab has been released.<br>
120 You can download it from our mirror site
121 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.tar.gz">here</a>.
122 This release includes some exciting new tools, support for FreeBSD
123 5.1, and documentation in manpages. Plus some major bugfixes and
124 packaging enhancements.
128 <b>Tuesday 09 September 2003</b><br><br>
129 We're pleased to announce a new release of libstatgrab.<br>
130 You can download version 0.5.1 from
131 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.1.tar.gz">here</a>.
135 <b>Monday 25 August 2003</b><br><br>
136 We're pleased to announce a new release of libstatgrab.<br>
137 You can download version 0.5 from
138 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.tar.gz">here</a>.
139 This release provides both documentation and examples, which
140 we hope will make the package more useable. Stay tuned for the
141 next release with some useful tools.
144 <a name="what"><h2>What is libstatgrab?</h2></a>
147 libstatgrab is a library that provides cross platform access to
148 statistics about the system on which it's run. It's written in C and
149 presents a selection of useful interfaces which can be used to access
150 key system statistics. The current list of statistics includes CPU
151 usage, memory utilisation, disk usage, process counts, network
152 traffic, disk I/O, and more.
156 The current list of platforms is Solaris 2.x, Linux 2.2/2.4/2.6,
157 FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x, DragonFly BSD 1.0, and
158 Cygwin. The aim is to extend this to include as many operating
163 The package also includes a couple of useful tools. The first,
164 <a href="#screenshot">saidar</a>, provides a curses-based interface to
165 viewing the current state of the system. The second, statgrab, gives a
166 sysctl-style interface to the statistics gathered by libstatgrab. This
167 extends the use of libstatgrab to people writing scripts or anything
168 else that can't easily make C function calls. Included with statgrab is
169 a script to generate an <a href="http://www.mrtg.org">MRTG</a>
170 configuration file to use statgrab.
173 <a name="download"><h2>Downloading</h2></a>
176 The latest version of libstatgrab can be downloaded from our
178 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab">mirror</a>.
179 All downloads are pgp signed using our <a href="/pgpkey.shtml">PGP Key</a>.
183 For installation instructions see the README and INSTALL files
184 contained within the archive. If you're using
185 <a href="http://www.freebsd.org">FreeBSD</a> you can make use of the
186 <a href="http://www.freshports.org/devel/libstatgrab">devel/libstatgrab</a>
187 port to install libstatgrab for you.
190 <a name="documentation"><h2>Documentation</h2></a>
193 The only online documentation we have at the moment is the manual
194 pages converted in to HTML format. It's probably best to start with
195 the overview manual page:
198 <li><a href="statgrab.html">statgrab(3)</a></li>
203 Then we have the manual pages for each function:
206 <li><a href="cpu_percent_usage.html">cpu_percent_usage(3)</a></li>
207 <li><a href="get_diskio_stats.html">get_diskio_stats(3)</a></li>
208 <li><a href="get_general_stats.html">get_general_stats(3)</a></li>
209 <li><a href="get_load_stats.html">get_load_stats(3)</a></li>
210 <li><a href="get_memory_stats.html">get_memory_stats(3)</a></li>
211 <li><a href="get_network_iface_stats.html">get_network_iface_stats(3)</a></li>
212 <li><a href="get_network_stats.html">get_network_stats(3)</a></li>
213 <li><a href="get_page_stats.html">get_page_stats(3)</a></li>
214 <li><a href="get_process_stats.html">get_process_stats(3)</a></li>
215 <li><a href="get_user_stats.html">get_user_stats(3)</a></li>
219 <a name="screenshot"><h2>Screenshot</h2></a>
222 Here's what saidar looks like when it's running:
225 <img src="saidar.png" alt="saidar screenshot">
230 <!--#include virtual="../bottom.inc" -->