laforge has submitted this change. ( 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(-)
Approvals:
Jenkins Builder: Verified
laforge: Looks good to me, approved
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-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-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