summaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorGravatar Matt Colyer2008-08-06 00:10:25 -0700
committerGravatar Matt Colyer2008-08-06 00:10:25 -0700
commitd81a3c5c412cca9b8327d6d27625bc52650e9651 (patch)
tree23986c22a08126efcf29c0ad637424a8858c2e00 /src
parent2dcc296d9209b02d3e794f953fcf995a4a19a498 (diff)
downloadlibplist-d81a3c5c412cca9b8327d6d27625bc52650e9651.tar.gz
libplist-d81a3c5c412cca9b8327d6d27625bc52650e9651.tar.bz2
Finish converting over to doxygen.
(I thought there was more documentation there but apparently we need to add some)
Diffstat (limited to 'src')
-rw-r--r--src/usbmux.c59
-rw-r--r--src/userpref.h48
2 files changed, 50 insertions, 57 deletions
diff --git a/src/usbmux.c b/src/usbmux.c
index c5b7535..235a1f2 100644
--- a/src/usbmux.c
+++ b/src/usbmux.c
@@ -60,12 +60,11 @@ usbmux_version_header *version_header() {
// Maintenance functions.
-/* delete_connection(connection)
- * connection: the connection to delete from the tracking list.
- * Removes a connection from the list of connections made.
+/** Removes a connection from the list of connections made.
* The list of connections is necessary for buffering.
+ *
+ * @param connection The connection to delete from the tracking list.
*/
-
void delete_connection(usbmux_connection *connection) {
usbmux_connection **newlist = (usbmux_connection**)malloc(sizeof(usbmux_connection*) * (connections - 1));
int i = 0, j = 0;
@@ -85,10 +84,10 @@ void delete_connection(usbmux_connection *connection) {
free(connection);
}
-/* add_connection(connection)
- * connection: the connection to add to the global list of connections.
- * Adds a connection to the list of connections made.
+/** Adds a connection to the list of connections made.
* The connection list is necessary for buffering.
+ *
+ * @param connection The connection to add to the global list of connections.
*/
void add_connection(usbmux_connection *connection) {
@@ -98,14 +97,14 @@ void add_connection(usbmux_connection *connection) {
connections++;
}
-/* mux_connect(phone, s_port, d_port)
- * This is a higher-level USBMuxTCP-type function.
- * phone: the iPhone to initialize a connection on.
- * s_port: the source port
- * d_port: the destination port -- 0xf27e for lockdownd.
+/** This is a higher-level USBMuxTCP-type function.
* Initializes a connection on phone, with source port s_port and destination port d_port
+ *
+ * @param phone The iPhone to initialize a connection on.
+ * @param s_port The source port
+ * @param d_port The destination port -- 0xf27e for lockdownd.
+ * @return A mux TCP header for the connection which is used for tracking and data transfer.
*
- * Returns a mux TCP header for the connection which is used for tracking and data transfer.
*/
usbmux_connection *mux_connect(iPhone *phone, uint16 s_port, uint16 d_port) {
@@ -146,12 +145,12 @@ usbmux_connection *mux_connect(iPhone *phone, uint16 s_port, uint16 d_port) {
return NULL;
}
-/* mux_close_connection(phone, connection)
+/**
* This is a higher-level USBmuxTCP-type function.
- * phone: the iPhone to close a connection with.
- * connection: the connection to close.
*
- * Doesn't return anything; WILL FREE THE CONNECTION'S MEMORY!!!
+ * @param phone The iPhone to close a connection with.
+ * @param connection The connection to close.
+ * @return Doesn't return anything; WILL FREE THE CONNECTION'S MEMORY!!!
*/
void mux_close_connection(usbmux_connection *connection) {
@@ -173,14 +172,14 @@ void mux_close_connection(usbmux_connection *connection) {
delete_connection(connection);
}
-/* mux_send(phone, connection, data, datalen)
+/*
* This is a higher-level USBMuxTCP-like function.
- * phone: the iPhone to send to.
- * connection: the connection we're sending data on.
- * data: a pointer to the data to send.
- * datalen: how much data we're sending.
*
- * Returns number of bytes sent, minus the header (28), or -1 on error.
+ * @param phone The iPhone to send to.
+ * @param connection The connection we're sending data on.
+ * @param data A pointer to the data to send.
+ * @param datalen How much data we're sending.
+ * @return The number of bytes sent, minus the header (28), or -1 on error.
*/
int mux_send(usbmux_connection *connection, const char *data, uint32 datalen) {
if (!connection->phone || !connection || !data || datalen == 0) return -1;
@@ -233,14 +232,14 @@ int mux_send(usbmux_connection *connection, const char *data, uint32 datalen) {
return bytes; // or something
}
-/* mux_recv(phone, connection, data, datalen)
+/**
* This is a higher-level USBMuxTCP-like function
- * phone: the phone to receive data from.
- * connection: the connection to receive data on.
- * data: where to put the data we receive.
- * datalen: how much data to read.
- *
- * Returns: how many bytes were read, or -1 if something bad happens.
+ *
+ * @param phone The phone to receive data from.
+ * @param connection The connection to receive data on.
+ * @param data Where to put the data we receive.
+ * @param datalen How much data to read.
+ * @returns How many bytes were read, or -1 if something bad happens.
*/
int mux_recv(usbmux_connection *connection, char *data, uint32 datalen) {
diff --git a/src/userpref.h b/src/userpref.h
index 441c7be..c437e52 100644
--- a/src/userpref.h
+++ b/src/userpref.h
@@ -24,54 +24,48 @@
#include <gnutls/gnutls.h>
/**
-* \fn char* get_host_id()
-* method to get user's HostID. Caller must free returned buffer.
-* \return the HostID if exist in config file. Returns NULL otherwise.
-*/
+ * Method to get user's HostID. Caller must free returned buffer.
+ *
+ * @return the HostID if exist in config file. Returns NULL otherwise.
+ */
char* get_host_id();
/**
-* \fn int is_device_known(char* public_key)
-* determine if we already paired this device.
-* \return 1 if device is already paired. Returns 0 otherwise.
-*/
+ * Determine if we already paired this device.
+ *
+ * @return 1 if device is already paired. Returns 0 otherwise.
+ */
int is_device_known(char* public_key);
/**
-* \fn int store_device_public_key(char* public_key)
-* \return 1 if everything went well. Returns 0 otherwise.
-*/
+ * @return 1 if everything went well. Returns 0 otherwise.
+ */
int store_device_public_key(char* public_key);
/**
-* \fn int get_root_private_key(gnutls_datum_t* root_privkey)
-* \return 1 if everything went well. Returns 0 otherwise.
-*/
+ * @return 1 if everything went well. Returns 0 otherwise.
+ */
int get_root_private_key(gnutls_datum_t* root_privkey);
/**
-* \fn int get_host_private_key(gnutls_datum_t* host_privkey)
-* \return 1 if everything went well. Returns 0 otherwise.
-*/
+ * @return 1 if everything went well. Returns 0 otherwise.
+ */
int get_host_private_key(gnutls_datum_t* host_privkey);
/**
-* \fn int get_root_certificate(gnutls_datum_t* root_cert)
-* \return 1 if everything went well. Returns 0 otherwise.
-*/
+ * @return 1 if everything went well. Returns 0 otherwise.
+ */
int get_root_certificate(gnutls_datum_t* root_cert);
/**
-* \fn int get_host_certificate(gnutls_datum_t* host_cert)
-* \return 1 if everything went well. Returns 0 otherwise.
-*/
+ * @return 1 if everything went well. Returns 0 otherwise.
+ */
int get_host_certificate(gnutls_datum_t* host_cert);
/**
-* \fn int init_config_file(char* host_id, gnutls_datum_t* root_key, gnutls_datum_t* host_key, gnutls_datum_t* root_cert, gnutls_datum_t* host_cert)
-* setup a brand new config file.
-* \return 1 if everything went well. Returns 0 otherwise.
-*/
+ * Setup a brand new config file.
+ * @return 1 if everything went well. Returns 0 otherwise.
+ */
int init_config_file(char* host_id, gnutls_datum_t* root_key, gnutls_datum_t* host_key, gnutls_datum_t* root_cert, gnutls_datum_t* host_cert);
#endif