ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/web/www/libstatgrab/index.xhtml
Revision: 1.32
Committed: Fri Nov 12 15:10:29 2004 UTC (19 years, 11 months ago) by tdb
Branch: MAIN
Changes since 1.31: +2 -2 lines
Log Message:
Add HP-UX to list of OSs we support.

File Contents

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