1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
11 <title>i-scream libstatgrab homepage</title>
14 <body bgcolor="#ffffff" link="#0000ff" alink="#3333cc" vlink="#3333cc" text="#000066">
16 <table border="0" cellpadding="2" cellspacing="2">
19 <!--#include virtual="../left.inc" -->
22 <!--#include virtual="../title.inc" -->
24 <font size="2" face="arial,sans-serif">
29 <li><a href="#news">News</a></li>
30 <li><a href="#what">What is libstatgrab?</a></li>
31 <li><a href="#download">Downloading</a></li>
32 <li><a href="#documentation">Documentation</a></li>
33 <li><a href="#screenshot">Screenshot</a></li>
36 <a name="news"><h2>News</h2></a>
39 <b>Friday 10 October 2003</b><br><br>
40 Version 0.6 of libstatgrab has been released.<br>
41 You can download it from our mirror site
42 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.tar.gz">here</a>.
43 This release includes some exciting new tools, support for FreeBSD
44 5.1, and documentation in manpages. Plus some major bugfixes and
45 packaging enhancements.
49 <b>Tuesday 09 September 2003</b><br><br>
50 We're pleased to announce a new release of libstatgrab.<br>
51 You can download version 0.5.1 from
52 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.1.tar.gz">here</a>.
56 <b>Monday 25 August 2003</b><br><br>
57 We're pleased to announce a new release of libstatgrab.<br>
58 You can download version 0.5 from
59 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.tar.gz">here</a>.
60 This release provides both documentation and examples, which
61 we hope will make the package more useable. Stay tuned for the
62 next release with some useful tools.
65 <a name="what"><h2>What is libstatgrab?</h2></a>
68 libstatgrab is a library that provides cross platform access to
69 statistics about the system on which it's run. It's written in C and
70 presents a selection of useful interfaces which can be used to access
71 key system statistics. The current list of statistics includes CPU
72 usage, memory utilisation, disk usage, process counts, network
73 traffic, disk I/O, and more.
77 The current list of platforms is Solaris 2.x, Linux 2.4, and FreeBSD
78 4.x/5.x. The aim is to extend this to include as many operating systems
83 The package also includes a couple of useful tools. The first,
84 <a href="#screenshot">saidar</a>, provides a curses-based interface to
85 viewing the current state of the system. The second, statgrab, gives a
86 sysctl-style interface to the statistics gathered by libstatgrab. This
87 extends the use of libstatgrab to people writing scripts or anything
88 else that can't easily make C function calls. Included with statgrab is
89 a script to generate an <a href="http://www.mrtg.org">MRTG</a>
90 configuration file to use statgrab.
93 <a name="download"><h2>Downloading</h2></a>
96 The latest version of libstatgrab can be downloaded from our
98 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab">mirror</a>.
99 All downloads are pgp signed using our <a href="/pgpkey.shtml">PGP Key</a>.
103 For installation instructions see the README and INSTALL files
104 contained within the archive. If you're using
105 <a href="http://www.freebsd.org">FreeBSD</a> you can make use of the
106 <a href="http://www.freshports.org/devel/libstatgrab">devel/libstatgrab</a>
107 port to install libstatgrab for you.
110 <a name="documentation"><h2>Documentation</h2></a>
113 The only online documentation we have at the moment is the manual
114 pages converted in to HTML format. It's probably best to start with
115 the overview manual page:
118 <li><a href="statgrab.html">statgrab(3)</a></li>
123 Then we have the manual pages for each function:
126 <li><a href="cpu_percent_usage.html">cpu_percent_usage(3)</a></li>
127 <li><a href="get_diskio_stats.html">get_diskio_stats(3)</a></li>
128 <li><a href="get_general_stats.html">get_general_stats(3)</a></li>
129 <li><a href="get_load_stats.html">get_load_stats(3)</a></li>
130 <li><a href="get_memory_stats.html">get_memory_stats(3)</a></li>
131 <li><a href="get_network_stats.html">get_network_stats(3)</a></li>
132 <li><a href="get_page_stats.html">get_page_stats(3)</a></li>
133 <li><a href="get_process_stats.html">get_process_stats(3)</a></li>
134 <li><a href="get_user_stats.html">get_user_stats(3)</a></li>
138 <a name="screenshot"><h2>Screenshot</h2></a>
141 Here's what saidar looks like when it's running:
144 <img src="saidar.png" alt="saidar screenshot">
149 <!--#include virtual="../bottom.inc" -->