OSSL_SELF_TEST_NEW - Online Linux Manual PageSection : 3ossl
Updated : 2022-03-15
Source : 3.0.2
Note : OpenSSL
NAMEOSSL_SELF_TEST_new, OSSL_SELF_TEST_free, OSSL_SELF_TEST_onbegin, OSSL_SELF_TEST_oncorrupt_byte, OSSL_SELF_TEST_onend − functionality to trigger a callback during a self test
SYNOPSIS​ #include <openssl/self_test.h> ​ ​ OSSL_SELF_TEST *OSSL_SELF_TEST_new(OSSL_CALLBACK *cb, void *cbarg); ​ void OSSL_SELF_TEST_free(OSSL_SELF_TEST *st); ​ ​ void OSSL_SELF_TEST_onbegin(OSSL_SELF_TEST *st, const char *type, ​ const char *desc); ​ int OSSL_SELF_TEST_oncorrupt_byte(OSSL_SELF_TEST *st, unsigned char *bytes); ​ void OSSL_SELF_TEST_onend(OSSL_SELF_TEST *st, int ret);
DESCRIPTIONThese methods are intended for use by provider implementors, to display diagnostic information during self testing. ​OSSL_SELF_TEST_new() allocates an opaque OSSL_SELF_TEST object that has a callback and callback argument associated with it. The callback cb may be triggered multiple times by a self test to indicate different phases. ​OSSL_SELF_TEST_free() frees the space allocated by OSSL_SELF_TEST_new(). ​OSSL_SELF_TEST_onbegin() may be inserted at the start of a block of self test code. It can be used for diagnostic purposes. If this method is called the callback cb will receive the following ​OSSL_PARAM object. ``st-phase'' (OSSL_PROV_PARAM_SELF_TEST_PHASE) <UTF8 string> The value is the string ‟Start” ​OSSL_SELF_TEST_oncorrupt_byte() may be inserted just after the known answer is calculated, but before the self test compares the result. The first byte in the passed in array of bytes will be corrupted if the callback returns 0, otherwise it leaves the array unaltered. It can be used for failure testing. The type and desc can be used to identify an individual self test to target for failure testing. If this method is called the callback cb will receive the following ​OSSL_PARAM object. ``st-phase'' (OSSL_PROV_PARAM_SELF_TEST_PHASE) <UTF8 string> The value is the string ‟Corrupt” ​OSSL_SELF_TEST_onend() may be inserted at the end of a block of self test code just before cleanup to indicate if the test passed or failed. It can be used for diagnostic purposes. If this method is called the callback cb will receive the following ​OSSL_PARAM object. ``st-phase'' (OSSL_PROV_PARAM_SELF_TEST_PHASE) <UTF8 string> The value of the string is ‟Pass” if ret is non zero, otherwise it has the value ‟Fail”. After the callback cb has been called the values that were set by ​OSSL_SELF_TEST_onbegin() for type and desc are set to the value ‟None”. If OSSL_SELF_TEST_onbegin(), OSSL_SELF_TEST_oncorrupt_byte() or ​OSSL_SELF_TEST_onend() is called the following additional OSSL_PARAM are passed to the callback. ``st-type'' (OSSL_PROV_PARAM_SELF_TEST_TYPE) <UTF8 string> The value is setup by the type passed to OSSL_SELF_TEST_onbegin(). This allows the callback to identify the type of test being run. ``st-desc'' (OSSL_PROV_PARAM_SELF_TEST_DESC) <UTF8 string> The value is setup by the type passed to OSSL_SELF_TEST_onbegin(). This allows the callback to identify the sub category of the test being run.
RETURN VALUES​OSSL_SELF_TEST_new() returns the allocated OSSL_SELF_TEST object, or NULL if it fails. ​OSSL_SELF_TEST_oncorrupt_byte() returns 1 if corruption occurs, otherwise it returns 0.
EXAMPLESA single self test could be set up in the following way: ​ OSSL_SELF_TEST *st = NULL; ​ OSSL_CALLBACK *cb; ​ void *cbarg; ​ int ok = 0; ​ unsigned char out[EVP_MAX_MD_SIZE]; ​ unsigned int out_len = 0; ​ EVP_MD_CTX *ctx = EVP_MD_CTX_new(); ​ EVP_MD *md = EVP_MD_fetch(libctx, t−>algorithm, NULL); ​ ​ /* ​ * Retrieve the callback − will be NULL if not set by the application via ​ * OSSL_SELF_TEST_set_callback(). ​ */ ​ OSSL_SELF_TEST_get_callback(libctx, &cb, &cbarg); ​ ​ st = OSSL_SELF_TEST_new(cb, cb_arg); ​ ​ /* Trigger the optional callback */ ​ OSSL_SELF_TEST_onbegin(st, OSSL_SELF_TEST_TYPE_KAT_DIGEST, ​ OSSL_SELF_TEST_DESC_MD_SHA2); ​ ​ if (!EVP_DigestInit_ex(ctx, md, NULL) ​ || !EVP_DigestUpdate(ctx, pt, pt_len) ​ || !EVP_DigestFinal(ctx, out, &out_len)) ​ goto err; ​ ​ /* Optional corruption − If the application callback returns 0 */ ​ OSSL_SELF_TEST_oncorrupt_byte(st, out); ​ ​ if (out_len != t−>expected_len ​ || memcmp(out, t−>expected, out_len) != 0) ​ goto err; ​ ok = 1; ​ err: ​ OSSL_SELF_TEST_onend(st, ok); ​ EVP_MD_free(md); ​ EVP_MD_CTX_free(ctx); Multiple self test's can be set up in a similar way by repeating the pattern of ​OSSL_SELF_TEST_onbegin(), OSSL_SELF_TEST_oncorrupt_byte(), OSSL_SELF_TEST_onend() for each test.
SEE ALSO​OSSL_SELF_TEST_set_callback (3), ​openssl−core.h (7), ​OSSL_PROVIDER−FIPS (7)
HISTORYThe functions described here were added in OpenSSL 3.0.
COPYRIGHTCopyright 2020 The OpenSSL Project Authors. All Rights Reserved. Licensed under the Apache License 2.0 (the ‟License”). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at <https://www.openssl.org/source/license.html>. 0
Johanes Gumabo
Data Size   :   18,374 byte
man-OSSL_SELF_TEST_oncorrupt_byte.3osslBuild   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   3 / 200,220
Visitor ID   :     :  
Visitor IP   :   3.147.78.185   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36
Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.
ERROR : Need New Coding :         (parse_manual_page_|249|O___SSL_SELF_TEST_free.3ossl|36/37|el══─{─══.|.el══─{─══. ds -- \|\(em\| )         (htmlprn|149|O___SSL_SELF_TEST_free.3ossl|36/37|.el══─{─══. ds --  —  |.el══─{─══. ds -- \|\(em\| )         (parse_manual_page_|249|O___SSL_SELF_TEST_free.3ossl|43|br══─}─══|'br══─}─══ )         (htmlprn|149|O___SSL_SELF_TEST_free.3ossl|43|'br══─}─══ |'br══─}─══ )