mirror of https://gerrit.osmocom.org/libosmocore
api doc: auth_core.c: add \returns, cosmetic
Add various missing \returns doxygen entries. In osmo_auth_3g_from_2g(), also adjust two comment-closing instances to match common style and add a period to end a sentence. (The recent addition of osmo_auth_3g_from_2g() raised my attention, and I added more return value docs while at it.) Change-Id: Iea71eb666bc061acb6b14215f398bd38d17b3ad3 Reviewed-on: https://gerrit.osmocom.org/33 Tested-by: Jenkins Builder Reviewed-by: Holger Freyther <holger@freyther.de>
This commit is contained in:
parent
7530d8242e
commit
c7bf8d0c84
|
@ -43,6 +43,7 @@ static struct osmo_auth_impl *selected_auths[_OSMO_AUTH_ALG_NUM];
|
||||||
|
|
||||||
/*! \brief Register an authentication algorithm implementation with the core
|
/*! \brief Register an authentication algorithm implementation with the core
|
||||||
* \param[in] impl Structure describing implementation and it's callbacks
|
* \param[in] impl Structure describing implementation and it's callbacks
|
||||||
|
* \returns 0 on success, or a negative error code on failure
|
||||||
*
|
*
|
||||||
* This function is called by an authentication implementation plugin to
|
* This function is called by an authentication implementation plugin to
|
||||||
* register itself with the authentication core.
|
* register itself with the authentication core.
|
||||||
|
@ -64,6 +65,7 @@ int osmo_auth_register(struct osmo_auth_impl *impl)
|
||||||
|
|
||||||
/*! \brief Load all available authentication plugins from the given path
|
/*! \brief Load all available authentication plugins from the given path
|
||||||
* \param[in] path Path name of the directory containing the plugins
|
* \param[in] path Path name of the directory containing the plugins
|
||||||
|
* \returns number of plugins loaded in case of success, negative in case of error
|
||||||
*
|
*
|
||||||
* This function will load all plugins contained in the specified path.
|
* This function will load all plugins contained in the specified path.
|
||||||
*/
|
*/
|
||||||
|
@ -75,6 +77,7 @@ int osmo_auth_load(const char *path)
|
||||||
|
|
||||||
/*! \brief Determine if a given authentication algorithm is supported
|
/*! \brief Determine if a given authentication algorithm is supported
|
||||||
* \param[in] algo Algorithm which should be checked
|
* \param[in] algo Algorithm which should be checked
|
||||||
|
* \returns 1 if algo is supported, 0 if not, negative error on failure
|
||||||
*
|
*
|
||||||
* This function is used by an application to determine at runtime if a
|
* This function is used by an application to determine at runtime if a
|
||||||
* given authentication algorithm is supported or not.
|
* given authentication algorithm is supported or not.
|
||||||
|
@ -111,10 +114,12 @@ static inline void c4_function(uint8_t *ck, const uint8_t *kc)
|
||||||
|
|
||||||
/*! \brief Generate 3G CK + IK from 2G authentication vector
|
/*! \brief Generate 3G CK + IK from 2G authentication vector
|
||||||
* \param vec Authentication Vector to be modified
|
* \param vec Authentication Vector to be modified
|
||||||
|
* \returns 1 if the vector was changed, 0 otherwise
|
||||||
*
|
*
|
||||||
* This function performs the C5 and C4 functions to derive the UMTS key
|
* This function performs the C5 and C4 functions to derive the UMTS key
|
||||||
* material from the GSM key material in the supplied vector, _if_ the input
|
* material from the GSM key material in the supplied vector, _if_ the input
|
||||||
* vector doesn't yet have UMTS authentication capability */
|
* vector doesn't yet have UMTS authentication capability.
|
||||||
|
*/
|
||||||
int osmo_auth_3g_from_2g(struct osmo_auth_vector *vec)
|
int osmo_auth_3g_from_2g(struct osmo_auth_vector *vec)
|
||||||
{
|
{
|
||||||
if ((vec->auth_types & OSMO_AUTH_TYPE_GSM) &&
|
if ((vec->auth_types & OSMO_AUTH_TYPE_GSM) &&
|
||||||
|
@ -124,7 +129,7 @@ int osmo_auth_3g_from_2g(struct osmo_auth_vector *vec)
|
||||||
/* We cannot actually set OSMO_AUTH_TYPE_UMTS as we have no
|
/* We cannot actually set OSMO_AUTH_TYPE_UMTS as we have no
|
||||||
* AUTN and no RES, and thus can only perform GSM
|
* AUTN and no RES, and thus can only perform GSM
|
||||||
* authentication with this tuple.
|
* authentication with this tuple.
|
||||||
* */
|
*/
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -135,6 +140,7 @@ int osmo_auth_3g_from_2g(struct osmo_auth_vector *vec)
|
||||||
* \param[out] vec Generated authentication vector
|
* \param[out] vec Generated authentication vector
|
||||||
* \param[in] aud Subscriber-specific key material
|
* \param[in] aud Subscriber-specific key material
|
||||||
* \param[in] _rand Random challenge to be used
|
* \param[in] _rand Random challenge to be used
|
||||||
|
* \returns 0 on success, negative error on failure
|
||||||
*
|
*
|
||||||
* This function performs the core cryptographic function of the AUC,
|
* This function performs the core cryptographic function of the AUC,
|
||||||
* computing authentication triples/quintuples based on the permanent
|
* computing authentication triples/quintuples based on the permanent
|
||||||
|
@ -167,6 +173,7 @@ int osmo_auth_gen_vec(struct osmo_auth_vector *vec,
|
||||||
* \param[in] rand_auts RAND value sent by the SIM/MS
|
* \param[in] rand_auts RAND value sent by the SIM/MS
|
||||||
* \param[in] auts AUTS value sent by the SIM/MS
|
* \param[in] auts AUTS value sent by the SIM/MS
|
||||||
* \param[in] _rand Random challenge to be used to generate vector
|
* \param[in] _rand Random challenge to be used to generate vector
|
||||||
|
* \returns 0 on success, negative error on failure
|
||||||
*
|
*
|
||||||
* This function performs a special variant of the core cryptographic
|
* This function performs a special variant of the core cryptographic
|
||||||
* function of the AUC: computing authentication triples/quintuples
|
* function of the AUC: computing authentication triples/quintuples
|
||||||
|
|
Loading…
Reference in New Issue