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