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>Tuesday 6 January 2004</b><br><br>
46 Version 0.8 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.tar.gz">here</a>.
49 This release brings support for Linux 2.6 and partial support for Cygwin.
50 On Solaris libstatgrab now returns disk names using cNtNdNsN names rather
51 than the older sdN names. There are also a bunch of fixes and optimisations
52 in various places. Finally, a new function has been added to make it
53 quicker to drop any elevated privileges libstatgrab may require on some
58 <b>Wednesday 22 October 2003</b><br><br>
59 Version 0.7 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.7.tar.gz">here</a>.
62 The most significant change in this release is support for NetBSD
63 1.6.x. Parts of the FreeBSD code have been optimised, and an initialise
64 function has been added to allow programs to drop any extra privileges
65 libstatgrab needs. The list of known file systems has been increased,
66 and libstatgrab has been tested on even more platforms. Finally,
67 saidar has been tweaked to work even if it can't get all the
72 <b>Saturday 18 October 2003</b><br><br>
73 Version 0.6.1 of libstatgrab has been released.<br>
75 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.1.tar.gz">here</a>.
76 This release brings support for FreeBSD 5 on sparc 64, and some
77 bugfixes in FreeBSD memory statistics. Also, some fixes to saidar,
82 <b>Friday 10 October 2003</b><br><br>
83 Version 0.6 of libstatgrab has been released.<br>
84 You can download it from our mirror site
85 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.tar.gz">here</a>.
86 This release includes some exciting new tools, support for FreeBSD
87 5.1, and documentation in manpages. Plus some major bugfixes and
88 packaging enhancements.
92 <b>Tuesday 09 September 2003</b><br><br>
93 We're pleased to announce a new release of libstatgrab.<br>
94 You can download version 0.5.1 from
95 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.1.tar.gz">here</a>.
99 <b>Monday 25 August 2003</b><br><br>
100 We're pleased to announce a new release of libstatgrab.<br>
101 You can download version 0.5 from
102 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.tar.gz">here</a>.
103 This release provides both documentation and examples, which
104 we hope will make the package more useable. Stay tuned for the
105 next release with some useful tools.
108 <a name="what"><h2>What is libstatgrab?</h2></a>
111 libstatgrab is a library that provides cross platform access to
112 statistics about the system on which it's run. It's written in C and
113 presents a selection of useful interfaces which can be used to access
114 key system statistics. The current list of statistics includes CPU
115 usage, memory utilisation, disk usage, process counts, network
116 traffic, disk I/O, and more.
120 The current list of platforms is Solaris 2.x, Linux 2.4, FreeBSD
121 4.x/5.x, and NetBSD 1.6.x. The aim is to extend this to include as many
122 operating systems as possible.
126 The package also includes a couple of useful tools. The first,
127 <a href="#screenshot">saidar</a>, provides a curses-based interface to
128 viewing the current state of the system. The second, statgrab, gives a
129 sysctl-style interface to the statistics gathered by libstatgrab. This
130 extends the use of libstatgrab to people writing scripts or anything
131 else that can't easily make C function calls. Included with statgrab is
132 a script to generate an <a href="http://www.mrtg.org">MRTG</a>
133 configuration file to use statgrab.
136 <a name="download"><h2>Downloading</h2></a>
139 The latest version of libstatgrab can be downloaded from our
141 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab">mirror</a>.
142 All downloads are pgp signed using our <a href="/pgpkey.shtml">PGP Key</a>.
146 For installation instructions see the README and INSTALL files
147 contained within the archive. If you're using
148 <a href="http://www.freebsd.org">FreeBSD</a> you can make use of the
149 <a href="http://www.freshports.org/devel/libstatgrab">devel/libstatgrab</a>
150 port to install libstatgrab for you.
153 <a name="documentation"><h2>Documentation</h2></a>
156 The only online documentation we have at the moment is the manual
157 pages converted in to HTML format. It's probably best to start with
158 the overview manual page:
161 <li><a href="statgrab.html">statgrab(3)</a></li>
166 Then we have the manual pages for each function:
169 <li><a href="cpu_percent_usage.html">cpu_percent_usage(3)</a></li>
170 <li><a href="get_diskio_stats.html">get_diskio_stats(3)</a></li>
171 <li><a href="get_general_stats.html">get_general_stats(3)</a></li>
172 <li><a href="get_load_stats.html">get_load_stats(3)</a></li>
173 <li><a href="get_memory_stats.html">get_memory_stats(3)</a></li>
174 <li><a href="get_network_stats.html">get_network_stats(3)</a></li>
175 <li><a href="get_page_stats.html">get_page_stats(3)</a></li>
176 <li><a href="get_process_stats.html">get_process_stats(3)</a></li>
177 <li><a href="get_user_stats.html">get_user_stats(3)</a></li>
181 <a name="screenshot"><h2>Screenshot</h2></a>
184 Here's what saidar looks like when it's running:
187 <img src="saidar.png" alt="saidar screenshot">
192 <!--#include virtual="../bottom.inc" -->