Copyright (c) 1998 Jeff Horwitz (jhorwitz@umich.edu). All rights reserved. This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. WARNING! THIS IS ALPHA SOFTWARE AND MAY NOT FUNCTION CORRECTLY ON ALL PLATFORMS. BOTH THE MODULE NAMESPACE AND THE API ARE SUBJECT TO CHANGE. Krb5 provides an object oriented interface to the most commonly used functions included in the Kerberos 5 API. It was developed and tested using Perl 5.004_04 and MIT Kerberos 5 version 1.0.5. Your comments and bug reports are welcome. Please send them to me at jhorwitz@umich.edu. REQUIREMENTS ------------ o Perl 5.004_04 or later (may work with 5.003). o Build, test and install MIT Kerberos 5 version 1.0.5 or later. BUILDING & INSTALLATION ----------------------- Krb5 is built and installed in the usual Perl module fashion: 1) edit Makefile.PL and change LIBS and INC to reflect the correct paths to your Kerberos libraries and include files. 2) perl Makefile.PL 3) make 4) make test (not implemented yet) 5) make install DOCUMENTATION ------------- 'make' should create man pages for Krb5 which will be installed upon a 'make install'. Perl POD documentation is supplied in Krb5.pm, which can be viewed by typing 'perldoc Krb5'. Take a look at the sample and simple clients and servers for some practical examples. NOTE: The documentation assumes familiarity with Kerberos 5 and Kerberos programming. Please see the Kerberos documentation for gory details. BUGS & PROBLEMS --------------- o The contents of a new Krb5::Address object needs to be converted to network byte order before being passed to Krb5::Address->new(). If this is not done, many functions like mk_priv and rd_priv will fail on little-endian platforms. I will try to make this automatic in a future version. ACKNOWLEDGEMENTS ---------------- Thanks to Doug MacEachern for handing off this module to me, although I'm sure he was glad to get it off his back! Valuable code contributions from Scott Hutton (shutton@indiana.edu).