CTLOG_STORE_GET0_LOG_BY_ID

Section: OpenSSL (3)
Updated: 2021-03-26
Page Index

NAME

CTLOG_STORE_get0_log_by_id - Get a Certificate Transparency log from a CTLOG_STORE

SYNOPSIS

 #include <openssl/ct.h>

 const CTLOG *CTLOG_STORE_get0_log_by_id(const CTLOG_STORE *store,
                                         const uint8_t *log_id,
                                         size_t log_id_len);

DESCRIPTION

A Signed Certificate Timestamp (SCT) identifies the Certificate Transparency (CT) log that issued it using the log's LogID (see RFC 6962, Section 3.2). Therefore, it is useful to be able to look up more information about a log (e.g. its public key) using this LogID.

CTLOG_STORE_get0_log_by_id() provides a way to do this. It will find a CTLOG in a CTLOG_STORE that has a given LogID.

RETURN VALUES

CTLOG_STORE_get0_log_by_id returns a CTLOG with the given LogID, if it exists in the given CTLOG_STORE, otherwise it returns NULL.

HISTORY

The CTLOG_STORE_get0_log_by_id() function was added in OpenSSL 1.1.0.

COPYRIGHT

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>.