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
5Your comments and bug reports are welcome. Please send them to me at
6jeff@smashing.org.
7
8
9REQUIREMENTS
10------------
11o Perl 5.004_04 or later (may work with 5.003).
12o Build, test and install MIT Kerberos 5 version 1.0.5 or later.
13
14
15BUILDING & INSTALLATION
16-----------------------
17Krb5 is built and installed in the usual Perl module fashion:
18
191) edit Makefile.PL and change the variables in the top section according
20 to your Kerberos 5 configuration.
212) perl Makefile.PL
223) make
234) make test (not implemented yet)
245) make install
25
26
27DOCUMENTATION
28-------------
29'make' should create man pages for Krb5 which will be installed upon a
30'make install'. Perl POD documentation is supplied in Krb5.pm, which can
31be viewed by typing 'perldoc Krb5'.
32
33Take a look at the sample and simple clients and servers for some
34practical examples.
35
36NOTE: The documentation assumes familiarity with Kerberos 5 and Kerberos
37programming. Please see the Kerberos documentation for gory details.
38
39
40BUGS & PROBLEMS
41---------------
42o The contents of a new Krb5::Address object needs to be converted to
43 network byte order before being passed to Krb5::Address->new().
44 If this is not done, many functions like mk_priv and rd_priv will fail
45 on little-endian platforms. I will try to make this automatic in a
46 future version.
47
48
49ACKNOWLEDGEMENTS
50----------------
51Thanks to Doug MacEachern for handing off this module to me, although I'm
52sure he was glad to get it off his back!
53
54Valuable code contributions from Scott Hutton (shutton@indiana.edu).
55
56