ne_ssl_cert_cmp3

Usage

#include <ne_header.h>

Overview

The ne_ssl_cert_cmp function can be used to compare two certificate objects; it returns zero if they refer to the same certificate, and non-zero otherwise.

The ne_ssl_cert_free function can be used to destroy a certificate object when it is no longer needed.

The ne_ssl_cert_digest function writes a human-readable fingerprint as a NUL-terminated string to the digest buffer provided, in the format "aa:bb...:ff". The digest buffer must be at least NE_SSL_DIGESTLEN bytes in length.

The ne_ssl_cert_hdigest function returns a human-readable fingerprint for the certificate object. The flags parameter specifies the hash formatting options as if passed to ne_strhash(3). The returned string is malloc-allocated and must be freed after use.

The ne_ssl_cert_validity_time function retrieves both the time from which the certificate is valid from and until. Each time is returned through the from and until parameters, which are written as (time_t)-1 if either time cannot be represented as a time_t value. The ne_ssl_cert_validity function similarly writes the validity times to the string buffers provided, using RFC 1123-style date formatting (not localized). The output parameters must be at least NE_SSL_VDATELEN bytes in length. Either parameter can be passed as NULL.

Return value

ne_ssl_cert_cmp returns 0 if the certificates are the same, and non-zero otherwise. ne_ssl_cert_digest returns 0 on success or non-zero on error. The return value of ne_ssl_cert_hdigest is a NUL-terminated malloc-allocated string, or NULL if the hash cannot be created.