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.29 by tdb, Sun Aug 1 15:21:39 2004 UTC vs.
Revision 1.51 by tdb, Fri May 30 20:57:18 2008 UTC

# Line 16 | Line 16
16            <div id="topnav">
17              <ul>
18                <li>
19 <                <a href="#news">News</a>
19 >                <a href="#what">What is libstatgrab?</a>
20                </li>
21                <li>
22 <                <a href="#what">What is libstatgrab?</a>
22 >                <a href="#news">News</a>
23                </li>
24                <li>
25                  <a href="#download">Downloading</a>
# 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 +            Friday 30 May 2008
85 +          </h3>
86 +          <p>
87 +            Dag Odenhall got in touch today to let us know he's written
88 +            <a href="http://statgrab.rubyforge.org/">Ruby bindings</a>
89 +            for libstatgrab. Thanks Dag!
90 +          </p>
91 +          <h3>
92 +            Monday 17 March 2008
93 +          </h3>
94 +          <p>
95 +            Version 0.16 of libstatgrab has been released.<br />
96 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
97 +          </p>
98 +          <p>
99 +            This release fixes some minor build problems on Solaris
100 +            with Sun's compiler, and on the Debian "armel" port. Also
101 +            a minor fix to statgrab-make-mrtg-config on machines with
102 +            no swap, and added support for FreeBSD 8.
103 +          </p>
104 +          <h3>
105 +            Saturday 14 July 2007
106 +          </h3>
107 +          <p>
108 +            Version 0.15 of libstatgrab has been released.<br />
109 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
110 +          </p>
111 +          <p>
112 +            This release fixes a regression introduced on OpenBSD in
113 +            the last release - memory statistics were reported
114 +            incorrectly. Some other minor changes have been made, see
115 +            the NEWS file for more information.
116 +          </p>
117 +          <h3>
118 +            Monday 8 January 2007
119 +          </h3>
120 +          <p>
121 +            Version 0.14 of libstatgrab has been released.<br />
122 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
123 +          </p>
124 +          <p>
125 +            This release contains mainly bugfixes - see the NEWS file
126 +            in the distribution for a full list. It also brings a new
127 +            feature in saidar: colour support, which can be activated
128 +            with the -c runtime flag.
129 +          </p>
130 +          <h3>
131 +            Monday 20 March 2006
132 +          </h3>
133 +          <p>
134 +            Version 0.13 of libstatgrab has been released.<br />
135 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
136 +          </p>
137 +          <p>
138 +            This release mainly includes a bunch of bug fixes, but
139 +            also brings preliminary support for WIN32. We've also
140 +            added a few lines to the header file to make C++ linking
141 +            easier. Please see the NEWS file in the distribution for
142 +            full details.
143 +          </p>
144 +          <h3>
145 +            Sunday 31 July 2005
146 +          </h3>
147 +          <p>
148 +            Version 0.12 of libstatgrab has been released.<br />
149 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
150 +          </p>
151 +          <p>
152 +            This release has some new features, bug fixes, and a minor
153 +            API change. More details have been added to the file
154 +            system statistics, linux partition detection has been
155 +            reworked, and compile errors on Linux 2.6 have been fixed.
156 +            Support has been added for Solaris 10 and FreeBSD 7.
157 +            There are also manual pages for all the tools.
158 +          </p>
159 +          <p>
160 +            The duplex value in the network interface statistics has
161 +            changed name from "dup" to "duplex" - this breaks the API.
162 +            We plan to stabilise the API for a 1.0 release. As before,
163 +            the old name is available if SG_ENABLE_DEPRECATED is
164 +            defined.
165 +          </p>
166 +          <h3>
167 +            Tuesday 26 April 2005
168 +          </h3>
169 +          <p>
170 +            Official libstatgrab packages for Debian now
171 +            <a href="http://packages.debian.org/unstable/source/libstatgrab">available</a>.
172 +          </p>
173 +          <p>
174 +            Thanks to the work of
175 +            <a href="mailto:fenio@debian.org">Bartosz Fenski</a>
176 +            libstatgrab is now available on debian. This replaces our
177 +            unofficial debian packages which will no longer be
178 +            updated.
179 +          </p>
180 +          <h3>
181 +            Thursday 3 March 2005
182 +          </h3>
183 +          <p>
184 +            Version 0.11.1 of libstatgrab has been released.<br />
185 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
186 +          </p>
187 +          <p>
188 +            This release fixes a handful of minor bugs. Duplex
189 +            settings were reported incorrectly on linux (half and
190 +            full duplex were swapped), saidar displayed negative
191 +            filesystem stats incorrectly, and NFS filesystems were
192 +            ignored. These have all been fixed.
193 +          </p>
194 +          <h3>
195 +            Friday 12 November 2004
196 +          </h3>
197 +          <p>
198 +            Version 0.11 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 brings support for HP-UX (version 11.11), and
203 +            also fixes a few other minor issues.
204 +          </p>
205 +          <h3>
206 +            Wednesday 25 August 2004
207 +          </h3>
208 +          <p>
209 +            Version 0.10.3 of libstatgrab has been released.<br />
210 +            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
211 +          </p>
212 +          <p>
213 +            This release adds a handful of new features to statgrab, and
214 +            adds support for FreeBSD 6.0-CURRENT. See the NEWS file in
215 +            the tarball for more details.
216 +          </p>
217 +          <h3>
218              Tuesday 27 July 2004
219            </h3>
220            <p>
# Line 110 | Line 278
278            </h3>
279            <p>
280              pystatgrab, a new package containing a set of Python
281 <            bindings, has been released. Check out it's
281 >            bindings, has been released. Check out its
282              <a href="/pystatgrab/">project page</a>.
283            </p>
116          <h3>
117            Wednesday 10 March 2004
118          </h3>
119          <p>
120            Version 0.9 of libstatgrab has been released.<br />
121            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
122          </p>
123          <p>
124            This release brings new features and new platforms. We've
125            added information about network interfaces (duplex, speed,
126            etc) along with further statistics such as i/o packets, i/o
127            errors, and collisions. Support has also been added for
128            OpenBSD and DragonFly BSD. Finally some work has been done
129            to reduce the platforms on which libstatgrab needs elevated
130            privileges. See the NEWS file for more information.
131          </p>
132          <h3>
133            Wednesday 11 February 2004
134          </h3>
135          <p>
136            Version 0.8.2 of libstatgrab has been released.<br />
137            Download it from one of our <a href="/mirrors.xhtml">mirrors</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.
145          </p>
146          <h3>
147            Wednesday 21 January 2004
148          </h3>
149          <p>
150            Version 0.8.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
159            released under the LGPL instead of the GPL.
160          </p>
161          <h3>
162            Tuesday 6 January 2004
163          </h3>
164          <p>
165            Version 0.8 of libstatgrab has been released.<br />
166            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
167          </p>
168          <p>
169            This release brings support for Linux 2.6 and partial
170            support for Cygwin. On Solaris libstatgrab now returns disk
171            names using cNtNdNsN names rather than the older sdN names.
172            There are also a bunch of fixes and optimisations in
173            various places. Finally, a new function has been added to
174            make it quicker to drop any elevated privileges libstatgrab
175            may require on some operating systems.
176          </p>
284            <h2>
178            <a id="what">What is libstatgrab?</a>
179          </h2>
180          <p>
181            libstatgrab is a library that provides cross platform
182            access to statistics about the system on which it's run.
183            It's written in C and presents a selection of useful
184            interfaces which can be used to access key system
185            statistics. The current list of statistics includes CPU
186            usage, memory utilisation, disk usage, process counts,
187            network traffic, disk I/O, and more.
188          </p>
189          <p>
190            The current list of platforms is Solaris 2.x, Linux
191            2.2/2.4/2.6, FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x,
192            DragonFly BSD 1.0, and Cygwin. The aim is to extend this to
193            include as many operating systems as possible.
194          </p>
195          <p>
196            The package also includes a couple of useful tools. The
197            first, <a href="#screenshot">saidar</a>, provides a
198            curses-based interface to viewing the current state of the
199            system. The second, statgrab, gives a sysctl-style
200            interface to the statistics gathered by libstatgrab. This
201            extends the use of libstatgrab to people writing scripts or
202            anything else that can't easily make C function calls.
203            Included with statgrab is a script to generate an
204            <a href="http://www.mrtg.org">MRTG</a> configuration file
205            to use statgrab.
206          </p>
207          <h2>
285              <a id="download">Downloading</a>
286            </h2>
287            <p>
# Line 215 | Line 292
292            </p>
293            <p>
294              For installation instructions see the README and INSTALL
295 <            files contained within the archive. If you're using
219 <            <a href="http://www.freebsd.org">FreeBSD</a> you can make
220 <            use of the
221 <            <a href="http://www.freshports.org/devel/libstatgrab">
222 <            devel/libstatgrab</a> port to install libstatgrab for you.
295 >            files contained within the archive.
296            </p>
297            <h2>
298              <a id="bindings">Language Bindings</a>
# Line 229 | Line 302
302                <a href="/pystatgrab/">Python</a>
303              </li>
304              <li>
305 <              <a href="http://pecl.php.net/statgrab/">PHP (external)</a>
305 >              <a href="http://pecl.php.net/statgrab/">PHP</a>
306              </li>
307              <li>
308 <              <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl (external)</a>
308 >              <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl</a>
309              </li>
310 +            <li>
311 +              <a href="http://statgrab.rubyforge.org/">Ruby</a>
312 +            </li>
313            </ul>
314            <p>
315              Here are links to bindings for higher level languages
316              that provide access to libstatgrab. If you've written
317              a binding for another language, please get
318 <            <a href="mailto:dev@i-scream.org">in touch</a> so we
318 >            <a href="mailto:support@i-scream.org">in touch</a> so we
319              can add a link here.
320            </p>
321            <h2>
322 +            <a id="packages">Packages of libstatgrab</a>
323 +          </h2>
324 +          <ul>
325 +            <li>
326 +              <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&amp;stype=all">FreeBSD</a>
327 +            </li>
328 +            <li>
329 +              <a href="http://packages.gentoo.org/search/?sstring=libstatgrab">Gentoo Linux</a>
330 +            </li>
331 +            <li>
332 +              <a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a>
333 +            </li>
334 +            <li>
335 +              <a href="http://www.sunfreeware.com/">Solaris (SunFreeware)</a>
336 +            </li>
337 +            <li>
338 +              <a href="http://packages.debian.org/unstable/source/libstatgrab">Debian</a>
339 +            </li>
340 +            <li>
341 +              <a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a>
342 +            </li>
343 +            <li>
344 +              <a href="http://software.opensuse.org/download/home:/anagappan/">RPMs for various Linux distributions</a>
345 +            </li>
346 +            <li>
347 +              <a href="http://www.openbsd.org/cgi-bin/cvsweb/ports/sysutils/libstatgrab/">OpenBSD</a>
348 +            </li>
349 +          </ul>
350 +          <p>
351 +            These are various pre-packaged versions of libstatgrab
352 +            that you can get for your favourite operating system. If
353 +            we've missed any out, please let us know.
354 +          </p>
355 +          <p>
356 +            We've noticed that google throws up some RPM's relating
357 +            to Mandrake and Suse, but no webpage for them.
358 +          </p>
359 +          <h2>
360              <a id="development">Development</a>
361            </h2>
362            <ul>
# Line 261 | Line 375
375            </h2>
376            <p>
377              The only online documentation we have at the moment is the
378 <            manual pages converted in to HTML format. It's probably
379 <            best to start with the overview manual page:
378 >            manual pages converted in to HTML format. First are the
379 >            manual pages for the command line tools:
380            </p>
381            <ul>
382              <li>
383 <              <a href="statgrab.html">statgrab(3)</a>
383 >              <a href="docs/saidar.1.html">saidar(1)</a>
384              </li>
385 +            <li>
386 +              <a href="docs/statgrab.1.html">statgrab(1)</a>
387 +            </li>
388 +            <li>
389 +              <a href="docs/statgrab-make-mrtg-config.1.html">statgrab-make-mrtg-config(1)</a>
390 +            </li>
391 +            <li>
392 +              <a href="docs/statgrab-make-mrtg-index.1.html">statgrab-make-mrtg-index(1)</a>
393 +            </li>
394            </ul>
395            <p>
396 +            We also have an overview page for the library:
397 +          </p>
398 +          <ul>
399 +            <li>
400 +              <a href="docs/statgrab.3.html">statgrab(3)</a>
401 +            </li>
402 +          </ul>
403 +          <p>
404              Then we have the manual pages for each function:
405            </p>
406            <ul>
407              <li>
408 <              <a href="sg_get_cpu_stats.html">sg_get_cpu_stats(3)</a>
408 >              <a href="docs/sg_get_cpu_stats.3.html">sg_get_cpu_stats(3)</a>
409              </li>
410              <li>
411 <              <a href="sg_get_disk_io_stats.html">sg_get_disk_io_stats(3)</a>
411 >              <a href="docs/sg_get_disk_io_stats.3.html">sg_get_disk_io_stats(3)</a>
412              </li>
413              <li>
414 <              <a href="sg_get_fs_stats.html">sg_get_fs_stats(3)</a>
414 >              <a href="docs/sg_get_fs_stats.3.html">sg_get_fs_stats(3)</a>
415              </li>
416              <li>
417 <              <a href="sg_get_host_info.html">sg_get_host_info(3)</a>
417 >              <a href="docs/sg_get_host_info.3.html">sg_get_host_info(3)</a>
418              </li>
419              <li>
420 <              <a href="sg_get_load_stats.html">sg_get_load_stats(3)</a>
420 >              <a href="docs/sg_get_load_stats.3.html">sg_get_load_stats(3)</a>
421              </li>
422              <li>
423 <              <a href="sg_get_mem_stats.html">sg_get_mem_stats(3)</a>
423 >              <a href="docs/sg_get_mem_stats.3.html">sg_get_mem_stats(3)</a>
424              </li>
425              <li>
426 <              <a href="sg_get_network_iface_stats.html">sg_get_network_iface_stats(3)</a>
426 >              <a href="docs/sg_get_network_iface_stats.3.html">sg_get_network_iface_stats(3)</a>
427              </li>
428              <li>
429 <              <a href="sg_get_network_io_stats.html">sg_get_network_io_stats(3)</a>
429 >              <a href="docs/sg_get_network_io_stats.3.html">sg_get_network_io_stats(3)</a>
430              </li>
431              <li>
432 <              <a href="sg_get_page_stats.html">sg_get_page_stats(3)</a>
432 >              <a href="docs/sg_get_page_stats.3.html">sg_get_page_stats(3)</a>
433              </li>
434              <li>
435 <              <a href="sg_get_process_stats.html">sg_get_process_stats(3)</a>
435 >              <a href="docs/sg_get_process_stats.3.html">sg_get_process_stats(3)</a>
436              </li>
437              <li>
438 <              <a href="sg_get_user_stats.html">sg_get_user_stats(3)</a>
438 >              <a href="docs/sg_get_user_stats.3.html">sg_get_user_stats(3)</a>
439              </li>
440            </ul>
441            <h2>

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines