NE_SSL_CERT_READ(3)     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.

COPYRIGHT
neon 0.28.2                3 April 2008       NE_SSL_CERT_READ(3)