ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/web/www/libstatgrab/index.xhtml
(Generate patch)

Comparing web/www/libstatgrab/index.xhtml (file contents):
Revision 1.24 by tdb, Wed May 19 18:58:18 2004 UTC vs.
Revision 1.43 by tdb, Mon Mar 20 10:52:06 2006 UTC

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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines