Diagnostic Log and Trace - Installation ======================================== Alexander Wenzel Instructions for installing this software ----------------------------------------- The following packages need to be installed in order to be able to build and install DLT daemon: - cmake - zlib - dbus On Ubuntu those dependencies can be installed with the following command: - sudo apt-get install cmake zlib1g-dev libdbus-glib-1-dev To build and install the DLT daemon, follow these steps: - mkdir build - cd build - cmake .. - make - optional: sudo make install - optional: sudo ldconfig Compile options with default values ----------------------------------- [options="header"] |============================================================================================== | Option | Value | Comment | BUILD_SHARED_LIBS | ON | Set to OFF to build static libraries | WITH_SYSTEMD | OFF | Set to ON to run CMakeLists.txt in systemd | WITH_SYSTEMD_WATCHDOG | OFF | Set to ON to use the systemd watchdog in dlt-daemon | WITH_SYSTEMD_JOURNAL | OFF | Set to ON to use the systemd journal in dlt-system | WITH_DOC | OFF | Set to ON to build documentation target | WITH_MAN | ON | Set to OFF to skip building of man pages | WITH_CHECK_CONFIG_FILE | OFF | Set to ON to create a configure file of CheckIncludeFiles and CheckFunctionExists | WITH_TESTSCRIPTS | OFF | Set to ON to run CMakeLists.txt in test scripts | WITH_GPROF | OFF | Set \-pg to compile flags | WITH_DLTTEST | OFF | Set to ON to build with modifications to test User-Daemon communication with corrupt messages | WITH_DLT_SHM_ENABLE | OFF | Set to OFF to use FIFO as IPC from user to daemon | WITH_DLT_ADAPTOR | ON | Set to ON to build src/adaptor binaries | WITH_DLT_CONSOLE | ON | Set to ON to build src/console binaries | WITH_DLT_EXAMPLES | ON | Set to ON to build src/examples binaries | WITH_DLT_SYSTEM | ON | Set to ON to build src/system binaries | WITH_DLT_DBUS | ON | Set to ON to build src/dbus binaries | WITH_DLT_TESTS | ON | Set to ON to build src/test binaries | WITH_DLT_CXX11_EXT | OFF | Set to ON to build C++11 extensions | WITH_DLT_COREDUMPHANDLER | OFF | EXPERIMENTAL! Set to ON to build src/core_dump_handler binaries. EXPERIMENTAL | WITH_DLT_LOGSTORAGE_CTRL_UDEV | OFF | PROTOTYPE! Set to ON to build logstorage control application with udev support | WITH_DLT_LOGSTORAGE_CTRL_PROP | OFF | PROTOTYPE! Set to ON to build logstorage control application with proprietary support | WITH_DLT_USE_IPv6 | ON | Set to ON for IPv6 support | WITH_DLT_KPI | ON | Set to ON to build src/kpi binaries | CMAKE_INSTALL_PREFIX | /usr/local | | CMAKE_BUILD_TYPE | RelWithDebInfo | |============================================================================================== In order to change these options, you can modify these values with ccmake, do the appropriate changes in CmakeList.txt or via the commandline for cmake - Change a value with: cmake -D= - Example: cmake -DWITH_SYSTEMD=ON -DWITH_SYSTEMD_JOURNAL=ON -DCMAKE_INSTALL_PREFIX=/usr .. Create Man pages ---------------- The man pages are generated and installed during the standard build and install. After installation they are located in /share/man. The man pages are generated with asciidoc. If the man pages are changed the following command must be executed. ---- mkdir build cd build cmake -DWITH_DOC=ON .. make doc-man ---- The generated man pages overwrite the existing ones. Create manuals documentation ---------------------------- The manuals are generated with asciidoc. ---- mkdir build cd build cmake -DWITH_DOC=ON .. make doc-manuals ---- You will find the generated documents in build/doc/manuals. Create api documentation ------------------------ The API documentation is generated with doxygen. ---- mkdir build cd build cmake -DWITH_DOC=ON .. make doc ---- You will find the generated documents in build/doc/DOC_DLT. Generation of systemd unit files -------------------------------- DLT provides cmake files to create unit files for systemd. These can be found in the systemd directory. In systemd/CMakeLists.txt you can modify some values, e.g. the port for dlt-adaptor-udp. By default the generation of unit files with cmake is disabled. Please follow these steps to enable the generation: * Change into the root directory of DLT-daemon * mkdir build * cd build * cmake -DWITH_SYSTEMD=ON .. You find the generated unit files in build/systemd. They are installed in ${CMAKE_INSTALL_PREFIX}/lib/systemd/system when make install is run. Git configuration ----------------- It is important to set the name of the user and the email of the user for all git instances on the system: ---- git config --global user.name "Firstname Lastname" git config --global user.email "your_email@youremail.com" ---- If you are behind a proxy you have to set up the Git proxy configuration, e.g. ---- git config --global http.proxy $http_proxy ---- Checkout the code from the OSS Git repository. ---- git clone http://git.projects.genivi.org/dlt-daemon.git ---- Working on the code & contribution ---------------------------------- Get an overview of all branches: ---- git branch -a ---- Switch to the branch you want to work on (see versioning scheme, the master is the feature branch) and verify that it has switched. ---- git checkout git branch -a ---- Best practice is to create a local branch based on the remote branch: ---- git checkout -b ---- Start working, best practice is to commit smaller, compilable pieces during the work that makes it easier to handle later on. If you want to commit your changes, send them to the auto-dlt list, you can create a patch like this: ---- git format-patch -s ---- This creates a set of patches (one patch per commit) that shall be published via the mailing list. The patches will be discussed, merged & uploaded on the git. Please do not forget to document your changes: - write a manual for new components or adapt manuals to the changes you have made - in case you have added a new program please write a man page for it - if you have added something to the DLT API please remember to provide Doxygen comments Please add a header to the top of each new source file you provide: ---- /* * @licence app begin@ * SPDX license identifier: MPL-2.0 * * Copyright (C) 2011-2016, {COPYRIGHT_HOLDER} * * This file is part of GENIVI Project DLT - Diagnostic Log and Trace. * * This Source Code Form is subject to the terms of the * Mozilla Public License (MPL), v. 2.0. * If a copy of the MPL was not distributed with this file, * You can obtain one at http://mozilla.org/MPL/2.0/. * * For further information see http://www.genivi.org/. * @licence end@ */ /*! * \author {YOUR NAME } * * \copyright Copyright © 2011-2016 {COPYRIGHT_HOLDER}. \n * License MPL-2.0: Mozilla Public License version 2.0 http://mozilla.org/MPL/2.0/. * * \file {FILENAME} */` ----