crypto/external/bsd/heimdal/dist/doc/intro.texi

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