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.33 by tdb, Thu Jan 20 20:30:46 2005 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 42 | 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
50 <            <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 136 | 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>
142          <h3>
143            Wednesday 10 March 2004
144          </h3>
145          <p>
146            Version 0.9 of libstatgrab has been released.<br />
147            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
148          </p>
149          <p>
150            This release brings new features and new platforms. We've
151            added information about network interfaces (duplex, speed,
152            etc) along with further statistics such as i/o packets, i/o
153            errors, and collisions. Support has also been added for
154            OpenBSD and DragonFly BSD. Finally some work has been done
155            to reduce the platforms on which libstatgrab needs elevated
156            privileges. See the NEWS file for more information.
157          </p>
158          <h3>
159            Wednesday 11 February 2004
160          </h3>
161          <p>
162            Version 0.8.2 of libstatgrab has been released.<br />
163            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
164          </p>
165          <p>
166            The main focus of this release is adding support for
167            Solaris 6. We've also added Python bindings so you can use
168            libstatgrab directly from Python (see the extras
169            directory). Finally, we've tidied up a few bits of the
170            code.
171          </p>
172          <h3>
173            Wednesday 21 January 2004
174          </h3>
175          <p>
176            Version 0.8.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 primarily fixes bugs. On Linux a file
181            descriptor leak was fixed. On Solaris some significant
182            speed increases were made to the disk mapping code, along
183            with some bug fixes for Solaris 7 platforms. Also, the
184            library part of libstatgrab (but not the tools) is now
185            released under the LGPL instead of the GPL.
186          </p>
187          <h3>
188            Tuesday 6 January 2004
189          </h3>
190          <p>
191            Version 0.8 of libstatgrab has been released.<br />
192            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
193          </p>
194          <p>
195            This release brings support for Linux 2.6 and partial
196            support for Cygwin. On Solaris libstatgrab now returns disk
197            names using cNtNdNsN names rather than the older sdN names.
198            There are also a bunch of fixes and optimisations in
199            various places. Finally, a new function has been added to
200            make it quicker to drop any elevated privileges libstatgrab
201            may require on some operating systems.
202          </p>
371            <h2>
204            <a id="what">What is libstatgrab?</a>
205          </h2>
206          <p>
207            libstatgrab is a library that provides cross platform
208            access to statistics about the system on which it's run.
209            It's written in C and presents a selection of useful
210            interfaces which can be used to access key system
211            statistics. The current list of statistics includes CPU
212            usage, memory utilisation, disk usage, process counts,
213            network traffic, disk I/O, and more.
214          </p>
215          <p>
216            The current list of platforms is Solaris 2.x, Linux
217            2.2/2.4/2.6, FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x,
218            DragonFly BSD 1.0, HP-UX, and Cygwin. The aim is to extend
219            this to include as many operating systems as possible.
220          </p>
221          <p>
222            The package also includes a couple of useful tools. The
223            first, <a href="#screenshot">saidar</a>, provides a
224            curses-based interface to viewing the current state of the
225            system. The second, statgrab, gives a sysctl-style
226            interface to the statistics gathered by libstatgrab. This
227            extends the use of libstatgrab to people writing scripts or
228            anything else that can't easily make C function calls.
229            Included with statgrab is a script to generate an
230            <a href="http://www.mrtg.org">MRTG</a> configuration file
231            to use statgrab.
232          </p>
233          <h2>
372              <a id="download">Downloading</a>
373            </h2>
374            <p>
# Line 251 | 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
264 <            <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>
# Line 269 | Line 409
409            </h2>
410            <ul>
411              <li>
412 <              <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&stype=all">FreeBSD</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=statgrab">Gentoo Linux</a>
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://ftp.i-scream.org/pub/i-scream/packages/debian/">Debian (unofficial)</a>
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              These are various pre-packaged versions of libstatgrab
# Line 290 | Line 442
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
445 >            We've noticed that Google throws up some RPM's relating
446              to Mandrake and Suse, but no webpage for them.
447            </p>
296          <p>
297            Several attempts were made to submit a port to the
298            OpenBSD folk, but they didn't seem interested in taking
299            it. You can find it
300            <a href="http://ftp.i-scream.org/pub/i-scream/tmp/libstatgrab-0.11-openbsd-port.tar.gz">
301            here.
302          </p>
448            <h2>
449 <            <a id="development">Development</a>
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. First are the
454 +            manual pages for the command line tools:
455 +          </p>
456            <ul>
457              <li>
458 <              <a href="/cgi-bin/cvslog.cgi?period=thisweek&amp;module=projects/libstatgrab">Commits this week</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 develop libstatgrab using the CVS revision control system.
313 <            Using this link you can see what changes we've made this week.
314 <            For more information on our CVS setup see our
315 <            <a href="/cvs.xhtml">CVS page</a>.
471 >            We also have an overview page for the library:
472            </p>
317          <h2>
318            <a id="documentation">Documentation</a>
319          </h2>
320          <p>
321            The only online documentation we have at the moment is the
322            manual pages converted in to HTML format. It's probably
323            best to start with the overview manual page:
324          </p>
473            <ul>
474              <li>
475 <              <a href="statgrab.html">statgrab(3)</a>
475 >              <a href="docs/statgrab.3.html">statgrab(3)</a>
476              </li>
477            </ul>
478            <p>
# Line 332 | Line 480
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