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 To get notifications of new libstatgrab releases why not subscribe
40 to our project over on <a href="http://freshmeat.net/projects/libstatgrab/">
45 <b>Wednesday 22 October 2003</b><br><br>
46 Version 0.7 of libstatgrab has been released.<br>
48 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.7.tar.gz">here</a>.
49 The most significant change in this release is support for NetBSD
50 1.6.x. Parts of the FreeBSD code have been optimised, and an initialise
51 function has been added to allow programs to drop any extra privileges
52 libstatgrab needs. The list of known file systems has been increased,
53 and libstatgrab has been tested on even more platforms. Finally,
54 saidar has been tweaked to work even if it can't get all the
59 <b>Saturday 18 October 2003</b><br><br>
60 Version 0.6.1 of libstatgrab has been released.<br>
62 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.1.tar.gz">here</a>.
63 This release brings support for FreeBSD 5 on sparc 64, and some
64 bugfixes in FreeBSD memory statistics. Also, some fixes to saidar,
69 <b>Friday 10 October 2003</b><br><br>
70 Version 0.6 of libstatgrab has been released.<br>
71 You can download it from our mirror site
72 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.tar.gz">here</a>.
73 This release includes some exciting new tools, support for FreeBSD
74 5.1, and documentation in manpages. Plus some major bugfixes and
75 packaging enhancements.
79 <b>Tuesday 09 September 2003</b><br><br>
80 We're pleased to announce a new release of libstatgrab.<br>
81 You can download version 0.5.1 from
82 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.1.tar.gz">here</a>.
86 <b>Monday 25 August 2003</b><br><br>
87 We're pleased to announce a new release of libstatgrab.<br>
88 You can download version 0.5 from
89 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.tar.gz">here</a>.
90 This release provides both documentation and examples, which
91 we hope will make the package more useable. Stay tuned for the
92 next release with some useful tools.
95 <a name="what"><h2>What is libstatgrab?</h2></a>
98 libstatgrab is a library that provides cross platform access to
99 statistics about the system on which it's run. It's written in C and
100 presents a selection of useful interfaces which can be used to access
101 key system statistics. The current list of statistics includes CPU
102 usage, memory utilisation, disk usage, process counts, network
103 traffic, disk I/O, and more.
107 The current list of platforms is Solaris 2.x, Linux 2.4, FreeBSD
108 4.x/5.x, and NetBSD 1.6.x. The aim is to extend this to include as many
109 operating systems as possible.
113 The package also includes a couple of useful tools. The first,
114 <a href="#screenshot">saidar</a>, provides a curses-based interface to
115 viewing the current state of the system. The second, statgrab, gives a
116 sysctl-style interface to the statistics gathered by libstatgrab. This
117 extends the use of libstatgrab to people writing scripts or anything
118 else that can't easily make C function calls. Included with statgrab is
119 a script to generate an <a href="http://www.mrtg.org">MRTG</a>
120 configuration file to use statgrab.
123 <a name="download"><h2>Downloading</h2></a>
126 The latest version of libstatgrab can be downloaded from our
128 <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab">mirror</a>.
129 All downloads are pgp signed using our <a href="/pgpkey.shtml">PGP Key</a>.
133 For installation instructions see the README and INSTALL files
134 contained within the archive. If you're using
135 <a href="http://www.freebsd.org">FreeBSD</a> you can make use of the
136 <a href="http://www.freshports.org/devel/libstatgrab">devel/libstatgrab</a>
137 port to install libstatgrab for you.
140 <a name="documentation"><h2>Documentation</h2></a>
143 The only online documentation we have at the moment is the manual
144 pages converted in to HTML format. It's probably best to start with
145 the overview manual page:
148 <li><a href="statgrab.html">statgrab(3)</a></li>
153 Then we have the manual pages for each function:
156 <li><a href="cpu_percent_usage.html">cpu_percent_usage(3)</a></li>
157 <li><a href="get_diskio_stats.html">get_diskio_stats(3)</a></li>
158 <li><a href="get_general_stats.html">get_general_stats(3)</a></li>
159 <li><a href="get_load_stats.html">get_load_stats(3)</a></li>
160 <li><a href="get_memory_stats.html">get_memory_stats(3)</a></li>
161 <li><a href="get_network_stats.html">get_network_stats(3)</a></li>
162 <li><a href="get_page_stats.html">get_page_stats(3)</a></li>
163 <li><a href="get_process_stats.html">get_process_stats(3)</a></li>
164 <li><a href="get_user_stats.html">get_user_stats(3)</a></li>
168 <a name="screenshot"><h2>Screenshot</h2></a>
171 Here's what saidar looks like when it's running:
174 <img src="saidar.png" alt="saidar screenshot">
179 <!--#include virtual="../bottom.inc" -->