/* * notification_proxy.c * com.apple.mobile.notification_proxy service implementation. * * Copyright (c) 2009 Nikias Bassen, All Rights Reserved. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA */ #include #include #include #include #include "notification_proxy.h" #include "property_list_service.h" #include "debug.h" #ifdef WIN32 #define sleep(x) Sleep(x*1000) #endif struct np_thread { np_client_t client; np_notify_cb_t cbfunc; void *user_data; }; /** * Locks a notification_proxy client, used for thread safety. * * @param client notification_proxy client to lock */ static void np_lock(np_client_t client) { debug_info("NP: Locked"); #ifdef WIN32 EnterCriticalSection(&client->mutex); #else pthread_mutex_lock(&client->mutex); #endif } /** * Unlocks a notification_proxy client, used for thread safety. * * @param client notification_proxy client to unlock */ static void np_unlock(np_client_t client) { debug_info("NP: Unlocked"); #ifdef WIN32 LeaveCriticalSection(&client->mutex); #else pthread_mutex_unlock(&client->mutex); #endif } /** * Convert a property_list_service_error_t value to an np_error_t value. * Used internally to get correct error codes. * * @param err A property_list_service_error_t error code * * @return A matching np_error_t error code, * NP_E_UNKNOWN_ERROR otherwise. */ static np_error_t np_error(property_list_service_error_t err) { switch (err) { case PROPERTY_LIST_SERVICE_E_SUCCESS: return NP_E_SUCCESS; case PROPERTY_LIST_SERVICE_E_INVALID_ARG: return NP_E_INVALID_ARG; case PROPERTY_LIST_SERVICE_E_PLIST_ERROR: return NP_E_PLIST_ERROR; case PROPERTY_LIST_SERVICE_E_MUX_ERROR: return NP_E_CONN_FAILED; default: break; } return NP_E_UNKNOWN_ERROR; } /** * Connects to the notification_proxy on the specified device. * * @param device The device to connect to. * @param service The service descriptor returned by lockdownd_start_service. * @param client Pointer that will be set to a newly allocated np_client_t * upon successful return. * * @return NP_E_SUCCESS on success, NP_E_INVALID_ARG when device is NULL, * or NP_E_CONN_FAILED when the connection to the device could not be * established. */ np_error_t np_client_new(idevice_t device, lockdownd_service_descriptor_t service, np_client_t *client) { property_list_service_client_t plistclient = NULL; np_error_t err = np_error(property_list_service_client_new(device, service, &plistclient)); if (err != NP_E_SUCCESS) { return err; } np_client_t client_loc = (np_client_t) malloc(sizeof(struct np_client_private)); client_loc->parent = plistclient; #ifdef WIN32 InitializeCriticalSection(&client_loc->mutex); client_loc->notifier = NULL; #else pthread_mutex_init(&client_loc->mutex, NULL); client_loc->notifier = (pthread_t)NULL; #endif *client = client_loc; return NP_E_SUCCESS; } /** * Disconnects a notification_proxy client from the device and frees up the * notification_proxy client data. * * @param client The notification_proxy client to disconnect and free. * * @return NP_E_SUCCESS on success, or NP_E_INVALID_ARG when client is NULL. */ np_error_t np_client_free(np_client_t client) { if (!client) return NP_E_INVALID_ARG; property_list_service_client_free(client->parent); client->parent = NULL; if (client->notifier) { debug_info("joining np callback"); #ifdef WIN32 WaitForSingleObject(client->notifier, INFINITE); #else pthread_join(client->notifier, NULL); #endif } #ifdef WIN32 DeleteCriticalSection(&client->mutex); #else pthread_mutex_destroy(&client->mutex); #endif free(client); return NP_E_SUCCESS; } /** * Sends a notification to the device's notification_proxy. * * @param client The client to send to * @param notification The notification message to send * * @return NP_E_SUCCESS on success, or an error returned by np_plist_send */ np_error_t np_post_notification(np_client_t client, const char *notification) { if (!client || !notification) { return NP_E_INVALID_ARG; } np_lock(client); plist_t dict = plist_new_dict(); plist_dict_insert_item(dict,"Command", plist_new_string("PostNotification")); plist_dict_insert_item(dict,"Name", plist_new_string(notification)); np_error_t res = np_error(property_list_service_send_xml_plist(client->parent, dict)); plist_free(dict); dict = plist_new_dict(); plist_dict_insert_item(dict,"Command", plist_new_string("Shutdown")); res = np_error(property_list_service_send_xml_plist(client->parent, dict)); plist_free(dict); if (res != NP_E_SUCCESS) { debug_info("Error sending XML plist to device!"); } // try to read an answer, we just ignore errors here dict = NULL; property_list_service_receive_plist(client->parent, &dict); if (dict) { #ifndef STRIP_DEBUG_CODE char *cmd_value = NULL; plist_t cmd_value_node = plist_dict_get_item(dict, "Command"); if (plist_get_node_type(cmd_value_node) == PLIST_STRING) { plist_get_string_val(cmd_value_node, &cmd_value); } if (cmd_value && !strcmp(cmd_value, "ProxyDeath")) { // this is the expected answer } else { debug_plist(dict); } if (cmd_value) { free(cmd_value); } #endif plist_free(dict); } np_unlock(client); return res; } /** * Tells the device to send a notification on the specified event. * * @param client The client to send to * @param notification The notifications that should be observed. * * @return NP_E_SUCCESS on success, NP_E_INVALID_ARG when client or * notification are NULL, or an error returned by np_plist_send. */ np_error_t np_observe_notification( np_client_t client, const char *notification ) { if (!client || !notification) { return NP_E_INVALID_ARG; } np_lock(client); plist_t dict = plist_new_dict(); plist_dict_insert_item(dict,"Command", plist_new_string("ObserveNotification")); plist_dict_insert_item(dict,"Name", plist_new_string(notification)); np_error_t res = np_error(property_list_service_send_xml_plist(client->parent, dict)); if (res != NP_E_SUCCESS) { debug_info("Error sending XML plist to device!"); } plist_free(dict); np_unlock(client); return res; } /** * Tells the device to send a notification on specified events. * * @param client The client to send to * @param notification_spec Specification of the notifications that should be * observed. This is expected to be an array of const char* that MUST have a * terminating NULL entry. * * @return NP_E_SUCCESS on success, NP_E_INVALID_ARG when client is null, * or an error returned by np_observe_notification. */ np_error_t np_observe_notifications(np_client_t client, const char **notification_spec) { int i = 0; np_error_t res = NP_E_UNKNOWN_ERROR; const char **notifications = notification_spec; if (!client) { return NP_E_INVALID_ARG; } if (!notifications) { return NP_E_INVALID_ARG; } while (notifications[i]) { res = np_observe_notification(client, notifications[i]); if (res != NP_E_SUCCESS) { break; } i++; } return res; } /** * Checks if a notification has been sent by the device. * * @param client NP to get a notification from * @param notification Pointer to a buffer that will be allocated and filled * with the notification that has been received. * * @return 0 if a notification has been received or nothing has been received, * or a negative value if an error occured. * * @note You probably want to check out np_set_notify_callback * @see np_set_notify_callback */ static int np_get_notification(np_client_t client, char **notification) { int res = 0; plist_t dict = NULL; if (!client || !client->parent || *notification) return -1; np_lock(client); property_list_service_receive_plist_with_timeout(client->parent, &dict, 500); if (!dict) { debug_info("NotificationProxy: no notification received!"); res = 0; } else { char *cmd_value = NULL; plist_t cmd_value_node = plist_dict_get_item(dict, "Command"); if (plist_get_node_type(cmd_value_node) == PLIST_STRING) { plist_get_string_val(cmd_value_node, &cmd_value); } if (cmd_value && !strcmp(cmd_value, "RelayNotification")) { char *name_value = NULL; plist_t name_value_node = plist_dict_get_item(dict, "Name"); if (plist_get_node_type(name_value_node) == PLIST_STRING) { plist_get_string_val(name_value_node, &name_value); } res = -2; if (name_value_node && name_value) { *notification = name_value; debug_info("got notification %s\n", __func__, name_value); res = 0; } } else if (cmd_value && !strcmp(cmd_value, "ProxyDeath")) { debug_info("ERROR: NotificationProxy died!"); res = -1; } else if (cmd_value) { debug_info("unknown NotificationProxy command '%s' received!", cmd_value); res = -1; } else { res = -2; } if (cmd_value) { free(cmd_value); } plist_free(dict); dict = NULL; } np_unlock(client); return res; } /** * Internally used thread function. */ void* np_notifier( void* arg ) { char *notification = NULL; struct np_thread *npt = (struct np_thread*)arg; if (!npt) return NULL; debug_info("starting callback."); while (npt->client->parent) { np_get_notification(npt->client, ¬ification); if (notification) { npt->cbfunc(notification, npt->user_data); free(notification); notification = NULL; } sleep(1); } if (npt) { free(npt); } return NULL; } /** * This function allows an application to define a callback function that will * be called when a notification has been received. * It will start a thread that polls for notifications and calls the callback * function if a notification has been received. * * @param client the NP client * @param notify_cb pointer to a callback function or NULL to de-register a * previously set callback function. * @param user_data Pointer that will be passed to the callback function as * user data. If notify_cb is NULL, this parameter is ignored. * * @note Only one callback function can be registered at the same time; * any previously set callback function will be removed automatically. * * @return NP_E_SUCCESS when the callback was successfully registered, * NP_E_INVALID_ARG when client is NULL, or NP_E_UNKNOWN_ERROR when * the callback thread could no be created. */ np_error_t np_set_notify_callback( np_client_t client, np_notify_cb_t notify_cb, void *user_data ) { if (!client) return NP_E_INVALID_ARG; np_error_t res = NP_E_UNKNOWN_ERROR; np_lock(client); if (client->notifier) { debug_info("callback already set, removing\n"); property_list_service_client_t parent = client->parent; client->parent = NULL; #ifdef WIN32 WaitForSingleObject(client->notifier, INFINITE); client->notifier = NULL; #else pthread_join(client->notifier, NULL); client->notifier = (pthread_t)NULL; #endif client->parent = parent; } if (notify_cb) { struct np_thread *npt = (struct np_thread*)malloc(sizeof(struct np_thread)); if (npt) { npt->client = client; npt->cbfunc = notify_cb; npt->user_data = user_data; #ifdef WIN32 client->notifier = CreateThread(NULL, 0, (LPTHREAD_START_ROUTINE)np_notifier, npt, 0, NULL); if (client->notifier != INVALID_HANDLE_VALUE) { res = NP_E_SUCCESS; } else { client->notifier = NULL; } #else if (pthread_create(&client->notifier, NULL, np_notifier, npt) == 0) { res = NP_E_SUCCESS; } #endif } } else { debug_info("no callback set"); } np_unlock(client); return res; }