svn rev #22112: trunk/src/ config/ include/ lib/kadm5/

[ghudson@MIT.EDU]

http://src.mit.edu/fisheye/changelog/krb5/?cs=22112
Commit By: ghudson
Log Message:
ticket: 6431
subject: Install kadmin and kdb headers
tags: pullup
target_version: 1.7

Add disclaimers to the kadmin and kdb headers about the weaker
stability commitments we make for their APIs, and install them for the
benefit of users who can tolerate such instability.  (The kadmin
interface is the real goal here, but the kadmin header includes kdb.h
so we need to install both.)



Changed Files:
U   trunk/src/config/pre.in
U   trunk/src/include/Makefile.in
U   trunk/src/include/kdb.h
U   trunk/src/lib/kadm5/Makefile.in
U   trunk/src/lib/kadm5/admin.h
Modified: trunk/src/config/pre.in
===================================================================
--- trunk/src/config/pre.in	2009-03-17 22:48:38 UTC (rev 22111)
+++ trunk/src/config/pre.in	2009-03-20 18:09:19 UTC (rev 22112)
@@ -219,6 +219,7 @@
 KRB5_LIBKRB5_MODULE_DIR = $(MODULE_DIR)/libkrb5
 GSS_MODULE_DIR = @libdir@/gss
 KRB5_INCSUBDIRS = \
+	$(KRB5_INCDIR)/kadm5 \
 	$(KRB5_INCDIR)/krb5 \
 	$(KRB5_INCDIR)/gssapi \
 	$(KRB5_INCDIR)/gssrpc

Modified: trunk/src/include/Makefile.in
===================================================================
--- trunk/src/include/Makefile.in	2009-03-17 22:48:38 UTC (rev 22111)
+++ trunk/src/include/Makefile.in	2009-03-20 18:09:19 UTC (rev 22112)
@@ -132,6 +132,7 @@
 
 install-headers-unix install:: krb5/krb5.h profile.h
 	$(INSTALL_DATA) $(srcdir)/krb5.h $(DESTDIR)$(KRB5_INCDIR)$(S)krb5.h
+	$(INSTALL_DATA) $(srcdir)/kdb.h $(DESTDIR)$(KRB5_INCDIR)$(S)kdb.h
 	$(INSTALL_DATA) krb5/krb5.h $(DESTDIR)$(KRB5_INCDIR)$(S)krb5$(S)krb5.h
 	$(INSTALL_DATA) $(srcdir)/krb5/locate_plugin.h $(DESTDIR)$(KRB5_INCDIR)$(S)krb5$(S)locate_plugin.h
 	$(INSTALL_DATA) profile.h $(DESTDIR)$(KRB5_INCDIR)$(S)profile.h

Modified: trunk/src/include/kdb.h
===================================================================
--- trunk/src/include/kdb.h	2009-03-17 22:48:38 UTC (rev 22111)
+++ trunk/src/include/kdb.h	2009-03-20 18:09:19 UTC (rev 22112)
@@ -58,9 +58,19 @@
  * Use is subject to license terms.
  */
 
+/* This API is not considered as stable as the main krb5 API.
+ *
+ * - We may make arbitrary incompatible changes between feature
+ *   releases (e.g. from 1.7 to 1.8).
+ * - We will make some effort to avoid making incompatible changes for
+ *   bugfix releases, but will make them if necessary.
+ */
+
 #ifndef KRB5_KDB5__
 #define KRB5_KDB5__
 
+#include <krb5.h>
+
 /* Salt types */
 #define KRB5_KDB_SALTTYPE_NORMAL	0
 #define KRB5_KDB_SALTTYPE_V4		1

Modified: trunk/src/lib/kadm5/Makefile.in
===================================================================
--- trunk/src/lib/kadm5/Makefile.in	2009-03-17 22:48:38 UTC (rev 22111)
+++ trunk/src/lib/kadm5/Makefile.in	2009-03-20 18:09:19 UTC (rev 22112)
@@ -98,5 +98,10 @@
 
 clean-windows::
 
+install-headers-unix install:: $(BUILD_HDRS)
+	$(INSTALL_DATA) $(srcdir)/admin.h $(DESTDIR)$(KRB5_INCDIR)$(S)kadm5$(S)admin.h
+	$(INSTALL_DATA) chpass_util_strings.h $(DESTDIR)$(KRB5_INCDIR)$(S)kadm5$(S)chpass_util_strings.h
+	$(INSTALL_DATA) kadm_err.h $(DESTDIR)$(KRB5_INCDIR)$(S)kadm5$(S)kadm_err.h
+
 @libobj_frag@
 

Modified: trunk/src/lib/kadm5/admin.h
===================================================================
--- trunk/src/lib/kadm5/admin.h	2009-03-17 22:48:38 UTC (rev 22111)
+++ trunk/src/lib/kadm5/admin.h	2009-03-20 18:09:19 UTC (rev 22112)
@@ -30,6 +30,17 @@
  * $Header$
  */
 
+/*
+ * This API is not considered as stable as the main krb5 API.
+ *
+ * - We may make arbitrary incompatible changes between feature
+ *   releases (e.g. from 1.7 to 1.8).
+ * - We will make some effort to avoid making incompatible changes for
+ *   bugfix releases, but will make them if necessary.
+ * - We make no commitments at all regarding the v1 API (obtained by
+ *   defining USE_KADM5_API_VERSION to 1) and expect to remove it.
+ */
+
 #ifndef __KADM5_ADMIN_H__
 #define __KADM5_ADMIN_H__