@@ -1,202 +0,0 @@

-#

-# spec file for package osmo-hlr

-#

-# Copyright (c) 2017 SUSE LINUX GmbH, Nuernberg, Germany.

-# Copyright (c) 2016, Martin Hauke <mardnh@gmx.de>

-#

-# All modifications and additions to the file contributed by third parties

-# remain the property of their copyright owners, unless otherwise agreed

-# upon. The license for this file, and modifications and additions to the

-# file, is the same license as for the pristine package itself (unless the

-# license for the pristine package is not an Open Source License, in which

-# case the license is the MIT License). An "Open Source License" is a

-# license that conforms to the Open Source Definition (Version 1.9)

-# published by the Open Source Initiative.

-

-Name:           osmo-hlr

-Requires: osmocom-latest

-Version: 1.7.0

-Release:        0

-Summary:        Osmocom Home Location Register for GSUP protocol towards OsmoSGSN and OsmoCSCN

-License:        AGPL-3.0-or-later AND GPL-2.0-or-later

-Group:          Productivity/Telephony/Servers

-URL:            https://osmocom.org/projects/osmo-hlr

-Source: osmo-hlr_1.7.0.tar.xz

-Source1: rpmlintrc

-BuildRequires:  autoconf

-BuildRequires:  automake

-BuildRequires:  libtool

-BuildRequires:  pkgconfig >= 0.20

-BuildRequires:  python3

-%if 0%{?suse_version}

-BuildRequires:  systemd-rpm-macros

-%endif

-BuildRequires:  pkgconfig(libosmoabis) >= 1.5.0

-BuildRequires:  pkgconfig(libosmocore) >= 1.9.0

-BuildRequires:  pkgconfig(libosmoctrl) >= 1.9.0

-BuildRequires:  pkgconfig(libosmogsm) >= 1.9.0

-BuildRequires:  pkgconfig(libosmovty) >= 1.9.0

-BuildRequires:  pkgconfig(sqlite3)

-BuildRequires:  pkgconfig(talloc) >= 2.0.1

-# only needed for populate_hlr_db.pl

-Requires:       libdbi-drivers-dbd-sqlite3

-%{?systemd_requires}

-

-%description

-The GSUP HLR is a stand-alone HLR (Home Location Register) for SIM

-and USIM based subscribers which exposes the GSUP protocol towards

-its users. OsmoSGSN supports this protocol.

-

-osmo-gsup-hlr is still very simplistic. It is a single-threaded

-architecture and uses only sqlite3 tables as back-end.  It is suitable

-for installations of the scale that OsmoNITB was able to handle.  It

-also lacks various features like fine-grained control of subscribed

-services (like supplementary services).

-

-%package -n libosmo-gsup-client0

-Requires: osmocom-latest

-Summary:        Osmocom GSUP (General Subscriber Update Protocol) client library

-License:        GPL-2.0-or-later

-Group:          System/Libraries

-

-%description -n libosmo-gsup-client0

-This is a shared library that can be used to implement client programs for

-the GSUP protocol. The typical GSUP server is OsmoHLR, with OsmoMSC, OsmoSGSN

-and External USSD Entities (EUSEs) using this library to implement clients.

-

-%package -n libosmo-gsup-client-devel

-Requires: osmocom-latest

-Summary:        Development files for the Osmocom GSUP client library

-License:        GPL-2.0-or-later

-Group:          Development/Libraries/C and C++

-Requires:       libosmo-gsup-client0 = %{version}

-

-%description -n libosmo-gsup-client-devel

-This is a shared library that can be used to implement client programs for

-the GSUP protocol. The typical GSUP server is OsmoHLR, with OsmoMSC, OsmoSGSN

-and External USSD Entities (EUSEs) using this library to implement clients.

-

-This subpackage contains libraries and header files for developing

-applications that want to make use of libosmo-gsup-client.

-

-%package -n libosmo-mslookup1

-Requires: osmocom-latest

-Summary:        Osmocom MS lookup library

-License:        GPL-2.0-or-later

-Group:          System/Libraries

-

-%description -n libosmo-mslookup1

-This shared library contains routines for looking up mobile subscribers.

-

-%package -n libosmo-mslookup-devel

-Requires: osmocom-latest

-Summary:        Development files for the Osmocom MS lookup library

-License:        GPL-2.0-or-later

-Group:          Development/Libraries/C and C++

-Requires:       libosmo-mslookup1 = %{version}

-

-%description -n libosmo-mslookup-devel

-This shared library contains routines for looking up mobile subscribers.

-

-This subpackage contains libraries and header files for developing

-applications that want to make use of libosmo-mslookup.

-

-

-%package -n osmo-mslookup-client

-Requires: osmocom-latest

-Summary:        Standalone program using libosmo-mslookup

-License:        GPL-2.0-or-later

-Group:          Development/Libraries/C and C++

-

-%description -n osmo-mslookup-client

-Standalone program using libosmo-mslookup to easily integrate with programs

-that want to connect services (SIP, SMS,...) to the current location of a

-subscriber.

-

-%prep

-%setup -n osmo-hlr -q

-

-%build

-echo "%{version}" >.tarball-version

-autoreconf -fi

-%configure \

-  --docdir="%{_docdir}/%{name}" \

-  --with-systemdsystemunitdir=%{_unitdir} \

-  --enable-shared \

-  --disable-static

-make V=1 %{?_smp_mflags}

-

-%install

-%make_install

-install -d "%{buildroot}/%{_localstatedir}/lib/osmocom"

-find %{buildroot} -type f -name "*.la" -delete -print

-

-%check

-make %{?_smp_mflags} check || (find . -name testsuite.log -exec cat {} +)

-

-%if 0%{?suse_version}

-%preun

-%service_del_preun %{name}.service

-

-%postun

-%service_del_postun %{name}.service

-

-%pre

-%service_add_pre %{name}.service

-%endif

-

-%post

-%if 0%{?suse_version}

-%service_add_post %{name}.service

-%endif

-/usr/share/osmocom/osmo-hlr-post-upgrade.sh

-

-%post   -n libosmo-gsup-client0 -p /sbin/ldconfig

-%postun -n libosmo-gsup-client0 -p /sbin/ldconfig

-%post   -n libosmo-mslookup1 -p /sbin/ldconfig

-%postun -n libosmo-mslookup1 -p /sbin/ldconfig

-

-%files

-%license COPYING

-%dir %{_docdir}/%{name}

-%dir %{_docdir}/%{name}/examples

-%{_docdir}/%{name}/examples/osmo-hlr.cfg

-%{_docdir}/%{name}/examples/osmo-hlr-dgsm.cfg

-%dir %{_docdir}/%{name}/sql

-%{_docdir}/%{name}/sql/hlr.sql

-%{_docdir}/%{name}/sql//hlr_data.sql

-%dir %{_sysconfdir}/osmocom

-%dir %{_localstatedir}/lib/osmocom

-%{_bindir}/osmo-hlr

-%{_bindir}/osmo-hlr-db-tool

-%dir %{_sysconfdir}/osmocom

-%config %{_sysconfdir}/osmocom/osmo-hlr.cfg

-%{_unitdir}/osmo-hlr.service

-%dir %{_datadir}/osmocom

-%{_datadir}/osmocom/osmo-hlr-post-upgrade.sh

-

-%files -n libosmo-gsup-client0

-%{_libdir}/libosmo-gsup-client.so.0*

-

-%files -n libosmo-gsup-client-devel

-%{_bindir}/osmo-euse-demo

-%dir %{_includedir}/osmocom

-%dir %{_includedir}/osmocom/gsupclient

-%{_includedir}/osmocom/gsupclient/*.h

-%{_libdir}/libosmo-gsup-client.so

-%{_libdir}/pkgconfig/libosmo-gsup-client.pc

-

-%files -n libosmo-mslookup1

-%{_libdir}/libosmo-mslookup.so.1*

-

-%files -n libosmo-mslookup-devel

-%dir %{_includedir}/osmocom

-%dir %{_includedir}/osmocom/mslookup

-%{_includedir}/osmocom/mslookup/*.h

-%{_libdir}/libosmo-mslookup.so

-%{_libdir}/pkgconfig/libosmo-mslookup.pc

-

-%files -n osmo-mslookup-client

​

@@ -1,201 +0,0 @@

-#

-# spec file for package osmo-hlr

-#

-# Copyright (c) 2017 SUSE LINUX GmbH, Nuernberg, Germany.

-# Copyright (c) 2016, Martin Hauke <mardnh@gmx.de>

-#

-# All modifications and additions to the file contributed by third parties

-# remain the property of their copyright owners, unless otherwise agreed

-# upon. The license for this file, and modifications and additions to the

-# file, is the same license as for the pristine package itself (unless the

-# license for the pristine package is not an Open Source License, in which

-# case the license is the MIT License). An "Open Source License" is a

-# license that conforms to the Open Source Definition (Version 1.9)

-# published by the Open Source Initiative.

-

-Name:           osmo-hlr

-Requires: osmocom-latest

-Version:        @VERSION@

-Release:        0

-Summary:        Osmocom Home Location Register for GSUP protocol towards OsmoSGSN and OsmoCSCN

-License:        AGPL-3.0-or-later AND GPL-2.0-or-later

-Group:          Productivity/Telephony/Servers

-URL:            https://osmocom.org/projects/osmo-hlr

-Source:         %{name}-%{version}.tar.xz

-BuildRequires:  autoconf

-BuildRequires:  automake

-BuildRequires:  libtool

-BuildRequires:  pkgconfig >= 0.20

-BuildRequires:  python3

-%if 0%{?suse_version}

-BuildRequires:  systemd-rpm-macros

-%endif

-BuildRequires:  pkgconfig(libosmoabis) >= 1.5.0

-BuildRequires:  pkgconfig(libosmocore) >= 1.9.0

-BuildRequires:  pkgconfig(libosmoctrl) >= 1.9.0

-BuildRequires:  pkgconfig(libosmogsm) >= 1.9.0

-BuildRequires:  pkgconfig(libosmovty) >= 1.9.0

-BuildRequires:  pkgconfig(sqlite3)

-BuildRequires:  pkgconfig(talloc) >= 2.0.1

-# only needed for populate_hlr_db.pl

-Requires:       libdbi-drivers-dbd-sqlite3

-%{?systemd_requires}

-

-%description

-The GSUP HLR is a stand-alone HLR (Home Location Register) for SIM

-and USIM based subscribers which exposes the GSUP protocol towards

-its users. OsmoSGSN supports this protocol.

-

-osmo-gsup-hlr is still very simplistic. It is a single-threaded

-architecture and uses only sqlite3 tables as back-end.  It is suitable

-for installations of the scale that OsmoNITB was able to handle.  It

-also lacks various features like fine-grained control of subscribed

-services (like supplementary services).

-

-%package -n libosmo-gsup-client0

-Requires: osmocom-latest

-Summary:        Osmocom GSUP (General Subscriber Update Protocol) client library

-License:        GPL-2.0-or-later

-Group:          System/Libraries

-

-%description -n libosmo-gsup-client0

-This is a shared library that can be used to implement client programs for

-the GSUP protocol. The typical GSUP server is OsmoHLR, with OsmoMSC, OsmoSGSN

-and External USSD Entities (EUSEs) using this library to implement clients.

-

-%package -n libosmo-gsup-client-devel

-Requires: osmocom-latest

-Summary:        Development files for the Osmocom GSUP client library

-License:        GPL-2.0-or-later

-Group:          Development/Libraries/C and C++

-Requires:       libosmo-gsup-client0 = %{version}

-

-%description -n libosmo-gsup-client-devel

-This is a shared library that can be used to implement client programs for

-the GSUP protocol. The typical GSUP server is OsmoHLR, with OsmoMSC, OsmoSGSN

-and External USSD Entities (EUSEs) using this library to implement clients.

-

-This subpackage contains libraries and header files for developing

-applications that want to make use of libosmo-gsup-client.

-

-%package -n libosmo-mslookup1

-Requires: osmocom-latest

-Summary:        Osmocom MS lookup library

-License:        GPL-2.0-or-later

-Group:          System/Libraries

-

-%description -n libosmo-mslookup1

-This shared library contains routines for looking up mobile subscribers.

-

-%package -n libosmo-mslookup-devel

-Requires: osmocom-latest

-Summary:        Development files for the Osmocom MS lookup library

-License:        GPL-2.0-or-later

-Group:          Development/Libraries/C and C++

-Requires:       libosmo-mslookup1 = %{version}

-

-%description -n libosmo-mslookup-devel

-This shared library contains routines for looking up mobile subscribers.

-

-This subpackage contains libraries and header files for developing

-applications that want to make use of libosmo-mslookup.

-

-

-%package -n osmo-mslookup-client

-Requires: osmocom-latest

-Summary:        Standalone program using libosmo-mslookup

-License:        GPL-2.0-or-later

-Group:          Development/Libraries/C and C++

-

-%description -n osmo-mslookup-client

-Standalone program using libosmo-mslookup to easily integrate with programs

-that want to connect services (SIP, SMS,...) to the current location of a

-subscriber.

-

-%prep

-%setup -q

-

-%build

-echo "%{version}" >.tarball-version

-autoreconf -fi

-%configure \

-  --docdir="%{_docdir}/%{name}" \

-  --with-systemdsystemunitdir=%{_unitdir} \

-  --enable-shared \

-  --disable-static

-make V=1 %{?_smp_mflags}

-

-%install

-%make_install

-install -d "%{buildroot}/%{_localstatedir}/lib/osmocom"

-find %{buildroot} -type f -name "*.la" -delete -print

-

-%check

-make %{?_smp_mflags} check || (find . -name testsuite.log -exec cat {} +)

-

-%if 0%{?suse_version}

-%preun

-%service_del_preun %{name}.service

-

-%postun

-%service_del_postun %{name}.service

-

-%pre

-%service_add_pre %{name}.service

-%endif

-

-%post

-%if 0%{?suse_version}

-%service_add_post %{name}.service

-%endif

-/usr/share/osmocom/osmo-hlr-post-upgrade.sh

-

-%post   -n libosmo-gsup-client0 -p /sbin/ldconfig

-%postun -n libosmo-gsup-client0 -p /sbin/ldconfig

-%post   -n libosmo-mslookup1 -p /sbin/ldconfig

-%postun -n libosmo-mslookup1 -p /sbin/ldconfig

-

-%files

-%license COPYING

-%dir %{_docdir}/%{name}

-%dir %{_docdir}/%{name}/examples

-%{_docdir}/%{name}/examples/osmo-hlr.cfg

-%{_docdir}/%{name}/examples/osmo-hlr-dgsm.cfg

-%dir %{_docdir}/%{name}/sql

-%{_docdir}/%{name}/sql/hlr.sql

-%{_docdir}/%{name}/sql//hlr_data.sql

-%dir %{_sysconfdir}/osmocom

-%dir %{_localstatedir}/lib/osmocom

-%{_bindir}/osmo-hlr

-%{_bindir}/osmo-hlr-db-tool

-%dir %{_sysconfdir}/osmocom

-%config %{_sysconfdir}/osmocom/osmo-hlr.cfg

-%{_unitdir}/osmo-hlr.service

-%dir %{_datadir}/osmocom

-%{_datadir}/osmocom/osmo-hlr-post-upgrade.sh

-

-%files -n libosmo-gsup-client0

-%{_libdir}/libosmo-gsup-client.so.0*

-

-%files -n libosmo-gsup-client-devel

-%{_bindir}/osmo-euse-demo

-%dir %{_includedir}/osmocom

-%dir %{_includedir}/osmocom/gsupclient

-%{_includedir}/osmocom/gsupclient/*.h

-%{_libdir}/libosmo-gsup-client.so

-%{_libdir}/pkgconfig/libosmo-gsup-client.pc

-

-%files -n libosmo-mslookup1

-%{_libdir}/libosmo-mslookup.so.1*

-

-%files -n libosmo-mslookup-devel

-%dir %{_includedir}/osmocom

-%dir %{_includedir}/osmocom/mslookup

-%{_includedir}/osmocom/mslookup/*.h

-%{_libdir}/libosmo-mslookup.so

-%{_libdir}/pkgconfig/libosmo-mslookup.pc

-

-%files -n osmo-mslookup-client

-%{_bindir}/osmo-mslookup-client

​

@@ -2,13 +2,13 @@

 Source: osmo-hlr

 Binary: osmo-hlr, osmo-hlr-dbg, libosmo-gsup-client0, libosmo-gsup-client-dev, libosmo-mslookup1, libosmo-mslookup-dev, osmo-mslookup-utils, osmo-hlr-doc

 Architecture: any all

-Version: 1.7.0

+Version: 1.8.0

 Maintainer: Osmocom team <openbsc@lists.osmocom.org>

 Homepage: https://projects.osmocom.org/projects/osmo-hlr

 Standards-Version: 3.9.6

 Vcs-Browser: https://gitea.osmocom.org/cellular-infrastructure/osmo-hlr

 Vcs-Git: https://gitea.osmocom.org/cellular-infrastructure/osmo-hlr

-Build-Depends: debhelper (>= 10), pkg-config, dh-autoreconf, autotools-dev, python3-minimal, libosmocore-dev (>= 1.9.0), libosmo-abis-dev (>= 1.5.0), libosmo-netif-dev (>= 1.4.0), libsqlite3-dev, sqlite3, osmo-gsm-manuals-dev (>= 1.5.0)

+Build-Depends: debhelper (>= 10), pkg-config, dh-autoreconf, autotools-dev, python3-minimal, libosmocore-dev (>= 1.10.0), libosmo-abis-dev (>= 1.6.0), libosmo-netif-dev (>= 1.5.0), libsqlite3-dev, sqlite3, osmo-gsm-manuals-dev (>= 1.6.0)

 Package-List:

  libosmo-gsup-client-dev deb net optional arch=any

  libosmo-gsup-client0 deb libs optional arch=any

@@ -19,8 +19,8 @@

  osmo-hlr-doc deb doc optional arch=all

  osmo-mslookup-utils deb utils optional arch=any

 Checksums-Sha1:

- 8731f52ebdda028b265bf25266a86159fa2efd4a 174520 osmo-hlr_1.7.0.tar.xz

+ d860d2a24cb405e333781028a5a4c3ce4a794d9e 176436 osmo-hlr_1.8.0.tar.xz

 Checksums-Sha256:

- 9b7c7f920e4017f4af101dd78bcda5305e86b292e40b3f664da49c4a757fd892 174520 osmo-hlr_1.7.0.tar.xz

+ a191ca37c5b2ceb89bdbaec580cf93d11d5ca788dbbcec24c53a0b01a627ecc0 176436 osmo-hlr_1.8.0.tar.xz

 Files:

- cae8d41c0a36b375dc6eb4c52345df24 174520 osmo-hlr_1.7.0.tar.xz

+ 7adde67ba5cb72d60ff781839ccc26e7 176436 osmo-hlr_1.8.0.tar.xz

​

+(directory)

​

@@ -0,0 +1 @@

+open_collective: osmocom

​

@@ -1 +1 @@

-1.7.0

+1.8.0

​

@@ -11,8 +11,9 @@

 EXTRA_DIST = \

    .version \

-   contrib/osmo-hlr.spec.in \

+   README.md \

    debian \

+   git-version-gen \

    $(NULL)

 AM_DISTCHECK_CONFIGURE_FLAGS = \

​

@@ -1,8 +1,8 @@

 osmo-hlr - Osmocom HLR Implementation

 =====================================

-This repository contains a C-language implementation of a GSM Home

-Location Register (HLR). It is part of the

+This repository contains a C-language implementation of a GSM *Home

+Location Register (HLR)*. It is part of the

 Osmocom(https://osmocom.org/) Open Source Mobile Communications

 project.

@@ -10,13 +10,14 @@

 does not use the ETSI/3GPP TCAP/MAP protocol stack. Instead, a much

 simpler custom protocol (GSUP) is used.  This means, OsmoHLR is of

 no use outside the context of an Osmocom core network.  You can use

-it with OsmoMSC, OsmoSGSN etc. - but not with third party components.

+it with OsmoMSC(https://osmocom.org/projects/osmomsc/wiki),

+OsmoSGSN(https://osmocom.org/projects/osmosgsn/wiki) etc. -

+but not directly with third party components.

 Homepage

 --------

-The official homepage of the project is

-https://osmocom.org/projects/osmo-hlr/wiki

+The official homepage of the project is <https://osmocom.org/projects/osmo-hlr/wiki>.

 GIT Repository

 --------------

@@ -33,11 +34,18 @@

 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/osmohlr-usermanual.pdf)

-as well as the VTY reference manuals

+Pre-rendered PDF versions of the current `master` can be found at

+

+* User Manual(https://ftp.osmocom.org/docs/latest/osmohlr-usermanual.pdf)

 * VTY Reference Manual for osmo-hlr(https://ftp.osmocom.org/docs/latest/osmohlr-vty-reference.pdf)

+Forum

+-----

+

+We welcome any osmo-hlr 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

 ------------

@@ -50,16 +58,23 @@

 Rules(https://osmocom.org/projects/cellular-infrastructure/wiki/Mailing_List_Rules)

 when posting.

+Issue Tracker

+-------------

+

+We use the issue tracker of the osmo-hlr project on osmocom.org(https://osmocom.org/projects/osmo-hlr/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

 ------------

 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

+We use 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 osmo-hlr can be seen at

-https://gerrit.osmocom.org/#/q/project:osmo-hlr+status:open

+<https://gerrit.osmocom.org/#/q/project:osmo-hlr+status:open>

​

@@ -1,9 +1,9 @@

 # When cleaning up this file: bump API version in corresponding Makefile.am and rename corresponding debian/lib*.install

-# according to https://www.gnu.org/software/libtool/manual/html_node/Updating-version-info.html#Updating-version-info

-# In short:

+# according to https://osmocom.org/projects/cellular-infrastructure/wiki/Make_a_new_release

+# In short: https://www.gnu.org/software/libtool/manual/html_node/Updating-version-info.html#Updating-version-info

 # LIBVERSION=c:r:a

 # If the library source code has changed at all since the last update, then increment revision: c:r + 1:a.

-# If any interfaces have been added, removed, or changed since the last update: c + 1:0:0.

+# If any interfaces have been added, removed, or changed since the last update: c + 1:0:a.

 # If any interfaces have been added since the last public release: c:r:a + 1.

 # If any interfaces have been removed or changed since the last public release: c:r:0.

-#library        what            description / commit summary line

+#library   what            description / commit summary line

​

@@ -41,11 +41,11 @@

 PKG_CHECK_MODULES(TALLOC, talloc >= 2.0.1)

-PKG_CHECK_MODULES(LIBOSMOCORE, libosmocore >= 1.9.0)

-PKG_CHECK_MODULES(LIBOSMOGSM, libosmogsm >= 1.9.0)

-PKG_CHECK_MODULES(LIBOSMOVTY, libosmovty >= 1.9.0)

-PKG_CHECK_MODULES(LIBOSMOCTRL, libosmoctrl >= 1.9.0)

-PKG_CHECK_MODULES(LIBOSMOABIS, libosmoabis >= 1.5.0)

+PKG_CHECK_MODULES(LIBOSMOCORE, libosmocore >= 1.10.0)

+PKG_CHECK_MODULES(LIBOSMOGSM, libosmogsm >= 1.10.0)

+PKG_CHECK_MODULES(LIBOSMOVTY, libosmovty >= 1.10.0)

+PKG_CHECK_MODULES(LIBOSMOCTRL, libosmoctrl >= 1.10.0)

+PKG_CHECK_MODULES(LIBOSMOABIS, libosmoabis >= 1.6.0)

 PKG_CHECK_MODULES(SQLITE3, sqlite3)

@@ -203,7 +203,6 @@

    contrib/Makefile

    contrib/systemd/Makefile

    contrib/dgsm/Makefile

-   contrib/osmo-hlr.spec

    tests/Makefile

    tests/auc/Makefile

    tests/auc/gen_ts_55_205_test_sets/Makefile

​

@@ -9,6 +9,8 @@

 Restart=always

 StateDirectory=osmocom

 WorkingDirectory=%S/osmocom

+User=osmocom

+Group=osmocom

 ExecStart=/usr/bin/osmo-hlr -c /etc/osmocom/osmo-hlr.cfg -l /var/lib/osmocom/hlr.db

 RestartSec=2

 ProtectHome=true

​

@@ -1,3 +1,36 @@

+osmo-hlr (1.8.0) unstable; urgency=medium

+

+   Vadim Yanitskiy 

+  * hlr_vty.c: drop redundant include of hlr_ussd.h

+  * build: include {README.md,git-version-gen} into the release tarball

+  * README.md: cosmetic: fix a typo

+

+   Mychaela N. Falconia 

+  * SMS over GSUP: implement vty config of SMSC routing

+  * SMS over GSUP: implement forwarding of MO SMS

+  * SMS over GSUP: implement forwarding of MT SMS

+  * SMS over GSUP: handle READY-FOR-SM.req from MSCs

+  * ctrl: add subscriber.by-*.imsi GET-able variable

+

+   Andreas Eversberg 

+  * Use uniform log format for default config files

+

+   Harald Welte 

+  * Add funding link to github mirror

+  * README.md: Improve mark-down formatting

+  * README.md: Add Forum and Issue Tracker sections

+

+   Max 

+  * .deb/.rpm: add osmocom user during package install

+

+   Oliver Smith 

+  * .deb/.rpm: various fixes related to non-root

+  * contrib: remove rpm spec file

+  * debian/postinst: add checks, be verbose

+  * mslookup: don't ignore return value of write()

+

+ -- Oliver Smith <osmith@sysmocom.de>  Wed, 24 Jul 2024 15:29:12 +0200

+

 osmo-hlr (1.7.0) unstable; urgency=medium

    Oliver Smith 

​

@@ -7,12 +7,12 @@

                dh-autoreconf,

                autotools-dev,

                python3-minimal,

-               libosmocore-dev (>= 1.9.0),

-               libosmo-abis-dev (>= 1.5.0),

-               libosmo-netif-dev (>= 1.4.0),

+               libosmocore-dev (>= 1.10.0),

+               libosmo-abis-dev (>= 1.6.0),

+               libosmo-netif-dev (>= 1.5.0),

                libsqlite3-dev,

                sqlite3,

-               osmo-gsm-manuals-dev (>= 1.5.0)

+               osmo-gsm-manuals-dev (>= 1.6.0)

 Standards-Version: 3.9.6

 Vcs-Browser: https://gitea.osmocom.org/cellular-infrastructure/osmo-hlr

 Vcs-Git: https://gitea.osmocom.org/cellular-infrastructure/osmo-hlr

​

@@ -3,3 +3,41 @@

 # post-upgrade script in both cases, it won't do anything if there is nothing

 # to do.

 /usr/share/osmocom/osmo-hlr-post-upgrade.sh

+

+case "$1" in

+   configure)

+       # Create the osmocom group and user (if it doesn't exist yet)

+       if ! getent group osmocom >/dev/null; then

+           groupadd --system osmocom

+       fi

+       if ! getent passwd osmocom >/dev/null; then

+           useradd \

+               --system \

+               --gid osmocom \

+               --home-dir /var/lib/osmocom \

+               --shell /sbin/nologin \

+               --comment "Open Source Mobile Communications" \

+               osmocom

+       fi

+

+       # Fix permissions of previous (root-owned) install (OS#4107)

+       if dpkg --compare-versions "$2" le "1.8.0"; then

+           if  -e /etc/osmocom/osmo-hlr.cfg ; then

+               chown -v osmocom:osmocom /etc/osmocom/osmo-hlr.cfg

+               chmod -v 0660 /etc/osmocom/osmo-hlr.cfg

+           fi

+

+           if  -d /etc/osmocom ; then

+               chown -v root:osmocom /etc/osmocom

+               chmod -v 2775 /etc/osmocom

+           fi

+

+           mkdir -p /var/lib/osmocom

+           chown -R -v osmocom:osmocom /var/lib/osmocom

+       fi

+       ;;

+esac

+

+# dh_installdeb(1) will replace this with shell code automatically

+# generated by other debhelper scripts.

+#DEBHELPER#

​

@@ -1,4 +1,12 @@

 # OsmoHLR example configuration for Distributed GSM (mslookup)

+log stderr

+ logging color 1

+ logging print category-hex 0

+ logging print category 1

+ logging timestamp 0

+ logging print file basename last

+ logging print level 1

+

 hlr

  gsup

   # For D-GSM roaming, osmo-hlr's GSUP must listen on a public IP:

​

@@ -4,11 +4,11 @@

 log stderr

  logging filter all 1

  logging color 1

- logging print category 1

  logging print category-hex 0

- logging print level 1

+ logging print category 1

+ logging timestamp 0

  logging print file basename last

- logging print extended-timestamp 1

+ logging print level 1

  logging level main notice

  logging level db notice

  logging level auc notice

​

@@ -6,6 +6,7 @@

    gsup_router.h \

    gsup_server.h \

    hlr.h \

+   hlr_sms.h \

    hlr_ussd.h \

    hlr_vty.h \

    hlr_vty_subscr.h \

​

@@ -74,6 +74,10 @@

    struct llist_head ss_sessions;

+   struct llist_head smsc_list;

+   struct llist_head smsc_routes;

+   struct hlr_smsc *smsc_default;

+

    bool store_imei;

    bool subscr_create_on_demand;

​

@@ -0,0 +1,33 @@

+#pragma once

+

+#include <osmocom/core/linuxlist.h>

+

+struct hlr_smsc {

+   /* g_hlr->smsc_list */

+   struct llist_head list;

+   struct hlr *hlr;

+   /* name (must match the IPA ID tag) */

+   const char *name;

+   /* human-readable description */

+   const char *description;

+};

+

+struct hlr_smsc *smsc_find(struct hlr *hlr, const char *name);

+struct hlr_smsc *smsc_alloc(struct hlr *hlr, const char *name);

+void smsc_free(struct hlr_smsc *smsc);

+

+struct hlr_smsc_route {

+   /* g_hlr->smsc_routes */

+   struct llist_head list;

+   const char *num_addr;

+   struct hlr_smsc *smsc;

+};

+

+struct hlr_smsc_route *smsc_route_find(struct hlr *hlr, const char *num_addr);

+struct hlr_smsc_route *smsc_route_alloc(struct hlr *hlr, const char *num_addr,

+                   struct hlr_smsc *smsc);

+void smsc_route_free(struct hlr_smsc_route *rt);

+

+void forward_mo_sms(struct osmo_gsup_req *req);

+void forward_mt_sms(struct osmo_gsup_req *req);

+void rx_ready_for_sm_req(struct osmo_gsup_req *req);

​

@@ -31,6 +31,7 @@

    HLR_NODE = _LAST_OSMOVTY_NODE + 1,

    GSUP_NODE,

    EUSE_NODE,

+   SMSC_NODE,

    MSLOOKUP_NODE,

    MSLOOKUP_SERVER_NODE,

    MSLOOKUP_SERVER_MSC_NODE,

​

@@ -52,6 +52,7 @@

    hlr_vty.c \

    hlr_vty_subscr.c \

    gsup_send.c \

+   hlr_sms.c \

    hlr_ussd.c \

    proxy.c \

    dgsm.c \

​

@@ -426,6 +426,20 @@

    return set_subscr_cs_ps_enabled(cmd, data, false);

 }

+CTRL_CMD_DEFINE_RO(subscr_imsi, "imsi");

+static int get_subscr_imsi(struct ctrl_cmd *cmd, void *data)

+{

+   struct hlr_subscriber subscr;

+   struct hlr *hlr = data;

+   const char *by_selector = cmd->node;

+

+   if (!get_subscriber(hlr->dbc, by_selector, &subscr, cmd))

+       return CTRL_CMD_ERROR;

+

+   cmd->reply = talloc_strdup(cmd, subscr.imsi);

+   return CTRL_CMD_REPLY;

+}

+

 CTRL_CMD_DEFINE(subscr_msisdn, "msisdn");

 static int verify_subscr_msisdn(struct ctrl_cmd *cmd, const char *value, void *data)

 {

@@ -761,6 +775,7 @@

    rc |= ctrl_cmd_install(CTRL_NODE_SUBSCR_BY, &cmd_subscr_info_all);

    rc |= ctrl_cmd_install(CTRL_NODE_SUBSCR_BY, &cmd_subscr_ps_enabled);

    rc |= ctrl_cmd_install(CTRL_NODE_SUBSCR_BY, &cmd_subscr_cs_enabled);

+   rc |= ctrl_cmd_install(CTRL_NODE_SUBSCR_BY, &cmd_subscr_imsi);

    rc |= ctrl_cmd_install(CTRL_NODE_SUBSCR_BY, &cmd_subscr_msisdn);

    rc |= ctrl_cmd_install(CTRL_NODE_SUBSCR_BY, &cmd_subscr_aud2g);

    rc |= ctrl_cmd_install(CTRL_NODE_SUBSCR_BY, &cmd_subscr_aud3g);

​

@@ -49,6 +49,7 @@

 #include <osmocom/hlr/rand.h>

 #include <osmocom/hlr/hlr_vty.h>

 #include <osmocom/hlr/hlr_ussd.h>

+#include <osmocom/hlr/hlr_sms.h>

 #include <osmocom/hlr/dgsm.h>

 #include <osmocom/hlr/proxy.h>

 #include <osmocom/hlr/lu_fsm.h>

@@ -556,6 +557,15 @@

    case OSMO_GSUP_MSGT_CHECK_IMEI_REQUEST:

        rx_check_imei_req(req);

        break;

+   case OSMO_GSUP_MSGT_MO_FORWARD_SM_REQUEST:

+       forward_mo_sms(req);

+       break;

+   case OSMO_GSUP_MSGT_MT_FORWARD_SM_REQUEST:

+       forward_mt_sms(req);

+       break;

+   case OSMO_GSUP_MSGT_READY_FOR_SM_REQUEST:

+       rx_ready_for_sm_req(req);

+       break;

    default:

        LOGP(DMAIN, LOGL_DEBUG, "Unhandled GSUP message type %s\n",

             osmo_gsup_message_type_name(req->gsup.message_type));

@@ -750,8 +760,10 @@

    g_hlr = talloc_zero(hlr_ctx, struct hlr);

    INIT_LLIST_HEAD(&g_hlr->euse_list);

+   INIT_LLIST_HEAD(&g_hlr->smsc_list);

    INIT_LLIST_HEAD(&g_hlr->ss_sessions);

    INIT_LLIST_HEAD(&g_hlr->ussd_routes);

+   INIT_LLIST_HEAD(&g_hlr->smsc_routes);

    INIT_LLIST_HEAD(&g_hlr->mslookup.server.local_site_services);

    g_hlr->db_file_path = talloc_strdup(g_hlr, HLR_DEFAULT_DB_FILE_PATH);

    g_hlr->mslookup.server.mdns.domain_suffix = talloc_strdup(g_hlr, OSMO_MDNS_DOMAIN_SUFFIX_DEFAULT);

​

@@ -0,0 +1,276 @@

+/* OsmoHLR SMS-over-GSUP routing implementation */

+

+/* Author: Mychaela N. Falconia <falcon@freecalypso.org>, 2023 - however,

+ * Mother Mychaela's contributions are NOT subject to copyright.

+ * No rights reserved, all rights relinquished.

+ *

+ * Based on earlier unmerged work by Vadim Yanitskiy, 2019.

+ *

+ * This program is free software; you can redistribute it and/or modify

+ * it under the terms of the GNU Affero General Public License as published by

+ * the Free Software Foundation; either version 3 of the License, or

+ * (at your option) any later version.

+ *

+ * This program is distributed in the hope that it will be useful,

+ * but WITHOUT ANY WARRANTY; without even the implied warranty of

+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

+ * GNU Affero General Public License for more details.

+ *

+ * You should have received a copy of the GNU Affero General Public License

+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.

+ */

+

+#include <stdint.h>

+#include <string.h>

+#include <errno.h>

+

+#include <osmocom/core/talloc.h>

+#include <osmocom/gsm/gsup.h>

+#include <osmocom/gsm/gsm48_ie.h>

+#include <osmocom/gsm/protocol/gsm_04_11.h>

+

+#include <osmocom/hlr/hlr.h>

+#include <osmocom/hlr/hlr_sms.h>

+#include <osmocom/hlr/gsup_server.h>

+#include <osmocom/hlr/gsup_router.h>

+#include <osmocom/hlr/logging.h>

+#include <osmocom/hlr/db.h>

+

+/***********************************************************************

+ * core data structures expressing config from VTY

+ ***********************************************************************/

+

+struct hlr_smsc *smsc_find(struct hlr *hlr, const char *name)

+{

+   struct hlr_smsc *smsc;

+

+   llist_for_each_entry(smsc, &hlr->smsc_list, list) {

+       if (!strcmp(smsc->name, name))

+           return smsc;

+   }

+   return NULL;

+}

+

+struct hlr_smsc *smsc_alloc(struct hlr *hlr, const char *name)

+{

+   struct hlr_smsc *smsc = smsc_find(hlr, name);

+   if (smsc)

+       return NULL;

+

+   smsc = talloc_zero(hlr, struct hlr_smsc);

+   smsc->name = talloc_strdup(smsc, name);

+   smsc->hlr = hlr;

+   llist_add_tail(&smsc->list, &hlr->smsc_list);

+

+   return smsc;

+}

+

+void smsc_free(struct hlr_smsc *smsc)

+{

+   llist_del(&smsc->list);

+   talloc_free(smsc);

+}

+

+struct hlr_smsc_route *smsc_route_find(struct hlr *hlr, const char *num_addr)

+{

+   struct hlr_smsc_route *rt;

+

+   llist_for_each_entry(rt, &hlr->smsc_routes, list) {

+       if (!strcmp(rt->num_addr, num_addr))

+           return rt;

+   }

+   return NULL;

+}

+

+struct hlr_smsc_route *smsc_route_alloc(struct hlr *hlr, const char *num_addr,

+                   struct hlr_smsc *smsc)

+{

+   struct hlr_smsc_route *rt;

+

+   if (smsc_route_find(hlr, num_addr))

+       return NULL;

+

+   rt = talloc_zero(hlr, struct hlr_smsc_route);

+   rt->num_addr = talloc_strdup(rt, num_addr);

+   rt->smsc = smsc;

+   llist_add_tail(&rt->list, &hlr->smsc_routes);

+

+   return rt;

+}

+

+void smsc_route_free(struct hlr_smsc_route *rt)

+{

+   llist_del(&rt->list);

+   talloc_free(rt);

+}

+

+/***********************************************************************

+ * forwarding of MO SMS to SMSCs based on SM-RP-DA

+ ***********************************************************************/

+

+static const struct hlr_smsc *find_smsc_route(const char *smsc_addr)

+{

+   const struct hlr_smsc_route *rt;

+

+   rt = smsc_route_find(g_hlr, smsc_addr);

+   if (rt)

+       return rt->smsc;

+   return g_hlr->smsc_default;

+}

+

+static void respond_with_sm_rp_cause(struct osmo_gsup_req *req,

+                    uint8_t sm_rp_cause)

+{

+   struct osmo_gsup_message rsp_msg = { };

+

+   rsp_msg.sm_rp_cause = &sm_rp_cause;

+   osmo_gsup_req_respond(req, &rsp_msg, true, true);

+}

+

+/* Short Message from MSC/VLR towards SMSC */

+void forward_mo_sms(struct osmo_gsup_req *req)

+{

+   uint8_t gsm48_decode_bufferGSM411_SMSC_ADDR_MAX_OCTETS;

+   char smsc_addrGSM411_SMSC_ADDR_MAX_DIGITS+1;

+   const struct hlr_smsc *smsc;

+   struct osmo_cni_peer_id dest_peer;

+

+   /* Make sure SM-RP-DA (SMSC address) is present */

+   if (req->gsup.sm_rp_da == NULL || !req->gsup.sm_rp_da_len) {

+       osmo_gsup_req_respond_err(req, GMM_CAUSE_INV_MAND_INFO,

+                     "missing SM-RP-DA");

+       return;

+   }

+

+   if (req->gsup.sm_rp_da_type != OSMO_GSUP_SMS_SM_RP_ODA_SMSC_ADDR) {

+       osmo_gsup_req_respond_err(req, GMM_CAUSE_INV_MAND_INFO,

+                     "SM-RP-DA type is not SMSC");

+       return;

+   }

+

+   /* Enforce the length constrainst on SM-RP-DA, as specified in

+    * GSM 04.11 section 8.2.5.2.  Also enforce absence of ToN/NPI

+    * extension octets at the same time. */

+   if (req->gsup.sm_rp_da_len < GSM411_SMSC_ADDR_MIN_OCTETS ||

+       req->gsup.sm_rp_da_len > GSM411_SMSC_ADDR_MAX_OCTETS ||

+       !(req->gsup.sm_rp_da0 & 0x80)) {

+       /* This form of bogosity originates from the MS,

+        * not from OsmoMSC or any other Osmocom network elements! */

+       LOGP(DLSMS, LOGL_NOTICE,

+            "Rx '%s' (IMSI-%s) contains invalid SM-RP-DA from MS\n",

+            osmo_gsup_message_type_name(req->gsup.message_type),

+            req->gsup.imsi);

+       respond_with_sm_rp_cause(req, GSM411_RP_CAUSE_SEMANT_INC_MSG);

+       return;

+   }

+

+   /* Decode SMSC address from SM-RP-DA */

+   gsm48_decode_buffer0 = req->gsup.sm_rp_da_len - 1;

+   memcpy(gsm48_decode_buffer + 1, req->gsup.sm_rp_da + 1,

+       req->gsup.sm_rp_da_len - 1);

+   gsm48_decode_bcd_number2(smsc_addr, sizeof(smsc_addr),

+                gsm48_decode_buffer,

+                req->gsup.sm_rp_da_len, 0);

+

+   /* Look for a route to this SMSC */

+   smsc = find_smsc_route(smsc_addr);

+   if (smsc == NULL) {

+       LOGP(DLSMS, LOGL_NOTICE,

+            "Failed to find a route for '%s' (IMSI-%s, SMSC-Addr-%s)\n",

+            osmo_gsup_message_type_name(req->gsup.message_type),

+            req->gsup.imsi, smsc_addr);

+       respond_with_sm_rp_cause(req,

+                    GSM411_RP_CAUSE_MO_NUM_UNASSIGNED);

+       return;

+   }

+

+   /* We got the IPA name of our SMSC - forward the message */

+   osmo_cni_peer_id_set(&dest_peer, OSMO_CNI_PEER_ID_IPA_NAME,

+                (const uint8_t *) smsc->name,

+                strlen(smsc->name) + 1);

+   osmo_gsup_forward_to_local_peer(req->cb_data, &dest_peer, req, NULL);

+}

+

+/***********************************************************************

+ * forwarding of MT SMS from SMSCs to MSC/VLR based on IMSI

+ ***********************************************************************/

+

+void forward_mt_sms(struct osmo_gsup_req *req)

+{

​

@@ -44,6 +44,7 @@

 #include <osmocom/hlr/hlr_vty.h>

 #include <osmocom/hlr/hlr_vty_subscr.h>

 #include <osmocom/hlr/hlr_ussd.h>

+#include <osmocom/hlr/hlr_sms.h>

 #include <osmocom/hlr/gsup_server.h>

 static const struct value_string gsm48_gmm_cause_vty_names = {

@@ -422,8 +423,6 @@

  * USSD Entity

  ***********************************************************************/

-#include <osmocom/hlr/hlr_ussd.h>

-

 #define USSD_STR "USSD Configuration\n"

 #define UROUTE_STR "Routing Configuration\n"

 #define PREFIX_STR "Prefix-Matching Route\n" "USSD Prefix\n"

@@ -610,6 +609,160 @@

    return CMD_SUCCESS;

 }

+/***********************************************************************

+ * Routing of SM-RL to GSUP-attached SMSCs

+ ***********************************************************************/

+

+#define SMSC_STR "Configuration of GSUP routing to SMSCs\n"

+

+struct cmd_node smsc_node = {

+   SMSC_NODE,

+   "%s(config-hlr-smsc)# ",

+   1,

+};

+

+DEFUN(cfg_smsc_entity, cfg_smsc_entity_cmd,

+   "smsc entity NAME",

+   SMSC_STR

+   "Configure a particular external SMSC\n"

+   "IPA name of the external SMSC\n")

+{

+   struct hlr_smsc *smsc;

+   const char *id = argv0;

+

+   smsc = smsc_find(g_hlr, id);

+   if (!smsc) {

+       smsc = smsc_alloc(g_hlr, id);

+       if (!smsc)

+           return CMD_WARNING;

+   }

+   vty->index = smsc;

+   vty->index_sub = &smsc->description;

+   vty->node = SMSC_NODE;

+

+   return CMD_SUCCESS;

+}

+

+DEFUN(cfg_no_smsc_entity, cfg_no_smsc_entity_cmd,

+   "no smsc entity NAME",

+   NO_STR SMSC_STR "Remove a particular external SMSC\n"