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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines