/** msi.c * * Copyright (C) 2013 Tox project All Rights Reserved. * * This file is part of Tox. * * Tox is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * Tox is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with Tox. If not, see . * */ #ifdef HAVE_CONFIG_H #include "config.h" #endif /* HAVE_CONFIG_H */ #include "../toxcore/logger.h" #include "../toxcore/util.h" #include "msi.h" #include #include #include #include #define MSI_MAXMSG_SIZE 256 /* Define default timeout for a request. * There is no behavior specified by the msi on what will * client do on timeout, but to call timeout callback. */ #define m_deftout 10000 /* in milliseconds */ /** * Protocol: * * |id [1 byte]| |size [1 byte]| |data [$size bytes]| |...{repeat}| |0 {end byte}| */ typedef enum { IDRequest = 1, IDResponse, IDReason, IDCallType, IDCallId, } MSIHeaderID; typedef enum { TypeRequest, TypeResponse, } MSIMessageType; typedef enum { invite, start, cancel, reject, end, } MSIRequest; typedef enum { ringing, starting, ending, error } MSIResponse; #define GENERIC_HEADER(header, val_type) \ typedef struct _MSIHeader##header { \ val_type value; \ _Bool exists; \ } MSIHeader##header; GENERIC_HEADER ( Request, MSIRequest ) GENERIC_HEADER ( Response, MSIResponse ) GENERIC_HEADER ( CallType, MSICallType ) GENERIC_HEADER ( CallId, MSICallIDType ) GENERIC_HEADER ( Reason, MSIReasonStrType ) /** * @brief This is the message structure. It contains all of the headers and * destination/source of the message stored in friend_id. * */ typedef struct _MSIMessage { MSIHeaderRequest request; MSIHeaderResponse response; MSIHeaderCallType calltype; MSIHeaderReason reason; MSIHeaderCallId callid; int friend_id; } MSIMessage; inline__ void invoke_callback(MSISession *session, int32_t call_index, MSICallbackID id) { if ( session->callbacks[id].function ) { LOGGER_DEBUG("Invoking callback function: %d", id); session->callbacks[id].function ( session->agent_handler, call_index, session->callbacks[id].data ); } } /** * @brief Parse raw 'data' received from socket into MSIMessage struct. * Every message has to have end value of 'end_byte' or _undefined_ behavior * occures. The best practice is to check the end of the message at the handle_packet. * * @param msg Container. * @param data The data. * @return int * @retval -1 Error occurred. * @retval 0 Success. */ static int parse_raw_data ( MSIMessage *msg, const uint8_t *data, uint16_t length ) { #define FAIL_CONSTRAINT(constraint, wanted) if ((constraint -= wanted) < 1) { LOGGER_ERROR("Read over length!"); return -1; } #define FAIL_SIZE(byte, valid) if ( byte != valid ) { LOGGER_ERROR("Invalid data size!"); return -1; } #define FAIL_LIMITS(byte, low, high) if ( byte < low || byte > high ) { LOGGER_ERROR("Invalid data!"); return -1; } if ( msg == NULL ) { LOGGER_ERROR("Could not parse message: no storage!"); return -1; } if ( data[length - 1] ) { /* End byte must have value 0 */ LOGGER_ERROR("Invalid end byte"); return -1; } const uint8_t *it = data; int size_constraint = length; while ( *it ) {/* until end byte is hit */ switch (*it) { case IDRequest: FAIL_CONSTRAINT(size_constraint, 3); FAIL_SIZE(it[1], 1); FAIL_LIMITS(it[2], invite, end); msg->request.value = it[2]; it += 3; msg->request.exists = 1; break; case IDResponse: FAIL_CONSTRAINT(size_constraint, 3); FAIL_SIZE(it[1], 1); FAIL_LIMITS(it[2], ringing, error); msg->response.value = it[2]; it += 3; msg->response.exists = 1; break; case IDCallType: FAIL_CONSTRAINT(size_constraint, 3); FAIL_SIZE(it[1], 1); FAIL_LIMITS(it[2], type_audio, type_video); msg->calltype.value = it[2]; it += 3; msg->calltype.exists = 1; break; case IDCallId: FAIL_CONSTRAINT(size_constraint, sizeof(MSICallIDType) + 2); FAIL_SIZE(it[1], sizeof(MSICallIDType)); memcpy(msg->callid.value, it + 2, sizeof(MSICallIDType)); it += sizeof(MSICallIDType) + 2; msg->callid.exists = 1; break; case IDReason: FAIL_CONSTRAINT(size_constraint, sizeof(MSIReasonStrType) + 2); FAIL_SIZE(it[1], sizeof(MSIReasonStrType)); memcpy(msg->reason.value, it + 2, sizeof(MSIReasonStrType)); it += sizeof(MSIReasonStrType) + 2; msg->reason.exists = 1; break; default: LOGGER_ERROR("Invalid id byte"); return -1; break; } } return 0; } /** * @brief Create the message. * * @param type Request or response. * @param type_id Type of request/response. * @return MSIMessage* Created message. * @retval NULL Error occurred. */ MSIMessage *msi_new_message ( MSIMessageType type, const uint8_t type_value ) { MSIMessage *retu = calloc ( sizeof ( MSIMessage ), 1 ); if ( retu == NULL ) { LOGGER_WARNING("Allocation failed! Program might misbehave!"); return NULL; } if ( type == TypeRequest ) { retu->request.exists = 1; retu->request.value = type_value; } else { retu->response.exists = 1; retu->response.value = type_value; } return retu; } /** * @brief Parse data from handle_packet. * * @param data The data. * @return MSIMessage* Parsed message. * @retval NULL Error occurred. */ MSIMessage *parse_recv ( const uint8_t *data, uint16_t length ) { if ( data == NULL ) { LOGGER_WARNING("Tried to parse empty message!"); return NULL; } MSIMessage *retu = calloc ( sizeof ( MSIMessage ), 1 ); if ( retu == NULL ) { LOGGER_WARNING("Allocation failed! Program might misbehave!"); return NULL; } if ( parse_raw_data ( retu, data, length ) == -1 ) { free ( retu ); return NULL; } return retu; } /** * @brief Speaks for it self. * * @param dest Container. * @param header_field Field. * @param header_value Field value. * @param value_len Length of field value. * @param length Pointer to container length. * @return uint8_t* Iterated container. */ uint8_t *format_output ( uint8_t *dest, MSIHeaderID id, const void *value, uint8_t value_len, uint16_t *length ) { if ( dest == NULL ) { LOGGER_ERROR("No destination space!"); return NULL; } if (value == NULL || value_len == 0) { LOGGER_ERROR("Empty header value"); return NULL; } *dest = id; dest ++; *dest = value_len; dest ++; memcpy(dest, value, value_len); *length += (2 + value_len); return dest + value_len; /* Set to next position ready to be written */ } /** * @brief Parse MSIMessage to send. * * @param msg The message. * @param dest Destination. * @return uint16_t Its final size. */ uint16_t parse_send ( MSIMessage *msg, uint8_t *dest ) { if (msg == NULL) { LOGGER_ERROR("No message!"); return 0; } if (dest == NULL ) { LOGGER_ERROR("No destination!"); return 0; } uint8_t *it = dest; uint16_t size = 0; if (msg->request.exists) { uint8_t cast = msg->request.value; it = format_output(it, IDRequest, &cast, 1, &size); } if (msg->response.exists) { uint8_t cast = msg->response.value; it = format_output(it, IDResponse, &cast, 1, &size); } if (msg->calltype.exists) { uint8_t cast = msg->calltype.value; it = format_output(it, IDCallType, &cast, 1, &size); } if (msg->callid.exists) { it = format_output(it, IDCallId, &msg->callid.value, sizeof(msg->callid.value), &size); } if (msg->reason.exists) { it = format_output(it, IDReason, &msg->reason.value, sizeof(msg->reason.value), &size); } *it = 0; size ++; return size; } void msi_msg_set_calltype ( MSIMessage *msg, const MSICallType value ) { if ( !msg ) return; msg->calltype.exists = 1; msg->calltype.value = value; } void msi_msg_set_reason ( MSIMessage *msg, const MSIReasonStrType value ) { if ( !msg ) return; msg->reason.exists = 1; memcpy(msg->reason.value, value, sizeof(MSIReasonStrType)); } void msi_msg_set_callid ( MSIMessage *msg, const MSICallIDType value ) { if ( !msg ) return; msg->callid.exists = 1; memcpy(msg->callid.value, value, sizeof(MSICallIDType)); } typedef struct _Timer { void *(*func)(void *); void *func_arg1; int func_arg2; uint64_t timeout; size_t idx; } Timer; typedef struct _TimerHandler { Timer **timers; pthread_mutex_t mutex; size_t max_capacity; size_t size; uint64_t resolution; _Bool running; } TimerHandler; struct timer_function_args { void *arg1; int arg2; }; /** * @brief Allocate timer in array * * @param timers_container Handler * @param func Function to be executed * @param arg Its args * @param timeout Timeout in ms * @return int */ static int timer_alloc ( TimerHandler *timers_container, void *(func)(void *), void *arg1, int arg2, unsigned timeout) { static int timer_id; pthread_mutex_lock(&timers_container->mutex); int i = 0; for (; i < timers_container->max_capacity && timers_container->timers[i]; i ++); if (i == timers_container->max_capacity) { LOGGER_WARNING("Maximum capacity reached!"); pthread_mutex_unlock(&timers_container->mutex); return -1; } Timer *timer = timers_container->timers[i] = calloc(sizeof(Timer), 1); if (timer == NULL) { LOGGER_ERROR("Failed to allocate timer!"); pthread_mutex_unlock(&timers_container->mutex); return -1; } timers_container->size ++; timer->func = func; timer->func_arg1 = arg1; timer->func_arg2 = arg2; timer->timeout = timeout + current_time_monotonic(); /* In ms */ ++timer_id; timer->idx = timer_id; /* reorder */ if (i) { int j = i - 1; for (; j >= 0 && timeout < timers_container->timers[j]->timeout; j--) { Timer *tmp = timers_container->timers[j]; timers_container->timers[j] = timer; timers_container->timers[j + 1] = tmp; } } pthread_mutex_unlock(&timers_container->mutex); LOGGER_DEBUG("Allocated timer index: %d timeout: %d, current size: %d", i, timeout, timers_container->size); return timer->idx; } /** * @brief Remove timer from array * * @param timers_container handler * @param idx timer id * @param lock_mutex (does the mutex need to be locked) * @return int */ static int timer_release ( TimerHandler *timers_container, int idx , int lock_mutex) { if (lock_mutex) pthread_mutex_lock(&timers_container->mutex); Timer **timed_events = timers_container->timers; int i, res = -1; for (i = 0; i < timers_container->max_capacity; ++i) { if (timed_events[i] && timed_events[i]->idx == idx) { res = i; break; } } if (res == -1) { LOGGER_WARNING("No event with id: %d", idx); if (lock_mutex) pthread_mutex_unlock(&timers_container->mutex); return -1; } free(timed_events[res]); timed_events[res] = NULL; i = res + 1; for (; i < timers_container->max_capacity && timed_events[i]; i ++) { timed_events[i - 1] = timed_events[i]; timed_events[i] = NULL; } timers_container->size--; LOGGER_DEBUG("Popped id: %d, current size: %d ", idx, timers_container->size); if (lock_mutex) pthread_mutex_unlock(&timers_container->mutex); return 0; } /** * @brief Main poll for timer execution * * @param arg ... * @return void* */ static void *timer_poll( void *arg ) { TimerHandler *handler = arg; while ( handler->running ) { pthread_mutex_lock(&handler->mutex); if ( handler->running ) { uint64_t time = current_time_monotonic(); while ( handler->timers[0] && handler->timers[0]->timeout < time ) { pthread_t tid; struct timer_function_args *args = malloc(sizeof(struct timer_function_args)); args->arg1 = handler->timers[0]->func_arg1; args->arg2 = handler->timers[0]->func_arg2; if ( 0 != pthread_create(&tid, NULL, handler->timers[0]->func, args) || 0 != pthread_detach(tid) ) { LOGGER_ERROR("Failed to execute timer at: %d!", handler->timers[0]->timeout); free(args); } else { LOGGER_DEBUG("Exectued timer assigned at: %d", handler->timers[0]->timeout); } timer_release(handler, handler->timers[0]->idx, 0); } } pthread_mutex_unlock(&handler->mutex); usleep(handler->resolution); } pthread_exit(NULL); } /** * @brief Start timer poll and return handler * * @param max_capacity capacity * @param resolution ... * @return TimerHandler* */ static TimerHandler *timer_init_session (int max_capacity, int resolution) { TimerHandler *handler = calloc(1, sizeof(TimerHandler)); if (handler == NULL) { LOGGER_ERROR("Failed to allocate memory, program might misbehave!"); return NULL; } handler->timers = calloc(max_capacity, sizeof(Timer *)); if (handler->timers == NULL) { LOGGER_ERROR("Failed to allocate %d timed events!", max_capacity); free(handler); return NULL; } handler->max_capacity = max_capacity; handler->running = 1; handler->resolution = resolution; pthread_mutex_init(&handler->mutex, NULL); pthread_t _tid; if ( 0 != pthread_create(&_tid, NULL, timer_poll, handler) || 0 != pthread_detach(_tid) ) { LOGGER_ERROR("Failed to start timer poll thread!"); free(handler->timers); free(handler); return NULL; } return handler; } /** * @brief Terminate timer session * * @param handler The timer handler * @return void */ static void timer_terminate_session(TimerHandler *handler) { pthread_mutex_lock(&handler->mutex); handler->running = 0; pthread_mutex_unlock(&handler->mutex); int i = 0; for (; i < handler->max_capacity; i ++) free(handler->timers[i]); free(handler->timers); pthread_mutex_destroy( &handler->mutex ); } /** * @brief Generate _random_ alphanumerical string. * * @param str Destination. * @param size Size of string. * @return void */ static void t_randomstr ( uint8_t *str, uint32_t size ) { if (str == NULL) { LOGGER_DEBUG("Empty destination!"); return; } static const uint8_t _bytes[] = "0123456789" "ABCDEFGHIJKLMNOPQRSTUVWXYZ" "abcdefghijklmnopqrstuvwxyz"; uint32_t _it = 0; for ( ; _it < size; _it++ ) { str[_it] = _bytes[ random_int() % 61 ]; } } typedef enum { error_none, error_deadcall, /* has call id but it's from old call */ error_id_mismatch, /* non-existing call */ error_no_callid, /* not having call id */ error_no_call, /* no call in session */ error_no_crypto_key, /* no crypto key */ error_busy } MSICallError; /* Error codes */ /** * @brief Stringify error code. * * @param error_code The code. * @return const uint8_t* The string. */ static inline__ const uint8_t *stringify_error ( MSICallError error_code ) { static const uint8_t *strings[] = { ( uint8_t *) "", ( uint8_t *) "Using dead call", ( uint8_t *) "Call id not set to any call", ( uint8_t *) "Call id not available", ( uint8_t *) "No active call in session", ( uint8_t *) "No Crypto-key set", ( uint8_t *) "Callee busy" }; return strings[error_code]; } /** * @brief Speaks for it self. * * @param session Control session. * @param msg The message. * @param to Where to. * @return int * @retval -1 Error occurred. * @retval 0 Success. */ static int send_message ( MSISession *session, MSICall *call, MSIMessage *msg, uint32_t to ) { msi_msg_set_callid ( msg, call->id ); uint8_t msg_string_final [MSI_MAXMSG_SIZE]; uint16_t length = parse_send ( msg, msg_string_final ); if (!length) { LOGGER_WARNING("Parsing message failed; nothing sent!"); return -1; } if ( m_msi_packet(session->messenger_handle, to, msg_string_final, length) ) { LOGGER_DEBUG("Sent message"); return 0; } return -1; } inline__ int send_reponse ( MSISession *session, MSICall *call, MSIResponse response, uint32_t to ) { MSIMessage *msg = msi_new_message ( TypeResponse, response ); int ret = send_message ( session, call, msg, to ); free ( msg ); return ret; } /** * @brief Determine 'bigger' call id * * @param first duh * @param second duh * @return int * @retval 0 it's first * @retval 1 it's second */ static int call_id_bigger( const uint8_t *first, const uint8_t *second) { return (memcmp(first, second, sizeof(MSICallIDType)) < 0); } /** * @brief Speaks for it self. * * @param session Control session. * @param msg The message. * @param peer_id The peer. * @return -1, 0 */ static int flush_peer_type ( MSICall *call, MSIMessage *msg, int peer_id ) { if ( msg->calltype.exists ) { call->type_peer[peer_id] = msg->calltype.value; return 0; } LOGGER_WARNING("No call type header!"); return -1; } static int terminate_call ( MSISession *session, MSICall *call ); static void handle_remote_connection_change(Messenger *messenger, int friend_num, uint8_t status, void *session_p) { MSISession *session = session_p; switch ( status ) { case 0: { /* Went offline */ uint32_t j = 0; for ( ; j < session->max_calls; j ++ ) { if ( !session->calls[j] ) continue; int i = 0; for ( ; i < session->calls[j]->peer_count; i ++ ) if ( session->calls[j]->peers[i] == friend_num ) { invoke_callback(session, j, MSI_OnPeerTimeout); terminate_call(session, session->calls[j]); LOGGER_DEBUG("Remote: %d timed out!", friend_num); return; /* TODO: On group calls change behaviour */ } } } break; default: break; } } static MSICall *find_call ( MSISession *session, uint8_t *call_id ) { if ( call_id == NULL ) return NULL; uint32_t i = 0; for (; i < session->max_calls; i ++ ) if ( session->calls[i] && memcmp(session->calls[i]->id, call_id, sizeof(session->calls[i]->id)) == 0 ) { return session->calls[i]; } return NULL; } /** * @brief Sends error response to peer. * * @param session The session. * @param errid The id. * @param to Where to? * @return int * @retval -1/0 It's usually always success. */ static int send_error ( MSISession *session, MSICall *call, MSICallError errid, uint32_t to ) { if (!call) { LOGGER_WARNING("Cannot handle error on 'null' call"); return -1; } LOGGER_DEBUG("Sending error: %d on call: %s", errid, call->id); MSIMessage *msg_error = msi_new_message ( TypeResponse, error ); msi_msg_set_reason ( msg_error, stringify_error(errid) ); send_message ( session, call, msg_error, to ); free ( msg_error ); return 0; } /** * @brief Add peer to peer list. * * @param call What call. * @param peer_id Its id. * @return void */ static void add_peer( MSICall *call, int peer_id ) { uint32_t *peers = !call->peers ? peers = calloc(sizeof(uint32_t), 1) : realloc( call->peers, sizeof(uint32_t) * call->peer_count); if (!peers) { LOGGER_WARNING("Allocation failed! Program might misbehave!"); return; } call->peer_count ++; call->peers = peers; call->peers[call->peer_count - 1] = peer_id; LOGGER_DEBUG("Added peer: %d", peer_id); } /** * @brief Speaks for it self. * * @param session Control session. * @param peers Amount of peers. (Currently it only supports 1) * @param ringing_timeout Ringing timeout. * @return MSICall* The created call. */ static MSICall *init_call ( MSISession *session, int peers, int ringing_timeout ) { if (peers == 0) { LOGGER_ERROR("No peers!"); return NULL; } int32_t call_idx = 0; for (; call_idx < session->max_calls; call_idx ++) { if ( !session->calls[call_idx] ) { if (!(session->calls[call_idx] = calloc ( sizeof ( MSICall ), 1 ))) { LOGGER_WARNING("Allocation failed! Program might misbehave!"); return NULL; } break; } } if ( call_idx == session->max_calls ) { LOGGER_WARNING("Reached maximum amount of calls!"); return NULL; } MSICall *call = session->calls[call_idx]; call->call_idx = call_idx; if ( !(call->type_peer = calloc ( sizeof ( MSICallType ), peers )) ) { LOGGER_WARNING("Allocation failed! Program might misbehave!"); free(call); return NULL; } call->session = session; /*_call->_participant_count = _peers;*/ call->request_timer_id = 0; call->ringing_timer_id = 0; call->ringing_tout_ms = ringing_timeout; pthread_mutex_init ( &call->mutex, NULL ); LOGGER_DEBUG("Started new call with index: %u", call_idx); return call; } /** * @brief Terminate the call. * * @param session Control session. * @return int * @retval -1 Error occurred. * @retval 0 Success. */ static int terminate_call ( MSISession *session, MSICall *call ) { if ( !call ) { LOGGER_WARNING("Tried to terminate non-existing call!"); return -1; } LOGGER_DEBUG("Terminated call id: %d", call->call_idx); /* Check event loop and cancel timed events if there are any * NOTE: This has to be done before possibly * locking the mutex the second time */ timer_release ( session->timer_handler, call->request_timer_id, 1); timer_release ( session->timer_handler, call->ringing_timer_id, 1); /* Get a handle */ pthread_mutex_lock ( &call->mutex ); session->calls[call->call_idx] = NULL; free ( call->type_peer ); free ( call->peers); /* Release handle */ pthread_mutex_unlock ( &call->mutex ); pthread_mutex_destroy ( &call->mutex ); free ( call ); return 0; } /** * @brief Function called at request timeout. If not called in thread it might cause trouble * * @param arg Control session * @return void* */ static void *handle_timeout ( void *arg ) { /* TODO: Cancel might not arrive there; set up * timers on these cancels and terminate call on * their timeout */ struct timer_function_args *args = arg; int call_index = args->arg2; MSISession *session = args->arg1; MSICall *call = session->calls[call_index]; if (call) { LOGGER_DEBUG("[Call: %d] Request timed out!", call->call_idx); invoke_callback(session, call_index, MSI_OnRequestTimeout); } if ( call && call->session ) { /* TODO: Cancel all? */ /* uint16_t _it = 0; * for ( ; _it < _session->call->peer_count; _it++ ) */ msi_cancel ( call->session, call->call_idx, call->peers [0], "Request timed out" ); /*terminate_call(call->session, call);*/ } free(arg); pthread_exit(NULL); } /********** Request handlers **********/ static int handle_recv_invite ( MSISession *session, MSICall *call, MSIMessage *msg ) { LOGGER_DEBUG("Session: %p Handling 'invite' on call: %d", session, call ? call->call_idx : -1); pthread_mutex_lock(&session->mutex); if (!msg->calltype.exists) {/**/ LOGGER_WARNING("Peer sent invalid call type!"); send_error ( session, call, error_no_callid, msg->friend_id ); pthread_mutex_unlock(&session->mutex); return 0; } if ( call ) { if ( call->peers[0] == msg->friend_id ) { if (call->state == call_inviting) { /* The glare case. A calls B when at the same time * B calls A. Who has advantage is set bey calculating * 'bigger' Call id and then that call id is being used in * future. User with 'bigger' Call id has the advantage * as in he will wait the response from the other. */ LOGGER_DEBUG("Glare case; Peer: %d", call->peers[0]); if ( call_id_bigger (call->id, msg->callid.value) == 1 ) { /* Peer has advantage */ /* Terminate call; peer will timeout(call) if call initialization fails */ terminate_call(session, call); call = init_call ( session, 1, 0 ); if ( !call ) { pthread_mutex_unlock(&session->mutex); LOGGER_ERROR("Starting call"); return 0; } } else { pthread_mutex_unlock(&session->mutex); return 0; /* Wait for ringing from peer */ } } else if (call->state == call_active) { /* Request for media change; call callback and send starting response */ if (flush_peer_type(call, msg, 0) != 0) { /**/ LOGGER_WARNING("Peer sent invalid call type!"); send_error ( session, call, error_no_callid, msg->friend_id ); pthread_mutex_unlock(&session->mutex); return 0; } LOGGER_DEBUG("Set new call type: %s", call->type_peer[0] == type_audio ? "audio" : "video"); send_reponse(session, call, starting, msg->friend_id); pthread_mutex_unlock(&session->mutex); invoke_callback(session, call->call_idx, MSI_OnMediaChange); return 1; } } else { send_error ( session, call, error_busy, msg->friend_id ); /* TODO: Ugh*/ terminate_call(session, call); pthread_mutex_unlock(&session->mutex); return 0; } } else { call = init_call ( session, 1, 0 ); if ( !call ) { pthread_mutex_unlock(&session->mutex); LOGGER_ERROR("Starting call"); return 0; } } if ( !msg->callid.exists ) { send_error ( session, call, error_no_callid, msg->friend_id ); terminate_call(session, call); pthread_mutex_unlock(&session->mutex); return 0; } memcpy ( call->id, msg->callid.value, sizeof(msg->callid.value) ); call->state = call_starting; add_peer( call, msg->friend_id); flush_peer_type ( call, msg, 0 ); send_reponse(session, call, ringing, msg->friend_id); pthread_mutex_unlock(&session->mutex); invoke_callback(session, call->call_idx, MSI_OnInvite); return 1; } static int handle_recv_start ( MSISession *session, MSICall *call, MSIMessage *msg ) { if ( !call ) { LOGGER_WARNING("Session: %p Handling 'start' on no call"); return 0; } LOGGER_DEBUG("Session: %p Handling 'start' on call: %d, friend id: %d", session, call->call_idx, msg->friend_id ); pthread_mutex_lock(&session->mutex); call->state = call_active; pthread_mutex_unlock(&session->mutex); invoke_callback(session, call->call_idx, MSI_OnStart); return 1; } static int handle_recv_reject ( MSISession *session, MSICall *call, MSIMessage *msg ) { if ( !call ) { LOGGER_WARNING("Session: %p Handling 'start' on no call"); return 0; } LOGGER_DEBUG("Session: %p Handling 'reject' on call: %s", session, call->call_idx); invoke_callback(session, call->call_idx, MSI_OnReject); pthread_mutex_lock(&session->mutex); send_reponse(session, call, ending, msg->friend_id); terminate_call(session, call); pthread_mutex_unlock(&session->mutex); return 1; } static int handle_recv_cancel ( MSISession *session, MSICall *call, MSIMessage *msg ) { if ( !call ) { LOGGER_WARNING("Session: %p Handling 'start' on no call"); return 0; } LOGGER_DEBUG("Session: %p Handling 'cancel' on call: %s", session, call->call_idx); invoke_callback(session, call->call_idx, MSI_OnCancel); pthread_mutex_lock(&session->mutex); terminate_call ( session, call ); pthread_mutex_unlock(&session->mutex); return 1; } static int handle_recv_end ( MSISession *session, MSICall *call, MSIMessage *msg ) { if ( !call ) { LOGGER_WARNING("Session: %p Handling 'start' on no call"); return 0; } LOGGER_DEBUG("Session: %p Handling 'end' on call: %d", session, call->call_idx); invoke_callback(session, call->call_idx, MSI_OnEnd); pthread_mutex_lock(&session->mutex); send_reponse(session, call, ending, msg->friend_id); terminate_call ( session, call ); pthread_mutex_unlock(&session->mutex); return 1; } /********** Response handlers **********/ static int handle_recv_ringing ( MSISession *session, MSICall *call, MSIMessage *msg ) { if ( !call ) { LOGGER_WARNING("Session: %p Handling 'start' on no call"); return 0; } pthread_mutex_lock(&session->mutex); if ( call->ringing_timer_id ) { LOGGER_WARNING("Call already ringing"); pthread_mutex_unlock(&session->mutex); return 0; } LOGGER_DEBUG("Session: %p Handling 'ringing' on call: %d", session, call->call_idx ); call->ringing_timer_id = timer_alloc ( session->timer_handler, handle_timeout, session, call->call_idx, call->ringing_tout_ms ); pthread_mutex_unlock(&session->mutex); invoke_callback(session, call->call_idx, MSI_OnRinging); return 1; } static int handle_recv_starting ( MSISession *session, MSICall *call, MSIMessage *msg ) { if ( !call ) { LOGGER_WARNING("Session: %p Handling 'starting' on non-existing call"); return 0; } pthread_mutex_lock(&session->mutex); if ( call->state == call_active ) { /* Change media */ LOGGER_DEBUG("Session: %p Changing media on call: %d", session, call->call_idx ); pthread_mutex_unlock(&session->mutex); invoke_callback(session, call->call_idx, MSI_OnMediaChange); } else if ( call->state == call_inviting ) { LOGGER_DEBUG("Session: %p Handling 'starting' on call: %d", session, call->call_idx ); call->state = call_active; MSIMessage *msg_start = msi_new_message ( TypeRequest, start ); send_message ( session, call, msg_start, msg->friend_id ); free ( msg_start ); flush_peer_type ( call, msg, 0 ); /* This is here in case of glare */ timer_release ( session->timer_handler, call->ringing_timer_id, 1 ); pthread_mutex_unlock(&session->mutex); invoke_callback(session, call->call_idx, MSI_OnStarting); } else { LOGGER_ERROR("Invalid call state"); terminate_call(session, call ); pthread_mutex_unlock(&session->mutex); return 0; } return 1; } static int handle_recv_ending ( MSISession *session, MSICall *call, MSIMessage *msg ) { if ( !call ) { LOGGER_WARNING("Session: %p Handling 'start' on no call"); return 0; } LOGGER_DEBUG("Session: %p Handling 'ending' on call: %d", session, call->call_idx ); invoke_callback(session, call->call_idx, MSI_OnEnding); /* Terminate call */ pthread_mutex_lock(&session->mutex); terminate_call ( session, call ); pthread_mutex_unlock(&session->mutex); return 1; } static int handle_recv_error ( MSISession *session, MSICall *call, MSIMessage *msg ) { if ( !call ) { LOGGER_WARNING("Handling 'error' on non-existing call!"); pthread_mutex_unlock(&session->mutex); return -1; } LOGGER_DEBUG("Session: %p Handling 'error' on call: %d", session, call->call_idx ); invoke_callback(session, call->call_idx, MSI_OnEnding); pthread_mutex_lock(&session->mutex); /* Handle error accordingly */ if ( msg->reason.exists ) { /* TODO */ } terminate_call ( session, call ); pthread_mutex_unlock(&session->mutex); return 1; } /** * @brief BASIC call flow: * * ALICE BOB * | invite --> | * | | * | <-- ringing | * | | * | <-- starting | * | | * | start --> | * | | * | <-- MEDIA TRANS --> | * | | * | end --> | * | | * | <-- ending | * * Alice calls Bob by sending invite packet. * Bob recvs the packet and sends an ringing packet; * which notifies Alice that her invite is acknowledged. * Ringing screen shown on both sides. * Bob accepts the invite for a call by sending starting packet. * Alice recvs the starting packet and sends the started packet to * inform Bob that she recved the starting packet. * Now the media transmission is established ( i.e. RTP transmission ). * Alice hangs up and sends end packet. * Bob recves the end packet and sends ending packet * as the acknowledgement that the call is ending. * * */ static void msi_handle_packet ( Messenger *messenger, int source, const uint8_t *data, uint16_t length, void *object ) { LOGGER_DEBUG("Got msi message"); /* Unused */ (void)messenger; MSISession *session = object; MSIMessage *msg; if ( !length ) { LOGGER_WARNING("Lenght param negative"); return; } msg = parse_recv ( data, length ); if ( !msg ) { LOGGER_WARNING("Error parsing message"); return; } else { LOGGER_DEBUG("Successfully parsed message"); } msg->friend_id = source; /* Find what call */ MSICall *call = msg->callid.exists ? find_call(session, msg->callid.value ) : NULL; /* Now handle message */ if ( msg->request.exists ) { /* Handle request */ switch (msg->request.value) { case invite: handle_recv_invite ( session, call, msg ); break; case start: handle_recv_start ( session, call, msg ); break; case cancel: handle_recv_cancel ( session, call, msg ); break; case reject: handle_recv_reject ( session, call, msg ); break; case end: handle_recv_end ( session, call, msg ); break; } } else if ( msg->response.exists ) { /* Handle response */ /* Got response so cancel timer */ if ( call ) timer_release ( session->timer_handler, call->request_timer_id, 1 ); switch (msg->response.value) { case ringing: handle_recv_ringing ( session, call, msg ); break; case starting: handle_recv_starting ( session, call, msg ); break; case ending: handle_recv_ending ( session, call, msg ); break; case error: handle_recv_error ( session, call, msg ); break; } } else { LOGGER_WARNING("Invalid message: no resp nor requ headers"); } free_end: free ( msg ); } /** * @brief Callback setter. * * @param callback The callback. * @param id The id. * @return void */ void msi_register_callback ( MSISession *session, MSICallbackType callback, MSICallbackID id, void *userdata ) { session->callbacks[id].function = callback; session->callbacks[id].data = userdata; } /** * @brief Start the control session. * * @param messenger Tox* object. * @param max_calls Amount of calls possible * @return MSISession* The created session. * @retval NULL Error occurred. */ MSISession *msi_init_session ( Messenger *messenger, int32_t max_calls ) { if (messenger == NULL) { LOGGER_ERROR("Could not init session on empty messenger!"); return NULL; } TimerHandler *handler = timer_init_session(max_calls * 10, 10000); if ( !max_calls || !handler ) { LOGGER_WARNING("Invalid max call treshold or timer handler initialization failed!"); return NULL; } MSISession *retu = calloc ( sizeof ( MSISession ), 1 ); if (retu == NULL) { LOGGER_ERROR("Allocation failed! Program might misbehave!"); return NULL; } retu->messenger_handle = messenger; retu->agent_handler = NULL; retu->timer_handler = handler; if (!(retu->calls = calloc( sizeof (MSICall *), max_calls ))) { LOGGER_ERROR("Allocation failed! Program might misbehave!"); free(retu); return NULL; } retu->max_calls = max_calls; retu->frequ = 10000; /* default value? */ retu->call_timeout = 30000; /* default value? */ m_callback_msi_packet(messenger, msi_handle_packet, retu ); /* This is called when remote terminates session */ m_callback_connectionstatus_internal_av(messenger, handle_remote_connection_change, retu); pthread_mutex_init(&retu->mutex, NULL); LOGGER_DEBUG("New msi session: %p max calls: %u", retu, max_calls); return retu; } /** * @brief Terminate control session. * * @param session The session * @return int */ int msi_terminate_session ( MSISession *session ) { if (session == NULL) { LOGGER_ERROR("Tried to terminate non-existing session"); return -1; } pthread_mutex_lock(&session->mutex); m_callback_msi_packet((struct Messenger *) session->messenger_handle, NULL, NULL); pthread_mutex_unlock(&session->mutex); int _status = 0; /* If have calls, cancel them */ uint32_t idx = 0; for (; idx < session->max_calls; idx ++) if ( session->calls[idx] ) { /* Cancel all? */ uint16_t _it = 0; /*for ( ; _it < session->calls[idx]->peer_count; _it++ ) * FIXME: will not work on multiple peers, must cancel call for all peers */ msi_cancel ( session, idx, session->calls[idx]->peers [_it], "MSI session terminated!" ); } timer_terminate_session(session->timer_handler); pthread_mutex_destroy(&session->mutex); LOGGER_DEBUG("Terminated session: %p", session); free ( session ); return _status; } /** * @brief Send invite request to friend_id. * * @param session Control session. * @param call_type Type of the call. Audio or Video(both audio and video) * @param rngsec Ringing timeout. * @param friend_id The friend. * @return int */ int msi_invite ( MSISession *session, int32_t *call_index, MSICallType call_type, uint32_t rngsec, uint32_t friend_id ) { pthread_mutex_lock(&session->mutex); LOGGER_DEBUG("Session: %p Inviting friend: %u", session, friend_id); int i = 0; for (; i < session->max_calls; i ++) if (session->calls[i] && session->calls[i]->peers[0] == friend_id) { LOGGER_ERROR("Already in a call with friend %d", friend_id); pthread_mutex_unlock(&session->mutex); return -1; } MSICall *call = init_call ( session, 1, rngsec ); /* Just one peer for now */ if ( !call ) { pthread_mutex_unlock(&session->mutex); LOGGER_ERROR("Cannot handle more calls"); return -1; } *call_index = call->call_idx; t_randomstr ( call->id, sizeof(call->id) ); add_peer ( call, friend_id ); call->type_local = call_type; MSIMessage *msg_invite = msi_new_message ( TypeRequest, invite ); msi_msg_set_calltype(msg_invite, call_type); send_message ( session, call, msg_invite, friend_id ); free( msg_invite ); call->state = call_inviting; call->request_timer_id = timer_alloc ( session->timer_handler, handle_timeout, session, call->call_idx, m_deftout ); LOGGER_DEBUG("Invite sent"); pthread_mutex_unlock(&session->mutex); return 0; } /** * @brief Hangup active call. * * @param session Control session. * @param call_id To which call is this action handled. * @return int * @retval -1 Error occurred. * @retval 0 Success. */ int msi_hangup ( MSISession *session, int32_t call_index ) { pthread_mutex_lock(&session->mutex); LOGGER_DEBUG("Session: %p Hanging up call: %u", session, call_index); if ( call_index < 0 || call_index >= session->max_calls || !session->calls[call_index] ) { LOGGER_ERROR("Invalid call index!"); pthread_mutex_unlock(&session->mutex); return -1; } if ( session->calls[call_index]->state != call_active ) { LOGGER_ERROR("No call with such index or call is not active!"); pthread_mutex_unlock(&session->mutex); return -1; } MSIMessage *msg_end = msi_new_message ( TypeRequest, end ); /* hangup for each peer */ int it = 0; for ( ; it < session->calls[call_index]->peer_count; it ++ ) send_message ( session, session->calls[call_index], msg_end, session->calls[call_index]->peers[it] ); session->calls[call_index]->state = call_hanged_up; free ( msg_end ); session->calls[call_index]->request_timer_id = timer_alloc ( session->timer_handler, handle_timeout, session, call_index, m_deftout ); pthread_mutex_unlock(&session->mutex); return 0; } /** * @brief Answer active call request. * * @param session Control session. * @param call_id To which call is this action handled. * @param call_type Answer with Audio or Video(both). * @return int */ int msi_answer ( MSISession *session, int32_t call_index, MSICallType call_type ) { pthread_mutex_lock(&session->mutex); LOGGER_DEBUG("Session: %p Answering call: %u", session, call_index); if ( call_index < 0 || call_index >= session->max_calls || !session->calls[call_index] ) { LOGGER_ERROR("Invalid call index!"); pthread_mutex_unlock(&session->mutex); return -1; } MSIMessage *msg_starting = msi_new_message ( TypeResponse, starting ); session->calls[call_index]->type_local = call_type; msi_msg_set_calltype(msg_starting, call_type); send_message ( session, session->calls[call_index], msg_starting, 0 ); free ( msg_starting ); session->calls[call_index]->state = call_active; pthread_mutex_unlock(&session->mutex); return 0; } /** * @brief Cancel request. * * @param session Control session. * @param call_id To which call is this action handled. * @param reason Set optional reason header. Pass NULL if none. * @return int */ int msi_cancel ( MSISession *session, int32_t call_index, uint32_t peer, const char *reason ) { pthread_mutex_lock(&session->mutex); LOGGER_DEBUG("Session: %p Canceling call: %u; reason: %s", session, call_index, reason ? reason : "Unknown"); if ( call_index < 0 || call_index >= session->max_calls || !session->calls[call_index] ) { LOGGER_ERROR("Invalid call index!"); pthread_mutex_unlock(&session->mutex); return -1; } MSIMessage *msg_cancel = msi_new_message ( TypeRequest, cancel ); /* FIXME */ #if 0 if ( reason && strlen(reason) < sizeof(MSIReasonStrType) ) { MSIReasonStrType reason_cast; memset(reason_cast, '\0', sizeof(MSIReasonStrType)); memcpy(reason_cast, reason, strlen(reason)); msi_msg_set_reason(msg_cancel, reason_cast); } #endif send_message ( session, session->calls[call_index], msg_cancel, peer ); free ( msg_cancel ); terminate_call ( session, session->calls[call_index] ); pthread_mutex_unlock(&session->mutex); return 0; } /** * @brief Reject request. * * @param session Control session. * @param call_id To which call is this action handled. * @return int */ int msi_reject ( MSISession *session, int32_t call_index, const char *reason ) { pthread_mutex_lock(&session->mutex); LOGGER_DEBUG("Session: %p Rejecting call: %u; reason: %s", session, call_index, reason ? reason : "Unknown"); if ( call_index < 0 || call_index >= session->max_calls || !session->calls[call_index] ) { LOGGER_ERROR("Invalid call index!"); pthread_mutex_unlock(&session->mutex); return -1; } MSIMessage *msg_reject = msi_new_message ( TypeRequest, reject ); /* FIXME */ #if 0 if ( reason && strlen(reason) < sizeof(MSIReasonStrType) ) { MSIReasonStrType reason_cast; memset(reason_cast, '\0', sizeof(MSIReasonStrType)); memcpy(reason_cast, reason, strlen(reason)); msi_msg_set_reason(msg_reject, reason_cast); } #endif send_message ( session, session->calls[call_index], msg_reject, session->calls[call_index]->peers[session->calls[call_index]->peer_count - 1] ); free ( msg_reject ); session->calls[call_index]->state = call_hanged_up; session->calls[call_index]->request_timer_id = timer_alloc ( session->timer_handler, handle_timeout, session, call_index, m_deftout ); pthread_mutex_unlock(&session->mutex); return 0; } /** * @brief Send invite request to friend_id. * * @param session Control session. * @param call_index Call index. * @param call_type Type of the call. Audio or Video(both audio and video) * @param rngsec Ringing timeout. * @param friend_id The friend. * @return int */ int msi_change_type(MSISession *session, int32_t call_index, MSICallType call_type) { pthread_mutex_lock(&session->mutex); LOGGER_DEBUG("Changing media on call: %d", call_index); if ( call_index < 0 || call_index >= session->max_calls || !session->calls[call_index] ) { LOGGER_ERROR("Invalid call index!"); pthread_mutex_unlock(&session->mutex); return -1; } MSICall *call = session->calls[call_index]; if ( call->state != call_active ) { LOGGER_ERROR("Call is not active!"); pthread_mutex_unlock(&session->mutex); return -1; } if ( call->type_local == call_type ) { LOGGER_ERROR("Call is already set to the requested type!"); pthread_mutex_unlock(&session->mutex); return -1; } call->type_local = call_type; MSIMessage *msg_invite = msi_new_message ( TypeRequest, invite ); msi_msg_set_calltype ( msg_invite, call_type ); send_message ( session, call, msg_invite, call->peers[0] ); free ( msg_invite ); LOGGER_DEBUG("Request for media change sent"); pthread_mutex_unlock(&session->mutex); return 0; } /** * @brief Terminate the current call. * * @param session Control session. * @param call_id To which call is this action handled. * @return int */ int msi_stopcall ( MSISession *session, int32_t call_index ) { pthread_mutex_lock(&session->mutex); LOGGER_DEBUG("Session: %p Stopping call index: %u", session, call_index); if ( call_index < 0 || call_index >= session->max_calls || !session->calls[call_index] ) { pthread_mutex_unlock(&session->mutex); return -1; } /* just terminate it */ terminate_call ( session, session->calls[call_index] ); pthread_mutex_unlock(&session->mutex); return 0; }