UUID Handling

Collaboration diagram for UUID Handling:

Data Structures
struct	switch_uuid_t

Macros
#define	SWITCH_UUID_FORMATTED_LENGTH   256
#define	SWITCH_MD5_DIGESTSIZE   16
#define	SWITCH_MD5_DIGEST_STRING_SIZE   33

Functions
void	switch_uuid_format (char *buffer, const switch_uuid_t *uuid)
void	switch_uuid_get (switch_uuid_t *uuid)
switch_status_t	switch_uuid_parse (switch_uuid_t *uuid, const char *uuid_str)
switch_status_t	switch_md5 (unsigned char digest[SWITCH_MD5_DIGESTSIZE], const void *input, switch_size_t inputLen)
switch_status_t	switch_md5_string (char digest_str[SWITCH_MD5_DIGEST_STRING_SIZE], const void *input, switch_size_t inputLen)

Detailed Description

Macro Definition Documentation

SWITCH_MD5_DIGEST_STRING_SIZE

#define SWITCH_MD5_DIGEST_STRING_SIZE   33

Definition at line 548 of file switch_apr.h.

SWITCH_MD5_DIGESTSIZE

#define SWITCH_MD5_DIGESTSIZE   16

Definition at line 547 of file switch_apr.h.

Referenced by switch_md5_string().

SWITCH_UUID_FORMATTED_LENGTH

#define SWITCH_UUID_FORMATTED_LENGTH   256

UUIDs are formatted as: 00112233-4455-6677-8899-AABBCCDDEEFF

Definition at line 545 of file switch_apr.h.

Referenced by switch_caller_profile_dup(), switch_caller_profile_new(), switch_core_perform_file_open(), switch_core_session_exec(), switch_core_session_perform_get_partner(), switch_ivr_insert_file(), switch_ivr_intercept_session(), switch_msrp_do_send(), and switch_uuid_str().

Function Documentation

switch_md5()

switch_status_t switch_md5	(	unsigned char	digest[SWITCH_MD5_DIGESTSIZE],
		const void *	input,
		switch_size_t	inputLen
	)

MD5 in one step

Parameters

digest	The final MD5 digest
input	The message block to use
inputLen	The length of the message block

Definition at line 1175 of file switch_apr.c.

References SWITCH_STATUS_NOTIMPL, and SWITCH_STATUS_SUCCESS.

Referenced by switch_md5_string().

{
#if (defined(HAVE_LIBMD5) || defined(HAVE_LIBMD) || defined(HAVE_MD5INIT))
        MD5_CTX md5_context;

        MD5Init(&md5_context);
        MD5Update(&md5_context, input, inputLen);
        MD5Final(digest, &md5_context);

        return SWITCH_STATUS_SUCCESS;
#elif defined(HAVE_LIBCRYPTO)
        #if OPENSSL_VERSION_NUMBER < 0x30000000
                MD5_CTX md5_context;

                MD5_Init(&md5_context);
                MD5_Update(&md5_context, input, inputLen);
                MD5_Final(digest, &md5_context);
        #else
                EVP_MD_CTX *md5_context;

                /* MD5_Init */
                md5_context = EVP_MD_CTX_new();
                EVP_DigestInit_ex(md5_context, EVP_md5(), NULL);
                /* MD5_Update */
                EVP_DigestUpdate(md5_context, input, inputLen);
                /* MD5_Final */
                EVP_DigestFinal_ex(md5_context, digest, NULL);
                EVP_MD_CTX_free(md5_context);
        #endif

        return SWITCH_STATUS_SUCCESS;
#else
        return SWITCH_STATUS_NOTIMPL;
#endif
}

switch_md5_string()

switch_status_t switch_md5_string	(	char	digest_str[SWITCH_MD5_DIGEST_STRING_SIZE],
		const void *	input,
		switch_size_t	inputLen
	)

Definition at line 1211 of file switch_apr.c.

References b, switch_md5(), and SWITCH_MD5_DIGESTSIZE.

{
        unsigned char digest[SWITCH_MD5_DIGESTSIZE];
        switch_status_t status = switch_md5(digest, input, inputLen);
        short i, x;
        uint8_t b;

        digest_str[SWITCH_MD5_DIGEST_STRING_SIZE - 1] = '\0';

        for (x = i = 0; x < SWITCH_MD5_DIGESTSIZE; x++) {
                b = (digest[x] >> 4) & 15;
                digest_str[i++] = b + (b > 9 ? 'a' - 10 : '0');
                b = digest[x] & 15;
                digest_str[i++] = b + (b > 9 ? 'a' - 10 : '0');
        }
        digest_str[i] = '\0';

        return status;
}

switch_uuid_format()

void switch_uuid_format	(	char *	buffer,
		const switch_uuid_t *	uuid
	)

Format a UUID into a string, following the standard format

Parameters

buffer	The buffer to place the formatted UUID string into. It must be at least APR_UUID_FORMATTED_LENGTH + 1 bytes long to hold the formatted UUID and a null terminator
uuid	The UUID to format

Definition at line 1140 of file switch_apr.c.

References buf, and switch_uuid_t::data.

Referenced by switch_core_init(), switch_core_perform_file_open(), switch_core_session_request_uuid(), switch_ivr_insert_file(), and switch_uuid_str().

{
#ifndef WIN32
        uuid_unparse_lower(uuid->data, buffer);
#else
        RPC_CSTR buf;
        UuidToString((const UUID *) uuid, &buf);
        strcpy(buffer, (const char *) buf);
        RpcStringFree(&buf);
#endif
}

switch_uuid_get()

void switch_uuid_get

(

switch_uuid_t *

uuid

)

Generate and return a (new) UUID

Parameters

uuid	The resulting UUID

Definition at line 1152 of file switch_apr.c.

References switch_uuid_t::data, runtime, switch_mutex_lock(), switch_mutex_unlock(), and switch_runtime::uuid_mutex.

Referenced by switch_core_init(), switch_core_perform_file_open(), switch_core_session_request_uuid(), switch_ivr_insert_file(), and switch_uuid_str().

{
        switch_mutex_lock(runtime.uuid_mutex);
#ifndef WIN32
        uuid_generate(uuid->data);
#else
        UuidCreate((UUID *) uuid);
#endif
        switch_mutex_unlock(runtime.uuid_mutex);
}

switch_uuid_parse()

switch_status_t switch_uuid_parse	(	switch_uuid_t *	uuid,
		const char *	uuid_str
	)

Parse a standard-format string into a UUID

Parameters

uuid	The resulting UUID
uuid_str	The formatted UUID

Definition at line 1163 of file switch_apr.c.

References switch_uuid_t::data, SWITCH_STATUS_FALSE, and SWITCH_STATUS_SUCCESS.

{
#ifndef WIN32
        if (uuid_parse(uuid_str, uuid->data)) {
                return SWITCH_STATUS_FALSE;
        }
        return SWITCH_STATUS_SUCCESS;
#else
        return UuidFromString((RPC_CSTR) uuid_str, (UUID *) uuid);
#endif
}