Install kadmin and kdb headers

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.)

ticket: 6431
tags: pullup
target_version: 1.7

git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@22112 dc483132-0cff-0310-8789-dd5450dbe970

diff --git a/src/config/pre.in b/src/config/pre.in
index 7a4e2ca4faa61fc2652ab0033eda9b51e7a41a47..6923ade7d27154ea18fe4effa3452e7b2d78466c 100644 (file)
--- a/src/config/pre.in
+++ b/src/config/pre.in
@@ -219,6 +219,7 @@ KRB5_AD_MODULE_DIR = $(MODULE_DIR)/authdata
 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

diff --git a/src/include/Makefile.in b/src/include/Makefile.in
index f5482a17166ed55187e62909304fe79596fd78a9..2b7cc087712ebe0173111b9a09d1f39dc7c3aa24 100644 (file)
--- a/src/include/Makefile.in
+++ b/src/include/Makefile.in
@@ -132,6 +132,7 @@ clean::
 
 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

diff --git a/src/include/kdb.h b/src/include/kdb.h
index 73b09c9e0454ef1e22b974d272a9855395d8cde4..8b681ef814237cd1cc0ab79929d6b4a7c1aa4629 100644 (file)
--- a/src/include/kdb.h
+++ b/src/include/kdb.h
@@ -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

diff --git a/src/lib/kadm5/Makefile.in b/src/lib/kadm5/Makefile.in
index 2e4d809d39c452f8ad749abccfd297e5f508b0e1..4644937fec7f8d4ea26abc26a057ae74ad26a459 100644 (file)
--- a/src/lib/kadm5/Makefile.in
+++ b/src/lib/kadm5/Makefile.in
@@ -98,5 +98,10 @@ clean-unix:: clean-libobjs
 
 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@
 

diff --git a/src/lib/kadm5/admin.h b/src/lib/kadm5/admin.h
index cdf2f4dc8d9df90bd7b6311818547240331096d3..a9e01768fdbf92d9d683de0f8207538aff4f322b 100644 (file)
--- a/src/lib/kadm5/admin.h
+++ b/src/lib/kadm5/admin.h
@@ -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__