--- projects/libstatgrab/PLATFORMS	2004/02/12 23:04:51	1.3
+++ projects/libstatgrab/PLATFORMS	2004/03/09 12:34:41	1.6
@@ -1,8 +1,15 @@
-# $Id: PLATFORMS,v 1.3 2004/02/12 23:04:51 tdb Exp $
+libstatgrab PLATFORMS
+http://www.i-scream.org/libstatgrab/
 
+$Id: PLATFORMS,v 1.6 2004/03/09 12:34:41 tdb Exp $
+
+Supported Platforms
+===================
+
 libstatgrab has been tested to work on the following platforms:
 
 Cygwin ?.?
+DragonFly BSD 1.0
 FreeBSD 4
 FreeBSD 5
 Linux 2.2
@@ -12,5 +19,51 @@ NetBSD 1.6
 OpenBSD 3.3
 Solaris 2.6
 Solaris 2.7
-Solaris 2.8
-Solaris 2.9
+Solaris 2.8 (sparc & x86)
+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
+-----
+
+On Linux root privileges are required to get the statistics returned
+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.
+
+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.
+
+The get_swap_stats function will return NULL if this hasn't been done.
+
+Solaris 2.6/2.7
+---------------
+
+On Solaris 2.6 and 2.7 root privileges are required to build the drive
+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.
+
+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
+fix this run: /etc/postinstall/libncurses-devel.sh.done
+