RSA BSAFE Micro Edition Suite

Streamlined security for mobile and embedded devices
Search  Print

Diagnostic Callback Functions

This section describes the functions used to trace the state changes of the SSL handshake.

Typedefs

typedef void R_CDECL SSL_INFO_CB_T (SSL *ssl, int where, int ret)
 Type of callback function that reports on the SSL protocol state. More...


Functions

void R_CDECL SSL_CTX_set_info_cb (SSL_CTX *ctx, SSL_INFO_CB_T *cb)
 Sets the information callback for the SSL_CTX structure ctx. More...

SSL_INFO_CB_T* R_CDECL SSL_CTX_get_info_cb (SSL_CTX *ctx)
 Returns the information callback for the SSL_CTX structure ctx. More...

void SSL_set_info_cb (SSL *ssl, SSL_INFO_CB_T *cb)
 Sets the information callback in the ssl structure by directly accessing the structure. More...

SSL_INFO_CB_T * SSL_get_info_cb (SSL *ssl)
 Returns the information callback reference from ssl by directly accessing the ssl structure. More...

Typedef Documentation

typedef void R_CDECL SSL_INFO_CB_T(SSL *ssl, int where, int ret)
 

Type of callback function that reports on the SSL protocol state.

Parameters:
ssl [In] An SSL reference.
where [In] The current SSL protocol state.
See Protocol State Identifiers for valid values.
ret [In] The current success flag. One of:
  • 0.
  • 1.
    • See also:
    SSL_set_info_cb(), SSL_get_info_cb(), SSL_CTX_set_info_cb() and SSL_CTX_get_info_cb().

    Function Documentation

    SSL_INFO_CB_T* R_CDECL SSL_CTX_get_info_cb (  SSL_CTX *    ctx )  ;
     

    Returns the information callback for the SSL_CTX structure ctx.

    Parameters:
    ctx [In] An SSL_CTX reference from which the default information callback reference is retrieved.
    Returns:
    The callback function invoked at key points during the handshake.
    See also:
    SSL_CTX_set_info_cb() and SSL_get_info_cb().

    void R_CDECL SSL_CTX_set_info_cb (  SSL_CTX *    ctx,
    SSL_INFO_CB_T *    cb
    )  ;
     

    Sets the information callback for the SSL_CTX structure ctx.

    Parameters:
    ctx [In] The SSL_CTX reference.
    cb [In] The callback function invoked at key points during handshake.
    note.gif
    This function is only used when no callback is defined via SSL_set_info_cb().
    See also:
    SSL_CTX_get_ex_new_index() and SSL_CTX_set_info_cb().
    Samples:
    bio_client.c, bio_server.c, cache_server.c, nbio_client.c, nbio_server.c, p7ssl_client.c, p7ssl_server.c, sock_client.c, sock_server.c, ssl_client.c, and ssl_server.c.

    SSL_INFO_CB_T * SSL_get_info_cb (  SSL *    ssl )  ;
     

    Returns the information callback reference from ssl by directly accessing the ssl structure. The information callback is invoked during each SSL handshake state.

    Parameters:
    ssl [In] The SSL structure.
    Returns:
    info_cb NULL if not set.
    Otherwise has the form:
    void (cb *)(SSL *ssl, int where, int ret).
    note.gif
    ssl must not be NULL.
    Se