[urcu.git] / urcu / compiler.h

#ifndef _URCU_COMPILER_H
#define _URCU_COMPILER_H

/*
 * compiler.h
 *
 * Compiler definitions.
 *
 * Copyright (c) 2009 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 */

#include <stddef.h>	/* for offsetof */

#define caa_likely(x)	__builtin_expect(!!(x), 1)
#define caa_unlikely(x)	__builtin_expect(!!(x), 0)

#define	cmm_barrier()	__asm__ __volatile__ ("" : : : "memory")

/*
 * Instruct the compiler to perform only a single access to a variable
 * (prohibits merging and refetching). The compiler is also forbidden to reorder
 * successive instances of CMM_ACCESS_ONCE(), but only when the compiler is aware of
 * particular ordering. Compiler ordering can be ensured, for example, by
 * putting two CMM_ACCESS_ONCE() in separate C statements.
 *
 * This macro does absolutely -nothing- to prevent the CPU from reordering,
 * merging, or refetching absolutely anything at any time.  Its main intended
 * use is to mediate communication between process-level code and irq/NMI
 * handlers, all running on the same CPU.
 */
#define CMM_ACCESS_ONCE(x)	(*(__volatile__  __typeof__(x) *)&(x))

#ifndef caa_max
#define caa_max(a,b) ((a)>(b)?(a):(b))
#endif

#ifndef caa_min
#define caa_min(a,b) ((a)<(b)?(a):(b))
#endif

#if defined(__SIZEOF_LONG__)
#define CAA_BITS_PER_LONG	(__SIZEOF_LONG__ * 8)
#elif defined(_LP64)
#define CAA_BITS_PER_LONG	64
#else
#define CAA_BITS_PER_LONG	32
#endif

/*
 * caa_container_of - Get the address of an object containing a field.
 *
 * @ptr: pointer to the field.
 * @type: type of the object.
 * @member: name of the field within the object.
 */
#define caa_container_of(ptr, type, member)				\
	__extension__							\
	({								\
		const __typeof__(((type *) NULL)->member) * __ptr = (ptr); \
		(type *)((char *)__ptr - offsetof(type, member));	\
	})

#define CAA_BUILD_BUG_ON_ZERO(cond) (sizeof(struct { int:-!!(cond); }))
#define CAA_BUILD_BUG_ON(cond) ((void)CAA_BUILD_BUG_ON_ZERO(cond))

/*
 * __rcu is an annotation that documents RCU pointer accesses that need
 * to be protected by a read-side critical section. Eventually, a static
 * checker will be able to use this annotation to detect incorrect RCU
 * usage.
 */
#define __rcu

#ifdef __cplusplus
#define URCU_FORCE_CAST(type, arg)	(reinterpret_cast<type>(arg))
#else
#define URCU_FORCE_CAST(type, arg)	((type) (arg))
#endif

#define caa_is_signed_type(type)	((type) -1 < (type) 0)

/*
 * Cast to unsigned long, sign-extending if @v is signed.
 * Note: casting to a larger type or to same type size keeps the sign of
 * the expression being cast (see C99 6.3.1.3).
 */
#define caa_cast_long_keep_sign(v)	((unsigned long) (v))

#if defined (__GNUC__) \
	&& ((__GNUC__ == 4) && (__GNUC_MINOR__ >= 5)	\
		|| __GNUC__ >= 5)
#define CDS_DEPRECATED(msg)	\
	__attribute__((deprecated(msg)))
#else
#define CDS_DEPRECATED(msg)	\
	__attribute__((deprecated))
#endif

#define CAA_ARRAY_SIZE(x)	(sizeof(x) / sizeof((x)[0]))

/*
 * Don't allow compiling with buggy compiler.
 */

#ifdef __GNUC__
# define URCU_GCC_VERSION	(__GNUC__ * 10000 \
				+ __GNUC_MINOR__ * 100 \
				+ __GNUC_PATCHLEVEL__)

/*
 * http://gcc.gnu.org/bugzilla/show_bug.cgi?id=58854
 */
# ifdef __ARMEL__
#  if URCU_GCC_VERSION >= 40800 && URCU_GCC_VERSION <= 40802
#   error Your gcc version produces clobbered frame accesses
#  endif
# endif
#endif

#endif /* _URCU_COMPILER_H */
Commit	Line	Data
	1	#ifndef _URCU_COMPILER_H
	2	#define _URCU_COMPILER_H
	3
	4	/*
	5	* compiler.h
	6	*
	7	* Compiler definitions.
	8	*
	9	* Copyright (c) 2009 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
	10	*
	11	* Permission is hereby granted, free of charge, to any person obtaining a copy
	12	* of this software and associated documentation files (the "Software"), to deal
	13	* in the Software without restriction, including without limitation the rights
	14	* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
	15	* copies of the Software, and to permit persons to whom the Software is
	16	* furnished to do so, subject to the following conditions:
	17	*
	18	* The above copyright notice and this permission notice shall be included in
	19	* all copies or substantial portions of the Software.
	20	*/
	21
	22	#include <stddef.h> /* for offsetof */
	23
	24	#define caa_likely(x) __builtin_expect(!!(x), 1)
	25	#define caa_unlikely(x) __builtin_expect(!!(x), 0)
	26
	27	#define cmm_barrier() __asm__ __volatile__ ("" : : : "memory")
	28
	29	/*
	30	* Instruct the compiler to perform only a single access to a variable
	31	* (prohibits merging and refetching). The compiler is also forbidden to reorder
	32	* successive instances of CMM_ACCESS_ONCE(), but only when the compiler is aware of
	33	* particular ordering. Compiler ordering can be ensured, for example, by
	34	* putting two CMM_ACCESS_ONCE() in separate C statements.
	35	*
	36	* This macro does absolutely -nothing- to prevent the CPU from reordering,
	37	* merging, or refetching absolutely anything at any time. Its main intended
	38	* use is to mediate communication between process-level code and irq/NMI
	39	* handlers, all running on the same CPU.
	40	*/
	41	#define CMM_ACCESS_ONCE(x) ((__volatile__ __typeof__(x) )&(x))
	42
	43	#ifndef caa_max
	44	#define caa_max(a,b) ((a)>(b)?(a):(b))
	45	#endif
	46
	47	#ifndef caa_min
	48	#define caa_min(a,b) ((a)<(b)?(a):(b))
	49	#endif
	50
	51	#if defined(__SIZEOF_LONG__)
	52	#define CAA_BITS_PER_LONG (__SIZEOF_LONG__ * 8)
	53	#elif defined(_LP64)
	54	#define CAA_BITS_PER_LONG 64
	55	#else
	56	#define CAA_BITS_PER_LONG 32
	57	#endif
	58
	59	/*
	60	* caa_container_of - Get the address of an object containing a field.
	61	*
	62	* @ptr: pointer to the field.
	63	* @type: type of the object.
	64	* @member: name of the field within the object.
	65	*/
	66	#define caa_container_of(ptr, type, member) \
	67	__extension__ \
	68	({ \
	69	const __typeof__(((type ) NULL)->member) __ptr = (ptr); \
	70	(type )((char )__ptr - offsetof(type, member)); \
	71	})
	72
	73	#define CAA_BUILD_BUG_ON_ZERO(cond) (sizeof(struct { int:-!!(cond); }))
	74	#define CAA_BUILD_BUG_ON(cond) ((void)CAA_BUILD_BUG_ON_ZERO(cond))
	75
	76	/*
	77	* __rcu is an annotation that documents RCU pointer accesses that need
	78	* to be protected by a read-side critical section. Eventually, a static
	79	* checker will be able to use this annotation to detect incorrect RCU
	80	* usage.
	81	*/
	82	#define __rcu
	83
	84	#ifdef __cplusplus
	85	#define URCU_FORCE_CAST(type, arg) (reinterpret_cast<type>(arg))
	86	#else
	87	#define URCU_FORCE_CAST(type, arg) ((type) (arg))
	88	#endif
	89
	90	#define caa_is_signed_type(type) ((type) -1 < (type) 0)
	91
	92	/*
	93	* Cast to unsigned long, sign-extending if @v is signed.
	94	* Note: casting to a larger type or to same type size keeps the sign of
	95	* the expression being cast (see C99 6.3.1.3).
	96	*/
	97	#define caa_cast_long_keep_sign(v) ((unsigned long) (v))
	98
	99	#if defined (__GNUC__) \
	100	&& ((__GNUC__ == 4) && (__GNUC_MINOR__ >= 5) \
	101	\|\| __GNUC__ >= 5)
	102	#define CDS_DEPRECATED(msg) \
	103	__attribute__((deprecated(msg)))
	104	#else
	105	#define CDS_DEPRECATED(msg) \
	106	__attribute__((deprecated))
	107	#endif
	108
	109	#define CAA_ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))
	110
	111	/*
	112	* Don't allow compiling with buggy compiler.
	113	*/
	114
	115	#ifdef __GNUC__
	116	# define URCU_GCC_VERSION (__GNUC__ * 10000 \
	117	+ __GNUC_MINOR__ * 100 \
	118	+ __GNUC_PATCHLEVEL__)
	119
	120	/*
	121	* http://gcc.gnu.org/bugzilla/show_bug.cgi?id=58854
	122	*/
	123	# ifdef __ARMEL__
	124	# if URCU_GCC_VERSION >= 40800 && URCU_GCC_VERSION <= 40802
	125	# error Your gcc version produces clobbered frame accesses
	126	# endif
	127	# endif
	128	#endif
	129
	130	#endif /* _URCU_COMPILER_H */