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