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