SSL_new

The SSL_new function creates a new Secure Sockets Layer (SSL) structure for use with an SSL session.

Last updated

  • Changed in 2019.
  • Changed for PUT13.
  • Changed for PUT00.

Format

LIBS := CSSL 
#include <openssl/ssl.h>
SSL *SSL_new(SSL_CTX *ctx)
ctx
A pointer to a token returned on the SSL_CTX_new call or the SSL_CTX_new_shared call.

Normal return

Returns a token that represents a new SSL structure.

Error return

A NULL pointer indicates an error.

Programming considerations

  • To use this function, you must include the library that is specified in the prototype in your makefile.
  • Before calling the SSL_new function, you must call one of the following functions to set up the connection method:
    • TLS_server_method
    • TLS_client_method
  • Use the output of this function as input to subsequent functions that require an SSL structure as input.

Examples

For sample SSL applications, see SSL examples.