--- projects/libstatgrab/PLATFORMS 2004/03/09 12:24:40 1.5 +++ projects/libstatgrab/PLATFORMS 2004/11/01 18:30:16 1.9 @@ -1,7 +1,7 @@ libstatgrab PLATFORMS http://www.i-scream.org/libstatgrab/ -$Id: PLATFORMS,v 1.5 2004/03/09 12:24:40 tdb Exp $ +$Id: PLATFORMS,v 1.9 2004/11/01 18:30:16 tdb Exp $ Supported Platforms =================== @@ -9,14 +9,16 @@ Supported Platforms libstatgrab has been tested to work on the following platforms: Cygwin ?.? -DragonFly BSD 1.0 -FreeBSD 4 -FreeBSD 5 +DragonFly BSD 1.x +FreeBSD 4.x +FreeBSD 5.x +HP-UX 11.11 (parisc) Linux 2.2 Linux 2.4 Linux 2.6 -NetBSD 1.6 -OpenBSD 3.3 +NetBSD 1.x +NetBSD 2.x +OpenBSD 3.x Solaris 2.6 Solaris 2.7 Solaris 2.8 (sparc & x86) @@ -25,6 +27,9 @@ Solaris 2.9 (sparc & x86) Platform Specific Notes ======================= +Unless explicitly mentioned below assume that libstatgrab will run on +any of the platforms above without any elevated privileges. + Linux ----- @@ -32,17 +37,17 @@ On Linux root privileges are required to get the stati by the get_network_iface_stats function. Not having these privileges results in NULL being returned. -Also note that this cannot be solved by calling statgrab_init and then -statgrab_drop_privileges at this stage. +Also note that this cannot be solved by calling sg_init and then +sg_drop_privileges at this stage. FreeBSD 4 --------- On FreeBSD 4 (not on 5) programs need to be setgid kmem to get swap statistics. It is sufficient to give a program these privileges, call -statgrab_init, and then drop the privileges using statgrab_drop_privileges. +sg_init, and then drop the privileges using sg_drop_privileges. -The get_swap_stats function will return NULL if this hasn't been done. +The sg_get_swap_stats function will return NULL if this hasn't been done. Solaris 2.6/2.7 --------------- @@ -51,10 +56,14 @@ On Solaris 2.6 and 2.7 root privileges are required to mapping list (eg. mapping ssd0 on to c0t0d0s0). If these privileges aren't available the names will be left as ssd0, for example. -It is sufficient to use statgrab_init and statgrab_drop_privileges. +It is sufficient to use sg_init and sg_drop_privileges. Cygwin ------ + +Full support for libstatgrab isn't yet provided on cygwin - there are +some stats which we just can't get. In these cases the functions will +return NULL to indicate failure. If you have installed libncurses-devel but the configure script can't find ncurses.h, you've most likely hit a bug in the cygwin package. To