cellular-infrastructure
/
osmo-iuh
mirror of https://gerrit.osmocom.org/osmo-iuh
9
0
Fork 0
Code Issues Releases Wiki Activity
Osmocom code for the Iuh interface (HNBAP, RUA, RANAP) https://osmocom.org/projects/libosmo-ranap
585 Commits 25 Branches 18 Tags 20 MiB
C 97.5%
Makefile 1.7%
Python 0.5%
Shell 0.2%
Go to file
Eric Wild 8d88271570 configure.ac: fix libtool issue with clang and sanitizer 
As pointed out at https://github.com/libexpat/libexpat/issues/312
libtool does not play nice with clang sanitizer builds at all.
For those builds LD shoud be set to clang too (and LDFLAGS needs the
sanitizer flags as well), because the clang compiler driver knows how
linking to the sanitizer libs works, but then at a later stage libtool
fails to actually produce the shared libraries and the build fails. This
is fixed by this patch.

Addtionally LD_LIBRARY_PATH has no effect on conftest runs during
configure time, so the rpath needs to be set to the asan library path to
ensure the configure run does not fail due to a missing asan library,
i.e.:

SANS='-fsanitize=memory -fsanitize-recover=all -shared-libsan'
export CC=clang-10
ASANPATH=$(dirname `$CC -print-file-name=libclang_rt.asan-x86_64.so`)
export LDFLAGS="-Wl,-rpath,$ASANPATH $SANS $LDFLAGS"

Change-Id: I74cdca5c8bd5a32b6fb05906280cc1cdd64e9369
 		2020-04-11 01:18:34 +02:00
asn1 debian, asn1tostruct.py: switch to python3 2019-12-11 11:37:21 +01:00
contrib jenkins: Enable manual publishing and building 2019-07-30 11:28:51 +02:00
debian Bump version: 0.5.0.23-11a1 → 0.6.0 2020-01-03 17:04:15 +01:00
doc manual: link to new common cs7-config.adoc 2020-03-30 18:19:33 +02:00
include sabp: Generate C/H files for SABP; create libosmo-sabp 2019-09-23 20:23:51 +02:00
pcap Better capture for PS Data 2016-02-18 13:21:30 +01:00
specs import TR 25.931 with examples of signalling procedures 2016-02-22 09:17:15 +01:00
src tests/test-ranap: cosmetic: remove unused variable 'rc' 2020-04-07 21:11:13 +07:00
.gitignore gitignore: add gen_sabp.stamp 2019-12-11 09:23:58 +01:00
.gitreview add .gitreview to support git review plugin 2017-08-08 17:02:18 +00:00
COPYING move COPYING file to root directory 2015-12-21 21:01:00 +01:00
Makefile.am sabp: Generate C/H files for SABP; create libosmo-sabp 2019-09-23 20:23:51 +02:00
README.md Update README with project related information and convert to Markdown 2017-03-17 18:15:20 +01:00
TODO-RELEASE manual: link to new common cs7-config.adoc 2020-03-30 18:19:33 +02:00
configure.ac configure.ac: fix libtool issue with clang and sanitizer 2020-04-11 01:18:34 +02:00
git-version-gen add git-version-gen to auto-generate git based version number 2016-01-03 18:08:05 +01:00
libosmo-ranap.pc.in add pkg-config file for libosmo-ranap 2016-01-03 18:12:22 +01:00
libosmo-sabp.pc.in sabp: Generate C/H files for SABP; create libosmo-sabp 2019-09-23 20:23:51 +02:00
move-asn1-header-files.sh make regen: ~8x faster: use sed script instead of single invocations 2016-07-12 00:44:18 +02:00

README.md

osmo-iuh - Osmocom Iuh and HNB-GW implementation

This repository contains a C-language implementation of the 3GPP Iuh interface, together with a HNB-GW (Home NodeB Gateway). You can use it to interface Iuh-speaking femtocells/small cells to Iu-speaking MSCs and SGSNs.

It is part of the Osmocom Open Source Mobile Communications project.

Homepage

The official homepage of the project is https://osmocom.org/projects/osmohnbgw/wiki

GIT Repository

You can clone from the official libosmocore.git repository using

git clone git://git.osmocom.org/osmo-iuh.git

There is a cgit interface at http://git.osmocom.org/osmo-iuh/

Documentation

There is currently no documentation beyond the wiki available on the homepage. We would love to see somebody contributing a manual that can be part of the osmo-gsm-manuals suite.

Mailing List

Discussions related to osmo-iuh are happening on the openbsc@lists.osmocom.org 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 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-iuh can be seen at https://gerrit.osmocom.org/#/q/project:osmo-iuh+status:open

Building

It is generally best to check the wiki for the most up-to-date build instructions.

As external library dependencies, you will need

  • libosmocore from git://git.osmocom.org/libosmocore
  • libasn1c from git://git.osmocom.org/libasn1c
  • libsctp-dev (this is the package name in Debian)
  • libosmo-netif from git://git.osmocom.org/libosmo-netif (sysmocom/sctp branch)
  • libosmo-sccp from git://git.osmocom.org/libosmo-sccp (sysmocom/iu branch)

To bootstrap the build, in the root directory, run:

autoreconf --install

After that, run the usual

./configure [options]
make
[sudo] make install

Using

Note: osmo-iuh just left very active development (December 2015, January 2016), so your mileage may vary.

If you run the 'hnbgw' executable, it will open a listening SCTP socket and wait for incoming Iuh connections. It will accept any HNB-REGISTER-REQUEST, and it will establish Iu (over SUA) connections towards the MSC and SGSN.

Regenerating C code from ASN.1 source

In order to re-generate the C source code from the ASN.1 source, you will need a modified asn1c which has the following features:

  • APER support (the patch from Eurecom, or its forward-ported version from the aper branch of git://git.osmocom.org/asn1c)
  • support for prefixing the generated types (aper-prefix branch of git://git.osmocom.org/asn1c)