xref: /minix3/crypto/external/bsd/heimdal/dist/doc/intro.texi (revision 0a6a1f1d05b60e214de2f05a7310ddd1f0e590e7)
1ebfedea0SLionel Sambuc@c Id
2*0a6a1f1dSLionel Sambuc@c $NetBSD: intro.texi,v 1.1.1.3 2014/04/24 12:45:26 pettai Exp $
3ebfedea0SLionel Sambuc
4ebfedea0SLionel Sambuc@node Introduction, What is Kerberos?, Top, Top
5ebfedea0SLionel Sambuc@c @node Introduction, What is Kerberos?, Top, Top
6ebfedea0SLionel Sambuc@comment  node-name,  next,  previous,  up
7ebfedea0SLionel Sambuc@chapter Introduction
8ebfedea0SLionel Sambuc
9ebfedea0SLionel Sambuc@heading What is Heimdal?
10ebfedea0SLionel Sambuc
11ebfedea0SLionel SambucHeimdal is a free implementation of Kerberos 5. The goals are to:
12ebfedea0SLionel Sambuc
13ebfedea0SLionel Sambuc@itemize @bullet
14ebfedea0SLionel Sambuc@item
15ebfedea0SLionel Sambuchave an implementation that can be freely used by anyone
16ebfedea0SLionel Sambuc@item
17ebfedea0SLionel Sambucbe protocol compatible with existing implementations and, if not in
18ebfedea0SLionel Sambucconflict, with RFC 4120 (and any future updated RFC). RFC 4120
19ebfedea0SLionel Sambucreplaced RFC 1510.
20ebfedea0SLionel Sambuc@item
21ebfedea0SLionel Sambucbe reasonably compatible with the M.I.T Kerberos V5 API
22ebfedea0SLionel Sambuc@item
23ebfedea0SLionel Sambuchave support for Kerberos V5 over GSS-API (RFC1964)
24ebfedea0SLionel Sambuc@item
25ebfedea0SLionel Sambucinclude the most important and useful application programs (rsh, telnet,
26ebfedea0SLionel Sambucpopper, etc.)
27ebfedea0SLionel Sambuc@item
28ebfedea0SLionel Sambucinclude enough backwards compatibility with Kerberos V4
29ebfedea0SLionel Sambuc@end itemize
30ebfedea0SLionel Sambuc
31ebfedea0SLionel Sambuc@heading Status
32ebfedea0SLionel Sambuc
33ebfedea0SLionel SambucHeimdal has the following features (this does not mean any of this
34ebfedea0SLionel Sambucworks):
35ebfedea0SLionel Sambuc
36ebfedea0SLionel Sambuc@itemize @bullet
37ebfedea0SLionel Sambuc@item
38ebfedea0SLionel Sambuca stub generator and a library to encode/decode/whatever ASN.1/DER
39ebfedea0SLionel Sambucstuff
40ebfedea0SLionel Sambuc@item
41ebfedea0SLionel Sambuca @code{libkrb5} library that should be possible to get to work with
42ebfedea0SLionel Sambucsimple applications
43ebfedea0SLionel Sambuc@item
44ebfedea0SLionel Sambuca GSS-API library
45ebfedea0SLionel Sambuc@item
46ebfedea0SLionel Sambuc@file{kinit}, @file{klist}, @file{kdestroy}
47ebfedea0SLionel Sambuc@item
48ebfedea0SLionel Sambuc@file{telnet}, @file{telnetd}
49ebfedea0SLionel Sambuc@item
50ebfedea0SLionel Sambuc@file{rsh}, @file{rshd}
51ebfedea0SLionel Sambuc@item
52ebfedea0SLionel Sambuc@file{popper}, @file{push} (a movemail equivalent)
53ebfedea0SLionel Sambuc@item
54ebfedea0SLionel Sambuc@file{ftp}, and @file{ftpd}
55ebfedea0SLionel Sambuc@item
56ebfedea0SLionel Sambuca library @file{libkafs} for authenticating to AFS and a program
57ebfedea0SLionel Sambuc@file{afslog} that uses it
58ebfedea0SLionel Sambuc@item
59ebfedea0SLionel Sambucsome simple test programs
60ebfedea0SLionel Sambuc@item
61*0a6a1f1dSLionel Sambuca KDC that supports most things,
62ebfedea0SLionel Sambuc@item
63ebfedea0SLionel Sambucsimple programs for distributing databases between a KDC master and
64ebfedea0SLionel Sambucslaves
65ebfedea0SLionel Sambuc@item
66ebfedea0SLionel Sambuca password changing daemon @file{kpasswdd}, library functions for
67ebfedea0SLionel Sambucchanging passwords and a simple client
68ebfedea0SLionel Sambuc@item
69ebfedea0SLionel Sambucsome kind of administration system
70ebfedea0SLionel Sambuc@item
71ebfedea0SLionel SambucKerberos V4 support in many of the applications.
72ebfedea0SLionel Sambuc@end itemize
73ebfedea0SLionel Sambuc
74ebfedea0SLionel Sambuc@heading Bug reports
75ebfedea0SLionel Sambuc
76ebfedea0SLionel SambucIf you find bugs in this software, make sure it is a genuine bug and not
77ebfedea0SLionel Sambucjust a part of the code that isn't implemented.
78ebfedea0SLionel Sambuc
79ebfedea0SLionel SambucBug reports should be sent to @email{heimdal-bugs@@h5l.org}. Please
80ebfedea0SLionel Sambucinclude information on what machine and operating system (including
81ebfedea0SLionel Sambucversion) you are running, what you are trying to do, what happens, what
82ebfedea0SLionel Sambucyou think should have happened, an example for us to repeat, the output
83ebfedea0SLionel Sambucyou get when trying the example, and a patch for the problem if you have
84ebfedea0SLionel Sambucone. Please make any patches with @code{diff -u} or @code{diff -c}.
85ebfedea0SLionel Sambuc
86ebfedea0SLionel SambucSuggestions, comments and other non bug reports are also welcome.
87ebfedea0SLionel Sambuc
88ebfedea0SLionel Sambuc@heading Mailing list
89ebfedea0SLionel Sambuc
90ebfedea0SLionel SambucThere are two mailing lists with talk about
91ebfedea0SLionel SambucHeimdal. @email{heimdal-announce@@sics.se} is a low-volume announcement
92ebfedea0SLionel Sambuclist, while @email{heimdal-discuss@@sics.se} is for general discussion.
93ebfedea0SLionel SambucSend a message to @email{majordomo@@sics.se} to subscribe.
94ebfedea0SLionel Sambuc
95ebfedea0SLionel Sambuc@heading Heimdal source code, binaries and the manual
96ebfedea0SLionel Sambuc
97ebfedea0SLionel SambucThe source code for heimdal, links to binaries and the manual (this
98ebfedea0SLionel Sambucdocument) can be found on our web-page at
99ebfedea0SLionel Sambuc@url{http://www.pdc.kth.se/heimdal/}.
100