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.31 by tdb, Fri Nov 12 11:55:35 2004 UTC vs.
Revision 1.61 by tdb, Mon Jul 14 16:00:44 2014 UTC

# Line 1 | Line 1
1   <!--#include virtual="/doctype.inc" -->
2    <head>
3      <title>
4 <      i-scream libstatgrab homepage
4 >      libstatgrab homepage
5      </title>
6   <!--#include virtual="/style.inc" -->
7    </head>
# Line 11 | Line 11
11   <!--#include virtual="/header.inc" -->
12          <div id="contents">
13            <h1 class="top">
14 <            i-scream libstatgrab homepage
14 >            libstatgrab homepage
15            </h1>
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 39 | Line 42
42              </ul>
43            </div>
44            <h2>
45 +            <a id="what">What is libstatgrab?</a>
46 +          </h2>
47 +          <p>
48 +            libstatgrab is a library that provides cross platform
49 +            access to statistics about the system on which it's run.
50 +            It's written in C and presents a selection of useful
51 +            interfaces which can be used to access key system
52 +            statistics. The current list of statistics includes CPU
53 +            usage, memory utilisation, disk usage, process counts,
54 +            network traffic, disk I/O, and more.
55 +          </p>
56 +          <p>
57 +            The current list of supported and tested platforms
58 +            includes FreeBSD, Linux, NetBSD, OpenBSD, Solaris,
59 +            DragonFly BSD, HP-UX and AIX. We are always happy to
60 +            accept patches to extend support to other operating
61 +            systems.
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 +          <h3>
79 +            Friday 11 July 2014
80 +          </h3>
81            <p>
82 <            To get notifications of new libstatgrab releases why not
83 <            subscribe to our project over on
47 <            <a href="http://freshmeat.net/projects/libstatgrab/">freshmeat</a>?
82 >            Version 0.91 of libstatgrab has been released.<br />
83 >            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
84            </p>
85 +          <p>
86 +            This release includes a number of bugfixes and new
87 +            features but is API compatible with 0.90.
88 +          </p>
89 +          <ul>
90 +            <li>Use /proc/mounts on Linux where available.</li>
91 +            <li>Add a new field named device_canonical to the filesystem
92 +                statistics.</li>
93 +            <li>Fix list miscounting in sg_set_valid_filesystems.</li>
94 +            <li>Fix buffer overrun when dealing with a larger number of
95 +                processes.</li>
96 +            <li>Fix divide by zero display problem in saidar.</li>
97 +            <li>When logging with log4cplus is enabled, properties files
98 +                are installed in to ${prefix}/etc.</li>
99 +            <li>Add Graphite output support in statgrab.</li>
100 +          </ul>
101 +          <p>
102 +            A full list of changes can be found in the
103 +            <a href="http://git.i-scream.org/?p=libstatgrab.git;a=blob;f=NEWS;h=3fbe52269637c4e68aab0d70b0419343889a4d4f;hb=d8d6c819ee007eb03bc95a48a614bcefec229b42">NEWS</a>
104 +            file contained within the release.
105 +          </p>
106 +          <p>
107 +            If you find any bugs in the release please report them
108 +            over at our
109 +            <a href="https://github.com/i-scream/libstatgrab/issues">Issue
110 +            Tracker</a> on GitHub.
111 +          </p>
112            <h3>
113 +            Thursday 8 August 2013
114 +          </h3>
115 +          <p>
116 +            Version 0.90 of libstatgrab has been released.<br />
117 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
118 +            Please note this and future releases are signed with a new
119 +            <a href="/pgpkey.xhtml">PGP key</a>.
120 +          </p>
121 +          <p>
122 +            Please note that the API in 0.90 has changed, so
123 +            applications using libstatgrab will need to be updated to
124 +            support the changes.
125 +          </p>
126 +          <p>
127 +            There are a large number of changes in this version of
128 +            libstatgrab. Here is an overview:
129 +          </p>
130 +          <ul>
131 +            <li>Thread safety and reentrant functions.</li>
132 +            <li>API unification (every stats call is now able to
133 +                return multiple entries).</li>
134 +            <li>Complete rewrite of internal memory management (eases
135 +                future extensions).</li>
136 +            <li>Add experimental support for tracing using log4cplus.</li>
137 +            <li>Complete the ports for AIX, HP-UX and most of the
138 +                widely used BSD-based operating systems.</li>
139 +            <li>Complete the port for Darwin/MacOS X including basic
140 +                Mach.</li>
141 +            <li>Clean up the FreeBSD and Solaris implementations.</li>
142 +            <li>Clean up the FreeBSD and Solaris implementations.</li>
143 +          </ul>
144 +          <p>
145 +            This release is the result of a significant amount of work
146 +            by the newest member of the libstatgrab team - Jens
147 +            Rehsack. Welcome to the team Jens!
148 +          </p>
149 +          <p>
150 +            If you find any bugs in the release please report them
151 +            over at our
152 +            <a href="https://github.com/i-scream/libstatgrab/issues">Issue
153 +            Tracker</a> on GitHub.
154 +          </p>
155 +          <h3>
156 +            Sunday 21 February 2010
157 +          </h3>
158 +          <p>
159 +            Version 0.17 of libstatgrab has been released.<br />
160 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
161 +          </p>
162 +          <p>
163 +            This release adds support for FreeBSD 9 and other systems
164 +            using utmpx. Also on FreeBSD it fixes an issue with large
165 +            quantities of memory and adds support for dynamically
166 +            getting a list of supported file systems. On Solaris ZFS
167 +            file systems will now be detected. And finally on Linux CPU
168 +            iowait information will be given where available.
169 +          </p>
170 +          <h3>
171 +            Friday 30 May 2008
172 +          </h3>
173 +          <p>
174 +            Dag Odenhall got in touch today to let us know he's written
175 +            <a href="http://statgrab.rubyforge.org/">Ruby bindings</a>
176 +            for libstatgrab. Thanks Dag!
177 +          </p>
178 +          <h3>
179 +            Monday 17 March 2008
180 +          </h3>
181 +          <p>
182 +            Version 0.16 of libstatgrab has been released.<br />
183 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
184 +          </p>
185 +          <p>
186 +            This release fixes some minor build problems on Solaris
187 +            with Sun's compiler, and on the Debian "armel" port. Also
188 +            a minor fix to statgrab-make-mrtg-config on machines with
189 +            no swap, and added support for FreeBSD 8.
190 +          </p>
191 +          <h3>
192 +            Saturday 14 July 2007
193 +          </h3>
194 +          <p>
195 +            Version 0.15 of libstatgrab has been released.<br />
196 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
197 +          </p>
198 +          <p>
199 +            This release fixes a regression introduced on OpenBSD in
200 +            the last release - memory statistics were reported
201 +            incorrectly. Some other minor changes have been made, see
202 +            the NEWS file for more information.
203 +          </p>
204 +          <h3>
205 +            Monday 8 January 2007
206 +          </h3>
207 +          <p>
208 +            Version 0.14 of libstatgrab has been released.<br />
209 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
210 +          </p>
211 +          <p>
212 +            This release contains mainly bugfixes - see the NEWS file
213 +            in the distribution for a full list. It also brings a new
214 +            feature in saidar: colour support, which can be activated
215 +            with the -c runtime flag.
216 +          </p>
217 +          <h3>
218 +            Monday 20 March 2006
219 +          </h3>
220 +          <p>
221 +            Version 0.13 of libstatgrab has been released.<br />
222 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
223 +          </p>
224 +          <p>
225 +            This release mainly includes a bunch of bug fixes, but
226 +            also brings preliminary support for WIN32. We've also
227 +            added a few lines to the header file to make C++ linking
228 +            easier. Please see the NEWS file in the distribution for
229 +            full details.
230 +          </p>
231 +          <h3>
232 +            Sunday 31 July 2005
233 +          </h3>
234 +          <p>
235 +            Version 0.12 of libstatgrab has been released.<br />
236 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
237 +          </p>
238 +          <p>
239 +            This release has some new features, bug fixes, and a minor
240 +            API change. More details have been added to the file
241 +            system statistics, linux partition detection has been
242 +            reworked, and compile errors on Linux 2.6 have been fixed.
243 +            Support has been added for Solaris 10 and FreeBSD 7.
244 +            There are also manual pages for all the tools.
245 +          </p>
246 +          <p>
247 +            The duplex value in the network interface statistics has
248 +            changed name from "dup" to "duplex" - this breaks the API.
249 +            We plan to stabilise the API for a 1.0 release. As before,
250 +            the old name is available if SG_ENABLE_DEPRECATED is
251 +            defined.
252 +          </p>
253 +          <h3>
254 +            Tuesday 26 April 2005
255 +          </h3>
256 +          <p>
257 +            Official libstatgrab packages for Debian now
258 +            <a href="http://packages.debian.org/unstable/source/libstatgrab">available</a>.
259 +          </p>
260 +          <p>
261 +            Thanks to the work of
262 +            <a href="mailto:fenio@debian.org">Bartosz Fenski</a>
263 +            libstatgrab is now available on debian. This replaces our
264 +            unofficial debian packages which will no longer be
265 +            updated.
266 +          </p>
267 +          <h3>
268 +            Thursday 3 March 2005
269 +          </h3>
270 +          <p>
271 +            Version 0.11.1 of libstatgrab has been released.<br />
272 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
273 +          </p>
274 +          <p>
275 +            This release fixes a handful of minor bugs. Duplex
276 +            settings were reported incorrectly on linux (half and
277 +            full duplex were swapped), saidar displayed negative
278 +            filesystem stats incorrectly, and NFS filesystems were
279 +            ignored. These have all been fixed.
280 +          </p>
281 +          <h3>
282              Friday 12 November 2004
283            </h3>
284            <p>
# Line 133 | Line 365
365            </h3>
366            <p>
367              pystatgrab, a new package containing a set of Python
368 <            bindings, has been released. Check out it's
368 >            bindings, has been released. Check out its
369              <a href="/pystatgrab/">project page</a>.
370            </p>
139          <h3>
140            Wednesday 10 March 2004
141          </h3>
142          <p>
143            Version 0.9 of libstatgrab has been released.<br />
144            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
145          </p>
146          <p>
147            This release brings new features and new platforms. We've
148            added information about network interfaces (duplex, speed,
149            etc) along with further statistics such as i/o packets, i/o
150            errors, and collisions. Support has also been added for
151            OpenBSD and DragonFly BSD. Finally some work has been done
152            to reduce the platforms on which libstatgrab needs elevated
153            privileges. See the NEWS file for more information.
154          </p>
155          <h3>
156            Wednesday 11 February 2004
157          </h3>
158          <p>
159            Version 0.8.2 of libstatgrab has been released.<br />
160            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
161          </p>
162          <p>
163            The main focus of this release is adding support for
164            Solaris 6. We've also added Python bindings so you can use
165            libstatgrab directly from Python (see the extras
166            directory). Finally, we've tidied up a few bits of the
167            code.
168          </p>
169          <h3>
170            Wednesday 21 January 2004
171          </h3>
172          <p>
173            Version 0.8.1 of libstatgrab has been released.<br />
174            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
175          </p>
176          <p>
177            This release primarily fixes bugs. On Linux a file
178            descriptor leak was fixed. On Solaris some significant
179            speed increases were made to the disk mapping code, along
180            with some bug fixes for Solaris 7 platforms. Also, the
181            library part of libstatgrab (but not the tools) is now
182            released under the LGPL instead of the GPL.
183          </p>
184          <h3>
185            Tuesday 6 January 2004
186          </h3>
187          <p>
188            Version 0.8 of libstatgrab has been released.<br />
189            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
190          </p>
191          <p>
192            This release brings support for Linux 2.6 and partial
193            support for Cygwin. On Solaris libstatgrab now returns disk
194            names using cNtNdNsN names rather than the older sdN names.
195            There are also a bunch of fixes and optimisations in
196            various places. Finally, a new function has been added to
197            make it quicker to drop any elevated privileges libstatgrab
198            may require on some operating systems.
199          </p>
371            <h2>
201            <a id="what">What is libstatgrab?</a>
202          </h2>
203          <p>
204            libstatgrab is a library that provides cross platform
205            access to statistics about the system on which it's run.
206            It's written in C and presents a selection of useful
207            interfaces which can be used to access key system
208            statistics. The current list of statistics includes CPU
209            usage, memory utilisation, disk usage, process counts,
210            network traffic, disk I/O, and more.
211          </p>
212          <p>
213            The current list of platforms is Solaris 2.x, Linux
214            2.2/2.4/2.6, FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x,
215            DragonFly BSD 1.0, and Cygwin. The aim is to extend this to
216            include as many operating systems as possible.
217          </p>
218          <p>
219            The package also includes a couple of useful tools. The
220            first, <a href="#screenshot">saidar</a>, provides a
221            curses-based interface to viewing the current state of the
222            system. The second, statgrab, gives a sysctl-style
223            interface to the statistics gathered by libstatgrab. This
224            extends the use of libstatgrab to people writing scripts or
225            anything else that can't easily make C function calls.
226            Included with statgrab is a script to generate an
227            <a href="http://www.mrtg.org">MRTG</a> configuration file
228            to use statgrab.
229          </p>
230          <h2>
372              <a id="download">Downloading</a>
373            </h2>
374            <p>
# Line 238 | Line 379
379            </p>
380            <p>
381              For installation instructions see the README and INSTALL
382 <            files contained within the archive. If you're using
242 <            <a href="http://www.freebsd.org">FreeBSD</a> you can make
243 <            use of the
244 <            <a href="http://www.freshports.org/devel/libstatgrab">
245 <            devel/libstatgrab</a> port to install libstatgrab for you.
382 >            files contained within the archive.
383            </p>
384            <h2>
385              <a id="bindings">Language Bindings</a>
# Line 252 | Line 389
389                <a href="/pystatgrab/">Python</a>
390              </li>
391              <li>
392 <              <a href="http://pecl.php.net/statgrab/">PHP (external)</a>
392 >              <a href="http://pecl.php.net/statgrab/">PHP</a>
393              </li>
394              <li>
395 <              <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl (external)</a>
395 >              <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl</a>
396              </li>
397 +            <li>
398 +              <a href="http://statgrab.rubyforge.org/">Ruby</a>
399 +            </li>
400            </ul>
401            <p>
402              Here are links to bindings for higher level languages
403              that provide access to libstatgrab. If you've written
404 <            a binding for another language, please get
265 <            <a href="mailto:dev@i-scream.org">in touch</a> so we
404 >            a binding for another language, please get in touch so we
405              can add a link here.
406            </p>
407            <h2>
408 <            <a id="development">Development</a>
408 >            <a id="packages">Packages of libstatgrab</a>
409            </h2>
410            <ul>
411              <li>
412 <              <a href="/cgi-bin/cvslog.cgi?period=thisweek&amp;module=projects/libstatgrab">Commits this week</a>
412 >              <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&amp;stype=all">FreeBSD</a>
413              </li>
414 +            <li>
415 +              <a href="http://packages.gentoo.org/search/?sstring=libstatgrab">Gentoo Linux</a>
416 +            </li>
417 +            <li>
418 +              <a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a>
419 +            </li>
420 +            <li>
421 +              <a href="http://www.sunfreeware.com/">Solaris (SunFreeware)</a>
422 +            </li>
423 +            <li>
424 +              <a href="http://www.opencsw.org/packages/libstatgrab/">Solaris (OpenCSW)</a>
425 +            </li>
426 +            <li>
427 +              <a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a>
428 +            </li>
429 +            <li>
430 +              <a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a>
431 +            </li>
432 +            <li>
433 +              <a href="http://software.opensuse.org/download/home:/anagappan/">RPMs for various Linux distributions</a>
434 +            </li>
435 +            <li>
436 +              <a href="http://www.openbsd.org/cgi-bin/cvsweb/ports/sysutils/libstatgrab/">OpenBSD</a>
437 +            </li>
438            </ul>
439            <p>
440 <            We develop libstatgrab using the CVS revision control system.
441 <            Using this link you can see what changes we've made this week.
442 <            For more information on our CVS setup see our
280 <            <a href="/cvs.xhtml">CVS page</a>.
440 >            These are various pre-packaged versions of libstatgrab
441 >            that you can get for your favourite operating system. If
442 >            we've missed any out, please let us know.
443            </p>
444 +          <p>
445 +            We've noticed that Google throws up some RPM's relating
446 +            to Mandrake and Suse, but no webpage for them.
447 +          </p>
448            <h2>
449              <a id="documentation">Documentation</a>
450            </h2>
451            <p>
452              The only online documentation we have at the moment is the
453 <            manual pages converted in to HTML format. It's probably
454 <            best to start with the overview manual page:
453 >            manual pages converted in to HTML format. First are the
454 >            manual pages for the command line tools:
455            </p>
456            <ul>
457              <li>
458 <              <a href="statgrab.html">statgrab(3)</a>
458 >              <a href="docs/saidar.1.html">saidar(1)</a>
459              </li>
460 +            <li>
461 +              <a href="docs/statgrab.1.html">statgrab(1)</a>
462 +            </li>
463 +            <li>
464 +              <a href="docs/statgrab-make-mrtg-config.1.html">statgrab-make-mrtg-config(1)</a>
465 +            </li>
466 +            <li>
467 +              <a href="docs/statgrab-make-mrtg-index.1.html">statgrab-make-mrtg-index(1)</a>
468 +            </li>
469            </ul>
470            <p>
471 +            We also have an overview page for the library:
472 +          </p>
473 +          <ul>
474 +            <li>
475 +              <a href="docs/statgrab.3.html">statgrab(3)</a>
476 +            </li>
477 +          </ul>
478 +          <p>
479              Then we have the manual pages for each function:
480            </p>
481            <ul>
482              <li>
483 <              <a href="sg_get_cpu_stats.html">sg_get_cpu_stats(3)</a>
483 >              <a href="docs/sg_comp_init.3.html">sg_comp_init(3)</a>
484              </li>
485              <li>
486 <              <a href="sg_get_disk_io_stats.html">sg_get_disk_io_stats(3)</a>
486 >              <a href="docs/sg_get_cpu_stats.3.html">sg_get_cpu_stats(3)</a>
487              </li>
488              <li>
489 <              <a href="sg_get_fs_stats.html">sg_get_fs_stats(3)</a>
489 >              <a href="docs/sg_get_disk_io_stats.3.html">sg_get_disk_io_stats(3)</a>
490              </li>
491              <li>
492 <              <a href="sg_get_host_info.html">sg_get_host_info(3)</a>
492 >              <a href="docs/sg_get_error.3.html">sg_get_error(3)</a>
493              </li>
494              <li>
495 <              <a href="sg_get_load_stats.html">sg_get_load_stats(3)</a>
495 >              <a href="docs/sg_get_fs_stats.3.html">sg_get_fs_stats(3)</a>
496              </li>
497              <li>
498 <              <a href="sg_get_mem_stats.html">sg_get_mem_stats(3)</a>
498 >              <a href="docs/sg_get_host_info.3.html">sg_get_host_info(3)</a>
499              </li>
500              <li>
501 <              <a href="sg_get_network_iface_stats.html">sg_get_network_iface_stats(3)</a>
501 >              <a href="docs/sg_get_load_stats.3.html">sg_get_load_stats(3)</a>
502              </li>
503              <li>
504 <              <a href="sg_get_network_io_stats.html">sg_get_network_io_stats(3)</a>
504 >              <a href="docs/sg_get_mem_stats.3.html">sg_get_mem_stats(3)</a>
505              </li>
506              <li>
507 <              <a href="sg_get_page_stats.html">sg_get_page_stats(3)</a>
507 >              <a href="docs/sg_get_network_iface_stats.3.html">sg_get_network_iface_stats(3)</a>
508              </li>
509              <li>
510 <              <a href="sg_get_process_stats.html">sg_get_process_stats(3)</a>
510 >              <a href="docs/sg_get_network_io_stats.3.html">sg_get_network_io_stats(3)</a>
511              </li>
512              <li>
513 <              <a href="sg_get_user_stats.html">sg_get_user_stats(3)</a>
513 >              <a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a>
514 >            </li>
515 >            <li>
516 >              <a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a>
517 >            </li>
518 >            <li>
519 >              <a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a>
520 >            </li>
521 >            <li>
522 >              <a href="docs/sg_init.3.html">sg_init(3)</a>
523 >            </li>
524 >            <li>
525 >              <a href="docs/sg_internal-intro.3.html">sg_internal-intro(3)</a>
526 >            </li>
527 >            <li>
528 >              <a href="docs/sg_intro.3.html">sg_intro(3)</a>
529 >            </li>
530 >            <li>
531 >              <a href="docs/sg_lock_mutex.3.html">sg_lock_mutex(3)</a>
532 >            </li>
533 >            <li>
534 >              <a href="docs/sg_set_error.3.html">sg_set_error(3)</a>
535 >            </li>
536 >            <li>
537 >              <a href="docs/sg_vector_create.3.html">sg_vector_create(3)</a>
538              </li>
539            </ul>
540            <h2>

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines