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 21 February 2010
  85           </h3>
  86           <p>
  87             Version 0.17 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 adds support for FreeBSD 9 and other systems
  92             using utmpx. Also on FreeBSD it fixes an issue with large
  93             quantities of memory and adds support for dynamically
  94             getting a list of supported file systems. On Solaris ZFS
  95             file systems will now be detected. And finally on Linux CPU
  96             iowait information will be given where available.
  97           </p>
  98           <h3>
  99             Friday 30 May 2008
 100           </h3>
 101           <p>
 102             Dag Odenhall got in touch today to let us know he's written
 103             <a href="http://statgrab.rubyforge.org/">Ruby bindings</a>
 104             for libstatgrab. Thanks Dag!
 105           </p>
 106           <h3>
 107             Monday 17 March 2008
 108           </h3>
 109           <p>
 110             Version 0.16 of libstatgrab has been released.<br />
 111             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
 112           </p>
 113           <p>
 114             This release fixes some minor build problems on Solaris
 115             with Sun's compiler, and on the Debian "armel" port. Also
 116             a minor fix to statgrab-make-mrtg-config on machines with
 117             no swap, and added support for FreeBSD 8.
 118           </p>
 119           <h3>
 120             Saturday 14 July 2007
 121           </h3>
 122           <p>
 123             Version 0.15 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 regression introduced on OpenBSD in
 128             the last release - memory statistics were reported
 129             incorrectly. Some other minor changes have been made, see
 130             the NEWS file for more information.
 131           </p>
 132           <h3>
 133             Monday 8 January 2007
 134           </h3>
 135           <p>
 136             Version 0.14 of libstatgrab has been released.<br />
 137             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
 138           </p>
 139           <p>
 140             This release contains mainly bugfixes - see the NEWS file
 141             in the distribution for a full list. It also brings a new
 142             feature in saidar: colour support, which can be activated
 143             with the -c runtime flag.
 144           </p>
 145           <h3>
 146             Monday 20 March 2006
 147           </h3>
 148           <p>
 149             Version 0.13 of libstatgrab has been released.<br />
 150             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
 151           </p>
 152           <p>
 153             This release mainly includes a bunch of bug fixes, but
 154             also brings preliminary support for WIN32. We've also
 155             added a few lines to the header file to make C++ linking
 156             easier. Please see the NEWS file in the distribution for
 157             full details.
 158           </p>
 159           <h3>
 160             Sunday 31 July 2005
 161           </h3>
 162           <p>
 163             Version 0.12 of libstatgrab has been released.<br />
 164             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
 165           </p>
 166           <p>
 167             This release has some new features, bug fixes, and a minor
 168             API change. More details have been added to the file
 169             system statistics, linux partition detection has been
 170             reworked, and compile errors on Linux 2.6 have been fixed.
 171             Support has been added for Solaris 10 and FreeBSD 7.
 172             There are also manual pages for all the tools.
 173           </p>
 174           <p>
 175             The duplex value in the network interface statistics has
 176             changed name from "dup" to "duplex" - this breaks the API.
 177             We plan to stabilise the API for a 1.0 release. As before,
 178             the old name is available if SG_ENABLE_DEPRECATED is
 179             defined.
 180           </p>
 181           <h3>
 182             Tuesday 26 April 2005
 183           </h3>
 184           <p>
 185             Official libstatgrab packages for Debian now
 186             <a href="http://packages.debian.org/unstable/source/libstatgrab">available</a>.
 187           </p>
 188           <p>
 189             Thanks to the work of
 190             <a href="mailto:fenio@debian.org">Bartosz Fenski</a>
 191             libstatgrab is now available on debian. This replaces our
 192             unofficial debian packages which will no longer be
 193             updated.
 194           </p>
 195           <h3>
 196             Thursday 3 March 2005
 197           </h3>
 198           <p>
 199             Version 0.11.1 of libstatgrab has been released.<br />
 200             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
 201           </p>
 202           <p>
 203             This release fixes a handful of minor bugs. Duplex
 204             settings were reported incorrectly on linux (half and
 205             full duplex were swapped), saidar displayed negative
 206             filesystem stats incorrectly, and NFS filesystems were
 207             ignored. These have all been fixed.
 208           </p>
 209           <h3>
 210             Friday 12 November 2004
 211           </h3>
 212           <p>
 213             Version 0.11 of libstatgrab has been released.<br />
 214             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
 215           </p>
 216           <p>
 217             This release brings support for HP-UX (version 11.11), and
 218             also fixes a few other minor issues.
 219           </p>
 220           <h3>
 221             Wednesday 25 August 2004
 222           </h3>
 223           <p>
 224             Version 0.10.3 of libstatgrab has been released.<br />
 225             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
 226           </p>
 227           <p>
 228             This release adds a handful of new features to statgrab, and
 229             adds support for FreeBSD 6.0-CURRENT. See the NEWS file in
 230             the tarball for more details.
 231           </p>
 232           <h3>
 233             Tuesday 27 July 2004
 234           </h3>
 235           <p>
 236             Version 0.10.2 of libstatgrab has been released.<br />
 237             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
 238           </p>
 239           <p>
 240             This release fixes a problem with the shared library
 241             version number in the last release.
 242           </p>
 243           <h3>
 244             Monday 26 July 2004
 245           </h3>
 246           <p>
 247             Version 0.10.1 of libstatgrab has been released.<br />
 248             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
 249           </p>
 250           <p>
 251             This release consists almost entirely of bugfixes.
 252             We've fixed compile-time errors for recent OpenBSD and
 253             NetBSD platforms, and also a minor bug in statgrab
 254             that broke network statistics on Solaris. New
 255             variables have been added to the pkg-config file to
 256             suggest ownership and permissions of binaries, and
 257             we've added error reporting functions that store errno
 258             values. There's also other minor fixes detailed in the
 259             NEWS file.
 260           </p>
 261           <h3>
 262             Thursday 20 May 2004
 263           </h3>
 264           <p>
 265             Version 0.10 of libstatgrab has been released.<br />
 266             Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
 267           </p>
 268           <p>
 269             This release concentrates heavily on standardising the names
 270             of functions and structures throughout libstatgrab. Although
 271             this will mean changes for existing programs, in the long run
 272             we hope it'll make things both clearer and easier. However,
 273             for those who still need the old functions we have provided
 274             compatibility wrappers. See the NEWS file for details.
 275           </p>
 276           <p>
 277             The other main change in this release is a new function to
 278             provide full details on currently running processes. See the
 279             documentation for sg_get_process_stats for details. Along with
 280             this there are compare functions for use with qsort for sorting
 281             process, network, and disk io statistics. We've also introduced
 282             error reporting functions that allow calling applications to
 283             see why libstatgrab has returned a failure. See sg_get_error.
 284           </p>
 285           <p>
 286             Finally, we've added support for NetBSD 2.0 and tidied up lots
 287             of areas of the code. This release does not include the python
 288             bindings - they're now available as their own project called
 289             <a href="/pystatgrab/">pystatgrab</a>.
 290           </p>
 291           <h3>
 292             Sunday 21 March 2004
 293           </h3>
 294           <p>
 295             pystatgrab, a new package containing a set of Python
 296             bindings, has been released. Check out its
 297             <a href="/pystatgrab/">project page</a>.
 298           </p>
 299           <h2>
 300             <a id="download">Downloading</a>
 301           </h2>
 302           <p>
 303             The latest version of libstatgrab can be downloaded from
 304             our <a href="/mirrors.xhtml">mirror sites</a>.
 305             All downloads are pgp signed using our
 306             <a href="/pgpkey.xhtml">PGP Key</a>.
 307           </p>
 308           <p>
 309             For installation instructions see the README and INSTALL
 310             files contained within the archive.
 311           </p>
 312           <h2>
 313             <a id="bindings">Language Bindings</a>
 314           </h2>
 315           <ul>
 316             <li>
 317               <a href="/pystatgrab/">Python</a>
 318             </li>
 319             <li>
 320               <a href="http://pecl.php.net/statgrab/">PHP</a>
 321             </li>
 322             <li>
 323               <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl</a>
 324             </li>
 325             <li>
 326               <a href="http://statgrab.rubyforge.org/">Ruby</a>
 327             </li>
 328           </ul>
 329           <p>
 330             Here are links to bindings for higher level languages
 331             that provide access to libstatgrab. If you've written
 332             a binding for another language, please get
 333             <a href="mailto:support@i-scream.org">in touch</a> so we
 334             can add a link here.
 335           </p>
 336           <h2>
 337             <a id="packages">Packages of libstatgrab</a>
 338           </h2>
 339           <ul>
 340             <li>
 341               <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&amp;stype=all">FreeBSD</a>
 342             </li>
 343             <li>
 344               <a href="http://packages.gentoo.org/search/?sstring=libstatgrab">Gentoo Linux</a>
 345             </li>
 346             <li>
 347               <a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a>
 348             </li>
 349             <li>
 350               <a href="http://www.sunfreeware.com/">Solaris (SunFreeware)</a>
 351             </li>
 352             <li>
 353               <a href="http://www.opencsw.org/packages/libstatgrab/">Solaris (OpenCSW)</a>
 354             </li>
 355             <li>
 356               <a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a>
 357             </li>
 358             <li>
 359               <a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a>
 360             </li>
 361             <li>
 362               <a href="http://software.opensuse.org/download/home:/anagappan/">RPMs for various Linux distributions</a>
 363             </li>
 364             <li>
 365               <a href="http://www.openbsd.org/cgi-bin/cvsweb/ports/sysutils/libstatgrab/">OpenBSD</a>
 366             </li>
 367           </ul>
 368           <p>
 369             These are various pre-packaged versions of libstatgrab
 370             that you can get for your favourite operating system. If
 371             we've missed any out, please let us know.
 372           </p>
 373           <p>
 374             We've noticed that google throws up some RPM's relating
 375             to Mandrake and Suse, but no webpage for them.
 376           </p>
 377           <h2>
 378             <a id="development">Development</a>
 379           </h2>
 380           <ul>
 381             <li>
 382               <a href="/cgi-bin/cvslog.cgi?period=thisweek&amp;module=projects/libstatgrab">Commits this week</a>
 383             </li>
 384           </ul>
 385           <p>
 386             We develop libstatgrab using the CVS revision control system.
 387             Using this link you can see what changes we've made this week.
 388             For more information on our CVS setup see our
 389             <a href="/cvs.xhtml">CVS page</a>.
 390           </p>
 391           <h2>
 392             <a id="documentation">Documentation</a>
 393           </h2>
 394           <p>
 395             The only online documentation we have at the moment is the
 396             manual pages converted in to HTML format. First are the
 397             manual pages for the command line tools:
 398           </p>
 399           <ul>
 400             <li>
 401               <a href="docs/saidar.1.html">saidar(1)</a>
 402             </li>
 403             <li>
 404               <a href="docs/statgrab.1.html">statgrab(1)</a>
 405             </li>
 406             <li>
 407               <a href="docs/statgrab-make-mrtg-config.1.html">statgrab-make-mrtg-config(1)</a>
 408             </li>
 409             <li>
 410               <a href="docs/statgrab-make-mrtg-index.1.html">statgrab-make-mrtg-index(1)</a>
 411             </li>
 412           </ul>
 413           <p>
 414             We also have an overview page for the library:
 415           </p>
 416           <ul>
 417             <li>
 418               <a href="docs/statgrab.3.html">statgrab(3)</a>
 419             </li>
 420           </ul>
 421           <p>
 422             Then we have the manual pages for each function:
 423           </p>
 424           <ul>
 425             <li>
 426               <a href="docs/sg_get_cpu_stats.3.html">sg_get_cpu_stats(3)</a>
 427             </li>
 428             <li>
 429               <a href="docs/sg_get_disk_io_stats.3.html">sg_get_disk_io_stats(3)</a>
 430             </li>
 431             <li>
 432               <a href="docs/sg_get_fs_stats.3.html">sg_get_fs_stats(3)</a>
 433             </li>
 434             <li>
 435               <a href="docs/sg_get_host_info.3.html">sg_get_host_info(3)</a>
 436             </li>
 437             <li>
 438               <a href="docs/sg_get_load_stats.3.html">sg_get_load_stats(3)</a>
 439             </li>
 440             <li>
 441               <a href="docs/sg_get_mem_stats.3.html">sg_get_mem_stats(3)</a>
 442             </li>
 443             <li>
 444               <a href="docs/sg_get_network_iface_stats.3.html">sg_get_network_iface_stats(3)</a>
 445             </li>
 446             <li>
 447               <a href="docs/sg_get_network_io_stats.3.html">sg_get_network_io_stats(3)</a>
 448             </li>
 449             <li>
 450               <a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a>
 451             </li>
 452             <li>
 453               <a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a>
 454             </li>
 455             <li>
 456               <a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a>
 457             </li>
 458           </ul>
 459           <h2>
 460             <a id="screenshot">Screenshot</a>
 461           </h2>
 462           <p>
 463             Here's what saidar looks like when it's running:
 464           </p>
 465           <p>
 466             <img src="saidar.png" alt="saidar screenshot" />
 467           </p>
 468         </div>
 469 <!--#include virtual="/footer.inc" -->
 470       </div>
 471 <!--#include virtual="/menu.inc" -->
 472     </div>
 473   </body>
 474 </html>