Building |rti_me_h|
===================

.. highlight:: none

This section is for users already familiar with `CMake <https://cmake.org/>`_ and may have
built earlier versions of |rti_me|. The sections following describe the process
in detail and is recommended for everyone building |me|.

This section assumes that the |me| source-bundle is downloaded and installed and
that `CMake <https://cmake.org/>`_ is available.

1. Make sure `CMake <https://cmake.org/>`_ is in the path. 
2. Unix::

    cd <rti_me install directory>/src
    # you should see directories like doc/ lib/ rtiddsgen/ src/
    # and CMakeLists.txt

    resource/scripts/rtime-make --target self --name i86Linux4gcc7.3.0 \
                -G "Unix Makefiles" --build

   Windows::

    cd <rti_me install directory>\src
    # you should see directories like doc/ lib/ rtiddsgen/ src/
    # and CMakeLists.txt

    resource\scripts\rtime-make --target self --name i86Win32VS2015 \
                -G "NMake Makefiles" --build

3. The |rti_me| libraries are available in::

    # Unix
    <rti_me install directory>/lib/i86Linux4gcc7.3.0

    # Windows 
    <rti_me install directory>/lib/i86Win32VS2015

NOTE: ``rtime-make`` uses the platform specified with ``--name`` to determine a few
settings needed by |rti_me|. Please refer to :ref:`source-prepare` for details.

OpenSSL
.......

The |me| builtin security plugin requires OpenSSL 1.0.1 or a later 1.0.x
version, but is not compatible with 1.1 or later. The CMake build
files will try to locate a suitable version and use a locally installed
library if available. If a compatible library is not available, please
check the RTI Download portal for a compatible version of OpenSSL.
After installing OpenSSL, set OPENSSLHOME to its location when building.

::

    rtime-make -DOPENSSLHOME=<path>/release


.. _rl_nobuiltin:

Excluding the Security Plugin from the Build
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

It is possible to exclude the builtin security plugin in |me|
(the rti_me_seccore library). Set RTIME_TRUST_INCLUDE_BUILTIN to false to
disable it.

::

    rtime-make -DRTIME_TRUST_INCLUDE_BUILTIN=false

For help, use::

    resource\scripts\rtime-make --help

To list available targets use::

    resource\scripts\rtime-make --list

For help for a specific target, except self, use::

    resource\scripts\rtime-make --target <target> --help