@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-
SC12 | SC13 | SC11 | SC1x3 |
-
n/a | n/a | n/a | V0.91 |
Supported by @CHIP-RTOS C Library since version
This API List
List of C Libraries
@CHIP-RTOS Main Index
End of document
|