include/openssl/self_test.h

   1 /*
   2  * Copyright 2019-2020 The OpenSSL Project Authors. All Rights Reserved.
   3  *
   4  * Licensed under the Apache License 2.0 (the "License").  You may not use
   5  * this file except in compliance with the License.  You can obtain a copy
   6  * in the file LICENSE in the source distribution or at
   7  * https://www.openssl.org/source/license.html
   8  */
   9
  10 #ifndef OPENSSL_SELF_TEST_H
  11 # define OPENSSL_SELF_TEST_H
  12
  13 # include <openssl/core.h> /* OSSL_CALLBACK */
  14
  15 # ifdef __cplusplus
  16 extern "C" {
  17 # endif
  18
  19 /* The test event phases */
  20 # define OSSL_SELF_TEST_PHASE_NONE     "None"
  21 # define OSSL_SELF_TEST_PHASE_START    "Start"
  22 # define OSSL_SELF_TEST_PHASE_CORRUPT  "Corrupt"
  23 # define OSSL_SELF_TEST_PHASE_PASS     "Pass"
  24 # define OSSL_SELF_TEST_PHASE_FAIL     "Fail"
  25
  26 /* Test event categories */
  27 # define OSSL_SELF_TEST_TYPE_NONE               "None"
  28 # define OSSL_SELF_TEST_TYPE_MODULE_INTEGRITY   "Module_Integrity"
  29 # define OSSL_SELF_TEST_TYPE_INSTALL_INTEGRITY  "Install_Integrity"
  30 # define OSSL_SELF_TEST_TYPE_CRNG               "Continuous_RNG_Test"
  31 # define OSSL_SELF_TEST_TYPE_PCT                "Pairwise_Consistency_Test"
  32 # define OSSL_SELF_TEST_TYPE_KAT_CIPHER         "KAT_Cipher"
  33 # define OSSL_SELF_TEST_TYPE_KAT_ASYM_CIPHER    "KAT_AsymmetricCipher"
  34 # define OSSL_SELF_TEST_TYPE_KAT_DIGEST         "KAT_Digest"
  35 # define OSSL_SELF_TEST_TYPE_KAT_SIGNATURE      "KAT_Signature"
  36 # define OSSL_SELF_TEST_TYPE_KAT_KDF            "KAT_KDF"
  37 # define OSSL_SELF_TEST_TYPE_KAT_KA             "KAT_KA"
  38 # define OSSL_SELF_TEST_TYPE_DRBG               "DRBG"
  39
  40 /* Test event sub categories */
  41 # define OSSL_SELF_TEST_DESC_NONE           "None"
  42 # define OSSL_SELF_TEST_DESC_INTEGRITY_HMAC "HMAC"
  43 # define OSSL_SELF_TEST_DESC_PCT_RSA_PKCS1  "RSA"
  44 # define OSSL_SELF_TEST_DESC_PCT_ECDSA      "ECDSA"
  45 # define OSSL_SELF_TEST_DESC_PCT_DSA        "DSA"
  46 # define OSSL_SELF_TEST_DESC_CIPHER_AES_GCM "AES_GCM"
  47 # define OSSL_SELF_TEST_DESC_CIPHER_TDES    "TDES"
  48 # define OSSL_SELF_TEST_DESC_ASYM_RSA_ENC   "RSA_Encrypt"
  49 # define OSSL_SELF_TEST_DESC_ASYM_RSA_DEC   "RSA_Decrypt"
  50 # define OSSL_SELF_TEST_DESC_MD_SHA1        "SHA1"
  51 # define OSSL_SELF_TEST_DESC_MD_SHA2        "SHA2"
  52 # define OSSL_SELF_TEST_DESC_MD_SHA3        "SHA3"
  53 # define OSSL_SELF_TEST_DESC_SIGN_DSA       "DSA"
  54 # define OSSL_SELF_TEST_DESC_SIGN_RSA       "RSA"
  55 # define OSSL_SELF_TEST_DESC_SIGN_ECDSA     "ECDSA"
  56 # define OSSL_SELF_TEST_DESC_DRBG_CTR       "CTR"
  57 # define OSSL_SELF_TEST_DESC_DRBG_HASH      "HASH"
  58 # define OSSL_SELF_TEST_DESC_DRBG_HMAC      "HMAC"
  59 # define OSSL_SELF_TEST_DESC_KA_DH          "DH"
  60 # define OSSL_SELF_TEST_DESC_KA_ECDH        "ECDH"
  61 # define OSSL_SELF_TEST_DESC_KDF_HKDF       "HKDF"
  62 # define OSSL_SELF_TEST_DESC_KDF_SSKDF      "SSKDF"
  63 # define OSSL_SELF_TEST_DESC_RNG            "RNG"
  64
  65 # ifdef __cplusplus
  66 }
  67 # endif
  68
  69 void OSSL_SELF_TEST_set_callback(OSSL_LIB_CTX *libctx, OSSL_CALLBACK *cb,
  70                                  void *cbarg);
  71 void OSSL_SELF_TEST_get_callback(OSSL_LIB_CTX *libctx, OSSL_CALLBACK **cb,
  72                                  void **cbarg);
  73
  74 OSSL_SELF_TEST *OSSL_SELF_TEST_new(OSSL_CALLBACK *cb, void *cbarg);
  75 void OSSL_SELF_TEST_free(OSSL_SELF_TEST *st);
  76
  77 void OSSL_SELF_TEST_onbegin(OSSL_SELF_TEST *st, const char *type,
  78                             const char *desc);
  79 int OSSL_SELF_TEST_oncorrupt_byte(OSSL_SELF_TEST *st, unsigned char *bytes);
  80 void OSSL_SELF_TEST_onend(OSSL_SELF_TEST *st, int ret);
  81
  82 #endif /* OPENSSL_SELF_TEST_H */