March 2024 - gerrit-log - lists.osmocom.org

[S] Change in osmo-bsc[master]: Add funding link to github mirror

by laforge

laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-bsc/+/36427?usp=email ) Change subject: Add funding link to github mirror ...................................................................... Add funding link to github mirror see https://docs.github.com/en/repositories/managing-your-repositorys-settings-… Change-Id: I754edea2ed122b6056e0fc94056ec6d509299067 --- A .github/FUNDING.yml 1 file changed, 12 insertions(+), 0 deletions(-) git pull ssh://gerrit.osmocom.org:29418/osmo-bsc refs/changes/27/36427/1 diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml new file mode 100644 index 0000000..7592deb --- /dev/null +++ b/.github/FUNDING.yml @@ -0,0 +1 @@ +open_collective: osmocom -- To view, visit https://gerrit.osmocom.org/c/osmo-bsc/+/36427?usp=email To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-bsc Gerrit-Branch: master Gerrit-Change-Id: I754edea2ed122b6056e0fc94056ec6d509299067 Gerrit-Change-Number: 36427 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-MessageType: newchange

1 year, 4 months

1
0
0 0

[M] Change in osmo-ggsn[master]: README.md: Major overhaul

by laforge

laforge has submitted this change. ( https://gerrit.osmocom.org/c/osmo-ggsn/+/36426?usp=email ) Change subject: README.md: Major overhaul ...................................................................... README.md: Major overhaul A lot of the existing contents was still from the old openggsn days, and predated osmo-ggsn. Change-Id: I6ec92260da0f55e9493a15db2e8178e5436143a0 --- M README.md 1 file changed, 60 insertions(+), 77 deletions(-) Approvals: Jenkins Builder: Verified laforge: Looks good to me, approved diff --git a/README.md b/README.md index 52f993e..dd9a424 100644 --- a/README.md +++ b/README.md @@ -6,8 +6,8 @@ networks such as GPRS, EDGE, UMTS or HSPA. **OsmoGGSN** is part of the [Osmocom](https://osmocom.org/) Open Source -Mobile Communications projects and the successor to OpenGGSN. -OpenGGSN was developed until 2004 by Mondru AB. +Mobile Communications projects and the successor to OpenGGSN (which was +developed until 2004 by Mondru AB). Homepage -------- @@ -89,61 +89,33 @@ kernels later than 2.4.7 the driver is typically included, but might need to be configured for automatic loading: -1. Add the following line to /etc/modules.conf: alias char-major-10-200 tun -2. depmod -a +1. Add the following line to `/etc/modules.conf`: `alias char-major-10-200 tun` +2. `depmod -a` Installation from binary ------------------------ -OsmoGGSN is built for common versions of Debian and Ubuntu as part of +OsmoGGSN is built for common versions of Debian, Ubuntu and other distributions part of the [Osmocom Nightly Builds](https://osmocom.org/projects/cellular-infrastructure/wiki/Nightly_B… -project. If you don't want to do development, it is suggested to simply -use those binary packages, rather than building yourself from source. +and [Osmocom Latest Builds](https://osmocom.org/projects/cellular-infrastructure/wiki/Latest_Bu…. +If you don't want to do development, it is suggested to simply use those binary packages, rather than building +yourself from source. Installation from source ------------------------ -1. ./configure -2. make -3. make install +``` +./configure +make +make install +``` You need to be root in order to install the package, but not in order to compile. -Running -------- - -*sgsnemu* -Start the emulator as root using the command: - - sgsnemu -l 10.0.0.50 -r 10.0.0.40 --createif --defaultroute - -This will cause the sgsn emulator to bind to local address 10.0.0.50 -and connect to the ggsn found at 10.0.0.40. It will first send off an -ECHO_REQUEST message. After this it will attempt to establish a pdp -context. If successful it will create a local interface and set up -routing. Now you should be able to ping through the connection. Use a -network analysator such as ethereal to monitor the traffic. - -sgsnemu -h will show a list of available options. - -sgsnemu -c sgsnemu.conf will use sgsnemu.conf as a configuration -file. A sample file is provided in examples/sgsnemu.conf. - -*ggsn* -Edit the configuration file ggsn.conf found under openggsn/examples. -Start the ggsn as root using the command: - -ggsn --fg -c examples/ggsn.conf -l 10.0.0.40 --statedir ./ - -This will run the ggsn in foreground using the local interface -10.0.0.40. If you don't have a GSM network available for testing you -can use sgsnemu to test the GGSN. - - Support ------- @@ -158,9 +130,10 @@ version 1. OsmoGGSN provides 3 components: - * gtplib - * osmo-ggsn - * sgsnemu + + * *libgtp*, a shared library for the GTPv1C protocol + * *osmo-ggsn*, the GGSN itself + * *sgsnemu*, a SGSN emulator *gtplib* This library contains all functionality relating to the GTP @@ -196,10 +169,10 @@ version 1.1. With Linux tun is normally included from kernel version 2.4.7. To configure automatic loading: -1. Add the following line to /etc/modules.conf: alias char-major-10-200 tun -2. depmod -a +1. Add the following line to `/etc/modules.conf`: `alias char-major-10-200 tun` +2. `depmod -a` -Alternatively you can execute "modprobe tun" on the commandline. +Alternatively you can execute `modprobe tun` on the commandline. Gengetopt --------- @@ -209,11 +182,13 @@ you are just going to compile the programs you don't need gengetopt. To use gengetopt for the sgsnemu do the following: +``` cd sgsnemu gengetopt < cmdline.ggo --conf-parser +``` For more information about gengetopt see -http://www.gnu.org/software/gengetopt/gengetopt.html +<http://www.gnu.org/software/gengetopt/gengetopt.html> Compilation and Installation @@ -227,27 +202,21 @@ Use osmo-ggsn -h for a list of available options. All options available on the command line can also be given in a configuration file. See -examples/osmo-ggsn.cfg for the format of this file. +`doc/examples/osmo-ggsn.cfg` for the format of this file. Start osmo-ggsn as root using the command: -osmo-ggsn -c examples/osmo-ggsn.cfg +`osmo-ggsn -c doc/examples/osmo-ggsn.cfg` -First a tun network interface will be created. In the above example -the network interface address is 192.168.0.0 and the mask is -255.255.255.0. You can check that this interface is up by using -ifconfig. +First, a tun network interface will be created for each configured apn. After tun has been successfully established the ggsn will wait for GTP -create PDP context requests on the local interface -10.0.0.40. Currently all requests are accepted, and no password, -username or APN validation is performed. +create PDP context requests on the configured `gtp bind-ip` address. +Currently all requests are accepted, and no password, username validation is performed. -When receiving a create PDP context request a dynamic IP address will -be allocated from the address pool determined by --dynip. In the above -example the first allocated address will be 192.168.0.1, followed by -192.168.0.2 and so on. The request is confirmed by sending a create -PDP context response message to the peer (SGSN). +When receiving a create PDP context request for a given APN, a dynamic IP address will +be allocated from the address pool defined in the config file section for that apn. +The request is confirmed by sending a create PDP context response message to the peer (SGSN). Now IP packets will be forwarded between the tun network interface and the established GTP tunnel. In order to allow users to access the @@ -255,22 +224,22 @@ used you need to configure network address translation. See the Linux Networking HOWTO for details. -Remember to enable routing: +Remember to enable routing: -echo 1 > /proc/sys/net/ipv4/ip_forward +`echo 1 > /proc/sys/net/ipv4/ip_forward` -If you installed using a binary RPM package it is possible to start -osmo-ggsn by using the Sys 5 script: +If you're using systemd and did `make install` or installed from a bianry package, +you can start osmo-ggsn by using the included systemd service/unit file: -/etc/init.d/osmo-ggsn start +`systemctl start osmo-ggsn` Running sgsnemu =============== -Use sgsnemu -h for a list of available options. All options available +Use `sgsnemu -h` for a list of available options. All options available on the command line can also be given in a configuration file. See -examples/sgsnemu.conf for the format of this file. +`doc/examples/sgsnemu.conf` for the format of this file. If you want to test a GRX roaming connection you will need to do the following: @@ -283,11 +252,11 @@ details. 4. Launch sgsnemu with something like: -sgsnemu --listen 10.0.0.50 --remote 10.0.0.40 --dns 10.20.38.51 --timelimit 10 --contexts 0 +`sgsnemu --listen 10.0.0.50 --remote 10.0.0.40 --dns 10.20.38.51 --timelimit 10 --contexts 0` sgsnemu will print something like the following on the screen: - +``` Using DNS server: 10.20.38.51 (10.20.38.51) Local IP address is: 10.0.0.50 (10.0.0.50) Remote IP address is: 10.0.0.40 (10.0.0.40) @@ -303,6 +272,7 @@ Waiting for response from ggsn........ Received echo response. Cause value: 0 +``` This is quite good. It means that you managed to send off an echo request to a remote GGSN, and it was friendly enough to answer you. If @@ -320,10 +290,11 @@ network, so please be carefull not to route internet traffic onto the GPRS core network! Assuming you know what you are doing: -sgsnemu --listen 10.0.0.50 --remote 10.0.0.40 --dns 10.20.38.51 --timelimit 10 --contexts 1 --apn internet --imsi 240011234567890 --msisdn 46702123456 --createif --defaultroute +`sgsnemu --listen 10.0.0.50 --remote 10.0.0.40 --dns 10.20.38.51 --timelimit 10 --contexts 1 --apn internet --imsi 240011234567890 --msisdn 46702123456 --createif --defaultroute` sgsnemu will print something like the following on the screen: +``` Using DNS server: 10.20.38.51 (10.20.38.51) Local IP address is: 10.0.0.50 (10.0.0.50) Remote IP address is: 10.0.0.40 (10.0.0.40) @@ -344,7 +315,7 @@ Setting up interface and routing /sbin/ifconfig tun0 192.168.0.1 /sbin/route add -net 192.168.0.0 netmask 255.255.255.0 gw 192.168.0.1 - +``` Now a context is established to the remote GGSN. The IP address of the context is 192.168.0.1. You should be able to ping a known address on @@ -358,13 +329,13 @@ connecting the same computer to both the Gn and Gi network, so please be carefull not to route internet traffic onto the GPRS core network and please protect yourself against hackers! For this reason it is -advised to always use --contexts 0 when testing a live network. +advised to always use `--contexts 0` when testing a live network. -After --timelimit seconds the PDP context is disconnected with the +After `--timelimit seconds` the PDP context is disconnected with the following messages from sgsnemu: - +``` Disconnecting PDP context #0 Received delete PDP context response. Cause value: 128 Deleting tun interface - +``` -- To view, visit https://gerrit.osmocom.org/c/osmo-ggsn/+/36426?usp=email To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-ggsn Gerrit-Branch: master Gerrit-Change-Id: I6ec92260da0f55e9493a15db2e8178e5436143a0 Gerrit-Change-Number: 36426 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: laforge <laforge(a)osmocom.org> Gerrit-MessageType: merged

1 year, 4 months

1
0
0 0

[M] Change in osmo-ggsn[master]: README.md: Major overhaul

by laforge

laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-ggsn/+/36426?usp=email ) Change subject: README.md: Major overhaul ...................................................................... Patch Set 1: Code-Review+2 -- To view, visit https://gerrit.osmocom.org/c/osmo-ggsn/+/36426?usp=email To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-ggsn Gerrit-Branch: master Gerrit-Change-Id: I6ec92260da0f55e9493a15db2e8178e5436143a0 Gerrit-Change-Number: 36426 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: laforge <laforge(a)osmocom.org> Gerrit-Comment-Date: Sat, 23 Mar 2024 15:35:26 +0000 Gerrit-HasComments: No Gerrit-Has-Labels: Yes Gerrit-MessageType: comment

1 year, 4 months

1
0
0 0

[S] Change in osmo-ggsn[master]: Add funding link to github mirror

by laforge

laforge has submitted this change. ( https://gerrit.osmocom.org/c/osmo-ggsn/+/36423?usp=email ) Change subject: Add funding link to github mirror ...................................................................... Add funding link to github mirror see https://docs.github.com/en/repositories/managing-your-repositorys-settings-… Change-Id: I75ba8c4f8635d5a2d36d5bb97566d737e27bcec9 --- A .github/FUNDING.yml 1 file changed, 12 insertions(+), 0 deletions(-) Approvals: laforge: Looks good to me, approved Jenkins Builder: Verified diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml new file mode 100644 index 0000000..7592deb --- /dev/null +++ b/.github/FUNDING.yml @@ -0,0 +1 @@ +open_collective: osmocom -- To view, visit https://gerrit.osmocom.org/c/osmo-ggsn/+/36423?usp=email To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-ggsn Gerrit-Branch: master Gerrit-Change-Id: I75ba8c4f8635d5a2d36d5bb97566d737e27bcec9 Gerrit-Change-Number: 36423 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: laforge <laforge(a)osmocom.org> Gerrit-MessageType: merged

1 year, 4 months

1
0
0 0

[S] Change in osmo-ggsn[master]: README.md: Improve markdown formatting

by laforge

laforge has submitted this change. ( https://gerrit.osmocom.org/c/osmo-ggsn/+/36424?usp=email ) Change subject: README.md: Improve markdown formatting ...................................................................... README.md: Improve markdown formatting Change-Id: I4e5d99384978d22e6ba0310e97e93d87b610a174 --- M README.md 1 file changed, 19 insertions(+), 11 deletions(-) Approvals: Jenkins Builder: Verified laforge: Looks good to me, approved diff --git a/README.md b/README.md index 98a03d7..90ad081 100644 --- a/README.md +++ b/README.md @@ -5,15 +5,14 @@ GPRS Support Node), a core network element of ETSI/3GPP cellular networks such as GPRS, EDGE, UMTS or HSPA. -OsmoGGSN is part of the [Osmocom](https://osmocom.org/) Open Source +**OsmoGGSN** is part of the [Osmocom](https://osmocom.org/) Open Source Mobile Communications projects and the successor to OpenGGSN. OpenGGSN was developed until 2004 by Mondru AB. Homepage -------- -The official homepage of the project is -https://osmocom.org/projects/openggsn/wiki +The official homepage of the project is <https://osmocom.org/projects/openggsn/wiki>. GIT Repository -------------- @@ -28,35 +27,35 @@ ------------- The user manual and VTY reference are optionally built in PDF form -as part of the build process. Find pre-rendered versions here: +as part of the build process. Pre-rendered versions are available here: -https://ftp.osmocom.org/docs/osmo-ggsn/master/ +* [osmo-ggsn user manual](https://ftp.osmocom.org/docs/osmo-ggsn/master/osmoggsn-usermanual.p… +* [osmo-ggsn VTY reference](https://ftp.osmocom.org/docs/osmo-ggsn/master/osmoggsn-vty-refer… Mailing List ------------ Discussions related to OsmoGGSN are happening on the osmocom-net-gprs(a)lists.osmocom.org mailing list, please see -https://lists.osmocom.org/mailman/listinfo/osmocom-net-gprs for +<https://lists.osmocom.org/mailman/listinfo/osmocom-net-gprs> for subscription options and the list archive. -Please observe the [Osmocom Mailing List -Rules](https://osmocom.org/projects/cellular-infrastructure/wiki/Mailing_List_Rules) +Please observe the [Osmocom Mailing List Rules](https://osmocom.org/projects/cellular-infrastructure/wiki/Mailing_Li… when posting. Contributing ------------ Our coding standards are described at -https://osmocom.org/projects/cellular-infrastructure/wiki/Coding_standards +<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 +<https://osmocom.org/projects/cellular-infrastructure/wiki/Gerrit> for more details The current patch queue for OsmoGGSN can be seen at -https://gerrit.osmocom.org/#/q/project:osmo-ggsn+status:open +<https://gerrit.osmocom.org/#/q/project:osmo-ggsn+status:open> QuickStart -- To view, visit https://gerrit.osmocom.org/c/osmo-ggsn/+/36424?usp=email To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-ggsn Gerrit-Branch: master Gerrit-Change-Id: I4e5d99384978d22e6ba0310e97e93d87b610a174 Gerrit-Change-Number: 36424 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: laforge <laforge(a)osmocom.org> Gerrit-MessageType: merged

1 year, 4 months

1
0
0 0

[S] Change in osmo-ggsn[master]: README.md: Add Forum + Issue Tracker sections

by laforge

laforge has submitted this change. ( https://gerrit.osmocom.org/c/osmo-ggsn/+/36425?usp=email ) Change subject: README.md: Add Forum + Issue Tracker sections ...................................................................... README.md: Add Forum + Issue Tracker sections Change-Id: I7b03a78178de77ebf733587ed178fd48c019663c --- M README.md 1 file changed, 23 insertions(+), 0 deletions(-) Approvals: Jenkins Builder: Verified laforge: Looks good to me, approved diff --git a/README.md b/README.md index 90ad081..52f993e 100644 --- a/README.md +++ b/README.md @@ -32,6 +32,13 @@ * [osmo-ggsn user manual](https://ftp.osmocom.org/docs/osmo-ggsn/master/osmoggsn-usermanual.p… * [osmo-ggsn VTY reference](https://ftp.osmocom.org/docs/osmo-ggsn/master/osmoggsn-vty-refer… +Forum +----- + +We welcome any pySim related discussions in the +[Cellular Network Infrastructure -> 2G/3G Core Network](https://discourse.osmocom.org/c/cni/2g-3g-cn/) +section of the osmocom discourse (web based Forum). + Mailing List ------------ @@ -43,6 +50,13 @@ Please observe the [Osmocom Mailing List Rules](https://osmocom.org/projects/cellular-infrastructure/wiki/Mailing_Li… when posting. +Issue Tracker +------------- + +We use the [issue tracker of the osmo-ggsn project on osmocom.org](https://osmocom.org/projects/openggsn/issues) for +tracking the state of bug reports and feature requests. Feel free to submit any issues you may find, or help +us out by resolving existing issues. + Contributing ------------ -- To view, visit https://gerrit.osmocom.org/c/osmo-ggsn/+/36425?usp=email To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-ggsn Gerrit-Branch: master Gerrit-Change-Id: I7b03a78178de77ebf733587ed178fd48c019663c Gerrit-Change-Number: 36425 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: laforge <laforge(a)osmocom.org> Gerrit-MessageType: merged

1 year, 4 months

1
0
0 0

[S] Change in osmo-ggsn[master]: README.md: Add Forum + Issue Tracker sections

by laforge

laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-ggsn/+/36425?usp=email ) Change subject: README.md: Add Forum + Issue Tracker sections ...................................................................... Patch Set 1: Code-Review+2 -- To view, visit https://gerrit.osmocom.org/c/osmo-ggsn/+/36425?usp=email To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-ggsn Gerrit-Branch: master Gerrit-Change-Id: I7b03a78178de77ebf733587ed178fd48c019663c Gerrit-Change-Number: 36425 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: laforge <laforge(a)osmocom.org> Gerrit-Comment-Date: Sat, 23 Mar 2024 15:34:38 +0000 Gerrit-HasComments: No Gerrit-Has-Labels: Yes Gerrit-MessageType: comment

1 year, 4 months

1
0
0 0

[S] Change in osmo-ggsn[master]: README.md: Improve markdown formatting

by laforge

laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-ggsn/+/36424?usp=email ) Change subject: README.md: Improve markdown formatting ...................................................................... Patch Set 1: Code-Review+2 -- To view, visit https://gerrit.osmocom.org/c/osmo-ggsn/+/36424?usp=email To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-ggsn Gerrit-Branch: master Gerrit-Change-Id: I4e5d99384978d22e6ba0310e97e93d87b610a174 Gerrit-Change-Number: 36424 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: laforge <laforge(a)osmocom.org> Gerrit-Comment-Date: Sat, 23 Mar 2024 15:34:29 +0000 Gerrit-HasComments: No Gerrit-Has-Labels: Yes Gerrit-MessageType: comment

1 year, 4 months

1
0
0 0

[M] Change in osmo-ggsn[master]: README.md: Major overhaul

by laforge

laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-ggsn/+/36426?usp=email ) Change subject: README.md: Major overhaul ...................................................................... README.md: Major overhaul A lot of the existing contents was still from the old openggsn days, and predated osmo-ggsn. Change-Id: I6ec92260da0f55e9493a15db2e8178e5436143a0 --- M README.md 1 file changed, 60 insertions(+), 77 deletions(-) git pull ssh://gerrit.osmocom.org:29418/osmo-ggsn refs/changes/26/36426/1 diff --git a/README.md b/README.md index 52f993e..dd9a424 100644 --- a/README.md +++ b/README.md @@ -6,8 +6,8 @@ networks such as GPRS, EDGE, UMTS or HSPA. **OsmoGGSN** is part of the [Osmocom](https://osmocom.org/) Open Source -Mobile Communications projects and the successor to OpenGGSN. -OpenGGSN was developed until 2004 by Mondru AB. +Mobile Communications projects and the successor to OpenGGSN (which was +developed until 2004 by Mondru AB). Homepage -------- @@ -89,61 +89,33 @@ kernels later than 2.4.7 the driver is typically included, but might need to be configured for automatic loading: -1. Add the following line to /etc/modules.conf: alias char-major-10-200 tun -2. depmod -a +1. Add the following line to `/etc/modules.conf`: `alias char-major-10-200 tun` +2. `depmod -a` Installation from binary ------------------------ -OsmoGGSN is built for common versions of Debian and Ubuntu as part of +OsmoGGSN is built for common versions of Debian, Ubuntu and other distributions part of the [Osmocom Nightly Builds](https://osmocom.org/projects/cellular-infrastructure/wiki/Nightly_B… -project. If you don't want to do development, it is suggested to simply -use those binary packages, rather than building yourself from source. +and [Osmocom Latest Builds](https://osmocom.org/projects/cellular-infrastructure/wiki/Latest_Bu…. +If you don't want to do development, it is suggested to simply use those binary packages, rather than building +yourself from source. Installation from source ------------------------ -1. ./configure -2. make -3. make install +``` +./configure +make +make install +``` You need to be root in order to install the package, but not in order to compile. -Running -------- - -*sgsnemu* -Start the emulator as root using the command: - - sgsnemu -l 10.0.0.50 -r 10.0.0.40 --createif --defaultroute - -This will cause the sgsn emulator to bind to local address 10.0.0.50 -and connect to the ggsn found at 10.0.0.40. It will first send off an -ECHO_REQUEST message. After this it will attempt to establish a pdp -context. If successful it will create a local interface and set up -routing. Now you should be able to ping through the connection. Use a -network analysator such as ethereal to monitor the traffic. - -sgsnemu -h will show a list of available options. - -sgsnemu -c sgsnemu.conf will use sgsnemu.conf as a configuration -file. A sample file is provided in examples/sgsnemu.conf. - -*ggsn* -Edit the configuration file ggsn.conf found under openggsn/examples. -Start the ggsn as root using the command: - -ggsn --fg -c examples/ggsn.conf -l 10.0.0.40 --statedir ./ - -This will run the ggsn in foreground using the local interface -10.0.0.40. If you don't have a GSM network available for testing you -can use sgsnemu to test the GGSN. - - Support ------- @@ -158,9 +130,10 @@ version 1. OsmoGGSN provides 3 components: - * gtplib - * osmo-ggsn - * sgsnemu + + * *libgtp*, a shared library for the GTPv1C protocol + * *osmo-ggsn*, the GGSN itself + * *sgsnemu*, a SGSN emulator *gtplib* This library contains all functionality relating to the GTP @@ -196,10 +169,10 @@ version 1.1. With Linux tun is normally included from kernel version 2.4.7. To configure automatic loading: -1. Add the following line to /etc/modules.conf: alias char-major-10-200 tun -2. depmod -a +1. Add the following line to `/etc/modules.conf`: `alias char-major-10-200 tun` +2. `depmod -a` -Alternatively you can execute "modprobe tun" on the commandline. +Alternatively you can execute `modprobe tun` on the commandline. Gengetopt --------- @@ -209,11 +182,13 @@ you are just going to compile the programs you don't need gengetopt. To use gengetopt for the sgsnemu do the following: +``` cd sgsnemu gengetopt < cmdline.ggo --conf-parser +``` For more information about gengetopt see -http://www.gnu.org/software/gengetopt/gengetopt.html +<http://www.gnu.org/software/gengetopt/gengetopt.html> Compilation and Installation @@ -227,27 +202,21 @@ Use osmo-ggsn -h for a list of available options. All options available on the command line can also be given in a configuration file. See -examples/osmo-ggsn.cfg for the format of this file. +`doc/examples/osmo-ggsn.cfg` for the format of this file. Start osmo-ggsn as root using the command: -osmo-ggsn -c examples/osmo-ggsn.cfg +`osmo-ggsn -c doc/examples/osmo-ggsn.cfg` -First a tun network interface will be created. In the above example -the network interface address is 192.168.0.0 and the mask is -255.255.255.0. You can check that this interface is up by using -ifconfig. +First, a tun network interface will be created for each configured apn. After tun has been successfully established the ggsn will wait for GTP -create PDP context requests on the local interface -10.0.0.40. Currently all requests are accepted, and no password, -username or APN validation is performed. +create PDP context requests on the configured `gtp bind-ip` address. +Currently all requests are accepted, and no password, username validation is performed. -When receiving a create PDP context request a dynamic IP address will -be allocated from the address pool determined by --dynip. In the above -example the first allocated address will be 192.168.0.1, followed by -192.168.0.2 and so on. The request is confirmed by sending a create -PDP context response message to the peer (SGSN). +When receiving a create PDP context request for a given APN, a dynamic IP address will +be allocated from the address pool defined in the config file section for that apn. +The request is confirmed by sending a create PDP context response message to the peer (SGSN). Now IP packets will be forwarded between the tun network interface and the established GTP tunnel. In order to allow users to access the @@ -255,22 +224,22 @@ used you need to configure network address translation. See the Linux Networking HOWTO for details. -Remember to enable routing: +Remember to enable routing: -echo 1 > /proc/sys/net/ipv4/ip_forward +`echo 1 > /proc/sys/net/ipv4/ip_forward` -If you installed using a binary RPM package it is possible to start -osmo-ggsn by using the Sys 5 script: +If you're using systemd and did `make install` or installed from a bianry package, +you can start osmo-ggsn by using the included systemd service/unit file: -/etc/init.d/osmo-ggsn start +`systemctl start osmo-ggsn` Running sgsnemu =============== -Use sgsnemu -h for a list of available options. All options available +Use `sgsnemu -h` for a list of available options. All options available on the command line can also be given in a configuration file. See -examples/sgsnemu.conf for the format of this file. +`doc/examples/sgsnemu.conf` for the format of this file. If you want to test a GRX roaming connection you will need to do the following: @@ -283,11 +252,11 @@ details. 4. Launch sgsnemu with something like: -sgsnemu --listen 10.0.0.50 --remote 10.0.0.40 --dns 10.20.38.51 --timelimit 10 --contexts 0 +`sgsnemu --listen 10.0.0.50 --remote 10.0.0.40 --dns 10.20.38.51 --timelimit 10 --contexts 0` sgsnemu will print something like the following on the screen: - +``` Using DNS server: 10.20.38.51 (10.20.38.51) Local IP address is: 10.0.0.50 (10.0.0.50) Remote IP address is: 10.0.0.40 (10.0.0.40) @@ -303,6 +272,7 @@ Waiting for response from ggsn........ Received echo response. Cause value: 0 +``` This is quite good. It means that you managed to send off an echo request to a remote GGSN, and it was friendly enough to answer you. If @@ -320,10 +290,11 @@ network, so please be carefull not to route internet traffic onto the GPRS core network! Assuming you know what you are doing: -sgsnemu --listen 10.0.0.50 --remote 10.0.0.40 --dns 10.20.38.51 --timelimit 10 --contexts 1 --apn internet --imsi 240011234567890 --msisdn 46702123456 --createif --defaultroute +`sgsnemu --listen 10.0.0.50 --remote 10.0.0.40 --dns 10.20.38.51 --timelimit 10 --contexts 1 --apn internet --imsi 240011234567890 --msisdn 46702123456 --createif --defaultroute` sgsnemu will print something like the following on the screen: +``` Using DNS server: 10.20.38.51 (10.20.38.51) Local IP address is: 10.0.0.50 (10.0.0.50) Remote IP address is: 10.0.0.40 (10.0.0.40) @@ -344,7 +315,7 @@ Setting up interface and routing /sbin/ifconfig tun0 192.168.0.1 /sbin/route add -net 192.168.0.0 netmask 255.255.255.0 gw 192.168.0.1 - +``` Now a context is established to the remote GGSN. The IP address of the context is 192.168.0.1. You should be able to ping a known address on @@ -358,13 +329,13 @@ connecting the same computer to both the Gn and Gi network, so please be carefull not to route internet traffic onto the GPRS core network and please protect yourself against hackers! For this reason it is -advised to always use --contexts 0 when testing a live network. +advised to always use `--contexts 0` when testing a live network. -After --timelimit seconds the PDP context is disconnected with the +After `--timelimit seconds` the PDP context is disconnected with the following messages from sgsnemu: - +``` Disconnecting PDP context #0 Received delete PDP context response. Cause value: 128 Deleting tun interface - +``` -- To view, visit https://gerrit.osmocom.org/c/osmo-ggsn/+/36426?usp=email To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-ggsn Gerrit-Branch: master Gerrit-Change-Id: I6ec92260da0f55e9493a15db2e8178e5436143a0 Gerrit-Change-Number: 36426 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-MessageType: newchange

1 year, 4 months

1
0
0 0

[S] Change in osmo-ggsn[master]: Add funding link to github mirror

by laforge

laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-ggsn/+/36423?usp=email ) Change subject: Add funding link to github mirror ...................................................................... Patch Set 1: Code-Review+2 -- To view, visit https://gerrit.osmocom.org/c/osmo-ggsn/+/36423?usp=email To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-ggsn Gerrit-Branch: master Gerrit-Change-Id: I75ba8c4f8635d5a2d36d5bb97566d737e27bcec9 Gerrit-Change-Number: 36423 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: laforge <laforge(a)osmocom.org> Gerrit-Comment-Date: Sat, 23 Mar 2024 15:17:43 +0000 Gerrit-HasComments: No Gerrit-Has-Labels: Yes Gerrit-MessageType: comment

1 year, 4 months

1
0
0 0

2025

2024

2023

2022

gerrit-log March 2024