opensolaris man page for ne_ssl_cert_read

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-en-
       coded 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 func-
       tion 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(3) 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@webdav.org>.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWneon	      |
       +--------------------+-----------------+
       |Interface Stability | Volatile	      |
       +--------------------+-----------------+
NOTES
       Source for Neon is available on http://opensolaris.org.

neon 0.25.5							  20 January 2006					       NE_SSL_CERT_READ(3)