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>Saturday 18 October 2003</b><br><br>
40 Version 0.6.1 of libstatgrab has been released.<br>
42 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.1.tar.gz">here</a>.
43 This release brings support for FreeBSD 5 on sparc 64, and some
44 bugfixes in FreeBSD memory statistics. Also, some fixes to saidar,
49 <b>Friday 10 October 2003</b><br><br>
50 Version 0.6 of libstatgrab has been released.<br>
51 You can download it from our mirror site
52 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.tar.gz">here</a>.
53 This release includes some exciting new tools, support for FreeBSD
54 5.1, and documentation in manpages. Plus some major bugfixes and
55 packaging enhancements.
59 <b>Tuesday 09 September 2003</b><br><br>
60 We're pleased to announce a new release of libstatgrab.<br>
61 You can download version 0.5.1 from
62 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.1.tar.gz">here</a>.
66 <b>Monday 25 August 2003</b><br><br>
67 We're pleased to announce a new release of libstatgrab.<br>
68 You can download version 0.5 from
69 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.tar.gz">here</a>.
70 This release provides both documentation and examples, which
71 we hope will make the package more useable. Stay tuned for the
72 next release with some useful tools.
75 <a name="what"><h2>What is libstatgrab?</h2></a>
78 libstatgrab is a library that provides cross platform access to
79 statistics about the system on which it's run. It's written in C and
80 presents a selection of useful interfaces which can be used to access
81 key system statistics. The current list of statistics includes CPU
82 usage, memory utilisation, disk usage, process counts, network
83 traffic, disk I/O, and more.
87 The current list of platforms is Solaris 2.x, Linux 2.4, and FreeBSD
88 4.x/5.x. The aim is to extend this to include as many operating systems
93 The package also includes a couple of useful tools. The first,
94 <a href="#screenshot">saidar</a>, provides a curses-based interface to
95 viewing the current state of the system. The second, statgrab, gives a
96 sysctl-style interface to the statistics gathered by libstatgrab. This
97 extends the use of libstatgrab to people writing scripts or anything
98 else that can't easily make C function calls. Included with statgrab is
99 a script to generate an <a href="http://www.mrtg.org">MRTG</a>
100 configuration file to use statgrab.
103 <a name="download"><h2>Downloading</h2></a>
106 The latest version of libstatgrab can be downloaded from our
108 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab">mirror</a>.
109 All downloads are pgp signed using our <a href="/pgpkey.shtml">PGP Key</a>.
113 For installation instructions see the README and INSTALL files
114 contained within the archive. If you're using
115 <a href="http://www.freebsd.org">FreeBSD</a> you can make use of the
116 <a href="http://www.freshports.org/devel/libstatgrab">devel/libstatgrab</a>
117 port to install libstatgrab for you.
120 <a name="documentation"><h2>Documentation</h2></a>
123 The only online documentation we have at the moment is the manual
124 pages converted in to HTML format. It's probably best to start with
125 the overview manual page:
128 <li><a href="statgrab.html">statgrab(3)</a></li>
133 Then we have the manual pages for each function:
136 <li><a href="cpu_percent_usage.html">cpu_percent_usage(3)</a></li>
137 <li><a href="get_diskio_stats.html">get_diskio_stats(3)</a></li>
138 <li><a href="get_general_stats.html">get_general_stats(3)</a></li>
139 <li><a href="get_load_stats.html">get_load_stats(3)</a></li>
140 <li><a href="get_memory_stats.html">get_memory_stats(3)</a></li>
141 <li><a href="get_network_stats.html">get_network_stats(3)</a></li>
142 <li><a href="get_page_stats.html">get_page_stats(3)</a></li>
143 <li><a href="get_process_stats.html">get_process_stats(3)</a></li>
144 <li><a href="get_user_stats.html">get_user_stats(3)</a></li>
148 <a name="screenshot"><h2>Screenshot</h2></a>
151 Here's what saidar looks like when it's running:
154 <img src="saidar.png" alt="saidar screenshot">
159 <!--#include virtual="../bottom.inc" -->