scripts/lttng-tools/build.sh

   1 #!/bin/bash
   2 #
   3 # SPDX-FileCopyrightText: 2016 Jonathan Rajotte-Julien <jonathan.rajotte-julien@efficios.com>
   4 # SPDX-FileCopyrightText: 2016-2023 Michael Jeanson <mjeanson@efficios.com>
   5 # SPDX-License-Identifier: GPL-2.0-or-later
   6 #
   7 # shellcheck disable=SC2103
   8
   9 set -exu
  10
  11 # Version compare functions
  12 vercomp () {
  13     set +u
  14     if [[ "$1" == "$2" ]]; then
  15         return 0
  16     fi
  17     local IFS=.
  18     # Ignore the shellcheck warning, we want splitting to happen based on IFS.
  19     # shellcheck disable=SC2206
  20     local i ver1=($1) ver2=($2)
  21     # fill empty fields in ver1 with zeros
  22     for ((i=${#ver1[@]}; i<${#ver2[@]}; i++)); do
  23         ver1[i]=0
  24     done
  25     for ((i=0; i<${#ver1[@]}; i++)); do
  26         if [[ -z ${ver2[i]} ]]; then
  27             # fill empty fields in ver2 with zeros
  28             ver2[i]=0
  29         fi
  30         if ((10#${ver1[i]} > 10#${ver2[i]})); then
  31             return 1
  32         fi
  33         if ((10#${ver1[i]} < 10#${ver2[i]})); then
  34             return 2
  35         fi
  36     done
  37     set -u
  38     return 0
  39 }
  40
  41 verlte() {
  42     vercomp "$1" "$2"; local res="$?"
  43     [ "$res" -eq "0" ] || [ "$res" -eq "2" ]
  44 }
  45
  46 verlt() {
  47     vercomp "$1" "$2"; local res="$?"
  48     [ "$res" -eq "2" ]
  49 }
  50
  51 vergte() {
  52     vercomp "$1" "$2"; local res="$?"
  53     [ "$res" -eq "0" ] || [ "$res" -eq "1" ]
  54 }
  55
  56 vergt() {
  57     vercomp "$1" "$2"; local res="$?"
  58     [ "$res" -eq "1" ]
  59 }
  60
  61 verne() {
  62     vercomp "$1" "$2"; local res="$?"
  63     [ "$res" -ne "0" ]
  64 }
  65
  66 print_header() {
  67     set +x
  68
  69     local message=" $1 "
  70     local message_len
  71     local padding_len
  72
  73     message_len="${#message}"
  74     padding_len=$(( (80 - (message_len)) / 2 ))
  75
  76
  77     printf '\n'; printf -- '#%.0s' {1..80}; printf '\n'
  78     printf -- '-%.0s' {1..80}; printf '\n'
  79     printf -- '#%.0s' $(seq 1 $padding_len); printf '%s' "$message"; printf -- '#%.0s' $(seq 1 $padding_len); printf '\n'
  80     printf -- '-%.0s' {1..80}; printf '\n'
  81     printf -- '#%.0s' {1..80}; printf '\n\n'
  82
  83     set -x
  84 }
  85
  86 failed_configure() {
  87     # Assume we are in the configured build directory
  88     print_header "BEGIN config.log"
  89     cat config.log
  90     print_header "END config.log"
  91
  92     # End the build with failure
  93     exit 1
  94 }
  95
  96 set_execute_traversal_bit()
  97 {
  98     path=$1
  99
 100     level="$path"
 101     if [ ! -d "$path" ]; then
 102         fail "Path is not a directory"
 103     fi
 104     while level="$(dirname "$level")"
 105     do
 106         if [ "$level" = / ]; then
 107             break
 108         fi
 109         chmod a+x "$level"
 110     done
 111     chmod a+x "$path"
 112 }
 113
 114 print_header "LTTng-tools build script starting"
 115
 116 # Required variables
 117 WORKSPACE=${WORKSPACE:-}
 118
 119 # Axis
 120 platform=${platform:-}
 121 conf=${conf:-}
 122 build=${build:-}
 123 cc=${cc:-}
 124
 125 # Build steps that can be overriden by the environment
 126 LTTNG_TOOLS_MAKE_INSTALL="${LTTNG_TOOLS_MAKE_INSTALL:-yes}"
 127 LTTNG_TOOLS_MAKE_CLEAN="${LTTNG_TOOLS_MAKE_CLEAN:-yes}"
 128 LTTNG_TOOLS_GEN_COMPILE_COMMANDS="${LTTNG_TOOLS_GEN_COMPILE_COMMANDS:-no}"
 129 LTTNG_TOOLS_RUN_TESTS="${LTTNG_TOOLS_RUN_TESTS:-yes}"
 130 LTTNG_TOOLS_RUN_TESTS_LONG_REGRESSION="${LTTNG_TOOLS_RUN_TESTS_LONG_REGRESSION:-no}"
 131 LTTNG_TOOLS_CLANG_TIDY="${LTTNG_TOOLS_CLANG_TIDY:-no}"
 132
 133 SRCDIR="$WORKSPACE/src/lttng-tools"
 134 TAPDIR="$WORKSPACE/tap"
 135 PREFIX="/build"
 136 LIBDIR="lib"
 137 LIBDIR_ARCH="$LIBDIR"
 138
 139 # RHEL and SLES both use lib64 but don't bother shipping a default autoconf
 140 # site config that matches this.
 141 if [[ ( -f /etc/redhat-release || -f /etc/products.d/SLES.prod || -f /etc/yocto-release ) ]]; then
 142     # Detect the userspace bitness in a distro agnostic way
 143     if file -L /bin/bash | grep '64-bit' >/dev/null 2>&1; then
 144         LIBDIR_ARCH="${LIBDIR}64"
 145     fi
 146 fi
 147
 148 DEPS_INC="$WORKSPACE/deps/build/include"
 149 DEPS_LIB="$WORKSPACE/deps/build/$LIBDIR_ARCH"
 150 DEPS_PKGCONFIG="$DEPS_LIB/pkgconfig"
 151 DEPS_BIN="$WORKSPACE/deps/build/bin"
 152 DEPS_JAVA="$WORKSPACE/deps/build/share/java"
 153
 154 export PATH="$DEPS_BIN:$PATH"
 155 export LD_LIBRARY_PATH="$DEPS_LIB:${LD_LIBRARY_PATH:-}"
 156 export PKG_CONFIG_PATH="$DEPS_PKGCONFIG"
 157 export CPPFLAGS="-I$DEPS_INC"
 158 export LDFLAGS="-L$DEPS_LIB"
 159
 160 exit_status=0
 161
 162 # Use bear to generate compile_commands.json when enabled
 163 BEAR=""
 164 if [ "$LTTNG_TOOLS_GEN_COMPILE_COMMANDS" = "yes" ]; then
 165         BEAR="bear"
 166 fi
 167
 168 # Create tmp directory
 169 TMPDIR="$WORKSPACE/tmp"
 170 mkdir -p "$TMPDIR"
 171
 172 # Use a symlink in /tmp to point to the the tmp directory
 173 # inside the workspace, this is to work around the path length
 174 # limit of unix sockets which are created by the test suite.
 175 tmpdir="$(mktemp)"
 176 ln -sf "$TMPDIR" "$tmpdir"
 177 export TMPDIR="$tmpdir"
 178
 179 # Create a symlink to "babeltrace" when the "babeltrace2" executable is found.
 180 # This is a temporary workaround until lttng-tools either allows the override of
 181 # the trace reader in its test suite or that we move to only supporting
 182 # babeltrace2
 183 if [ -x "$DEPS_BIN/babeltrace2" ]; then
 184     ln -s "$DEPS_BIN/babeltrace2" "$DEPS_BIN/babeltrace"
 185 fi
 186
 187 # When using babeltrace2 make sure that it finds its plugins and
 188 # plugin-providers.
 189 export BABELTRACE_PLUGIN_PATH="$DEPS_LIB/babeltrace2/plugins/"
 190 export LIBBABELTRACE2_PLUGIN_PROVIDER_DIR="$DEPS_LIB/babeltrace2/plugin-providers/"
 191
 192 export CFLAGS="-g -O2"
 193 export CXXFLAGS="-g -O2"
 194
 195 # Set compiler variables
 196 case "$cc" in
 197 gcc)
 198     export CC=gcc
 199     export CXX=g++
 200     ;;
 201 gcc-*)
 202     export CC=gcc-${cc#gcc-}
 203     export CXX=g++-${cc#gcc-}
 204     ;;
 205 clang)
 206     export CC=clang
 207     export CXX=clang++
 208     ;;
 209 clang-*)
 210     export CC=clang-${cc#clang-}
 211     export CXX=clang++-${cc#clang-}
 212     ;;
 213 *)
 214     if [ "x$cc" != "x" ]; then
 215             export CC="$cc"
 216     fi
 217     ;;
 218 esac
 219
 220 # Set platform variables
 221 case "$platform" in
 222 macos*)
 223     export MAKE=make
 224     export TAR=tar
 225     export NPROC="getconf _NPROCESSORS_ONLN"
 226     export PATH="/opt/local/bin:/opt/local/sbin:$PATH"
 227     export CPPFLAGS="-I/opt/local/include $CPPFLAGS"
 228     export LDFLAGS="-L/opt/local/lib $LDFLAGS"
 229     export PYTHON="python3"
 230     export PYTHON_CONFIG="python3-config"
 231
 232     LTTNG_TOOLS_RUN_TESTS="no"
 233     LTTNG_TOOLS_RUN_TESTS_LONG_REGRESSION="no"
 234     ;;
 235
 236 cygwin|cygwin64|msys32|msys64)
 237     export MAKE=make
 238     export TAR=tar
 239     export NPROC=nproc
 240
 241     LTTNG_TOOLS_RUN_TESTS="no"
 242     LTTNG_TOOLS_RUN_TESTS_LONG_REGRESSION="no"
 243     ;;
 244
 245 *)
 246     export MAKE=make
 247     export TAR=tar
 248     export NPROC=nproc
 249
 250     PYTHON2=python2
 251     PYTHON3=python3
 252
 253     if command -v $PYTHON2 >/dev/null 2>&1; then
 254         P2_VERSION=$($PYTHON2 -c 'import sys;v = sys.version.split()[0].split("."); print("{}.{}".format(v[0], v[1]))')
 255         DEPS_PYTHON2="$WORKSPACE/deps/build/$LIBDIR/python$P2_VERSION/site-packages"
 256         if [ "$LIBDIR" != "$LIBDIR_ARCH" ]; then
 257             DEPS_PYTHON2="$DEPS_PYTHON2:$WORKSPACE/deps/build/$LIBDIR_ARCH/python$P2_VERSION/site-packages"
 258         fi
 259     fi
 260
 261     P3_VERSION=$($PYTHON3 -c 'import sys;v = sys.version.split()[0].split("."); print("{}.{}".format(v[0], v[1]))')
 262     DEPS_PYTHON3="$WORKSPACE/deps/build/$LIBDIR/python$P3_VERSION/site-packages"
 263     if [ "$LIBDIR" != "$LIBDIR_ARCH" ]; then
 264         DEPS_PYTHON3="$DEPS_PYTHON3:$WORKSPACE/deps/build/$LIBDIR_ARCH/python$P3_VERSION/site-packages"
 265     fi
 266
 267     # Most build configs require access to the babeltrace 2 python bindings.
 268     # This also makes the lttngust python agent available for `agents` builds.
 269     export PYTHONPATH="${DEPS_PYTHON2:-}${DEPS_PYTHON2:+:}$DEPS_PYTHON3"
 270     ;;
 271 esac
 272
 273 # Some warning flags are very dumb in GCC 4.8 on SLES12 / EL7, disable them
 274 # even if they are available.
 275 if [[ $platform = sles12sp5* ]] || [[  $platform = el7* ]]; then
 276     CFLAGS="$CFLAGS -Wno-missing-field-initializers -Wno-shadow"
 277     CXXFLAGS="$CXXFLAGS -Wno-missing-field-initializers -Wno-shadow"
 278 fi
 279
 280 # If we have modules, build them
 281 if [ -d "$WORKSPACE/src/lttng-modules" ]; then
 282     print_header "Build and install LTTng-modules"
 283     cd "$WORKSPACE/src/lttng-modules"
 284     $MAKE -j"$($NPROC)" V=1
 285     $MAKE modules_install V=1
 286     depmod
 287 fi
 288
 289 # Print build env details
 290 print_header "Build environment details"
 291 print_os || true
 292 print_tooling || true
 293
 294 # Enter the source directory
 295 cd "$SRCDIR"
 296
 297 # Run bootstrap in the source directory prior to configure
 298 print_header "Bootstrap autotools"
 299 ./bootstrap
 300
 301 # Get source version from configure script
 302 eval "$(grep '^PACKAGE_VERSION=' ./configure)"
 303 PACKAGE_VERSION=${PACKAGE_VERSION//\-pre*/}
 304
 305 CONF_OPTS=("--prefix=$PREFIX" "--libdir=$PREFIX/$LIBDIR_ARCH" "--disable-maintainer-mode")
 306 DIST_CONF_OPTS=("--disable-maintainer-mode")
 307
 308 # Set configure options and environment variables for each build
 309 # configuration.
 310 case "$conf" in
 311 static)
 312     print_header "Conf: Static lib only"
 313
 314     CONF_OPTS+=("--enable-static" "--disable-shared" "--enable-python-bindings")
 315     ;;
 316
 317 no-ust)
 318     print_header "Conf: Without UST support"
 319
 320     CONF_OPTS+=("--without-lttng-ust")
 321     DIST_CONF_OPTS+=("--without-lttng-ust")
 322     ;;
 323
 324 agents)
 325     print_header "Conf: Java and Python agents"
 326
 327     export JAVA_HOME="/usr/lib/jvm/default-java"
 328     export CLASSPATH="$DEPS_JAVA/lttng-ust-agent-all.jar:/usr/share/java/log4j-api.jar:/usr/share/java/log4j-core.jar:/usr/share/java/log4j-1.2.jar"
 329
 330     CONF_OPTS+=("--enable-python-bindings" "--enable-test-java-agent-all")
 331
 332     # Explicitly add '--enable-test-java-agent-log4j2', it's not part of '-all' in stable 2.12/2.13
 333     if verlt "$PACKAGE_VERSION" "2.14"; then
 334         CONF_OPTS+=("--enable-test-java-agent-log4j2")
 335     fi
 336
 337     # Some distros don't ship python2 anymore
 338     if command -v $PYTHON2 >/dev/null 2>&1; then
 339         CONF_OPTS+=("--enable-test-python-agent-all")
 340     else
 341         CONF_OPTS+=("--enable-test-python3-agent")
 342     fi
 343     ;;
 344
 345 relayd-only)
 346     print_header "Conf: Relayd only"
 347
 348     CONF_OPTS+=("--disable-bin-lttng" "--disable-bin-lttng-consumerd" "--disable-bin-lttng-crash" "--disable-bin-lttng-sessiond" "--disable-extras" "--disable-man-pages" "--without-lttng-ust")
 349     ;;
 350
 351 debug-rcu)
 352     print_header "Conf: RCU sanity checks for debugging"
 353
 354     CONF_OPTS+=("--enable-python-bindings")
 355
 356     export CPPFLAGS="$CPPFLAGS -DDEBUG_RCU"
 357     ;;
 358
 359 *)
 360     print_header "Conf: Standard"
 361
 362     CONF_OPTS+=("--enable-python-bindings")
 363
 364     # Something is broken in docbook-xml on yocto
 365     if [[ "$platform" = yocto* ]]; then
 366         CONF_OPTS+=("--disable-man-pages")
 367     fi
 368     ;;
 369 esac
 370
 371 # Build type
 372 # oot     : out-of-tree build
 373 # dist    : build via make dist
 374 # oot-dist: build via make dist out-of-tree
 375 # *       : normal tree build
 376 #
 377 # Make sure to move to the build directory and run configure
 378 # before continuing.
 379 case "$build" in
 380 oot)
 381     print_header "Build: Out of tree"
 382
 383     # Create and enter a temporary build directory
 384     builddir=$(mktemp -d)
 385     cd "$builddir"
 386
 387     "$SRCDIR/configure" "${CONF_OPTS[@]}" || failed_configure
 388     ;;
 389
 390 dist)
 391     print_header "Build: Distribution in-tree"
 392
 393     # Run configure and generate the tar file
 394     # in the source directory
 395
 396     ./configure "${DIST_CONF_OPTS[@]}" || failed_configure
 397     $MAKE dist
 398
 399     # Create and enter a temporary build directory
 400     builddir=$(mktemp -d)
 401     cd "$builddir"
 402
 403     # Extract the distribution tar in the build directory,
 404     # ignore the first directory level
 405     $TAR xvf "$SRCDIR"/*.tar.* --strip 1
 406
 407     # Build in extracted source tree
 408     ./configure "${CONF_OPTS[@]}" || failed_configure
 409     ;;
 410
 411 oot-dist)
 412     print_header "Build: Distribution Out of tree"
 413
 414     # Create and enter a temporary build directory
 415     builddir=$(mktemp -d)
 416     cd "$builddir"
 417
 418     # Run configure out of tree and generate the tar file
 419     "$SRCDIR/configure" "${DIST_CONF_OPTS[@]}" || failed_configure
 420     $MAKE dist
 421
 422     dist_srcdir="$(mktemp -d)"
 423     cd "$dist_srcdir"
 424
 425     # Extract the distribution tar in the new source directory,
 426     # ignore the first directory level
 427     $TAR xvf "$builddir"/*.tar.* --strip 1
 428
 429     # Create and enter a second temporary build directory
 430     builddir="$(mktemp -d)"
 431     cd "$builddir"
 432
 433     # Run configure from the extracted distribution tar,
 434     # out of the source tree
 435     "$dist_srcdir/configure" "${CONF_OPTS[@]}" || failed_configure
 436     ;;
 437
 438 *)
 439     print_header "Build: Standard In-tree"
 440     ./configure "${CONF_OPTS[@]}" || failed_configure
 441     ;;
 442 esac
 443
 444 # We are now inside a configured build directory
 445
 446 # BUILD!
 447 print_header "BUILD!"
 448 $BEAR ${BEAR:+--} $MAKE -j "$($NPROC)" V=1
 449
 450 # Install in the workspace if enabled
 451 if [ "$LTTNG_TOOLS_MAKE_INSTALL" = "yes" ]; then
 452     print_header "Install"
 453
 454     $MAKE install V=1 DESTDIR="$WORKSPACE"
 455
 456     # Cleanup rpath in executables
 457     find "$WORKSPACE/$PREFIX/bin" -type f -perm -0500 -exec chrpath --delete {} \;
 458
 459     # Some configs don't build liblttng-ctl
 460     if [ -d "$WORKSPACE/$PREFIX/$LIBDIR_ARCH" ]; then
 461         # Cleanup rpath in shared libraries
 462         find "$WORKSPACE/$PREFIX/$LIBDIR_ARCH" -name "*.so" -exec chrpath --delete {} \;
 463         # Remove libtool .la files
 464         find "$WORKSPACE/$PREFIX/$LIBDIR_ARCH" -name "*.la" -delete
 465     fi
 466 fi
 467
 468 # Run clang-tidy on the topmost commit
 469 if [ "$LTTNG_TOOLS_CLANG_TIDY" = "yes" ]; then
 470     print_header "Run clang-tidy"
 471
 472     # This would be better by linting only the lines touched by a patch but it
 473     # doesn't seem to work, the lines are always filtered and no error is
 474     # reported.
 475     #git diff -U0 HEAD^ | clang-tidy-diff -p1 -j "$($NPROC)" -timeout 60 -fix
 476
 477     # Instead, run clan-tidy on all the files touched by the patch.
 478     while read -r filepath; do
 479         if [[ "$filepath" =~ (\.cpp|\.hhp|\.c|\.h)$ ]]; then
 480             clang-tidy --fix-errors "$(realpath "$filepath")"
 481         fi
 482     done < <(git diff-tree --no-commit-id --diff-filter=d --name-only -r HEAD)
 483
 484     # If the tree has local changes, the formatting was incorrect
 485     GIT_DIFF_OUTPUT=$(git diff)
 486     if [ -n "$GIT_DIFF_OUTPUT" ]; then
 487         echo "Saving clang-tidy proposed fixes in clang-tidy-fixes.diff"
 488         git diff > "$WORKSPACE/clang-tidy-fixes.diff"
 489
 490         # Restore the unfixed files so they can be viewed in the warnings web
 491         # interface
 492         git checkout .
 493         exit_status=1
 494     fi
 495 fi
 496
 497 # Run tests for all configs except 'no-ust'
 498 if [ "$LTTNG_TOOLS_RUN_TESTS" = "yes" ] && [ "$conf" != "no-ust" ]; then
 499     print_header "Run test suite"
 500
 501     # Allow core dumps
 502     ulimit -c unlimited
 503
 504     # Force the lttng-sessiond path to /bin/true to prevent the spawing of a
 505     # lttng-sessiond --daemonize on "lttng create"
 506     export LTTNG_SESSIOND_PATH="/bin/true"
 507
 508     # It is implied that tests depending on LTTNG_ENABLE_DESTRUCTIVE_TESTS
 509     # only run for the root user. Note that here `destructive` means that
 510     # operations are performed at the host level (add user etc.) that
 511     # effectively modify the host. Running those tests are acceptable on our
 512     # CI and root jobs since we always run root tests against a `snapshot`
 513     # of the host.
 514     if [ "$(id -u)" == "0" ]; then
 515         # Allow the traversal of all directories leading to the
 516         # DEPS_LIBS directory to enable test app run by temp users to
 517         # access lttng-ust.
 518         set_execute_traversal_bit "$DEPS_LIB"
 519         # Allow `all` to interact with all deps libs.
 520         chmod a+rwx -R "$DEPS_LIB"
 521
 522         export LTTNG_ENABLE_DESTRUCTIVE_TESTS="will-break-my-system"
 523
 524         # Some destructive tests play with the system clock, disable timesyncd
 525         systemctl stop systemd-timesyncd.service || true
 526     fi
 527
 528     make --keep-going check || exit_status=1
 529
 530     # Copy tap logs for the jenkins tap parser before cleaning the build dir
 531     rsync -a --exclude 'test-suite.log' --include '*/' --include '*.log' --exclude='*' tests/ "$TAPDIR"
 532
 533     # Copy the test suites top-level log which includes all tests failures
 534     rsync -a --include 'test-suite.log' --include '*/' --exclude='*' tests/ "$WORKSPACE/log"
 535
 536     if [ "$LTTNG_TOOLS_RUN_TESTS_LONG_REGRESSION" = "yes" ]; then
 537         print_header "Run long regression tests"
 538         cd tests
 539         mkdir -p "$TAPDIR/long_regression"
 540         prove --merge -v --exec '' - < long_regression --archive "$TAPDIR/long_regression/" || exit_status=1
 541         cd ..
 542     fi
 543 fi
 544
 545 if [ "$LTTNG_TOOLS_RUN_TESTS" = "yes" ] && [ "$conf" = "no-ust" ]; then
 546     # The TAP plugin will fail the job if no test logs are present
 547     mkdir -p "$TAPDIR/no-tests"
 548     echo "1..1" > "$TAPDIR/no-tests/tests.log"
 549     echo "ok 1 - Test suite disabled" >> "$TAPDIR/no-tests/tests.log"
 550 fi
 551
 552 # Clean the build directory
 553 if [ "$LTTNG_TOOLS_MAKE_CLEAN" = "yes" ]; then
 554     print_header "Clean"
 555     $MAKE clean
 556 fi
 557
 558 print_header "LTTng-tools build script ended with: $(test $exit_status == 0 && echo SUCCESS || echo FAILURE)"
 559
 560 # Exit with failure if any of the tests failed
 561 exit $exit_status
 562
 563 # EOF
 564 # vim: expandtab tabstop=4 shiftwidth=4