NAME¶

PEM_read_SSL_SESSION, PEM_read_bio_SSL_SESSION, PEM_write_SSL_SESSION, PEM_write_bio_SSL_SESSION — encode and decode SSL session objects in PEM format

SYNOPSIS¶

#include <openssl/ssl.h>

SSL_SESSION *
PEM_read_SSL_SESSION(FILE *fp, SSL_SESSION **a, pem_password_cb *cb, void *u);

SSL_SESSION *
PEM_read_bio_SSL_SESSION(BIO *bp, SSL_SESSION **a, pem_password_cb *cb, void *u);

int
PEM_write_SSL_SESSION(FILE *fp, const SSL_SESSION *a);

int
PEM_write_bio_SSL_SESSION(BIO *bp, const SSL_SESSION *a);

DESCRIPTION¶

These routines convert between local instances of ASN.1 SSL_SESSION objects and the PEM encoding.

PEM_read_SSL_SESSION() reads a PEM-encoded SSL_SESSION object from the file fp and returns it. The cb and u parameters are as described in PEM_read_bio_PrivateKey(3).

PEM_read_bio_SSL_SESSION() is similar to PEM_read_SSL_SESSION() but reads from the BIO bp.

PEM_write_SSL_SESSION() writes the PEM encoding of the object a to the file fp.

PEM_write_bio_SSL_SESSION() similarly writes to the BIO bp.

RETURN VALUES¶

PEM_read_SSL_SESSION() and PEM_read_bio_SSL_SESSION() return a pointer to an allocated object, which should be released by calling SSL_SESSION_free(3), or NULL on error.

PEM_write_SSL_SESSION() and PEM_write_bio_SSL_SESSION() return the number of bytes written or 0 on error.

SEE ALSO¶

PEM_read(3), ssl(3)

HISTORY¶

PEM_read_SSL_SESSION() and PEM_write_SSL_SESSION() first appeared in SSLeay 0.5.2. PEM_read_bio_SSL_SESSION() and PEM_write_bio_SSL_SESSION() first appeared in SSLeay 0.6.0. These functions have been available since OpenBSD 2.4.