ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/projects/libstatgrab/PLATFORMS
Revision: 1.5
Committed: Tue Mar 9 12:24:40 2004 UTC (20 years, 7 months ago) by tdb
Branch: MAIN
Changes since 1.4: +46 -1 lines
Log Message:
Add platform specific notes (particularly on required privileges) to
the PLATFORMS file.

File Contents

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