Common library for all Osmocom projects (libosmocore, libosmogsm, libosmovty, libosmogb, libosmosim, libosmousb, ...)
Go to file
Pau Espin 01dd570de8 Always generate entire commit changelog
Before this commit, for library projects (containing LIBVERSION in some
Makefile), the entire commit list was not stored into the changelog, but
only a few lines from TODO-RELEASE files.

This is a bad approach for several reasons. First, because that file was
only aimed at containing API/ABI breaks, and not the full relevant
changeset (like bugfixes, new features, etc.). Second, because it relies
on every developer making API/ABI changes to remember to store the
change in there during commit break time.

Let's instead always store the entire commit list in changelog, and
let's use TODO-RELEASE only as a list of hints for the maintainer to
help him evaluate how LIBVERSION needs to be bumped for each library.
Other tools such as osmo-abi-check.git can be used to help with the
process of decission too.

Let's take the opportunity too to only commit stuff already added to the
staging area, as it proved easier to manage from my personal experinece
making latest releases.

Change-Id: Ibf662173ce2b4ff3966e9ad5f56c65dfb13607ff
2018-05-03 15:21:24 +02:00
contrib contrib/fsm-to-dot: warn about identically named FSMs 2018-03-26 15:04:32 +02:00
debian implement support for 3-digit MNC with leading zeros 2018-02-28 19:26:33 +01:00
doc vty reference: merge_doc.xsl: do not omit description tag 2017-12-10 13:34:36 +00:00
include gsm_08_58.h: introduce RSL_IE_ERIC_PAGING_GROUP 2018-04-23 08:38:34 +00:00
m4 conv_acc: Our code requires SSSE3, not just SSE3 2017-11-17 11:44:22 +01:00
src gsm_utils: call gnutls_global_init() as constructor 2018-05-02 15:45:56 +02:00
tests gsm0808_test: silence deprecation: use gsm0808_create_layer3_2() 2018-04-23 08:42:00 +00:00
utils Revert "Use python 3 for utilities" 2018-02-09 08:49:26 +00:00
.gitignore Embedded: add sercomm stubs 2018-01-21 19:08:05 +00:00
.gitreview add .gitreview 2016-05-19 06:39:13 +00:00
.mailmap Add .mailmap file for mapping mail addresses in shortlog 2016-08-08 13:12:17 +02:00
COPYING add GPL to project source 2010-02-21 09:21:30 +01:00 doxygen: config: one enum val per line 2017-06-23 00:18:24 +00:00 doxygen: config: one enum val per line 2017-06-23 00:18:24 +00:00 [doc] Ensure stats.h is parsed properly for Doxygen 2017-10-17 05:47:09 +00:00 doxygen: enable AUTOBRIEF, drop \brief 2017-06-23 00:18:22 +00:00 [doc] Ensure include/crypt/* is part of libosmogsm documentation 2017-10-17 05:52:04 +00:00 doxygen: config: one enum val per line 2017-06-23 00:18:24 +00:00 build: Ensure all .pc files are installed 2018-02-14 00:47:19 +00:00 Make sure all hyperlinks use <> 2017-03-17 21:31:42 +01:00
TODO-RELEASE Always generate entire commit changelog 2018-05-03 15:21:24 +02:00 configure: add --enable-werror 2018-03-13 00:00:30 +00:00
git-version-gen add git-version-gen magic to automatically generate package version 2010-03-23 00:30:19 +08:00 codec: Add the missing bits for include to install and pkgconfig to work 2010-10-24 18:23:10 +02:00 libosmocoding: migrate transcoding routines from OsmoBTS 2017-03-07 01:06:38 +07:00 talloc: Untested change to unbreak build 2015-12-10 19:50:29 +01:00 remove our internal copy of talloc, use system libtalloc 2015-12-05 23:38:18 +01:00 remove our internal copy of talloc, use system libtalloc 2015-12-05 23:38:18 +01:00 remove our internal copy of talloc, use system libtalloc 2015-12-05 23:38:18 +01:00 remove our internal copy of talloc, use system libtalloc 2015-12-05 23:38:18 +01:00 remove our internal copy of talloc, use system libtalloc 2015-12-05 23:38:18 +01:00 Fixup severe build performance issues 2017-10-04 16:26:37 +02:00 Always generate entire commit changelog 2018-05-03 15:21:24 +02:00

libosmocore - set of Osmocom core libraries

This repository contains a set of C-language libraries that form the core infrastructure of many Osmocom Open Source Mobile Communications projects.

Historically, a lot of this code was developed as part of the OpenBSC project, but which are of a more generic nature and thus useful to (at least) other programs that we develop in the sphere of Free Software / Open Source mobile communications.

There is no clear scope of it. We simply move all shared code between the various Osmocom projects in this library to avoid code duplication.

The libosmcoore.git repository build multiple libraries:

  • libosmocore contains some general-purpose functions like select-loop abstraction, message buffers, timers, linked lists
  • libosmovty contains routines related to the interactive command-line interface called VTY
  • libosmogsm contains definitions and helper code related to GSM protocols
  • libosmoctrl contains a shared implementation of the Osmocom control interface
  • libosmogb contains an implementation of the Gb interface with its NS/BSSGP protocols
  • libosmocodec contains an implementation of GSM voice codecs
  • libosmocoding contains an implementation of GSM channel coding
  • libosmosim contains infrastructure to interface SIM/UICC/USIM cards
  • libosmotrau contains encoding/decoding functions for A-bis TRAU frames


The official homepage of the project is

GIT Repository

You can clone from the official libosmocore.git repository using

git clone git://

There is a cgit interface at


Doxygen-generated API documentation is generated during the build process, but also available online for each of the sub-libraries at

Mailing List

Discussions related to libosmocore are happening on the mailing list, please see for subscription options and the list archive.

Please observe the Osmocom Mailing List Rules when posting.


Our coding standards are described at

We us a gerrit based patch submission/review process for managing contributions. Please see for more details

The current patch queue for libosmocore can be seen at