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