 d84512b8d2
			
		
	
	d84512b8d2
	
	
	
		
			
			The krb5_cc_ops structure is an extensible structure to which new
functionality has been added over the years.
Version zero was the original.  It included all functions up to
and including get_default_name().
Version one added set_default().
Version two added lastchange().
Version three added set_kdc_offset() and get_kdc_offset().
Version four broke compatibility by modifying the signatures
of get_name() and resolve().   This was in change
7bf4d76e75 ("krb5: Improve cccol sub
naming; add gss_store_cred_into2()").
Version five restores the original signatures of get_name()
and resolve() and introduces get_name_2() and resolve_2() that
provide the additional cccol functionality.
This change
 * introduces version five
 * documents which functions are part of each version
 * replaces KRB5_CC_OPS_VERSION with KRB5_CC_OPS_VERSION_0,
   KRB5_CC_OPS_VERSION_1, KRB5_CC_OPS_VERSION_2, KRB5_CC_OPS_VERSION_3,
   and KRB5_CC_OPS_VERSION_5.  KRB5_CC_OPS_VERSION_4 is skipped
   because of the aforementioned breakage.
 * compatibility logic is added to permit ccache plugins to implement
   any of version one, two, three, five or a future version.
 * all in-tree krb5_cc_ops implementations are updated to version 5.
Change-Id: Iadfce01d10834bc6151939e4d9d196f03001626e
		
	
		
			
				
	
	
		
			82 lines
		
	
	
		
			2.7 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			82 lines
		
	
	
		
			2.7 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /***********************************************************************
 | |
|  * Copyright (c) 2010, Secure Endpoints Inc.
 | |
|  * All rights reserved.
 | |
|  *
 | |
|  * Redistribution and use in source and binary forms, with or without
 | |
|  * modification, are permitted provided that the following conditions
 | |
|  * are met:
 | |
|  *
 | |
|  * - Redistributions of source code must retain the above copyright
 | |
|  *   notice, this list of conditions and the following disclaimer.
 | |
|  *
 | |
|  * - Redistributions in binary form must reproduce the above copyright
 | |
|  *   notice, this list of conditions and the following disclaimer in
 | |
|  *   the documentation and/or other materials provided with the
 | |
|  *   distribution.
 | |
|  *
 | |
|  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 | |
|  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 | |
|  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 | |
|  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
 | |
|  * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
 | |
|  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 | |
|  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 | |
|  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 | |
|  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
 | |
|  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 | |
|  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 | |
|  * OF THE POSSIBILITY OF SUCH DAMAGE.
 | |
|  *
 | |
|  **********************************************************************/
 | |
| 
 | |
| #include "krb5_locl.h"
 | |
| #include "ccache_plugin.h"
 | |
| #ifdef HAVE_DLFCN_H
 | |
| #include <dlfcn.h>
 | |
| #endif
 | |
| #include <assert.h>
 | |
| 
 | |
| /*
 | |
|  * cc_plugin_register_to_context is executed once per krb5_init_context().
 | |
|  * Its job is to register the plugin's krb5_cc_ops structure with the
 | |
|  * krb5_context.
 | |
|  */
 | |
| 
 | |
| static krb5_error_code KRB5_LIB_CALL
 | |
| cc_plugin_register_to_context(krb5_context context, const void *plug, void *plugctx, void *userctx)
 | |
| {
 | |
|     krb5_cc_ops *ccops = (krb5_cc_ops *)plugctx;
 | |
|     krb5_error_code ret;
 | |
| 
 | |
|     if (ccops == NULL)
 | |
|        return KRB5_PLUGIN_NO_HANDLE;
 | |
| 
 | |
|     ret = krb5_cc_register(context, ccops, TRUE);
 | |
|     if (ret != 0)
 | |
|        *((krb5_error_code *)userctx) = ret;
 | |
| 
 | |
|     return KRB5_PLUGIN_NO_HANDLE;
 | |
| }
 | |
| 
 | |
| static const char *ccache_plugin_deps[] = { "krb5", NULL };
 | |
| 
 | |
| static struct heim_plugin_data
 | |
| ccache_plugin_data = {
 | |
|     "krb5",
 | |
|     KRB5_PLUGIN_CCACHE,
 | |
|     0,
 | |
|     ccache_plugin_deps,
 | |
|     krb5_get_instance
 | |
| };
 | |
| 
 | |
| KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
 | |
| _krb5_load_ccache_plugins(krb5_context context)
 | |
| {
 | |
|     krb5_error_code userctx = 0;
 | |
| 
 | |
|     (void)_krb5_plugin_run_f(context, &ccache_plugin_data, 0,
 | |
| 			     &userctx, cc_plugin_register_to_context);
 | |
| 
 | |
|     return userctx;
 | |
| }
 |