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