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="#what">What is libstatgrab?</a>
  20               </li>
  21               <li>
  22                 <a href="#news">News</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="#packages">Packages</a>
  32               </li>
  33               <li>
  34                 <a href="#development">Development</a>
  35               </li>
  36               <li>
  37                 <a href="#documentation">Documentation</a>
  38               </li>
  39               <li>
  40                 <a href="#screenshot">Screenshot</a>
  41               </li>
  42             </ul>
  43           </div>
  44 <!--#include virtual="/bannerad.inc" -->
  45           <h2>
  46             <a id="what">What is libstatgrab?</a>
  47           </h2>
  48           <p>
  49             libstatgrab is a library that provides cross platform
  50             access to statistics about the system on which it's run.
  51             It's written in C and presents a selection of useful
  52             interfaces which can be used to access key system
  53             statistics. The current list of statistics includes CPU
  54             usage, memory utilisation, disk usage, process counts,
  55             network traffic, disk I/O, and more.
  56           </p>
  57           <p>
  58             The current list of platforms is Solaris 2.x, Linux
  59             2.2/2.4/2.6, FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x,
  60             DragonFly BSD 1.0, HP-UX, and Cygwin. The aim is to extend
  61             this to include as many operating systems as possible.
  62           </p>
  63           <p>
  64             The package also includes a couple of useful tools. The
  65             first, <a href="#screenshot">saidar</a>, provides a
  66             curses-based interface to viewing the current state of the
  67             system. The second, statgrab, gives a sysctl-style
  68             interface to the statistics gathered by libstatgrab. This
  69             extends the use of libstatgrab to people writing scripts or
  70             anything else that can't easily make C function calls.
  71             Included with statgrab is a script to generate an
  72             <a href="http://www.mrtg.org">MRTG</a> configuration file
  73             to use statgrab.
  74           </p>
  75           <h2>
  76             <a id="news">News</a>
  77           </h2>
  78           <p>
  79             To get notifications of new libstatgrab releases why not
  80             subscribe to our project over on
  81             <a href="http://freshmeat.net/projects/libstatgrab/">freshmeat</a>?
  82           </p>
  83           <h3>
  84             Sunday 31 July 2005
  85           </h3>
  86           <p>
  87             Version 0.12 of libstatgrab has been released.<br />
  88             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
  89           </p>
  90           <p>
  91             This release has some new features, bug fixes, and a minor
  92             API change. More details have been added to the file
  93             system statistics, linux partition detection has been
  94             reworked, and compile errors on Linux 2.6 have been fixed.
  95             Support has been added for Solaris 10 and FreeBSD 7.
  96             There are also manual pages for all the tools.
  97           </p>
  98           <p>
  99             The duplex value in the network interface statistics has
 100             changed name from "dup" to "duplex" - this breaks the API.
 101             We plan to stabilise the API for a 1.0 release. As before,
 102             the old name is available if SG_ENABLE_DEPRECATED is
 103             defined.
 104           </p>
 105           <h3>
 106             Tuesday 26 April 2005
 107           </h3>
 108           <p>
 109             Official libstatgrab packages for Debian now
 110             <a href="http://packages.debian.org/unstable/source/libstatgrab">available</a>.
 111           </p>
 112           <p>
 113             Thanks to the work of
 114             <a href="mailto:fenio@debian.org">Bartosz Fenski</a>
 115             libstatgrab is now available on debian. This replaces our
 116             unofficial debian packages which will no longer be
 117             updated.
 118           </p>
 119           <h3>
 120             Thursday 3 March 2005
 121           </h3>
 122           <p>
 123             Version 0.11.1 of libstatgrab has been released.<br />
 124             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
 125           </p>
 126           <p>
 127             This release fixes a handful of minor bugs. Duplex
 128             settings were reported incorrectly on linux (half and
 129             full duplex were swapped), saidar displayed negative
 130             filesystem stats incorrectly, and NFS filesystems were
 131             ignored. These have all been fixed.
 132           </p>
 133           <h3>
 134             Friday 12 November 2004
 135           </h3>
 136           <p>
 137             Version 0.11 of libstatgrab has been released.<br />
 138             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
 139           </p>
 140           <p>
 141             This release brings support for HP-UX (version 11.11), and
 142             also fixes a few other minor issues.
 143           </p>
 144           <h3>
 145             Wednesday 25 August 2004
 146           </h3>
 147           <p>
 148             Version 0.10.3 of libstatgrab has been released.<br />
 149             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
 150           </p>
 151           <p>
 152             This release adds a handful of new features to statgrab, and
 153             adds support for FreeBSD 6.0-CURRENT. See the NEWS file in
 154             the tarball for more details.
 155           </p>
 156           <h3>
 157             Tuesday 27 July 2004
 158           </h3>
 159           <p>
 160             Version 0.10.2 of libstatgrab has been released.<br />
 161             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
 162           </p>
 163           <p>
 164             This release fixes a problem with the shared library
 165             version number in the last release.
 166           </p>
 167           <h3>
 168             Monday 26 July 2004
 169           </h3>
 170           <p>
 171             Version 0.10.1 of libstatgrab has been released.<br />
 172             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
 173           </p>
 174           <p>
 175             This release consists almost entirely of bugfixes.
 176             We've fixed compile-time errors for recent OpenBSD and
 177             NetBSD platforms, and also a minor bug in statgrab
 178             that broke network statistics on Solaris. New
 179             variables have been added to the pkg-config file to
 180             suggest ownership and permissions of binaries, and
 181             we've added error reporting functions that store errno
 182             values. There's also other minor fixes detailed in the
 183             NEWS file.
 184           </p>
 185           <h3>
 186             Thursday 20 May 2004
 187           </h3>
 188           <p>
 189             Version 0.10 of libstatgrab has been released.<br />
 190             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
 191           </p>
 192           <p>
 193             This release concentrates heavily on standardising the names
 194             of functions and structures throughout libstatgrab. Although
 195             this will mean changes for existing programs, in the long run
 196             we hope it'll make things both clearer and easier. However,
 197             for those who still need the old functions we have provided
 198             compatibility wrappers. See the NEWS file for details.
 199           </p>
 200           <p>
 201             The other main change in this release is a new function to
 202             provide full details on currently running processes. See the
 203             documentation for sg_get_process_stats for details. Along with
 204             this there are compare functions for use with qsort for sorting
 205             process, network, and disk io statistics. We've also introduced
 206             error reporting functions that allow calling applications to
 207             see why libstatgrab has returned a failure. See sg_get_error.
 208           </p>
 209           <p>
 210             Finally, we've added support for NetBSD 2.0 and tidied up lots
 211             of areas of the code. This release does not include the python
 212             bindings - they're now available as their own project called
 213             <a href="/pystatgrab/">pystatgrab</a>.
 214           </p>
 215           <h3>
 216             Sunday 21 March 2004
 217           </h3>
 218           <p>
 219             pystatgrab, a new package containing a set of Python
 220             bindings, has been released. Check out it's
 221             <a href="/pystatgrab/">project page</a>.
 222           </p>
 223           <h2>
 224             <a id="download">Downloading</a>
 225           </h2>
 226           <p>
 227             The latest version of libstatgrab can be downloaded from
 228             our <a href="/mirrors.xhtml">mirror sites</a>.
 229             All downloads are pgp signed using our
 230             <a href="/pgpkey.xhtml">PGP Key</a>.
 231           </p>
 232           <p>
 233             For installation instructions see the README and INSTALL
 234             files contained within the archive.
 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:support@i-scream.org">in touch</a> so we
 255             can add a link here.
 256           </p>
 257           <h2>
 258             <a id="packages">Packages of libstatgrab</a>
 259           </h2>
 260           <ul>
 261             <li>
 262               <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&amp;stype=all">FreeBSD</a>
 263             </li>
 264             <li>
 265               <a href="http://packages.gentoo.org/search/?sstring=statgrab">Gentoo Linux</a>
 266             </li>
 267             <li>
 268               <a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a>
 269             </li>
 270             <li>
 271               <a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a>
 272             </li>
 273             <li>
 274               <a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a>
 275             </li>
 276           </ul>
 277           <p>
 278             These are various pre-packaged versions of libstatgrab
 279             that you can get for your favourite operating system. If
 280             we've missed any out, please let us know.
 281           </p>
 282           <p>
 283             We've noticed that google throws up some RPM's relating
 284             to Mandrake and Suse, but no webpage for them.
 285           </p>
 286           <p>
 287             Several attempts were made to submit a port to the
 288             OpenBSD folk, but they didn't seem interested in taking
 289             it. You can find it
 290             <a href="http://ftp.i-scream.org/pub/i-scream/tmp/libstatgrab-0.11-openbsd-port.tar.gz">
 291             here</a>.
 292           </p>
 293           <h2>
 294             <a id="development">Development</a>
 295           </h2>
 296           <ul>
 297             <li>
 298               <a href="/cgi-bin/cvslog.cgi?period=thisweek&amp;module=projects/libstatgrab">Commits this week</a>
 299             </li>
 300           </ul>
 301           <p>
 302             We develop libstatgrab using the CVS revision control system.
 303             Using this link you can see what changes we've made this week.
 304             For more information on our CVS setup see our
 305             <a href="/cvs.xhtml">CVS page</a>.
 306           </p>
 307           <h2>
 308             <a id="documentation">Documentation</a>
 309           </h2>
 310           <p>
 311             The only online documentation we have at the moment is the
 312             manual pages converted in to HTML format. It's probably
 313             best to start with the overview manual page:
 314           </p>
 315           <ul>
 316             <li>
 317               <a href="statgrab.html">statgrab(3)</a>
 318             </li>
 319           </ul>
 320           <p>
 321             Then we have the manual pages for each function:
 322           </p>
 323           <ul>
 324             <li>
 325               <a href="sg_get_cpu_stats.html">sg_get_cpu_stats(3)</a>
 326             </li>
 327             <li>
 328               <a href="sg_get_disk_io_stats.html">sg_get_disk_io_stats(3)</a>
 329             </li>
 330             <li>
 331               <a href="sg_get_fs_stats.html">sg_get_fs_stats(3)</a>
 332             </li>
 333             <li>
 334               <a href="sg_get_host_info.html">sg_get_host_info(3)</a>
 335             </li>
 336             <li>
 337               <a href="sg_get_load_stats.html">sg_get_load_stats(3)</a>
 338             </li>
 339             <li>
 340               <a href="sg_get_mem_stats.html">sg_get_mem_stats(3)</a>
 341             </li>
 342             <li>
 343               <a href="sg_get_network_iface_stats.html">sg_get_network_iface_stats(3)</a>
 344             </li>
 345             <li>
 346               <a href="sg_get_network_io_stats.html">sg_get_network_io_stats(3)</a>
 347             </li>
 348             <li>
 349               <a href="sg_get_page_stats.html">sg_get_page_stats(3)</a>
 350             </li>
 351             <li>
 352               <a href="sg_get_process_stats.html">sg_get_process_stats(3)</a>
 353             </li>
 354             <li>
 355               <a href="sg_get_user_stats.html">sg_get_user_stats(3)</a>
 356             </li>
 357           </ul>
 358           <h2>
 359             <a id="screenshot">Screenshot</a>
 360           </h2>
 361           <p>
 362             Here's what saidar looks like when it's running:
 363           </p>
 364           <p>
 365             <img src="saidar.png" alt="saidar screenshot" />
 366           </p>
 367         </div>
 368 <!--#include virtual="/footer.inc" -->
 369       </div>
 370 <!--#include virtual="/menu.inc" -->
 371     </div>
 372   </body>
 373 </html>