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