diff options
author | Nikias Bassen | 2010-01-28 22:18:41 +0100 |
---|---|---|
committer | Martin Szulecki | 2010-01-29 02:16:00 +0100 |
commit | 96101a1231a4ddfeb40fd738a24e108a3a904048 (patch) | |
tree | 65a8f54354d9acbbba93dac2c8602d07e469482c /src/iphone.c | |
parent | 45b88ae3956de089fdc35605910f1359a1d3961c (diff) | |
download | libimobiledevice-96101a1231a4ddfeb40fd738a24e108a3a904048.tar.gz libimobiledevice-96101a1231a4ddfeb40fd738a24e108a3a904048.tar.bz2 |
Global renames due to project rename to libimobiledevice
Diffstat (limited to 'src/iphone.c')
-rw-r--r-- | src/iphone.c | 618 |
1 files changed, 0 insertions, 618 deletions
diff --git a/src/iphone.c b/src/iphone.c deleted file mode 100644 index b471e35..0000000 --- a/src/iphone.c +++ /dev/null @@ -1,618 +0,0 @@ -/* - * iphone.c - * Device discovery and communication interface. - * - * Copyright (c) 2008 Zach C. All Rights Reserved. - * 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 <stdlib.h> -#include <string.h> -#include <errno.h> -#include <arpa/inet.h> - -#include <usbmuxd.h> -#include <gnutls/gnutls.h> -#include "iphone.h" -#include "debug.h" - -static iphone_event_cb_t event_cb = NULL; - -static void usbmux_event_cb(const usbmuxd_event_t *event, void *user_data) -{ - iphone_event_t ev; - - ev.event = event->event; - ev.uuid = event->device.uuid; - ev.conn_type = CONNECTION_USBMUXD; - - if (event_cb) { - event_cb(&ev, user_data); - } -} - -/** - * Register a callback function that will be called when device add/remove - * events occur. - * - * @param callback Callback function to call. - * @param user_data Application-specific data passed as parameter - * to the registered callback function. - * - * @return IPHONE_E_SUCCESS on success or an error value when an error occured. - */ -iphone_error_t iphone_event_subscribe(iphone_event_cb_t callback, void *user_data) -{ - event_cb = callback; - int res = usbmuxd_subscribe(usbmux_event_cb, user_data); - if (res != 0) { - event_cb = NULL; - debug_info("Error %d when subscribing usbmux event callback!", res); - return IPHONE_E_UNKNOWN_ERROR; - } - return IPHONE_E_SUCCESS; -} - -/** - * Release the event callback function that has been registered with - * iphone_event_subscribe(). - * - * @return IPHONE_E_SUCCESS on success or an error value when an error occured. - */ -iphone_error_t iphone_event_unsubscribe() -{ - event_cb = NULL; - int res = usbmuxd_unsubscribe(); - if (res != 0) { - debug_info("Error %d when unsubscribing usbmux event callback!", res); - return IPHONE_E_UNKNOWN_ERROR; - } - return IPHONE_E_SUCCESS; -} - -/** - * Get a list of currently available devices. - * - * @param devices List of uuids of devices that are currently available. - * This list is terminated by a NULL pointer. - * @param count Number of devices found. - * - * @return IPHONE_E_SUCCESS on success or an error value when an error occured. - */ -iphone_error_t iphone_get_device_list(char ***devices, int *count) -{ - usbmuxd_device_info_t *dev_list; - - *devices = NULL; - *count = 0; - - if (usbmuxd_get_device_list(&dev_list) < 0) { - debug_info("ERROR: usbmuxd is not running!\n", __func__); - return IPHONE_E_NO_DEVICE; - } - - char **newlist = NULL; - int i, newcount = 0; - - for (i = 0; dev_list[i].handle > 0; i++) { - newlist = realloc(*devices, sizeof(char*) * (newcount+1)); - newlist[newcount++] = strdup(dev_list[i].uuid); - *devices = newlist; - } - usbmuxd_device_list_free(&dev_list); - - *count = newcount; - newlist = realloc(*devices, sizeof(char*) * (newcount+1)); - newlist[newcount] = NULL; - *devices = newlist; - - return IPHONE_E_SUCCESS; -} - -/** - * Free a list of device uuids. - * - * @param devices List of uuids to free. - * - * @return Always returnes IPHONE_E_SUCCESS. - */ -iphone_error_t iphone_device_list_free(char **devices) -{ - if (devices) { - int i = 0; - while (devices[i++]) { - free(devices[i]); - } - free(devices); - } - return IPHONE_E_SUCCESS; -} - -/** - * Creates an iphone_device_t structure for the device specified by uuid, - * if the device is available. - * - * @note The resulting iphone_device_t structure has to be freed with - * iphone_device_free() if it is no longer used. - * - * @param device Upon calling this function, a pointer to a location of type - * iphone_device_t. On successful return, this location will be populated. - * @param uuid The UUID to match. - * - * @return IPHONE_E_SUCCESS if ok, otherwise an error code. - */ -iphone_error_t iphone_device_new(iphone_device_t * device, const char *uuid) -{ - usbmuxd_device_info_t muxdev; - int res = usbmuxd_get_device_by_uuid(uuid, &muxdev); - if (res > 0) { - iphone_device_t phone = (iphone_device_t) malloc(sizeof(struct iphone_device_int)); - phone->uuid = strdup(muxdev.uuid); - phone->conn_type = CONNECTION_USBMUXD; - phone->conn_data = (void*)muxdev.handle; - *device = phone; - return IPHONE_E_SUCCESS; - } - /* other connection types could follow here */ - - return IPHONE_E_NO_DEVICE; -} - -/** Cleans up an iPhone structure, then frees the structure itself. - * This is a library-level function; deals directly with the iPhone to tear - * down relations, but otherwise is mostly internal. - * - * @param device A pointer to an iPhone structure. - */ -iphone_error_t iphone_device_free(iphone_device_t device) -{ - if (!device) - return IPHONE_E_INVALID_ARG; - iphone_error_t ret = IPHONE_E_UNKNOWN_ERROR; - - ret = IPHONE_E_SUCCESS; - - free(device->uuid); - - if (device->conn_type == CONNECTION_USBMUXD) { - device->conn_data = 0; - } - if (device->conn_data) { - free(device->conn_data); - } - free(device); - return ret; -} - -/** - * Set up a connection to the given device. - * - * @param device The device to connect to. - * @param port The destination port to connect to. - * @param connection Pointer to an iphone_connection_t that will be filled - * with the necessary data of the connection. - * - * @return IPHONE_E_SUCCESS if ok, otherwise an error code. - */ -iphone_error_t iphone_device_connect(iphone_device_t device, uint16_t port, iphone_connection_t *connection) -{ - if (!device) { - return IPHONE_E_INVALID_ARG; - } - - if (device->conn_type == CONNECTION_USBMUXD) { - int sfd = usbmuxd_connect((uint32_t)(device->conn_data), port); - if (sfd < 0) { - debug_info("ERROR: Connecting to usbmuxd failed: %d (%s)", sfd, strerror(-sfd)); - return IPHONE_E_UNKNOWN_ERROR; - } - iphone_connection_t new_connection = (iphone_connection_t)malloc(sizeof(struct iphone_connection_int)); - new_connection->type = CONNECTION_USBMUXD; - new_connection->data = (void*)sfd; - new_connection->ssl_data = NULL; - *connection = new_connection; - return IPHONE_E_SUCCESS; - } else { - debug_info("Unknown connection type %d", device->conn_type); - } - - return IPHONE_E_UNKNOWN_ERROR; -} - -/** - * Disconnect from the device and clean up the connection structure. - * - * @param connection The connection to close. - * - * @return IPHONE_E_SUCCESS if ok, otherwise an error code. - */ -iphone_error_t iphone_device_disconnect(iphone_connection_t connection) -{ - if (!connection) { - return IPHONE_E_INVALID_ARG; - } - /* shut down ssl if enabled */ - if (connection->ssl_data) { - iphone_connection_disable_ssl(connection); - } - iphone_error_t result = IPHONE_E_UNKNOWN_ERROR; - if (connection->type == CONNECTION_USBMUXD) { - usbmuxd_disconnect((int)(connection->data)); - result = IPHONE_E_SUCCESS; - } else { - debug_info("Unknown connection type %d", connection->type); - } - free(connection); - return result; -} - -/** - * Internally used function to send raw data over the given connection. - */ -static iphone_error_t internal_connection_send(iphone_connection_t connection, const char *data, uint32_t len, uint32_t *sent_bytes) -{ - if (!connection || !data) { - return IPHONE_E_INVALID_ARG; - } - - if (connection->type == CONNECTION_USBMUXD) { - int res = usbmuxd_send((int)(connection->data), data, len, sent_bytes); - if (res < 0) { - debug_info("ERROR: usbmuxd_send returned %d (%s)", res, strerror(-res)); - return IPHONE_E_UNKNOWN_ERROR; - } - return IPHONE_E_SUCCESS; - } else { - debug_info("Unknown connection type %d", connection->type); - } - return IPHONE_E_UNKNOWN_ERROR; - -} - -/** - * Send data to a device via the given connection. - * - * @param connection The connection to send data over. - * @param data Buffer with data to send. - * @param len Size of the buffer to send. - * @param sent_bytes Pointer to an uint32_t that will be filled - * with the number of bytes actually sent. - * - * @return IPHONE_E_SUCCESS if ok, otherwise an error code. - */ -iphone_error_t iphone_connection_send(iphone_connection_t connection, const char *data, uint32_t len, uint32_t *sent_bytes) -{ - if (!connection || !data || (connection->ssl_data && !connection->ssl_data->session)) { - return IPHONE_E_INVALID_ARG; - } - - if (connection->ssl_data) { - ssize_t sent = gnutls_record_send(connection->ssl_data->session, (void*)data, (size_t)len); - if ((uint32_t)sent == (uint32_t)len) { - *sent_bytes = sent; - return IPHONE_E_SUCCESS; - } - *sent_bytes = 0; - return IPHONE_E_SSL_ERROR; - } - return internal_connection_send(connection, data, len, sent_bytes); -} - -/** - * Internally used function for receiving raw data over the given connection - * using a timeout. - */ -static iphone_error_t internal_connection_receive_timeout(iphone_connection_t connection, char *data, uint32_t len, uint32_t *recv_bytes, unsigned int timeout) -{ - if (!connection) { - return IPHONE_E_INVALID_ARG; - } - - if (connection->type == CONNECTION_USBMUXD) { - int res = usbmuxd_recv_timeout((int)(connection->data), data, len, recv_bytes, timeout); - if (res < 0) { - debug_info("ERROR: usbmuxd_recv_timeout returned %d (%s)", res, strerror(-res)); - return IPHONE_E_UNKNOWN_ERROR; - } - return IPHONE_E_SUCCESS; - } else { - debug_info("Unknown connection type %d", connection->type); - } - return IPHONE_E_UNKNOWN_ERROR; -} - -/** - * Receive data from a device via the given connection. - * This function will return after the given timeout even if no data has been - * received. - * - * @param connection The connection to receive data from. - * @param data Buffer that will be filled with the received data. - * This buffer has to be large enough to hold len bytes. - * @param len Buffer size or number of bytes to receive. - * @param recv_bytes Number of bytes actually received. - * @param timeout Timeout in milliseconds after which this function should - * return even if no data has been received. - * - * @return IPHONE_E_SUCCESS if ok, otherwise an error code. - */ -iphone_error_t iphone_connection_receive_timeout(iphone_connection_t connection, char *data, uint32_t len, uint32_t *recv_bytes, unsigned int timeout) -{ - if (!connection || (connection->ssl_data && !connection->ssl_data->session)) { - return IPHONE_E_INVALID_ARG; - } - - if (connection->ssl_data) { - ssize_t received = gnutls_record_recv(connection->ssl_data->session, (void*)data, (size_t)len); - if (received > 0) { - *recv_bytes = received; - return IPHONE_E_SUCCESS; - } - *recv_bytes = 0; - return IPHONE_E_SSL_ERROR; - } - return internal_connection_receive_timeout(connection, data, len, recv_bytes, timeout); -} - -/** - * Internally used function for receiving raw data over the given connection. - */ -static iphone_error_t internal_connection_receive(iphone_connection_t connection, char *data, uint32_t len, uint32_t *recv_bytes) -{ - if (!connection) { - return IPHONE_E_INVALID_ARG; - } - - if (connection->type == CONNECTION_USBMUXD) { - int res = usbmuxd_recv((int)(connection->data), data, len, recv_bytes); - if (res < 0) { - debug_info("ERROR: usbmuxd_recv returned %d (%s)", res, strerror(-res)); - return IPHONE_E_UNKNOWN_ERROR; - } - - return IPHONE_E_SUCCESS; - } else { - debug_info("Unknown connection type %d", connection->type); - } - return IPHONE_E_UNKNOWN_ERROR; -} - -/** - * Receive data from a device via the given connection. - * This function is like iphone_connection_receive_timeout, but with a predefined - * reasonable timeout. - * - * @param connection The connection to receive data from. - * @param data Buffer that will be filled with the received data. - * This buffer has to be large enough to hold len bytes. - * @param len Buffer size or number of bytes to receive. - * @param recv_bytes Number of bytes actually received. - * - * @return IPHONE_E_SUCCESS if ok, otherwise an error code. - */ -iphone_error_t iphone_connection_receive(iphone_connection_t connection, char *data, uint32_t len, uint32_t *recv_bytes) -{ - if (!connection || (connection->ssl_data && !connection->ssl_data->session)) { - return IPHONE_E_INVALID_ARG; - } - - if (connection->ssl_data) { - ssize_t received = gnutls_record_recv(connection->ssl_data->session, (void*)data, (size_t)len); - if (received > 0) { - *recv_bytes = received; - return IPHONE_E_SUCCESS; - } - *recv_bytes = 0; - return IPHONE_E_SSL_ERROR; - } - return internal_connection_receive(connection, data, len, recv_bytes); -} - -iphone_error_t iphone_device_get_handle(iphone_device_t device, uint32_t *handle) -{ - if (!device) - return IPHONE_E_INVALID_ARG; - - if (device->conn_type == CONNECTION_USBMUXD) { - *handle = (uint32_t)device->conn_data; - return IPHONE_E_SUCCESS; - } else { - debug_info("Unknown connection type %d", device->conn_type); - } - return IPHONE_E_UNKNOWN_ERROR; -} - -iphone_error_t iphone_device_get_uuid(iphone_device_t device, char **uuid) -{ - if (!device) - return IPHONE_E_INVALID_ARG; - - *uuid = strdup(device->uuid); - return IPHONE_E_SUCCESS; -} - -/** - * Internally used gnutls callback function for receiving encrypted data. - */ -static ssize_t internal_ssl_read(gnutls_transport_ptr_t transport, char *buffer, size_t length) -{ - int bytes = 0, pos_start_fill = 0; - size_t tbytes = 0; - int this_len = length; - iphone_error_t res; - iphone_connection_t connection = (iphone_connection_t)transport; - char *recv_buffer; - - debug_info("pre-read client wants %zi bytes", length); - - recv_buffer = (char *) malloc(sizeof(char) * this_len); - - /* repeat until we have the full data or an error occurs */ - do { - if ((res = internal_connection_receive(connection, recv_buffer, this_len, (uint32_t*)&bytes)) != IPHONE_E_SUCCESS) { - debug_info("ERROR: iphone_connection_receive returned %d", res); - return res; - } - debug_info("post-read we got %i bytes", bytes); - - // increase read count - tbytes += bytes; - - // fill the buffer with what we got right now - memcpy(buffer + pos_start_fill, recv_buffer, bytes); - pos_start_fill += bytes; - - if (tbytes >= length) { - break; - } - - this_len = length - tbytes; - debug_info("re-read trying to read missing %i bytes", this_len); - } while (tbytes < length); - - if (recv_buffer) { - free(recv_buffer); - } - return tbytes; -} - -/** - * Internally used gnutls callback function for sending encrypted data. - */ -static ssize_t internal_ssl_write(gnutls_transport_ptr_t transport, char *buffer, size_t length) -{ - uint32_t bytes = 0; - iphone_connection_t connection = (iphone_connection_t)transport; - debug_info("pre-send length = %zi", length); - internal_connection_send(connection, buffer, length, &bytes); - debug_info("post-send sent %i bytes", bytes); - return bytes; -} - -/** - * Internally used function for cleaning up SSL stuff. - */ -static void internal_ssl_cleanup(ssl_data_t ssl_data) -{ - if (!ssl_data) - return; - - if (ssl_data->session) { - gnutls_deinit(ssl_data->session); - } - if (ssl_data->certificate) { - gnutls_certificate_free_credentials(ssl_data->certificate); - } -} - -/** - * Enables SSL for the given connection. - * - * @param connection The connection to enable SSL for. - * - * @return IPHONE_E_SUCCESS on success, IPHONE_E_INVALID_ARG when connection - * is NULL or connection->ssl_data is non-NULL, or IPHONE_E_SSL_ERROR when - * SSL initialization, setup, or handshake fails. - */ -iphone_error_t iphone_connection_enable_ssl(iphone_connection_t connection) -{ - if (!connection || connection->ssl_data) - return IPHONE_E_INVALID_ARG; - - iphone_error_t ret = IPHONE_E_SSL_ERROR; - uint32_t return_me = 0; - - ssl_data_t ssl_data_loc = (ssl_data_t)malloc(sizeof(struct ssl_data_int)); - - // Set up GnuTLS... - debug_info("enabling SSL mode"); - errno = 0; - gnutls_global_init(); - gnutls_certificate_allocate_credentials(&ssl_data_loc->certificate); - gnutls_certificate_set_x509_trust_file(ssl_data_loc->certificate, "hostcert.pem", GNUTLS_X509_FMT_PEM); - gnutls_init(&ssl_data_loc->session, GNUTLS_CLIENT); - { - int protocol_priority[16] = { GNUTLS_SSL3, 0 }; - int kx_priority[16] = { GNUTLS_KX_ANON_DH, GNUTLS_KX_RSA, 0 }; - int cipher_priority[16] = { GNUTLS_CIPHER_AES_128_CBC, GNUTLS_CIPHER_AES_256_CBC, 0 }; - int mac_priority[16] = { GNUTLS_MAC_SHA1, GNUTLS_MAC_MD5, 0 }; - int comp_priority[16] = { GNUTLS_COMP_NULL, 0 }; - - gnutls_cipher_set_priority(ssl_data_loc->session, cipher_priority); - gnutls_compression_set_priority(ssl_data_loc->session, comp_priority); - gnutls_kx_set_priority(ssl_data_loc->session, kx_priority); - gnutls_protocol_set_priority(ssl_data_loc->session, protocol_priority); - gnutls_mac_set_priority(ssl_data_loc->session, mac_priority); - } - gnutls_credentials_set(ssl_data_loc->session, GNUTLS_CRD_CERTIFICATE, ssl_data_loc->certificate); // this part is killing me. - - debug_info("GnuTLS step 1..."); - gnutls_transport_set_ptr(ssl_data_loc->session, (gnutls_transport_ptr_t)connection); - debug_info("GnuTLS step 2..."); - gnutls_transport_set_push_function(ssl_data_loc->session, (gnutls_push_func) & internal_ssl_write); - debug_info("GnuTLS step 3..."); - gnutls_transport_set_pull_function(ssl_data_loc->session, (gnutls_pull_func) & internal_ssl_read); - debug_info("GnuTLS step 4 -- now handshaking..."); - if (errno) - debug_info("WARN: errno says %s before handshake!", strerror(errno)); - return_me = gnutls_handshake(ssl_data_loc->session); - debug_info("GnuTLS handshake done..."); - - if (return_me != GNUTLS_E_SUCCESS) { - internal_ssl_cleanup(ssl_data_loc); - free(ssl_data_loc); - debug_info("GnuTLS reported something wrong."); - gnutls_perror(return_me); - debug_info("oh.. errno says %s", strerror(errno)); - } else { - connection->ssl_data = ssl_data_loc; - ret = IPHONE_E_SUCCESS; - debug_info("SSL mode enabled"); - } - return ret; -} - -/** - * Disable SSL for the given connection. - * - * @param connection The connection to disable SSL for. - * - * @return IPHONE_E_SUCCESS on success, IPHONE_E_INVALID_ARG when connection - * is NULL. This function also returns IPHONE_E_SUCCESS when SSL is not - * enabled and does no further error checking on cleanup. - */ -iphone_error_t iphone_connection_disable_ssl(iphone_connection_t connection) -{ - if (!connection) - return IPHONE_E_INVALID_ARG; - if (!connection->ssl_data) { - /* ignore if ssl is not enabled */ - return IPHONE_E_SUCCESS; - } - - if (connection->ssl_data->session) { - gnutls_bye(connection->ssl_data->session, GNUTLS_SHUT_RDWR); - } - internal_ssl_cleanup(connection->ssl_data); - free(connection->ssl_data); - connection->ssl_data = NULL; - - debug_info("SSL mode disabled"); - - return IPHONE_E_SUCCESS; -} - |