Blame crypto/store/store_register.c

Packit c4476c
/*
Packit c4476c
 * Copyright 2016-2018 The OpenSSL Project Authors. All Rights Reserved.
Packit c4476c
 *
Packit c4476c
 * Licensed under the OpenSSL license (the "License").  You may not use
Packit c4476c
 * this file except in compliance with the License.  You can obtain a copy
Packit c4476c
 * in the file LICENSE in the source distribution or at
Packit c4476c
 * https://www.openssl.org/source/license.html
Packit c4476c
 */
Packit c4476c
Packit c4476c
#include <string.h>
Packit c4476c
#include "crypto/ctype.h"
Packit c4476c
#include <assert.h>
Packit c4476c
Packit c4476c
#include <openssl/err.h>
Packit c4476c
#include <openssl/lhash.h>
Packit c4476c
#include "store_local.h"
Packit c4476c
Packit c4476c
static CRYPTO_RWLOCK *registry_lock;
Packit c4476c
static CRYPTO_ONCE registry_init = CRYPTO_ONCE_STATIC_INIT;
Packit c4476c
Packit c4476c
DEFINE_RUN_ONCE_STATIC(do_registry_init)
Packit c4476c
{
Packit c4476c
    registry_lock = CRYPTO_THREAD_lock_new();
Packit c4476c
    return registry_lock != NULL;
Packit c4476c
}
Packit c4476c
Packit c4476c
/*
Packit c4476c
 *  Functions for manipulating OSSL_STORE_LOADERs
Packit c4476c
 */
Packit c4476c
Packit c4476c
OSSL_STORE_LOADER *OSSL_STORE_LOADER_new(ENGINE *e, const char *scheme)
Packit c4476c
{
Packit c4476c
    OSSL_STORE_LOADER *res = NULL;
Packit c4476c
Packit c4476c
    /*
Packit c4476c
     * We usually don't check NULL arguments.  For loaders, though, the
Packit c4476c
     * scheme is crucial and must never be NULL, or the user will get
Packit c4476c
     * mysterious errors when trying to register the created loader
Packit c4476c
     * later on.
Packit c4476c
     */
Packit c4476c
    if (scheme == NULL) {
Packit c4476c
        OSSL_STOREerr(OSSL_STORE_F_OSSL_STORE_LOADER_NEW,
Packit c4476c
                      OSSL_STORE_R_INVALID_SCHEME);
Packit c4476c
        return NULL;
Packit c4476c
    }
Packit c4476c
Packit c4476c
    if ((res = OPENSSL_zalloc(sizeof(*res))) == NULL) {
Packit c4476c
        OSSL_STOREerr(OSSL_STORE_F_OSSL_STORE_LOADER_NEW, ERR_R_MALLOC_FAILURE);
Packit c4476c
        return NULL;
Packit c4476c
    }
Packit c4476c
Packit c4476c
    res->engine = e;
Packit c4476c
    res->scheme = scheme;
Packit c4476c
    return res;
Packit c4476c
}
Packit c4476c
Packit c4476c
const ENGINE *OSSL_STORE_LOADER_get0_engine(const OSSL_STORE_LOADER *loader)
Packit c4476c
{
Packit c4476c
    return loader->engine;
Packit c4476c
}
Packit c4476c
Packit c4476c
const char *OSSL_STORE_LOADER_get0_scheme(const OSSL_STORE_LOADER *loader)
Packit c4476c
{
Packit c4476c
    return loader->scheme;
Packit c4476c
}
Packit c4476c
Packit c4476c
int OSSL_STORE_LOADER_set_open(OSSL_STORE_LOADER *loader,
Packit c4476c
                               OSSL_STORE_open_fn open_function)
Packit c4476c
{
Packit c4476c
    loader->open = open_function;
Packit c4476c
    return 1;
Packit c4476c
}
Packit c4476c
Packit c4476c
int OSSL_STORE_LOADER_set_ctrl(OSSL_STORE_LOADER *loader,
Packit c4476c
                               OSSL_STORE_ctrl_fn ctrl_function)
Packit c4476c
{
Packit c4476c
    loader->ctrl = ctrl_function;
Packit c4476c
    return 1;
Packit c4476c
}
Packit c4476c
Packit c4476c
int OSSL_STORE_LOADER_set_expect(OSSL_STORE_LOADER *loader,
Packit c4476c
                                 OSSL_STORE_expect_fn expect_function)
Packit c4476c
{
Packit c4476c
    loader->expect = expect_function;
Packit c4476c
    return 1;
Packit c4476c
}
Packit c4476c
Packit c4476c
int OSSL_STORE_LOADER_set_find(OSSL_STORE_LOADER *loader,
Packit c4476c
                               OSSL_STORE_find_fn find_function)
Packit c4476c
{
Packit c4476c
    loader->find = find_function;
Packit c4476c
    return 1;
Packit c4476c
}
Packit c4476c
Packit c4476c
int OSSL_STORE_LOADER_set_load(OSSL_STORE_LOADER *loader,
Packit c4476c
                               OSSL_STORE_load_fn load_function)
Packit c4476c
{
Packit c4476c
    loader->load = load_function;
Packit c4476c
    return 1;
Packit c4476c
}
Packit c4476c
Packit c4476c
int OSSL_STORE_LOADER_set_eof(OSSL_STORE_LOADER *loader,
Packit c4476c
                              OSSL_STORE_eof_fn eof_function)
Packit c4476c
{
Packit c4476c
    loader->eof = eof_function;
Packit c4476c
    return 1;
Packit c4476c
}
Packit c4476c
Packit c4476c
int OSSL_STORE_LOADER_set_error(OSSL_STORE_LOADER *loader,
Packit c4476c
                                OSSL_STORE_error_fn error_function)
Packit c4476c
{
Packit c4476c
    loader->error = error_function;
Packit c4476c
    return 1;
Packit c4476c
}
Packit c4476c
Packit c4476c
int OSSL_STORE_LOADER_set_close(OSSL_STORE_LOADER *loader,
Packit c4476c
                                OSSL_STORE_close_fn close_function)
Packit c4476c
{
Packit c4476c
    loader->close = close_function;
Packit c4476c
    return 1;
Packit c4476c
}
Packit c4476c
Packit c4476c
void OSSL_STORE_LOADER_free(OSSL_STORE_LOADER *loader)
Packit c4476c
{
Packit c4476c
    OPENSSL_free(loader);
Packit c4476c
}
Packit c4476c
Packit c4476c
/*
Packit c4476c
 *  Functions for registering OSSL_STORE_LOADERs
Packit c4476c
 */
Packit c4476c
Packit c4476c
static unsigned long store_loader_hash(const OSSL_STORE_LOADER *v)
Packit c4476c
{
Packit c4476c
    return OPENSSL_LH_strhash(v->scheme);
Packit c4476c
}
Packit c4476c
Packit c4476c
static int store_loader_cmp(const OSSL_STORE_LOADER *a,
Packit c4476c
                            const OSSL_STORE_LOADER *b)
Packit c4476c
{
Packit c4476c
    assert(a->scheme != NULL && b->scheme != NULL);
Packit c4476c
    return strcmp(a->scheme, b->scheme);
Packit c4476c
}
Packit c4476c
Packit c4476c
static LHASH_OF(OSSL_STORE_LOADER) *loader_register = NULL;
Packit c4476c
Packit c4476c
int ossl_store_register_loader_int(OSSL_STORE_LOADER *loader)
Packit c4476c
{
Packit c4476c
    const char *scheme = loader->scheme;
Packit c4476c
    int ok = 0;
Packit c4476c
Packit c4476c
    /*
Packit c4476c
     * Check that the given scheme conforms to correct scheme syntax as per
Packit c4476c
     * RFC 3986:
Packit c4476c
     *
Packit c4476c
     * scheme        = ALPHA *( ALPHA / DIGIT / "+" / "-" / "." )
Packit c4476c
     */
Packit c4476c
    if (ossl_isalpha(*scheme))
Packit c4476c
        while (*scheme != '\0'
Packit c4476c
               && (ossl_isalpha(*scheme)
Packit c4476c
                   || ossl_isdigit(*scheme)
Packit c4476c
                   || strchr("+-.", *scheme) != NULL))
Packit c4476c
            scheme++;
Packit c4476c
    if (*scheme != '\0') {
Packit c4476c
        OSSL_STOREerr(OSSL_STORE_F_OSSL_STORE_REGISTER_LOADER_INT,
Packit c4476c
                      OSSL_STORE_R_INVALID_SCHEME);
Packit c4476c
        ERR_add_error_data(2, "scheme=", loader->scheme);
Packit c4476c
        return 0;
Packit c4476c
    }
Packit c4476c
Packit c4476c
    /* Check that functions we absolutely require are present */
Packit c4476c
    if (loader->open == NULL || loader->load == NULL || loader->eof == NULL
Packit c4476c
        || loader->error == NULL || loader->close == NULL) {
Packit c4476c
        OSSL_STOREerr(OSSL_STORE_F_OSSL_STORE_REGISTER_LOADER_INT,
Packit c4476c
                      OSSL_STORE_R_LOADER_INCOMPLETE);
Packit c4476c
        return 0;
Packit c4476c
    }
Packit c4476c
Packit c4476c
    if (!RUN_ONCE(&registry_init, do_registry_init)) {
Packit c4476c
        OSSL_STOREerr(OSSL_STORE_F_OSSL_STORE_REGISTER_LOADER_INT,
Packit c4476c
                      ERR_R_MALLOC_FAILURE);
Packit c4476c
        return 0;
Packit c4476c
    }
Packit c4476c
    CRYPTO_THREAD_write_lock(registry_lock);
Packit c4476c
Packit c4476c
    if (loader_register == NULL) {
Packit c4476c
        loader_register = lh_OSSL_STORE_LOADER_new(store_loader_hash,
Packit c4476c
                                                   store_loader_cmp);
Packit c4476c
    }
Packit c4476c
Packit c4476c
    if (loader_register != NULL
Packit c4476c
        && (lh_OSSL_STORE_LOADER_insert(loader_register, loader) != NULL
Packit c4476c
            || lh_OSSL_STORE_LOADER_error(loader_register) == 0))
Packit c4476c
        ok = 1;
Packit c4476c
Packit c4476c
    CRYPTO_THREAD_unlock(registry_lock);
Packit c4476c
Packit c4476c
    return ok;
Packit c4476c
}
Packit c4476c
int OSSL_STORE_register_loader(OSSL_STORE_LOADER *loader)
Packit c4476c
{
Packit c4476c
    if (!ossl_store_init_once())
Packit c4476c
        return 0;
Packit c4476c
    return ossl_store_register_loader_int(loader);
Packit c4476c
}
Packit c4476c
Packit c4476c
const OSSL_STORE_LOADER *ossl_store_get0_loader_int(const char *scheme)
Packit c4476c
{
Packit c4476c
    OSSL_STORE_LOADER template;
Packit c4476c
    OSSL_STORE_LOADER *loader = NULL;
Packit c4476c
Packit c4476c
    template.scheme = scheme;
Packit c4476c
    template.open = NULL;
Packit c4476c
    template.load = NULL;
Packit c4476c
    template.eof = NULL;
Packit c4476c
    template.close = NULL;
Packit c4476c
Packit c4476c
    if (!ossl_store_init_once())
Packit c4476c
        return NULL;
Packit c4476c
Packit c4476c
    if (!RUN_ONCE(&registry_init, do_registry_init)) {
Packit c4476c
        OSSL_STOREerr(OSSL_STORE_F_OSSL_STORE_GET0_LOADER_INT,
Packit c4476c
                      ERR_R_MALLOC_FAILURE);
Packit c4476c
        return NULL;
Packit c4476c
    }
Packit c4476c
    CRYPTO_THREAD_write_lock(registry_lock);
Packit c4476c
Packit c4476c
    loader = lh_OSSL_STORE_LOADER_retrieve(loader_register, &template);
Packit c4476c
Packit c4476c
    if (loader == NULL) {
Packit c4476c
        OSSL_STOREerr(OSSL_STORE_F_OSSL_STORE_GET0_LOADER_INT,
Packit c4476c
                      OSSL_STORE_R_UNREGISTERED_SCHEME);
Packit c4476c
        ERR_add_error_data(2, "scheme=", scheme);
Packit c4476c
    }
Packit c4476c
Packit c4476c
    CRYPTO_THREAD_unlock(registry_lock);
Packit c4476c
Packit c4476c
    return loader;
Packit c4476c
}
Packit c4476c
Packit c4476c
OSSL_STORE_LOADER *ossl_store_unregister_loader_int(const char *scheme)
Packit c4476c
{
Packit c4476c
    OSSL_STORE_LOADER template;
Packit c4476c
    OSSL_STORE_LOADER *loader = NULL;
Packit c4476c
Packit c4476c
    template.scheme = scheme;
Packit c4476c
    template.open = NULL;
Packit c4476c
    template.load = NULL;
Packit c4476c
    template.eof = NULL;
Packit c4476c
    template.close = NULL;
Packit c4476c
Packit c4476c
    if (!RUN_ONCE(&registry_init, do_registry_init)) {
Packit c4476c
        OSSL_STOREerr(OSSL_STORE_F_OSSL_STORE_UNREGISTER_LOADER_INT,
Packit c4476c
                      ERR_R_MALLOC_FAILURE);
Packit c4476c
        return NULL;
Packit c4476c
    }
Packit c4476c
    CRYPTO_THREAD_write_lock(registry_lock);
Packit c4476c
Packit c4476c
    loader = lh_OSSL_STORE_LOADER_delete(loader_register, &template);
Packit c4476c
Packit c4476c
    if (loader == NULL) {
Packit c4476c
        OSSL_STOREerr(OSSL_STORE_F_OSSL_STORE_UNREGISTER_LOADER_INT,
Packit c4476c
                      OSSL_STORE_R_UNREGISTERED_SCHEME);
Packit c4476c
        ERR_add_error_data(2, "scheme=", scheme);
Packit c4476c
    }
Packit c4476c
Packit c4476c
    CRYPTO_THREAD_unlock(registry_lock);
Packit c4476c
Packit c4476c
    return loader;
Packit c4476c
}
Packit c4476c
OSSL_STORE_LOADER *OSSL_STORE_unregister_loader(const char *scheme)
Packit c4476c
{
Packit c4476c
    if (!ossl_store_init_once())
Packit c4476c
        return 0;
Packit c4476c
    return ossl_store_unregister_loader_int(scheme);
Packit c4476c
}
Packit c4476c
Packit c4476c
void ossl_store_destroy_loaders_int(void)
Packit c4476c
{
Packit c4476c
    assert(lh_OSSL_STORE_LOADER_num_items(loader_register) == 0);
Packit c4476c
    lh_OSSL_STORE_LOADER_free(loader_register);
Packit c4476c
    loader_register = NULL;
Packit c4476c
    CRYPTO_THREAD_lock_free(registry_lock);
Packit c4476c
    registry_lock = NULL;
Packit c4476c
}
Packit c4476c
Packit c4476c
/*
Packit c4476c
 *  Functions to list OSSL_STORE loaders
Packit c4476c
 */
Packit c4476c
Packit c4476c
IMPLEMENT_LHASH_DOALL_ARG_CONST(OSSL_STORE_LOADER, void);
Packit c4476c
int OSSL_STORE_do_all_loaders(void (*do_function) (const OSSL_STORE_LOADER
Packit c4476c
                                                   *loader, void *do_arg),
Packit c4476c
                              void *do_arg)
Packit c4476c
{
Packit c4476c
    lh_OSSL_STORE_LOADER_doall_void(loader_register, do_function, do_arg);
Packit c4476c
    return 1;
Packit c4476c
}