include/internal/property.h

   1 /*
   2  * Copyright 2019-2020 The OpenSSL Project Authors. All Rights Reserved.
   3  * Copyright (c) 2019, Oracle and/or its affiliates.  All rights reserved.
   4  *
   5  * Licensed under the Apache License 2.0 (the "License").  You may not use
   6  * this file except in compliance with the License.  You can obtain a copy
   7  * in the file LICENSE in the source distribution or at
   8  * https://www.openssl.org/source/license.html
   9  */
  10
  11 #ifndef OSSL_INTERNAL_PROPERTY_H
  12 # define OSSL_INTERNAL_PROPERTY_H
  13 # pragma once
  14
  15 # include "internal/cryptlib.h"
  16
  17 typedef struct ossl_method_store_st OSSL_METHOD_STORE;
  18 typedef struct ossl_property_list_st OSSL_PROPERTY_LIST;
  19
  20 /* Initialisation */
  21 int ossl_property_parse_init(OSSL_LIB_CTX *ctx);
  22
  23 /* Property definition parser */
  24 OSSL_PROPERTY_LIST *ossl_parse_property(OSSL_LIB_CTX *ctx, const char *defn);
  25 /* Property query parser */
  26 OSSL_PROPERTY_LIST *ossl_parse_query(OSSL_LIB_CTX *ctx, const char *s);
  27 /* Property checker of query vs definition */
  28 int ossl_property_match_count(const OSSL_PROPERTY_LIST *query,
  29                               const OSSL_PROPERTY_LIST *defn);
  30 int ossl_property_is_enabled(OSSL_LIB_CTX *ctx,  const char *property_name,
  31                              const OSSL_PROPERTY_LIST *prop_list);
  32 /* Free a parsed property list */
  33 void ossl_property_free(OSSL_PROPERTY_LIST *p);
  34
  35
  36 /* Implementation store functions */
  37 OSSL_METHOD_STORE *ossl_method_store_new(OSSL_LIB_CTX *ctx);
  38 void ossl_method_store_free(OSSL_METHOD_STORE *store);
  39 int ossl_method_store_add(OSSL_METHOD_STORE *store, const OSSL_PROVIDER *prov,
  40                           int nid, const char *properties, void *method,
  41                           int (*method_up_ref)(void *),
  42                           void (*method_destruct)(void *));
  43 int ossl_method_store_remove(OSSL_METHOD_STORE *store, int nid,
  44                              const void *method);
  45 int ossl_method_store_fetch(OSSL_METHOD_STORE *store, int nid,
  46                             const char *prop_query, void **method);
  47
  48 /* Get the global properties associate with the specified library context */
  49 OSSL_PROPERTY_LIST **ossl_ctx_global_properties(OSSL_LIB_CTX *ctx,
  50                                                 int loadconfig);
  51
  52 /* property query cache functions */
  53 int ossl_method_store_cache_get(OSSL_METHOD_STORE *store, int nid,
  54                                 const char *prop_query, void **result);
  55 int ossl_method_store_cache_set(OSSL_METHOD_STORE *store, int nid,
  56                                 const char *prop_query, void *result,
  57                                 int (*method_up_ref)(void *),
  58                                 void (*method_destruct)(void *));
  59
  60 void ossl_method_store_flush_cache(OSSL_METHOD_STORE *store, int all);
  61
  62 /* Merge two property queries together */
  63 OSSL_PROPERTY_LIST *ossl_property_merge(const OSSL_PROPERTY_LIST *a,
  64                                         const OSSL_PROPERTY_LIST *b);
  65
  66 #endif