# | Line 16 | Line 16 | |
---|---|---|
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> | |
# | Line 41 | Line 41 | |
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> | |
# | Line 50 | Line 81 | |
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> | |
# | Line 136 | Line 293 | |
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> | |
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> |
299 | <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> |
300 | <a id="download">Downloading</a> | |
301 | </h2> | |
302 | <p> | |
# | Line 251 | Line 317 | |
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> | |
# | Line 272 | Line 341 | |
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=statgrab">Gentoo Linux</a> |
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://ftp.i-scream.org/pub/i-scream/packages/debian/">Debian (unofficial)</a> |
350 | > | <a href="http://www.sunfreeware.com/">Solaris (SunFreeware)</a> |
351 | </li> | |
352 | <li> | |
353 | + | <a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a> |
354 | + | </li> |
355 | + | <li> |
356 | <a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a> | |
357 | </li> | |
358 | + | <li> |
359 | + | <a href="http://software.opensuse.org/download/home:/anagappan/">RPMs for various Linux distributions</a> |
360 | + | </li> |
361 | + | <li> |
362 | + | <a href="http://www.openbsd.org/cgi-bin/cvsweb/ports/sysutils/libstatgrab/">OpenBSD</a> |
363 | + | </li> |
364 | </ul> | |
365 | <p> | |
366 | These are various pre-packaged versions of libstatgrab | |
# | Line 293 | Line 371 | |
371 | We've noticed that google throws up some RPM's relating | |
372 | to Mandrake and Suse, but no webpage for them. | |
373 | </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</a>. |
302 | – | </p> |
374 | <h2> | |
375 | <a id="development">Development</a> | |
376 | </h2> | |
# | Line 319 | Line 390 | |
390 | </h2> | |
391 | <p> | |
392 | The only online documentation we have at the moment is the | |
393 | < | manual pages converted in to HTML format. It's probably |
394 | < | best to start with the overview manual page: |
393 | > | manual pages converted in to HTML format. First are the |
394 | > | manual pages for the command line tools: |
395 | </p> | |
396 | <ul> | |
397 | <li> | |
398 | < | <a href="statgrab.html">statgrab(3)</a> |
398 | > | <a href="docs/saidar.1.html">saidar(1)</a> |
399 | </li> | |
400 | + | <li> |
401 | + | <a href="docs/statgrab.1.html">statgrab(1)</a> |
402 | + | </li> |
403 | + | <li> |
404 | + | <a href="docs/statgrab-make-mrtg-config.1.html">statgrab-make-mrtg-config(1)</a> |
405 | + | </li> |
406 | + | <li> |
407 | + | <a href="docs/statgrab-make-mrtg-index.1.html">statgrab-make-mrtg-index(1)</a> |
408 | + | </li> |
409 | </ul> | |
410 | <p> | |
411 | + | We also have an overview page for the library: |
412 | + | </p> |
413 | + | <ul> |
414 | + | <li> |
415 | + | <a href="docs/statgrab.3.html">statgrab(3)</a> |
416 | + | </li> |
417 | + | </ul> |
418 | + | <p> |
419 | Then we have the manual pages for each function: | |
420 | </p> | |
421 | <ul> | |
422 | <li> | |
423 | < | <a href="sg_get_cpu_stats.html">sg_get_cpu_stats(3)</a> |
423 | > | <a href="docs/sg_get_cpu_stats.3.html">sg_get_cpu_stats(3)</a> |
424 | </li> | |
425 | <li> | |
426 | < | <a href="sg_get_disk_io_stats.html">sg_get_disk_io_stats(3)</a> |
426 | > | <a href="docs/sg_get_disk_io_stats.3.html">sg_get_disk_io_stats(3)</a> |
427 | </li> | |
428 | <li> | |
429 | < | <a href="sg_get_fs_stats.html">sg_get_fs_stats(3)</a> |
429 | > | <a href="docs/sg_get_fs_stats.3.html">sg_get_fs_stats(3)</a> |
430 | </li> | |
431 | <li> | |
432 | < | <a href="sg_get_host_info.html">sg_get_host_info(3)</a> |
432 | > | <a href="docs/sg_get_host_info.3.html">sg_get_host_info(3)</a> |
433 | </li> | |
434 | <li> | |
435 | < | <a href="sg_get_load_stats.html">sg_get_load_stats(3)</a> |
435 | > | <a href="docs/sg_get_load_stats.3.html">sg_get_load_stats(3)</a> |
436 | </li> | |
437 | <li> | |
438 | < | <a href="sg_get_mem_stats.html">sg_get_mem_stats(3)</a> |
438 | > | <a href="docs/sg_get_mem_stats.3.html">sg_get_mem_stats(3)</a> |
439 | </li> | |
440 | <li> | |
441 | < | <a href="sg_get_network_iface_stats.html">sg_get_network_iface_stats(3)</a> |
441 | > | <a href="docs/sg_get_network_iface_stats.3.html">sg_get_network_iface_stats(3)</a> |
442 | </li> | |
443 | <li> | |
444 | < | <a href="sg_get_network_io_stats.html">sg_get_network_io_stats(3)</a> |
444 | > | <a href="docs/sg_get_network_io_stats.3.html">sg_get_network_io_stats(3)</a> |
445 | </li> | |
446 | <li> | |
447 | < | <a href="sg_get_page_stats.html">sg_get_page_stats(3)</a> |
447 | > | <a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a> |
448 | </li> | |
449 | <li> | |
450 | < | <a href="sg_get_process_stats.html">sg_get_process_stats(3)</a> |
450 | > | <a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a> |
451 | </li> | |
452 | <li> | |
453 | < | <a href="sg_get_user_stats.html">sg_get_user_stats(3)</a> |
453 | > | <a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a> |
454 | </li> | |
455 | </ul> | |
456 | <h2> |
– | Removed lines |
+ | Added lines |
< | Changed lines |
> | Changed lines |