intro.texi revision 233294 
1247606Spjd@c $Id$
2247606Spjd
3247606Spjd@node Introduction, What is Kerberos?, Top, Top
4247606Spjd@c @node Introduction, What is Kerberos?, Top, Top
5247606Spjd@comment  node-name,  next,  previous,  up
6247606Spjd@chapter Introduction
7247606Spjd
8247606Spjd@heading What is Heimdal?
9247606Spjd
10247606SpjdHeimdal is a free implementation of Kerberos 5. The goals are to:
11247606Spjd
12247606Spjd@itemize @bullet
13247606Spjd@item
14247606Spjdhave an implementation that can be freely used by anyone
15247606Spjd@item
16247606Spjdbe protocol compatible with existing implementations and, if not in
17247606Spjdconflict, with RFC 4120 (and any future updated RFC). RFC 4120
18247606Spjdreplaced RFC 1510.
19247606Spjd@item
20247606Spjdbe reasonably compatible with the M.I.T Kerberos V5 API
21247606Spjd@item
22247606Spjdhave support for Kerberos V5 over GSS-API (RFC1964)
23247606Spjd@item
24247606Spjdinclude the most important and useful application programs (rsh, telnet,
25247606Spjdpopper, etc.)
26247606Spjd@item
27247606Spjdinclude enough backwards compatibility with Kerberos V4
28247606Spjd@end itemize
29
30@heading Status
31
32Heimdal has the following features (this does not mean any of this
33works):
34
35@itemize @bullet
36@item
37a stub generator and a library to encode/decode/whatever ASN.1/DER
38stuff
39@item
40a @code{libkrb5} library that should be possible to get to work with
41simple applications
42@item
43a GSS-API library
44@item
45@file{kinit}, @file{klist}, @file{kdestroy}
46@item
47@file{telnet}, @file{telnetd}
48@item
49@file{rsh}, @file{rshd}
50@item
51@file{popper}, @file{push} (a movemail equivalent)
52@item
53@file{ftp}, and @file{ftpd}
54@item
55a library @file{libkafs} for authenticating to AFS and a program
56@file{afslog} that uses it
57@item
58some simple test programs
59@item
60a KDC that supports most things; optionally, it may also support
61Kerberos V4 and kaserver,
62@item
63simple programs for distributing databases between a KDC master and
64slaves
65@item
66a password changing daemon @file{kpasswdd}, library functions for
67changing passwords and a simple client
68@item
69some kind of administration system
70@item
71Kerberos V4 support in many of the applications.
72@end itemize
73
74@heading Bug reports
75
76If you find bugs in this software, make sure it is a genuine bug and not
77just a part of the code that isn't implemented.
78
79Bug reports should be sent to @email{heimdal-bugs@@h5l.org}. Please
80include information on what machine and operating system (including
81version) you are running, what you are trying to do, what happens, what
82you think should have happened, an example for us to repeat, the output
83you get when trying the example, and a patch for the problem if you have
84one. Please make any patches with @code{diff -u} or @code{diff -c}.
85
86Suggestions, comments and other non bug reports are also welcome.
87
88@heading Mailing list
89
90There are two mailing lists with talk about
91Heimdal. @email{heimdal-announce@@sics.se} is a low-volume announcement
92list, while @email{heimdal-discuss@@sics.se} is for general discussion.
93Send a message to @email{majordomo@@sics.se} to subscribe.
94
95@heading Heimdal source code, binaries and the manual
96
97The source code for heimdal, links to binaries and the manual (this
98document) can be found on our web-page at
99@url{http://www.pdc.kth.se/heimdal/}.
100