Files
heimdal/doc/intro.texi
Assar Westerlund b15cbefc25 documentation update
git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@3338 ec53bebd-3082-4978-b11e-865c3cabbd6b
1997-09-01 23:59:28 +00:00

103 lines
3.2 KiB
Plaintext

@node Introduction, What is Kerberos?, Top, Top
@c @node Introduction, What is Kerberos?, Top, Top
@comment node-name, next, previous, up
@chapter Introduction
@quotation
@strong{Caution:} this is alpha quality software. If something doesn't
work, it's probably because it doesn't. Don't be surprised if your
computer suffers a melt-down.
@end quotation
@heading What is Heimdal?
Heimdal is a free implementation of Kerberos 5. The goals are to:
@itemize @bullet
@item
have an implementation that can be freely used outside of the United
States
@item
be protocol compatible with existing implementations and, if not in
conflict, with RFC 1510 (and any future updated RFC)
@item
be somewhat compatible with the M.I.T Kerberos V5 API
@item
have support for Kerberos V5 over GSS-API
@item
include the most important and useful application programs (rsh, telnet,
popper, etc.)
@item
include enough backwards compatibility with Kerberos V4
@end itemize
This initial pre-version is mostly compatible with the M.I.T
implementation, as well as DCE secd. The library is at least not totally
different from the M.I.T @code{libkrb5}.
@heading Status
Heimdal has the following features (this does not mean any of this
works):
@itemize @bullet
@item
there is a stub generator and a library to encode/decode/whatever ASN.1/DER
stuff
@item
a @code{libkrb5} library that should be possible to get to work with
simple applications
@item
a GSS-API library that doesn't have all functions implemented but should
have all the important ones for building applications that use it
@item
Eric Young's @file{libdes}
@item
@file{kinit}, @file{klist}, @file{kdestroy}
@item
@file{telnet}, @file{telnetd}
@item
@file{rsh}, @file{rshd}
@item
@file{popper}, @file{push} (a movemail equivalent)
@item
a library @file{libkafs} for authenticating to AFS and a program
@file{afslog} that uses it
@item
some simple test programs
@item
a KDC that supports most things, not including cross-realm and
user-to-user, optionally, it may also support Kerberos V4 and kaserver,
@item
simple programs for distributing databases between a KDC master and
slaves
@item
a password changing daemon @file{kpasswdd}, library functions for
changing passwords and a simple client
@item
an incredibly simple @file{kdb_edit}
@item
all applications can also support the Kerberos V4 protocols
@end itemize
@heading Bug reports
If you find bugs in this software, make sure it is a genuine bug and not
just a part of the code that isn't implemented.
Bug reports should be sent to @email{heimdal-bugs@@pdc.kth.se}. Please
include information on what machine and operating system (including
version) you are running, what you are trying to do, what happens, what
you think should have happened, an example for us to repeat, the output
you get when trying the example, and a patch for the problem if you have
one. Please make any patches with @code{diff -u} or @code{diff -c}.
Suggestions, comments and other non bug reports are also welcome.
@heading Mailing list
There are two mailing lists with talk about
Heimdal. @email{heimdal-announce@@sics.se} is a low-volume announcement
list, while @email{heimdal-discuss@@sics.se} is for general discussion.
Send a message to @email{majordomo@@sics.se} to subscribe.