From: Namhyung Kim <namhyung@kernel.org>
To: Ian Rogers <irogers@google.com>
Cc: acme@kernel.org, adrian.hunter@intel.com, bvanassche@acm.org,
elver@google.com, james.clark@linaro.org, jolsa@kernel.org,
justinstitt@google.com, linux-kernel@vger.kernel.org,
linux-perf-users@vger.kernel.org, llvm@lists.linux.dev,
mingo@redhat.com, morbo@google.com, nathan@kernel.org,
ndesaulniers@google.com, peterz@infradead.org
Subject: Re: [PATCH v13 04/21] perf mutex: Use kernel style compiler-context-analysis.h annotations
Date: Thu, 19 Nov 2026 21:31:04 -0800 [thread overview]
Message-ID: <av_bGKcyato9YHD_@google.com> (raw)
In-Reply-To: <20261113164152.2095566-5-irogers@google.com>
On Fri, Nov 13, 2026 at 08:41:35AM -0800, Ian Rogers wrote:
> Enable -DWARN_CONTEXT_ANALYSIS alongside -Wthread-safety for Clang
> builds in tools/perf/Makefile.config, replace the custom lock safety
> macros in tools/perf with the kernel's compiler-context-analysis.h
> annotations (context_lock_struct, __guarded_by, __acquires,
> __acquires_shared, __releases, __releases_shared, __cond_acquires,
> __must_hold, __must_hold_shared, __must_not_hold, __returns_ctx_lock,
> __no_context_analysis, and __context_unsafe), and remove the redundant
> macro definitions from tools/perf/util/mutex.h.
>
> Signed-off-by: Ian Rogers <irogers@google.com>
> ---
> tools/perf/Makefile.config | 2 +-
> tools/perf/builtin-sched.c | 16 +++----
> tools/perf/builtin-top.c | 4 +-
> tools/perf/util/annotate.c | 4 +-
> tools/perf/util/annotate.h | 8 ++--
> tools/perf/util/comm.c | 4 +-
> tools/perf/util/dso.c | 30 ++++++------
> tools/perf/util/dso.h | 11 +++--
> tools/perf/util/dsos.c | 6 +--
> tools/perf/util/intel-tpebs.c | 6 +--
> tools/perf/util/libbfd.c | 4 +-
> tools/perf/util/mutex.c | 4 +-
> tools/perf/util/mutex.h | 90 +++--------------------------------
> tools/perf/util/rwsem.c | 8 ++--
> tools/perf/util/rwsem.h | 10 ++--
> tools/perf/util/thread.c | 8 ++--
> tools/perf/util/thread.h | 2 +-
> 17 files changed, 70 insertions(+), 147 deletions(-)
>
> diff --git a/tools/perf/Makefile.config b/tools/perf/Makefile.config
> index b4764f69f47f..3eb8d095cda0 100644
> --- a/tools/perf/Makefile.config
> +++ b/tools/perf/Makefile.config
> @@ -64,7 +64,7 @@ ifeq ($(CC_NO_CLANG), 0)
> endif
>
> # Enabled Wthread-safety analysis for clang builds.
> - CFLAGS += -Wthread-safety
> + CFLAGS += -Wthread-safety -DWARN_CONTEXT_ANALYSIS
Why is this needed? Also it seem to belong to the next patch.
Thanks,
Namhyung
> endif
>
> include $(srctree)/tools/scripts/Makefile.arch
> diff --git a/tools/perf/builtin-sched.c b/tools/perf/builtin-sched.c
> index 39571f03eda2..ee74a6aa5ea3 100644
> --- a/tools/perf/builtin-sched.c
> +++ b/tools/perf/builtin-sched.c
> @@ -828,8 +828,8 @@ static void *thread_func(void *ctx)
> }
>
> static void create_tasks(struct perf_sched *sched)
> - EXCLUSIVE_LOCK_FUNCTION(sched->start_work_mutex)
> - EXCLUSIVE_LOCK_FUNCTION(sched->work_done_wait_mutex)
> + __acquires(&sched->start_work_mutex)
> + __acquires(&sched->work_done_wait_mutex)
> {
> struct task_desc *task;
> pthread_attr_t attr;
> @@ -858,8 +858,8 @@ static void create_tasks(struct perf_sched *sched)
> }
>
> static void destroy_tasks(struct perf_sched *sched)
> - UNLOCK_FUNCTION(sched->start_work_mutex)
> - UNLOCK_FUNCTION(sched->work_done_wait_mutex)
> + __releases(&sched->start_work_mutex)
> + __releases(&sched->work_done_wait_mutex)
> {
> struct task_desc *task;
> unsigned long i;
> @@ -878,8 +878,8 @@ static void destroy_tasks(struct perf_sched *sched)
> }
>
> static void wait_for_tasks(struct perf_sched *sched)
> - EXCLUSIVE_LOCKS_REQUIRED(sched->work_done_wait_mutex)
> - EXCLUSIVE_LOCKS_REQUIRED(sched->start_work_mutex)
> + __must_hold(&sched->work_done_wait_mutex)
> + __must_hold(&sched->start_work_mutex)
> {
> u64 cpu_usage_0, cpu_usage_1;
> struct task_desc *task;
> @@ -930,8 +930,8 @@ static void wait_for_tasks(struct perf_sched *sched)
> }
>
> static void run_one_test(struct perf_sched *sched)
> - EXCLUSIVE_LOCKS_REQUIRED(sched->work_done_wait_mutex)
> - EXCLUSIVE_LOCKS_REQUIRED(sched->start_work_mutex)
> + __must_hold(&sched->work_done_wait_mutex)
> + __must_hold(&sched->start_work_mutex)
> {
> u64 T0, T1, delta, avg_delta, fluct;
>
> diff --git a/tools/perf/builtin-top.c b/tools/perf/builtin-top.c
> index a3442d2d6edf..9049db154fa4 100644
> --- a/tools/perf/builtin-top.c
> +++ b/tools/perf/builtin-top.c
> @@ -201,7 +201,7 @@ static void perf_top__record_precise_ip(struct perf_top *top,
> struct hist_entry *he,
> struct perf_sample *sample,
> u64 ip)
> - EXCLUSIVE_LOCKS_REQUIRED(he->hists->lock)
> + __must_hold(&he->hists->lock)
> {
> struct annotation *notes;
> struct symbol *sym = he->ms.sym;
> @@ -730,7 +730,7 @@ static void *display_thread(void *arg)
> static int hist_iter__top_callback(struct hist_entry_iter *iter,
> struct addr_location *al, bool single,
> void *arg)
> - EXCLUSIVE_LOCKS_REQUIRED(iter->he->hists->lock)
> + __must_hold(&iter->he->hists->lock)
> {
> struct perf_top *top = arg;
>
> diff --git a/tools/perf/util/annotate.c b/tools/perf/util/annotate.c
> index 86a4beec6528..c466757e8508 100644
> --- a/tools/perf/util/annotate.c
> +++ b/tools/perf/util/annotate.c
> @@ -655,7 +655,7 @@ static struct mutex *annotation__get_mutex(const struct annotation *notes)
> }
>
> void annotation__lock(struct annotation *notes)
> - NO_THREAD_SAFETY_ANALYSIS
> + __no_context_analysis
> {
> struct mutex *mutex = annotation__get_mutex(notes);
>
> @@ -664,7 +664,7 @@ void annotation__lock(struct annotation *notes)
> }
>
> void annotation__unlock(struct annotation *notes)
> - NO_THREAD_SAFETY_ANALYSIS
> + __no_context_analysis
> {
> struct mutex *mutex = annotation__get_mutex(notes);
>
> diff --git a/tools/perf/util/annotate.h b/tools/perf/util/annotate.h
> index 1b47c1156b9a..f5465c931721 100644
> --- a/tools/perf/util/annotate.h
> +++ b/tools/perf/util/annotate.h
> @@ -369,7 +369,7 @@ struct annotated_branch {
> u64 *br_cntr;
> };
>
> -struct LOCKABLE annotation {
> +context_lock_struct(annotation) {
> struct annotated_source *src;
> struct annotated_branch *branch;
> };
> @@ -379,9 +379,9 @@ static inline void annotation__init(struct annotation *notes __maybe_unused)
> }
> void annotation__exit(struct annotation *notes);
>
> -void annotation__lock(struct annotation *notes) EXCLUSIVE_LOCK_FUNCTION(*notes);
> -void annotation__unlock(struct annotation *notes) UNLOCK_FUNCTION(*notes);
> -bool annotation__trylock(struct annotation *notes) EXCLUSIVE_TRYLOCK_FUNCTION(true, *notes);
> +void annotation__lock(struct annotation *notes) __acquires(notes);
> +void annotation__unlock(struct annotation *notes) __releases(notes);
> +bool annotation__trylock(struct annotation *notes) __cond_acquires(true, notes);
>
> static inline int annotation__cycles_width(struct annotation *notes)
> {
> diff --git a/tools/perf/util/comm.c b/tools/perf/util/comm.c
> index 9880247a2c33..6343a3c9debe 100644
> --- a/tools/perf/util/comm.c
> +++ b/tools/perf/util/comm.c
> @@ -24,7 +24,7 @@ static struct comm_strs {
> static void comm_strs__remove_if_last(struct comm_str *cs);
>
> static void comm_strs__init(void)
> - NO_THREAD_SAFETY_ANALYSIS /* Inherently single threaded due to pthread_once. */
> + __context_unsafe(/* Inherently single threaded due to pthread_once. */)
> {
> init_rwsem(&_comm_strs.lock);
> _comm_strs.capacity = 16;
> @@ -120,7 +120,7 @@ static void comm_strs__remove_if_last(struct comm_str *cs)
> }
>
> static struct comm_str *__comm_strs__find(struct comm_strs *comm_strs, const char *str)
> - SHARED_LOCKS_REQUIRED(comm_strs->lock)
> + __must_hold_shared(&comm_strs->lock)
> {
> struct comm_str **result;
>
> diff --git a/tools/perf/util/dso.c b/tools/perf/util/dso.c
> index ce98613868e7..24ff066b9878 100644
> --- a/tools/perf/util/dso.c
> +++ b/tools/perf/util/dso.c
> @@ -525,14 +525,14 @@ void dso__set_module_info(struct dso *dso, struct kmod_path *m,
> */
> struct mutex _dso__data_open_lock;
> static LIST_HEAD(dso__data_open);
> -static long dso__data_open_cnt GUARDED_BY(_dso__data_open_lock);
> +static long dso__data_open_cnt __guarded_by(&_dso__data_open_lock);
>
> static void dso__data_open_lock_init(void)
> {
> mutex_init(&_dso__data_open_lock);
> }
>
> -static struct mutex *dso__data_open_lock(void) LOCK_RETURNED(_dso__data_open_lock)
> +static struct mutex *dso__data_open_lock(void) __returns_ctx_lock(&_dso__data_open_lock)
> {
> static pthread_once_t data_open_lock_once = PTHREAD_ONCE_INIT;
>
> @@ -541,7 +541,7 @@ static struct mutex *dso__data_open_lock(void) LOCK_RETURNED(_dso__data_open_loc
> return &_dso__data_open_lock;
> }
>
> -static void dso__list_add(struct dso *dso) EXCLUSIVE_LOCKS_REQUIRED(_dso__data_open_lock)
> +static void dso__list_add(struct dso *dso) __must_hold(&_dso__data_open_lock)
> {
> list_add_tail(&dso__data(dso)->open_entry, &dso__data_open);
> #ifdef REFCNT_CHECKING
> @@ -552,7 +552,7 @@ static void dso__list_add(struct dso *dso) EXCLUSIVE_LOCKS_REQUIRED(_dso__data_o
> dso__data_open_cnt++;
> }
>
> -static void dso__list_del(struct dso *dso) EXCLUSIVE_LOCKS_REQUIRED(_dso__data_open_lock)
> +static void dso__list_del(struct dso *dso) __must_hold(&_dso__data_open_lock)
> {
> list_del_init(&dso__data(dso)->open_entry);
> #ifdef REFCNT_CHECKING
> @@ -567,7 +567,7 @@ static void dso__list_del(struct dso *dso) EXCLUSIVE_LOCKS_REQUIRED(_dso__data_o
>
> static void close_first_dso(void);
>
> -static int do_open(char *name) EXCLUSIVE_LOCKS_REQUIRED(_dso__data_open_lock)
> +static int do_open(char *name) __must_hold(&_dso__data_open_lock)
> {
> do {
> int fd = open(name, O_RDONLY|O_CLOEXEC);
> @@ -670,7 +670,7 @@ void dso__put_filename(struct dso *dso __maybe_unused, char *filename, bool deco
> }
>
> static int __open_dso(struct dso *dso, struct machine *machine)
> - EXCLUSIVE_LOCKS_REQUIRED(_dso__data_open_lock)
> + __must_hold(&_dso__data_open_lock)
> {
> int fd = -EINVAL;
> char *name;
> @@ -703,7 +703,7 @@ static void check_data_close(void);
> * list/count of open DSO objects.
> */
> static int open_dso(struct dso *dso, struct machine *machine)
> - EXCLUSIVE_LOCKS_REQUIRED(_dso__data_open_lock)
> + __must_hold(&_dso__data_open_lock)
> {
> int fd;
> struct nscookie nsc;
> @@ -729,7 +729,7 @@ static int open_dso(struct dso *dso, struct machine *machine)
> return fd;
> }
>
> -static void close_data_fd(struct dso *dso) EXCLUSIVE_LOCKS_REQUIRED(_dso__data_open_lock)
> +static void close_data_fd(struct dso *dso) __must_hold(&_dso__data_open_lock)
> {
> if (dso__data(dso)->fd >= 0) {
> close(dso__data(dso)->fd);
> @@ -746,12 +746,12 @@ static void close_data_fd(struct dso *dso) EXCLUSIVE_LOCKS_REQUIRED(_dso__data_o
> * Close @dso's data file descriptor and updates
> * list/count of open DSO objects.
> */
> -static void close_dso(struct dso *dso) EXCLUSIVE_LOCKS_REQUIRED(_dso__data_open_lock)
> +static void close_dso(struct dso *dso) __must_hold(&_dso__data_open_lock)
> {
> close_data_fd(dso);
> }
>
> -static void close_first_dso(void) EXCLUSIVE_LOCKS_REQUIRED(_dso__data_open_lock)
> +static void close_first_dso(void) __must_hold(&_dso__data_open_lock)
> {
> struct dso_data *dso_data;
> struct dso *dso;
> @@ -796,7 +796,7 @@ void reset_fd_limit(void)
> fd_limit = 0;
> }
>
> -static bool may_cache_fd(void) EXCLUSIVE_LOCKS_REQUIRED(_dso__data_open_lock)
> +static bool may_cache_fd(void) __must_hold(&_dso__data_open_lock)
> {
> if (!fd_limit)
> fd_limit = get_fd_limit();
> @@ -812,7 +812,7 @@ static bool may_cache_fd(void) EXCLUSIVE_LOCKS_REQUIRED(_dso__data_open_lock)
> * for opened dso file descriptors. The limit is half
> * of the RLIMIT_NOFILE files opened.
> */
> -static void check_data_close(void) EXCLUSIVE_LOCKS_REQUIRED(_dso__data_open_lock)
> +static void check_data_close(void) __must_hold(&_dso__data_open_lock)
> {
> bool cache_fd = may_cache_fd();
>
> @@ -834,7 +834,7 @@ void dso__data_close(struct dso *dso)
> }
>
> static int dso__find_binary_type_locked(struct dso *dso)
> - EXCLUSIVE_LOCKS_REQUIRED(dso__lock(dso))
> + __must_hold(dso__lock(dso))
> {
> enum dso_binary_type binary_type_data[] = {
> DSO_BINARY_TYPE__BUILD_ID_CACHE,
> @@ -926,7 +926,7 @@ static int dso__find_binary_type_locked(struct dso *dso)
>
> #define FIND_MAX_RETRY 3
> static int __dso__find_binary_type(struct dso *dso)
> - EXCLUSIVE_LOCKS_REQUIRED(_dso__data_open_lock)
> + __must_hold(&_dso__data_open_lock)
> {
> int ret;
> int retry = 0;
> @@ -966,7 +966,7 @@ enum dso_binary_type dso__find_binary_type(struct dso *dso)
> }
>
> static void try_to_open_dso(struct dso *dso, struct machine *machine)
> - EXCLUSIVE_LOCKS_REQUIRED(_dso__data_open_lock)
> + __must_hold(&_dso__data_open_lock)
> {
> struct dso_data *dso_data = dso__data(dso);
>
> diff --git a/tools/perf/util/dso.h b/tools/perf/util/dso.h
> index d5f7382d4e13..f6c60bafcde1 100644
> --- a/tools/perf/util/dso.h
> +++ b/tools/perf/util/dso.h
> @@ -629,6 +629,7 @@ static inline void dso__set_loaded(struct dso *dso)
> }
>
> static inline struct mutex *dso__lock(struct dso *dso)
> + __returns_ctx_lock(&RC_CHK_ACCESS(dso)->lock)
> {
> return &RC_CHK_ACCESS(dso)->lock;
> }
> @@ -760,7 +761,7 @@ static inline const char *dso__symsrc_filename(const struct dso *dso)
> return RC_CHK_ACCESS(dso)->symsrc_filename;
> }
>
> -void dso__set_symsrc_filename(struct dso *dso, char *val) EXCLUSIVE_LOCKS_REQUIRED(dso__lock(dso));
> +void dso__set_symsrc_filename(struct dso *dso, char *val) __must_hold(dso__lock(dso));
>
> static inline void dso__free_symsrc_filename(struct dso *dso)
> {
> @@ -809,7 +810,7 @@ void __dso__improve_id(struct dso *dso, const struct dso_id *id);
> int dso__name_len(const struct dso *dso);
>
> struct dso *dso__get(struct dso *dso);
> -void dso__put(struct dso *dso) LOCKS_EXCLUDED(_dso__data_open_lock);
> +void dso__put(struct dso *dso) __must_not_hold(&_dso__data_open_lock);
>
> static inline void __dso__zput(struct dso **dso)
> {
> @@ -919,9 +920,9 @@ void dso__set_module_info(struct dso *dso, struct kmod_path *m,
> * TODO
> */
> bool dso__data_get_fd(struct dso *dso, struct machine *machine, int *fd)
> - EXCLUSIVE_TRYLOCK_FUNCTION(true, _dso__data_open_lock);
> -void dso__data_put_fd(struct dso *dso) UNLOCK_FUNCTION(_dso__data_open_lock);
> -void dso__data_close(struct dso *dso) LOCKS_EXCLUDED(_dso__data_open_lock);
> + __cond_acquires(true, &_dso__data_open_lock);
> +void dso__data_put_fd(struct dso *dso) __releases(&_dso__data_open_lock);
> +void dso__data_close(struct dso *dso) __must_not_hold(&_dso__data_open_lock);
>
> int dso__data_file_size(struct dso *dso, struct machine *machine);
> off_t dso__data_size(struct dso *dso, struct machine *machine);
> diff --git a/tools/perf/util/dsos.c b/tools/perf/util/dsos.c
> index e927e707abac..a2cd37bd1660 100644
> --- a/tools/perf/util/dsos.c
> +++ b/tools/perf/util/dsos.c
> @@ -157,7 +157,7 @@ static struct dso *__dsos__find_by_longname_id(struct dsos *dsos,
> const char *name,
> const struct dso_id *id,
> bool write_locked)
> - SHARED_LOCKS_REQUIRED(dsos->lock)
> + __must_hold_shared(&dsos->lock)
> {
> struct dsos__key key = {
> .long_name = name,
> @@ -266,7 +266,7 @@ static int dsos__find_id_cb(struct dso *dso, void *data)
>
> static struct dso *__dsos__find_id(struct dsos *dsos, const char *name, const struct dso_id *id,
> bool cmp_short, bool write_locked)
> - SHARED_LOCKS_REQUIRED(dsos->lock)
> + __must_hold_shared(&dsos->lock)
> {
> struct dso *res;
>
> @@ -330,7 +330,7 @@ static struct dso *__dsos__addnew_id(struct dsos *dsos, const char *name, const
> }
>
> static struct dso *__dsos__findnew_id(struct dsos *dsos, const char *name, const struct dso_id *id)
> - SHARED_LOCKS_REQUIRED(dsos->lock)
> + __must_hold_shared(&dsos->lock)
> {
> struct dso *dso = __dsos__find_id(dsos, name, id, false, /*write_locked=*/true);
>
> diff --git a/tools/perf/util/intel-tpebs.c b/tools/perf/util/intel-tpebs.c
> index b41171b5df77..7c0b8b15bd10 100644
> --- a/tools/perf/util/intel-tpebs.c
> +++ b/tools/perf/util/intel-tpebs.c
> @@ -69,7 +69,7 @@ static struct mutex *tpebs_mtx_get(void)
> }
>
> static struct tpebs_retire_lat *tpebs_retire_lat__find(struct evsel *evsel)
> - EXCLUSIVE_LOCKS_REQUIRED(tpebs_mtx_get());
> + __must_hold(tpebs_mtx_get());
>
> static int evsel__tpebs_start_perf_record(struct evsel *evsel)
> {
> @@ -244,7 +244,7 @@ static void *__sample_reader(void *arg __maybe_unused)
> return NULL;
> }
>
> -static int tpebs_send_record_cmd(const char *msg) EXCLUSIVE_LOCKS_REQUIRED(tpebs_mtx_get())
> +static int tpebs_send_record_cmd(const char *msg) __must_hold(tpebs_mtx_get())
> {
> struct pollfd pollfd = { .events = POLLIN, };
> int ret, len, retries = 0;
> @@ -321,7 +321,7 @@ static int tpebs_send_record_cmd(const char *msg) EXCLUSIVE_LOCKS_REQUIRED(tpebs
> /*
> * tpebs_stop - stop the sample data read thread and the perf record process.
> */
> -static int tpebs_stop(void) EXCLUSIVE_LOCKS_REQUIRED(tpebs_mtx_get())
> +static int tpebs_stop(void) __must_hold(tpebs_mtx_get())
> {
> int ret = 0;
>
> diff --git a/tools/perf/util/libbfd.c b/tools/perf/util/libbfd.c
> index 58cadc93e8b5..61bd4f49afba 100644
> --- a/tools/perf/util/libbfd.c
> +++ b/tools/perf/util/libbfd.c
> @@ -51,13 +51,13 @@ struct a2l_data {
> asymbol **syms;
> };
>
> -static bool perf_bfd_lock(void *bfd_mutex) NO_THREAD_SAFETY_ANALYSIS
> +static bool perf_bfd_lock(void *bfd_mutex) __no_context_analysis
> {
> mutex_lock(bfd_mutex);
> return true;
> }
>
> -static bool perf_bfd_unlock(void *bfd_mutex) NO_THREAD_SAFETY_ANALYSIS
> +static bool perf_bfd_unlock(void *bfd_mutex) __no_context_analysis
> {
> mutex_unlock(bfd_mutex);
> return true;
> diff --git a/tools/perf/util/mutex.c b/tools/perf/util/mutex.c
> index df3b7cce3d5a..f1b99409ea91 100644
> --- a/tools/perf/util/mutex.c
> +++ b/tools/perf/util/mutex.c
> @@ -125,14 +125,14 @@ void mutex_destroy(struct mutex *mtx)
> }
>
> void mutex_lock(struct mutex *mtx)
> - NO_THREAD_SAFETY_ANALYSIS
> + __no_context_analysis
> {
> CHECK_ERR(mutex_take_over(mtx, pthread_mutex_lock(&mtx->lock),
> /*give_up=*/false));
> }
>
> void mutex_unlock(struct mutex *mtx)
> - NO_THREAD_SAFETY_ANALYSIS
> + __no_context_analysis
> {
> CHECK_ERR(pthread_mutex_unlock(&mtx->lock));
> }
> diff --git a/tools/perf/util/mutex.h b/tools/perf/util/mutex.h
> index 5de1065ea2b9..fc01a038aefe 100644
> --- a/tools/perf/util/mutex.h
> +++ b/tools/perf/util/mutex.h
> @@ -4,91 +4,13 @@
>
> #include <pthread.h>
> #include <stdbool.h>
> -
> -/*
> - * A function-like feature checking macro that is a wrapper around
> - * `__has_attribute`, which is defined by GCC 5+ and Clang and evaluates to a
> - * nonzero constant integer if the attribute is supported or 0 if not.
> - */
> -#ifdef __has_attribute
> -#define HAVE_ATTRIBUTE(x) __has_attribute(x)
> -#else
> -#define HAVE_ATTRIBUTE(x) 0
> -#endif
> -
> -#if HAVE_ATTRIBUTE(guarded_by) && HAVE_ATTRIBUTE(pt_guarded_by) && \
> - HAVE_ATTRIBUTE(lockable) && HAVE_ATTRIBUTE(exclusive_lock_function) && \
> - HAVE_ATTRIBUTE(exclusive_trylock_function) && HAVE_ATTRIBUTE(exclusive_locks_required) && \
> - HAVE_ATTRIBUTE(no_thread_safety_analysis)
> -
> -/* Documents if a shared field or global variable needs to be protected by a mutex. */
> -#define GUARDED_BY(x) __attribute__((guarded_by(x)))
> -
> -/*
> - * Documents if the memory location pointed to by a pointer should be guarded by
> - * a mutex when dereferencing the pointer.
> - */
> -#define PT_GUARDED_BY(x) __attribute__((pt_guarded_by(x)))
> -
> -/* Documents if a type is a lockable type. */
> -#define LOCKABLE __attribute__((lockable))
> -
> -/* Documents a function that expects a lock not to be held prior to entry. */
> -#define LOCKS_EXCLUDED(...) __attribute__((locks_excluded(__VA_ARGS__)))
> -
> -/* Documents a function that returns a lock. */
> -#define LOCK_RETURNED(x) __attribute__((lock_returned(x)))
> -
> -/* Documents functions that acquire a lock in the body of a function, and do not release it. */
> -#define EXCLUSIVE_LOCK_FUNCTION(...) __attribute__((exclusive_lock_function(__VA_ARGS__)))
> -
> -/*
> - * Documents functions that acquire a shared (reader) lock in the body of a
> - * function, and do not release it.
> - */
> -#define SHARED_LOCK_FUNCTION(...) __attribute__((shared_lock_function(__VA_ARGS__)))
> -
> -/*
> - * Documents functions that expect a lock to be held on entry to the function,
> - * and release it in the body of the function.
> - */
> -#define UNLOCK_FUNCTION(...) __attribute__((unlock_function(__VA_ARGS__)))
> -
> -/* Documents functions that try to acquire a lock, and return success or failure. */
> -#define EXCLUSIVE_TRYLOCK_FUNCTION(...) \
> - __attribute__((exclusive_trylock_function(__VA_ARGS__)))
> -
> -/* Documents a function that expects a mutex to be held prior to entry. */
> -#define EXCLUSIVE_LOCKS_REQUIRED(...) __attribute__((exclusive_locks_required(__VA_ARGS__)))
> -
> -/* Documents a function that expects a shared (reader) lock to be held prior to entry. */
> -#define SHARED_LOCKS_REQUIRED(...) __attribute__((shared_locks_required(__VA_ARGS__)))
> -
> -/* Turns off thread safety checking within the body of a particular function. */
> -#define NO_THREAD_SAFETY_ANALYSIS __attribute__((no_thread_safety_analysis))
> -
> -#else
> -
> -#define GUARDED_BY(x)
> -#define PT_GUARDED_BY(x)
> -#define LOCKABLE
> -#define LOCKS_EXCLUDED(...)
> -#define LOCK_RETURNED(x)
> -#define EXCLUSIVE_LOCK_FUNCTION(...)
> -#define SHARED_LOCK_FUNCTION(...)
> -#define UNLOCK_FUNCTION(...)
> -#define EXCLUSIVE_TRYLOCK_FUNCTION(...)
> -#define EXCLUSIVE_LOCKS_REQUIRED(...)
> -#define SHARED_LOCKS_REQUIRED(...)
> -#define NO_THREAD_SAFETY_ANALYSIS
> -
> -#endif
> +#include <linux/compiler.h>
>
> /*
> * A wrapper around the mutex implementation that allows perf to error check
> * usage, etc.
> */
> -struct LOCKABLE mutex {
> +context_lock_struct(mutex) {
> pthread_mutex_t lock;
> };
>
> @@ -150,10 +72,10 @@ void mutex_init_recursive(struct mutex *mtx);
> bool mutex_init_pshared_robust(struct mutex *mtx);
> void mutex_destroy(struct mutex *mtx);
>
> -void mutex_lock(struct mutex *mtx) EXCLUSIVE_LOCK_FUNCTION(*mtx);
> -void mutex_unlock(struct mutex *mtx) UNLOCK_FUNCTION(*mtx);
> +void mutex_lock(struct mutex *mtx) __acquires(mtx);
> +void mutex_unlock(struct mutex *mtx) __releases(mtx);
> /* Tries to acquire the lock and returns true on success. */
> -bool mutex_trylock(struct mutex *mtx) EXCLUSIVE_TRYLOCK_FUNCTION(true, *mtx);
> +bool mutex_trylock(struct mutex *mtx) __cond_acquires(true, mtx);
>
> /* Default initialize the cond struct. */
> void cond_init(struct cond *cnd);
> @@ -164,7 +86,7 @@ void cond_init(struct cond *cnd);
> void cond_init_pshared(struct cond *cnd);
> void cond_destroy(struct cond *cnd);
>
> -void cond_wait(struct cond *cnd, struct mutex *mtx) EXCLUSIVE_LOCKS_REQUIRED(mtx);
> +void cond_wait(struct cond *cnd, struct mutex *mtx) __must_hold(mtx);
> void cond_signal(struct cond *cnd);
> void cond_broadcast(struct cond *cnd);
>
> diff --git a/tools/perf/util/rwsem.c b/tools/perf/util/rwsem.c
> index 9d26832398db..cc720b482333 100644
> --- a/tools/perf/util/rwsem.c
> +++ b/tools/perf/util/rwsem.c
> @@ -27,7 +27,7 @@ int exit_rwsem(struct rw_semaphore *sem)
> }
>
> int down_read(struct rw_semaphore *sem)
> - NO_THREAD_SAFETY_ANALYSIS
> + __no_context_analysis
> {
> #if RWS_ERRORCHECK
> mutex_lock(&sem->mtx);
> @@ -38,7 +38,7 @@ int down_read(struct rw_semaphore *sem)
> }
>
> int up_read(struct rw_semaphore *sem)
> - NO_THREAD_SAFETY_ANALYSIS
> + __no_context_analysis
> {
> #if RWS_ERRORCHECK
> mutex_unlock(&sem->mtx);
> @@ -49,7 +49,7 @@ int up_read(struct rw_semaphore *sem)
> }
>
> int down_write(struct rw_semaphore *sem)
> - NO_THREAD_SAFETY_ANALYSIS
> + __no_context_analysis
> {
> #if RWS_ERRORCHECK
> mutex_lock(&sem->mtx);
> @@ -60,7 +60,7 @@ int down_write(struct rw_semaphore *sem)
> }
>
> int up_write(struct rw_semaphore *sem)
> - NO_THREAD_SAFETY_ANALYSIS
> + __no_context_analysis
> {
> #if RWS_ERRORCHECK
> mutex_unlock(&sem->mtx);
> diff --git a/tools/perf/util/rwsem.h b/tools/perf/util/rwsem.h
> index b102d8143181..235bb63c92d0 100644
> --- a/tools/perf/util/rwsem.h
> +++ b/tools/perf/util/rwsem.h
> @@ -10,7 +10,7 @@
> */
> #define RWS_ERRORCHECK 0
>
> -struct LOCKABLE rw_semaphore {
> +context_lock_struct(rw_semaphore) {
> #if RWS_ERRORCHECK
> struct mutex mtx;
> #else
> @@ -21,10 +21,10 @@ struct LOCKABLE rw_semaphore {
> int init_rwsem(struct rw_semaphore *sem);
> int exit_rwsem(struct rw_semaphore *sem);
>
> -int down_read(struct rw_semaphore *sem) SHARED_LOCK_FUNCTION(sem);
> -int up_read(struct rw_semaphore *sem) UNLOCK_FUNCTION(sem);
> +int down_read(struct rw_semaphore *sem) __acquires_shared(sem);
> +int up_read(struct rw_semaphore *sem) __releases_shared(sem);
>
> -int down_write(struct rw_semaphore *sem) EXCLUSIVE_LOCK_FUNCTION(sem);
> -int up_write(struct rw_semaphore *sem) UNLOCK_FUNCTION(sem);
> +int down_write(struct rw_semaphore *sem) __acquires(sem);
> +int up_write(struct rw_semaphore *sem) __releases(sem);
>
> #endif /* _PERF_RWSEM_H */
> diff --git a/tools/perf/util/thread.c b/tools/perf/util/thread.c
> index 91118c301913..616d5bf87baf 100644
> --- a/tools/perf/util/thread.c
> +++ b/tools/perf/util/thread.c
> @@ -41,7 +41,7 @@ int thread__init_maps(struct thread *thread, struct machine *machine)
> }
>
> struct thread *thread__new(pid_t pid, pid_t tid)
> - NO_THREAD_SAFETY_ANALYSIS /* Allocation/creation is inherently single threaded. */
> + __context_unsafe(/* Allocation/creation is inherently single threaded. */)
> {
> RC_STRUCT(thread) *_thread = zalloc(sizeof(*_thread));
> struct thread *thread;
> @@ -203,7 +203,7 @@ int thread__set_namespaces(struct thread *thread, u64 timestamp,
> }
>
> static struct comm *__thread__comm(struct thread *thread)
> - SHARED_LOCKS_REQUIRED(thread__comm_lock(thread))
> + __must_hold_shared(thread__comm_lock(thread))
> {
> if (list_empty(thread__comm_list(thread)))
> return NULL;
> @@ -250,7 +250,7 @@ struct comm *thread__exec_comm(struct thread *thread)
>
> static int ____thread__set_comm(struct thread *thread, const char *str,
> u64 timestamp, bool exec)
> - EXCLUSIVE_LOCKS_REQUIRED(thread__comm_lock(thread))
> + __must_hold(thread__comm_lock(thread))
> {
> struct comm *new, *curr = __thread__comm(thread);
>
> @@ -308,7 +308,7 @@ int thread__set_comm_from_proc(struct thread *thread)
> }
>
> static const char *__thread__comm_str(struct thread *thread)
> - SHARED_LOCKS_REQUIRED(thread__comm_lock(thread))
> + __must_hold_shared(thread__comm_lock(thread))
> {
> const struct comm *comm = __thread__comm(thread);
>
> diff --git a/tools/perf/util/thread.h b/tools/perf/util/thread.h
> index d82fce8173ae..9d0ce7742c06 100644
> --- a/tools/perf/util/thread.h
> +++ b/tools/perf/util/thread.h
> @@ -251,7 +251,7 @@ static inline struct rw_semaphore *thread__comm_lock(struct thread *thread)
> }
>
> static inline struct list_head *thread__comm_list(struct thread *thread)
> - SHARED_LOCKS_REQUIRED(thread__comm_lock(thread))
> + __must_hold_shared(thread__comm_lock(thread))
> {
> return &RC_CHK_ACCESS(thread)->comm_list;
> }
> --
> 2.56.1.703.gf848ed807c-goog
>
next prev parent reply other threads:[~2026-11-20 5:31 UTC|newest]
Thread overview: 47+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-11-13 16:41 [PATCH v13 00/21] tools/perf: Adopt kernel compiler-context-analysis.h annotations Ian Rogers
2026-11-13 16:41 ` [PATCH v13 01/21] compiler-context-analysis: Avoid unused parameter warning in _context_unsafe_alias() Ian Rogers
2026-11-13 16:50 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 02/21] tools headers compiler: Synchronize compiler_types.h with the kernel sources Ian Rogers
2026-11-13 16:56 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 03/21] tools headers: Synchronize linux/compiler-context-analysis.h " Ian Rogers
2026-11-13 16:49 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 04/21] perf mutex: Use kernel style compiler-context-analysis.h annotations Ian Rogers
2026-11-13 16:57 ` sashiko-bot
2026-11-20 5:31 ` Namhyung Kim [this message]
2026-11-13 16:41 ` [PATCH v13 05/21] perf build: Enable additional Clang thread-safety flags Ian Rogers
2026-11-13 16:56 ` sashiko-bot
2026-11-20 5:27 ` Namhyung Kim
2026-11-13 16:41 ` [PATCH v13 06/21] perf comm: Add __guarded_by annotations to struct comm_strs Ian Rogers
2026-11-13 17:02 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 07/21] perf vdso: Fix unlocked __dsos__add() and race in __machine__addnew_vdso() Ian Rogers
2026-11-13 16:50 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 08/21] perf dsos: Skip BPF and OOL DSOs in dsos__find_kernel_dso() Ian Rogers
2026-11-13 16:58 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 09/21] perf dsos: Ensure DSOs in auxtrace, machine, and symbol are in dsos Ian Rogers
2026-11-13 16:59 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 10/21] perf dso: Pass dso_data to close_data_fd() and dso__list_del() Ian Rogers
2026-11-13 16:55 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 11/21] perf dso: Use DEFINE_MUTEX for dso__data_open_lock Ian Rogers
2026-11-13 16:52 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 12/21] perf dsos: Use read lock fast path in dsos__findnew_id() Ian Rogers
2026-11-13 17:09 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 13/21] perf dso: Expand context analysis annotations Ian Rogers
2026-11-13 16:58 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 14/21] perf thread: Expand context analysis annotations to threads and namespaces_lock Ian Rogers
2026-11-13 16:59 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 15/21] perf intel-tpebs: Fix race in tpebs_stop() and tpebs_cmd.out fd handling Ian Rogers
2026-11-13 17:13 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 16/21] perf intel-tpebs: Use DEFINE_MUTEX for tpebs_mtx and add lock annotations Ian Rogers
2026-11-13 17:09 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 17/21] perf config: Add __guarded_by and __must_hold annotations Ian Rogers
2026-11-13 17:01 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 18/21] perf env: " Ian Rogers
2026-11-13 17:11 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 19/21] perf maps: Fix lock inversion in maps__load_first() Ian Rogers
2026-11-13 17:10 ` sashiko-bot
2026-11-20 5:33 ` Namhyung Kim
2026-11-13 16:41 ` [PATCH v13 20/21] perf maps: Fix map index lookup fallback and removal Ian Rogers
2026-11-13 17:07 ` sashiko-bot
2026-11-13 16:41 ` [PATCH v13 21/21] perf maps: Add context analysis annotations Ian Rogers
2026-11-13 17:04 ` sashiko-bot
2026-11-19 16:39 ` [PATCH v13 00/21] tools/perf: Adopt kernel compiler-context-analysis.h annotations Ian Rogers
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=av_bGKcyato9YHD_@google.com \
--to=namhyung@kernel.org \
--cc=acme@kernel.org \
--cc=adrian.hunter@intel.com \
--cc=bvanassche@acm.org \
--cc=elver@google.com \
--cc=irogers@google.com \
--cc=james.clark@linaro.org \
--cc=jolsa@kernel.org \
--cc=justinstitt@google.com \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-perf-users@vger.kernel.org \
--cc=llvm@lists.linux.dev \
--cc=mingo@redhat.com \
--cc=morbo@google.com \
--cc=nathan@kernel.org \
--cc=ndesaulniers@google.com \
--cc=peterz@infradead.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox