--- projects/libstatgrab/PLATFORMS	2004/02/16 14:55:32	1.4
+++ projects/libstatgrab/PLATFORMS	2004/03/09 12:24:40	1.5
@@ -1,5 +1,11 @@
-# $Id: PLATFORMS,v 1.4 2004/02/16 14:55:32 tdb Exp $
+libstatgrab PLATFORMS
+http://www.i-scream.org/libstatgrab/
 
+$Id: PLATFORMS,v 1.5 2004/03/09 12:24:40 tdb Exp $
+
+Supported Platforms
+===================
+
 libstatgrab has been tested to work on the following platforms:
 
 Cygwin ?.?
@@ -15,3 +21,42 @@ Solaris 2.6
 Solaris 2.7
 Solaris 2.8 (sparc & x86)
 Solaris 2.9 (sparc & x86)
+
+Platform Specific Notes
+=======================
+
+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
+------
+
+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
+