Introduction

GNU Bayonne, the telephony server of GNU Telephony and the GNU Project, offers free, scalable, media-independent software environment for development and deployment of telephony solutions for use with current and next generation telephone networks.

GNU Bayonne 1 and 2

Bayonne 1 was developed from ACS, and dates back to 1998. Bayonne 2 was developed starting in 2005, with a special focus on SIP. Bayonne is an integral part of GNU Telephony.

In 2017, the latest stable release of the Bayonne2 server is 2.3.2. An API-only version (2.99+3.0apionly) that includes ccAudio and ccScript is also available.

BayonneXML and Web services

BayonneXML allows GNU Bayonne servers to query and process call sessions under the control of web-served documents. I see XML documents as the way to enable common publishing and presentation of documents, whether on the web for browsers in XHTML, for editing through ODT, for the visually impaired in DAISY, and voiceXML and/or BayonneXML for presentation to telephone callers. Produce once and distribute everywhere.

Bayonne2 web services provide a model both for system management and for integrating Bayonne with other application services. Initially, I have introduced several HTML status pages which automatically refresh, and hence can be used to monitor the server, as well as a new XML dialect, serverResponse, which allows one to send a GET request to known URI's, with optional query arguments, and retrieve an XML response document which is simpler than the POST-driven XMLRPC reply system. In the future, I will also be adding XMLRPC to Bayonne web services. The existing web service also needs support for authentication.

Bayonne web services make it possible to telephony-enable other existing web services, or to create telephony-enabled applications using common scripting languages. Along with the existing Bayonne::Libexec.pm module, and similar modules for Python, Java, C#, and PHP that also exist, I will be writing a Bayonne::Webservice.pm (and Bayonne::xmlrpc.pm) module for different scripting languages to future Bayonne distributions, to make it easier to write such applications that integrate with Bayonne.

Downloading

Current releases of GNU Bayonne 1 and 2 are found on the GNU FTP site or one of its mirrors. Please use a nearby mirror if you can.

GNU Bayonne may be available from other sites in various package formats, including GNU/Linux RPM and Debian packages, .pkg files under various Unix operating systems, etc. I do encourage people to distribute GNU Bayonne in a package form where convenient for installation, so long as source is also made available.

For other packages that you may need to set up your installation, please refer to the GNU Telephony Download page.

Documentation

Programmers' manuals

• Reference manuals
  • Bayonne 3 API, generated from header and source files of bayonne-2.99+3.0apionly. The complete framework also includes uCommon;
  • Common C++ 2 / Bayonne 2 Framework, generated from the header files of Common C++ 2 (1.3.11), Bayonne 2 (2.3.2), ccScript 3 (1.1.7), ccAudio 2 (2.2.0), ccRTP (1.7.2) and libzrtpcpp (2.3.4);
  • GNU Telephony class framework — 2010, based on uCommon (archived);
  • GNU Bayonne / Common C++ class framework — 2007 (archived).
• Specification
  • ServerResponse Specification

User manuals

• Bayonne 2 Server
  • Bayonne 2 Installation Guide, in HTML, PDF, and LaTeX formats;
  • Scripting Guide (4th edition), in HTML, PDF, and LaTeX formats;
  • Bayonne2 FAQ;
  • Using Bayonne 2 SIP;
  • BayonneXML.
• Bayonne 1 Server
  • Installation Guide;
  • Administration Guide;
  • Scripting Guide;
  • Scripting Examples.

Participating

As the current GNU Bayonne maintainer, I am very open to bringing new ideas and code into GNU Bayonne. In particular, I am looking for help with documentation and additional voice libraries. The source code repositories can be accessed anonymously through the Bayonne project on Savannah. I would be happy to receive and evaluate patches for inclusion in future releases.

The Bayonne mailing list is <[email protected]>. It has a web interface for subscribing, modifying subscription options and searching the list archives. Feel free to send any bug reports, patches, and questions to this list.

---

This page was retrieved from the Wayback Machine archive of the GNU Telephony website (licensed under the Free Documentation License 1.3), and slightly edited.