diff options
author | Harald Welte <laforge@gnumonks.org> | 2017-10-16 18:34:14 +0200 |
---|---|---|
committer | Harald Welte <laforge@gnumonks.org> | 2017-10-17 07:53:02 +0200 |
commit | a338983d3bfd8d8475921df84b746d27f857d2e7 (patch) | |
tree | 7bb219b613b596c5ada567211284c384be9d84e3 | |
parent | 381a1aa1c190697ccaa939081573268739aeea28 (diff) |
[doc] Properly define 'oap' group and add introductory text
Change-Id: I1e875991ae1dd93862f850f85d40b3dac61ece72
-rw-r--r-- | include/osmocom/gsm/oap.h | 13 | ||||
-rw-r--r-- | src/gsm/oap.c | 3 |
2 files changed, 12 insertions, 4 deletions
diff --git a/include/osmocom/gsm/oap.h b/include/osmocom/gsm/oap.h index ef83b794..ce1e1513 100644 --- a/include/osmocom/gsm/oap.h +++ b/include/osmocom/gsm/oap.h @@ -1,5 +1,12 @@ -/*! \file oap.h - * Osmocom Authentication Protocol message encoder/decoder. */ +/*! \defgroup oap Osmocom Authentication Protocol + * @{ + * + * The Osmocom Authentication Protocol (OAP) is a way to use the 3GPP + * AKA (Authentication and Key Agreement) as cryptographic + * authentication mechanism in other protocols that don't provide + * cryptographic authentication. + * + * \file oap.h */ /* * (C) 2015-2016 by sysmocom s.f.m.c. GmbH * All Rights Reserved @@ -71,3 +78,5 @@ struct osmo_oap_message { int osmo_oap_decode(struct osmo_oap_message *oap_msg, const uint8_t *data, size_t data_len); void osmo_oap_encode(struct msgb *msg, const struct osmo_oap_message *oap_msg); + +/*! @} */ diff --git a/src/gsm/oap.c b/src/gsm/oap.c index b07eafcf..aab5caca 100644 --- a/src/gsm/oap.c +++ b/src/gsm/oap.c @@ -1,5 +1,3 @@ -/*! \file oap.c - * Osmocom Authentication Protocol message encoder/decoder */ /* * (C) 2015-2016 by sysmocom s.f.m.c. GmbH * All Rights Reserved @@ -31,6 +29,7 @@ /*! \addtogroup oap * @{ + * \file oap.c * Osmocom Authentication Protocol */ |