Add a README file for some background information about this repo

Let's add some general information about this repository, links to
redmine, gerrit, the mailing list, etc.

Change-Id: If034c6f551ff9bfaff0b8368fd0963f3147155b9
Harald Welte 2017-03-16 15:28:17 +01:00
parent 00ab9ed6e2
commit 220fa74016
2 changed files with 81 additions and 1 deletions

View File

@ -13,7 +13,7 @@ $(top_srcdir)/.version:
echo $(VERSION) > $(distdir)/.tarball-version
EXTRA_DIST = git-version-gen .version
EXTRA_DIST = git-version-gen .version

80 Normal file
View File

@ -0,0 +1,80 @@
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
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
* **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
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