www/libstatgrab/index.shtml

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html>

<head>
<title>i-scream libstatgrab homepage</title>
<!--#include virtual="/style.inc" -->
</head>

<body>

<div id="container">

<div id="main">

<!--#include virtual="/header.inc" -->

<div id="contents"> 

<h1 class="top">i-scream libstatgrab homepage</h1>

<div id="topnav">
  <ul>
    <li><a href="#news">News</a></li>
    <li><a href="#what">What is libstatgrab?</a></li>
    <li><a href="#download">Downloading</a></li>
    <li><a href="#documentation">Documentation</a></li>
    <li><a href="#screenshot">Screenshot</a></li>
  </ul>
</div>

<h2><a name="news">News</a></h2>

<p>
To get notifications of new libstatgrab releases why not subscribe
to our project over on <a href="http://freshmeat.net/projects/libstatgrab/">
freshmeat</a>?
</p>

<h3>Sunday 21 March 2004</h3>
<p>
pystatgrab, a new package containing a set of Python bindings,
has been released. Check out it's <a href="/pystatgrab/">project
page</a>.
</p>

<h3>Wednesday 10 March 2004</h3>
<p>
Version 0.9 of libstatgrab has been released.<br/>
Download it
<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.9.tar.gz">here</a>.
</p>
<p>
This release brings new features and new platforms. We've added
information about network interfaces (duplex, speed, etc) along
with further statistics such as i/o packets, i/o errors, and
collisions. Support has also been added for OpenBSD and DragonFly
BSD. Finally some work has been done to reduce the platforms on
which libstatgrab needs elevated privileges. See the NEWS file for
more information.
</p>

<h3>Wednesday 11 February 2004</h3>
<p>
Version 0.8.2 of libstatgrab has been released.<br/>
Download it
<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.2.tar.gz">here</a>.
</p>
<p>
The main focus of this release is adding support for Solaris 6.
We've also added Python bindings so you can use libstatgrab directly
from Python (see the extras directory). Finally, we've tidied up a
few bits of the code.
</p>

<h3>Wednesday 21 January 2004</h3>
<p>
Version 0.8.1 of libstatgrab has been released.<br/>
Download it
<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.1.tar.gz">here</a>.
</p>
<p>
This release primarily fixes bugs. On Linux a file descriptor leak was
fixed. On Solaris some significant speed increases were made to the
disk mapping code, along with some bug fixes for Solaris 7 platforms.
Also, the library part of libstatgrab (but not the tools) is now
released under the LGPL instead of the GPL.
</p>

<h3>Tuesday 6 January 2004</h3>
<p>
Version 0.8 of libstatgrab has been released.<br/>
Download it
<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.tar.gz">here</a>.
</p>
<p>
This release brings support for Linux 2.6 and partial support for Cygwin.
On Solaris libstatgrab now returns disk names using cNtNdNsN names rather
than the older sdN names. There are also a bunch of fixes and optimisations
in various places. Finally, a new function has been added to make it
quicker to drop any elevated privileges libstatgrab may require on some
operating systems.
</p>

<h3>Wednesday 22 October 2003</h3>
<p>
Version 0.7 of libstatgrab has been released.<br/>
Download it
<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.7.tar.gz">here</a>.
</p>
<p>
The most significant change in this release is support for NetBSD
1.6.x. Parts of the FreeBSD code have been optimised, and an initialise
function has been added to allow programs to drop any extra privileges
libstatgrab needs. The list of known file systems has been increased,
and libstatgrab has been tested on even more platforms.  Finally,
saidar has been tweaked to work even if it can't get all the
statistics.
</p>

<h3>Saturday 18 October 2003</h3>
<p>
Version 0.6.1 of libstatgrab has been released.<br/>
Download it
<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.1.tar.gz">here</a>.
</p>
<p>
This release brings support for FreeBSD 5 on sparc 64, and some
bugfixes in FreeBSD memory statistics. Also, some fixes to saidar,
and statgrab.
</p>

<h3>Friday 10 October 2003</h3>
<p>
Version 0.6 of libstatgrab has been released.<br/>
You can download it from our mirror site
<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.tar.gz">here</a>.
</p>
<p>
This release includes some exciting new tools, support for FreeBSD
5.1, and documentation in manpages. Plus some major bugfixes and
packaging enhancements.
</p>

<h3>Tuesday 09 September 2003</h3>
<p>
We're pleased to announce a new release of libstatgrab.<br/>
You can download version 0.5.1 from
<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.1.tar.gz">here</a>.
</p>

<h3>Monday 25 August 2003</h3>
<p>
We're pleased to announce a new release of libstatgrab.<br/>
You can download version 0.5 from
<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.tar.gz">here</a>.
</p>
<p>
This release provides both documentation and examples, which
we hope will make the package more useable. Stay tuned for the
next release with some useful tools.
</p>

<h2><a name="what">What is libstatgrab?</a></h2>

<p>
libstatgrab is a library that provides cross platform access to
statistics about the system on which it's run. It's written in C and
presents a selection of useful interfaces which can be used to access
key system statistics. The current list of statistics includes CPU
usage, memory utilisation, disk usage, process counts, network
traffic, disk I/O, and more.
</p>

<p>
The current list of platforms is Solaris 2.x, Linux 2.2/2.4/2.6,
FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x, DragonFly BSD 1.0, and
Cygwin. The aim is to extend this to include as many operating
systems as possible.
</p>

<p>
The package also includes a couple of useful tools. The first,
<a href="#screenshot">saidar</a>, provides a curses-based interface to
viewing the current state of the system. The second, statgrab, gives a
sysctl-style interface to the statistics gathered by libstatgrab. This
extends the use of libstatgrab to people writing scripts or anything
else that can't easily make C function calls. Included with statgrab is
a script to generate an <a href="http://www.mrtg.org">MRTG</a>
configuration file to use statgrab.
</p>

<h2><a name="download">Downloading</a></h2>

<p>
The latest version of libstatgrab can be downloaded from our
primary download
<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/">mirror</a>.
All downloads are pgp signed using our <a href="/pgpkey.shtml">PGP Key</a>.
</p>

<p>
For installation instructions see the README and INSTALL files
contained within the archive. If you're using
<a href="http://www.freebsd.org">FreeBSD</a> you can make use of the
<a href="http://www.freshports.org/devel/libstatgrab">devel/libstatgrab</a>
port to install libstatgrab for you.
</p>

<h2><a name="documentation">Documentation</a></h2>

<p>
The only online documentation we have at the moment is the manual
pages converted in to HTML format. It's probably best to start with
the overview manual page:
</p>

<ul>
<li><a href="statgrab.html">statgrab(3)</a></li>
</ul>

<p>
Then we have the manual pages for each function:
</p>

<ul>
<li><a href="cpu_percent_usage.html">cpu_percent_usage(3)</a></li>
<li><a href="get_diskio_stats.html">get_diskio_stats(3)</a></li>
<li><a href="get_general_stats.html">get_general_stats(3)</a></li>
<li><a href="get_load_stats.html">get_load_stats(3)</a></li>
<li><a href="get_memory_stats.html">get_memory_stats(3)</a></li>
<li><a href="get_network_iface_stats.html">get_network_iface_stats(3)</a></li>
<li><a href="get_network_stats.html">get_network_stats(3)</a></li>
<li><a href="get_page_stats.html">get_page_stats(3)</a></li>
<li><a href="get_process_stats.html">get_process_stats(3)</a></li>
<li><a href="get_user_stats.html">get_user_stats(3)</a></li>
</ul>

<h2><a name="screenshot">Screenshot</a></h2>

<p>
Here's what saidar looks like when it's running:
</p>
<p>
<img src="saidar.png" alt="saidar screenshot" />
</p>
</div>

<!--#include virtual="/footer.inc" -->

</div>

<!--#include virtual="/menu.inc" -->

</div>

</body>
</html>
Revision:	1.19
Committed:	Sun Mar 21 23:58:38 2004 UTC (20 years, 8 months ago) by tdb
Branch:	MAIN
Changes since 1.18:	+80 -58 lines
Log Message:	Commit new website. The old site is tagged, so this won't change the live site... but it does move HEAD on to the new site. Too many changes to list really. General points are: - Moved to a XHTML CSS compliant site. - Reorganised the site into a more multi-project based look. - Removed a lot of cruft. Still to do: - Fix all the zillions of bugs stopping the whole site from validating :-) - Tidy up the HTML in terms of layout and indentation. Thanks to AJ for his help this weekend in doing this.
#	User	Rev	Content
1	tdb	1.19	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2			"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3	tdb	1.1
4			<html>
5
6			<head>
7	tdb	1.19	<title>i-scream libstatgrab homepage</title>
8			<!--#include virtual="/style.inc" -->
9	tdb	1.1	</head>
10
11	tdb	1.19	<body>
12
13			<div id="container">
14	tdb	1.1
15	tdb	1.19	<div id="main">
16	tdb	1.1
17	tdb	1.19	<!--#include virtual="/header.inc" -->
18	tdb	1.3
19	tdb	1.19	<div id="contents">
20	tdb	1.1
21	tdb	1.19	<h1 class="top">i-scream libstatgrab homepage</h1>
22
23			<div id="topnav">
24			<ul>
25			<li><a href="#news">News</a></li>
26			<li><a href="#what">What is libstatgrab?</a></li>
27			<li><a href="#download">Downloading</a></li>
28			<li><a href="#documentation">Documentation</a></li>
29			<li><a href="#screenshot">Screenshot</a></li>
30			</ul>
31			</div>
32	tdb	1.1
33	tdb	1.19	<h2><a name="news">News</a></h2>
34	tdb	1.12
35			<p>
36			To get notifications of new libstatgrab releases why not subscribe
37			to our project over on <a href="http://freshmeat.net/projects/libstatgrab/">
38			freshmeat</a>?
39	tdb	1.15	</p>
40
41	tdb	1.19	<h3>Sunday 21 March 2004</h3>
42			<p>
43			pystatgrab, a new package containing a set of Python bindings,
44			has been released. Check out it's <a href="/pystatgrab/">project
45			page</a>.
46			</p>
47
48			<h3>Wednesday 10 March 2004</h3>
49	tdb	1.15	<p>
50	tdb	1.19	Version 0.9 of libstatgrab has been released.<br/>
51	tdb	1.17	Download it
52			<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.9.tar.gz">here</a>.
53	tdb	1.19	</p>
54			<p>
55	tdb	1.17	This release brings new features and new platforms. We've added
56			information about network interfaces (duplex, speed, etc) along
57	tdb	1.18	with further statistics such as i/o packets, i/o errors, and
58			collisions. Support has also been added for OpenBSD and DragonFly
59			BSD. Finally some work has been done to reduce the platforms on
60			which libstatgrab needs elevated privileges. See the NEWS file for
61			more information.
62	tdb	1.17	</p>
63
64	tdb	1.19	<h3>Wednesday 11 February 2004</h3>
65	tdb	1.17	<p>
66	tdb	1.19	Version 0.8.2 of libstatgrab has been released.<br/>
67	tdb	1.15	Download it
68			<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.2.tar.gz">here</a>.
69	tdb	1.19	</p>
70			<p>
71	tdb	1.16	The main focus of this release is adding support for Solaris 6.
72	tdb	1.19	We've also added Python bindings so you can use libstatgrab directly
73			from Python (see the extras directory). Finally, we've tidied up a
74	tdb	1.16	few bits of the code.
75	tdb	1.14	</p>
76
77	tdb	1.19	<h3>Wednesday 21 January 2004</h3>
78	tdb	1.14	<p>
79	tdb	1.19	Version 0.8.1 of libstatgrab has been released.<br/>
80	tdb	1.14	Download it
81			<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.1.tar.gz">here</a>.
82	tdb	1.19	</p>
83			<p>
84	tdb	1.14	This release primarily fixes bugs. On Linux a file descriptor leak was
85			fixed. On Solaris some significant speed increases were made to the
86			disk mapping code, along with some bug fixes for Solaris 7 platforms.
87			Also, the library part of libstatgrab (but not the tools) is now
88			released under the LGPL instead of the GPL.
89	tdb	1.13	</p>
90
91	tdb	1.19	<h3>Tuesday 6 January 2004</h3>
92	tdb	1.13	<p>
93	tdb	1.19	Version 0.8 of libstatgrab has been released.<br/>
94	tdb	1.13	Download it
95			<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.tar.gz">here</a>.
96	tdb	1.19	</p>
97			<p>
98	tdb	1.13	This release brings support for Linux 2.6 and partial support for Cygwin.
99			On Solaris libstatgrab now returns disk names using cNtNdNsN names rather
100			than the older sdN names. There are also a bunch of fixes and optimisations
101			in various places. Finally, a new function has been added to make it
102			quicker to drop any elevated privileges libstatgrab may require on some
103			operating systems.
104	tdb	1.12	</p>
105	tdb	1.9
106	tdb	1.19	<h3>Wednesday 22 October 2003</h3>
107	tdb	1.9	<p>
108	tdb	1.19	Version 0.7 of libstatgrab has been released.<br/>
109	tdb	1.10	Download it
110			<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.7.tar.gz">here</a>.
111	tdb	1.19	</p>
112			<p>
113	tdb	1.10	The most significant change in this release is support for NetBSD
114			1.6.x. Parts of the FreeBSD code have been optimised, and an initialise
115			function has been added to allow programs to drop any extra privileges
116	tdb	1.11	libstatgrab needs. The list of known file systems has been increased,
117			and libstatgrab has been tested on even more platforms. Finally,
118			saidar has been tweaked to work even if it can't get all the
119	tdb	1.10	statistics.
120			</p>
121
122	tdb	1.19	<h3>Saturday 18 October 2003</h3>
123	tdb	1.10	<p>
124	tdb	1.19	Version 0.6.1 of libstatgrab has been released.<br/>
125	tdb	1.9	Download it
126			<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.1.tar.gz">here</a>.
127	tdb	1.19	</p>
128			<p>
129	tdb	1.9	This release brings support for FreeBSD 5 on sparc 64, and some
130			bugfixes in FreeBSD memory statistics. Also, some fixes to saidar,
131			and statgrab.
132			</p>
133	tdb	1.1
134	tdb	1.19	<h3>Friday 10 October 2003</h3>
135	tdb	1.1	<p>
136	tdb	1.19	Version 0.6 of libstatgrab has been released.<br/>
137	tdb	1.4	You can download it from our mirror site
138			<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.tar.gz">here</a>.
139	tdb	1.19	</p>
140			<p>
141	tdb	1.4	This release includes some exciting new tools, support for FreeBSD
142			5.1, and documentation in manpages. Plus some major bugfixes and
143			packaging enhancements.
144			</p>
145
146	tdb	1.19	<h3>Tuesday 09 September 2003</h3>
147	tdb	1.4	<p>
148	tdb	1.19	We're pleased to announce a new release of libstatgrab.<br/>
149	tdb	1.1	You can download version 0.5.1 from
150			<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.1.tar.gz">here</a>.
151			</p>
152
153	tdb	1.19	<h3>Monday 25 August 2003</h3>
154	tdb	1.1	<p>
155	tdb	1.19	We're pleased to announce a new release of libstatgrab.<br/>
156	tdb	1.1	You can download version 0.5 from
157			<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.tar.gz">here</a>.
158	tdb	1.19	</p>
159			<p>
160	tdb	1.1	This release provides both documentation and examples, which
161			we hope will make the package more useable. Stay tuned for the
162			next release with some useful tools.
163			</p>
164
165	tdb	1.19	<h2><a name="what">What is libstatgrab?</a></h2>
166	tdb	1.1
167			<p>
168			libstatgrab is a library that provides cross platform access to
169			statistics about the system on which it's run. It's written in C and
170			presents a selection of useful interfaces which can be used to access
171			key system statistics. The current list of statistics includes CPU
172			usage, memory utilisation, disk usage, process counts, network
173			traffic, disk I/O, and more.
174			</p>
175
176			<p>
177	tdb	1.17	The current list of platforms is Solaris 2.x, Linux 2.2/2.4/2.6,
178			FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x, DragonFly BSD 1.0, and
179			Cygwin. The aim is to extend this to include as many operating
180			systems as possible.
181	tdb	1.1	</p>
182
183			<p>
184	tdb	1.8	The package also includes a couple of useful tools. The first,
185			<a href="#screenshot">saidar</a>, provides a curses-based interface to
186			viewing the current state of the system. The second, statgrab, gives a
187			sysctl-style interface to the statistics gathered by libstatgrab. This
188			extends the use of libstatgrab to people writing scripts or anything
189			else that can't easily make C function calls. Included with statgrab is
190			a script to generate an <a href="http://www.mrtg.org">MRTG</a>
191			configuration file to use statgrab.
192	tdb	1.1	</p>
193
194	tdb	1.19	<h2><a name="download">Downloading</a></h2>
195	tdb	1.1
196			<p>
197			The latest version of libstatgrab can be downloaded from our
198			primary download
199	tdb	1.19	<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/">mirror</a>.
200	tdb	1.1	All downloads are pgp signed using our <a href="/pgpkey.shtml">PGP Key</a>.
201			</p>
202
203			<p>
204			For installation instructions see the README and INSTALL files
205			contained within the archive. If you're using
206			<a href="http://www.freebsd.org">FreeBSD</a> you can make use of the
207			<a href="http://www.freshports.org/devel/libstatgrab">devel/libstatgrab</a>
208			port to install libstatgrab for you.
209			</p>
210
211	tdb	1.19	<h2><a name="documentation">Documentation</a></h2>
212	tdb	1.1
213			<p>
214			The only online documentation we have at the moment is the manual
215			pages converted in to HTML format. It's probably best to start with
216			the overview manual page:
217	tdb	1.19	</p>
218	tdb	1.1
219			<ul>
220			<li><a href="statgrab.html">statgrab(3)</a></li>
221			</ul>
222
223			<p>
224			Then we have the manual pages for each function:
225	tdb	1.19	</p>
226	tdb	1.1
227			<ul>
228			<li><a href="cpu_percent_usage.html">cpu_percent_usage(3)</a></li>
229			<li><a href="get_diskio_stats.html">get_diskio_stats(3)</a></li>
230			<li><a href="get_general_stats.html">get_general_stats(3)</a></li>
231			<li><a href="get_load_stats.html">get_load_stats(3)</a></li>
232			<li><a href="get_memory_stats.html">get_memory_stats(3)</a></li>
233	tdb	1.17	<li><a href="get_network_iface_stats.html">get_network_iface_stats(3)</a></li>
234	tdb	1.1	<li><a href="get_network_stats.html">get_network_stats(3)</a></li>
235			<li><a href="get_page_stats.html">get_page_stats(3)</a></li>
236			<li><a href="get_process_stats.html">get_process_stats(3)</a></li>
237			<li><a href="get_user_stats.html">get_user_stats(3)</a></li>
238			</ul>
239	tdb	1.6
240	tdb	1.19	<h2><a name="screenshot">Screenshot</a></h2>
241	tdb	1.6
242			<p>
243			Here's what saidar looks like when it's running:
244	tdb	1.7	</p>
245			<p>
246	tdb	1.19	<img src="saidar.png" alt="saidar screenshot" />
247	tdb	1.1	</p>
248	tdb	1.19	</div>
249
250			<!--#include virtual="/footer.inc" -->
251
252			</div>
253	tdb	1.3
254	tdb	1.19	<!--#include virtual="/menu.inc" -->
255	tdb	1.1
256	tdb	1.19	</div>
257	tdb	1.1
258			</body>
259			</html>