TLSLIB.h

Go to the documentation of this file.

#ifndef TLSLIB_H
#define TLSLIB_H

    #ifndef UINT32

    typedef unsigned long UINT32;
    #endif

    #ifndef UINT16

    typedef unsigned short UINT16;
    #endif

    #ifndef UINT8

    typedef unsigned char UINT8;
    #endif

    #ifndef BOOL

typedef UINT8 BOOL;
#endif

#ifndef TRUE

#    define TRUE        ( (BOOL)1 )
#endif

#ifndef FALSE

#    define FALSE       ( (BOOL)0 )
#endif

#ifndef SOCKET
    typedef UINT8 SOCKET;
#endif

    typedef int (*PointerToSend)(SOCKET pSocket, const UINT8* pBuffer, UINT32 len_buffer);

    typedef int (*PointerToReceive)(SOCKET pSocket, UINT8* const pBuffer, UINT32 len_buffer);

    typedef void (*PointerToCloseSocket)(SOCKET pSocket);

    typedef void* (*PointerToMalloc)(UINT32 size);

    typedef void (*PointerToFree)(void* pMemory);

    typedef void* (*PointerToRealloc)(void* pMemory, UINT32 new_size);

#if eWBM
    typedef int (*PointerToTRNG)(void* out, uint32_t readSz, const void* reseed);
#else
    typedef int (*PointerToTRNG)(UINT8 rng[32]);
#endif

extern int TLSShutdown(const void** ppSession);

//TODO Document the new parameters for dynamic certs!
extern int TLSEngine(SOCKET pSocket,
                    const void** ppSession,
                    const char fqdn[], const UINT8 len_fqdn,
                    PointerToSend Send,
                    PointerToReceive Receive,
                    PointerToCloseSocket CloseSocket,
                    PointerToMalloc Malloc,
                    PointerToFree Free,
                    PointerToRealloc Realloc,
                    PointerToTRNG pbTRNG,
                    UINT8 mode_of_operation,
                    BOOL bClientMode_Tolerate_FQDN_Mismatch,
                    BOOL bClientMode_Skip_Authorised_Root_CA_Check,
                    BOOL client_certificate_request,    // new in 1.1: client certificate request by Server (in Server Mode)
                    const UINT8 server_cert[], const UINT32 len_server_cert,
                    const UINT8 ca_cert[], const UINT32 len_ca_cert,
                    const UINT8 client_cert[], const UINT32 len_client_cert,
                    const UINT8 server_rsa_private_key[], const UINT32 len_server_rsa_private_key,
                    const UINT8 client_rsa_private_key[], const UINT32 len_client_rsa_private_key);


extern int TLSReadAppData(const void* const* ppCurrentSession,
                          UINT8 output_buffer[], UINT32* len_output_buffer );
extern int TLSWriteAppData(const void* const* ppCurrentSession,
                           const UINT8 data[], UINT32 len_data);


#endif