使用CMake和嵌入式目标的clang-tidy

Question

本文旨在帮助开发使用C++的嵌入式系统的人们捕捉一些bug。作为其中的一部分，我正在尝试让clang-tidy在小型嵌入式目标上工作。

我正在尝试设置CMake以执行以下操作：

1. 在构建时运行clang tidy；然后
2. 使用GCC 8.2进行编译

然而，clang-tidy失败并显示“未知目标CPU'armv6-m'”

--

我使用的CMake脚本如下：

ClangTidy.cmake

set(ENABLE_CLANG_TIDY ON CACHE BOOL "Add clang-tidy automatically to builds")
if (ENABLE_CLANG_TIDY)
    find_program(CLANG_TIDY_EXE NAMES "C:\\Program Files\\LLVM\\bin\\clang-tidy.exe")
    if (CLANG_TIDY_EXE)
        message(STATUS "clang-tidy found: ${CLANG_TIDY_EXE}")
        set(CLANG_TIDY_CHECKS "-*,modernize-*")
        set(CMAKE_CXX_CLANG_TIDY "${CLANG_TIDY_EXE};-checks=${CLANG_TIDY_CHECKS};-header-filter='${CMAKE_SOURCE_DIR}/*'"
        CACHE STRING "" FORCE)
    else()
        message(AUTHOR_WARNING "clang-tidy not found!")
        set(CMAKE_CXX_CLANG_TIDY "" CACHE STRING "" FORCE) # delete it
    endif()
endif()

armv6-m是CMake脚本的一部分，但仅用于GCC，以下是用于设置GCC标志的内容：

set(TARGET STM32F070x6)
set(ARCH armv6-m)
set(CORE cortex-m0)
set(CMAKE_CXX_FLAGS "-march=${ARCH} -mcpu=${CORE} -D${TARGET}")

接下来进行以下构建：

#
# Including extra cmake rules
include(cmake/ClangTidy.cmake)

#Compile and link the exe :)
add_executable(${TARGET}.elf ${MAIN_SOURCE})

#Print the size of the .hex
add_custom_target(size ALL arm-none-eabi-size ${TARGET}.elf DEPENDS ${TARGET}.elf)
add_custom_target(${TARGET}.bin ALL DEPENDS ${TARGET}.elf COMMAND ${CMAKE_OBJCOPY} -Obinary ${TARGET}.elf ${TARGET}.bin)

cmake构建后的生成构建消息为:

[build] "C:\Program Files\CMake\bin\cmake.exe" -E __run_co_compile 
--tidy="C:/Program Files/LLVM/bin/clang-tidy.exe;-checks=-*,modernize-*;-header-filter='G:/Files/Git/projectname/*'" --source=../src/main.cpp 
-- C:\PROGRA~2\GNUTOO~1\82018-~1\bin\AR10B2~1.EXE  -DHSE_VALUE=48000000 -DSTM32F070x6 -DTRACE -DUSE_STDPERIPH_DRIVER -I../include -I../system -I../library -I../library/usb -I../library/usb/HID -I../library/usb/LL -I../library/usb/Standard -I../library/usb/Types -I../library/common -I../library/common/SCPI -I../library/common/containers -I../library/peripherals -I../library/peripherals/Bitbanging -I../st-library/include -I../st-library/include/arm -I../st-library/include/cmsis -I../st-library/include/cortexm -I../st-library/include/diag -I../st-library/include/stm32f0-stdperiph -march=armv6-m -mcpu=cortex-m0 -DSTM32F070x6 -Os -mthumb -g2 -ggdb -pedantic -Wall -Wextra -Wfloat-equal -Wshadow -Wall -Wl,--gc-sections -fmessage-length=0 -ffunction-sections -fdata-sections -ffreestanding -fno-builtin -std=c++1z -fno-rtti -fno-exceptions -fno-use-cxa-atexit -fno-threadsafe-statics -ftemplate-backtrace-limit=0 -O2 -g -DNDEBUG -MD -MT CMakeFiles/STM32F070x6.elf.dir/src/main.cpp.obj -MF CMakeFiles\STM32F070x6.elf.dir\src\main.cpp.obj.d -o CMakeFiles/STM32F070x6.elf.dir/src/main.cpp.obj -c ../src/main.cpp

在上述错误发生后立即进行以下操作：

[build] error: unknown target CPU 'armv6-m' [clang-diagnostic-error]
[build] note: valid target CPU values are: nocona, core2, penryn, bonnell, atom, silvermont, slm, goldmont, goldmont-plus, tremont, nehalem, corei7, westmere, sandybridge, corei7-avx, ivybridge, core-avx-i, haswell, core-avx2, broadwell, skylake, skylake-avx512, skx, cascadelake, cannonlake, icelake-client, icelake-server, knl, knm, k8, athlon64, athlon-fx, opteron, k8-sse3, athlon64-sse3, opteron-sse3, amdfam10, barcelona, btver1, btver2, bdver1, bdver2, bdver3, bdver4, znver1, x86-64

目标（armv6-m）字段似乎与GCC使用的相同。但我不确定为什么会带有target字段来调用clang-tidy。

- David Ledger

---

你找到解决方案了吗？我这里也遇到了同样的问题。 - Pavel Kirienko

Answer 1

在源代码中我们可以看到：

static int HandleTidy(const std::string& runCmd, const std::string& sourceFile,
                      const std::vector<std::string>& orig_cmd)
{
  // Construct the clang-tidy command line by taking what was given
  // and adding our compiler command line.  The clang-tidy tool will
  // automatically skip over the compiler itself and extract the
  // options.
  int ret;
  std::vector<std::string> tidy_cmd = cmExpandedList(runCmd, true);
  tidy_cmd.push_back(sourceFile);
  tidy_cmd.emplace_back("--");
  cmAppend(tidy_cmd, orig_cmd);

源代码位置：https://github.com/Kitware/CMake/blob/09032f09f8d2b4f7af658060ef434083f9d6a0d4/Source/cmcmd.cxx#L196-L207

因此，我认为所有编译器选项，例如 CMAKE_CXX_FLAGS，默认情况下也会传递给 clang-tidy...

- Mizux

---

很好的发现。它解释了问题所在，但是没有说明如何使其工作（而不需要重新编译带有更改的cmake）。 问题是，我该如何防止它发生。似乎没有任何选项可以不这样做。 - David Ledger

Answer 2

作为一种解决方法，您可以编写一个小脚本来过滤接收到的参数，然后使用过滤后的参数列表调用 clang-tidy。然后将此脚本交给 CMAKE_CXX_CLANG_TIDY 而不是实际的可执行文件。

- svanveen

Answer 3

正如其他人所提到的，这是因为CMake将所有标志传递给clang-tidy，而clang-tidy并不理解所有这些标志。在我的情况下，它在RISC-V的march标志上遇到了问题。

我使用的解决方法是生成一个中间脚本，使用sed将march标志剥离出来，然后再传递给clang-tidy。这个解决方案完全包含在CMake中，但也可以将脚本放在磁盘上。

我的解决方案（在你的情况下，请使用CMAKE_CXX_CLANG_TIDY）：

file(GENERATE OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/clang-tidy.sh
     CONTENT "#!/usr/bin/env sh\nclang-tidy $(echo $@ | sed 's/-march=[^ ]* //')"
     FILE_PERMISSIONS OWNER_READ OWNER_EXECUTE)
set(CMAKE_C_CLANG_TIDY "${CMAKE_CURRENT_BINARY_DIR}/clang-tidy.sh")

- Shadoxfix

Answer 4

我几年前就想出了这个解决方案，但最近又因为另一个平台而重新审视了它。对于喜欢Python的任何人，这是我的解决方案：

set(LLVM_ROOT /opt/llvm-14.0.6)
set(LLVM_BIN ${LLVM_ROOT}/bin)
set(CLANG_TIDY ${LLVM_BIN}/clang-tidy)
set(CLANG_TIDY_ARGS --use-color)
set(CLANG_TIDY_ON_ARM python3 ${CMAKE_SOURCE_DIR}/cmake/llvm/clang-tidy-on-arm.py)

if(NOT EXISTS ${CLANG_TIDY})
  message(FATAL_ERROR
    "Cannot find Clang Tidy executable at path: ${CLANG_TIDY}\n"
    "Please make sure you have a working copy of LLVM installed to this directory: "
    "${LLVM_ROOT}"
    )
endif()

if(CMAKE_SYSTEM_PROCESSOR STREQUAL "arm")
  set(CMAKE_C_CLANG_TIDY ${CLANG_TIDY_ON_ARM} ${CLANG_TIDY} ${CLANG_TIDY_ARGS})
else()
  set(CMAKE_C_CLANG_TIDY ${CLANG_TIDY} ${CLANG_TIDY_ARGS})
endif()

# This is a wrapper script that converts a GCC compilation command for a Zynq
# target to a Clang-compatible command on ARM.
import os.path
import subprocess
import sys

args = list(sys.argv)

if len(args) < 2 or not args[1].endswith("clang-tidy"):
    print(
        "error: clang-tidy-on-arm.py: "
        "expecting the first argument to be a path to Clang Tidy executable."
    )
    sys.exit(1)

clang_tidy = args[1]
if not os.path.exists(clang_tidy):
    print(
        "error: clang-tidy-on-arm.py: "
        f"the path to Clang Tidy does not exist: {clang_tidy}."
    )
    sys.exit(1)

# Remove the first argument (which is the path to this script) because it is not
# to be passed to the underlying Clang Tidy invocation.
_ = args.pop(0)

# Clang does not support this argument: -march=armv7-a.
# error: unknown target CPU 'arm7v-a'
# So we replace it with a generic ARM target.
# See clang -print-targets for available targets.
march_idx = args.index('-march=armv7-a')
args[march_idx] = "--target=arm-none-eabi"

# Clang Tidy needs to access stdio.h and cpuset.h
# This include path seems to be substituted by RTEMS Toolchain automatically,
# but this script has to do it manually here because we are calling Clang Tidy
# which calls into Clang to parse the AST and the RTEMS Toolchain's GCC is not
# used.
args.insert(march_idx, "-I/opt/rtems-6-arm-toolchain/arm-rtems6/include")

print(f"clang-tidy-on-arm.py: checking file: {args[-1]}")
result = subprocess.run(args, stdout=subprocess.PIPE, stderr=subprocess.PIPE, universal_newlines=True)
print(result.stdout)
if result.returncode != 0:
    print(result.stderr)
    print(f"clang-tidy-on-arm.py: Clang Tidy has finished with error code: {result.returncode}")
    sys.exit(1)

- Stanislav Pankevich