diff options
author | Martin Szulecki | 2010-03-16 03:13:38 +0100 |
---|---|---|
committer | Martin Szulecki | 2010-03-16 03:13:38 +0100 |
commit | 08d2af5d611319748afba2aaba5e6c8a99f1b396 (patch) | |
tree | 8bf4a3533f2acf11368dc37a9c653689ace99b77 /include/libimobiledevice/lockdown.h | |
parent | 3e0c5021100c879ff7d0776d4c7bb4f0ec88e0d7 (diff) | |
download | libimobiledevice-08d2af5d611319748afba2aaba5e6c8a99f1b396.tar.gz libimobiledevice-08d2af5d611319748afba2aaba5e6c8a99f1b396.tar.bz2 |
Complete documentation of public interface and fix a lot of bogus comments
This change unifies the documentation comment syntax, fixes a few bad
documentation comments and completes documentation where it was missing.
Diffstat (limited to 'include/libimobiledevice/lockdown.h')
-rw-r--r-- | include/libimobiledevice/lockdown.h | 16 |
1 files changed, 10 insertions, 6 deletions
diff --git a/include/libimobiledevice/lockdown.h b/include/libimobiledevice/lockdown.h index 6abf6d6..4504ef1 100644 --- a/include/libimobiledevice/lockdown.h +++ b/include/libimobiledevice/lockdown.h @@ -1,6 +1,6 @@ /** * @file libimobiledevice/lockdown.h - * @brief Communcation with the lockdown device daemon + * @brief Implementation to communicate with the lockdown device daemon * \internal * * Copyright (c) 2008 Zach C. All Rights Reserved. @@ -30,7 +30,8 @@ extern "C" { #include <libimobiledevice/libimobiledevice.h> -/* Error Codes */ +/** @name Error Codes */ +/*@{*/ #define LOCKDOWN_E_SUCCESS 0 #define LOCKDOWN_E_INVALID_ARG -1 #define LOCKDOWN_E_INVALID_CONF -2 @@ -52,18 +53,21 @@ extern "C" { #define LOCKDOWN_E_INVALID_ACTIVATION_RECORD -18 #define LOCKDOWN_E_UNKNOWN_ERROR -256 +/*@}*/ +/** Represents an error code. */ typedef int16_t lockdownd_error_t; typedef struct lockdownd_client_private lockdownd_client_private; typedef lockdownd_client_private *lockdownd_client_t; /**< The client handle. */ struct lockdownd_pair_record { - char *device_certificate; - char *host_certificate; - char *host_id; - char *root_certificate; + char *device_certificate; /**< The device certificate */ + char *host_certificate; /**< The host certificate */ + char *host_id; /**< A unique HostID for the host computer */ + char *root_certificate; /**< The root certificate */ }; +/** A pair record holding device, host and root certificates along the host_id */ typedef struct lockdownd_pair_record *lockdownd_pair_record_t; /* Interface */ |