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