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