Files
heimdal/doc/intro.texi
Johan Danielsson 01815d6fa0 Some updates.
git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@2889 ec53bebd-3082-4978-b11e-865c3cabbd6b
1997-08-10 22:20:08 +00:00

89 lines
2.7 KiB
Plaintext

@node Introduction, Tutorial, 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 kerberosV5 over GSS-API
@item
include the most important and useful application programs (rsh, telnet,
popper, etc.)
@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
some simple test programs
@item
a KDC that supports most things, not including cross-realm and
user-to-user
@item
an incredibly simple @file{kdb_edit}
@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.