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 11 February 2004</b><br><br>
46 Version 0.8.2 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.8.2.tar.gz">here</a>.
49 The main focus of this release is adding support for Solaris 6. We've also
50 add python bindings so you can use libstatgrab directly from python (see the
51 extras directory). Finally, we've tidied up a few bits of the code.
55 <b>Wednesday 21 January 2004</b><br><br>
56 Version 0.8.1 of libstatgrab has been released.<br>
58 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.1.tar.gz">here</a>.
59 This release primarily fixes bugs. On Linux a file descriptor leak was
60 fixed. On Solaris some significant speed increases were made to the
61 disk mapping code, along with some bug fixes for Solaris 7 platforms.
62 Also, the library part of libstatgrab (but not the tools) is now
63 released under the LGPL instead of the GPL.
67 <b>Tuesday 6 January 2004</b><br><br>
68 Version 0.8 of libstatgrab has been released.<br>
70 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.tar.gz">here</a>.
71 This release brings support for Linux 2.6 and partial support for Cygwin.
72 On Solaris libstatgrab now returns disk names using cNtNdNsN names rather
73 than the older sdN names. There are also a bunch of fixes and optimisations
74 in various places. Finally, a new function has been added to make it
75 quicker to drop any elevated privileges libstatgrab may require on some
80 <b>Wednesday 22 October 2003</b><br><br>
81 Version 0.7 of libstatgrab has been released.<br>
83 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.7.tar.gz">here</a>.
84 The most significant change in this release is support for NetBSD
85 1.6.x. Parts of the FreeBSD code have been optimised, and an initialise
86 function has been added to allow programs to drop any extra privileges
87 libstatgrab needs. The list of known file systems has been increased,
88 and libstatgrab has been tested on even more platforms. Finally,
89 saidar has been tweaked to work even if it can't get all the
94 <b>Saturday 18 October 2003</b><br><br>
95 Version 0.6.1 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.6.1.tar.gz">here</a>.
98 This release brings support for FreeBSD 5 on sparc 64, and some
99 bugfixes in FreeBSD memory statistics. Also, some fixes to saidar,
104 <b>Friday 10 October 2003</b><br><br>
105 Version 0.6 of libstatgrab has been released.<br>
106 You can download it from our mirror site
107 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.tar.gz">here</a>.
108 This release includes some exciting new tools, support for FreeBSD
109 5.1, and documentation in manpages. Plus some major bugfixes and
110 packaging enhancements.
114 <b>Tuesday 09 September 2003</b><br><br>
115 We're pleased to announce a new release of libstatgrab.<br>
116 You can download version 0.5.1 from
117 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.1.tar.gz">here</a>.
121 <b>Monday 25 August 2003</b><br><br>
122 We're pleased to announce a new release of libstatgrab.<br>
123 You can download version 0.5 from
124 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.tar.gz">here</a>.
125 This release provides both documentation and examples, which
126 we hope will make the package more useable. Stay tuned for the
127 next release with some useful tools.
130 <a name="what"><h2>What is libstatgrab?</h2></a>
133 libstatgrab is a library that provides cross platform access to
134 statistics about the system on which it's run. It's written in C and
135 presents a selection of useful interfaces which can be used to access
136 key system statistics. The current list of statistics includes CPU
137 usage, memory utilisation, disk usage, process counts, network
138 traffic, disk I/O, and more.
142 The current list of platforms is Solaris 2.x, Linux 2.4, FreeBSD
143 4.x/5.x, and NetBSD 1.6.x. The aim is to extend this to include as many
144 operating systems as possible.
148 The package also includes a couple of useful tools. The first,
149 <a href="#screenshot">saidar</a>, provides a curses-based interface to
150 viewing the current state of the system. The second, statgrab, gives a
151 sysctl-style interface to the statistics gathered by libstatgrab. This
152 extends the use of libstatgrab to people writing scripts or anything
153 else that can't easily make C function calls. Included with statgrab is
154 a script to generate an <a href="http://www.mrtg.org">MRTG</a>
155 configuration file to use statgrab.
158 <a name="download"><h2>Downloading</h2></a>
161 The latest version of libstatgrab can be downloaded from our
163 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab">mirror</a>.
164 All downloads are pgp signed using our <a href="/pgpkey.shtml">PGP Key</a>.
168 For installation instructions see the README and INSTALL files
169 contained within the archive. If you're using
170 <a href="http://www.freebsd.org">FreeBSD</a> you can make use of the
171 <a href="http://www.freshports.org/devel/libstatgrab">devel/libstatgrab</a>
172 port to install libstatgrab for you.
175 <a name="documentation"><h2>Documentation</h2></a>
178 The only online documentation we have at the moment is the manual
179 pages converted in to HTML format. It's probably best to start with
180 the overview manual page:
183 <li><a href="statgrab.html">statgrab(3)</a></li>
188 Then we have the manual pages for each function:
191 <li><a href="cpu_percent_usage.html">cpu_percent_usage(3)</a></li>
192 <li><a href="get_diskio_stats.html">get_diskio_stats(3)</a></li>
193 <li><a href="get_general_stats.html">get_general_stats(3)</a></li>
194 <li><a href="get_load_stats.html">get_load_stats(3)</a></li>
195 <li><a href="get_memory_stats.html">get_memory_stats(3)</a></li>
196 <li><a href="get_network_stats.html">get_network_stats(3)</a></li>
197 <li><a href="get_page_stats.html">get_page_stats(3)</a></li>
198 <li><a href="get_process_stats.html">get_process_stats(3)</a></li>
199 <li><a href="get_user_stats.html">get_user_stats(3)</a></li>
203 <a name="screenshot"><h2>Screenshot</h2></a>
206 Here's what saidar looks like when it's running:
209 <img src="saidar.png" alt="saidar screenshot">
214 <!--#include virtual="../bottom.inc" -->