From 2b6d272549b0e12b656571b405aa449491b2b043 Mon Sep 17 00:00:00 2001
From: Max <msuraev@sysmocom.de>
Date: Wed, 4 May 2016 16:37:36 +0200
Subject: Add OsmoSGSN control interface description

---
 doc/manuals/chapters/control.adoc    | 23 +++++++++++++++++++++++
 doc/manuals/osmosgsn-usermanual.adoc |  2 ++
 2 files changed, 25 insertions(+)
 create mode 100644 doc/manuals/chapters/control.adoc

diff --git a/doc/manuals/chapters/control.adoc b/doc/manuals/chapters/control.adoc
new file mode 100644
index 000000000..0f2bfae0a
--- /dev/null
+++ b/doc/manuals/chapters/control.adoc
@@ -0,0 +1,23 @@
+[[control]]
+== Control interface
+
+The actual protocol is described in <<common-control-if>>, the variables
+common to all programs using it are described in <<ctrl_common_vars>>. Here we
+describe variables specific to OsmoSGSN.
+
+.Variables available over control interface
+[options="header",width="100%",cols="20%,5%,5%,50%,20%"]
+|===
+|Name|Access|Trap|Value|Comment
+|subscriber-list-active-v1|RO|No|"<imsi>,<addr>"|See <<subs>> for details.
+|===
+
+[[subs]]
+=== subscriber-list-active-v1
+
+Return the list of active subscribers as a concatenated set of pairs "<imsi>",
+"addr" where first element of the pair is subscriber's IMSI and the second
+element (which might be empty) is the subscriber's address. The address value
+might be "none", "invalid" and "PPP" in addition to actual IP address. In case
+of IP address it will be prefixed with "IPv4" or "IPv6" string depending on the
+version of IP protocol.
diff --git a/doc/manuals/osmosgsn-usermanual.adoc b/doc/manuals/osmosgsn-usermanual.adoc
index d532a31d2..12a7b8756 100644
--- a/doc/manuals/osmosgsn-usermanual.adoc
+++ b/doc/manuals/osmosgsn-usermanual.adoc
@@ -9,6 +9,8 @@ include::chapters/overview.adoc[]
 
 include::chapters/running.adoc[]
 
+include::chapters/control.adoc[]
+
 include::../common/chapters/vty.adoc[]
 
 include::../common/chapters/logging.adoc[]
-- 
cgit v1.2.3