ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/projects/libstatgrab/PLATFORMS
Revision: 1.8
Committed: Sun Jul 18 20:21:20 2004 UTC (19 years, 9 months ago) by tdb
Branch: MAIN
CVS Tags: LIBSTATGRAB_0_10_3, LIBSTATGRAB_0_10_2, LIBSTATGRAB_0_10_1
Changes since 1.7: +6 -6 lines
Log Message:
Catch a few bits of documentation/comments containing the deprecated
function names.

File Contents

# User Rev Content
1 tdb 1.5 libstatgrab PLATFORMS
2     http://www.i-scream.org/libstatgrab/
3    
4 tdb 1.8 $Id: PLATFORMS,v 1.7 2004/04/06 14:21:26 tdb Exp $
5 tdb 1.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.7 DragonFly BSD 1.x
13     FreeBSD 4.x
14     FreeBSD 5.x
15 tdb 1.1 Linux 2.2
16     Linux 2.4
17     Linux 2.6
18 tdb 1.7 NetBSD 1.x
19     NetBSD 2.x
20     OpenBSD 3.x
21 tdb 1.2 Solaris 2.6
22 tdb 1.1 Solaris 2.7
23 tdb 1.4 Solaris 2.8 (sparc & x86)
24     Solaris 2.9 (sparc & x86)
25 tdb 1.5
26     Platform Specific Notes
27     =======================
28    
29 tdb 1.6 Unless explicitly mentioned below assume that libstatgrab will run on
30     any of the platforms above without any elevated privileges.
31    
32 tdb 1.5 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 tdb 1.8 Also note that this cannot be solved by calling sg_init and then
40     sg_drop_privileges at this stage.
41 tdb 1.5
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 tdb 1.8 sg_init, and then drop the privileges using sg_drop_privileges.
48 tdb 1.5
49 tdb 1.8 The sg_get_swap_stats function will return NULL if this hasn't been done.
50 tdb 1.5
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 tdb 1.8 It is sufficient to use sg_init and sg_drop_privileges.
59 tdb 1.5
60     Cygwin
61     ------
62 tdb 1.6
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 tdb 1.5
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