
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;
|
|
}
|