Added a doxygen group for libsimaka, some cleanups

This commit is contained in:
Martin Willi 2009-10-22 14:41:13 +02:00
parent bcf8a0ff94
commit 13f418b442
5 changed files with 609 additions and 609 deletions

View File

@ -155,13 +155,6 @@ QT_AUTOBRIEF = NO
MULTILINE_CPP_IS_BRIEF = NO
# If the DETAILS_AT_TOP tag is set to YES then Doxygen
# will output the detailed description near the top, like JavaDoc.
# If set to NO, the detailed description appears after the member
# documentation.
DETAILS_AT_TOP = YES
# If the INHERIT_DOCS tag is set to YES (the default) then an undocumented
# member inherits the documentation from any documented member that it
# re-implements.
@ -536,6 +529,7 @@ WARN_LOGFILE =
INPUT = src/libstrongswan \
src/charon \
src/libsimaka \
src/libfast \
src/manager

View File

@ -54,4 +54,4 @@ struct eap_sim_peer_t {
eap_sim_peer_t *eap_sim_peer_create(identification_t *server,
identification_t *peer);
#endif /* EAP_SIM_PEER_H_ @}*/
#endif /** EAP_SIM_PEER_H_ @}*/

View File

@ -54,4 +54,4 @@ struct eap_sim_server_t {
eap_sim_server_t *eap_sim_server_create(identification_t *server,
identification_t *peer);
#endif /* EAP_SIM_SERVER_H_ @}*/
#endif /** EAP_SIM_SERVER_H_ @}*/

View File

@ -79,4 +79,4 @@ struct simaka_crypto_t {
*/
simaka_crypto_t *simaka_crypto_create();
#endif /* SIMAKA_CRYPTO_ @}*/
#endif /** SIMAKA_CRYPTO_H_ @}*/

View File

@ -14,6 +14,11 @@
*/
/**
* @defgroup libsimaka libsimaka
*
* @addtogroup libsimaka
* Library providing functions shared between EAP-SIM and EAP-AKA plugins.
*
* @defgroup simaka_message simaka_message
* @{ @ingroup libsimaka
*/
@ -94,25 +99,25 @@ extern enum_name_t *simaka_attribute_names;
* Notification codes used within AT_NOTIFICATION attribute.
*/
enum simaka_notification_t {
/* SIM General failure after authentication. (Implies failure) */
/** SIM General failure after authentication. (Implies failure) */
SIM_GENERAL_FAILURE_AA = 0,
/* AKA General failure after authentication. (Implies failure) */
/** AKA General failure after authentication. (Implies failure) */
AKA_GENERAL_FAILURE_AA = 0,
/* SIM General failure. (Implies failure, used before authentication) */
/** SIM General failure. (Implies failure, used before authentication) */
SIM_GENERAL_FAILURE = 16384,
/* AKA General failure. (Implies failure, used before authentication) */
/** AKA General failure. (Implies failure, used before authentication) */
AKA_GENERAL_FAILURE = 16384,
/* SIM User has been temporarily denied access to the requested service. */
/** SIM User has been temporarily denied access to the requested service. */
SIM_TEMP_DENIED = 1026,
/* AKA User has been temporarily denied access to the requested service. */
/** AKA User has been temporarily denied access to the requested service. */
AKA_TEMP_DENIED = 1026,
/* SIM User has not subscribed to the requested service. */
/** SIM User has not subscribed to the requested service. */
SIM_NOT_SUBSCRIBED = 1031,
/* AKA User has not subscribed to the requested service. */
/** AKA User has not subscribed to the requested service. */
AKA_NOT_SUBSCRIBED = 1031,
/* SIM Success. User has been successfully authenticated. */
/** SIM Success. User has been successfully authenticated. */
SIM_SUCCESS = 32768,
/* AKA Success. User has been successfully authenticated. */
/** AKA Success. User has been successfully authenticated. */
AKA_SUCCESS = 32768,
};
@ -125,15 +130,15 @@ extern enum_name_t *simaka_notification_names;
* Error codes sent in AT_CLIENT_ERROR_CODE attribute
*/
enum simaka_client_error_t {
/* AKA unable to process packet */
/** AKA unable to process packet */
AKA_UNABLE_TO_PROCESS = 0,
/* SIM unable to process packet */
/** SIM unable to process packet */
SIM_UNABLE_TO_PROCESS = 0,
/* SIM unsupported version */
/** SIM unsupported version */
SIM_UNSUPPORTED_VERSION = 1,
/* SIM insufficient number of challenges */
/** SIM insufficient number of challenges */
SIM_INSUFFICIENT_CHALLENGES = 2,
/* SIM RANDs are not fresh */
/** SIM RANDs are not fresh */
SIM_RANDS_NOT_FRESH = 3,
};
@ -247,7 +252,8 @@ struct simaka_message_t {
*
* @param request TRUE for a request message, FALSE for a response
* @param identifier EAP message identifier
* @param type EAP subtype of the message
* @param type EAP type: EAP-SIM or EAP-AKA
* @param subtype subtype of the EAP message
* @return empty message of requested kind, NULL on error
*/
simaka_message_t *simaka_message_create(bool request, u_int8_t identifier,
@ -261,4 +267,4 @@ simaka_message_t *simaka_message_create(bool request, u_int8_t identifier,
*/
simaka_message_t *simaka_message_create_from_payload(eap_payload_t *payload);
#endif /* SIMAKA_MESSAGE_H_ @}*/
#endif /** SIMAKA_MESSAGE_H_ @}*/