Osmocom Open Build Service

osmo-uecups.spec Changed

@@ -14,22 +14,22 @@
 
 Name:           osmo-uecups
 Requires: osmocom-latest
-Version: 0.2.1
+Version: 0.2.2
 Release:        0
 Summary:        OsmoUECUPS: UE/MME/SGW side GTP user plane daemon with control plane separation
 License:        GPL-2.0-or-later
 Group:          Productivity/Telephony/Utilities
 URL:            https://osmocom.org/projects/osmo-uecups
-Source: osmo-uecups_0.2.1.tar.xz
+Source: osmo-uecups_0.2.2.tar.xz
 Source1: rpmlintrc
 BuildRequires:  autoconf
 BuildRequires:  autoconf-archive
 BuildRequires:  automake
 BuildRequires:  libtool
 BuildRequires:  pkgconfig
-BuildRequires:  pkgconfig(libosmocore) >= 1.8.0
-BuildRequires:  pkgconfig(libosmovty) >= 1.8.0
-BuildRequires:  pkgconfig(libosmo-netif) >= 1.3.0
+BuildRequires:  pkgconfig(libosmocore) >= 1.9.0
+BuildRequires:  pkgconfig(libosmovty) >= 1.9.0
+BuildRequires:  pkgconfig(libosmo-netif) >= 1.4.0
 BuildRequires:  pkgconfig(jansson)
 BuildRequires:  pkgconfig(libnl-route-3.0)
 BuildRequires:  lksctp-tools-devel

osmo-uecups_0.2.1.dsc -> osmo-uecups_0.2.2.dsc Changed

@@ -2,18 +2,18 @@
 Source: osmo-uecups
 Binary: osmo-uecups
 Architecture: any
-Version: 0.2.1
-Maintainer: Harald Welte <laforge@osmocom.org>
+Version: 0.2.2
+Maintainer: Osmocom team <openbsc@lists.osmocom.org>
 Homepage: https://osmocom.org/projects/osmo-uecups
 Standards-Version: 3.9.8
 Vcs-Browser: https://gitea.osmocom.org/cellular-infrastructure/osmo-uecups
 Vcs-Git: https://gitea.osmocom.org/cellular-infrastructure/osmo-uecups
-Build-Depends: debhelper (>= 9), dh-autoreconf, autotools-dev, autoconf, automake, libtool, pkg-config, libjansson-dev, libnl-route-3-dev, libosmocore-dev (>= 1.8.0), libosmo-netif-dev (>= 1.3.0), libsctp-dev, osmo-gsm-manuals-dev (>= 1.4.0)
+Build-Depends: debhelper (>= 10), dh-autoreconf, autotools-dev, autoconf, automake, libtool, pkg-config, libjansson-dev, libnl-route-3-dev, libosmocore-dev (>= 1.9.0), libosmo-netif-dev (>= 1.4.0), libsctp-dev, osmo-gsm-manuals-dev (>= 1.5.0)
 Package-List:
  osmo-uecups deb net extra arch=any
 Checksums-Sha1:
- 7abb9fea061f59ab92cae3ce7b1e49e6ba93fe73 27696 osmo-uecups_0.2.1.tar.xz
+ 1b56f3ef960fa56d34490d8dd0625ada847f0922 29228 osmo-uecups_0.2.2.tar.xz
 Checksums-Sha256:
- d0b33c3d6a21fceaa9da83372bda7c328a27684dd3c277ff08a785e84b71dcdd 27696 osmo-uecups_0.2.1.tar.xz
+ 20ae887d5c70a21d7daa80bf106dfc0396058124c39728cdbae3ddad95fd9adc 29228 osmo-uecups_0.2.2.tar.xz
 Files:
- 2a7228d82b1ebf6870a853f511851167 27696 osmo-uecups_0.2.1.tar.xz
+ 683719f9716f4919fdfbbe5d4b78e895 29228 osmo-uecups_0.2.2.tar.xz

osmo-uecups_0.2.1.tar.xz/.tarball-version -> osmo-uecups_0.2.2.tar.xz/.tarball-version Changed

osmo-uecups_0.2.1.tar.xz/README.md -> osmo-uecups_0.2.2.tar.xz/README.md Changed

@@ -37,7 +37,87 @@
 Documentation
 -------------
 
-FIXME
+Please check the PGW test suite we have at
+https://gitea.osmocom.org/ttcn3/osmo-ttcn3-hacks/src/branch/master/pgw
+for a full example.  This test suite implements the signaling plane of
+simulating UE/MME/SGW towards a PGW (device under test).  It uses
+osmo-uecups to simulate the user plane and start commands like "ping"
+within the netns of the simulated UE.
+
+The interface between test suite and osmo-uecups is using
+JSON-serialized commands via a SCTP socket on SCTP port 4268.
+
+JSON Examples from the above PGW tests suite execution look like below.  You can find a pcap file containing this example communication in contrib/osmo-uecups-example.pcap
+
+### Initial reset of state:
+
+Request to osmo-uecups:
+```
+{"reset_all_state":{}}
+```
+
+Response from osmo-uecups:
+```
+{"reset_all_state_res": {"result": "OK"}}
+```
+
+### Creating a GTP tunnel / UE with its own tun-device in its own netns
+
+Request to osmo-uecups:
+```
+{
+   "create_tun" : {
+      "local_gtp_ep" : {
+         "Port" : 2152,
+         "addr_type" : "IPV4",
+         "ip" : "AC121B14"
+      },
+      "remote_gtp_ep" : {
+         "Port" : 2152,
+         "addr_type" : "IPV4",
+         "ip" : "AC121B07"
+      },
+      "rx_teid" : 2029948341,
+      "tun_dev_name" : "tun23",
+      "tun_netns_name" : "tun23",
+      "tx_teid" : 6,
+      "user_addr" : "0A2D0003",
+      "user_addr_type" : "IPV4"
+   }
+}
+```
+
+Response from osmo-uecups:
+```
+{"create_tun_res": {"result": "OK"}}
+```
+
+### Running a test program (here "ping") inside that netns, just as if the command was executed on the UE
+
+
+Request to osmo-uecups:
+```
+{
+   "start_program" : {
+      "command" : "ping -c 10 -i 1 -I 10.45.0.3 10.45.0.1 1>>/data/TC_createSession_ping4.prog.stdout 2>>/data/TC_createSession_ping4.prog.stderr",
+      "environment" : ,
+      "run_as_user" : "osmocom",
+      "tun_netns_name" : "tun23"
+   }
+}
+```
+
+Initial Response from osmo-uecups (program was started):
+```
+{"start_program_res": {"pid": 12, "result": "OK"}}
+```
+
+Final response from osmo-uecups (program terminated):
+```
+{"program_term_ind": {"exit_code": 0, "pid": 12}}
+```
+
+
 
 Mailing List
 ------------

osmo-uecups_0.2.1.tar.xz/configure.ac -> osmo-uecups_0.2.2.tar.xz/configure.ac Changed

osmo-uecups_0.2.2.tar.xz/contrib/osmo-uecups-example.pcap Added

osmo-uecups_0.2.1.tar.xz/contrib/osmo-uecups.spec.in -> osmo-uecups_0.2.2.tar.xz/contrib/osmo-uecups.spec.in Changed

osmo-uecups_0.2.1.tar.xz/daemon/daemon_vty.c -> osmo-uecups_0.2.2.tar.xz/daemon/daemon_vty.c Changed

osmo-uecups_0.2.1.tar.xz/daemon/gtp_daemon.c -> osmo-uecups_0.2.2.tar.xz/daemon/gtp_daemon.c Changed

osmo-uecups_0.2.1.tar.xz/daemon/gtp_tunnel.c -> osmo-uecups_0.2.2.tar.xz/daemon/gtp_tunnel.c Changed

osmo-uecups_0.2.1.tar.xz/daemon/main.c -> osmo-uecups_0.2.2.tar.xz/daemon/main.c Changed

osmo-uecups_0.2.1.tar.xz/debian/changelog -> osmo-uecups_0.2.2.tar.xz/debian/changelog Changed

osmo-uecups_0.2.1.tar.xz/debian/compat -> osmo-uecups_0.2.2.tar.xz/debian/compat Changed

osmo-uecups_0.2.1.tar.xz/debian/control -> osmo-uecups_0.2.2.tar.xz/debian/control Changed

Changes of Revision 4