neon API reference NE_SSL_CERT_READ(3)
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
SYNOPSIS
#include
ne_ssl_certificate *ne_ssl_cert_read(const char *filename);
int ne_ssl_cert_write(const ne_ssl_certificate *cert,
const char *filename);
ne_ssl_certificate *ne_ssl_cert_import(const char *data);
char *ne_ssl_cert_export(const ne_ssl_certificate *cert);
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.
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.
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.
AUTHOR
Joe Orton
Author.
neon 0.29.0 Last change: 13 September 2009 1
neon API reference NE_SSL_CERT_READ(3)
COPYRIGHT
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
_______________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE|
|____________________|__________________|_
| Availability | library/neon |
|____________________|__________________|_
| Interface Stability| Volatile |
|____________________|_________________|
NOTES
Source for Neon is available on http://opensolaris.org.
neon 0.29.0 Last change: 13 September 2009 2