www/libstatgrab/index.xhtml

   1 <!--#include virtual="/doctype.inc" -->
   2   <head>
   3     <title>
   4       i-scream libstatgrab homepage
   5     </title>
   6 <!--#include virtual="/style.inc" -->
   7   </head>
   8   <body>
   9     <div id="container">
  10       <div id="main">
  11 <!--#include virtual="/header.inc" -->
  12         <div id="contents">
  13           <h1 class="top">
  14             i-scream libstatgrab homepage
  15           </h1>
  16           <div id="topnav">
  17             <ul>
  18               <li>
  19                 <a href="#news">News</a>
  20               </li>
  21               <li>
  22                 <a href="#what">What is libstatgrab?</a>
  23               </li>
  24               <li>
  25                 <a href="#download">Downloading</a>
  26               </li>
  27               <li>
  28                 <a href="#development">Development</a>
  29               </li>
  30               <li>
  31                 <a href="#documentation">Documentation</a>
  32               </li>
  33               <li>
  34                 <a href="#screenshot">Screenshot</a>
  35               </li>
  36             </ul>
  37           </div>
  38           <h2>
  39             <a id="news">News</a>
  40           </h2>
  41           <p>
  42             To get notifications of new libstatgrab releases why not
  43             subscribe to our project over on
  44             <a href="http://freshmeat.net/projects/libstatgrab/">freshmeat</a>?
  45           </p>
  46           <h3>
  47             Sunday 21 March 2004
  48           </h3>
  49           <p>
  50             pystatgrab, a new package containing a set of Python
  51             bindings, has been released. Check out it's
  52             <a href="/pystatgrab/">project page</a>.
  53           </p>
  54           <h3>
  55             Wednesday 10 March 2004
  56           </h3>
  57           <p>
  58             Version 0.9 of libstatgrab has been released.<br />
  59             Download it
  60             <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.9.tar.gz">
  61             here</a>.
  62           </p>
  63           <p>
  64             This release brings new features and new platforms. We've
  65             added information about network interfaces (duplex, speed,
  66             etc) along with further statistics such as i/o packets, i/o
  67             errors, and collisions. Support has also been added for
  68             OpenBSD and DragonFly BSD. Finally some work has been done
  69             to reduce the platforms on which libstatgrab needs elevated
  70             privileges. See the NEWS file for more information.
  71           </p>
  72           <h3>
  73             Wednesday 11 February 2004
  74           </h3>
  75           <p>
  76             Version 0.8.2 of libstatgrab has been released.<br />
  77             Download it
  78             <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.2.tar.gz">
  79             here</a>.
  80           </p>
  81           <p>
  82             The main focus of this release is adding support for
  83             Solaris 6. We've also added Python bindings so you can use
  84             libstatgrab directly from Python (see the extras
  85             directory). Finally, we've tidied up a few bits of the
  86             code.
  87           </p>
  88           <h3>
  89             Wednesday 21 January 2004
  90           </h3>
  91           <p>
  92             Version 0.8.1 of libstatgrab has been released.<br />
  93             Download it
  94             <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.1.tar.gz">
  95             here</a>.
  96           </p>
  97           <p>
  98             This release primarily fixes bugs. On Linux a file
  99             descriptor leak was fixed. On Solaris some significant
 100             speed increases were made to the disk mapping code, along
 101             with some bug fixes for Solaris 7 platforms. Also, the
 102             library part of libstatgrab (but not the tools) is now
 103             released under the LGPL instead of the GPL.
 104           </p>
 105           <h3>
 106             Tuesday 6 January 2004
 107           </h3>
 108           <p>
 109             Version 0.8 of libstatgrab has been released.<br />
 110             Download it
 111             <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.tar.gz">
 112             here</a>.
 113           </p>
 114           <p>
 115             This release brings support for Linux 2.6 and partial
 116             support for Cygwin. On Solaris libstatgrab now returns disk
 117             names using cNtNdNsN names rather than the older sdN names.
 118             There are also a bunch of fixes and optimisations in
 119             various places. Finally, a new function has been added to
 120             make it quicker to drop any elevated privileges libstatgrab
 121             may require on some operating systems.
 122           </p>
 123           <h3>
 124             Wednesday 22 October 2003
 125           </h3>
 126           <p>
 127             Version 0.7 of libstatgrab has been released.<br />
 128             Download it
 129             <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.7.tar.gz">
 130             here</a>.
 131           </p>
 132           <p>
 133             The most significant change in this release is support for
 134             NetBSD 1.6.x. Parts of the FreeBSD code have been
 135             optimised, and an initialise function has been added to
 136             allow programs to drop any extra privileges libstatgrab
 137             needs. The list of known file systems has been increased,
 138             and libstatgrab has been tested on even more platforms.
 139             Finally, saidar has been tweaked to work even if it can't
 140             get all the statistics.
 141           </p>
 142           <h3>
 143             Saturday 18 October 2003
 144           </h3>
 145           <p>
 146             Version 0.6.1 of libstatgrab has been released.<br />
 147             Download it
 148             <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.1.tar.gz">
 149             here</a>.
 150           </p>
 151           <p>
 152             This release brings support for FreeBSD 5 on sparc 64, and
 153             some bugfixes in FreeBSD memory statistics. Also, some
 154             fixes to saidar, and statgrab.
 155           </p>
 156           <h3>
 157             Friday 10 October 2003
 158           </h3>
 159           <p>
 160             Version 0.6 of libstatgrab has been released.<br />
 161             You can download it from our mirror site
 162             <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.tar.gz">
 163             here</a>.
 164           </p>
 165           <p>
 166             This release includes some exciting new tools, support for
 167             FreeBSD 5.1, and documentation in manpages. Plus some major
 168             bugfixes and packaging enhancements.
 169           </p>
 170           <h3>
 171             Tuesday 09 September 2003
 172           </h3>
 173           <p>
 174             We're pleased to announce a new release of
 175             libstatgrab.<br />
 176             You can download version 0.5.1 from
 177             <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.1.tar.gz">
 178             here</a>.
 179           </p>
 180           <h3>
 181             Monday 25 August 2003
 182           </h3>
 183           <p>
 184             We're pleased to announce a new release of
 185             libstatgrab.<br />
 186             You can download version 0.5 from
 187             <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.tar.gz">
 188             here</a>.
 189           </p>
 190           <p>
 191             This release provides both documentation and examples,
 192             which we hope will make the package more useable. Stay
 193             tuned for the next release with some useful tools.
 194           </p>
 195           <h2>
 196             <a id="what">What is libstatgrab?</a>
 197           </h2>
 198           <p>
 199             libstatgrab is a library that provides cross platform
 200             access to statistics about the system on which it's run.
 201             It's written in C and presents a selection of useful
 202             interfaces which can be used to access key system
 203             statistics. The current list of statistics includes CPU
 204             usage, memory utilisation, disk usage, process counts,
 205             network traffic, disk I/O, and more.
 206           </p>
 207           <p>
 208             The current list of platforms is Solaris 2.x, Linux
 209             2.2/2.4/2.6, FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x,
 210             DragonFly BSD 1.0, and Cygwin. The aim is to extend this to
 211             include as many operating systems as possible.
 212           </p>
 213           <p>
 214             The package also includes a couple of useful tools. The
 215             first, <a href="#screenshot">saidar</a>, provides a
 216             curses-based interface to viewing the current state of the
 217             system. The second, statgrab, gives a sysctl-style
 218             interface to the statistics gathered by libstatgrab. This
 219             extends the use of libstatgrab to people writing scripts or
 220             anything else that can't easily make C function calls.
 221             Included with statgrab is a script to generate an
 222             <a href="http://www.mrtg.org">MRTG</a> configuration file
 223             to use statgrab.
 224           </p>
 225           <h2>
 226             <a id="download">Downloading</a>
 227           </h2>
 228           <p>
 229             The latest version of libstatgrab can be downloaded from
 230             our primary download
 231             <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/">
 232             mirror</a>. All downloads are pgp signed using our
 233             <a href="/pgpkey.xhtml">PGP Key</a>.
 234           </p>
 235           <p>
 236             For installation instructions see the README and INSTALL
 237             files contained within the archive. If you're using
 238             <a href="http://www.freebsd.org">FreeBSD</a> you can make
 239             use of the
 240             <a href="http://www.freshports.org/devel/libstatgrab">
 241             devel/libstatgrab</a> port to install libstatgrab for you.
 242           </p>
 243           <h2>
 244             <a id="development">Development</a>
 245           </h2>
 246           <ul>
 247             <li>
 248               <a href="/cgi-bin/cvslog.cgi?period=thisweek&amp;module=projects/libstatgrab">Commits this week</a>
 249             </li>
 250           </ul>
 251           <p>
 252             We develop libstatgrab using the CVS revision control system.
 253             Using this link you can see what changes we've made this week.
 254             For more information on our CVS setup see our
 255             <a href="/cvs.xhtml">CVS page</a>.
 256           </p>
 257           <h2>
 258             <a id="documentation">Documentation</a>
 259           </h2>
 260           <p>
 261             The only online documentation we have at the moment is the
 262             manual pages converted in to HTML format. It's probably
 263             best to start with the overview manual page:
 264           </p>
 265           <ul>
 266             <li>
 267               <a href="statgrab.html">statgrab(3)</a>
 268             </li>
 269           </ul>
 270           <p>
 271             Then we have the manual pages for each function:
 272           </p>
 273           <ul>
 274             <li>
 275               <a href="cpu_percent_usage.html">cpu_percent_usage(3)</a>
 276             </li>
 277             <li>
 278               <a href="get_diskio_stats.html">get_diskio_stats(3)</a>
 279             </li>
 280             <li>
 281               <a href="get_general_stats.html">get_general_stats(3)</a>
 282             </li>
 283             <li>
 284               <a href="get_load_stats.html">get_load_stats(3)</a>
 285             </li>
 286             <li>
 287               <a href="get_memory_stats.html">get_memory_stats(3)</a>
 288             </li>
 289             <li>
 290               <a href="get_network_iface_stats.html">get_network_iface_stats(3)</a>
 291             </li>
 292             <li>
 293               <a href="get_network_stats.html">get_network_stats(3)</a>
 294             </li>
 295             <li>
 296               <a href="get_page_stats.html">get_page_stats(3)</a>
 297             </li>
 298             <li>
 299               <a href="get_process_stats.html">get_process_stats(3)</a>
 300             </li>
 301             <li>
 302               <a href="get_user_stats.html">get_user_stats(3)</a>
 303             </li>
 304           </ul>
 305           <h2>
 306             <a id="screenshot">Screenshot</a>
 307           </h2>
 308           <p>
 309             Here's what saidar looks like when it's running:
 310           </p>
 311           <p>
 312             <img src="saidar.png" alt="saidar screenshot" />
 313           </p>
 314         </div>
 315 <!--#include virtual="/footer.inc" -->
 316       </div>
 317 <!--#include virtual="/menu.inc" -->
 318     </div>
 319   </body>
 320 </html>