README
1GSSAPI Perlbindings version 0.28
2=================================
3GSSAPI - Perl extension for using
4GSSAPI C-Bindings as described in RFC 2744.
5
6The module is based on GSSAPI 0.13 written by Philip Guenther
7
8Testing and development was done against
9
10- heimdal 0.6.2
11- heimdal 0.7.1
12- heimdal 1.0.1
13- heimdal 1.3.2
14- MIT Kerberos 5 release 1.5.2
15- MIT Kerberos 5 release 1.4.3
16- MIT Kerberos 5 release 1.3.1
17- MIT Kerberos 5 release 1.2.7
18- MIT Kerberos 5 release 1.6.3
19- VAS 3.0.1
20- Solaris 10 / Opensolaris native gss library
21
22see t/test.t for tests that do not work on Heimdal.
23
24Please let me know if there are buildingproblems with your
25Kerberossoftware.
26
27
28DEPENDENCIES
29
30This module requires these other modules and libraries:
31
32 An installed Version of GSS-API bindings, e.g
33
34 MIT Kerberos <http://web.mit.edu/kerberos/www/>
35 Heimdal <http://www.pdc.kth.se/heimdal/>
36 VAS <http://www.quest.com/>
37
38This GSSAPI-implementations ship with a command called 'krb5-config'.
39Make sure the krb5-config command is present and executeable,
40Makefile.PL needs it to detect the library configuration.
41
42OS specific notes:
43
44- Windows - MIT KfW SDK:
45
46 This SDK does not provide the krb5-config command,
47 <http://www.mail-archive.com/kerberos%40mit.edu/msg12808.html>.
48 Instead of using krb5-config you need to specifiy the compiler and linker flags
49 on the perl Makefile.PL commandline. run
50 perl Makefile.PL --help
51 to see all available configuration options.
52
53- NetBSD:
54
55 since 2006-01-26 krb5-config is present
56 in pkgsrc/security/heimdal, see
57 <http://mail-index.netbsd.org/pkgsrc-changes/2006/01/26/0036.html
58
59
60INSTALLATION
61
62
63To install this module type the following:
64
65 perl Makefile.PL
66 make
67 make test
68 make install
69
70run
71 perl Makefile.PL -help
72
73to see further install options
74
75PLATFORMS
76
77Building the module was tested on
78
79-Linux (Gentoo, Ubuntu, Suse, Fedora, RHEL)
80-FreeBSD
81-cygwin
82-Solaris
83
84Please let my know if your Platform needs support.
85
86AUTHOR:
87
88GSSAPI.pm is originally written by Philip Guenther.
89
90Maintanance by
91Achim Grolms <perl@grolmsnet.de>,
92
93with help from
94
95-Leif Johansson
96-Merijn Broeren
97
98<http://perlgssapi.sourceforge.net/>
99
100
101COPYRIGHT AND LICENCE
102
103
104Copyright (C) 2006, 2007 by Achim Grolms perl@grolmsnet.de
105
106This library is free software; you can redistribute it and/or modify
107it under the same terms as Perl itself, either Perl version 5.8.4 or,
108at your option, any later version of Perl 5 you may have available.
109