/* * preboard.c * com.apple.preboardservice_v2 service implementation. * * Copyright (c) 2019 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 */ #ifdef HAVE_CONFIG_H #include #endif #include #include #include #include "preboard.h" #include "lockdown.h" #include "common/debug.h" /** * Convert a property_list_service_error_t value to a preboard_error_t value. * Used internally to get correct error codes. * * @param err An property_list_service_error_t error code * * @return A matching preboard_error_t error code, * PREBOARD_E_UNKNOWN_ERROR otherwise. */ static preboard_error_t preboard_error(property_list_service_error_t err) { switch (err) { case PROPERTY_LIST_SERVICE_E_SUCCESS: return PREBOARD_E_SUCCESS; case PROPERTY_LIST_SERVICE_E_INVALID_ARG: return PREBOARD_E_INVALID_ARG; case PROPERTY_LIST_SERVICE_E_PLIST_ERROR: return PREBOARD_E_PLIST_ERROR; case PROPERTY_LIST_SERVICE_E_MUX_ERROR: return PREBOARD_E_MUX_ERROR; case PROPERTY_LIST_SERVICE_E_SSL_ERROR: return PREBOARD_E_SSL_ERROR; case PROPERTY_LIST_SERVICE_E_NOT_ENOUGH_DATA: return PREBOARD_E_NOT_ENOUGH_DATA; case PROPERTY_LIST_SERVICE_E_RECEIVE_TIMEOUT: return PREBOARD_E_TIMEOUT; default: break; } return PREBOARD_E_UNKNOWN_ERROR; } LIBIMOBILEDEVICE_API preboard_error_t preboard_client_new(idevice_t device, lockdownd_service_descriptor_t service, preboard_client_t * client) { *client = NULL; if (!device || !service || service->port == 0 || !client || *client) { debug_info("Incorrect parameter passed to preboard_client_new."); return PREBOARD_E_INVALID_ARG; } debug_info("Creating preboard_client, port = %d.", service->port); property_list_service_client_t plclient = NULL; preboard_error_t ret = preboard_error(property_list_service_client_new(device, service, &plclient)); if (ret != PREBOARD_E_SUCCESS) { debug_info("Creating a property list client failed. Error: %i", ret); return ret; } preboard_client_t client_loc = (preboard_client_t) malloc(sizeof(struct preboard_client_private)); client_loc->parent = plclient; client_loc->receive_status_thread = THREAD_T_NULL; *client = client_loc; debug_info("preboard_client successfully created."); return 0; } LIBIMOBILEDEVICE_API preboard_error_t preboard_client_start_service(idevice_t device, preboard_client_t * client, const char* label) { preboard_error_t err = PREBOARD_E_UNKNOWN_ERROR; service_client_factory_start_service(device, PREBOARD_SERVICE_NAME, (void**)client, label, SERVICE_CONSTRUCTOR(preboard_client_new), &err); return err; } LIBIMOBILEDEVICE_API preboard_error_t preboard_client_free(preboard_client_t client) { if (!client) return PREBOARD_E_INVALID_ARG; property_list_service_client_t parent = client->parent; client->parent = NULL; if (client->receive_status_thread) { debug_info("joining receive_status_thread"); thread_join(client->receive_status_thread); thread_free(client->receive_status_thread); client->receive_status_thread = THREAD_T_NULL; } preboard_error_t err = preboard_error(property_list_service_client_free(parent)); free(client); return err; } LIBIMOBILEDEVICE_API preboard_error_t preboard_send(preboard_client_t client, plist_t plist) { preboard_error_t res = PREBOARD_E_UNKNOWN_ERROR; res = preboard_error(property_list_service_send_binary_plist(client->parent, plist)); if (res != PREBOARD_E_SUCCESS) { debug_info("Sending plist failed with error %d", res); return res; } return res; } LIBIMOBILEDEVICE_API preboard_error_t preboard_receive_with_timeout(preboard_client_t client, plist_t * plist, uint32_t timeout_ms) { preboard_error_t res = PREBOARD_E_UNKNOWN_ERROR; plist_t outplist = NULL; res = preboard_error(property_list_service_receive_plist_with_timeout(client->parent, &outplist, timeout_ms)); if (res != PREBOARD_E_SUCCESS && res != PREBOARD_E_TIMEOUT) { debug_info("Could not receive plist, error %d", res); plist_free(outplist); } else if (res == PREBOARD_E_SUCCESS) { *plist = outplist; } return res; } LIBIMOBILEDEVICE_API preboard_error_t preboard_receive(preboard_client_t client, plist_t * plist) { return preboard_receive_with_timeout(client, plist, 5000); } struct preboard_status_data { preboard_client_t client; preboard_status_cb_t cbfunc; void *user_data; }; static void* preboard_receive_status_loop_thread(void* arg) { struct preboard_status_data *data = (struct preboard_status_data*)arg; /* run until the service disconnects or an error occurs */ while (data->client && data->client->parent) { plist_t pl = NULL; preboard_error_t perr = preboard_receive_with_timeout(data->client, &pl, 1000); if (perr == PREBOARD_E_TIMEOUT) { continue; } else if (perr == PREBOARD_E_SUCCESS) { data->cbfunc(pl, data->user_data); } plist_free(pl); if (perr != PREBOARD_E_SUCCESS) { data->cbfunc(NULL, data->user_data); break; } } /* cleanup */ debug_info("done, cleaning up."); if (data->client->receive_status_thread) { thread_free(data->client->receive_status_thread); data->client->receive_status_thread = THREAD_T_NULL; } free(data); return NULL; } static preboard_error_t preboard_receive_status_loop_with_callback(preboard_client_t client, preboard_status_cb_t status_cb, void *user_data) { if (!client || !client->parent) { return PREBOARD_E_INVALID_ARG; } if (client->receive_status_thread) { return PREBOARD_E_OP_IN_PROGRESS; } preboard_error_t res = PREBOARD_E_UNKNOWN_ERROR; struct preboard_status_data *data = (struct preboard_status_data*)malloc(sizeof(struct preboard_status_data)); if (data) { data->client = client; data->cbfunc = status_cb; data->user_data = user_data; if (thread_new(&client->receive_status_thread, preboard_receive_status_loop_thread, data) == 0) { res = PREBOARD_E_SUCCESS; } } return res; } LIBIMOBILEDEVICE_API preboard_error_t preboard_create_stashbag(preboard_client_t client, plist_t manifest, preboard_status_cb_t status_cb, void *user_data) { if (!client) { return PREBOARD_E_INVALID_ARG; } plist_t dict = plist_new_dict(); plist_dict_set_item(dict, "Command", plist_new_string("CreateStashbag")); if (manifest) { plist_dict_set_item(dict, "Manifest", plist_copy(manifest)); } preboard_error_t perr = preboard_send(client, dict); plist_free(dict); if (perr != PREBOARD_E_SUCCESS) { return perr; } if (!status_cb) { return PREBOARD_E_SUCCESS; } return preboard_receive_status_loop_with_callback(client, status_cb, user_data); } LIBIMOBILEDEVICE_API preboard_error_t preboard_commit_stashbag(preboard_client_t client, plist_t manifest, preboard_status_cb_t status_cb, void *user_data) { if (!client) { return PREBOARD_E_INVALID_ARG; } plist_t dict = plist_new_dict(); plist_dict_set_item(dict, "Command", plist_new_string("CommitStashbag")); if (manifest) { plist_dict_set_item(dict, "Manifest", plist_copy(manifest)); } preboard_error_t perr = preboard_send(client, dict); plist_free(dict); if (perr != PREBOARD_E_SUCCESS) { return perr; } if (!status_cb) { return PREBOARD_E_SUCCESS; } return preboard_receive_status_loop_with_callback(client, status_cb, user_data); }