www/libstatgrab/index.xhtml

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

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