commit | 08cc9dd6340498759dc27feeb6f75a24126a2caf | [log] [tgz] |
---|---|---|
author | arehbein <arehbein@sysmocom.de> | Sat Feb 25 17:48:58 2023 +0100 |
committer | arehbein <arehbein@sysmocom.de> | Sat Feb 25 17:48:58 2023 +0100 |
tree | 3ecfaa5ff38a068f0564ba12ba37754c65291973 | |
parent | f7a00a5528daaad74906c5d1428a929e255e0130 [diff] |
Transition to use of 'telnet_init_default' Related: OS#5809 Change-Id: Icc57c68337d55c6594c1c36e9bf41624d11dab0a
This repository contains a C-language implementation of a simulator for the SGW/MME/UE side of GTP-U. It is part of the Osmocom Open Source Mobile Communications project.
This code is primarily intended to be used in testing of 2G/3G/4G GGSN and P-GW.
Every GTP tunnel (corresponding to a PDP context or EPC bearer) is terminated in a local 'tun' device, which in turn is put into its own network namespace.
This means you can simulate any number of users / sessions / bearers on a single machine without any routing nightmare.
The code only implements the user plane (GTP1U), and not the control plane like GTP1C or GTP2C. osmo-uecups-daemon exposes a JSON-over-SCTP protocol calleD UECUPS, which allows any external control plane instance to add/remove tunnels in the daemon
The official homepage of the project is https://osmocom.org/projects/osmo-ggsn/wiki/osmo-uecups
You can clone from the official osmo-uecups.git repository using
git clone https://gitea.osmocom.org/cellular-infrastructure/osmo-uecups
There is a web interface at https://gitea.osmocom.org/cellular-infrastructure/osmo-uecups
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
Request to osmo-uecups:
{"reset_all_state":{}}
Response from osmo-uecups:
{"reset_all_state_res": {"result": "OK"}}
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"}}
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}}
Discussions related to this software are happening on the osmocom-net-gprs@lists.osmocom.org mailing list, please see https://lists.osmocom.org/mailman/listinfo/osmocom-net-gprs for subscription options and the list archive.
Please observe the Osmocom Mailing List Rules when posting.
Our coding standards are described at https://osmocom.org/projects/cellular-infrastructure/wiki/Coding_standards
We us a gerrit based patch submission/review process for managing contributions. Please see https://osmocom.org/projects/cellular-infrastructure/wiki/Gerrit for more details
The current patch queue for osmo-uecups can be seen at https://gerrit.osmocom.org/#/q/project:osmo-uecups+status:open