# | 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 42 | Line 42 | |
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> | |
# | Line 50 | Line 80 | |
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> | |
# | Line 136 | Line 292 | |
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> | |
# | Line 251 | Line 316 | |
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> | |
# | Line 269 | Line 337 | |
337 | </h2> | |
338 | <ul> | |
339 | <li> | |
340 | < | <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&stype=all">FreeBSD</a> |
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 | |
# | Line 293 | Line 373 | |
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> | |
# | Line 319 | Line 392 | |
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> |
– | Removed lines |
+ | Added lines |
< | Changed lines |
> | Changed lines |