pespin has submitted this change. ( https://gerrit.osmocom.org/c/osmo-smlc/+/28375 )
Change subject: Fill README with content; convert to markdown ...................................................................... Fill README with content; convert to markdown Change-Id: I54297aba4dbb4f521caaeb555de9e5404f9e6dcd --- D README A README.md M contrib/osmo-smlc.spec.in 3 files changed, 70 insertions(+), 5 deletions(-) Approvals: Jenkins Builder: Verified pespin: Looks good to me, approved diff --git a/README b/README deleted file mode 100644 index 06fa1ea..0000000 --- a/README +++ /dev/null @@ -1,4 +0,0 @@ -About OsmoSMLC -============== - -FIXME diff --git a/README.md b/README.md new file mode 100644 index 0000000..354e683 --- /dev/null +++ b/README.md @@ -0,0 +1,69 @@ +osmo-smlc - Osmocom Serving Mobile Location Centre +================================================== + +This repository contains a C-language implementation of a minimalistic +GSM Serving Mobile Location Centre (SMLC) for 2G (GSM). It is part of the +[Osmocom](https://osmocom.org/) Open Source Mobile Communications project. + +OsmoSMLC exposes + * 3GPP Lb interface towards the BSC + * The Osmocom typical telnet VTY and CTRL interfaces. + * The Osmocom typical statsd exporter. + +OsmoSMLC supports the following location methods: + * currently only the Timing Advance based method of determining a mobile station; operator must configure the + locations of the cells in the osmo-smlc configuration file + +Homepage +-------- + +You can find the OsmoSMLC issue tracker and wiki online at +<https://osmocom.org/projects/osmo-smlc> and <https://osmocom.org/projects/osmo-smlc/wiki> + + +GIT Repository +-------------- + +You can clone from the official osmo-smlc.git repository using + + git clone https://gitea.osmocom.org/cellular-infrastructure/osmo-smlc + +There is a web interface at <https://gitea.osmocom.org/cellular-infrastructure/osmo-smlc> + + +Documentation +------------- + +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 +[User Manual](https://ftp.osmocom.org/docs/latest/osmosmlc-usermanual.pdf) +as well as the [VTY Reference Manual](https://ftp.osmocom.org/docs/latest/osmosmlc-vty-reference.pdf) + + +Mailing List +------------ + +Discussions related to osmo-smlc are happening on the [email protected] mailing list, please see +<https://lists.osmocom.org/mailman/listinfo/openbsc> for subscription +options and the list archive. + +Please observe the [Osmocom Mailing List +Rules](https://osmocom.org/projects/cellular-infrastructure/wiki/Mailing_List_Rules) +when posting. + +Contributing +------------ + +Our coding standards are described at +<https://osmocom.org/projects/cellular-infrastructure/wiki/Coding_standards> + +We us a gerrit based patch submission/review process for managing +contributions. Please see +<https://osmocom.org/projects/cellular-infrastructure/wiki/Gerrit> for +more details + +The current patch queue for osmo-smlc can be seen at +<https://gerrit.osmocom.org/#/q/project:osmo-smlc+status:open> diff --git a/contrib/osmo-smlc.spec.in b/contrib/osmo-smlc.spec.in index a5852b8..72e2376 100644 --- a/contrib/osmo-smlc.spec.in +++ b/contrib/osmo-smlc.spec.in @@ -77,7 +77,7 @@ %files %license COPYING -%doc AUTHORS README +%doc AUTHORS README.md %{_bindir}/osmo-smlc %dir %{_docdir}/%{name}/examples %dir %{_docdir}/%{name}/examples/osmo-smlc -- To view, visit https://gerrit.osmocom.org/c/osmo-smlc/+/28375 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: osmo-smlc Gerrit-Branch: master Gerrit-Change-Id: I54297aba4dbb4f521caaeb555de9e5404f9e6dcd Gerrit-Change-Number: 28375 Gerrit-PatchSet: 2 Gerrit-Owner: laforge <[email protected]> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: pespin <[email protected]> Gerrit-MessageType: merged
