# | 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> | |
26 | </li> | |
27 | <li> | |
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> |
37 | <a href="#documentation">Documentation</a> | |
38 | </li> | |
39 | <li> | |
# | Line 32 | 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 41 | Line 81 | |
81 | <a href="http://freshmeat.net/projects/libstatgrab/">freshmeat</a>? | |
82 | </p> | |
83 | <h3> | |
84 | < | Sunday 21 March 2004 |
84 | > | Sunday 31 July 2005 |
85 | </h3> | |
86 | <p> | |
87 | < | pystatgrab, a new package containing a set of Python |
88 | < | bindings, has been released. Check out it's |
49 | < | <a href="/pystatgrab/">project page</a>. |
87 | > | Version 0.12 of libstatgrab has been released.<br /> |
88 | > | Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
89 | </p> | |
51 | – | <h3> |
52 | – | Wednesday 10 March 2004 |
53 | – | </h3> |
90 | <p> | |
91 | < | Version 0.9 of libstatgrab has been released.<br /> |
92 | < | Download it |
93 | < | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.9.tar.gz"> |
94 | < | here</a>. |
91 | > | This release has some new features, bug fixes, and a minor |
92 | > | API change. More details have been added to the file |
93 | > | system statistics, linux partition detection has been |
94 | > | reworked, and compile errors on Linux 2.6 have been fixed. |
95 | > | Support has been added for Solaris 10 and FreeBSD 7. |
96 | > | There are also manual pages for all the tools. |
97 | </p> | |
98 | <p> | |
99 | < | This release brings new features and new platforms. We've |
100 | < | added information about network interfaces (duplex, speed, |
101 | < | etc) along with further statistics such as i/o packets, i/o |
102 | < | errors, and collisions. Support has also been added for |
103 | < | OpenBSD and DragonFly BSD. Finally some work has been done |
66 | < | to reduce the platforms on which libstatgrab needs elevated |
67 | < | privileges. See the NEWS file for more information. |
99 | > | The duplex value in the network interface statistics has |
100 | > | changed name from "dup" to "duplex" - this breaks the API. |
101 | > | We plan to stabilise the API for a 1.0 release. As before, |
102 | > | the old name is available if SG_ENABLE_DEPRECATED is |
103 | > | defined. |
104 | </p> | |
105 | <h3> | |
106 | < | Wednesday 11 February 2004 |
106 | > | Tuesday 26 April 2005 |
107 | </h3> | |
108 | <p> | |
109 | < | Version 0.8.2 of libstatgrab has been released.<br /> |
110 | < | Download it |
75 | < | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.2.tar.gz"> |
76 | < | here</a>. |
109 | > | Official libstatgrab packages for Debian now |
110 | > | <a href="http://packages.debian.org/unstable/source/libstatgrab">available</a>. |
111 | </p> | |
112 | <p> | |
113 | < | The main focus of this release is adding support for |
114 | < | Solaris 6. We've also added Python bindings so you can use |
115 | < | libstatgrab directly from Python (see the extras |
116 | < | directory). Finally, we've tidied up a few bits of the |
117 | < | code. |
113 | > | Thanks to the work of |
114 | > | <a href="mailto:fenio@debian.org">Bartosz Fenski</a> |
115 | > | libstatgrab is now available on debian. This replaces our |
116 | > | unofficial debian packages which will no longer be |
117 | > | updated. |
118 | </p> | |
119 | <h3> | |
120 | < | Wednesday 21 January 2004 |
120 | > | Thursday 3 March 2005 |
121 | </h3> | |
122 | <p> | |
123 | < | Version 0.8.1 of libstatgrab has been released.<br /> |
124 | < | Download it |
91 | < | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.1.tar.gz"> |
92 | < | here</a>. |
123 | > | Version 0.11.1 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 primarily fixes bugs. On Linux a file |
128 | < | descriptor leak was fixed. On Solaris some significant |
129 | < | speed increases were made to the disk mapping code, along |
130 | < | with some bug fixes for Solaris 7 platforms. Also, the |
131 | < | library part of libstatgrab (but not the tools) is now |
100 | < | released under the LGPL instead of the GPL. |
127 | > | This release fixes a handful of minor bugs. Duplex |
128 | > | settings were reported incorrectly on linux (half and |
129 | > | full duplex were swapped), saidar displayed negative |
130 | > | filesystem stats incorrectly, and NFS filesystems were |
131 | > | ignored. These have all been fixed. |
132 | </p> | |
133 | <h3> | |
134 | < | Tuesday 6 January 2004 |
134 | > | Friday 12 November 2004 |
135 | </h3> | |
136 | <p> | |
137 | < | Version 0.8 of libstatgrab has been released.<br /> |
138 | < | Download it |
108 | < | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.8.tar.gz"> |
109 | < | here</a>. |
137 | > | Version 0.11 of libstatgrab has been released.<br /> |
138 | > | Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
139 | </p> | |
140 | <p> | |
141 | < | This release brings support for Linux 2.6 and partial |
142 | < | support for Cygwin. On Solaris libstatgrab now returns disk |
114 | < | names using cNtNdNsN names rather than the older sdN names. |
115 | < | There are also a bunch of fixes and optimisations in |
116 | < | various places. Finally, a new function has been added to |
117 | < | make it quicker to drop any elevated privileges libstatgrab |
118 | < | may require on some operating systems. |
141 | > | This release brings support for HP-UX (version 11.11), and |
142 | > | also fixes a few other minor issues. |
143 | </p> | |
144 | <h3> | |
145 | < | Wednesday 22 October 2003 |
145 | > | Wednesday 25 August 2004 |
146 | </h3> | |
147 | <p> | |
148 | < | Version 0.7 of libstatgrab has been released.<br /> |
149 | < | Download it |
126 | < | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.7.tar.gz"> |
127 | < | here</a>. |
148 | > | Version 0.10.3 of libstatgrab has been released.<br /> |
149 | > | Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
150 | </p> | |
151 | <p> | |
152 | < | The most significant change in this release is support for |
153 | < | NetBSD 1.6.x. Parts of the FreeBSD code have been |
154 | < | optimised, and an initialise function has been added to |
133 | < | allow programs to drop any extra privileges libstatgrab |
134 | < | needs. The list of known file systems has been increased, |
135 | < | and libstatgrab has been tested on even more platforms. |
136 | < | Finally, saidar has been tweaked to work even if it can't |
137 | < | get all the statistics. |
152 | > | This release adds a handful of new features to statgrab, and |
153 | > | adds support for FreeBSD 6.0-CURRENT. See the NEWS file in |
154 | > | the tarball for more details. |
155 | </p> | |
156 | <h3> | |
157 | < | Saturday 18 October 2003 |
157 | > | Tuesday 27 July 2004 |
158 | </h3> | |
159 | <p> | |
160 | < | Version 0.6.1 of libstatgrab has been released.<br /> |
161 | < | Download it |
145 | < | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.1.tar.gz"> |
146 | < | here</a>. |
160 | > | Version 0.10.2 of libstatgrab has been released.<br /> |
161 | > | Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
162 | </p> | |
163 | <p> | |
164 | < | This release brings support for FreeBSD 5 on sparc 64, and |
165 | < | some bugfixes in FreeBSD memory statistics. Also, some |
151 | < | fixes to saidar, and statgrab. |
164 | > | This release fixes a problem with the shared library |
165 | > | version number in the last release. |
166 | </p> | |
167 | <h3> | |
168 | < | Friday 10 October 2003 |
168 | > | Monday 26 July 2004 |
169 | </h3> | |
170 | <p> | |
171 | < | Version 0.6 of libstatgrab has been released.<br /> |
172 | < | You can download it from our mirror site |
159 | < | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.6.tar.gz"> |
160 | < | here</a>. |
171 | > | Version 0.10.1 of libstatgrab has been released.<br /> |
172 | > | Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
173 | </p> | |
174 | <p> | |
175 | < | This release includes some exciting new tools, support for |
176 | < | FreeBSD 5.1, and documentation in manpages. Plus some major |
177 | < | bugfixes and packaging enhancements. |
175 | > | This release consists almost entirely of bugfixes. |
176 | > | We've fixed compile-time errors for recent OpenBSD and |
177 | > | NetBSD platforms, and also a minor bug in statgrab |
178 | > | that broke network statistics on Solaris. New |
179 | > | variables have been added to the pkg-config file to |
180 | > | suggest ownership and permissions of binaries, and |
181 | > | we've added error reporting functions that store errno |
182 | > | values. There's also other minor fixes detailed in the |
183 | > | NEWS file. |
184 | </p> | |
185 | <h3> | |
186 | < | Tuesday 09 September 2003 |
186 | > | Thursday 20 May 2004 |
187 | </h3> | |
188 | <p> | |
189 | < | We're pleased to announce a new release of |
190 | < | libstatgrab.<br /> |
173 | < | You can download version 0.5.1 from |
174 | < | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.1.tar.gz"> |
175 | < | here</a>. |
189 | > | Version 0.10 of libstatgrab has been released.<br /> |
190 | > | Download it from one of our <a href="/mirrors.xhtml">mirrors</a>. |
191 | </p> | |
177 | – | <h3> |
178 | – | Monday 25 August 2003 |
179 | – | </h3> |
192 | <p> | |
193 | < | We're pleased to announce a new release of |
194 | < | libstatgrab.<br /> |
195 | < | You can download version 0.5 from |
196 | < | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/libstatgrab-0.5.tar.gz"> |
197 | < | here</a>. |
193 | > | This release concentrates heavily on standardising the names |
194 | > | of functions and structures throughout libstatgrab. Although |
195 | > | this will mean changes for existing programs, in the long run |
196 | > | we hope it'll make things both clearer and easier. However, |
197 | > | for those who still need the old functions we have provided |
198 | > | compatibility wrappers. See the NEWS file for details. |
199 | </p> | |
200 | <p> | |
201 | < | This release provides both documentation and examples, |
202 | < | which we hope will make the package more useable. Stay |
203 | < | tuned for the next release with some useful tools. |
201 | > | The other main change in this release is a new function to |
202 | > | provide full details on currently running processes. See the |
203 | > | documentation for sg_get_process_stats for details. Along with |
204 | > | this there are compare functions for use with qsort for sorting |
205 | > | process, network, and disk io statistics. We've also introduced |
206 | > | error reporting functions that allow calling applications to |
207 | > | see why libstatgrab has returned a failure. See sg_get_error. |
208 | </p> | |
192 | – | <h2> |
193 | – | <a id="what">What is libstatgrab?</a> |
194 | – | </h2> |
209 | <p> | |
210 | < | libstatgrab is a library that provides cross platform |
211 | < | access to statistics about the system on which it's run. |
212 | < | It's written in C and presents a selection of useful |
213 | < | interfaces which can be used to access key system |
200 | < | statistics. The current list of statistics includes CPU |
201 | < | usage, memory utilisation, disk usage, process counts, |
202 | < | network traffic, disk I/O, and more. |
210 | > | Finally, we've added support for NetBSD 2.0 and tidied up lots |
211 | > | of areas of the code. This release does not include the python |
212 | > | bindings - they're now available as their own project called |
213 | > | <a href="/pystatgrab/">pystatgrab</a>. |
214 | </p> | |
215 | + | <h3> |
216 | + | Sunday 21 March 2004 |
217 | + | </h3> |
218 | <p> | |
219 | < | The current list of platforms is Solaris 2.x, Linux |
220 | < | 2.2/2.4/2.6, FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x, |
221 | < | DragonFly BSD 1.0, and Cygwin. The aim is to extend this to |
208 | < | include as many operating systems as possible. |
219 | > | pystatgrab, a new package containing a set of Python |
220 | > | bindings, has been released. Check out it's |
221 | > | <a href="/pystatgrab/">project page</a>. |
222 | </p> | |
210 | – | <p> |
211 | – | The package also includes a couple of useful tools. The |
212 | – | first, <a href="#screenshot">saidar</a>, provides a |
213 | – | curses-based interface to viewing the current state of the |
214 | – | system. The second, statgrab, gives a sysctl-style |
215 | – | interface to the statistics gathered by libstatgrab. This |
216 | – | extends the use of libstatgrab to people writing scripts or |
217 | – | anything else that can't easily make C function calls. |
218 | – | Included with statgrab is a script to generate an |
219 | – | <a href="http://www.mrtg.org">MRTG</a> configuration file |
220 | – | to use statgrab. |
221 | – | </p> |
223 | <h2> | |
224 | <a id="download">Downloading</a> | |
225 | </h2> | |
226 | <p> | |
227 | The latest version of libstatgrab can be downloaded from | |
228 | < | our primary download |
229 | < | <a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/libstatgrab/"> |
229 | < | mirror</a>. All downloads are pgp signed using our |
228 | > | our <a href="/mirrors.xhtml">mirror sites</a>. |
229 | > | All downloads are pgp signed using our |
230 | <a href="/pgpkey.xhtml">PGP Key</a>. | |
231 | </p> | |
232 | <p> | |
233 | For installation instructions see the README and INSTALL | |
234 | < | files contained within the archive. If you're using |
235 | < | <a href="http://www.freebsd.org">FreeBSD</a> you can make |
236 | < | use of the |
237 | < | <a href="http://www.freshports.org/devel/libstatgrab"> |
238 | < | devel/libstatgrab</a> port to install libstatgrab for you. |
234 | > | files contained within the archive. |
235 | </p> | |
236 | <h2> | |
237 | + | <a id="bindings">Language Bindings</a> |
238 | + | </h2> |
239 | + | <ul> |
240 | + | <li> |
241 | + | <a href="/pystatgrab/">Python</a> |
242 | + | </li> |
243 | + | <li> |
244 | + | <a href="http://pecl.php.net/statgrab/">PHP (external)</a> |
245 | + | </li> |
246 | + | <li> |
247 | + | <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl (external)</a> |
248 | + | </li> |
249 | + | </ul> |
250 | + | <p> |
251 | + | Here are links to bindings for higher level languages |
252 | + | that provide access to libstatgrab. If you've written |
253 | + | a binding for another language, please get |
254 | + | <a href="mailto:support@i-scream.org">in touch</a> so we |
255 | + | can add a link here. |
256 | + | </p> |
257 | + | <h2> |
258 | + | <a id="packages">Packages of libstatgrab</a> |
259 | + | </h2> |
260 | + | <ul> |
261 | + | <li> |
262 | + | <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&stype=all">FreeBSD</a> |
263 | + | </li> |
264 | + | <li> |
265 | + | <a href="http://packages.gentoo.org/search/?sstring=statgrab">Gentoo Linux</a> |
266 | + | </li> |
267 | + | <li> |
268 | + | <a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a> |
269 | + | </li> |
270 | + | <li> |
271 | + | <a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a> |
272 | + | </li> |
273 | + | <li> |
274 | + | <a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a> |
275 | + | </li> |
276 | + | </ul> |
277 | + | <p> |
278 | + | These are various pre-packaged versions of libstatgrab |
279 | + | that you can get for your favourite operating system. If |
280 | + | we've missed any out, please let us know. |
281 | + | </p> |
282 | + | <p> |
283 | + | We've noticed that google throws up some RPM's relating |
284 | + | to Mandrake and Suse, but no webpage for them. |
285 | + | </p> |
286 | + | <p> |
287 | + | Several attempts were made to submit a port to the |
288 | + | OpenBSD folk, but they didn't seem interested in taking |
289 | + | it. You can find it |
290 | + | <a href="http://ftp.i-scream.org/pub/i-scream/tmp/libstatgrab-0.11-openbsd-port.tar.gz"> |
291 | + | here</a>. |
292 | + | </p> |
293 | + | <h2> |
294 | + | <a id="development">Development</a> |
295 | + | </h2> |
296 | + | <ul> |
297 | + | <li> |
298 | + | <a href="/cgi-bin/cvslog.cgi?period=thisweek&module=projects/libstatgrab">Commits this week</a> |
299 | + | </li> |
300 | + | </ul> |
301 | + | <p> |
302 | + | We develop libstatgrab using the CVS revision control system. |
303 | + | Using this link you can see what changes we've made this week. |
304 | + | For more information on our CVS setup see our |
305 | + | <a href="/cvs.xhtml">CVS page</a>. |
306 | + | </p> |
307 | + | <h2> |
308 | <a id="documentation">Documentation</a> | |
309 | </h2> | |
310 | <p> | |
# | Line 255 | Line 322 | |
322 | </p> | |
323 | <ul> | |
324 | <li> | |
325 | < | <a href="cpu_percent_usage.html">cpu_percent_usage(3)</a> |
325 | > | <a href="sg_get_cpu_stats.html">sg_get_cpu_stats(3)</a> |
326 | </li> | |
327 | <li> | |
328 | < | <a href="get_diskio_stats.html">get_diskio_stats(3)</a> |
328 | > | <a href="sg_get_disk_io_stats.html">sg_get_disk_io_stats(3)</a> |
329 | </li> | |
330 | <li> | |
331 | < | <a href="get_general_stats.html">get_general_stats(3)</a> |
331 | > | <a href="sg_get_fs_stats.html">sg_get_fs_stats(3)</a> |
332 | </li> | |
333 | <li> | |
334 | < | <a href="get_load_stats.html">get_load_stats(3)</a> |
334 | > | <a href="sg_get_host_info.html">sg_get_host_info(3)</a> |
335 | </li> | |
336 | <li> | |
337 | < | <a href="get_memory_stats.html">get_memory_stats(3)</a> |
337 | > | <a href="sg_get_load_stats.html">sg_get_load_stats(3)</a> |
338 | </li> | |
339 | <li> | |
340 | < | <a href="get_network_iface_stats.html">get_network_iface_stats(3)</a> |
340 | > | <a href="sg_get_mem_stats.html">sg_get_mem_stats(3)</a> |
341 | </li> | |
342 | <li> | |
343 | < | <a href="get_network_stats.html">get_network_stats(3)</a> |
343 | > | <a href="sg_get_network_iface_stats.html">sg_get_network_iface_stats(3)</a> |
344 | </li> | |
345 | <li> | |
346 | < | <a href="get_page_stats.html">get_page_stats(3)</a> |
346 | > | <a href="sg_get_network_io_stats.html">sg_get_network_io_stats(3)</a> |
347 | </li> | |
348 | <li> | |
349 | < | <a href="get_process_stats.html">get_process_stats(3)</a> |
349 | > | <a href="sg_get_page_stats.html">sg_get_page_stats(3)</a> |
350 | </li> | |
351 | <li> | |
352 | < | <a href="get_user_stats.html">get_user_stats(3)</a> |
352 | > | <a href="sg_get_process_stats.html">sg_get_process_stats(3)</a> |
353 | > | </li> |
354 | > | <li> |
355 | > | <a href="sg_get_user_stats.html">sg_get_user_stats(3)</a> |
356 | </li> | |
357 | </ul> | |
358 | <h2> |
– | Removed lines |
+ | Added lines |
< | Changed lines |
> | Changed lines |