add back mistakenly deleted files

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

2 files changed, 378 insertions, 0 deletions

diff --git a/src/mac/libraries/CCache API/include/CCache.h b/src/mac/libraries/CCache API/include/CCache.h
new file mode 100644
index 000000000..f758c14f3
--- /dev/null
+++ b/src/mac/libraries/CCache API/include/CCache.h
@@ -0,0 +1,350 @@
+/*************************************************************
+ *
+ *	Header file for Credential Cache API for MacOS
+ *
+ *	-as defined by the document found at http://www.umich.edu/~sgr/v4Cache/
+ *	-definitions borrowed from a windows implementation found at
+ *	 /afs/umich.edu/user/s/g/sgr/Public/TsoCacheDll shell/
+ *
+ *	Revision 1: Frank Dabek, 6/4/98
+ * 				added missing calls from revision four of the API
+ *				deleted some WIN specific Information
+ *				added some misssing definitions
+ *				renamed to CCache.h
+ **************************************************************/
+#ifndef _CCache_h_
+#define _CCache_h_
+
+#if defined(__CFM68K__) && !defined(__USING_STATIC_LIBS__)
+#	pragma import on
+#endif
+
+#include "Processes.h"
+/*
+** The Official Error Codes
+*/
+#define	CC_NOERROR	0
+#define CC_BADNAME	1
+#define CC_NOTFOUND	2
+#define CC_END		3
+#define CC_IO		4
+#define CC_WRITE	5
+#define CC_NOMEM	6
+#define CC_FORMAT	7
+#define CC_LOCKED	8
+#define CC_BAD_API_VERSION	9
+#define CC_NO_EXIST	10
+#define CC_NOT_SUPP	11
+#define CC_BAD_PARM 12
+#define CC_ERR_CACHE_ATTACH 13
+#define CC_ERR_CACHE_RELEASE 14
+#define CC_ERR_CACHE_FULL  15
+#define CC_ERR_CRED_VERSION  16
+
+#define CRED_TYPE_IN_UNION
+
+typedef int cc_int32;
+typedef cc_int32 cc_time_t;
+typedef cc_int32 cc_nc_flags;
+//typedef short cc_cred_vers;
+	
+enum StringToKey_Type { STK_AFS = 0, STK_DES = 1};
+
+enum {  MAX_V4_CRED_LEN = 1250, 
+		KRB_PRINCIPAL_SZ = 1250, 
+		KRB_INSTANCE_SZ = 1250,
+		KRB_REALM_SZ = 1250,
+		KRB_SERVICE_SZ = 1250,
+		ADDR_SZ = 16  };
+
+// V4 Credentials
+typedef struct _V4Credentials {
+	unsigned char	kversion;
+    char			principal[KRB_PRINCIPAL_SZ];
+    char			principal_instance[KRB_INSTANCE_SZ];
+    char			service[KRB_SERVICE_SZ];
+    char			service_instance[KRB_INSTANCE_SZ];
+    char			realm[KRB_REALM_SZ];
+    unsigned char	session_key[8];
+    cc_int32		kvno;
+    enum StringToKey_Type	str_to_key;
+    long			issue_date;  
+    cc_int32		lifetime;          
+    char			address[ADDR_SZ];       // IP Address of local host
+    cc_int32		ticket_sz;    
+    unsigned char	ticket[MAX_V4_CRED_LEN];
+    unsigned long	oops;
+} V4Cred_type;
+
+// version indentfiers
+// extend to authentication schemes beyond Kerberos?
+enum cc_cred_vers {  
+    CC_CRED_VUNKNOWN = 0,       // For validation
+    CC_CRED_V4 = 1,
+    CC_CRED_V5 = 2,
+    CC_CRED_VMAX = 3,            // For validation
+    CC_INVALID_RECORD = 99
+};
+
+#define NC_MAX_NAME_LENGTH 255
+typedef struct _infoNC  {
+	char name[NC_MAX_NAME_LENGTH];
+	char principal[NC_MAX_NAME_LENGTH];
+	enum cc_cred_vers vers;
+} infoNC;
+
+
+typedef struct _cc_data {
+	cc_int32		type; // should be one of above
+	cc_int32		length;
+	unsigned char*	data;
+} cc_data;
+
+typedef struct _cc_creds {
+	char*		client;
+	char*		server;
+	cc_data		keyblock;
+	cc_time_t	authtime;
+	cc_time_t	starttime;
+	cc_time_t	endtime;
+	cc_time_t	renew_till;
+	int			is_skey;
+	cc_int32	ticket_flags;
+	cc_data     **addresses;
+	cc_data		ticket;
+	cc_data		second_ticket; //????
+	cc_data     **authdata;
+} cc_creds;
+
+//union of v4, v5 pointers
+typedef union cred_ptr_union_type {
+    V4Cred_type* pV4Cred;
+    cc_creds*    pV5Cred;
+} cred_ptr_union;
+
+//version 4 and version 5 union data type
+typedef struct cred_union_type {
+#ifdef CRED_TYPE_IN_UNION
+    enum cc_cred_vers cred_type;
+#endif
+    cred_ptr_union cred;
+} cred_union;
+
+#define kInitialCredBufferSize 10
+#define kLocalCopyNCType 1
+#define kMasterRecordNCType 2
+#define kUnlocked 100
+#define kReadLock 101
+#define kWriteLock 102
+typedef struct _ccache_p {
+	char					name[NC_MAX_NAME_LENGTH + 1]; 
+	enum cc_cred_vers			vers;
+	char					principal[NC_MAX_NAME_LENGTH + 1];
+	short					numCreds;
+	short					maxCreds;
+	cred_union**	 		creds; //self-growing array of pointers
+	int						cc_flags;
+	char					typeFlag; //master or local copy
+	long					lock;
+	ProcessSerialNumber		lockOwner;
+	struct _ccache_p		*next;
+	struct _ccache_p		*prev;
+} ccache_p;
+
+
+typedef struct _ccache_it {
+	ccache_p *prevNC;
+	int		  lastCredOffset;
+} ccache_it;
+
+typedef struct _apiCB {
+	ccache_p* listHead;
+	ccache_p* listTail;
+	int		  numNCs;
+	cc_time_t	  changeCount;
+} apiCB;
+
+
+// --- Globals -------------
+extern apiCB *gCntrlBlock;
+
+
+/*
+** The official (externally visible) API
+*/
+
+#define CC_API_VER_1	1
+
+// -- Main cache routines ------
+
+/* Initialize the Credentials Cache, return a control structure in cc_ctx,
+	This should be the entry point of the shared library, or called from
+	the entry point */
+int
+cc_initialize(apiCB ** cc_ctx,		// < SL's primary control structure. 
+									//   returned here, passed everywhere else 
+			  int	api_version,	// > ver supported by caller (use CC_API_VER_1)
+			  int*	api_supported,	// < if ~NULL, returned max ver supported by DLL
+			  char** vendor);		// < if ~NULL, returns read only C string, vendor name */
+
+/* Termination routine */
+int
+cc_shutdown(apiCB** cc_ctx);			// <> SL's primary control structure. NULL after call. 
+
+
+/* Open a name cache within the ccache designated by name and version? 
+ 	Returns a control struture pointer to the NC in *handle */
+int
+cc_open(apiCB * cc_ctx,				// > SL's primary control structure
+		char * name,				// > name of pre-created cache
+		const enum cc_cred_vers vers,	// > version of credentials held in this NC 
+		int cc_flags,				// > options
+		ccache_p ** handle);		// < named cache control structure 
+
+/* Close and deallocate memory assoicated with the named cache pointed to by *handle */
+int
+cc_close(apiCB* cc_ctx,				// > DLL's primary control structure
+		 ccache_p** handle);		// <> named cache control structure. NULL after call. 
+
+/* Create a new named cache in the cache cc_ctx.
+Specify the cache by: a name, a principal, a version
+return a pointer to the control structure for the cache via handle */
+int
+cc_create(apiCB* cc_ctx,			// > DLL's primary control structure
+		  char* name,				// > name of cache to be [destroyed if exists, then] created
+		  const enum cc_cred_vers vers,	// > version of credentials to be held in cache
+		  char* principal,			// > name of principal associated with named cache
+		  int cc_flags,				// > options
+		  ccache_p** handle);		// < named cache control structure 
+
+/* Seems remarkably similiar to cc_close ???? */
+int
+cc_destroy(apiCB* cc_ctx,			// > DLL's primary control structure
+		   ccache_p** handle);		// <> named cache control structure. NULL after call.
+
+/* Get the global last changed time variable for the CCache 
+   Replace this with a change counter instead of an actual time?*/
+int
+cc_get_change_time(apiCB* cc_ctx,	  // > DLL's primary control structure
+				   cc_time_t* time); // < time of last change to named cache
+
+// -- Named Cache routines ---------
+
+/* store the credentials (tickets) in cred in the named cache pointed 
+to by handle.  Maybe the last argument should be more general? */
+int
+cc_store(apiCB* cc_ctx,				// > DLL's primary control structure
+		 const ccache_p* ccache_pointer,			// > named cache control structure
+		 const cred_union cred);			// > credentials to store in cache named
+
+/* Remove the credentials pointed to by cred from the Named Cache pointed to
+by handle. */
+int
+cc_remove_cred(apiCB* cc_ctx,		// > DLL's primary control structure
+			   ccache_p* ccache_pointer,	// > named cache control structure
+			   const cred_union cred);		// > credentials to remove from named cache
+
+/* set the principal of the NC *ccache_pointer to principal,
+	principal should be a null terminated C string */
+int
+cc_set_principal(apiCB* cc_ctx,						// > cs 
+				const ccache_p* ccache_pointer,		// > NC
+			    const enum cc_cred_vers vers,			// > version: to check pointer?
+			    const char* principal);				// > new principal name
+
+/* Get the name of the principal associated with the NC handle */
+int
+cc_get_principal(apiCB* cc_ctx,		// > DLL's primary control structure
+				 ccache_p * ccache_pointer,	// > named cache control structure
+				 char** principal);	// < name of principal associated with named cache
+									//   Free via cc_free_principal()
+
+/* Get version of credentials stored in the NC pointed to by ccache_pointer */ 
+int
+cc_get_cred_version(apiCB* cc_ctx, 					// > cs
+					const ccache_p* ccache_pointer, // > the named cache
+					enum cc_cred_vers* vers);			// <> the version of credentials in the NC
+
+/* Return the name of the NC specified by ccache_p */
+int
+cc_get_name(apiCB* cc_ctx,						// > control struct
+			const ccache_p* ccache_pointer, 	// > NC
+			char** name);						// <> name					
+
+
+//  - Search routines ----
+
+/*
+Sequentially open every NC in the CCache. 
+To use (?): initially set handle and itCache to NULL
+after each call set itCache to handle,
+repeated calls will return all currently held NC's
+*/
+int
+cc_seq_fetch_NCs(apiCB* cc_ctx,			// > DLL's primary control structure
+				   ccache_p** ccache_pointer,	// <> named cache control structure (close, then open next)
+			       ccache_it** itCache);// <> iterator used by DLL, set to NULL before first call
+										//    Also NULL for final call if loop ends before CC_END
+
+/* Sequentially fetch every set of credentials in the Named Cache handle
+use similiarly to cc_seq_fetch_NCs */
+int
+cc_seq_fetch_creds(apiCB* cc_ctx,			// > DLL's primary control structure
+				   ccache_p* ccache_pointer,		// > named cache control structure
+			       cred_union** creds,			// < filled in by DLL, free via cc_free_creds()
+			       ccache_it** itCreds);	// <> iterator used by DLL, set to NULL before first call
+											//    Also NULL for final call if loop ends before CC_END
+
+/* a wrapper for cc_seq_fetch_NCs.
+	Returns: a null terminated list (array) of pointers to infoNC structs
+	if this works, maybe we should hide that seq call...
+	*/
+int
+cc_get_NC_info(apiCB *cc_ctx,		// > control structure
+			 infoNC*** ppNCi);		// <> info about the NC (yes.. three asterisks...)
+
+				
+// -- Memory recovery ---------
+
+/* just a wrapper for free() ??? */
+int
+cc_free_principal(apiCB* cc_ctx,		// > DLL's primary control structure
+				  char* principal);// <> principal to be freed, returned as NULL
+									//   (from cc_get_principal())
+/* another wrapper? */
+int
+cc_free_name(apiCB* cc_ctx,			// > DLL's primary control structure
+			 char* name);			// <> name to be freed, returned as NULL
+									//   (from cc_seq_fetch_cache())
+
+/* free storage associated with cred_union** */
+int
+cc_free_creds(apiCB* cc_ctx,			// > DLL's primary control structure
+			  cred_union** creds);		// <> creds (from cc_seq_fetch_creds()) to be freed
+										//    Returned as NULL.
+
+/* Free that nasty array we created above */
+int 
+cc_free_NC_info(apiCB *cc_ctx,		// > control structure
+				infoNC*** ppNCi);	// <> pointer to free
+							 
+
+// -- Locking ----------
+
+#define CC_LOCK_UNLOCK	 1
+#define CC_LOCK_READER	 2
+#define CC_LOCK_WRITER	 3
+#define CC_LOCK_NOBLOCK	16
+
+/* Place a lock on the Named Cache handle, lock types are above 
+NB: API indicates that this call is not implemented*/
+int
+cc_lock_request(apiCB* cc_ctx,		// > DLL's primary control structure
+				ccache_p* ccache_pointer,		// > named cache control structure
+				int lock_type);		// > one (or combination) of above defined lock types
+			   
+#if defined(__CFM68K__) && !defined(__USING_STATIC_LIBS__)
+#	pragma import reset
+#endif
+
+#endif /* Krb_CCacheAPI_h_ */
diff --git a/src/mac/libraries/CCache API/include/CCacheUtil.h b/src/mac/libraries/CCache API/include/CCacheUtil.h
new file mode 100644
index 000000000..23426fc67
--- /dev/null
+++ b/src/mac/libraries/CCache API/include/CCacheUtil.h
@@ -0,0 +1,28 @@
+#include "CCache.h"
+
+#define kCredsMatch 1
+#define kCredsDiffer 0
+
+// ----- Prototypes for Private Functions ------------------
+cred_union **	newCredBuffer(ccache_p *nc);
+int credBufferInsert(ccache_p* nc,  cred_union creds);
+int credBufferRemove(ccache_p* nc, const cred_union cred_to_remove);
+
+char credcmp (cred_union a, cred_union b);
+
+char isLockOurs(const ccache_p *nc);
+
+int copyDataObj(cc_data *obj, cc_data src);
+int copyV5Cred(cred_union src, cred_union **dest);
+int copyV4Cred(cred_union src, cred_union **dest);
+int dupNC(ccache_p* src, ccache_p** dest);
+void copyDataArray(cc_data **src, cc_data ***dest);
+
+void disposeDataArray(cc_data **base);
+int cc_free_cred_internals(cred_union *creds);
+int freeNCList(apiCB *cntrlBlock);
+int disposeCredBuffer(apiCB *cc_ctx, ccache_p *nc);
+
+Ptr NewSafePtr(long size);
+Ptr NewSafePtrSys(long size);
+void DisposeSafePtr(Ptr safeP);