OSSL_STORE_LOADER - Online Linux Manual PageSection : 3
Updated : 2021-03-26
Source : 1.1.1k
Note : OpenSSL

NAMEOSSL_STORE_LOADER, OSSL_STORE_LOADER_CTX, OSSL_STORE_LOADER_new, OSSL_STORE_LOADER_get0_engine, OSSL_STORE_LOADER_get0_scheme, OSSL_STORE_LOADER_set_open, OSSL_STORE_LOADER_set_ctrl, OSSL_STORE_LOADER_set_expect, OSSL_STORE_LOADER_set_find, OSSL_STORE_LOADER_set_load, OSSL_STORE_LOADER_set_eof, OSSL_STORE_LOADER_set_error, OSSL_STORE_LOADER_set_close, OSSL_STORE_LOADER_free, OSSL_STORE_register_loader, OSSL_STORE_unregister_loader, OSSL_STORE_open_fn, OSSL_STORE_ctrl_fn, OSSL_STORE_expect_fn, OSSL_STORE_find_fn, OSSL_STORE_load_fn, OSSL_STORE_eof_fn, OSSL_STORE_error_fn, OSSL_STORE_close_fn − Types and functions to manipulate, register and unregister STORE loaders for different URI schemes

SYNOPSIS​ #include <openssl/store.h> ​ ​ typedef struct ossl_store_loader_st OSSL_STORE_LOADER; ​ ​ OSSL_STORE_LOADER *OSSL_STORE_LOADER_new(ENGINE *e, const char *scheme); ​ const ENGINE *OSSL_STORE_LOADER_get0_engine(const OSSL_STORE_LOADER ​ *store_loader); ​ const char *OSSL_STORE_LOADER_get0_scheme(const OSSL_STORE_LOADER ​ *store_loader); ​ ​ /* struct ossl_store_loader_ctx_st is defined differently by each loader */ ​ typedef struct ossl_store_loader_ctx_st OSSL_STORE_LOADER_CTX; ​ ​ typedef OSSL_STORE_LOADER_CTX *(*OSSL_STORE_open_fn)(const char *uri, ​ const UI_METHOD *ui_method, ​ void *ui_data); ​ int OSSL_STORE_LOADER_set_open(OSSL_STORE_LOADER *store_loader, ​ OSSL_STORE_open_fn store_open_function); ​ typedef int (*OSSL_STORE_ctrl_fn)(OSSL_STORE_LOADER_CTX *ctx, int cmd, ​ va_list args); ​ int OSSL_STORE_LOADER_set_ctrl(OSSL_STORE_LOADER *store_loader, ​ OSSL_STORE_ctrl_fn store_ctrl_function); ​ typedef int (*OSSL_STORE_expect_fn)(OSSL_STORE_LOADER_CTX *ctx, int expected); ​ int OSSL_STORE_LOADER_set_expect(OSSL_STORE_LOADER *loader, ​ OSSL_STORE_expect_fn expect_function); ​ typedef int (*OSSL_STORE_find_fn)(OSSL_STORE_LOADER_CTX *ctx, ​ OSSL_STORE_SEARCH *criteria); ​ int OSSL_STORE_LOADER_set_find(OSSL_STORE_LOADER *loader, ​ OSSL_STORE_find_fn find_function); ​ typedef OSSL_STORE_INFO *(*OSSL_STORE_load_fn)(OSSL_STORE_LOADER_CTX *ctx, ​ UI_METHOD *ui_method, ​ void *ui_data); ​ int OSSL_STORE_LOADER_set_load(OSSL_STORE_LOADER *store_loader, ​ OSSL_STORE_load_fn store_load_function); ​ typedef int (*OSSL_STORE_eof_fn)(OSSL_STORE_LOADER_CTX *ctx); ​ int OSSL_STORE_LOADER_set_eof(OSSL_STORE_LOADER *store_loader, ​ OSSL_STORE_eof_fn store_eof_function); ​ typedef int (*OSSL_STORE_error_fn)(OSSL_STORE_LOADER_CTX *ctx); ​ int OSSL_STORE_LOADER_set_error(OSSL_STORE_LOADER *store_loader, ​ OSSL_STORE_error_fn store_error_function); ​ typedef int (*OSSL_STORE_close_fn)(OSSL_STORE_LOADER_CTX *ctx); ​ int OSSL_STORE_LOADER_set_close(OSSL_STORE_LOADER *store_loader, ​ OSSL_STORE_close_fn store_close_function); ​ void OSSL_STORE_LOADER_free(OSSL_STORE_LOADER *store_loader); ​ ​ int OSSL_STORE_register_loader(OSSL_STORE_LOADER *loader); ​ OSSL_STORE_LOADER *OSSL_STORE_unregister_loader(const char *scheme);

DESCRIPTIONThese functions help applications and engines to create loaders for schemes they support.

TypesOSSL_STORE_LOADER is the type to hold a loader. It contains a scheme and the functions needed to implement ​OSSL_STORE_open(), OSSL_STORE_load(), OSSL_STORE_eof(), OSSL_STORE_error() and ​OSSL_STORE_close() for this scheme. OSSL_STORE_LOADER_CTX is a type template, to be defined by each loader using struct ossl_store_loader_ctx_st { ... }. OSSL_STORE_open_fn, OSSL_STORE_ctrl_fn, OSSL_STORE_expect_fn, ​OSSL_STORE_find_fn, OSSL_STORE_load_fn, OSSL_STORE_eof_fn, and OSSL_STORE_close_fn are the function pointer types used within a STORE loader. The functions pointed at define the functionality of the given loader. OSSL_STORE_open_fn This function takes a URI and is expected to interpret it in the best manner possible according to the scheme the loader implements, it also takes a UI_METHOD and associated data, to be used any time something needs to be prompted for. Furthermore, this function is expected to initialize what needs to be initialized, to create a private data store (OSSL_STORE_LOADER_CTX, see above), and to return it. If something goes wrong, this function is expected to return NULL. OSSL_STORE_ctrl_fn This function takes a OSSL_STORE_LOADER_CTX pointer, a command number ​cmd and a va_list args and is used to manipulate loader specific parameters. Loader specific command numbers must begin at OSSL_STORE_C_CUSTOM_START. Any number below that is reserved for future globally known command numbers. This function is expected to return 1 on success, 0 on error. OSSL_STORE_expect_fn This function takes a OSSL_STORE_LOADER_CTX pointer and a OSSL_STORE_INFO identity expected, and is used to tell the loader what object type is expected. ​expected may be zero to signify that no specific object type is expected. This function is expected to return 1 on success, 0 on error. OSSL_STORE_find_fn This function takes a OSSL_STORE_LOADER_CTX pointer and a ​OSSL_STORE_SEARCH search criterion, and is used to tell the loader what to search for. When called with the loader context being NULL, this function is expected to return 1 if the loader supports the criterion, otherwise 0. When called with the loader context being something other than NULL, this function is expected to return 1 on success, 0 on error. OSSL_STORE_load_fn This function takes a OSSL_STORE_LOADER_CTX pointer and a UI_METHOD with associated data. It's expected to load the next available data, mold it into a data structure that can be wrapped in a OSSL_STORE_INFO using one of the ​OSSL_STORE_INFO(3) functions. If no more data is available or an error occurs, this function is expected to return NULL. The OSSL_STORE_eof_fn and OSSL_STORE_error_fn functions must indicate if it was in fact the end of data or if an error occurred. Note that this function retrieves one data item only. OSSL_STORE_eof_fn This function takes a OSSL_STORE_LOADER_CTX pointer and is expected to return 1 to indicate that the end of available data has been reached. It is otherwise expected to return 0. OSSL_STORE_error_fn This function takes a OSSL_STORE_LOADER_CTX pointer and is expected to return 1 to indicate that an error occurred in a previous call to the ​OSSL_STORE_load_fn function. It is otherwise expected to return 0. OSSL_STORE_close_fn This function takes a OSSL_STORE_LOADER_CTX pointer and is expected to close or shut down what needs to be closed, and finally free the contents of the OSSL_STORE_LOADER_CTX pointer. It returns 1 on success and 0 on error.

FunctionsOSSL_STORE_LOADER_new() creates a new OSSL_STORE_LOADER. It takes an ENGINE e and a string scheme. ​scheme must always be set. Both e and scheme are used as is and must therefore be alive as long as the created loader is. OSSL_STORE_LOADER_get0_engine() returns the engine of the store_loader. ​OSSL_STORE_LOADER_get0_scheme() returns the scheme of the store_loader. OSSL_STORE_LOADER_set_open() sets the opener function for the ​store_loader. OSSL_STORE_LOADER_set_ctrl() sets the control function for the ​store_loader. OSSL_STORE_LOADER_set_expect() sets the expect function for the ​store_loader. OSSL_STORE_LOADER_set_load() sets the loader function for the ​store_loader. OSSL_STORE_LOADER_set_eof() sets the end of file checker function for the ​store_loader. OSSL_STORE_LOADER_set_close() sets the closing function for the ​store_loader. OSSL_STORE_LOADER_free() frees the given store_loader. OSSL_STORE_register_loader() register the given store_loader and thereby makes it available for use with OSSL_STORE_open(), OSSL_STORE_load(), ​OSSL_STORE_eof() and OSSL_STORE_close(). OSSL_STORE_unregister_loader() unregister the store loader for the given ​scheme.

NOTESThe file: scheme has built in support.

RETURN VALUESThe functions with the types OSSL_STORE_open_fn, OSSL_STORE_ctrl_fn, ​OSSL_STORE_expect_fn, ​OSSL_STORE_load_fn, OSSL_STORE_eof_fn and OSSL_STORE_close_fn have the same return values as OSSL_STORE_open(), OSSL_STORE_ctrl(), OSSL_STORE_expect(), ​OSSL_STORE_load(), OSSL_STORE_eof() and OSSL_STORE_close(), respectively. OSSL_STORE_LOADER_new() returns a pointer to a OSSL_STORE_LOADER on success, or NULL on failure. OSSL_STORE_LOADER_set_open(), OSSL_STORE_LOADER_set_ctrl(), ​OSSL_STORE_LOADER_set_load(), OSSL_STORE_LOADER_set_eof() and ​OSSL_STORE_LOADER_set_close() return 1 on success, or 0 on failure. OSSL_STORE_register_loader() returns 1 on success, or 0 on failure. OSSL_STORE_unregister_loader() returns the unregistered loader on success, or NULL on failure.

SEE ALSOossl_store(7), OSSL_STORE_open(3)

HISTORYOSSL_STORE_LOADER(), OSSL_STORE_LOADER_CTX(), OSSL_STORE_LOADER_new(), ​OSSL_STORE_LOADER_set0_scheme(), OSSL_STORE_LOADER_set_open(), ​OSSL_STORE_LOADER_set_ctrl(), OSSL_STORE_LOADER_set_load(), ​OSSL_STORE_LOADER_set_eof(), OSSL_STORE_LOADER_set_close(), ​OSSL_STORE_LOADER_free(), OSSL_STORE_register_loader(), ​OSSL_STORE_unregister_loader(), OSSL_STORE_open_fn(), OSSL_STORE_ctrl_fn(), ​OSSL_STORE_load_fn(), OSSL_STORE_eof_fn() and OSSL_STORE_close_fn() were added in OpenSSL 1.1.1.

COPYRIGHTCopyright 2016−2019 The OpenSSL Project Authors. All Rights Reserved. Licensed under the OpenSSL license (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   :   33,717 byte
man-OSSL_STORE_LOADER_set_find.3sslBuild   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   3 / 181,925
Visitor ID   :     :  
Visitor IP   :   18.221.161.43   :  
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_STORE_close_fn.3ssl|36/37|el══─{─══.|.el══─{─══. ds -- \|\(em\| )         (htmlprn|149|O___SSL_STORE_close_fn.3ssl|36/37|.el══─{─══. ds --  —  |.el══─{─══. ds -- \|\(em\| )         (parse_manual_page_|249|O___SSL_STORE_close_fn.3ssl|43|br══─}─══|'br══─}─══ )         (htmlprn|149|O___SSL_STORE_close_fn.3ssl|43|'br══─}─══ |'br══─}─══ )