summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorHarald Welte <laforge@gnumonks.org>2017-10-16 18:31:20 +0200
committerHarald Welte <laforge@gnumonks.org>2017-10-17 07:53:02 +0200
commit381a1aa1c190697ccaa939081573268739aeea28 (patch)
treef349f931059cf6cce4e952feff388b8d029609d1
parent55d724addc3184a7fd6bb77160bbdbd0ec772d9f (diff)
[doc] Define 'gsup' group with proper name, add intro text
Change-Id: Ieee6213dc5aad082a2d439c7418b51f281b80b1a
-rw-r--r--include/osmocom/gsm/gsup.h21
-rw-r--r--src/gsm/gsup.c3
2 files changed, 20 insertions, 4 deletions
diff --git a/include/osmocom/gsm/gsup.h b/include/osmocom/gsm/gsup.h
index 36e5c841..8daf4602 100644
--- a/include/osmocom/gsm/gsup.h
+++ b/include/osmocom/gsm/gsup.h
@@ -1,5 +1,20 @@
-/*! \file gsup.h
- * Osmocom Generic Subscriber Update Protocol message encoder/decoder. */
+/*! \defgroup gsup Generic Subscriber Update Protocol
+ * @{
+ *
+ * The Generic Subscriber Update Protocol (GSUP) is an Osmocom-specific
+ * non-standard protocol replacing MAP as the protocol between
+ * MSC/VLR/SGSN and HLR in a 3GPP cellular communications network.
+ *
+ * It was designed around the same transactions and architecture as the
+ * MAP messages/operations, but without the complexity of TCAP and MAP,
+ * and without the need for ASN.1 encoding.
+ *
+ * The purpose is to keep protocol complexity out of OsmoSGSN and
+ * OsmoMSC, while providing a clean path to an external GSUP to MAP
+ * translator.
+ *
+ * \file gsup.h
+ * Osmocom Generic Subscriber Update Protocol message encoder/decoder. */
/*
* (C) 2014 by sysmocom s.f.m.c. GmbH, Author: Jacob Erlbeck
* (C) 2016 by Harald Welte <laforge@gnumonks.org>
@@ -163,3 +178,5 @@ struct osmo_gsup_message {
int osmo_gsup_decode(const uint8_t *data, size_t data_len,
struct osmo_gsup_message *gsup_msg);
void osmo_gsup_encode(struct msgb *msg, const struct osmo_gsup_message *gsup_msg);
+
+/*! @} */
diff --git a/src/gsm/gsup.c b/src/gsm/gsup.c
index 685c91f4..e5b0a663 100644
--- a/src/gsm/gsup.c
+++ b/src/gsm/gsup.c
@@ -1,5 +1,3 @@
-/*! \file gsup.c
- * Osmocom Generic Subscriber Update Protocol message encoder/decoder. */
/*
* (C) 2014 by sysmocom s.f.m.c. GmbH
* (C) 2015 by Holger Hans Peter Freyther
@@ -33,6 +31,7 @@
/*! \addtogroup gsup
* @{
+ * \file gsup.c
* Osmocom Generic Subscriber Update Protocol
*/