ne_ssl_cert_read, ne_ssl_cert_write, ne_ssl_cert_import, ne_ssl_cert_export - functions to read or write
Contents
Copyright
Copyright © 2001-2024 Joe Orton
neon 0.34.2 15 April 2025 NE_SSL_CERT_READ(3)
Description
The ne_ssl_cert_write function writes a certificate to a file using the PEM encoding. The
ne_ssl_cert_export function returns a base64-encoded NUL-terminated string representing the certificate.
This string is malloc-allocated and should be destroyed using free by the caller.
The ne_ssl_cert_read function reads a certificate from a PEM-encoded file, and returns a certificate
object. The ne_ssl_cert_import function returns a certificate object from a base64-encoded string, data,
as returned by ne_ssl_cert_export. The certificate object returned by these functions should be destroyed
using ne_ssl_cert_free after use.
Encoding Formats
The string produced by ne_ssl_cert_export is the base64 encoding of the DER representation of the
certificate. The file written by ne_ssl_cert_write uses the PEM format: this is the base64 encoding of
the DER representation with newlines every 64 characters, and start and end marker lines.
Name
ne_ssl_cert_read, ne_ssl_cert_write, ne_ssl_cert_import, ne_ssl_cert_export - functions to read or write
certificates to and from files or strings
Return Value
ne_ssl_cert_read returns NULL if a certificate could not be read from the file. ne_ssl_cert_write
returns non-zero if the certificate could not be written to the file. ne_ssl_cert_export always returns
a NUL-terminated string, and never NULL. ne_ssl_cert_import returns NULL if the string was not a valid
base64-encoded certificate.
Synopsis
#include<ne_ssl.h>ne_ssl_certificate*ne_ssl_cert_read(constchar*filename);intne_ssl_cert_write(constne_ssl_certificate*cert,constchar*filename);ne_ssl_certificate*ne_ssl_cert_import(constchar*data);char*ne_ssl_cert_export(constne_ssl_certificate*cert);
