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="#bindings">Language Bindings</a>
  29               </li>
  30               <li>
  31                 <a href="#development">Development</a>
  32               </li>
  33               <li>
  34                 <a href="#documentation">Documentation</a>
  35               </li>
  36               <li>
  37                 <a href="#screenshot">Screenshot</a>
  38               </li>
  39             </ul>
  40           </div>
  41           <h2>
  42             <a id="news">News</a>
  43           </h2>
  44           <p>
  45             To get notifications of new libstatgrab releases why not
  46             subscribe to our project over on
  47             <a href="http://freshmeat.net/projects/libstatgrab/">freshmeat</a>?
  48           </p>
  49           <h3>
  50             Thursday 20 May 2004
  51           </h3>
  52           <p>
  53             Version 0.10 of libstatgrab has been released.<br />
  54             Download it
  55             <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.10.tar.gz">
  56             here</a>.
  57           </p>
  58           <p>
  59             This release concentrates heavily on standardising the names
  60             of functions and structures throughout libstatgrab. Although
  61             this will mean changes for existing programs, in the long run
  62             we hope it'll make things both clearer and easier. However,
  63             for those who still need the old functions we have provided
  64             compatibility wrappers. See the NEWS file for details.
  65           </p>
  66           <p>
  67             The other main change in this release is a new function to
  68             provide full details on currently running processes. See the
  69             documentation for sg_get_process_stats for details. Along with
  70             this there are compare functions for use with qsort for sorting
  71             process, network, and disk io statistics. We've also introduced
  72             error reporting functions that allow calling applications to
  73             see why libstatgrab has returned a failure. See sg_get_error.
  74           </p>
  75           <p>
  76             Finally, we've added support for NetBSD 2.0 and tidied up lots
  77             of areas of the code. This release does not include the python
  78             bindings - they're now available as their own project called
  79             <a href="/pystatgrab/">pystatgrab</a>.
  80           </p>
  81           <h3>
  82             Sunday 21 March 2004
  83           </h3>
  84           <p>
  85             pystatgrab, a new package containing a set of Python
  86             bindings, has been released. Check out it's
  87             <a href="/pystatgrab/">project page</a>.
  88           </p>
  89           <h3>
  90             Wednesday 10 March 2004
  91           </h3>
  92           <p>
  93             Version 0.9 of libstatgrab has been released.<br />
  94             Download it
  95             <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.9.tar.gz">
  96             here</a>.
  97           </p>
  98           <p>
  99             This release brings new features and new platforms. We've
 100             added information about network interfaces (duplex, speed,
 101             etc) along with further statistics such as i/o packets, i/o
 102             errors, and collisions. Support has also been added for
 103             OpenBSD and DragonFly BSD. Finally some work has been done
 104             to reduce the platforms on which libstatgrab needs elevated
 105             privileges. See the NEWS file for more information.
 106           </p>
 107           <h3>
 108             Wednesday 11 February 2004
 109           </h3>
 110           <p>
 111             Version 0.8.2 of libstatgrab has been released.<br />
 112             Download it
 113             <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.2.tar.gz">
 114             here</a>.
 115           </p>
 116           <p>
 117             The main focus of this release is adding support for
 118             Solaris 6. We've also added Python bindings so you can use
 119             libstatgrab directly from Python (see the extras
 120             directory). Finally, we've tidied up a few bits of the
 121             code.
 122           </p>
 123           <h3>
 124             Wednesday 21 January 2004
 125           </h3>
 126           <p>
 127             Version 0.8.1 of libstatgrab has been released.<br />
 128             Download it
 129             <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.1.tar.gz">
 130             here</a>.
 131           </p>
 132           <p>
 133             This release primarily fixes bugs. On Linux a file
 134             descriptor leak was fixed. On Solaris some significant
 135             speed increases were made to the disk mapping code, along
 136             with some bug fixes for Solaris 7 platforms. Also, the
 137             library part of libstatgrab (but not the tools) is now
 138             released under the LGPL instead of the GPL.
 139           </p>
 140           <h3>
 141             Tuesday 6 January 2004
 142           </h3>
 143           <p>
 144             Version 0.8 of libstatgrab has been released.<br />
 145             Download it
 146             <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.tar.gz">
 147             here</a>.
 148           </p>
 149           <p>
 150             This release brings support for Linux 2.6 and partial
 151             support for Cygwin. On Solaris libstatgrab now returns disk
 152             names using cNtNdNsN names rather than the older sdN names.
 153             There are also a bunch of fixes and optimisations in
 154             various places. Finally, a new function has been added to
 155             make it quicker to drop any elevated privileges libstatgrab
 156             may require on some operating systems.
 157           </p>
 158           <h3>
 159             Wednesday 22 October 2003
 160           </h3>
 161           <p>
 162             Version 0.7 of libstatgrab has been released.<br />
 163             Download it
 164             <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.7.tar.gz">
 165             here</a>.
 166           </p>
 167           <p>
 168             The most significant change in this release is support for
 169             NetBSD 1.6.x. Parts of the FreeBSD code have been
 170             optimised, and an initialise function has been added to
 171             allow programs to drop any extra privileges libstatgrab
 172             needs. The list of known file systems has been increased,
 173             and libstatgrab has been tested on even more platforms.
 174             Finally, saidar has been tweaked to work even if it can't
 175             get all the statistics.
 176           </p>
 177           <h3>
 178             Saturday 18 October 2003
 179           </h3>
 180           <p>
 181             Version 0.6.1 of libstatgrab has been released.<br />
 182             Download it
 183             <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.1.tar.gz">
 184             here</a>.
 185           </p>
 186           <p>
 187             This release brings support for FreeBSD 5 on sparc 64, and
 188             some bugfixes in FreeBSD memory statistics. Also, some
 189             fixes to saidar, and statgrab.
 190           </p>
 191           <h3>
 192             Friday 10 October 2003
 193           </h3>
 194           <p>
 195             Version 0.6 of libstatgrab has been released.<br />
 196             You can download it from our mirror site
 197             <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.tar.gz">
 198             here</a>.
 199           </p>
 200           <p>
 201             This release includes some exciting new tools, support for
 202             FreeBSD 5.1, and documentation in manpages. Plus some major
 203             bugfixes and packaging enhancements.
 204           </p>
 205           <h3>
 206             Tuesday 09 September 2003
 207           </h3>
 208           <p>
 209             We're pleased to announce a new release of
 210             libstatgrab.<br />
 211             You can download version 0.5.1 from
 212             <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.1.tar.gz">
 213             here</a>.
 214           </p>
 215           <h3>
 216             Monday 25 August 2003
 217           </h3>
 218           <p>
 219             We're pleased to announce a new release of
 220             libstatgrab.<br />
 221             You can download version 0.5 from
 222             <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.tar.gz">
 223             here</a>.
 224           </p>
 225           <p>
 226             This release provides both documentation and examples,
 227             which we hope will make the package more useable. Stay
 228             tuned for the next release with some useful tools.
 229           </p>
 230           <h2>
 231             <a id="what">What is libstatgrab?</a>
 232           </h2>
 233           <p>
 234             libstatgrab is a library that provides cross platform
 235             access to statistics about the system on which it's run.
 236             It's written in C and presents a selection of useful
 237             interfaces which can be used to access key system
 238             statistics. The current list of statistics includes CPU
 239             usage, memory utilisation, disk usage, process counts,
 240             network traffic, disk I/O, and more.
 241           </p>
 242           <p>
 243             The current list of platforms is Solaris 2.x, Linux
 244             2.2/2.4/2.6, FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x,
 245             DragonFly BSD 1.0, and Cygwin. The aim is to extend this to
 246             include as many operating systems as possible.
 247           </p>
 248           <p>
 249             The package also includes a couple of useful tools. The
 250             first, <a href="#screenshot">saidar</a>, provides a
 251             curses-based interface to viewing the current state of the
 252             system. The second, statgrab, gives a sysctl-style
 253             interface to the statistics gathered by libstatgrab. This
 254             extends the use of libstatgrab to people writing scripts or
 255             anything else that can't easily make C function calls.
 256             Included with statgrab is a script to generate an
 257             <a href="http://www.mrtg.org">MRTG</a> configuration file
 258             to use statgrab.
 259           </p>
 260           <h2>
 261             <a id="download">Downloading</a>
 262           </h2>
 263           <p>
 264             The latest version of libstatgrab can be downloaded from
 265             our primary download
 266             <a href="http://www.mirrorservice.org/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/">
 267             mirror</a>. All downloads are pgp signed using our
 268             <a href="/pgpkey.xhtml">PGP Key</a>.
 269           </p>
 270           <p>
 271             For installation instructions see the README and INSTALL
 272             files contained within the archive. If you're using
 273             <a href="http://www.freebsd.org">FreeBSD</a> you can make
 274             use of the
 275             <a href="http://www.freshports.org/devel/libstatgrab">
 276             devel/libstatgrab</a> port to install libstatgrab for you.
 277           </p>
 278           <h2>
 279             <a id="bindings">Language Bindings</a>
 280           </h2>
 281           <ul>
 282             <li>
 283               <a href="/pystatgrab/">Python</a>
 284             </li>
 285             <li>
 286               <a href="http://pecl.php.net/statgrab/">PHP (external)</a>
 287             </li>
 288             <li>
 289               <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl (external)</a>
 290             </li>
 291           </ul>
 292           <p>
 293             Here are links to bindings for higher level languages
 294             that provide access to libstatgrab. If you've written
 295             a binding for another language, please get
 296             <a href="mailto:dev@i-scream.org">in touch</a> so we
 297             can add a link here.
 298           </p>
 299           <h2>
 300             <a id="development">Development</a>
 301           </h2>
 302           <ul>
 303             <li>
 304               <a href="/cgi-bin/cvslog.cgi?period=thisweek&amp;module=projects/libstatgrab">Commits this week</a>
 305             </li>
 306           </ul>
 307           <p>
 308             We develop libstatgrab using the CVS revision control system.
 309             Using this link you can see what changes we've made this week.
 310             For more information on our CVS setup see our
 311             <a href="/cvs.xhtml">CVS page</a>.
 312           </p>
 313           <h2>
 314             <a id="documentation">Documentation</a>
 315           </h2>
 316           <p>
 317             The only online documentation we have at the moment is the
 318             manual pages converted in to HTML format. It's probably
 319             best to start with the overview manual page:
 320           </p>
 321           <ul>
 322             <li>
 323               <a href="statgrab.html">statgrab(3)</a>
 324             </li>
 325           </ul>
 326           <p>
 327             Then we have the manual pages for each function:
 328           </p>
 329           <ul>
 330             <li>
 331               <a href="sg_get_cpu_stats.html">sg_get_cpu_stats(3)</a>
 332             </li>
 333             <li>
 334               <a href="sg_get_disk_io_stats.html">sg_get_disk_io_stats(3)</a>
 335             </li>
 336             <li>
 337               <a href="sg_get_fs_stats.html">sg_get_fs_stats(3)</a>
 338             </li>
 339             <li>
 340               <a href="sg_get_host_info.html">sg_get_host_info(3)</a>
 341             </li>
 342             <li>
 343               <a href="sg_get_load_stats.html">sg_get_load_stats(3)</a>
 344             </li>
 345             <li>
 346               <a href="sg_get_mem_stats.html">sg_get_mem_stats(3)</a>
 347             </li>
 348             <li>
 349               <a href="sg_get_network_iface_stats.html">sg_get_network_iface_stats(3)</a>
 350             </li>
 351             <li>
 352               <a href="sg_get_network_io_stats.html">sg_get_network_io_stats(3)</a>
 353             </li>
 354             <li>
 355               <a href="sg_get_page_stats.html">sg_get_page_stats(3)</a>
 356             </li>
 357             <li>
 358               <a href="sg_get_process_stats.html">sg_get_process_stats(3)</a>
 359             </li>
 360             <li>
 361               <a href="sg_get_user_stats.html">sg_get_user_stats(3)</a>
 362             </li>
 363           </ul>
 364           <h2>
 365             <a id="screenshot">Screenshot</a>
 366           </h2>
 367           <p>
 368             Here's what saidar looks like when it's running:
 369           </p>
 370           <p>
 371             <img src="saidar.png" alt="saidar screenshot" />
 372           </p>
 373         </div>
 374 <!--#include virtual="/footer.inc" -->
 375       </div>
 376 <!--#include virtual="/menu.inc" -->
 377     </div>
 378   </body>
 379 </html>