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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines