device_link_service: new function and docs updated

New function: device_link_service_get_process_message.
This function receives a DLMessageProcessMessage and extracts
the message (a PLIST_DICT). Fails if the received plist is not
a DLMessageProcessMessage.

2 files changed, 70 insertions, 2 deletions

diff --git a/src/device_link_service.c b/src/device_link_service.c
index 10e9e9c..4140911 100644
--- a/src/device_link_service.c
+++ b/src/device_link_service.c
@@ -253,9 +253,20 @@ device_link_service_error_t device_link_service_disconnect(device_link_service_c
 	return err;
 }
 
+/**
+ * Sends a DLMessageProcessMessage plist.
+ *
+ * @param client The device link service client to use.
+ * @param message PLIST_DICT to send.
+ *
+ * @return DEVICE_LINK_SERVICE_E_SUCCESS on success,
+ *     DEVICE_LINK_SERVICE_E_INVALID_ARG if client or message is invalid or
+ *     message is not a PLIST_DICT, or DEVICE_LINK_SERVICE_E_MUX_ERROR if
+ *     the DLMessageProcessMessage plist could not be sent.
+ */
 device_link_service_error_t device_link_service_process_message(device_link_service_client_t client, plist_t message)
 {
-	if (!client || !message)
+	if (!client || !client->parent || !message)
 		return DEVICE_LINK_SERVICE_E_INVALID_ARG;
 
 	if (plist_get_node_type(message) != PLIST_DICT)
@@ -263,7 +274,7 @@ device_link_service_error_t device_link_service_process_message(device_link_serv
 
 	plist_t array = plist_new_array();
 	plist_array_append_item(array, plist_new_string("DLMessageProcessMessage"));
-	plist_array_append_item(array, message);
+	plist_array_append_item(array, plist_copy(message));
 
 	device_link_service_error_t err = DEVICE_LINK_SERVICE_E_SUCCESS;
 	if (property_list_service_send_binary_plist(client->parent, array) != PROPERTY_LIST_SERVICE_E_SUCCESS) {
@@ -274,6 +285,62 @@ device_link_service_error_t device_link_service_process_message(device_link_serv
 }
 
 /**
+ * Receives a DLMessageProcessMessage plist.
+ *
+ * @param client The connected device link service client used for receiving.
+ * @param message Pointer to a plist that will be set to the contents of the
+ *    message contents upon successful return.
+ *
+ * @return DEVICE_LINK_SERVICE_E_SUCCESS when a DLMessageProcessMessage was
+ *    received, DEVICE_LINK_SERVICE_E_INVALID_ARG when client or message is
+ *    invalid, DEVICE_LINK_SERVICE_E_PLIST_ERROR if the received plist is
+ *    invalid or is not a DLMessageProcessMessage,
+ *    or DEVICE_LINK_SERVICE_E_MUX_ERROR if receiving from device fails.
+ */
+device_link_service_error_t device_link_service_get_process_message(device_link_service_client_t client, plist_t *message)
+{
+	if (!client || !client->parent || !message)
+		return DEVICE_LINK_SERVICE_E_INVALID_ARG;
+
+	plist_t pmsg = NULL;
+	if (property_list_service_receive_plist(client->parent, &pmsg) != PROPERTY_LIST_SERVICE_E_SUCCESS) {
+		return DEVICE_LINK_SERVICE_E_MUX_ERROR;
+	}
+
+	device_link_service_error_t err = DEVICE_LINK_SERVICE_E_UNKNOWN_ERROR;
+
+	char *msg = device_link_service_get_message(pmsg);
+	if (!msg || strcmp(msg, "DLMessageProcessMessage")) {
+		debug_info("Did not receive DLMessageProcessMessage as expected!");
+		err = DEVICE_LINK_SERVICE_E_PLIST_ERROR;
+		goto leave;
+	}
+
+	if (plist_array_get_size(pmsg) != 2) {
+		debug_info("Malformed plist received for DLMessageProcessMessage");
+		err = DEVICE_LINK_SERVICE_E_PLIST_ERROR;
+		goto leave;
+	}
+
+	plist_t msg_loc = plist_array_get_item(pmsg, 1);
+	if (msg_loc) {
+		*message = plist_copy(msg_loc);
+		err = DEVICE_LINK_SERVICE_E_SUCCESS;
+	} else {
+		*message = NULL;
+		err = DEVICE_LINK_SERVICE_E_PLIST_ERROR;
+	}
+
+leave:
+	if (msg)
+		free(msg);
+	if (pmsg)
+		plist_free(pmsg);
+
+	return err;
+}
+
+/**
  * Generic device link service send function.
  *
  * @param client The device link service client to use for sending
diff --git a/src/device_link_service.h b/src/device_link_service.h
index 4fc9a9f..1d2a178 100644
--- a/src/device_link_service.h
+++ b/src/device_link_service.h
@@ -45,6 +45,7 @@ device_link_service_error_t device_link_service_client_new(idevice_t device, uin
 device_link_service_error_t device_link_service_client_free(device_link_service_client_t client);
 device_link_service_error_t device_link_service_version_exchange(device_link_service_client_t client, uint64_t version_major, uint64_t version_minor);
 device_link_service_error_t device_link_service_process_message(device_link_service_client_t client, plist_t message);
+device_link_service_error_t device_link_service_get_process_message(device_link_service_client_t client, plist_t *message);
 device_link_service_error_t device_link_service_disconnect(device_link_service_client_t client);
 device_link_service_error_t device_link_service_send(device_link_service_client_t client, plist_t plist);
 device_link_service_error_t device_link_service_receive(device_link_service_client_t client, plist_t *plist);