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