BIP Compiler

1 2

 Installation

The BIP tools provided here consist of a compiler for generating code from BIP sources, and an execution engine used as a scheduler for executing the generated code. We currently target C++ code generation, but the tool-chain allows the use of multiple backends at the same time.

Notice that these tools are only provided for GNU/Linux systems. They are known to work correctly on Mac OSX, and probably other Unices, but we do not support them currently. Please contact us for specific installations.

The compiler requires Java VM, version 6. For compiling the generated C++ code, you also need a standard C++ compiler with support for the STL, and C++0x for the optimized engine and C++11 for the multithread engine. We strongly recommend to use the GNU compiler g++ version 4.8 or above (GCC). The compilation of the generated code needs also CMake.

If you use Ubuntu 14.04 LTS, to install all the dependencies required for the compiler you simply need to install packets default-jre, g++, cmake, e.g. using the following command in a terminal:

  $ sudo apt-get install default-jre g++ cmake

Quick install

Download the archive corresponding to the latest version of BIP, and matching your platform:

• compiler + engines for x86 machines
• compiler + engines for x86 64 bits machines

Extract it and source the ’setup.sh’ located at the root of the archive.

Check the corresponding section in the documentation for more details.

Separate archives

If you can’t use the quick install, you can still download and install separate archives corresponding to the latest version of BIP:

• Compiler: Download the archive containing the compiler here. Follow the installation instruction of the compiler.
• Engines: Download also the archive containing the engine using the correct link matching your platform and your needs (see also installation instruction):
  • reference engine x86 machines / x86 64 bits machines
  • optimized engine x86 machines / x86 64 bits machines
  • multithread engine x86 machines / x86 64 bits machines

Try Hello World Example

Once the BIP tools are correctly installed, you can try the Hello World example of provided in the BIP tutorial. Instruction for compiling this example can be found using the following link: Hello World.

All tutorial’s examples can be downloaded following this link.

 Documentation

A full documentation for the BIP tools and language is available using the following links. Notice that the revision number of the documentation is different from the one of the tools (i.e. RC6.1 instead of RC6) since it was fixed recently (more information about revisions).

• as HTML
• as PDF
• as PDF minibook.

This documentation contains:

• a description of the BIP2 language (syntax and semantics)
• installation instructions for both the compiler and the reference BIP engine used for executing C++ code
• a tutorial illustrating the main features of the language.

 Notes about revisions

More information about the revisions of the BIP compiler and engines can be found here.

 Contacts

Please feel free to report bugs, problems, comments to: Jacques Combaz.

If you need to report a bug, please include (if possible) all the source files and a log of everything (compilation warnings/errors, execution trace, ...).

Former developers: Anakreontas Mentis, Marc Poulhiès

1 2