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>
            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://ftp.i-scream.org/pub/i-scream/packages/debian/">Debian (unofficial)</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.37
Committed:	Wed Mar 9 10:43:07 2005 UTC (19 years, 7 months ago) by tdb
Branch:	MAIN
Changes since 1.36:	+32 -32 lines
Log Message:	Move description of libstatgrab to top of page.
#	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.36	Thursday 3 March 2005
84			</h3>
85			<p>
86			Version 0.11.1 of libstatgrab has been released.<br />
87			Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
88			</p>
89			<p>
90			This release fixes a handful of minor bugs. Duplex
91			settings were reported incorrectly on linux (half and
92			full duplex were swapped), saidar displayed negative
93			filesystem stats incorrectly, and NFS filesystems were
94			ignored. These have all been fixed.
95			</p>
96			<h3>
97	tdb	1.31	Friday 12 November 2004
98			</h3>
99			<p>
100			Version 0.11 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 brings support for HP-UX (version 11.11), and
105			also fixes a few other minor issues.
106			</p>
107			<h3>
108	tdb	1.30	Wednesday 25 August 2004
109			</h3>
110			<p>
111			Version 0.10.3 of libstatgrab has been released.<br />
112			Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
113			</p>
114			<p>
115			This release adds a handful of new features to statgrab, and
116			adds support for FreeBSD 6.0-CURRENT. See the NEWS file in
117			the tarball for more details.
118			</p>
119			<h3>
120	tdb	1.28	Tuesday 27 July 2004
121			</h3>
122			<p>
123			Version 0.10.2 of libstatgrab has been released.<br />
124	tdb	1.29	Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
125	tdb	1.28	</p>
126			<p>
127			This release fixes a problem with the shared library
128			version number in the last release.
129			</p>
130			<h3>
131	tdb	1.27	Monday 26 July 2004
132			</h3>
133			<p>
134			Version 0.10.1 of libstatgrab has been released.<br />
135	tdb	1.29	Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
136	tdb	1.27	</p>
137			<p>
138			This release consists almost entirely of bugfixes.
139			We've fixed compile-time errors for recent OpenBSD and
140			NetBSD platforms, and also a minor bug in statgrab
141			that broke network statistics on Solaris. New
142			variables have been added to the pkg-config file to
143			suggest ownership and permissions of binaries, and
144			we've added error reporting functions that store errno
145			values. There's also other minor fixes detailed in the
146			NEWS file.
147			</p>
148			<h3>
149	tdb	1.24	Thursday 20 May 2004
150			</h3>
151			<p>
152			Version 0.10 of libstatgrab has been released.<br />
153	tdb	1.29	Download it from one of our <a href="/mirrors.xhtml">mirrors</a>.
154	tdb	1.24	</p>
155			<p>
156			This release concentrates heavily on standardising the names
157			of functions and structures throughout libstatgrab. Although
158			this will mean changes for existing programs, in the long run
159			we hope it'll make things both clearer and easier. However,
160			for those who still need the old functions we have provided
161			compatibility wrappers. See the NEWS file for details.
162			</p>
163			<p>
164			The other main change in this release is a new function to
165			provide full details on currently running processes. See the
166			documentation for sg_get_process_stats for details. Along with
167			this there are compare functions for use with qsort for sorting
168			process, network, and disk io statistics. We've also introduced
169			error reporting functions that allow calling applications to
170			see why libstatgrab has returned a failure. See sg_get_error.
171			</p>
172			<p>
173			Finally, we've added support for NetBSD 2.0 and tidied up lots
174			of areas of the code. This release does not include the python
175			bindings - they're now available as their own project called
176			<a href="/pystatgrab/">pystatgrab</a>.
177			</p>
178			<h3>
179	tdb	1.21	Sunday 21 March 2004
180			</h3>
181			<p>
182			pystatgrab, a new package containing a set of Python
183			bindings, has been released. Check out it's
184			<a href="/pystatgrab/">project page</a>.
185			</p>
186			<h2>
187			<a id="download">Downloading</a>
188			</h2>
189			<p>
190			The latest version of libstatgrab can be downloaded from
191	tdb	1.29	our <a href="/mirrors.xhtml">mirror sites</a>.
192			All downloads are pgp signed using our
193	tdb	1.21	<a href="/pgpkey.xhtml">PGP Key</a>.
194			</p>
195			<p>
196			For installation instructions see the README and INSTALL
197	tdb	1.33	files contained within the archive.
198	tdb	1.22	</p>
199			<h2>
200	tdb	1.25	<a id="bindings">Language Bindings</a>
201			</h2>
202			<ul>
203			<li>
204			<a href="/pystatgrab/">Python</a>
205			</li>
206			<li>
207			<a href="http://pecl.php.net/statgrab/">PHP (external)</a>
208			</li>
209			<li>
210			<a href="http://search.cpan.org/dist/Unix-Statgrab/">Perl (external)</a>
211			</li>
212			</ul>
213			<p>
214			Here are links to bindings for higher level languages
215			that provide access to libstatgrab. If you've written
216			a binding for another language, please get
217			<a href="mailto:dev@i-scream.org">in touch</a> so we
218			can add a link here.
219	tdb	1.33	</p>
220			<h2>
221			<a id="packages">Packages of libstatgrab</a>
222			</h2>
223			<ul>
224			<li>
225	tdb	1.34	<a href="http://www.freebsd.org/cgi/ports.cgi?query=statgrab&stype=all">FreeBSD</a>
226	tdb	1.33	</li>
227			<li>
228			<a href="http://packages.gentoo.org/search/?sstring=statgrab">Gentoo Linux</a>
229			</li>
230			<li>
231			<a href="http://www.blastwave.org/packages.php/libstatgrab">Solaris (Blastwave)</a>
232			</li>
233			<li>
234			<a href="http://ftp.i-scream.org/pub/i-scream/packages/debian/">Debian (unofficial)</a>
235			</li>
236			<li>
237			<a href="ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/devel/libstatgrab/README.html">NetBSD</a>
238			</li>
239			</ul>
240			<p>
241			These are various pre-packaged versions of libstatgrab
242			that you can get for your favourite operating system. If
243			we've missed any out, please let us know.
244			</p>
245			<p>
246			We've noticed that google throws up some RPM's relating
247			to Mandrake and Suse, but no webpage for them.
248			</p>
249			<p>
250			Several attempts were made to submit a port to the
251			OpenBSD folk, but they didn't seem interested in taking
252			it. You can find it
253			<a href="http://ftp.i-scream.org/pub/i-scream/tmp/libstatgrab-0.11-openbsd-port.tar.gz">
254	tdb	1.35	here</a>.
255	tdb	1.25	</p>
256			<h2>
257	tdb	1.22	<a id="development">Development</a>
258			</h2>
259			<ul>
260			<li>
261	tdb	1.23	<a href="/cgi-bin/cvslog.cgi?period=thisweek&module=projects/libstatgrab">Commits this week</a>
262	tdb	1.22	</li>
263			</ul>
264			<p>
265	tdb	1.25	We develop libstatgrab using the CVS revision control system.
266	tdb	1.22	Using this link you can see what changes we've made this week.
267	tdb	1.25	For more information on our CVS setup see our
268	tdb	1.22	<a href="/cvs.xhtml">CVS page</a>.
269	tdb	1.21	</p>
270			<h2>
271			<a id="documentation">Documentation</a>
272			</h2>
273			<p>
274			The only online documentation we have at the moment is the
275			manual pages converted in to HTML format. It's probably
276			best to start with the overview manual page:
277			</p>
278			<ul>
279			<li>
280			<a href="statgrab.html">statgrab(3)</a>
281			</li>
282			</ul>
283			<p>
284			Then we have the manual pages for each function:
285			</p>
286			<ul>
287			<li>
288	tdb	1.24	<a href="sg_get_cpu_stats.html">sg_get_cpu_stats(3)</a>
289			</li>
290			<li>
291			<a href="sg_get_disk_io_stats.html">sg_get_disk_io_stats(3)</a>
292	tdb	1.21	</li>
293			<li>
294	tdb	1.24	<a href="sg_get_fs_stats.html">sg_get_fs_stats(3)</a>
295	tdb	1.21	</li>
296			<li>
297	tdb	1.24	<a href="sg_get_host_info.html">sg_get_host_info(3)</a>
298	tdb	1.21	</li>
299			<li>
300	tdb	1.24	<a href="sg_get_load_stats.html">sg_get_load_stats(3)</a>
301	tdb	1.21	</li>
302			<li>
303	tdb	1.24	<a href="sg_get_mem_stats.html">sg_get_mem_stats(3)</a>
304	tdb	1.21	</li>
305			<li>
306	tdb	1.24	<a href="sg_get_network_iface_stats.html">sg_get_network_iface_stats(3)</a>
307	tdb	1.21	</li>
308			<li>
309	tdb	1.24	<a href="sg_get_network_io_stats.html">sg_get_network_io_stats(3)</a>
310	tdb	1.21	</li>
311			<li>
312	tdb	1.24	<a href="sg_get_page_stats.html">sg_get_page_stats(3)</a>
313	tdb	1.21	</li>
314			<li>
315	tdb	1.24	<a href="sg_get_process_stats.html">sg_get_process_stats(3)</a>
316	tdb	1.21	</li>
317			<li>
318	tdb	1.24	<a href="sg_get_user_stats.html">sg_get_user_stats(3)</a>
319	tdb	1.21	</li>
320			</ul>
321			<h2>
322			<a id="screenshot">Screenshot</a>
323			</h2>
324			<p>
325			Here's what saidar looks like when it's running:
326			</p>
327			<p>
328			<img src="saidar.png" alt="saidar screenshot" />
329			</p>
330			</div>
331	tdb	1.19	<!--#include virtual="/footer.inc" -->
332	tdb	1.21	</div>
333	tdb	1.19	<!--#include virtual="/menu.inc" -->
334	tdb	1.21	</div>
335			</body>
336	tdb	1.1	</html>