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 |
|
<p> |
80 |
|
<a href="http://freshmeat.net/projects/libstatgrab/">freshmeat</a>? |
81 |
|
</p> |
82 |
|
<h3> |
83 |
+ |
Sunday 21 February 2010 |
84 |
+ |
</h3> |
85 |
+ |
<p> |
86 |
+ |
Version 0.17 of libstatgrab has been released.<br /> |
87 |
+ |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
88 |
+ |
</p> |
89 |
+ |
<p> |
90 |
+ |
This release adds support for FreeBSD 9 and other systems |
91 |
+ |
using utmpx. Also on FreeBSD it fixes an issue with large |
92 |
+ |
quantities of memory and adds support for dynamically |
93 |
+ |
getting a list of supported file systems. On Solaris ZFS |
94 |
+ |
file systems will now be detected. And finally on Linux CPU |
95 |
+ |
iowait information will be given where available. |
96 |
+ |
</p> |
97 |
+ |
<h3> |
98 |
+ |
Friday 30 May 2008 |
99 |
+ |
</h3> |
100 |
+ |
<p> |
101 |
+ |
Dag Odenhall got in touch today to let us know he's written |
102 |
+ |
<a href="http://statgrab.rubyforge.org/">Ruby bindings</a> |
103 |
+ |
for libstatgrab. Thanks Dag! |
104 |
+ |
</p> |
105 |
+ |
<h3> |
106 |
+ |
Monday 17 March 2008 |
107 |
+ |
</h3> |
108 |
+ |
<p> |
109 |
+ |
Version 0.16 of libstatgrab has been released.<br /> |
110 |
+ |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
111 |
+ |
</p> |
112 |
+ |
<p> |
113 |
+ |
This release fixes some minor build problems on Solaris |
114 |
+ |
with Sun's compiler, and on the Debian "armel" port. Also |
115 |
+ |
a minor fix to statgrab-make-mrtg-config on machines with |
116 |
+ |
no swap, and added support for FreeBSD 8. |
117 |
+ |
</p> |
118 |
+ |
<h3> |
119 |
+ |
Saturday 14 July 2007 |
120 |
+ |
</h3> |
121 |
+ |
<p> |
122 |
+ |
Version 0.15 of libstatgrab has been released.<br /> |
123 |
+ |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
124 |
+ |
</p> |
125 |
+ |
<p> |
126 |
+ |
This release fixes a regression introduced on OpenBSD in |
127 |
+ |
the last release - memory statistics were reported |
128 |
+ |
incorrectly. Some other minor changes have been made, see |
129 |
+ |
the NEWS file for more information. |
130 |
+ |
</p> |
131 |
+ |
<h3> |
132 |
+ |
Monday 8 January 2007 |
133 |
+ |
</h3> |
134 |
+ |
<p> |
135 |
+ |
Version 0.14 of libstatgrab has been released.<br /> |
136 |
+ |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
137 |
+ |
</p> |
138 |
+ |
<p> |
139 |
+ |
This release contains mainly bugfixes - see the NEWS file |
140 |
+ |
in the distribution for a full list. It also brings a new |
141 |
+ |
feature in saidar: colour support, which can be activated |
142 |
+ |
with the -c runtime flag. |
143 |
+ |
</p> |
144 |
+ |
<h3> |
145 |
+ |
Monday 20 March 2006 |
146 |
+ |
</h3> |
147 |
+ |
<p> |
148 |
+ |
Version 0.13 of libstatgrab has been released.<br /> |
149 |
+ |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
150 |
+ |
</p> |
151 |
+ |
<p> |
152 |
+ |
This release mainly includes a bunch of bug fixes, but |
153 |
+ |
also brings preliminary support for WIN32. We've also |
154 |
+ |
added a few lines to the header file to make C++ linking |
155 |
+ |
easier. Please see the NEWS file in the distribution for |
156 |
+ |
full details. |
157 |
+ |
</p> |
158 |
+ |
<h3> |
159 |
+ |
Sunday 31 July 2005 |
160 |
+ |
</h3> |
161 |
+ |
<p> |
162 |
+ |
Version 0.12 of libstatgrab has been released.<br /> |
163 |
+ |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
164 |
+ |
</p> |
165 |
+ |
<p> |
166 |
+ |
This release has some new features, bug fixes, and a minor |
167 |
+ |
API change. More details have been added to the file |
168 |
+ |
system statistics, linux partition detection has been |
169 |
+ |
reworked, and compile errors on Linux 2.6 have been fixed. |
170 |
+ |
Support has been added for Solaris 10 and FreeBSD 7. |
171 |
+ |
There are also manual pages for all the tools. |
172 |
+ |
</p> |
173 |
+ |
<p> |
174 |
+ |
The duplex value in the network interface statistics has |
175 |
+ |
changed name from "dup" to "duplex" - this breaks the API. |
176 |
+ |
We plan to stabilise the API for a 1.0 release. As before, |
177 |
+ |
the old name is available if SG_ENABLE_DEPRECATED is |
178 |
+ |
defined. |
179 |
+ |
</p> |
180 |
+ |
<h3> |
181 |
+ |
Tuesday 26 April 2005 |
182 |
+ |
</h3> |
183 |
+ |
<p> |
184 |
+ |
Official libstatgrab packages for Debian now |
185 |
+ |
<a href="http://packages.debian.org/unstable/source/libstatgrab">available</a>. |
186 |
+ |
</p> |
187 |
+ |
<p> |
188 |
+ |
Thanks to the work of |
189 |
+ |
<a href="mailto:fenio@debian.org">Bartosz Fenski</a> |
190 |
+ |
libstatgrab is now available on debian. This replaces our |
191 |
+ |
unofficial debian packages which will no longer be |
192 |
+ |
updated. |
193 |
+ |
</p> |
194 |
+ |
<h3> |
195 |
+ |
Thursday 3 March 2005 |
196 |
+ |
</h3> |
197 |
+ |
<p> |
198 |
+ |
Version 0.11.1 of libstatgrab has been released.<br /> |
199 |
+ |
Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
200 |
+ |
</p> |
201 |
+ |
<p> |
202 |
+ |
This release fixes a handful of minor bugs. Duplex |
203 |
+ |
settings were reported incorrectly on linux (half and |
204 |
+ |
full duplex were swapped), saidar displayed negative |
205 |
+ |
filesystem stats incorrectly, and NFS filesystems were |
206 |
+ |
ignored. These have all been fixed. |
207 |
+ |
</p> |
208 |
+ |
<h3> |
209 |
|
Friday 12 November 2004 |
210 |
|
</h3> |
211 |
|
<p> |
292 |
|
</h3> |
293 |
|
<p> |
294 |
|
pystatgrab, a new package containing a set of Python |
295 |
< |
bindings, has been released. Check out it's |
295 |
> |
bindings, has been released. Check out its |
296 |
|
<a href="/pystatgrab/">project page</a>. |
297 |
|
</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> |
298 |
|
<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> |
299 |
|
<a id="download">Downloading</a> |
300 |
|
</h2> |
301 |
|
<p> |
316 |
|
<a href="/pystatgrab/">Python</a> |
317 |
|
</li> |
318 |
|
<li> |
319 |
< |
<a href="http://pecl.php.net/statgrab/">PHP (external)</a> |
319 |
> |
<a href="http://pecl.php.net/statgrab/">PHP</a> |
320 |
|
</li> |
321 |
|
<li> |
322 |
< |
<a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl (external)</a> |
322 |
> |
<a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl</a> |
323 |
|
</li> |
324 |
+ |
<li> |
325 |
+ |
<a href="http://statgrab.rubyforge.org/">Ruby</a> |
326 |
+ |
</li> |
327 |
|
</ul> |
328 |
|
<p> |
329 |
|
Here are links to bindings for higher level languages |
330 |
|
that provide access to libstatgrab. If you've written |
331 |
|
a binding for another language, please get |
332 |
< |
<a href="mailto:dev@i-scream.org">in touch</a> so we |
332 |
> |
<a href="mailto:support@i-scream.org">in touch</a> so we |
333 |
|
can add a link here. |
334 |
|
</p> |
335 |
|
<h2> |
340 |
|
<a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&stype=all">FreeBSD</a> |
341 |
|
</li> |
342 |
|
<li> |
343 |
< |
<a href="http://packages.gentoo.org/search/?sstring=statgrab">Gentoo Linux</a> |
343 |
> |
<a href="http://packages.gentoo.org/search/?sstring=libstatgrab">Gentoo Linux</a> |
344 |
|
</li> |
345 |
|
<li> |
346 |
|
<a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a> |
347 |
|
</li> |
348 |
|
<li> |
349 |
< |
<a href="http://ftp.i-scream.org/pub/i-scream/packages/debian/">Debian (unofficial)</a> |
349 |
> |
<a href="http://www.sunfreeware.com/">Solaris (SunFreeware)</a> |
350 |
|
</li> |
351 |
|
<li> |
352 |
+ |
<a href="http://www.opencsw.org/packages/libstatgrab/">Solaris (OpenCSW)</a> |
353 |
+ |
</li> |
354 |
+ |
<li> |
355 |
+ |
<a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a> |
356 |
+ |
</li> |
357 |
+ |
<li> |
358 |
|
<a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a> |
359 |
|
</li> |
360 |
+ |
<li> |
361 |
+ |
<a href="http://software.opensuse.org/download/home:/anagappan/">RPMs for various Linux distributions</a> |
362 |
+ |
</li> |
363 |
+ |
<li> |
364 |
+ |
<a href="http://www.openbsd.org/cgi-bin/cvsweb/ports/sysutils/libstatgrab/">OpenBSD</a> |
365 |
+ |
</li> |
366 |
|
</ul> |
367 |
|
<p> |
368 |
|
These are various pre-packaged versions of libstatgrab |
373 |
|
We've noticed that google throws up some RPM's relating |
374 |
|
to Mandrake and Suse, but no webpage for them. |
375 |
|
</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> |
376 |
|
<h2> |
377 |
|
<a id="development">Development</a> |
378 |
|
</h2> |
392 |
|
</h2> |
393 |
|
<p> |
394 |
|
The only online documentation we have at the moment is the |
395 |
< |
manual pages converted in to HTML format. It's probably |
396 |
< |
best to start with the overview manual page: |
395 |
> |
manual pages converted in to HTML format. First are the |
396 |
> |
manual pages for the command line tools: |
397 |
|
</p> |
398 |
|
<ul> |
399 |
|
<li> |
400 |
< |
<a href="statgrab.html">statgrab(3)</a> |
400 |
> |
<a href="docs/saidar.1.html">saidar(1)</a> |
401 |
|
</li> |
402 |
+ |
<li> |
403 |
+ |
<a href="docs/statgrab.1.html">statgrab(1)</a> |
404 |
+ |
</li> |
405 |
+ |
<li> |
406 |
+ |
<a href="docs/statgrab-make-mrtg-config.1.html">statgrab-make-mrtg-config(1)</a> |
407 |
+ |
</li> |
408 |
+ |
<li> |
409 |
+ |
<a href="docs/statgrab-make-mrtg-index.1.html">statgrab-make-mrtg-index(1)</a> |
410 |
+ |
</li> |
411 |
|
</ul> |
412 |
|
<p> |
413 |
+ |
We also have an overview page for the library: |
414 |
+ |
</p> |
415 |
+ |
<ul> |
416 |
+ |
<li> |
417 |
+ |
<a href="docs/statgrab.3.html">statgrab(3)</a> |
418 |
+ |
</li> |
419 |
+ |
</ul> |
420 |
+ |
<p> |
421 |
|
Then we have the manual pages for each function: |
422 |
|
</p> |
423 |
|
<ul> |
424 |
|
<li> |
425 |
< |
<a href="sg_get_cpu_stats.html">sg_get_cpu_stats(3)</a> |
425 |
> |
<a href="docs/sg_get_cpu_stats.3.html">sg_get_cpu_stats(3)</a> |
426 |
|
</li> |
427 |
|
<li> |
428 |
< |
<a href="sg_get_disk_io_stats.html">sg_get_disk_io_stats(3)</a> |
428 |
> |
<a href="docs/sg_get_disk_io_stats.3.html">sg_get_disk_io_stats(3)</a> |
429 |
|
</li> |
430 |
|
<li> |
431 |
< |
<a href="sg_get_fs_stats.html">sg_get_fs_stats(3)</a> |
431 |
> |
<a href="docs/sg_get_fs_stats.3.html">sg_get_fs_stats(3)</a> |
432 |
|
</li> |
433 |
|
<li> |
434 |
< |
<a href="sg_get_host_info.html">sg_get_host_info(3)</a> |
434 |
> |
<a href="docs/sg_get_host_info.3.html">sg_get_host_info(3)</a> |
435 |
|
</li> |
436 |
|
<li> |
437 |
< |
<a href="sg_get_load_stats.html">sg_get_load_stats(3)</a> |
437 |
> |
<a href="docs/sg_get_load_stats.3.html">sg_get_load_stats(3)</a> |
438 |
|
</li> |
439 |
|
<li> |
440 |
< |
<a href="sg_get_mem_stats.html">sg_get_mem_stats(3)</a> |
440 |
> |
<a href="docs/sg_get_mem_stats.3.html">sg_get_mem_stats(3)</a> |
441 |
|
</li> |
442 |
|
<li> |
443 |
< |
<a href="sg_get_network_iface_stats.html">sg_get_network_iface_stats(3)</a> |
443 |
> |
<a href="docs/sg_get_network_iface_stats.3.html">sg_get_network_iface_stats(3)</a> |
444 |
|
</li> |
445 |
|
<li> |
446 |
< |
<a href="sg_get_network_io_stats.html">sg_get_network_io_stats(3)</a> |
446 |
> |
<a href="docs/sg_get_network_io_stats.3.html">sg_get_network_io_stats(3)</a> |
447 |
|
</li> |
448 |
|
<li> |
449 |
< |
<a href="sg_get_page_stats.html">sg_get_page_stats(3)</a> |
449 |
> |
<a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a> |
450 |
|
</li> |
451 |
|
<li> |
452 |
< |
<a href="sg_get_process_stats.html">sg_get_process_stats(3)</a> |
452 |
> |
<a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a> |
453 |
|
</li> |
454 |
|
<li> |
455 |
< |
<a href="sg_get_user_stats.html">sg_get_user_stats(3)</a> |
455 |
> |
<a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a> |
456 |
|
</li> |
457 |
|
</ul> |
458 |
|
<h2> |