r18022@luminous: jaltman | 2006-05-19 05:18:37 -0400
[krb5.git] / README
1                    Kerberos Version 5, Release 1.5
2
3                             Release Notes
4                         The MIT Kerberos Team
5
6 Unpacking the Source Distribution
7 ---------------------------------
8
9 The source distribution of Kerberos 5 comes in a gzipped tarfile,
10 krb5-1.5.tar.gz.  Instructions on how to extract the entire
11 distribution follow.
12
13 If you have the GNU tar program and gzip installed, you can simply do:
14
15         gtar zxpf krb5-1.5.tar.gz
16
17 If you don't have GNU tar, you will need to get the FSF gzip
18 distribution and use gzcat:
19
20         gzcat krb5-1.5.tar.gz | tar xpf -
21
22 Both of these methods will extract the sources into krb5-1.5/src and
23 the documentation into krb5-1.5/doc.
24
25 Building and Installing Kerberos 5
26 ----------------------------------
27
28 The first file you should look at is doc/install-guide.ps; it contains
29 the notes for building and installing Kerberos 5.  The info file
30 krb5-install.info has the same information in info file format.  You
31 can view this using the GNU emacs info-mode, or by using the
32 standalone info file viewer from the Free Software Foundation.  This
33 is also available as an HTML file, install.html.
34
35 Other good files to look at are admin-guide.ps and user-guide.ps,
36 which contain the system administrator's guide, and the user's guide,
37 respectively.  They are also available as info files
38 kerberos-admin.info and krb5-user.info, respectively.  These files are
39 also available as HTML files.
40
41 If you are attempting to build under Windows, please see the
42 src/windows/README file.
43
44 Reporting Bugs
45 --------------
46
47 Please report any problems/bugs/comments using the krb5-send-pr
48 program.  The krb5-send-pr program will be installed in the sbin
49 directory once you have successfully compiled and installed Kerberos
50 V5 (or if you have installed one of our binary distributions).
51
52 If you are not able to use krb5-send-pr because you haven't been able
53 compile and install Kerberos V5 on any platform, you may send mail to
54 krb5-bugs@mit.edu.
55
56 You may view bug reports by visiting
57
58 http://krbdev.mit.edu/rt/
59
60 and logging in as "guest" with password "guest".
61
62 Major changes in 1.5
63 ----------------------
64
65 Merged to the trunk and included in this alpha release:
66
67 * plug-in architecture (in-progress)
68
69 Not yet merged to the trunk, thus not included in this alpha release:
70
71 * LDAP plug-in for KDB
72
73 * multi-mechanism GSS-API implementation
74
75 * SPNEGO implementation
76
77 Minor changes in 1.5
78 ----------------------
79
80 For a list of bugs fixed in krb5-1.5, please consult
81
82 http://krbdev.mit.edu/rt/NoAuth/krb5-1.5/fixed-1.5.html
83
84 Copyright Notice and Legal Administrivia
85 ----------------------------------------
86
87 Copyright (C) 1985-2006 by the Massachusetts Institute of Technology.
88
89 All rights reserved.
90
91 Export of this software from the United States of America may require
92 a specific license from the United States Government.  It is the
93 responsibility of any person or organization contemplating export to
94 obtain such a license before exporting.
95
96 WITHIN THAT CONSTRAINT, permission to use, copy, modify, and
97 distribute this software and its documentation for any purpose and
98 without fee is hereby granted, provided that the above copyright
99 notice appear in all copies and that both that copyright notice and
100 this permission notice appear in supporting documentation, and that
101 the name of M.I.T. not be used in advertising or publicity pertaining
102 to distribution of the software without specific, written prior
103 permission.  Furthermore if you modify this software you must label
104 your software as modified software and not distribute it in such a
105 fashion that it might be confused with the original MIT software.
106 M.I.T. makes no representations about the suitability of this software
107 for any purpose.  It is provided "as is" without express or implied
108 warranty.
109
110 THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
111 IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
112 WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
113
114 Individual source code files are copyright MIT, Cygnus Support,
115 OpenVision, Oracle, Sun Soft, FundsXpress, and others.
116
117 Project Athena, Athena, Athena MUSE, Discuss, Hesiod, Kerberos, Moira,
118 and Zephyr are trademarks of the Massachusetts Institute of Technology
119 (MIT).  No commercial use of these trademarks may be made without
120 prior written permission of MIT.
121
122 "Commercial use" means use of a name in a product or other for-profit
123 manner.  It does NOT prevent a commercial firm from referring to the
124 MIT trademarks in order to convey information (although in doing so,
125 recognition of their trademark status should be given).
126
127 ----
128
129 The following copyright and permission notice applies to the
130 OpenVision Kerberos Administration system located in kadmin/create,
131 kadmin/dbutil, kadmin/passwd, kadmin/server, lib/kadm5, and portions
132 of lib/rpc:
133
134    Copyright, OpenVision Technologies, Inc., 1996, All Rights Reserved
135
136    WARNING: Retrieving the OpenVision Kerberos Administration system 
137    source code, as described below, indicates your acceptance of the 
138    following terms.  If you do not agree to the following terms, do not 
139    retrieve the OpenVision Kerberos administration system.
140
141    You may freely use and distribute the Source Code and Object Code
142    compiled from it, with or without modification, but this Source
143    Code is provided to you "AS IS" EXCLUSIVE OF ANY WARRANTY,
144    INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY OR
145    FITNESS FOR A PARTICULAR PURPOSE, OR ANY OTHER WARRANTY, WHETHER
146    EXPRESS OR IMPLIED.  IN NO EVENT WILL OPENVISION HAVE ANY LIABILITY
147    FOR ANY LOST PROFITS, LOSS OF DATA OR COSTS OF PROCUREMENT OF 
148    SUBSTITUTE GOODS OR SERVICES, OR FOR ANY SPECIAL, INDIRECT, OR
149    CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, INCLUDING, 
150    WITHOUT LIMITATION, THOSE RESULTING FROM THE USE OF THE SOURCE 
151    CODE, OR THE FAILURE OF THE SOURCE CODE TO PERFORM, OR FOR ANY 
152    OTHER REASON.
153
154    OpenVision retains all copyrights in the donated Source Code. OpenVision
155    also retains copyright to derivative works of the Source Code, whether
156    created by OpenVision or by a third party. The OpenVision copyright 
157    notice must be preserved if derivative works are made based on the 
158    donated Source Code.
159
160    OpenVision Technologies, Inc. has donated this Kerberos 
161    Administration system to MIT for inclusion in the standard 
162    Kerberos 5 distribution.  This donation underscores our 
163    commitment to continuing Kerberos technology development 
164    and our gratitude for the valuable work which has been 
165    performed by MIT and the Kerberos community.
166
167 ----
168
169     Portions contributed by Matt Crawford <crawdad@fnal.gov> were
170     work performed at Fermi National Accelerator Laboratory, which is
171     operated by Universities Research Association, Inc., under
172     contract DE-AC02-76CHO3000 with the U.S. Department of Energy.
173
174 ---- The implementation of the Yarrow pseudo-random number generator
175 in src/lib/crypto/yarrow has the following copyright:
176
177 Copyright 2000 by Zero-Knowledge Systems, Inc.
178
179 Permission to use, copy, modify, distribute, and sell this software
180 and its documentation for any purpose is hereby granted without fee,
181 provided that the above copyright notice appear in all copies and that
182 both that copyright notice and this permission notice appear in
183 supporting documentation, and that the name of Zero-Knowledge Systems,
184 Inc. not be used in advertising or publicity pertaining to
185 distribution of the software without specific, written prior
186 permission.  Zero-Knowledge Systems, Inc. makes no representations
187 about the suitability of this software for any purpose.  It is
188 provided "as is" without express or implied warranty.
189
190 ZERO-KNOWLEDGE SYSTEMS, INC. DISCLAIMS ALL WARRANTIES WITH REGARD TO
191 THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
192 FITNESS, IN NO EVENT SHALL ZERO-KNOWLEDGE SYSTEMS, INC. BE LIABLE FOR
193 ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
194 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
195 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTUOUS ACTION, ARISING OUT
196 OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
197
198 ---- The implementation of the AES encryption algorithm in
199 src/lib/crypto/aes has the following copyright:
200
201  Copyright (c) 2001, Dr Brian Gladman <brg@gladman.uk.net>, Worcester, UK.
202  All rights reserved.
203
204  LICENSE TERMS
205
206  The free distribution and use of this software in both source and binary 
207  form is allowed (with or without changes) provided that:
208
209    1. distributions of this source code include the above copyright 
210       notice, this list of conditions and the following disclaimer;
211
212    2. distributions in binary form include the above copyright
213       notice, this list of conditions and the following disclaimer
214       in the documentation and/or other associated materials;
215
216    3. the copyright holder's name is not used to endorse products 
217       built using this software without specific written permission. 
218
219  DISCLAIMER
220
221  This software is provided 'as is' with no explcit or implied warranties
222  in respect of any properties, including, but not limited to, correctness 
223  and fitness for purpose.
224
225 --- The implementations of GSSAPI mechglue in GSSAPI-SPNEGO in
226     src/lib/gssapi, including the following files:
227
228 lib/gssapi/generic/gssapi_err_generic.et
229 lib/gssapi/mechglue/g_accept_sec_context.c
230 lib/gssapi/mechglue/g_acquire_cred.c
231 lib/gssapi/mechglue/g_canon_name.c
232 lib/gssapi/mechglue/g_compare_name.c
233 lib/gssapi/mechglue/g_context_time.c
234 lib/gssapi/mechglue/g_delete_sec_context.c
235 lib/gssapi/mechglue/g_dsp_name.c
236 lib/gssapi/mechglue/g_dsp_status.c
237 lib/gssapi/mechglue/g_dup_name.c
238 lib/gssapi/mechglue/g_exp_sec_context.c
239 lib/gssapi/mechglue/g_export_name.c
240 lib/gssapi/mechglue/g_glue.c
241 lib/gssapi/mechglue/g_imp_name.c
242 lib/gssapi/mechglue/g_imp_sec_context.c
243 lib/gssapi/mechglue/g_init_sec_context.c
244 lib/gssapi/mechglue/g_initialize.c
245 lib/gssapi/mechglue/g_inquire_context.c
246 lib/gssapi/mechglue/g_inquire_cred.c
247 lib/gssapi/mechglue/g_inquire_names.c
248 lib/gssapi/mechglue/g_process_context.c
249 lib/gssapi/mechglue/g_rel_buffer.c
250 lib/gssapi/mechglue/g_rel_cred.c
251 lib/gssapi/mechglue/g_rel_name.c
252 lib/gssapi/mechglue/g_rel_oid_set.c
253 lib/gssapi/mechglue/g_seal.c
254 lib/gssapi/mechglue/g_sign.c
255 lib/gssapi/mechglue/g_store_cred.c
256 lib/gssapi/mechglue/g_unseal.c
257 lib/gssapi/mechglue/g_userok.c
258 lib/gssapi/mechglue/g_utils.c
259 lib/gssapi/mechglue/g_verify.c
260 lib/gssapi/mechglue/gssd_pname_to_uid.c
261 lib/gssapi/mechglue/mglueP.h
262 lib/gssapi/mechglue/oid_ops.c
263 lib/gssapi/spnego/gssapiP_spnego.h
264 lib/gssapi/spnego/spnego_mech.c
265
266 are subject to the following license:
267
268 Copyright (c) 2004 Sun Microsystems, Inc.
269
270 Permission is hereby granted, free of charge, to any person obtaining a
271 copy of this software and associated documentation files (the
272 "Software"), to deal in the Software without restriction, including
273 without limitation the rights to use, copy, modify, merge, publish,
274 distribute, sublicense, and/or sell copies of the Software, and to
275 permit persons to whom the Software is furnished to do so, subject to
276 the following conditions:
277
278 The above copyright notice and this permission notice shall be included
279 in all copies or substantial portions of the Software.
280
281 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
282 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
283 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
284 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
285 CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
286 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
287 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
288
289 Acknowledgements
290 ----------------
291
292 Thanks to Sun Microsystems for donating their implementations of
293 mechglue and SPNEGO.
294
295 Thanks to the members of the Kerberos V5 development team at MIT, both
296 past and present: Danilo Almeida, Jeffrey Altman, Richard Basch, Jay
297 Berkenbilt, Mitch Berger, Andrew Boardman, Joe Calzaretta, John Carr,
298 Don Davis, Alexandra Ellwood, Nancy Gilman, Matt Hancher, Sam Hartman,
299 Paul Hill, Marc Horowitz, Eva Jacobus, Miroslav Jurisic, Barry Jaspan,
300 Geoffrey King, John Kohl, Peter Litwack, Scott McGuire, Kevin
301 Mitchell, Cliff Neuman, Paul Park, Ezra Peisach, Chris Provenzano, Ken
302 Raeburn, Jon Rochlis, Jeff Schiller, Jen Selby, Brad Thompson, Harry
303 Tsai, Ted Ts'o, Marshall Vale, Tom Yu.