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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines