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