man pages section 3: Library Interfaces and Headers

ne_ssl_cert_export (3)

Name

ne_ssl_cert_export - ne_ssl_cert_read, ne_ssl_cert_write, ne_ssl_cert_import, functions to read or write certificates to and from files or strings

Synopsis

#include <ne_ssl.h>

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

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

       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 <neon@lists.manyfish.co.uk>
           Author.

COPYRIGHT
ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/neon     |
       +---------------+------------------+
       |Stability      | Volatile         |
       +---------------+------------------+

NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       http://www.webdav.org/neon/neon-0.30.1.tar.gz.

       Further information about this software can be found on the open source
       community website at http://www.webdav.org/neon/.



neon 0.30.1                    23 September 2014           NE_SSL_CERT_READ(3)