laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/libosmo-gprs/+/36435?usp=email )
Change subject: Add funding link to github mirror
......................................................................
Patch Set 1: Code-Review+2
--
To view, visit https://gerrit.osmocom.org/c/libosmo-gprs/+/36435?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: libosmo-gprs
Gerrit-Branch: master
Gerrit-Change-Id: I428cd9f4b1b15f5663756ca9e943c289f97ed8d9
Gerrit-Change-Number: 36435
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 17:50:03 +0000
Gerrit-HasComments: No
Gerrit-Has-Labels: Yes
Gerrit-MessageType: comment
laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-e1d/+/36438?usp=email )
Change subject: README.md: Improved markdown formatting; more links
......................................................................
README.md: Improved markdown formatting; more links
Change-Id: I7e4f1c8c527a63f13ef9eaa26a00e1b2efca82ae
---
M README.md
1 file changed, 15 insertions(+), 6 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/osmo-e1d refs/changes/38/36438/1
diff --git a/README.md b/README.md
index ac2893e..4e1ad9b 100644
--- a/README.md
+++ b/README.md
@@ -2,16 +2,15 @@
======================================
This repository contains the osmocom E1 interface daemon,
-a pure userspace driver for the icE1usb hardware USB E1 adapter.
+a pure userspace driver for the [icE1usb](https://osmocom.org/projects/e1-t1-adapter/wiki/IcE1usb)
+hardware USB E1 adapter.
-It is part of the [Osmocom](https://osmocom.org/) Open Source Mobile
-Communications project.
+It is part of the [Osmocom](https://osmocom.org/) Open Source Mobile Communications project.
Homepage
--------
-The official homepage of the project is
-<https://osmocom.org/projects/osmo-e1d/wiki>
+The official homepage of the project is <https://osmocom.org/projects/osmo-e1d/wiki>
GIT Repository
--------------
@@ -26,6 +25,7 @@
-------------
* [icE1usb USB E1 adapter](https://osmocom.org/projects/e1-t1-adapter/wiki/IcE1usb)
+ * pre-assembled hardware available from the [sysmocom webshop](https://shop.sysmocom.de/Osmocom-icE1usb-E1-interface-for-USB/icE1usb-kit)
* [alternative DAHDI driver](https://osmocom.org/issues/4923)
Mailing List
@@ -33,7 +33,7 @@
Discussions related to osmo-e1d are happening on the
openbsc(a)lists.osmocom.org mailing list, please see
-https://lists.osmocom.org/mailman/listinfo/openbsc for subscription
+<https://lists.osmocom.org/mailman/listinfo/openbsc> for subscription
options and the list archive.
Please observe the [Osmocom Mailing List
--
To view, visit https://gerrit.osmocom.org/c/osmo-e1d/+/36438?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-e1d
Gerrit-Branch: master
Gerrit-Change-Id: I7e4f1c8c527a63f13ef9eaa26a00e1b2efca82ae
Gerrit-Change-Number: 36438
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: newchange
laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/libosmo-gprs/+/36436?usp=email )
Change subject: README.md: Improve formatting
......................................................................
README.md: Improve formatting
Change-Id: Ide52989e241a1546e7ac2a46aa6c34e5e536e088
---
M README.md
1 file changed, 19 insertions(+), 11 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/libosmo-gprs refs/changes/36/36436/1
diff --git a/README.md b/README.md
index b88c581..5fa93ce 100644
--- a/README.md
+++ b/README.md
@@ -4,18 +4,17 @@
This project is a home for several libraries providing common GPRS routines:
-* libosmo-csn1 - CSN.1 (Concrete Syntax Notation 1) codec;
-* libosmo-gprs-rlcmac - RLC/MAC as per 3GPP TS 44.060, TS 44.018;
-* libosmo-gprs-llc - LLC (Logical Link Control) as per 3GPP TS 44.064;
-* libosmo-gprs-gmm - GMM (GPRS Mobility Management) as per 3GPP TS 24.008 section 9.4;
-* libosmo-gprs-sm - SM (GPRS Session Management) as per 3GPP TS 24.008 section 9.5;
-* libosmo-gprs-sndcp - SNDCP (Subnetwork Dependent Convergence Protocol) as per 3GPP TS 44.065.
+* *libosmo-csn1* - CSN.1 (Concrete Syntax Notation 1) codec;
+* *libosmo-gprs-rlcmac* - RLC/MAC as per 3GPP TS 44.060, TS 44.018;
+* *libosmo-gprs-llc* - LLC (Logical Link Control) as per 3GPP TS 44.064;
+* *libosmo-gprs-gmm* - GMM (GPRS Mobility Management) as per 3GPP TS 24.008 section 9.4;
+* *libosmo-gprs-sm* - SM (GPRS Session Management) as per 3GPP TS 24.008 section 9.5;
+* *libosmo-gprs-sndcp* - SNDCP (Subnetwork Dependent Convergence Protocol) as per 3GPP TS 44.065.
Homepage
--------
-The official homepage of the project is
-https://osmocom.org/projects/libosmo-gprs
+The official homepage of the project is <https://osmocom.org/projects/libosmo-gprs>.
GIT Repository
--------------
@@ -42,10 +41,10 @@
------------
Our coding standards are described at
-https://osmocom.org/projects/cellular-infrastructure/wiki/Coding_standards
+<https://osmocom.org/projects/cellular-infrastructure/wiki/Coding_standards>
Submit patches at https://gerrit.osmocom.org/
-See also https://osmocom.org/projects/cellular-infrastructure/wiki/Gerrit
+See also <https://osmocom.org/projects/cellular-infrastructure/wiki/Gerrit>
The current patch queue for libosmo-gprs can be seen at
-https://gerrit.osmocom.org/#/q/project:libosmo-gprs+status:open
+<https://gerrit.osmocom.org/#/q/project:libosmo-gprs+status:open>
--
To view, visit https://gerrit.osmocom.org/c/libosmo-gprs/+/36436?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: libosmo-gprs
Gerrit-Branch: master
Gerrit-Change-Id: Ide52989e241a1546e7ac2a46aa6c34e5e536e088
Gerrit-Change-Number: 36436
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: newchange
laforge has submitted this change. ( https://gerrit.osmocom.org/c/osmo-sgsn/+/36433?usp=email )
Change subject: README.md: Overhaul (more links; improved formatting)
......................................................................
README.md: Overhaul (more links; improved formatting)
Change-Id: I0cf9898877aab2f834c886491f4d203d55a8b4b9
---
M README.md
1 file changed, 23 insertions(+), 12 deletions(-)
Approvals:
laforge: Looks good to me, approved
Jenkins Builder: Verified
diff --git a/README.md b/README.md
index 607b05d..37362b8 100644
--- a/README.md
+++ b/README.md
@@ -1,28 +1,30 @@
-osmo-sgssn - Osmocom SGSN Implementation
-========================================
+osmo-sgsn - Osmocom SGSN Implementation
+=======================================
-This repository contains a C-language implementation of a GSM Serving GPRS
-Support Node (SGSN) for 2G (GSM) and 3G (UMTS). It is part of the
+This repository contains a C-language implementation of a *Serving GPRS
+Support Node (SGSN)* for 2.5/2.75G (GPRS/EDGE) and 3G (UMTS). It is part of the
[Osmocom](https://osmocom.org/) Open Source Mobile Communications
project.
OsmoSGSN exposes
- * Gb towards PCUs (e.g. OsmoPCU): Various GbIP flavors + Gb/FR/E1
- * GTP towards a GGSN (e.g. OsmoGGSN);
- * IuPS over IP towards RNCs / HNBGW (e.g. osmo-hnbgw)
- * The Osmocom typical telnet VTY and CTRL interfaces.
- * The Osmocom typical statsd exporter.
- * GSUP (custom MAP-like protocol) towards osmo-hlr
+
+ * *Gb* towards PCUs (e.g. [OsmoPCU](https://osmocom.org/projects/osmopcu/wiki/OsmoPCU)): Various GbIP flavors + Gb/FR/E1
+ * *GTP* towards a GGSN (e.g. [OsmoGGSN](https://osmocom.org/projects/openggsn/wiki))
+ * IuPS over IP towards RNCs / HNBGW (e.g. [osmo-hnbgw](https://osmocom.org/projects/osmohnbgw/wiki))
+ * The Osmocom typical telnet *VTY* and *CTRL* interfaces.
+ * The Osmocom typical *statsd* exporter.
+ * GSUP (custom MAP-like protocol) towards [osmo-hlr](https://osmocom.org/projects/osmo-hlr/wiki/OsmoHLR)
OsmoSGSN implements
+
* GPRS mobility management
* GPRS session management
+
Homepage
--------
-You can find the OsmoSGSN issue tracker and wiki online at
-<https://osmocom.org/projects/osmosgsn> and <https://osmocom.org/projects/osmosgsn/wiki>.
+You can find the OsmoSGSN homepage online at <https://osmocom.org/projects/osmosgsn/wiki>.
GIT Repository
--
To view, visit https://gerrit.osmocom.org/c/osmo-sgsn/+/36433?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-sgsn
Gerrit-Branch: master
Gerrit-Change-Id: I0cf9898877aab2f834c886491f4d203d55a8b4b9
Gerrit-Change-Number: 36433
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: merged
laforge has submitted this change. ( https://gerrit.osmocom.org/c/osmo-sgsn/+/36434?usp=email )
Change subject: README.md: Add Forum and Issue Tracker sections
......................................................................
README.md: Add Forum and Issue Tracker sections
Change-Id: I69dfe4124c2a2be30c9ef04e70e3f15d10a2305c
---
M README.md
1 file changed, 26 insertions(+), 0 deletions(-)
Approvals:
Jenkins Builder: Verified
laforge: Looks good to me, approved
diff --git a/README.md b/README.md
index 37362b8..3143d04 100644
--- a/README.md
+++ b/README.md
@@ -48,6 +48,14 @@
as well as the [VTY Reference Manual](https://ftp.osmocom.org/docs/latest/osmosgsn-vty-reference.pdf)
+Forum
+-----
+
+We welcome any osmo-sgsn related discussions in the
+[Cellular Network Infratructure -> 2G/3G Core Network](https://discourse.osmocom.org/c/cni/2g-3g-cn).
+section of the osmocom discourse (web based Forum).
+
+
Mailing List
------------
@@ -60,6 +68,15 @@
Rules](https://osmocom.org/projects/cellular-infrastructure/wiki/Mailing_Li…
when posting.
+
+Issue Tracker
+-------------
+
+We use the [issue tracker of the osmo-sgsn project on osmocom.org](https://osmocom.org/projects/osmosgsn/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-sgsn/+/36434?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-sgsn
Gerrit-Branch: master
Gerrit-Change-Id: I69dfe4124c2a2be30c9ef04e70e3f15d10a2305c
Gerrit-Change-Number: 36434
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: merged
laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-sgsn/+/36432?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-sgsn/+/36432?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-sgsn
Gerrit-Branch: master
Gerrit-Change-Id: Icf0fd068742eba60c23f0e567e6e72b42063f2c0
Gerrit-Change-Number: 36432
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-CC: Jenkins Builder
Gerrit-Comment-Date: Sat, 23 Mar 2024 16:16:00 +0000
Gerrit-HasComments: No
Gerrit-Has-Labels: Yes
Gerrit-MessageType: comment
laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-sgsn/+/36433?usp=email )
Change subject: README.md: Overhaul (more links; improved formatting)
......................................................................
README.md: Overhaul (more links; improved formatting)
Change-Id: I0cf9898877aab2f834c886491f4d203d55a8b4b9
---
M README.md
1 file changed, 23 insertions(+), 12 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/osmo-sgsn refs/changes/33/36433/1
diff --git a/README.md b/README.md
index 607b05d..37362b8 100644
--- a/README.md
+++ b/README.md
@@ -1,28 +1,30 @@
-osmo-sgssn - Osmocom SGSN Implementation
-========================================
+osmo-sgsn - Osmocom SGSN Implementation
+=======================================
-This repository contains a C-language implementation of a GSM Serving GPRS
-Support Node (SGSN) for 2G (GSM) and 3G (UMTS). It is part of the
+This repository contains a C-language implementation of a *Serving GPRS
+Support Node (SGSN)* for 2.5/2.75G (GPRS/EDGE) and 3G (UMTS). It is part of the
[Osmocom](https://osmocom.org/) Open Source Mobile Communications
project.
OsmoSGSN exposes
- * Gb towards PCUs (e.g. OsmoPCU): Various GbIP flavors + Gb/FR/E1
- * GTP towards a GGSN (e.g. OsmoGGSN);
- * IuPS over IP towards RNCs / HNBGW (e.g. osmo-hnbgw)
- * The Osmocom typical telnet VTY and CTRL interfaces.
- * The Osmocom typical statsd exporter.
- * GSUP (custom MAP-like protocol) towards osmo-hlr
+
+ * *Gb* towards PCUs (e.g. [OsmoPCU](https://osmocom.org/projects/osmopcu/wiki/OsmoPCU)): Various GbIP flavors + Gb/FR/E1
+ * *GTP* towards a GGSN (e.g. [OsmoGGSN](https://osmocom.org/projects/openggsn/wiki))
+ * IuPS over IP towards RNCs / HNBGW (e.g. [osmo-hnbgw](https://osmocom.org/projects/osmohnbgw/wiki))
+ * The Osmocom typical telnet *VTY* and *CTRL* interfaces.
+ * The Osmocom typical *statsd* exporter.
+ * GSUP (custom MAP-like protocol) towards [osmo-hlr](https://osmocom.org/projects/osmo-hlr/wiki/OsmoHLR)
OsmoSGSN implements
+
* GPRS mobility management
* GPRS session management
+
Homepage
--------
-You can find the OsmoSGSN issue tracker and wiki online at
-<https://osmocom.org/projects/osmosgsn> and <https://osmocom.org/projects/osmosgsn/wiki>.
+You can find the OsmoSGSN homepage online at <https://osmocom.org/projects/osmosgsn/wiki>.
GIT Repository
--
To view, visit https://gerrit.osmocom.org/c/osmo-sgsn/+/36433?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-sgsn
Gerrit-Branch: master
Gerrit-Change-Id: I0cf9898877aab2f834c886491f4d203d55a8b4b9
Gerrit-Change-Number: 36433
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: newchange
laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-sgsn/+/36434?usp=email )
Change subject: README.md: Add Forum and Issue Tracker sections
......................................................................
README.md: Add Forum and Issue Tracker sections
Change-Id: I69dfe4124c2a2be30c9ef04e70e3f15d10a2305c
---
M README.md
1 file changed, 26 insertions(+), 0 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/osmo-sgsn refs/changes/34/36434/1
diff --git a/README.md b/README.md
index 37362b8..3143d04 100644
--- a/README.md
+++ b/README.md
@@ -48,6 +48,14 @@
as well as the [VTY Reference Manual](https://ftp.osmocom.org/docs/latest/osmosgsn-vty-reference.pdf)
+Forum
+-----
+
+We welcome any osmo-sgsn related discussions in the
+[Cellular Network Infratructure -> 2G/3G Core Network](https://discourse.osmocom.org/c/cni/2g-3g-cn).
+section of the osmocom discourse (web based Forum).
+
+
Mailing List
------------
@@ -60,6 +68,15 @@
Rules](https://osmocom.org/projects/cellular-infrastructure/wiki/Mailing_Li…
when posting.
+
+Issue Tracker
+-------------
+
+We use the [issue tracker of the osmo-sgsn project on osmocom.org](https://osmocom.org/projects/osmosgsn/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-sgsn/+/36434?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-sgsn
Gerrit-Branch: master
Gerrit-Change-Id: I69dfe4124c2a2be30c9ef04e70e3f15d10a2305c
Gerrit-Change-Number: 36434
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: newchange
laforge has submitted this change. ( https://gerrit.osmocom.org/c/osmo-ttcn3-hacks/+/36430?usp=email )
Change subject: Add README.md file (to show up in gitea / github / etc.)
......................................................................
Add README.md file (to show up in gitea / github / etc.)
Change-Id: Ic176636930e9a36cc428360147140a7339aa58b5
---
A README.md
1 file changed, 39 insertions(+), 0 deletions(-)
Approvals:
Jenkins Builder: Verified
laforge: Looks good to me, approved
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..907ebb1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+Osmocom TTCN-3 Test Suites
+==========================
+
+This repository contains a collection of test suites developed within
+the [Osmocom](https://osmocom.org/) (Open Source Mobile Communications)
+project. The test suites are developed in the
+[TTCN-3](https://de.wikipedia.org/wiki/TTCN-3) programming language,
+compiled/executed by the [Eclipse TITAN](https://projects.eclipse.org/projects/tools.titan)
+compiler and runtime.
+
+Those test suites mostly are performing *functional testing* of cellular
+network elements, from 2G, 3G, 4G to 5G. The individual test-suites are
+in sub-directories, while some shared library code is in *library*.
+
+
+Continuous Integration
+----------------------
+
+The individual tests suites are executed against different versions of
+the respective IUT (Implementation Under Test) by the Osmocom jenkins.
+
+See the [list of all TTCN-3 jenkins jobs](https://jenkins.osmocom.org/jenkins/view/TTCN3/)
+for more details
+
+
+Further reading
+--------------
+
+Some more information about those test suites can be found
+at <https://osmocom.org/projects/cellular-infrastructure/wiki/Titan_TTCN3_Tests…>.
--
To view, visit https://gerrit.osmocom.org/c/osmo-ttcn3-hacks/+/36430?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-ttcn3-hacks
Gerrit-Branch: master
Gerrit-Change-Id: Ic176636930e9a36cc428360147140a7339aa58b5
Gerrit-Change-Number: 36430
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: merged
laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-ttcn3-hacks/+/36431?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-ttcn3-hacks/+/36431?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-ttcn3-hacks
Gerrit-Branch: master
Gerrit-Change-Id: I2ceef868ae52c52329413a7caeaa3ca00a40b983
Gerrit-Change-Number: 36431
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 16:00:56 +0000
Gerrit-HasComments: No
Gerrit-Has-Labels: Yes
Gerrit-MessageType: comment
laforge has submitted this change. ( https://gerrit.osmocom.org/c/osmo-bsc/+/36429?usp=email )
Change subject: README.md Add Forum + Issue Tracker sections
......................................................................
README.md Add Forum + Issue Tracker sections
Change-Id: I0e9fc221fdf78ad94de7713b62473680ee7d58c2
---
M README.md
1 file changed, 26 insertions(+), 0 deletions(-)
Approvals:
laforge: Looks good to me, approved
Jenkins Builder: Verified
diff --git a/README.md b/README.md
index 79907e7..bf9526c 100644
--- a/README.md
+++ b/README.md
@@ -50,6 +50,14 @@
describing the level of CBSP conformance.
+Forum
+-----
+
+We welcome any osmo-bsc related discussions in the
+[Cellular Network Infrastructure -> 2G/3G RAN (GERAN)](https://discourse.osmocom.org/c/cni/geran)
+section of the osmocom discourse (web based Forum).
+
+
Mailing List
------------
@@ -62,6 +70,15 @@
Rules](https://osmocom.org/projects/cellular-infrastructure/wiki/Mailing_Li…
when posting.
+
+Issue Tracker
+-------------
+
+We use the [issue tracker of the osmo-bsc project on osmocom.org](https://osmocom.org/projects/osmobsc/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-bsc/+/36429?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: I0e9fc221fdf78ad94de7713b62473680ee7d58c2
Gerrit-Change-Number: 36429
Gerrit-PatchSet: 2
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: merged
laforge has submitted this change. ( https://gerrit.osmocom.org/c/osmo-bsc/+/36428?usp=email )
Change subject: README.md: Overhaul (more links, fix markdown formatting)
......................................................................
README.md: Overhaul (more links, fix markdown formatting)
Change-Id: Id1e320439c052797cb9c6cda51b65cd2b9e9a3c4
---
M README.md
1 file changed, 19 insertions(+), 12 deletions(-)
Approvals:
Jenkins Builder: Verified
laforge: Looks good to me, approved
diff --git a/README.md b/README.md
index 5eed2f2..79907e7 100644
--- a/README.md
+++ b/README.md
@@ -2,24 +2,25 @@
=====================================
This repository contains a C-language implementation of a GSM Base Station
-Controller (BSC). IT is part of the
+Controller (BSC). It is part of the
[Osmocom](https://osmocom.org/) Open Source Mobile Communications
project.
OsmoBSC exposes
- * A over IP towards an MSC (e.g. OsmoMSC): 3GPP AoIP or SCCPlite
- * Abis interfaces towards various kinds of BTS (osmo-bts, sysmobts, nanoBTS, Siemens, Nokia, Ericsson)
- * The Osmocom typical telnet VTY and CTRL interfaces.
- * The Osmocom typical statsd exporter.
- * Cell Broadcast Service Protocol (CBSP) towards a CBC (Cell Broadcast Centre, such as osmo-cbc).
- * Lb interface towards a SMLC (Serving Mobile Location Centre, such as osmo-smlc).
+
+ * *A over IP* towards an MSC (e.g. [osmo-msc](https://osmocom.org/projects/osmomsc/wiki)): 3GPP AoIP or SCCPlite
+ * *Abis* interfaces towards various kinds of BTS (e.g. [osmo-bts](https://osmocom.org/projects/osmobts/wiki/Wiki), sysmobts, nanoBTS, Siemens, Nokia, Ericsson)
+ * The Osmocom typical telnet *VTY* and *CTRL* interfaces.
+ * The Osmocom typical *statsd* exporter.
+ * Cell Broadcast Service Protocol (*CBSP*) towards a CBC (Cell Broadcast Centre, such as [osmo-cbc](https://osmocom.org/projects/osmo-cbc/wiki)).
+ * Lb interface towards a *SMLC* (Serving Mobile Location Centre, such as [osmo-smlc](https://osmocom.org/projects/osmo-smlc/wiki/OsmoSMLC)).
Homepage
--------
-You can find the OsmoBSC issue tracker and wiki online at
-<https://osmocom.org/projects/osmobsc> and <https://osmocom.org/projects/osmobsc/wiki>.
+You can find the OsmoBSC homepage with issue tracker and wiki online at
+<https://osmocom.org/projects/osmobsc/wiki>.
GIT Repository
@@ -90,6 +91,3 @@
libmsc, i.e. the old OsmoNITB. Since the standalone OsmoMSC with a true A
interface (and IuCS for 3G support) is available, OsmoBSC exists only as a
separate standalone entity.
-
-OsmoBSC-NAT is a specialized solution to navigating RTP streams through a NAT.
-(Todo: describe in more detail)
--
To view, visit https://gerrit.osmocom.org/c/osmo-bsc/+/36428?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: Id1e320439c052797cb9c6cda51b65cd2b9e9a3c4
Gerrit-Change-Number: 36428
Gerrit-PatchSet: 2
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: merged
laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-ttcn3-hacks/+/36430?usp=email )
Change subject: Add README.md file (to show up in gitea / github / etc.)
......................................................................
Add README.md file (to show up in gitea / github / etc.)
Change-Id: Ic176636930e9a36cc428360147140a7339aa58b5
---
A README.md
1 file changed, 39 insertions(+), 0 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/osmo-ttcn3-hacks refs/changes/30/36430/1
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..907ebb1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+Osmocom TTCN-3 Test Suites
+==========================
+
+This repository contains a collection of test suites developed within
+the [Osmocom](https://osmocom.org/) (Open Source Mobile Communications)
+project. The test suites are developed in the
+[TTCN-3](https://de.wikipedia.org/wiki/TTCN-3) programming language,
+compiled/executed by the [Eclipse TITAN](https://projects.eclipse.org/projects/tools.titan)
+compiler and runtime.
+
+Those test suites mostly are performing *functional testing* of cellular
+network elements, from 2G, 3G, 4G to 5G. The individual test-suites are
+in sub-directories, while some shared library code is in *library*.
+
+
+Continuous Integration
+----------------------
+
+The individual tests suites are executed against different versions of
+the respective IUT (Implementation Under Test) by the Osmocom jenkins.
+
+See the [list of all TTCN-3 jenkins jobs](https://jenkins.osmocom.org/jenkins/view/TTCN3/)
+for more details
+
+
+Further reading
+--------------
+
+Some more information about those test suites can be found
+at <https://osmocom.org/projects/cellular-infrastructure/wiki/Titan_TTCN3_Tests…>.
--
To view, visit https://gerrit.osmocom.org/c/osmo-ttcn3-hacks/+/36430?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-ttcn3-hacks
Gerrit-Branch: master
Gerrit-Change-Id: Ic176636930e9a36cc428360147140a7339aa58b5
Gerrit-Change-Number: 36430
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: newchange
laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-bsc/+/36427?usp=email )
Change subject: Add funding link to github mirror
......................................................................
Patch Set 2: Code-Review+2
--
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: 2
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-CC: Jenkins Builder
Gerrit-Comment-Date: Sat, 23 Mar 2024 15:48:24 +0000
Gerrit-HasComments: No
Gerrit-Has-Labels: Yes
Gerrit-MessageType: comment
laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-bsc/+/36429?usp=email )
Change subject: README.md Add Forum + Issue Tracker sections
......................................................................
README.md Add Forum + Issue Tracker sections
Change-Id: I0e9fc221fdf78ad94de7713b62473680ee7d58c2
---
M README.md
1 file changed, 26 insertions(+), 0 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/osmo-bsc refs/changes/29/36429/1
diff --git a/README.md b/README.md
index 79907e7..bf9526c 100644
--- a/README.md
+++ b/README.md
@@ -50,6 +50,14 @@
describing the level of CBSP conformance.
+Forum
+-----
+
+We welcome any osmo-bsc related discussions in the
+[Cellular Network Infrastructure -> 2G/3G RAN (GERAN)](https://discourse.osmocom.org/c/cni/geran)
+section of the osmocom discourse (web based Forum).
+
+
Mailing List
------------
@@ -62,6 +70,15 @@
Rules](https://osmocom.org/projects/cellular-infrastructure/wiki/Mailing_Li…
when posting.
+
+Issue Tracker
+-------------
+
+We use the [issue tracker of the osmo-bsc project on osmocom.org](https://osmocom.org/projects/osmobsc/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-bsc/+/36429?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: I0e9fc221fdf78ad94de7713b62473680ee7d58c2
Gerrit-Change-Number: 36429
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: newchange
laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-bsc/+/36428?usp=email )
Change subject: README.md: Overhaul (more links, fix markdown formatting)
......................................................................
README.md: Overhaul (more links, fix markdown formatting)
Change-Id: Id1e320439c052797cb9c6cda51b65cd2b9e9a3c4
---
M README.md
1 file changed, 19 insertions(+), 12 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/osmo-bsc refs/changes/28/36428/1
diff --git a/README.md b/README.md
index 5eed2f2..79907e7 100644
--- a/README.md
+++ b/README.md
@@ -2,24 +2,25 @@
=====================================
This repository contains a C-language implementation of a GSM Base Station
-Controller (BSC). IT is part of the
+Controller (BSC). It is part of the
[Osmocom](https://osmocom.org/) Open Source Mobile Communications
project.
OsmoBSC exposes
- * A over IP towards an MSC (e.g. OsmoMSC): 3GPP AoIP or SCCPlite
- * Abis interfaces towards various kinds of BTS (osmo-bts, sysmobts, nanoBTS, Siemens, Nokia, Ericsson)
- * The Osmocom typical telnet VTY and CTRL interfaces.
- * The Osmocom typical statsd exporter.
- * Cell Broadcast Service Protocol (CBSP) towards a CBC (Cell Broadcast Centre, such as osmo-cbc).
- * Lb interface towards a SMLC (Serving Mobile Location Centre, such as osmo-smlc).
+
+ * *A over IP* towards an MSC (e.g. [osmo-msc](https://osmocom.org/projects/osmomsc/wiki)): 3GPP AoIP or SCCPlite
+ * *Abis* interfaces towards various kinds of BTS (e.g. [osmo-bts](https://osmocom.org/projects/osmobts/wiki/Wiki), sysmobts, nanoBTS, Siemens, Nokia, Ericsson)
+ * The Osmocom typical telnet *VTY* and *CTRL* interfaces.
+ * The Osmocom typical *statsd* exporter.
+ * Cell Broadcast Service Protocol (*CBSP*) towards a CBC (Cell Broadcast Centre, such as [osmo-cbc](https://osmocom.org/projects/osmo-cbc/wiki)).
+ * Lb interface towards a *SMLC* (Serving Mobile Location Centre, such as [osmo-smlc](https://osmocom.org/projects/osmo-smlc/wiki/OsmoSMLC)).
Homepage
--------
-You can find the OsmoBSC issue tracker and wiki online at
-<https://osmocom.org/projects/osmobsc> and <https://osmocom.org/projects/osmobsc/wiki>.
+You can find the OsmoBSC homepage with issue tracker and wiki online at
+<https://osmocom.org/projects/osmobsc/wiki>.
GIT Repository
@@ -90,6 +91,3 @@
libmsc, i.e. the old OsmoNITB. Since the standalone OsmoMSC with a true A
interface (and IuCS for 3G support) is available, OsmoBSC exists only as a
separate standalone entity.
-
-OsmoBSC-NAT is a specialized solution to navigating RTP streams through a NAT.
-(Todo: describe in more detail)
--
To view, visit https://gerrit.osmocom.org/c/osmo-bsc/+/36428?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: Id1e320439c052797cb9c6cda51b65cd2b9e9a3c4
Gerrit-Change-Number: 36428
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: newchange
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
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
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
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
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
laforge has uploaded this change for review. ( 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(-)
git pull ssh://gerrit.osmocom.org:29418/osmo-ggsn refs/changes/24/36424/1
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-MessageType: newchange
laforge has submitted this change. ( https://gerrit.osmocom.org/c/libosmo-sccp/+/36422?usp=email )
Change subject: README.md: Add links to forum and issue tracker
......................................................................
README.md: Add links to forum and issue tracker
Change-Id: If5b028d5de19fb456ec91a7f94612131ee42c47c
---
M README.md
1 file changed, 25 insertions(+), 0 deletions(-)
Approvals:
Jenkins Builder: Verified
laforge: Looks good to me, approved
diff --git a/README.md b/README.md
index f1970d8..ffc666b 100644
--- a/README.md
+++ b/README.md
@@ -37,6 +37,13 @@
as well as the VTY reference manuals
* [VTY Reference Manual for osmo-stp](https://ftp.osmocom.org/docs/latest/osmostp-vty-reference.pdf)
+Forum
+-----
+
+We welcome any libosmo-sigtran + osmo-stp 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
------------
@@ -49,6 +56,15 @@
Rules](https://osmocom.org/projects/cellular-infrastructure/wiki/Mailing_Li…
when posting.
+Issue Tracker
+-------------
+
+We use the issue trackers of smocom.org 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.
+
+* [osmo-stp issue tracker](https://osmocom.org/projects/osmo-stp/issues)
+* [libosmo-sigtran issue tracker](https://osmocom.org/projects/libosmo-sccp/issues)
+
Contributing
------------
--
To view, visit https://gerrit.osmocom.org/c/libosmo-sccp/+/36422?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: libosmo-sccp
Gerrit-Branch: master
Gerrit-Change-Id: If5b028d5de19fb456ec91a7f94612131ee42c47c
Gerrit-Change-Number: 36422
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: merged
laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/libosmo-sccp/+/36422?usp=email )
Change subject: README.md: Add links to forum and issue tracker
......................................................................
Patch Set 1: Code-Review+2
--
To view, visit https://gerrit.osmocom.org/c/libosmo-sccp/+/36422?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: libosmo-sccp
Gerrit-Branch: master
Gerrit-Change-Id: If5b028d5de19fb456ec91a7f94612131ee42c47c
Gerrit-Change-Number: 36422
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 12:30:46 +0000
Gerrit-HasComments: No
Gerrit-Has-Labels: Yes
Gerrit-MessageType: comment
laforge has submitted this change. ( https://gerrit.osmocom.org/c/libosmo-sccp/+/36421?usp=email )
Change subject: README.md: Update; improve markdown syntax
......................................................................
README.md: Update; improve markdown syntax
Change-Id: Ifb24635f9debc873bb3416226c43984104be270c
---
M README.md
1 file changed, 24 insertions(+), 16 deletions(-)
Approvals:
laforge: Looks good to me, approved
Jenkins Builder: Verified
diff --git a/README.md b/README.md
index 2ec30c8..f1970d8 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,21 @@
libosmo-sccp - Osmocom SCCP, SIGTRAN and STP
============================================
-This repository contains a C-language library implementation of a
-variety of telecom signaling protocols, such as M3UA, SUA, SCCP
-(connection oriented and connectionless), as well as the OsmoSTP, a SS7
-Transfer Point.
+This repository contains
+
+* *libosmo-sigtran*, a C-language library implementation of a variety of telecom signaling protocols, such as M3UA, SUA, SCCP
+ (connection oriented and connectionless)
+* *OsmoSTP*, a SS7 Transfer Point that can be used to act as router and translator between M3UA, SUA and/or
+ SCCPlite
+* *libosmo-sccp*, a legacy C-language [static] library that we used in prehistoric osmocom code before we had
+ libosmo-sigtran.
Homepage
--------
-The official homepage of libosmo-sccp is
- https://osmocom.org/projects/libosmo-sccp/wiki
+The official homepage of libosmo-sccp is at <https://osmocom.org/projects/libosmo-sccp/wiki>
-The official homepage of osmo-stp is
- https://osmocom.org/projects/osmo-stp/wiki
+The official homepage of osmo-stp is at <https://osmocom.org/projects/osmo-stp/wiki>
GIT Repository
--------------
@@ -27,7 +29,7 @@
Documentation
-------------
-User Manuals and VTY reference manuals are [optionally] built in PDF form
+osmo-stp User Manuals and VTY reference manuals are [optionally] built in PDF form
as part of the build process.
Pre-rendered PDF version of the current "master" can be found at
@@ -51,12 +53,9 @@
------------
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
-more details
+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 can be seen at
-https://gerrit.osmocom.org/#/q/project:libosmo-sccp+status:open
+The current patch queue can be seen at <https://gerrit.osmocom.org/#/q/project:libosmo-sccp+status:open>
--
To view, visit https://gerrit.osmocom.org/c/libosmo-sccp/+/36421?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: libosmo-sccp
Gerrit-Branch: master
Gerrit-Change-Id: Ifb24635f9debc873bb3416226c43984104be270c
Gerrit-Change-Number: 36421
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: merged
laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/libosmo-sccp/+/36420?usp=email )
Change subject: Add funding link to github mirror
......................................................................
Patch Set 1: Code-Review+2
--
To view, visit https://gerrit.osmocom.org/c/libosmo-sccp/+/36420?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: libosmo-sccp
Gerrit-Branch: master
Gerrit-Change-Id: I9c3300966e5511ad5650a5128a3e6d5dd6b98605
Gerrit-Change-Number: 36420
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 12:29:15 +0000
Gerrit-HasComments: No
Gerrit-Has-Labels: Yes
Gerrit-MessageType: comment
laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/libosmo-sccp/+/36421?usp=email )
Change subject: README.md: Update; improve markdown syntax
......................................................................
README.md: Update; improve markdown syntax
Change-Id: Ifb24635f9debc873bb3416226c43984104be270c
---
M README.md
1 file changed, 24 insertions(+), 16 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/libosmo-sccp refs/changes/21/36421/1
diff --git a/README.md b/README.md
index 2ec30c8..f1970d8 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,21 @@
libosmo-sccp - Osmocom SCCP, SIGTRAN and STP
============================================
-This repository contains a C-language library implementation of a
-variety of telecom signaling protocols, such as M3UA, SUA, SCCP
-(connection oriented and connectionless), as well as the OsmoSTP, a SS7
-Transfer Point.
+This repository contains
+
+* *libosmo-sigtran*, a C-language library implementation of a variety of telecom signaling protocols, such as M3UA, SUA, SCCP
+ (connection oriented and connectionless)
+* *OsmoSTP*, a SS7 Transfer Point that can be used to act as router and translator between M3UA, SUA and/or
+ SCCPlite
+* *libosmo-sccp*, a legacy C-language [static] library that we used in prehistoric osmocom code before we had
+ libosmo-sigtran.
Homepage
--------
-The official homepage of libosmo-sccp is
- https://osmocom.org/projects/libosmo-sccp/wiki
+The official homepage of libosmo-sccp is at <https://osmocom.org/projects/libosmo-sccp/wiki>
-The official homepage of osmo-stp is
- https://osmocom.org/projects/osmo-stp/wiki
+The official homepage of osmo-stp is at <https://osmocom.org/projects/osmo-stp/wiki>
GIT Repository
--------------
@@ -27,7 +29,7 @@
Documentation
-------------
-User Manuals and VTY reference manuals are [optionally] built in PDF form
+osmo-stp User Manuals and VTY reference manuals are [optionally] built in PDF form
as part of the build process.
Pre-rendered PDF version of the current "master" can be found at
@@ -51,12 +53,9 @@
------------
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
-more details
+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 can be seen at
-https://gerrit.osmocom.org/#/q/project:libosmo-sccp+status:open
+The current patch queue can be seen at <https://gerrit.osmocom.org/#/q/project:libosmo-sccp+status:open>
--
To view, visit https://gerrit.osmocom.org/c/libosmo-sccp/+/36421?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: libosmo-sccp
Gerrit-Branch: master
Gerrit-Change-Id: Ifb24635f9debc873bb3416226c43984104be270c
Gerrit-Change-Number: 36421
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: newchange
laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/libosmo-sccp/+/36422?usp=email )
Change subject: README.md: Add links to forum and issue tracker
......................................................................
README.md: Add links to forum and issue tracker
Change-Id: If5b028d5de19fb456ec91a7f94612131ee42c47c
---
M README.md
1 file changed, 25 insertions(+), 0 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/libosmo-sccp refs/changes/22/36422/1
diff --git a/README.md b/README.md
index f1970d8..ffc666b 100644
--- a/README.md
+++ b/README.md
@@ -37,6 +37,13 @@
as well as the VTY reference manuals
* [VTY Reference Manual for osmo-stp](https://ftp.osmocom.org/docs/latest/osmostp-vty-reference.pdf)
+Forum
+-----
+
+We welcome any libosmo-sigtran + osmo-stp 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
------------
@@ -49,6 +56,15 @@
Rules](https://osmocom.org/projects/cellular-infrastructure/wiki/Mailing_Li…
when posting.
+Issue Tracker
+-------------
+
+We use the issue trackers of smocom.org 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.
+
+* [osmo-stp issue tracker](https://osmocom.org/projects/osmo-stp/issues)
+* [libosmo-sigtran issue tracker](https://osmocom.org/projects/libosmo-sccp/issues)
+
Contributing
------------
--
To view, visit https://gerrit.osmocom.org/c/libosmo-sccp/+/36422?usp=email
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: libosmo-sccp
Gerrit-Branch: master
Gerrit-Change-Id: If5b028d5de19fb456ec91a7f94612131ee42c47c
Gerrit-Change-Number: 36422
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: newchange