summaryrefslogtreecommitdiffstats
path: root/src/notification_proxy.c
diff options
context:
space:
mode:
Diffstat (limited to 'src/notification_proxy.c')
-rw-r--r--src/notification_proxy.c32
1 files changed, 20 insertions, 12 deletions
diff --git a/src/notification_proxy.c b/src/notification_proxy.c
index eb5e6b2..827468e 100644
--- a/src/notification_proxy.c
+++ b/src/notification_proxy.c
@@ -1,6 +1,6 @@
/*
* notification_proxy.c
- * Notification Proxy implementation.
+ * com.apple.mobile.notification_proxy service implementation.
*
* Copyright (c) 2009 Nikias Bassen, All Rights Reserved.
*
@@ -35,9 +35,10 @@ struct np_thread {
np_notify_cb_t cbfunc;
};
-/** Locks an NP client, done for thread safety stuff.
+/**
+ * Locks a notification_proxy client, used for thread safety.
*
- * @param client The NP
+ * @param client notification_proxy client to lock
*/
static void np_lock(np_client_t client)
{
@@ -45,9 +46,10 @@ static void np_lock(np_client_t client)
g_mutex_lock(client->mutex);
}
-/** Unlocks an NP client, done for thread safety stuff.
+/**
+ * Unlocks a notification_proxy client, used for thread safety.
*
- * @param client The NP
+ * @param client notification_proxy client to unlock
*/
static void np_unlock(np_client_t client)
{
@@ -81,7 +83,8 @@ static np_error_t np_error(property_list_service_error_t err)
return NP_E_UNKNOWN_ERROR;
}
-/** Makes a connection to the NP service on the phone.
+/**
+ * Connects to the notification_proxy on the specified device.
*
* @param device The device to connect to.
* @param port Destination port (usually given by lockdownd_start_service).
@@ -117,9 +120,11 @@ np_error_t np_client_new(idevice_t device, uint16_t port, np_client_t *client)
return NP_E_SUCCESS;
}
-/** Disconnects an NP client from the device.
+/**
+ * Disconnects a notification_proxy client from the device and frees up the
+ * notification_proxy client data.
*
- * @param client The client to disconnect.
+ * @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.
*/
@@ -142,7 +147,8 @@ np_error_t np_client_free(np_client_t client)
return NP_E_SUCCESS;
}
-/** Sends a notification to the device's Notification Proxy.
+/**
+ * Sends a notification to the device's notification_proxy.
*
* @param client The client to send to
* @param notification The notification message to send
@@ -177,7 +183,8 @@ np_error_t np_post_notification(np_client_t client, const char *notification)
return res;
}
-/** Notifies the device to send a notification on the specified event.
+/**
+ * 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.
@@ -206,7 +213,8 @@ np_error_t np_observe_notification( np_client_t client, const char *notification
return res;
}
-/** Notifies the device to send a notification on specified events.
+/**
+ * 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
@@ -242,7 +250,7 @@ np_error_t np_observe_notifications(np_client_t client, const char **notificatio
}
/**
- * Checks if a notification has been sent.
+ * 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