Common library for all Osmocom projects (libosmocore, libosmogsm, libosmovty, libosmogb, libosmosim, libosmousb, ...) https://osmocom.org/projects/libosmocore
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Harald Welte 220fa74016 Add a README file for some background information about this repo 6 years ago
contrib contrib: add script to find unterminated value_string arrays 6 years ago
debian libosmocoding: fix .deb building 6 years ago
doc OAP:remove design doc. osmocom-authn-protocol.txt 6 years ago
include add gsm48_pdisc_msgtype_name() 6 years ago
m4 Create a dummy m4 directory to make autoreconf --install --force work 13 years ago
src add gsm48_pdisc_msgtype_name() 6 years ago
tests ctrl_type_vals: explicitly terminate 6 years ago
utils osmo_auth_gen_vec: UMTS auth: store last used SQN, not next 6 years ago
.gitignore libosmocoding: migrate transcoding routines from OsmoBTS 6 years ago
.gitreview add .gitreview 7 years ago
.mailmap Add .mailmap file for mapping mail addresses in shortlog 6 years ago
COPYING add GPL to project source 13 years ago
Doxyfile.codec.in Doxygen: enable tagfile generation and usage for cross-project references 7 years ago
Doxyfile.coding.in libosmocoding: migrate transcoding routines from OsmoBTS 6 years ago
Doxyfile.core.in Doxygen: enable tagfile generation and usage for cross-project references 7 years ago
Doxyfile.gsm.in Doxygen: exclude osmocom/core/gsm/protocol/* 6 years ago
Doxyfile.vty.in Doxygen: enable tagfile generation and usage for cross-project references 7 years ago
Makefile.am Add a README file for some background information about this repo 6 years ago
README.md Add a README file for some background information about this repo 6 years ago
TODO-RELEASE GSUP, OAP, osmo-gen-vec: fix AUTS length to 14, not 16 6 years ago
configure.ac libosmocoding: migrate transcoding routines from OsmoBTS 6 years ago
git-version-gen add git-version-gen magic to automatically generate package version 13 years ago
libosmocodec.pc.in codec: Add the missing bits for include to install and pkgconfig to work 12 years ago
libosmocoding.pc.in libosmocoding: migrate transcoding routines from OsmoBTS 6 years ago
libosmocore.pc.in talloc: Untested change to unbreak build 7 years ago
libosmoctrl.pc.in remove our internal copy of talloc, use system libtalloc 7 years ago
libosmogb.pc.in remove our internal copy of talloc, use system libtalloc 7 years ago
libosmogsm.pc.in remove our internal copy of talloc, use system libtalloc 7 years ago
libosmosim.pc.in remove our internal copy of talloc, use system libtalloc 7 years ago
libosmovty.pc.in remove our internal copy of talloc, use system libtalloc 7 years ago

README.md

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

Homepage

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

GIT Repository

You can clone from the official libosmocore.git repository using

git clone git://git.osmocom.org/libosmocore.git

There is a cgit interface at http://git.osmocom.org/libosmocore/

Documentation

Doxygen-generated API documentation is generated during the build process, but also available online for each of the sub-libraries at http://ftp.osmocom.org/api/latest/libosmocore/

Mailing List

Discussions related to libosmocore 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 libosmocore can be seen at https://gerrit.osmocom.org/#/q/project:libosmocore+status:open