www/libstatgrab/index.xhtml

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