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.56 by tdb, Thu Aug 8 19:33:59 2013 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 +            Thursday 8 August 2013
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.90 of libstatgrab has been released.<br />
83 >            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
84            </p>
85 +          <p>
86 +            Please note that the API in 0.90 has changed, so
87 +            applications using libstatgrab will need to be updated to
88 +            support the changes.
89 +          </p>
90 +          <p>
91 +            There are a large number of changes in this version of
92 +            libstatgrab. Here is an overview:
93 +          </p>
94 +          <ul>
95 +            <li>Thread safety and reentrant functions.</li>
96 +            <li>API unification (every stats call is now able to
97 +                return multiple entries).</li>
98 +            <li>Complete rewrite of internal memory management (eases
99 +                future extensions).</li>
100 +            <li>Add experimental support for tracing using log4cplus.</li>
101 +            <li>Complete the ports for AIX, HP-UX and most of the
102 +                widely used BSD-based operating systems.</li>
103 +            <li>Complete the port for Darwin/MacOS X including basic
104 +                Mach.</li>
105 +            <li>Clean up the FreeBSD and Solaris implementations.</li>
106 +            <li>Clean up the FreeBSD and Solaris implementations.</li>
107 +          </ul>
108 +          <p>
109 +            This release is the result of a significant amount of work
110 +            by the newest member of the libstatgrab team - Jens
111 +            Rehsack. Welcome to the team Jens!
112 +          </p>
113 +          <p>
114 +            If you find any bugs in the release please report them
115 +            over at our
116 +            <a href="https://github.com/i-scream/libstatgrab/issues">Issue
117 +            Tracker</a> on GitHub.
118 +          </p>
119            <h3>
120 +            Sunday 21 February 2010
121 +          </h3>
122 +          <p>
123 +            Version 0.17 of libstatgrab has been released.<br />
124 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
125 +          </p>
126 +          <p>
127 +            This release adds support for FreeBSD 9 and other systems
128 +            using utmpx. Also on FreeBSD it fixes an issue with large
129 +            quantities of memory and adds support for dynamically
130 +            getting a list of supported file systems. On Solaris ZFS
131 +            file systems will now be detected. And finally on Linux CPU
132 +            iowait information will be given where available.
133 +          </p>
134 +          <h3>
135 +            Friday 30 May 2008
136 +          </h3>
137 +          <p>
138 +            Dag Odenhall got in touch today to let us know he's written
139 +            <a href="http://statgrab.rubyforge.org/">Ruby bindings</a>
140 +            for libstatgrab. Thanks Dag!
141 +          </p>
142 +          <h3>
143 +            Monday 17 March 2008
144 +          </h3>
145 +          <p>
146 +            Version 0.16 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 fixes some minor build problems on Solaris
151 +            with Sun's compiler, and on the Debian "armel" port. Also
152 +            a minor fix to statgrab-make-mrtg-config on machines with
153 +            no swap, and added support for FreeBSD 8.
154 +          </p>
155 +          <h3>
156 +            Saturday 14 July 2007
157 +          </h3>
158 +          <p>
159 +            Version 0.15 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 fixes a regression introduced on OpenBSD in
164 +            the last release - memory statistics were reported
165 +            incorrectly. Some other minor changes have been made, see
166 +            the NEWS file for more information.
167 +          </p>
168 +          <h3>
169 +            Monday 8 January 2007
170 +          </h3>
171 +          <p>
172 +            Version 0.14 of libstatgrab has been released.<br />
173 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
174 +          </p>
175 +          <p>
176 +            This release contains mainly bugfixes - see the NEWS file
177 +            in the distribution for a full list. It also brings a new
178 +            feature in saidar: colour support, which can be activated
179 +            with the -c runtime flag.
180 +          </p>
181 +          <h3>
182 +            Monday 20 March 2006
183 +          </h3>
184 +          <p>
185 +            Version 0.13 of libstatgrab has been released.<br />
186 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
187 +          </p>
188 +          <p>
189 +            This release mainly includes a bunch of bug fixes, but
190 +            also brings preliminary support for WIN32. We've also
191 +            added a few lines to the header file to make C++ linking
192 +            easier. Please see the NEWS file in the distribution for
193 +            full details.
194 +          </p>
195 +          <h3>
196 +            Sunday 31 July 2005
197 +          </h3>
198 +          <p>
199 +            Version 0.12 of libstatgrab has been released.<br />
200 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
201 +          </p>
202 +          <p>
203 +            This release has some new features, bug fixes, and a minor
204 +            API change. More details have been added to the file
205 +            system statistics, linux partition detection has been
206 +            reworked, and compile errors on Linux 2.6 have been fixed.
207 +            Support has been added for Solaris 10 and FreeBSD 7.
208 +            There are also manual pages for all the tools.
209 +          </p>
210 +          <p>
211 +            The duplex value in the network interface statistics has
212 +            changed name from "dup" to "duplex" - this breaks the API.
213 +            We plan to stabilise the API for a 1.0 release. As before,
214 +            the old name is available if SG_ENABLE_DEPRECATED is
215 +            defined.
216 +          </p>
217 +          <h3>
218 +            Tuesday 26 April 2005
219 +          </h3>
220 +          <p>
221 +            Official libstatgrab packages for Debian now
222 +            <a href="http://packages.debian.org/unstable/source/libstatgrab">available</a>.
223 +          </p>
224 +          <p>
225 +            Thanks to the work of
226 +            <a href="mailto:fenio@debian.org">Bartosz Fenski</a>
227 +            libstatgrab is now available on debian. This replaces our
228 +            unofficial debian packages which will no longer be
229 +            updated.
230 +          </p>
231 +          <h3>
232 +            Thursday 3 March 2005
233 +          </h3>
234 +          <p>
235 +            Version 0.11.1 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 fixes a handful of minor bugs. Duplex
240 +            settings were reported incorrectly on linux (half and
241 +            full duplex were swapped), saidar displayed negative
242 +            filesystem stats incorrectly, and NFS filesystems were
243 +            ignored. These have all been fixed.
244 +          </p>
245 +          <h3>
246              Friday 12 November 2004
247            </h3>
248            <p>
# Line 136 | Line 329
329            </h3>
330            <p>
331              pystatgrab, a new package containing a set of Python
332 <            bindings, has been released. Check out it's
332 >            bindings, has been released. Check out its
333              <a href="/pystatgrab/">project page</a>.
334            </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>
335            <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>
336              <a id="download">Downloading</a>
337            </h2>
338            <p>
# Line 251 | Line 353
353                <a href="/pystatgrab/">Python</a>
354              </li>
355              <li>
356 <              <a href="http://pecl.php.net/statgrab/">PHP (external)</a>
356 >              <a href="http://pecl.php.net/statgrab/">PHP</a>
357              </li>
358              <li>
359 <              <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl (external)</a>
359 >              <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl</a>
360              </li>
361 +            <li>
362 +              <a href="http://statgrab.rubyforge.org/">Ruby</a>
363 +            </li>
364            </ul>
365            <p>
366              Here are links to bindings for higher level languages
367              that provide access to libstatgrab. If you've written
368 <            a binding for another language, please get
264 <            <a href="mailto:dev@i-scream.org">in touch</a> so we
368 >            a binding for another language, please get in touch so we
369              can add a link here.
370            </p>
371            <h2>
# Line 269 | Line 373
373            </h2>
374            <ul>
375              <li>
376 <              <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&stype=all">FreeBSD</a>
376 >              <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&amp;stype=all">FreeBSD</a>
377              </li>
378              <li>
379 <              <a href="http://packages.gentoo.org/search/?sstring=statgrab">Gentoo Linux</a>
379 >              <a href="http://packages.gentoo.org/search/?sstring=libstatgrab">Gentoo Linux</a>
380              </li>
381              <li>
382                <a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a>
383              </li>
384              <li>
385 <              <a href="http://ftp.i-scream.org/pub/i-scream/packages/debian/">Debian (unofficial)</a>
385 >              <a href="http://www.sunfreeware.com/">Solaris (SunFreeware)</a>
386              </li>
387              <li>
388 +              <a href="http://www.opencsw.org/packages/libstatgrab/">Solaris (OpenCSW)</a>
389 +            </li>
390 +            <li>
391 +              <a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a>
392 +            </li>
393 +            <li>
394                <a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a>
395              </li>
396 +            <li>
397 +              <a href="http://software.opensuse.org/download/home:/anagappan/">RPMs for various Linux distributions</a>
398 +            </li>
399 +            <li>
400 +              <a href="http://www.openbsd.org/cgi-bin/cvsweb/ports/sysutils/libstatgrab/">OpenBSD</a>
401 +            </li>
402            </ul>
403            <p>
404              These are various pre-packaged versions of libstatgrab
# Line 290 | Line 406
406              we've missed any out, please let us know.
407            </p>
408            <p>
409 <            We've noticed that google throws up some RPM's relating
409 >            We've noticed that Google throws up some RPM's relating
410              to Mandrake and Suse, but no webpage for them.
411            </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>
412            <h2>
413 <            <a id="development">Development</a>
413 >            <a id="documentation">Documentation</a>
414            </h2>
415 +          <em>These need updating for the 0.90 release.</em>
416 +          <p>
417 +            The only online documentation we have at the moment is the
418 +            manual pages converted in to HTML format. First are the
419 +            manual pages for the command line tools:
420 +          </p>
421            <ul>
422              <li>
423 <              <a href="/cgi-bin/cvslog.cgi?period=thisweek&amp;module=projects/libstatgrab">Commits this week</a>
423 >              <a href="docs/saidar.1.html">saidar(1)</a>
424              </li>
425 +            <li>
426 +              <a href="docs/statgrab.1.html">statgrab(1)</a>
427 +            </li>
428 +            <li>
429 +              <a href="docs/statgrab-make-mrtg-config.1.html">statgrab-make-mrtg-config(1)</a>
430 +            </li>
431 +            <li>
432 +              <a href="docs/statgrab-make-mrtg-index.1.html">statgrab-make-mrtg-index(1)</a>
433 +            </li>
434            </ul>
435            <p>
436 <            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>.
436 >            We also have an overview page for the library:
437            </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>
438            <ul>
439              <li>
440 <              <a href="statgrab.html">statgrab(3)</a>
440 >              <a href="docs/statgrab.3.html">statgrab(3)</a>
441              </li>
442            </ul>
443            <p>
# Line 332 | Line 445
445            </p>
446            <ul>
447              <li>
448 <              <a href="sg_get_cpu_stats.html">sg_get_cpu_stats(3)</a>
448 >              <a href="docs/sg_get_cpu_stats.3.html">sg_get_cpu_stats(3)</a>
449              </li>
450              <li>
451 <              <a href="sg_get_disk_io_stats.html">sg_get_disk_io_stats(3)</a>
451 >              <a href="docs/sg_get_disk_io_stats.3.html">sg_get_disk_io_stats(3)</a>
452              </li>
453              <li>
454 <              <a href="sg_get_fs_stats.html">sg_get_fs_stats(3)</a>
454 >              <a href="docs/sg_get_fs_stats.3.html">sg_get_fs_stats(3)</a>
455              </li>
456              <li>
457 <              <a href="sg_get_host_info.html">sg_get_host_info(3)</a>
457 >              <a href="docs/sg_get_host_info.3.html">sg_get_host_info(3)</a>
458              </li>
459              <li>
460 <              <a href="sg_get_load_stats.html">sg_get_load_stats(3)</a>
460 >              <a href="docs/sg_get_load_stats.3.html">sg_get_load_stats(3)</a>
461              </li>
462              <li>
463 <              <a href="sg_get_mem_stats.html">sg_get_mem_stats(3)</a>
463 >              <a href="docs/sg_get_mem_stats.3.html">sg_get_mem_stats(3)</a>
464              </li>
465              <li>
466 <              <a href="sg_get_network_iface_stats.html">sg_get_network_iface_stats(3)</a>
466 >              <a href="docs/sg_get_network_iface_stats.3.html">sg_get_network_iface_stats(3)</a>
467              </li>
468              <li>
469 <              <a href="sg_get_network_io_stats.html">sg_get_network_io_stats(3)</a>
469 >              <a href="docs/sg_get_network_io_stats.3.html">sg_get_network_io_stats(3)</a>
470              </li>
471              <li>
472 <              <a href="sg_get_page_stats.html">sg_get_page_stats(3)</a>
472 >              <a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a>
473              </li>
474              <li>
475 <              <a href="sg_get_process_stats.html">sg_get_process_stats(3)</a>
475 >              <a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a>
476              </li>
477              <li>
478 <              <a href="sg_get_user_stats.html">sg_get_user_stats(3)</a>
478 >              <a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a>
479              </li>
480            </ul>
481            <h2>

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines