1 |
< |
# $Id$ |
1 |
> |
libstatgrab PLATFORMS |
2 |
> |
http://www.i-scream.org/libstatgrab/ |
3 |
|
|
4 |
+ |
$Id$ |
5 |
+ |
|
6 |
+ |
Supported Platforms |
7 |
+ |
=================== |
8 |
+ |
|
9 |
|
libstatgrab has been tested to work on the following platforms: |
10 |
|
|
11 |
|
Cygwin ?.? |
12 |
+ |
DragonFly BSD 1.0 |
13 |
|
FreeBSD 4 |
14 |
|
FreeBSD 5 |
15 |
|
Linux 2.2 |
16 |
|
Linux 2.4 |
17 |
|
Linux 2.6 |
18 |
|
NetBSD 1.6 |
19 |
+ |
OpenBSD 3.3 |
20 |
+ |
Solaris 2.6 |
21 |
|
Solaris 2.7 |
22 |
< |
Solaris 2.8 |
23 |
< |
Solaris 2.9 |
22 |
> |
Solaris 2.8 (sparc & x86) |
23 |
> |
Solaris 2.9 (sparc & x86) |
24 |
> |
|
25 |
> |
Platform Specific Notes |
26 |
> |
======================= |
27 |
> |
|
28 |
> |
Unless explicitly mentioned below assume that libstatgrab will run on |
29 |
> |
any of the platforms above without any elevated privileges. |
30 |
> |
|
31 |
> |
Linux |
32 |
> |
----- |
33 |
> |
|
34 |
> |
On Linux root privileges are required to get the statistics returned |
35 |
> |
by the get_network_iface_stats function. Not having these privileges |
36 |
> |
results in NULL being returned. |
37 |
> |
|
38 |
> |
Also note that this cannot be solved by calling statgrab_init and then |
39 |
> |
statgrab_drop_privileges at this stage. |
40 |
> |
|
41 |
> |
FreeBSD 4 |
42 |
> |
--------- |
43 |
> |
|
44 |
> |
On FreeBSD 4 (not on 5) programs need to be setgid kmem to get swap |
45 |
> |
statistics. It is sufficient to give a program these privileges, call |
46 |
> |
statgrab_init, and then drop the privileges using statgrab_drop_privileges. |
47 |
> |
|
48 |
> |
The get_swap_stats function will return NULL if this hasn't been done. |
49 |
> |
|
50 |
> |
Solaris 2.6/2.7 |
51 |
> |
--------------- |
52 |
> |
|
53 |
> |
On Solaris 2.6 and 2.7 root privileges are required to build the drive |
54 |
> |
mapping list (eg. mapping ssd0 on to c0t0d0s0). If these privileges |
55 |
> |
aren't available the names will be left as ssd0, for example. |
56 |
> |
|
57 |
> |
It is sufficient to use statgrab_init and statgrab_drop_privileges. |
58 |
> |
|
59 |
> |
Cygwin |
60 |
> |
------ |
61 |
> |
|
62 |
> |
Full support for libstatgrab isn't yet provided on cygwin - there are |
63 |
> |
some stats which we just can't get. In these cases the functions will |
64 |
> |
return NULL to indicate failure. |
65 |
> |
|
66 |
> |
If you have installed libncurses-devel but the configure script can't |
67 |
> |
find ncurses.h, you've most likely hit a bug in the cygwin package. To |
68 |
> |
fix this run: /etc/postinstall/libncurses-devel.sh.done |
69 |
> |
|