| 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | 
 
 
 
 
 | 2 |  | 
 
 
 
 
 | 3 | <!-- | 
 
 
 
 
 | 4 | $Author: tdb $ | 
 
 
 
 
 | 5 | $Id: index.shtml,v 1.17 2004/03/09 20:47:55 tdb Exp $ | 
 
 
 
 
 | 6 | --> | 
 
 
 
 
 | 7 |  | 
 
 
 
 
 | 8 | <html> | 
 
 
 
 
 | 9 |  | 
 
 
 
 
 | 10 | <head> | 
 
 
 
 
 | 11 | <title>i-scream libstatgrab homepage</title> | 
 
 
 
 
 | 12 | </head> | 
 
 
 
 
 | 13 |  | 
 
 
 
 
 | 14 | <body bgcolor="#ffffff" link="#0000ff" alink="#3333cc" vlink="#3333cc" text="#000066"> | 
 
 
 
 
 | 15 |  | 
 
 
 
 
 | 16 | <table border="0" cellpadding="2" cellspacing="2"> | 
 
 
 
 
 | 17 | <tr> | 
 
 
 
 
 | 18 | <td valign="top"> | 
 
 
 
 
 | 19 | <!--#include virtual="../left.inc" --> | 
 
 
 
 
 | 20 | </td> | 
 
 
 
 
 | 21 | <td valign="top"> | 
 
 
 
 
 | 22 | <!--#include virtual="../title.inc" --> | 
 
 
 
 
 | 23 |  | 
 
 
 
 
 | 24 | <font size="2" face="arial,sans-serif"> | 
 
 
 
 
 | 25 |  | 
 
 
 
 
 | 26 | <h1>libstatgrab</h1> | 
 
 
 
 
 | 27 |  | 
 
 
 
 
 | 28 | <ul> | 
 
 
 
 
 | 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> | 
 
 
 
 
 | 34 | </ul> | 
 
 
 
 
 | 35 |  | 
 
 
 
 
 | 36 | <a name="news"><h2>News</h2></a> | 
 
 
 
 
 | 37 |  | 
 
 
 
 
 | 38 | <p> | 
 
 
 
 
 | 39 | To get notifications of new libstatgrab releases why not subscribe | 
 
 
 
 
 | 40 | to our project over on <a href="http://freshmeat.net/projects/libstatgrab/"> | 
 
 
 
 
 | 41 | freshmeat</a>? | 
 
 
 
 
 | 42 | </p> | 
 
 
 
 
 | 43 |  | 
 
 
 
 
 | 44 | <p> | 
 
 
 
 
 | 45 | <b>Wednesday 10 March 2004</b><br><br> | 
 
 
 
 
 | 46 | Version 0.9 of libstatgrab has been released.<br> | 
 
 
 
 
 | 47 | Download it | 
 
 
 
 
 | 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, i/o errors, and | 
 
 
 
 
 | 52 | collisions. Support has also been added for OpenBSD and DragonFly | 
 
 
 
 
 | 53 | BSD. Finally some work has been done to reduce the platforms on | 
 
 
 
 
 | 54 | which libstatgrab needs elevated privileges. See the NEWS file for | 
 
 
 
 
 | 55 | more information. | 
 
 
 
 
 | 56 | </p> | 
 
 
 
 
 | 57 |  | 
 
 
 
 
 | 58 | <p> | 
 
 
 
 
 | 59 | <b>Wednesday 11 February 2004</b><br><br> | 
 
 
 
 
 | 60 | Version 0.8.2 of libstatgrab has been released.<br> | 
 
 
 
 
 | 61 | Download it | 
 
 
 
 
 | 62 | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.2.tar.gz">here</a>. | 
 
 
 
 
 | 63 | The main focus of this release is adding support for Solaris 6. | 
 
 
 
 
 | 64 | We've also added python bindings so you can use libstatgrab directly | 
 
 
 
 
 | 65 | from python (see the extras directory). Finally, we've tidied up a | 
 
 
 
 
 | 66 | few bits of the code. | 
 
 
 
 
 | 67 | </p> | 
 
 
 
 
 | 68 |  | 
 
 
 
 
 | 69 | <p> | 
 
 
 
 
 | 70 | <b>Wednesday 21 January 2004</b><br><br> | 
 
 
 
 
 | 71 | Version 0.8.1 of libstatgrab has been released.<br> | 
 
 
 
 
 | 72 | Download it | 
 
 
 
 
 | 73 | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.1.tar.gz">here</a>. | 
 
 
 
 
 | 74 | This release primarily fixes bugs. On Linux a file descriptor leak was | 
 
 
 
 
 | 75 | fixed. On Solaris some significant speed increases were made to the | 
 
 
 
 
 | 76 | disk mapping code, along with some bug fixes for Solaris 7 platforms. | 
 
 
 
 
 | 77 | Also, the library part of libstatgrab (but not the tools) is now | 
 
 
 
 
 | 78 | released under the LGPL instead of the GPL. | 
 
 
 
 
 | 79 | </p> | 
 
 
 
 
 | 80 |  | 
 
 
 
 
 | 81 | <p> | 
 
 
 
 
 | 82 | <b>Tuesday 6 January 2004</b><br><br> | 
 
 
 
 
 | 83 | Version 0.8 of libstatgrab has been released.<br> | 
 
 
 
 
 | 84 | Download it | 
 
 
 
 
 | 85 | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.tar.gz">here</a>. | 
 
 
 
 
 | 86 | This release brings support for Linux 2.6 and partial support for Cygwin. | 
 
 
 
 
 | 87 | On Solaris libstatgrab now returns disk names using cNtNdNsN names rather | 
 
 
 
 
 | 88 | than the older sdN names. There are also a bunch of fixes and optimisations | 
 
 
 
 
 | 89 | in various places. Finally, a new function has been added to make it | 
 
 
 
 
 | 90 | quicker to drop any elevated privileges libstatgrab may require on some | 
 
 
 
 
 | 91 | operating systems. | 
 
 
 
 
 | 92 | </p> | 
 
 
 
 
 | 93 |  | 
 
 
 
 
 | 94 | <p> | 
 
 
 
 
 | 95 | <b>Wednesday 22 October 2003</b><br><br> | 
 
 
 
 
 | 96 | Version 0.7 of libstatgrab has been released.<br> | 
 
 
 
 
 | 97 | Download it | 
 
 
 
 
 | 98 | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.7.tar.gz">here</a>. | 
 
 
 
 
 | 99 | The most significant change in this release is support for NetBSD | 
 
 
 
 
 | 100 | 1.6.x. Parts of the FreeBSD code have been optimised, and an initialise | 
 
 
 
 
 | 101 | function has been added to allow programs to drop any extra privileges | 
 
 
 
 
 | 102 | libstatgrab needs. The list of known file systems has been increased, | 
 
 
 
 
 | 103 | and libstatgrab has been tested on even more platforms.  Finally, | 
 
 
 
 
 | 104 | saidar has been tweaked to work even if it can't get all the | 
 
 
 
 
 | 105 | statistics. | 
 
 
 
 
 | 106 | </p> | 
 
 
 
 
 | 107 |  | 
 
 
 
 
 | 108 | <p> | 
 
 
 
 
 | 109 | <b>Saturday 18 October 2003</b><br><br> | 
 
 
 
 
 | 110 | Version 0.6.1 of libstatgrab has been released.<br> | 
 
 
 
 
 | 111 | Download it | 
 
 
 
 
 | 112 | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.1.tar.gz">here</a>. | 
 
 
 
 
 | 113 | This release brings support for FreeBSD 5 on sparc 64, and some | 
 
 
 
 
 | 114 | bugfixes in FreeBSD memory statistics. Also, some fixes to saidar, | 
 
 
 
 
 | 115 | and statgrab. | 
 
 
 
 
 | 116 | </p> | 
 
 
 
 
 | 117 |  | 
 
 
 
 
 | 118 | <p> | 
 
 
 
 
 | 119 | <b>Friday 10 October 2003</b><br><br> | 
 
 
 
 
 | 120 | Version 0.6 of libstatgrab has been released.<br> | 
 
 
 
 
 | 121 | You can download it from our mirror site | 
 
 
 
 
 | 122 | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.tar.gz">here</a>. | 
 
 
 
 
 | 123 | This release includes some exciting new tools, support for FreeBSD | 
 
 
 
 
 | 124 | 5.1, and documentation in manpages. Plus some major bugfixes and | 
 
 
 
 
 | 125 | packaging enhancements. | 
 
 
 
 
 | 126 | </p> | 
 
 
 
 
 | 127 |  | 
 
 
 
 
 | 128 | <p> | 
 
 
 
 
 | 129 | <b>Tuesday 09 September 2003</b><br><br> | 
 
 
 
 
 | 130 | We're pleased to announce a new release of libstatgrab.<br> | 
 
 
 
 
 | 131 | You can download version 0.5.1 from | 
 
 
 
 
 | 132 | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.1.tar.gz">here</a>. | 
 
 
 
 
 | 133 | </p> | 
 
 
 
 
 | 134 |  | 
 
 
 
 
 | 135 | <p> | 
 
 
 
 
 | 136 | <b>Monday 25 August 2003</b><br><br> | 
 
 
 
 
 | 137 | We're pleased to announce a new release of libstatgrab.<br> | 
 
 
 
 
 | 138 | You can download version 0.5 from | 
 
 
 
 
 | 139 | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.tar.gz">here</a>. | 
 
 
 
 
 | 140 | This release provides both documentation and examples, which | 
 
 
 
 
 | 141 | we hope will make the package more useable. Stay tuned for the | 
 
 
 
 
 | 142 | next release with some useful tools. | 
 
 
 
 
 | 143 | </p> | 
 
 
 
 
 | 144 |  | 
 
 
 
 
 | 145 | <a name="what"><h2>What is libstatgrab?</h2></a> | 
 
 
 
 
 | 146 |  | 
 
 
 
 
 | 147 | <p> | 
 
 
 
 
 | 148 | libstatgrab is a library that provides cross platform access to | 
 
 
 
 
 | 149 | statistics about the system on which it's run. It's written in C and | 
 
 
 
 
 | 150 | presents a selection of useful interfaces which can be used to access | 
 
 
 
 
 | 151 | key system statistics. The current list of statistics includes CPU | 
 
 
 
 
 | 152 | usage, memory utilisation, disk usage, process counts, network | 
 
 
 
 
 | 153 | traffic, disk I/O, and more. | 
 
 
 
 
 | 154 | </p> | 
 
 
 
 
 | 155 |  | 
 
 
 
 
 | 156 | <p> | 
 
 
 
 
 | 157 | The current list of platforms is Solaris 2.x, Linux 2.2/2.4/2.6, | 
 
 
 
 
 | 158 | FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x, DragonFly BSD 1.0, and | 
 
 
 
 
 | 159 | Cygwin. The aim is to extend this to include as many operating | 
 
 
 
 
 | 160 | systems as possible. | 
 
 
 
 
 | 161 | </p> | 
 
 
 
 
 | 162 |  | 
 
 
 
 
 | 163 | <p> | 
 
 
 
 
 | 164 | The package also includes a couple of useful tools. The first, | 
 
 
 
 
 | 165 | <a href="#screenshot">saidar</a>, provides a curses-based interface to | 
 
 
 
 
 | 166 | viewing the current state of the system. The second, statgrab, gives a | 
 
 
 
 
 | 167 | sysctl-style interface to the statistics gathered by libstatgrab. This | 
 
 
 
 
 | 168 | extends the use of libstatgrab to people writing scripts or anything | 
 
 
 
 
 | 169 | else that can't easily make C function calls. Included with statgrab is | 
 
 
 
 
 | 170 | a script to generate an <a href="http://www.mrtg.org">MRTG</a> | 
 
 
 
 
 | 171 | configuration file to use statgrab. | 
 
 
 
 
 | 172 | </p> | 
 
 
 
 
 | 173 |  | 
 
 
 
 
 | 174 | <a name="download"><h2>Downloading</h2></a> | 
 
 
 
 
 | 175 |  | 
 
 
 
 
 | 176 | <p> | 
 
 
 
 
 | 177 | The latest version of libstatgrab can be downloaded from our | 
 
 
 
 
 | 178 | primary download | 
 
 
 
 
 | 179 | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab">mirror</a>. | 
 
 
 
 
 | 180 | All downloads are pgp signed using our <a href="/pgpkey.shtml">PGP Key</a>. | 
 
 
 
 
 | 181 | </p> | 
 
 
 
 
 | 182 |  | 
 
 
 
 
 | 183 | <p> | 
 
 
 
 
 | 184 | For installation instructions see the README and INSTALL files | 
 
 
 
 
 | 185 | contained within the archive. If you're using | 
 
 
 
 
 | 186 | <a href="http://www.freebsd.org">FreeBSD</a> you can make use of the | 
 
 
 
 
 | 187 | <a href="http://www.freshports.org/devel/libstatgrab">devel/libstatgrab</a> | 
 
 
 
 
 | 188 | port to install libstatgrab for you. | 
 
 
 
 
 | 189 | </p> | 
 
 
 
 
 | 190 |  | 
 
 
 
 
 | 191 | <a name="documentation"><h2>Documentation</h2></a> | 
 
 
 
 
 | 192 |  | 
 
 
 
 
 | 193 | <p> | 
 
 
 
 
 | 194 | The only online documentation we have at the moment is the manual | 
 
 
 
 
 | 195 | pages converted in to HTML format. It's probably best to start with | 
 
 
 
 
 | 196 | the overview manual page: | 
 
 
 
 
 | 197 |  | 
 
 
 
 
 | 198 | <ul> | 
 
 
 
 
 | 199 | <li><a href="statgrab.html">statgrab(3)</a></li> | 
 
 
 
 
 | 200 | </ul> | 
 
 
 
 
 | 201 | </p> | 
 
 
 
 
 | 202 |  | 
 
 
 
 
 | 203 | <p> | 
 
 
 
 
 | 204 | Then we have the manual pages for each function: | 
 
 
 
 
 | 205 |  | 
 
 
 
 
 | 206 | <ul> | 
 
 
 
 
 | 207 | <li><a href="cpu_percent_usage.html">cpu_percent_usage(3)</a></li> | 
 
 
 
 
 | 208 | <li><a href="get_diskio_stats.html">get_diskio_stats(3)</a></li> | 
 
 
 
 
 | 209 | <li><a href="get_general_stats.html">get_general_stats(3)</a></li> | 
 
 
 
 
 | 210 | <li><a href="get_load_stats.html">get_load_stats(3)</a></li> | 
 
 
 
 
 | 211 | <li><a href="get_memory_stats.html">get_memory_stats(3)</a></li> | 
 
 
 
 
 | 212 | <li><a href="get_network_iface_stats.html">get_network_iface_stats(3)</a></li> | 
 
 
 
 
 | 213 | <li><a href="get_network_stats.html">get_network_stats(3)</a></li> | 
 
 
 
 
 | 214 | <li><a href="get_page_stats.html">get_page_stats(3)</a></li> | 
 
 
 
 
 | 215 | <li><a href="get_process_stats.html">get_process_stats(3)</a></li> | 
 
 
 
 
 | 216 | <li><a href="get_user_stats.html">get_user_stats(3)</a></li> | 
 
 
 
 
 | 217 | </ul> | 
 
 
 
 
 | 218 | </p> | 
 
 
 
 
 | 219 |  | 
 
 
 
 
 | 220 | <a name="screenshot"><h2>Screenshot</h2></a> | 
 
 
 
 
 | 221 |  | 
 
 
 
 
 | 222 | <p> | 
 
 
 
 
 | 223 | Here's what saidar looks like when it's running: | 
 
 
 
 
 | 224 | </p> | 
 
 
 
 
 | 225 | <p> | 
 
 
 
 
 | 226 | <img src="saidar.png" alt="saidar screenshot"> | 
 
 
 
 
 | 227 | </p> | 
 
 
 
 
 | 228 |  | 
 
 
 
 
 | 229 | </font> | 
 
 
 
 
 | 230 |  | 
 
 
 
 
 | 231 | <!--#include virtual="../bottom.inc" --> | 
 
 
 
 
 | 232 | </td> | 
 
 
 
 
 | 233 | </tr> | 
 
 
 
 
 | 234 | </table> | 
 
 
 
 
 | 235 |  | 
 
 
 
 
 | 236 | </body> | 
 
 
 
 
 | 237 | </html> |