README
1Krb5 provides an object oriented interface to the most commonly used
2functions included in the Kerberos 5 API. It was developed and tested
3using Perl 5.005_03 and MIT Kerberos 5 version 1.0.5 and 1.1.1.
4
5NOTE: This module is very out of date, though it should still work with recent
6Kerberos 5 libraries. Version 2.0 will be a well deserved, complete rewrite.
7Following version 1.9, only bug fixes will be released for the 1.x series.
8
9Your comments and bug reports are welcome. Please send them to me at
10jeff@smashing.org.
11
12
13REQUIREMENTS
14------------
15o Perl 5.004_04 or later (may work with 5.003).
16o Build, test and install MIT Kerberos 5 version 1.0.5 or later.
17
18
19BUILDING & INSTALLATION
20-----------------------
21Krb5 is built and installed in the usual Perl module fashion:
22
231) edit Makefile.PL and change the variables in the top section according
24 to your Kerberos 5 configuration.
252) perl Makefile.PL
263) make
274) make test (not implemented yet)
285) make install
29
30
31DOCUMENTATION
32-------------
33'make' should create man pages for Krb5 which will be installed upon a
34'make install'. Perl POD documentation is supplied in Krb5.pm, which can
35be viewed by typing 'perldoc Krb5'.
36
37Take a look at the sample and simple clients and servers for some
38practical examples.
39
40NOTE: The documentation assumes familiarity with Kerberos 5 and Kerberos
41programming. Please see the Kerberos documentation for gory details.
42
43
44BUGS & PROBLEMS
45---------------
46o The contents of a new Krb5::Address object needs to be converted to
47 network byte order before being passed to Krb5::Address->new().
48 If this is not done, many functions like mk_priv and rd_priv will fail
49 on little-endian platforms. I will try to make this automatic in a
50 future version.
51
52
53ACKNOWLEDGEMENTS
54----------------
55Thanks to Doug MacEachern for handing off this module to me, although I'm
56sure he was glad to get it off his back!
57
58Valuable code contributions from Scott Hutton (shutton@indiana.edu).
59
60