xref: /dpdk/lib/eal/include/rte_lock_annotations.h (revision 4dd146e597d81d900140a904e0b3b9feb1b0be6c)

/* SPDX-License-Identifier: BSD-3-Clause
 * Copyright(c) 2022 Red Hat, Inc.
 */

#ifndef RTE_LOCK_ANNOTATIONS_H
#define RTE_LOCK_ANNOTATIONS_H

#ifdef __cplusplus
extern "C" {
#endif

#ifdef RTE_ANNOTATE_LOCKS

#define __rte_lockable \
	__attribute__((lockable))

#define __rte_guarded_by(...) \
	__attribute__((guarded_by(__VA_ARGS__)))
#define __rte_guarded_var \
	__attribute__((guarded_var))

#define __rte_exclusive_locks_required(...) \
	__attribute__((exclusive_locks_required(__VA_ARGS__)))
#define __rte_exclusive_lock_function(...) \
	__attribute__((exclusive_lock_function(__VA_ARGS__)))
#define __rte_exclusive_trylock_function(ret, ...) \
	__attribute__((exclusive_trylock_function(ret, __VA_ARGS__)))
#define __rte_assert_exclusive_lock(...) \
	__attribute__((assert_exclusive_lock(__VA_ARGS__)))

#define __rte_shared_locks_required(...) \
	__attribute__((shared_locks_required(__VA_ARGS__)))
#define __rte_shared_lock_function(...) \
	__attribute__((shared_lock_function(__VA_ARGS__)))
#define __rte_shared_trylock_function(ret, ...) \
	__attribute__((shared_trylock_function(ret, __VA_ARGS__)))
#define __rte_assert_shared_lock(...) \
	__attribute__((assert_shared_lock(__VA_ARGS__)))

#define __rte_unlock_function(...) \
	__attribute__((unlock_function(__VA_ARGS__)))

#define __rte_locks_excluded(...) \
	__attribute__((locks_excluded(__VA_ARGS__)))

#define __rte_no_thread_safety_analysis \
	__attribute__((no_thread_safety_analysis))

#else /* ! RTE_ANNOTATE_LOCKS */

#define __rte_lockable

#define __rte_guarded_by(...)
#define __rte_guarded_var

#define __rte_exclusive_locks_required(...)
#define __rte_exclusive_lock_function(...)
#define __rte_exclusive_trylock_function(...)
#define __rte_assert_exclusive_lock(...)

#define __rte_shared_locks_required(...)
#define __rte_shared_lock_function(...)
#define __rte_shared_trylock_function(...)
#define __rte_assert_shared_lock(...)

#define __rte_unlock_function(...)

#define __rte_locks_excluded(...)

#define __rte_no_thread_safety_analysis

#endif /* RTE_ANNOTATE_LOCKS */

#ifdef __cplusplus
}
#endif

#endif /* RTE_LOCK_ANNOTATIONS_H */