Belle-sip

June 24, 2025 · View on GitHub

CAUTION: this git repository is no longer updated. The project has been merged into the linphone-sdk (Gitlab, Github) git repository and will continue his life there.

Versions up to 5.4 (included) are still kept into this repository, that will remain active on 'release/5.4' branch until the end of life of release 5.4.

pipeline status

Belle-sip

Overview

Belle-sip is a modern library implementing SIP (RFC3261) transport, transaction and dialog layers. It is written in C, with an object oriented API. It also comprises a simple HTTP/HTTPS client implementation.

License

Copyright © Belledonne Communications

Belle-sip is dual licensed, and is available either :

  • under a GNU/GPLv3 license, for free (open source). Please make sure that you understand and agree with the terms of this license before using it (see LICENSE.txt file for details).

  • under a proprietary license, for a fee, to be used in closed source applications. Contact Belledonne Communications for any question about costs and services.

Features

  • RFC3261 compliant implementation of SIP parser, writer, transactions and dialog layers.
  • SIP transaction state machines with lastest updates (RFC6026).
  • fully asynchronous transport layer (UDP, TCP, TLS), comprising DNS resolver (SRV, A, AAAA).
  • full dual-stack IPv6 support.
  • automatic management of request refreshes with network disconnection resiliency thanks to the "refresher" object.
  • supported platforms: Linux, Mac OSX, Windows, iOS, Android
  • HTTP/HTTPS client implementation.

Dependencies

Runtime dependencies

Building belle-sip with CMake

cmake .
make
make install

Build options

  • CMAKE_INSTALL_PREFIX=<string> : install prefix.
  • CMAKE_PREFIX_PATH=<string> : column-separated list of prefixes where to find dependencies.
  • ENABLE_STRICT=NO : build without strict build options like -Wall -Werror
  • ENABLE_UNIT_TESTS=NO : disable non-regression tests.

Note for packagers

Our CMake scripts may automatically add some paths into research paths of generated binaries. To ensure that the installed binaries are striped of any rpath, use -DCMAKE_SKIP_INSTALL_RPATH=ON while you invoke cmake.

Rpm packaging belle-sip can be generated with cmake3 using the following command: mkdir WORK cd WORK cmake3 ../ make package_source rpmbuild -ta --clean --rmsource --rmspec belle-sip--.tar.gz