mirror of
https://github.com/curl/curl.git
synced 2026-04-29 20:12:12 +03:00
4497dbd9ac
Fix bigger and smaller kinks in how clang-tidy is configured and used.
Sync behavior more between autotools and cmake, lib/src and tests. Bump
clang-tidy minimum version and prepare logic to allow using clang-tidy
to a fuller extent.
- move clang-tidy settings from builds to a new `.clang-tidy.yml`.
To make it easy to see and edit checks at one place. Also to allow
using the `--checks=` option internally to silence tests-specific
checks. (clang-tidy does not support multiple `--check=` options via
the command-line.)
Use explicit `--config-file=` option to point to the configuration.
- .clang-tidy.yml: link to documentation.
- suppress `clang-diagnostic-nullability-extension` due to a false
positive in libtests with `CURL_WERROR=ON` and `PICKY_COMPILER=OFF`.
- .clang-tidy.yml: enable `portability-*`, `misc-const-correctness`.
- drop `--quiet` clang-tidy option by default to make its working a bit
more transparent. The extra output is minimial.
- consistently use double-dashes in clang-tidy command-line options.
Supported by clang-tidy 9.0.0+ (2019-09-19). Before this patch single
and double were used arbitrarily.
- src/tool_parsecfg: silence false positive `clang-analyzer-unix.Stream`.
Seen with clang 18 + clang-tidy 19 and 20 (only with autotools.)
- INTERNALS: require clang-tidy 14.0.0+. For the `--config-file` option.
- INTERNALS: recommend clang-tidy 19.1.0+, to avoid bogus
`clang-analyzer-valist.Uninitialized` warnings. (bug details below)
autotools:
- allow configuring the clang-tidy tool via `CLANG_TIDY` env.
Also to use in GHA to point to a suffixed clang-tody tool.
- fix to pass CFLAGS to lib, src sources.
(keep omitting them when using a non-clang compiler.)
- fix to pass `--warnings-as-errors=*` in quotes to avoid globbing.
cmake:
- fix to not pass an empty `-I` to clang-tidy.
- fix to pass CFLAGS (picky warnings) to clang-tidy for test sources.
(keep omitting them when using a non-clang compiler.)
- fix to disable `clang-diagnostic-unused-function` for test sources.
(tests have static entry points, which trigger this check when
checking them as individidual sources.)
- fix forwarding `CURL_CLANG_TIDYFLAGS` to clang-tidy.
- force disable picky warnings when running clang-tidy with a non-clang
compiler. To not pass these flags when checking lib and src.
CI:
- GHA/linux: avoid clang-tidy bug by upgrading to v19, and drop the
workaround.
- GHA/linux: switch to clang from gcc in the clang-tidy job. Using gcc
doesn't allow passing CFLAGS to clang-tidy, making it less effective.
(My guess this was one factor contributing to this job often missing
to find certain issues compared to GHA/macos.)
I recomment using clang-tidy with a clang compiler, preferably the same
version or one that's compatible. Other cases are best effort, and may
fail if a C flag is passed to clang-tidy that it does not understand.
Picky warnings are mostly omitted when using a non-clang compiler,
reducing its usefulness.
Details and reproducer for the v18 (and earlier) clang-tidy bug,
previously affecting the GHA/linux job:
clang-tidy <=18 emits false warnings way when passing multiple C sources
at once (as done with autotools):
```sh
cat > src1.c <<EOF
#include <string.h>
static void dummy(void *p) { memcmp(p, p, 0); }
EOF
cat > src2.c <<EOF
#include <stdarg.h>
void vafunc(int option, ...)
{
va_list param;
va_start(param, option);
if(option)
(void)va_arg(param, int);
va_end(param);
}
EOF
/opt/homebrew/opt/llvm@18/bin/clang-tidy --checks=clang-analyzer-valist.Uninitialized src1.c src2.c
# src2.c:7:11: warning: va_arg() is called on an uninitialized va_list [clang-analyzer-valist.Uninitialized]
```
Follow-up to
|
||
|---|---|---|
| .. | ||
| toolx | ||
| .checksrc | ||
| .gitignore | ||
| CMakeLists.txt | ||
| config2setopts.c | ||
| config2setopts.h | ||
| curl.rc | ||
| curlinfo.c | ||
| Makefile.am | ||
| Makefile.inc | ||
| mk-file-embed.pl | ||
| mkhelp.pl | ||
| slist_wc.c | ||
| slist_wc.h | ||
| terminal.c | ||
| terminal.h | ||
| tool_cb_dbg.c | ||
| tool_cb_dbg.h | ||
| tool_cb_hdr.c | ||
| tool_cb_hdr.h | ||
| tool_cb_prg.c | ||
| tool_cb_prg.h | ||
| tool_cb_rea.c | ||
| tool_cb_rea.h | ||
| tool_cb_see.c | ||
| tool_cb_see.h | ||
| tool_cb_soc.c | ||
| tool_cb_soc.h | ||
| tool_cb_wrt.c | ||
| tool_cb_wrt.h | ||
| tool_cfgable.c | ||
| tool_cfgable.h | ||
| tool_dirhie.c | ||
| tool_dirhie.h | ||
| tool_doswin.c | ||
| tool_doswin.h | ||
| tool_easysrc.c | ||
| tool_easysrc.h | ||
| tool_filetime.c | ||
| tool_filetime.h | ||
| tool_findfile.c | ||
| tool_findfile.h | ||
| tool_formparse.c | ||
| tool_formparse.h | ||
| tool_getparam.c | ||
| tool_getparam.h | ||
| tool_getpass.c | ||
| tool_getpass.h | ||
| tool_help.c | ||
| tool_help.h | ||
| tool_helpers.c | ||
| tool_helpers.h | ||
| tool_hugehelp.h | ||
| tool_ipfs.c | ||
| tool_ipfs.h | ||
| tool_libinfo.c | ||
| tool_libinfo.h | ||
| tool_listhelp.c | ||
| tool_main.c | ||
| tool_main.h | ||
| tool_msgs.c | ||
| tool_msgs.h | ||
| tool_operate.c | ||
| tool_operate.h | ||
| tool_operhlp.c | ||
| tool_operhlp.h | ||
| tool_paramhlp.c | ||
| tool_paramhlp.h | ||
| tool_parsecfg.c | ||
| tool_parsecfg.h | ||
| tool_progress.c | ||
| tool_progress.h | ||
| tool_sdecls.h | ||
| tool_setopt.c | ||
| tool_setopt.h | ||
| tool_setup.h | ||
| tool_ssls.c | ||
| tool_ssls.h | ||
| tool_stderr.c | ||
| tool_stderr.h | ||
| tool_urlglob.c | ||
| tool_urlglob.h | ||
| tool_util.c | ||
| tool_util.h | ||
| tool_version.h | ||
| tool_vms.c | ||
| tool_vms.h | ||
| tool_writeout.c | ||
| tool_writeout.h | ||
| tool_writeout_json.c | ||
| tool_writeout_json.h | ||
| tool_xattr.c | ||
| tool_xattr.h | ||
| var.c | ||
| var.h | ||