	RSA BSAFE Micro Edition Suite	Streamlined security for mobile and embedded devices

Method Functions

This section details the method functions used to specify the various client and server protocols supported by SSL connections. These functions are used in conjunction with SSL_CTX_new().

Functions
SSL_METHOD* R_CDECL	SSLv3_server_method (void)
	Specifies the SSL version 3 protocol for servers only. More...
SSL_METHOD* R_CDECL	SSLv3_client_method (void)
	Specifies the SSL version 3 protocol for clients only. More...
SSL_METHOD* R_CDECL	SSLv3_method (void)
	Specifies the SSL version 3 protocol. More...
SSL_METHOD* R_CDECL	TLSv1_method (void)
	Specifies the Transport Layer Security (TLS) version 1 protocol for both clients and servers. More...
SSL_METHOD* R_CDECL	TLSv1_server_method (void)
	Specifies the Transport Layer Security (TLS) version 1 protocol for servers only. More...
SSL_METHOD* R_CDECL	TLSv1_client_method (void)
	Specifies the Transport Layer Security (TLS) version 1 protocol for clients only. More...
int R_CDECL	SSL_set_ssl_method (SSL ssl, SSL_METHOD meth)
	Sets the SSL method meth to override the default methods that an SSL connection inherits from its SSL_CTX when establishing the SSL connection ssl. More...
SSL_METHOD *	SSL_get_ssl_method (SSL *ssl)
	Returns a reference to the SSL_METHOD structure by directly accessing the ssl structure. More...

Function Documentation

SSL_METHOD * SSL_get_ssl_method ( SSL * ssl ) ;

Returns a reference to the SSL_METHOD structure by directly accessing the ssl structure. SSL_METHOD holds pointers to functions that control the operations during an ssl session. The functions are specific to particular ssl versions.
Parameters:

ssl [In] The SSL connection reference from which to retrieve the method reference.

Returns:
A pointer to SSL_METHOD for SSL. Stores pointers to functions that control protocol operation during an SSL connection.

ssl is not NULL.

int R_CDECL SSL_set_ssl_method ( SSL * ssl,

SSL_METHOD * meth

) ;

Sets the SSL method meth to override the default methods that an SSL connection inherits from its SSL_CTX when establishing the SSL connection ssl. This allows the application to support multiple SSL versions without requiring an SSL_CTX for each one.
Parameters:

ssl [In] The SSL against which to store the method.

meth [In] The new SSL_METHOD for the SSL. Stores pointers to functions that control protocol operations during an SSL session.

Returns:
1 indicates success.
0 indicates error.

The SSL structure is reset.
See also:
SSL_get_ssl_method() and SSL_METHOD.

SSL_METHOD* R_CDECL SSLv3_client_method ( ) ;

Specifies the SSL version 3 protocol for clients only. This method is typically passed in a call to SSL_CTX_new() to specify that the SSLv3 protocol will be supported by SSL connections using that SSL_CTX.

Returns:
The SSL_METHOD pointer.
See also:
SSL_METHOD, SSL_CTX_new() and SSL_CTX.
Samples:
bio_client.c, nbio_client.c, p7ssl_client.c, simple.c, sock_client.c, and ssl_client.c.

SSL_METHOD* R_CDECL SSLv3_method ( void ) ;

Specifies the SSL version 3 protocol. This method is typically passed in a call to SSL_CTX_new() to specify that the SSLv3 protocol will be supported by SSL connections using that SSL_CTX.

Returns:
The SSL_METHOD pointer.
See also:
SSL_METHOD, SSL_CTX_new() and SSL_CTX.

SSL_METHOD* R_CDECL SSLv3_server_method ( void ) ;

Specifies the SSL version 3 protocol for servers only. This method is typically passed in a call to SSL_CTX_new() to specify that the SSLv3 protocol will be supported by SSL connections using that SSL_CTX.

Returns:
The SSL_METHOD pointer.
See also:
SSL_METHOD, SSL_CTX_new()and SSL_CTX.
Samples:
bio_server.c, cache_server.c, nbio_server.c, sock_server.c, and ssl_server.c.

SSL_METHOD* R_CDECL TLSv1_client_method ( ) ;

Specifies the Transport Layer Security (TLS) version 1 protocol for clients only. This method is typically passed in a call to SSL_CTX_new() to specify that the TLSv1 protocol will be supported by SSL connections using that SSL_CTX.

Returns:
The SSL_METHOD pointer.

This method is also capable of doing SSLv3 if option SSL_OP_NO_SSLv3 is not set using SSL_CTX_set_options().
See also:
SSL_CTX_new(), SSL_CTX_set_options().
Samples:
bio_client.c, nbio_client.c, p7ssl_client.c, simple.c, sock_client.c, and ssl_client.c.

SSL_METHOD* R_CDECL TLSv1_method ( void ) ;

Specifies the Transport Layer Security (TLS) version 1 protocol for both clients and servers. This method is typically passed in a call to SSL_CTX_new() to specify that the TLSv1 protocol will be supported by SSL connections using that SSL_CTX.

Returns:
The SSL_METHOD pointer.

This method is also capable of doing SSLv3 if the SSL_OP_NO_SSLv3 option is not set using SSL_CTX_set_options().
See also:
SSL_CTX_new() and SSL_CTX_set_options().

SSL_METHOD* R_CDECL TLSv1_server_method ( ) ;

Specifies the Transport Layer Security (TLS) version 1 protocol for servers only. This method is typically passed in a call to SSL_CTX_new() to specify that the TLSv1 protocol will be supported by SSL connections using that SSL_CTX.

Returns:
The SSL_METHOD pointer.

This method is also capable of doing SSLv3 if the SSL_OP_NO_SSLv3 option is not set using SSL_CTX_set_options().
See also:
SSL_CTX_new() and SSL_CTX_set_options().
Samples:
bio_server.c, cache_server.c, nbio_server.c, p7ssl_server.c, sock_server.c, and ssl_server.c.