1 |
|
<!--#include virtual="/doctype.inc" --> |
2 |
|
<head> |
3 |
|
<title> |
4 |
< |
i-scream libstatgrab homepage |
4 |
> |
libstatgrab homepage |
5 |
|
</title> |
6 |
|
<!--#include virtual="/style.inc" --> |
7 |
|
</head> |
11 |
|
<!--#include virtual="/header.inc" --> |
12 |
|
<div id="contents"> |
13 |
|
<h1 class="top"> |
14 |
< |
i-scream libstatgrab homepage |
14 |
> |
libstatgrab homepage |
15 |
|
</h1> |
16 |
|
<div id="topnav"> |
17 |
|
<ul> |
18 |
|
<li> |
19 |
< |
<a href="#news">News</a> |
19 |
> |
<a href="#what">What is libstatgrab?</a> |
20 |
|
</li> |
21 |
|
<li> |
22 |
< |
<a href="#what">What is libstatgrab?</a> |
22 |
> |
<a href="#news">News</a> |
23 |
|
</li> |
24 |
|
<li> |
25 |
|
<a href="#download">Downloading</a> |
42 |
|
</ul> |
43 |
|
</div> |
44 |
|
<h2> |
45 |
+ |
<a id="what">What is libstatgrab?</a> |
46 |
+ |
</h2> |
47 |
+ |
<p> |
48 |
+ |
libstatgrab is a library that provides cross platform |
49 |
+ |
access to statistics about the system on which it's run. |
50 |
+ |
It's written in C and presents a selection of useful |
51 |
+ |
interfaces which can be used to access key system |
52 |
+ |
statistics. The current list of statistics includes CPU |
53 |
+ |
usage, memory utilisation, disk usage, process counts, |
54 |
+ |
network traffic, disk I/O, and more. |
55 |
+ |
</p> |
56 |
+ |
<p> |
57 |
+ |
The current list of platforms is Solaris 2.x, Linux |
58 |
+ |
2.2/2.4/2.6, FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x, |
59 |
+ |
DragonFly BSD 1.0, HP-UX, and Cygwin. The aim is to extend |
60 |
+ |
this to include as many operating systems as possible. |
61 |
+ |
</p> |
62 |
+ |
<p> |
63 |
+ |
The package also includes a couple of useful tools. The |
64 |
+ |
first, <a href="#screenshot">saidar</a>, provides a |
65 |
+ |
curses-based interface to viewing the current state of the |
66 |
+ |
system. The second, statgrab, gives a sysctl-style |
67 |
+ |
interface to the statistics gathered by libstatgrab. This |
68 |
+ |
extends the use of libstatgrab to people writing scripts or |
69 |
+ |
anything else that can't easily make C function calls. |
70 |
+ |
Included with statgrab is a script to generate an |
71 |
+ |
<a href="http://www.mrtg.org">MRTG</a> configuration file |
72 |
+ |
to use statgrab. |
73 |
+ |
</p> |
74 |
+ |
<h2> |
75 |
|
<a id="news">News</a> |
76 |
|
</h2> |
77 |
+ |
<h3> |
78 |
+ |
Sunday 21 February 2010 |
79 |
+ |
</h3> |
80 |
|
<p> |
81 |
< |
To get notifications of new libstatgrab releases why not |
82 |
< |
subscribe to our project over on |
50 |
< |
<a href="http://freshmeat.net/projects/libstatgrab/">freshmeat</a>? |
81 |
> |
Version 0.17 of libstatgrab has been released.<br /> |
82 |
> |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
83 |
|
</p> |
84 |
+ |
<p> |
85 |
+ |
This release adds support for FreeBSD 9 and other systems |
86 |
+ |
using utmpx. Also on FreeBSD it fixes an issue with large |
87 |
+ |
quantities of memory and adds support for dynamically |
88 |
+ |
getting a list of supported file systems. On Solaris ZFS |
89 |
+ |
file systems will now be detected. And finally on Linux CPU |
90 |
+ |
iowait information will be given where available. |
91 |
+ |
</p> |
92 |
|
<h3> |
93 |
+ |
Friday 30 May 2008 |
94 |
+ |
</h3> |
95 |
+ |
<p> |
96 |
+ |
Dag Odenhall got in touch today to let us know he's written |
97 |
+ |
<a href="http://statgrab.rubyforge.org/">Ruby bindings</a> |
98 |
+ |
for libstatgrab. Thanks Dag! |
99 |
+ |
</p> |
100 |
+ |
<h3> |
101 |
+ |
Monday 17 March 2008 |
102 |
+ |
</h3> |
103 |
+ |
<p> |
104 |
+ |
Version 0.16 of libstatgrab has been released.<br /> |
105 |
+ |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
106 |
+ |
</p> |
107 |
+ |
<p> |
108 |
+ |
This release fixes some minor build problems on Solaris |
109 |
+ |
with Sun's compiler, and on the Debian "armel" port. Also |
110 |
+ |
a minor fix to statgrab-make-mrtg-config on machines with |
111 |
+ |
no swap, and added support for FreeBSD 8. |
112 |
+ |
</p> |
113 |
+ |
<h3> |
114 |
+ |
Saturday 14 July 2007 |
115 |
+ |
</h3> |
116 |
+ |
<p> |
117 |
+ |
Version 0.15 of libstatgrab has been released.<br /> |
118 |
+ |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
119 |
+ |
</p> |
120 |
+ |
<p> |
121 |
+ |
This release fixes a regression introduced on OpenBSD in |
122 |
+ |
the last release - memory statistics were reported |
123 |
+ |
incorrectly. Some other minor changes have been made, see |
124 |
+ |
the NEWS file for more information. |
125 |
+ |
</p> |
126 |
+ |
<h3> |
127 |
+ |
Monday 8 January 2007 |
128 |
+ |
</h3> |
129 |
+ |
<p> |
130 |
+ |
Version 0.14 of libstatgrab has been released.<br /> |
131 |
+ |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
132 |
+ |
</p> |
133 |
+ |
<p> |
134 |
+ |
This release contains mainly bugfixes - see the NEWS file |
135 |
+ |
in the distribution for a full list. It also brings a new |
136 |
+ |
feature in saidar: colour support, which can be activated |
137 |
+ |
with the -c runtime flag. |
138 |
+ |
</p> |
139 |
+ |
<h3> |
140 |
+ |
Monday 20 March 2006 |
141 |
+ |
</h3> |
142 |
+ |
<p> |
143 |
+ |
Version 0.13 of libstatgrab has been released.<br /> |
144 |
+ |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
145 |
+ |
</p> |
146 |
+ |
<p> |
147 |
+ |
This release mainly includes a bunch of bug fixes, but |
148 |
+ |
also brings preliminary support for WIN32. We've also |
149 |
+ |
added a few lines to the header file to make C++ linking |
150 |
+ |
easier. Please see the NEWS file in the distribution for |
151 |
+ |
full details. |
152 |
+ |
</p> |
153 |
+ |
<h3> |
154 |
+ |
Sunday 31 July 2005 |
155 |
+ |
</h3> |
156 |
+ |
<p> |
157 |
+ |
Version 0.12 of libstatgrab has been released.<br /> |
158 |
+ |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
159 |
+ |
</p> |
160 |
+ |
<p> |
161 |
+ |
This release has some new features, bug fixes, and a minor |
162 |
+ |
API change. More details have been added to the file |
163 |
+ |
system statistics, linux partition detection has been |
164 |
+ |
reworked, and compile errors on Linux 2.6 have been fixed. |
165 |
+ |
Support has been added for Solaris 10 and FreeBSD 7. |
166 |
+ |
There are also manual pages for all the tools. |
167 |
+ |
</p> |
168 |
+ |
<p> |
169 |
+ |
The duplex value in the network interface statistics has |
170 |
+ |
changed name from "dup" to "duplex" - this breaks the API. |
171 |
+ |
We plan to stabilise the API for a 1.0 release. As before, |
172 |
+ |
the old name is available if SG_ENABLE_DEPRECATED is |
173 |
+ |
defined. |
174 |
+ |
</p> |
175 |
+ |
<h3> |
176 |
+ |
Tuesday 26 April 2005 |
177 |
+ |
</h3> |
178 |
+ |
<p> |
179 |
+ |
Official libstatgrab packages for Debian now |
180 |
+ |
<a href="http://packages.debian.org/unstable/source/libstatgrab">available</a>. |
181 |
+ |
</p> |
182 |
+ |
<p> |
183 |
+ |
Thanks to the work of |
184 |
+ |
<a href="mailto:fenio@debian.org">Bartosz Fenski</a> |
185 |
+ |
libstatgrab is now available on debian. This replaces our |
186 |
+ |
unofficial debian packages which will no longer be |
187 |
+ |
updated. |
188 |
+ |
</p> |
189 |
+ |
<h3> |
190 |
+ |
Thursday 3 March 2005 |
191 |
+ |
</h3> |
192 |
+ |
<p> |
193 |
+ |
Version 0.11.1 of libstatgrab has been released.<br /> |
194 |
+ |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
195 |
+ |
</p> |
196 |
+ |
<p> |
197 |
+ |
This release fixes a handful of minor bugs. Duplex |
198 |
+ |
settings were reported incorrectly on linux (half and |
199 |
+ |
full duplex were swapped), saidar displayed negative |
200 |
+ |
filesystem stats incorrectly, and NFS filesystems were |
201 |
+ |
ignored. These have all been fixed. |
202 |
+ |
</p> |
203 |
+ |
<h3> |
204 |
|
Friday 12 November 2004 |
205 |
|
</h3> |
206 |
|
<p> |
287 |
|
</h3> |
288 |
|
<p> |
289 |
|
pystatgrab, a new package containing a set of Python |
290 |
< |
bindings, has been released. Check out it's |
290 |
> |
bindings, has been released. Check out its |
291 |
|
<a href="/pystatgrab/">project page</a>. |
292 |
|
</p> |
142 |
– |
<h3> |
143 |
– |
Wednesday 10 March 2004 |
144 |
– |
</h3> |
145 |
– |
<p> |
146 |
– |
Version 0.9 of libstatgrab has been released.<br /> |
147 |
– |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
148 |
– |
</p> |
149 |
– |
<p> |
150 |
– |
This release brings new features and new platforms. We've |
151 |
– |
added information about network interfaces (duplex, speed, |
152 |
– |
etc) along with further statistics such as i/o packets, i/o |
153 |
– |
errors, and collisions. Support has also been added for |
154 |
– |
OpenBSD and DragonFly BSD. Finally some work has been done |
155 |
– |
to reduce the platforms on which libstatgrab needs elevated |
156 |
– |
privileges. See the NEWS file for more information. |
157 |
– |
</p> |
158 |
– |
<h3> |
159 |
– |
Wednesday 11 February 2004 |
160 |
– |
</h3> |
161 |
– |
<p> |
162 |
– |
Version 0.8.2 of libstatgrab has been released.<br /> |
163 |
– |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
164 |
– |
</p> |
165 |
– |
<p> |
166 |
– |
The main focus of this release is adding support for |
167 |
– |
Solaris 6. We've also added Python bindings so you can use |
168 |
– |
libstatgrab directly from Python (see the extras |
169 |
– |
directory). Finally, we've tidied up a few bits of the |
170 |
– |
code. |
171 |
– |
</p> |
172 |
– |
<h3> |
173 |
– |
Wednesday 21 January 2004 |
174 |
– |
</h3> |
175 |
– |
<p> |
176 |
– |
Version 0.8.1 of libstatgrab has been released.<br /> |
177 |
– |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
178 |
– |
</p> |
179 |
– |
<p> |
180 |
– |
This release primarily fixes bugs. On Linux a file |
181 |
– |
descriptor leak was fixed. On Solaris some significant |
182 |
– |
speed increases were made to the disk mapping code, along |
183 |
– |
with some bug fixes for Solaris 7 platforms. Also, the |
184 |
– |
library part of libstatgrab (but not the tools) is now |
185 |
– |
released under the LGPL instead of the GPL. |
186 |
– |
</p> |
187 |
– |
<h3> |
188 |
– |
Tuesday 6 January 2004 |
189 |
– |
</h3> |
190 |
– |
<p> |
191 |
– |
Version 0.8 of libstatgrab has been released.<br /> |
192 |
– |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
193 |
– |
</p> |
194 |
– |
<p> |
195 |
– |
This release brings support for Linux 2.6 and partial |
196 |
– |
support for Cygwin. On Solaris libstatgrab now returns disk |
197 |
– |
names using cNtNdNsN names rather than the older sdN names. |
198 |
– |
There are also a bunch of fixes and optimisations in |
199 |
– |
various places. Finally, a new function has been added to |
200 |
– |
make it quicker to drop any elevated privileges libstatgrab |
201 |
– |
may require on some operating systems. |
202 |
– |
</p> |
293 |
|
<h2> |
204 |
– |
<a id="what">What is libstatgrab?</a> |
205 |
– |
</h2> |
206 |
– |
<p> |
207 |
– |
libstatgrab is a library that provides cross platform |
208 |
– |
access to statistics about the system on which it's run. |
209 |
– |
It's written in C and presents a selection of useful |
210 |
– |
interfaces which can be used to access key system |
211 |
– |
statistics. The current list of statistics includes CPU |
212 |
– |
usage, memory utilisation, disk usage, process counts, |
213 |
– |
network traffic, disk I/O, and more. |
214 |
– |
</p> |
215 |
– |
<p> |
216 |
– |
The current list of platforms is Solaris 2.x, Linux |
217 |
– |
2.2/2.4/2.6, FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x, |
218 |
– |
DragonFly BSD 1.0, HP-UX, and Cygwin. The aim is to extend |
219 |
– |
this to include as many operating systems as possible. |
220 |
– |
</p> |
221 |
– |
<p> |
222 |
– |
The package also includes a couple of useful tools. The |
223 |
– |
first, <a href="#screenshot">saidar</a>, provides a |
224 |
– |
curses-based interface to viewing the current state of the |
225 |
– |
system. The second, statgrab, gives a sysctl-style |
226 |
– |
interface to the statistics gathered by libstatgrab. This |
227 |
– |
extends the use of libstatgrab to people writing scripts or |
228 |
– |
anything else that can't easily make C function calls. |
229 |
– |
Included with statgrab is a script to generate an |
230 |
– |
<a href="http://www.mrtg.org">MRTG</a> configuration file |
231 |
– |
to use statgrab. |
232 |
– |
</p> |
233 |
– |
<h2> |
294 |
|
<a id="download">Downloading</a> |
295 |
|
</h2> |
296 |
|
<p> |
311 |
|
<a href="/pystatgrab/">Python</a> |
312 |
|
</li> |
313 |
|
<li> |
314 |
< |
<a href="http://pecl.php.net/statgrab/">PHP (external)</a> |
314 |
> |
<a href="http://pecl.php.net/statgrab/">PHP</a> |
315 |
|
</li> |
316 |
|
<li> |
317 |
< |
<a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl (external)</a> |
317 |
> |
<a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl</a> |
318 |
|
</li> |
319 |
+ |
<li> |
320 |
+ |
<a href="http://statgrab.rubyforge.org/">Ruby</a> |
321 |
+ |
</li> |
322 |
|
</ul> |
323 |
|
<p> |
324 |
|
Here are links to bindings for higher level languages |
325 |
|
that provide access to libstatgrab. If you've written |
326 |
< |
a binding for another language, please get |
264 |
< |
<a href="mailto:dev@i-scream.org">in touch</a> so we |
326 |
> |
a binding for another language, please get in touch so we |
327 |
|
can add a link here. |
328 |
|
</p> |
329 |
|
<h2> |
334 |
|
<a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&stype=all">FreeBSD</a> |
335 |
|
</li> |
336 |
|
<li> |
337 |
< |
<a href="http://packages.gentoo.org/search/?sstring=statgrab">Gentoo Linux</a> |
337 |
> |
<a href="http://packages.gentoo.org/search/?sstring=libstatgrab">Gentoo Linux</a> |
338 |
|
</li> |
339 |
|
<li> |
340 |
|
<a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a> |
341 |
|
</li> |
342 |
|
<li> |
343 |
< |
<a href="http://ftp.i-scream.org/pub/i-scream/packages/debian/">Debian (unofficial)</a> |
343 |
> |
<a href="http://www.sunfreeware.com/">Solaris (SunFreeware)</a> |
344 |
|
</li> |
345 |
|
<li> |
346 |
+ |
<a href="http://www.opencsw.org/packages/libstatgrab/">Solaris (OpenCSW)</a> |
347 |
+ |
</li> |
348 |
+ |
<li> |
349 |
+ |
<a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a> |
350 |
+ |
</li> |
351 |
+ |
<li> |
352 |
|
<a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a> |
353 |
|
</li> |
354 |
+ |
<li> |
355 |
+ |
<a href="http://software.opensuse.org/download/home:/anagappan/">RPMs for various Linux distributions</a> |
356 |
+ |
</li> |
357 |
+ |
<li> |
358 |
+ |
<a href="http://www.openbsd.org/cgi-bin/cvsweb/ports/sysutils/libstatgrab/">OpenBSD</a> |
359 |
+ |
</li> |
360 |
|
</ul> |
361 |
|
<p> |
362 |
|
These are various pre-packaged versions of libstatgrab |
367 |
|
We've noticed that google throws up some RPM's relating |
368 |
|
to Mandrake and Suse, but no webpage for them. |
369 |
|
</p> |
296 |
– |
<p> |
297 |
– |
Several attempts were made to submit a port to the |
298 |
– |
OpenBSD folk, but they didn't seem interested in taking |
299 |
– |
it. You can find it |
300 |
– |
<a href="http://ftp.i-scream.org/pub/i-scream/tmp/libstatgrab-0.11-openbsd-port.tar.gz"> |
301 |
– |
here. |
302 |
– |
</p> |
370 |
|
<h2> |
371 |
< |
<a id="development">Development</a> |
371 |
> |
<a id="documentation">Documentation</a> |
372 |
|
</h2> |
373 |
+ |
<p> |
374 |
+ |
The only online documentation we have at the moment is the |
375 |
+ |
manual pages converted in to HTML format. First are the |
376 |
+ |
manual pages for the command line tools: |
377 |
+ |
</p> |
378 |
|
<ul> |
379 |
|
<li> |
380 |
< |
<a href="/cgi-bin/cvslog.cgi?period=thisweek&module=projects/libstatgrab">Commits this week</a> |
380 |
> |
<a href="docs/saidar.1.html">saidar(1)</a> |
381 |
|
</li> |
382 |
+ |
<li> |
383 |
+ |
<a href="docs/statgrab.1.html">statgrab(1)</a> |
384 |
+ |
</li> |
385 |
+ |
<li> |
386 |
+ |
<a href="docs/statgrab-make-mrtg-config.1.html">statgrab-make-mrtg-config(1)</a> |
387 |
+ |
</li> |
388 |
+ |
<li> |
389 |
+ |
<a href="docs/statgrab-make-mrtg-index.1.html">statgrab-make-mrtg-index(1)</a> |
390 |
+ |
</li> |
391 |
|
</ul> |
392 |
|
<p> |
393 |
< |
We develop libstatgrab using the CVS revision control system. |
313 |
< |
Using this link you can see what changes we've made this week. |
314 |
< |
For more information on our CVS setup see our |
315 |
< |
<a href="/cvs.xhtml">CVS page</a>. |
393 |
> |
We also have an overview page for the library: |
394 |
|
</p> |
317 |
– |
<h2> |
318 |
– |
<a id="documentation">Documentation</a> |
319 |
– |
</h2> |
320 |
– |
<p> |
321 |
– |
The only online documentation we have at the moment is the |
322 |
– |
manual pages converted in to HTML format. It's probably |
323 |
– |
best to start with the overview manual page: |
324 |
– |
</p> |
395 |
|
<ul> |
396 |
|
<li> |
397 |
< |
<a href="statgrab.html">statgrab(3)</a> |
397 |
> |
<a href="docs/statgrab.3.html">statgrab(3)</a> |
398 |
|
</li> |
399 |
|
</ul> |
400 |
|
<p> |
402 |
|
</p> |
403 |
|
<ul> |
404 |
|
<li> |
405 |
< |
<a href="sg_get_cpu_stats.html">sg_get_cpu_stats(3)</a> |
405 |
> |
<a href="docs/sg_get_cpu_stats.3.html">sg_get_cpu_stats(3)</a> |
406 |
|
</li> |
407 |
|
<li> |
408 |
< |
<a href="sg_get_disk_io_stats.html">sg_get_disk_io_stats(3)</a> |
408 |
> |
<a href="docs/sg_get_disk_io_stats.3.html">sg_get_disk_io_stats(3)</a> |
409 |
|
</li> |
410 |
|
<li> |
411 |
< |
<a href="sg_get_fs_stats.html">sg_get_fs_stats(3)</a> |
411 |
> |
<a href="docs/sg_get_fs_stats.3.html">sg_get_fs_stats(3)</a> |
412 |
|
</li> |
413 |
|
<li> |
414 |
< |
<a href="sg_get_host_info.html">sg_get_host_info(3)</a> |
414 |
> |
<a href="docs/sg_get_host_info.3.html">sg_get_host_info(3)</a> |
415 |
|
</li> |
416 |
|
<li> |
417 |
< |
<a href="sg_get_load_stats.html">sg_get_load_stats(3)</a> |
417 |
> |
<a href="docs/sg_get_load_stats.3.html">sg_get_load_stats(3)</a> |
418 |
|
</li> |
419 |
|
<li> |
420 |
< |
<a href="sg_get_mem_stats.html">sg_get_mem_stats(3)</a> |
420 |
> |
<a href="docs/sg_get_mem_stats.3.html">sg_get_mem_stats(3)</a> |
421 |
|
</li> |
422 |
|
<li> |
423 |
< |
<a href="sg_get_network_iface_stats.html">sg_get_network_iface_stats(3)</a> |
423 |
> |
<a href="docs/sg_get_network_iface_stats.3.html">sg_get_network_iface_stats(3)</a> |
424 |
|
</li> |
425 |
|
<li> |
426 |
< |
<a href="sg_get_network_io_stats.html">sg_get_network_io_stats(3)</a> |
426 |
> |
<a href="docs/sg_get_network_io_stats.3.html">sg_get_network_io_stats(3)</a> |
427 |
|
</li> |
428 |
|
<li> |
429 |
< |
<a href="sg_get_page_stats.html">sg_get_page_stats(3)</a> |
429 |
> |
<a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a> |
430 |
|
</li> |
431 |
|
<li> |
432 |
< |
<a href="sg_get_process_stats.html">sg_get_process_stats(3)</a> |
432 |
> |
<a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a> |
433 |
|
</li> |
434 |
|
<li> |
435 |
< |
<a href="sg_get_user_stats.html">sg_get_user_stats(3)</a> |
435 |
> |
<a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a> |
436 |
|
</li> |
437 |
|
</ul> |
438 |
|
<h2> |