www.beck-ipc.com

@CHIP-RTOS C Library V2.06 - TCP/IP API


SSL_ClientStart

Call this function to start the SSL client and SSL handshaking. Before this call, the user should set proper socket options on socket descriptor.

int SSL_ClientStart(int sd, char far * srvCommonName, int *error);

Parameters

sd

Socket descriptor

srvCommonName

Server common name.
The common name is used to verify the certificate of the peer. If user passes in a NULL string, the certificate identity is not checked. This means, any valid certificate, even if it belongs to a bad party, will be accepted.

error

Output parameter:  Failure code, 0 on success.

Return Value

0: Success
-1: failed

Comments

The certificate identity (common name field) may contain the wildcard character which is considered to match any single domain name component or component fragment. E.g., "*.a.com" in certificate Common Name matches the server common name "foo.a.com" but not "bar.foo.a.com". And certificate common name "f*.com" matches server common name "foo.com" but not "bar.com".

See Also

RTOS API

This library function invokes a RTOS software interrupt. Refer to this RTOS API function's documentation for more details.

Supported since or modified in @CHIP-RTOS version

    SC12SC13SC11SC1x3
    n/an/an/aV0.91

Supported by @CHIP-RTOS C Library since version

    CLIB
    V2.02

This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document