www/libstatgrab/index.xhtml

<!--#include virtual="/doctype.inc" -->
  <head>
    <title>
      i-scream libstatgrab homepage
    </title>
<!--#include virtual="/style.inc" -->
  </head>
  <body>
    <div id="container">
      <div id="main">
<!--#include virtual="/header.inc" -->
        <div id="contents">
          <h1 class="top">
            i-scream libstatgrab homepage
          </h1>
          <div id="topnav">
            <ul>
              <li>
                <a href="#what">What is libstatgrab?</a>
              </li>
              <li>
                <a href="#news">News</a>
              </li>
              <li>
                <a href="#download">Downloading</a>
              </li>
              <li>
                <a href="#bindings">Language Bindings</a>
              </li>
              <li>
                <a href="#packages">Packages</a>
              </li>
              <li>
                <a href="#development">Development</a>
              </li>
              <li>
                <a href="#documentation">Documentation</a>
              </li>
              <li>
                <a href="#screenshot">Screenshot</a>
              </li>
            </ul>
          </div>
          <h2>
            <a id="what">What is libstatgrab?</a>
          </h2>
          <p>
            libstatgrab is a library that provides cross platform
            access to statistics about the system on which it's run.
            It's written in C and presents a selection of useful
            interfaces which can be used to access key system
            statistics. The current list of statistics includes CPU
            usage, memory utilisation, disk usage, process counts,
            network traffic, disk I/O, and more.
          </p>
          <p>
            The current list of platforms is Solaris 2.x, Linux
            2.2/2.4/2.6, FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x,
            DragonFly BSD 1.0, HP-UX, and Cygwin. The aim is to extend
            this to include as many operating systems as possible.
          </p>
          <p>
            The package also includes a couple of useful tools. The
            first, <a href="#screenshot">saidar</a>, provides a
            curses-based interface to viewing the current state of the
            system. The second, statgrab, gives a sysctl-style
            interface to the statistics gathered by libstatgrab. This
            extends the use of libstatgrab to people writing scripts or
            anything else that can't easily make C function calls.
            Included with statgrab is a script to generate an
            <a href="http://www.mrtg.org">MRTG</a> configuration file
            to use statgrab.
          </p>
          <h2>
            <a id="news">News</a>
          </h2>
          <p>
            To get notifications of new libstatgrab releases why not
            subscribe to our project over on
            <a href="http://freshmeat.net/projects/libstatgrab/">freshmeat</a>?
          </p>
          <h3>
            Tuesday 26 April 2005
          </h3>
          <p>
            Official libstatgrab packages for Debian now
            <a href="http://packages.debian.org/unstable/source/libstatgrab/">available</a>.
          </p>
          <p>
            Thanks to the work of
            <a href="mailto:fenio@debian.org">Bartosz Fenski</a>
            libstatgrab is now available on debian. This replaces our
            unofficial debian packages which will no longer be
            updated.
          </p>
          <h3>
            Thursday 3 March 2005
          </h3>
          <p>
            Version 0.11.1 of libstatgrab has been released.<br />
            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
          </p>
          <p>
            This release fixes a handful of minor bugs. Duplex
            settings were reported incorrectly on linux (half and
            full duplex were swapped), saidar displayed negative
            filesystem stats incorrectly, and NFS filesystems were
            ignored. These have all been fixed.
          </p>
          <h3>
            Friday 12 November 2004
          </h3>
          <p>
            Version 0.11 of libstatgrab has been released.<br />
            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
          </p>
          <p>
            This release brings support for HP-UX (version 11.11), and
            also fixes a few other minor issues.
          </p>
          <h3>
            Wednesday 25 August 2004
          </h3>
          <p>
            Version 0.10.3 of libstatgrab has been released.<br />
            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
          </p>
          <p>
            This release adds a handful of new features to statgrab, and
            adds support for FreeBSD 6.0-CURRENT. See the NEWS file in
            the tarball for more details.
          </p>
          <h3>
            Tuesday 27 July 2004
          </h3>
          <p>
            Version 0.10.2 of libstatgrab has been released.<br />
            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
          </p>
          <p>
            This release fixes a problem with the shared library
            version number in the last release.
          </p>
          <h3>
            Monday 26 July 2004
          </h3>
          <p>
            Version 0.10.1 of libstatgrab has been released.<br />
            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
          </p>
          <p>
            This release consists almost entirely of bugfixes.
            We've fixed compile-time errors for recent OpenBSD and
            NetBSD platforms, and also a minor bug in statgrab
            that broke network statistics on Solaris. New
            variables have been added to the pkg-config file to
            suggest ownership and permissions of binaries, and
            we've added error reporting functions that store errno
            values. There's also other minor fixes detailed in the
            NEWS file.
          </p>
          <h3>
            Thursday 20 May 2004
          </h3>
          <p>
            Version 0.10 of libstatgrab has been released.<br />
            Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
          </p>
          <p>
            This release concentrates heavily on standardising the names
            of functions and structures throughout libstatgrab. Although
            this will mean changes for existing programs, in the long run
            we hope it'll make things both clearer and easier. However,
            for those who still need the old functions we have provided
            compatibility wrappers. See the NEWS file for details.
          </p>
          <p>
            The other main change in this release is a new function to
            provide full details on currently running processes. See the
            documentation for sg_get_process_stats for details. Along with
            this there are compare functions for use with qsort for sorting
            process, network, and disk io statistics. We've also introduced
            error reporting functions that allow calling applications to
            see why libstatgrab has returned a failure. See sg_get_error.
          </p>
          <p>
            Finally, we've added support for NetBSD 2.0 and tidied up lots
            of areas of the code. This release does not include the python
            bindings - they're now available as their own project called
            <a href="/pystatgrab/">pystatgrab</a>.
          </p>
          <h3>
            Sunday 21 March 2004
          </h3>
          <p>
            pystatgrab, a new package containing a set of Python
            bindings, has been released. Check out it's
            <a href="/pystatgrab/">project page</a>.
          </p>
          <h2>
            <a id="download">Downloading</a>
          </h2>
          <p>
            The latest version of libstatgrab can be downloaded from
            our <a href="/mirrors.xhtml">mirror sites</a>.
            All downloads are pgp signed using our
            <a href="/pgpkey.xhtml">PGP Key</a>.
          </p>
          <p>
            For installation instructions see the README and INSTALL
            files contained within the archive.
          </p>
          <h2>
            <a id="bindings">Language Bindings</a>
          </h2>
          <ul>
            <li>
              <a href="/pystatgrab/">Python</a>
            </li>
            <li>
              <a href="http://pecl.php.net/statgrab/">PHP (external)</a>
            </li>
            <li>
              <a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl (external)</a>
            </li>
          </ul>
          <p>
            Here are links to bindings for higher level languages
            that provide access to libstatgrab. If you've written
            a binding for another language, please get
            <a href="mailto:dev@i-scream.org">in touch</a> so we
            can add a link here.
          </p>
          <h2>
            <a id="packages">Packages of libstatgrab</a>
          </h2>
          <ul>
            <li>
              <a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&amp;stype=all">FreeBSD</a>
            </li>
            <li>
              <a href="http://packages.gentoo.org/search/?sstring=statgrab">Gentoo Linux</a>
            </li>
            <li>
              <a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a>
            </li>
            <li>
              <a href="http://packages.debian.org/unstable/source/libstatgrab/">Debian</a>
            </li>
            <li>
              <a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a>
            </li>
          </ul>
          <p>
            These are various pre-packaged versions of libstatgrab
            that you can get for your favourite operating system. If
            we've missed any out, please let us know.
          </p>
          <p>
            We've noticed that google throws up some RPM's relating
            to Mandrake and Suse, but no webpage for them.
          </p>
          <p>
            Several attempts were made to submit a port to the
            OpenBSD folk, but they didn't seem interested in taking
            it. You can find it
            <a href="http://ftp.i-scream.org/pub/i-scream/tmp/libstatgrab-0.11-openbsd-port.tar.gz">
            here</a>.
          </p>
          <h2>
            <a id="development">Development</a>
          </h2>
          <ul>
            <li>
              <a href="/cgi-bin/cvslog.cgi?period=thisweek&amp;module=projects/libstatgrab">Commits this week</a>
            </li>
          </ul>
          <p>
            We develop libstatgrab using the CVS revision control system.
            Using this link you can see what changes we've made this week.
            For more information on our CVS setup see our
            <a href="/cvs.xhtml">CVS page</a>.
          </p>
          <h2>
            <a id="documentation">Documentation</a>
          </h2>
          <p>
            The only online documentation we have at the moment is the
            manual pages converted in to HTML format. It's probably
            best to start with the overview manual page:
          </p>
          <ul>
            <li>
              <a href="statgrab.html">statgrab(3)</a>
            </li>
          </ul>
          <p>
            Then we have the manual pages for each function:
          </p>
          <ul>
            <li>
              <a href="sg_get_cpu_stats.html">sg_get_cpu_stats(3)</a>
            </li>
            <li>
              <a href="sg_get_disk_io_stats.html">sg_get_disk_io_stats(3)</a>
            </li>
            <li>
              <a href="sg_get_fs_stats.html">sg_get_fs_stats(3)</a>
            </li>
            <li>
              <a href="sg_get_host_info.html">sg_get_host_info(3)</a>
            </li>
            <li>
              <a href="sg_get_load_stats.html">sg_get_load_stats(3)</a>
            </li>
            <li>
              <a href="sg_get_mem_stats.html">sg_get_mem_stats(3)</a>
            </li>
            <li>
              <a href="sg_get_network_iface_stats.html">sg_get_network_iface_stats(3)</a>
            </li>
            <li>
              <a href="sg_get_network_io_stats.html">sg_get_network_io_stats(3)</a>
            </li>
            <li>
              <a href="sg_get_page_stats.html">sg_get_page_stats(3)</a>
            </li>
            <li>
              <a href="sg_get_process_stats.html">sg_get_process_stats(3)</a>
            </li>
            <li>
              <a href="sg_get_user_stats.html">sg_get_user_stats(3)</a>
            </li>
          </ul>
          <h2>
            <a id="screenshot">Screenshot</a>
          </h2>
          <p>
            Here's what saidar looks like when it's running:
          </p>
          <p>
            <img src="saidar.png" alt="saidar screenshot" />
          </p>
        </div>
<!--#include virtual="/footer.inc" -->
      </div>
<!--#include virtual="/menu.inc" -->
    </div>
  </body>
</html>
Revision:	1.38
Committed:	Tue Apr 26 10:25:51 2005 UTC (19 years, 7 months ago) by tdb
Branch:	MAIN
Changes since 1.37:	+15 -1 lines
Log Message:	Official debian packages now available.
#	User	Rev	Content
1	tdb	1.20	<!--#include virtual="/doctype.inc" -->
2	tdb	1.21	<head>
3			<title>
4			i-scream libstatgrab homepage
5			</title>
6	tdb	1.19	<!--#include virtual="/style.inc" -->
7	tdb	1.21	</head>
8			<body>
9			<div id="container">
10			<div id="main">
11	tdb	1.19	<!--#include virtual="/header.inc" -->
12	tdb	1.21	<div id="contents">
13			<h1 class="top">
14			i-scream libstatgrab homepage
15			</h1>
16			<div id="topnav">
17			<ul>
18			<li>
19	tdb	1.37	<a href="#what">What is libstatgrab?</a>
20	tdb	1.21	</li>
21			<li>
22	tdb	1.37	<a href="#news">News</a>
23	tdb	1.21	</li>
24			<li>
25			<a href="#download">Downloading</a>
26			</li>
27			<li>
28	tdb	1.25	<a href="#bindings">Language Bindings</a>
29			</li>
30			<li>
31	tdb	1.33	<a href="#packages">Packages</a>
32			</li>
33			<li>
34	tdb	1.22	<a href="#development">Development</a>
35			</li>
36			<li>
37	tdb	1.21	<a href="#documentation">Documentation</a>
38			</li>
39			<li>
40			<a href="#screenshot">Screenshot</a>
41			</li>
42			</ul>
43			</div>
44			<h2>
45	tdb	1.37	<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 platforms is Solaris 2.x, Linux
58			2.2/2.4/2.6, FreeBSD 4.x/5.x, NetBSD 1.6.x, OpenBSD 3.x,
59			DragonFly BSD 1.0, HP-UX, and Cygwin. The aim is to extend
60			this to include as many operating systems as possible.
61			</p>
62			<p>
63			The package also includes a couple of useful tools. The
64			first, <a href="#screenshot">saidar</a>, provides a
65			curses-based interface to viewing the current state of the
66			system. The second, statgrab, gives a sysctl-style
67			interface to the statistics gathered by libstatgrab. This
68			extends the use of libstatgrab to people writing scripts or
69			anything else that can't easily make C function calls.
70			Included with statgrab is a script to generate an
71			<a href="http://www.mrtg.org">MRTG</a> configuration file
72			to use statgrab.
73			</p>
74			<h2>
75	tdb	1.21	<a id="news">News</a>
76			</h2>
77			<p>
78			To get notifications of new libstatgrab releases why not
79			subscribe to our project over on
80			<a href="http://freshmeat.net/projects/libstatgrab/">freshmeat</a>?
81			</p>
82			<h3>
83	tdb	1.38	Tuesday 26 April 2005
84			</h3>
85			<p>
86			Official libstatgrab packages for Debian now
87			<a href="http://packages.debian.org/unstable/source/libstatgrab/">available</a>.
88			</p>
89			<p>
90			Thanks to the work of
91			<a href="mailto:fenio@debian.org">Bartosz Fenski</a>
92			libstatgrab is now available on debian. This replaces our
93			unofficial debian packages which will no longer be
94			updated.
95			</p>
96			<h3>
97	tdb	1.36	Thursday 3 March 2005
98			</h3>
99			<p>
100			Version 0.11.1 of libstatgrab has been released.<br />
101			Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
102			</p>
103			<p>
104			This release fixes a handful of minor bugs. Duplex
105			settings were reported incorrectly on linux (half and
106			full duplex were swapped), saidar displayed negative
107			filesystem stats incorrectly, and NFS filesystems were
108			ignored. These have all been fixed.
109			</p>
110			<h3>
111	tdb	1.31	Friday 12 November 2004
112			</h3>
113			<p>
114			Version 0.11 of libstatgrab has been released.<br />
115			Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
116			</p>
117			<p>
118			This release brings support for HP-UX (version 11.11), and
119			also fixes a few other minor issues.
120			</p>
121			<h3>
122	tdb	1.30	Wednesday 25 August 2004
123			</h3>
124			<p>
125			Version 0.10.3 of libstatgrab has been released.<br />
126			Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
127			</p>
128			<p>
129			This release adds a handful of new features to statgrab, and
130			adds support for FreeBSD 6.0-CURRENT. See the NEWS file in
131			the tarball for more details.
132			</p>
133			<h3>
134	tdb	1.28	Tuesday 27 July 2004
135			</h3>
136			<p>
137			Version 0.10.2 of libstatgrab has been released.<br />
138	tdb	1.29	Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
139	tdb	1.28	</p>
140			<p>
141			This release fixes a problem with the shared library
142			version number in the last release.
143			</p>
144			<h3>
145	tdb	1.27	Monday 26 July 2004
146			</h3>
147			<p>
148			Version 0.10.1 of libstatgrab has been released.<br />
149	tdb	1.29	Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
150	tdb	1.27	</p>
151			<p>
152			This release consists almost entirely of bugfixes.
153			We've fixed compile-time errors for recent OpenBSD and
154			NetBSD platforms, and also a minor bug in statgrab
155			that broke network statistics on Solaris. New
156			variables have been added to the pkg-config file to
157			suggest ownership and permissions of binaries, and
158			we've added error reporting functions that store errno
159			values. There's also other minor fixes detailed in the
160			NEWS file.
161			</p>
162			<h3>
163	tdb	1.24	Thursday 20 May 2004
164			</h3>
165			<p>
166			Version 0.10 of libstatgrab has been released.<br />
167	tdb	1.29	Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
168	tdb	1.24	</p>
169			<p>
170			This release concentrates heavily on standardising the names
171			of functions and structures throughout libstatgrab. Although
172			this will mean changes for existing programs, in the long run
173			we hope it'll make things both clearer and easier. However,
174			for those who still need the old functions we have provided
175			compatibility wrappers. See the NEWS file for details.
176			</p>
177			<p>
178			The other main change in this release is a new function to
179			provide full details on currently running processes. See the
180			documentation for sg_get_process_stats for details. Along with
181			this there are compare functions for use with qsort for sorting
182			process, network, and disk io statistics. We've also introduced
183			error reporting functions that allow calling applications to
184			see why libstatgrab has returned a failure. See sg_get_error.
185			</p>
186			<p>
187			Finally, we've added support for NetBSD 2.0 and tidied up lots
188			of areas of the code. This release does not include the python
189			bindings - they're now available as their own project called
190			<a href="/pystatgrab/">pystatgrab</a>.
191			</p>
192			<h3>
193	tdb	1.21	Sunday 21 March 2004
194			</h3>
195			<p>
196			pystatgrab, a new package containing a set of Python
197			bindings, has been released. Check out it's
198			<a href="/pystatgrab/">project page</a>.
199			</p>
200			<h2>
201			<a id="download">Downloading</a>
202			</h2>
203			<p>
204			The latest version of libstatgrab can be downloaded from
205	tdb	1.29	our <a href="/mirrors.xhtml">mirror sites</a>.
206			All downloads are pgp signed using our
207	tdb	1.21	<a href="/pgpkey.xhtml">PGP Key</a>.
208			</p>
209			<p>
210			For installation instructions see the README and INSTALL
211	tdb	1.33	files contained within the archive.
212	tdb	1.22	</p>
213			<h2>
214	tdb	1.25	<a id="bindings">Language Bindings</a>
215			</h2>
216			<ul>
217			<li>
218			<a href="/pystatgrab/">Python</a>
219			</li>
220			<li>
221			<a href="http://pecl.php.net/statgrab/">PHP (external)</a>
222			</li>
223			<li>
224			<a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl (external)</a>
225			</li>
226			</ul>
227			<p>
228			Here are links to bindings for higher level languages
229			that provide access to libstatgrab. If you've written
230			a binding for another language, please get
231			<a href="mailto:dev@i-scream.org">in touch</a> so we
232			can add a link here.
233	tdb	1.33	</p>
234			<h2>
235			<a id="packages">Packages of libstatgrab</a>
236			</h2>
237			<ul>
238			<li>
239	tdb	1.34	<a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&stype=all">FreeBSD</a>
240	tdb	1.33	</li>
241			<li>
242			<a href="http://packages.gentoo.org/search/?sstring=statgrab">Gentoo Linux</a>
243			</li>
244			<li>
245			<a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a>
246			</li>
247			<li>
248	tdb	1.38	<a href="http://packages.debian.org/unstable/source/libstatgrab/">Debian</a>
249	tdb	1.33	</li>
250			<li>
251			<a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a>
252			</li>
253			</ul>
254			<p>
255			These are various pre-packaged versions of libstatgrab
256			that you can get for your favourite operating system. If
257			we've missed any out, please let us know.
258			</p>
259			<p>
260			We've noticed that google throws up some RPM's relating
261			to Mandrake and Suse, but no webpage for them.
262			</p>
263			<p>
264			Several attempts were made to submit a port to the
265			OpenBSD folk, but they didn't seem interested in taking
266			it. You can find it
267			<a href="http://ftp.i-scream.org/pub/i-scream/tmp/libstatgrab-0.11-openbsd-port.tar.gz">
268	tdb	1.35	here</a>.
269	tdb	1.25	</p>
270			<h2>
271	tdb	1.22	<a id="development">Development</a>
272			</h2>
273			<ul>
274			<li>
275	tdb	1.23	<a href="/cgi-bin/cvslog.cgi?period=thisweek&module=projects/libstatgrab">Commits this week</a>
276	tdb	1.22	</li>
277			</ul>
278			<p>
279	tdb	1.25	We develop libstatgrab using the CVS revision control system.
280	tdb	1.22	Using this link you can see what changes we've made this week.
281	tdb	1.25	For more information on our CVS setup see our
282	tdb	1.22	<a href="/cvs.xhtml">CVS page</a>.
283	tdb	1.21	</p>
284			<h2>
285			<a id="documentation">Documentation</a>
286			</h2>
287			<p>
288			The only online documentation we have at the moment is the
289			manual pages converted in to HTML format. It's probably
290			best to start with the overview manual page:
291			</p>
292			<ul>
293			<li>
294			<a href="statgrab.html">statgrab(3)</a>
295			</li>
296			</ul>
297			<p>
298			Then we have the manual pages for each function:
299			</p>
300			<ul>
301			<li>
302	tdb	1.24	<a href="sg_get_cpu_stats.html">sg_get_cpu_stats(3)</a>
303			</li>
304			<li>
305			<a href="sg_get_disk_io_stats.html">sg_get_disk_io_stats(3)</a>
306	tdb	1.21	</li>
307			<li>
308	tdb	1.24	<a href="sg_get_fs_stats.html">sg_get_fs_stats(3)</a>
309	tdb	1.21	</li>
310			<li>
311	tdb	1.24	<a href="sg_get_host_info.html">sg_get_host_info(3)</a>
312	tdb	1.21	</li>
313			<li>
314	tdb	1.24	<a href="sg_get_load_stats.html">sg_get_load_stats(3)</a>
315	tdb	1.21	</li>
316			<li>
317	tdb	1.24	<a href="sg_get_mem_stats.html">sg_get_mem_stats(3)</a>
318	tdb	1.21	</li>
319			<li>
320	tdb	1.24	<a href="sg_get_network_iface_stats.html">sg_get_network_iface_stats(3)</a>
321	tdb	1.21	</li>
322			<li>
323	tdb	1.24	<a href="sg_get_network_io_stats.html">sg_get_network_io_stats(3)</a>
324	tdb	1.21	</li>
325			<li>
326	tdb	1.24	<a href="sg_get_page_stats.html">sg_get_page_stats(3)</a>
327	tdb	1.21	</li>
328			<li>
329	tdb	1.24	<a href="sg_get_process_stats.html">sg_get_process_stats(3)</a>
330	tdb	1.21	</li>
331			<li>
332	tdb	1.24	<a href="sg_get_user_stats.html">sg_get_user_stats(3)</a>
333	tdb	1.21	</li>
334			</ul>
335			<h2>
336			<a id="screenshot">Screenshot</a>
337			</h2>
338			<p>
339			Here's what saidar looks like when it's running:
340			</p>
341			<p>
342			<img src="saidar.png" alt="saidar screenshot" />
343			</p>
344			</div>
345	tdb	1.19	<!--#include virtual="/footer.inc" -->
346	tdb	1.21	</div>
347	tdb	1.19	<!--#include virtual="/menu.inc" -->
348	tdb	1.21	</div>
349			</body>
350	tdb	1.1	</html>