[J-u-boot.git] / include / linux / compiler-gcc.h

#ifndef __LINUX_COMPILER_H
#error "Please don't include <linux/compiler-gcc.h> directly, include <linux/compiler.h> instead."
#endif

/*
 * Common definitions for all gcc versions go here.
 */
#define GCC_VERSION (__GNUC__ * 10000 \
		   + __GNUC_MINOR__ * 100 \
		   + __GNUC_PATCHLEVEL__)


/* Optimization barrier */
/* The "volatile" is due to gcc bugs */
#define barrier() __asm__ __volatile__("": : :"memory")

/*
 * This macro obfuscates arithmetic on a variable address so that gcc
 * shouldn't recognize the original var, and make assumptions about it.
 *
 * This is needed because the C standard makes it undefined to do
 * pointer arithmetic on "objects" outside their boundaries and the
 * gcc optimizers assume this is the case. In particular they
 * assume such arithmetic does not wrap.
 *
 * A miscompilation has been observed because of this on PPC.
 * To work around it we hide the relationship of the pointer and the object
 * using this macro.
 *
 * Versions of the ppc64 compiler before 4.1 had a bug where use of
 * RELOC_HIDE could trash r30. The bug can be worked around by changing
 * the inline assembly constraint from =g to =r, in this particular
 * case either is valid.
 */
#define RELOC_HIDE(ptr, off)					\
  ({ unsigned long __ptr;					\
    __asm__ ("" : "=r"(__ptr) : "0"(ptr));		\
    (typeof(ptr)) (__ptr + (off)); })

/* Make the optimizer believe the variable can be manipulated arbitrarily. */
#define OPTIMIZER_HIDE_VAR(var) __asm__ ("" : "=r" (var) : "0" (var))

#ifdef __CHECKER__
#define __must_be_array(arr) 0
#else
/* &a[0] degrades to a pointer: a different type from an array */
#define __must_be_array(a) BUILD_BUG_ON_ZERO(__same_type((a), &(a)[0]))
#endif

/*
 * Force always-inline if the user requests it so via the .config,
 * or if gcc is too old:
 */
#if !defined(CONFIG_ARCH_SUPPORTS_OPTIMIZED_INLINING) || \
    !defined(CONFIG_OPTIMIZE_INLINING) || (__GNUC__ < 4)
# define inline		inline		__attribute__((always_inline)) notrace
# define __inline__	__inline__	__attribute__((always_inline)) notrace
# define __inline	__inline	__attribute__((always_inline)) notrace
#else
/* A lot of inline functions can cause havoc with function tracing */
# define inline		inline		notrace
# define __inline__	__inline__	notrace
# define __inline	__inline	notrace
#endif

#define __deprecated			__attribute__((deprecated))
#ifndef __packed
#define __packed			__attribute__((packed))
#endif
#ifndef __weak
#define __weak				__attribute__((weak))
#endif

/*
 * it doesn't make sense on ARM (currently the only user of __naked) to trace
 * naked functions because then mcount is called without stack and frame pointer
 * being set up and there is no chance to restore the lr register to the value
 * before mcount was called.
 *
 * The asm() bodies of naked functions often depend on standard calling conventions,
 * therefore they must be noinline and noclone.  GCC 4.[56] currently fail to enforce
 * this, so we must do so ourselves.  See GCC PR44290.
 */
#define __naked				__attribute__((naked)) noinline __noclone notrace

#define __noreturn			__attribute__((noreturn))

/*
 * From the GCC manual:
 *
 * Many functions have no effects except the return value and their
 * return value depends only on the parameters and/or global
 * variables.  Such a function can be subject to common subexpression
 * elimination and loop optimization just as an arithmetic operator
 * would be.
 * [...]
 */
#ifndef __pure
#define __pure				__attribute__((pure))
#endif
#ifndef __aligned
#define __aligned(x)			__attribute__((aligned(x)))
#endif
#define __printf(a, b)			__attribute__((format(printf, a, b)))
#define __scanf(a, b)			__attribute__((format(scanf, a, b)))
#define  noinline			__attribute__((noinline))
#define __attribute_const__		__attribute__((__const__))
#define __maybe_unused			__attribute__((unused))
#define __always_unused			__attribute__((unused))

#define __gcc_header(x) #x
#define _gcc_header(x) __gcc_header(linux/compiler-gcc##x.h)
#define gcc_header(x) _gcc_header(x)
#include gcc_header(__GNUC__)

#if !defined(__noclone)
#define __noclone	/* not needed */
#endif

/*
 * A trick to suppress uninitialized variable warning without generating any
 * code
 */
#define uninitialized_var(x) x = x

#ifndef __always_inline
#define __always_inline		inline __attribute__((always_inline))
#endif
Commit	Line	Data
95ffaba3 GR	1	#ifndef __LINUX_COMPILER_H
	2	#error "Please don't include <linux/compiler-gcc.h> directly, include <linux/compiler.h> instead."
	3	#endif
	4
	5	/*
	6	* Common definitions for all gcc versions go here.
	7	*/
fb8ffd7c MY	8	#define GCC_VERSION (__GNUC__ * 10000 \
	9	+ __GNUC_MINOR__ * 100 \
	10	+ __GNUC_PATCHLEVEL__)
95ffaba3 GR	11
	12
	13	/* Optimization barrier */
	14	/* The "volatile" is due to gcc bugs */
	15	#define barrier() __asm__ __volatile__("": : :"memory")
	16
	17	/*
	18	* This macro obfuscates arithmetic on a variable address so that gcc
	19	* shouldn't recognize the original var, and make assumptions about it.
	20	*
	21	* This is needed because the C standard makes it undefined to do
	22	* pointer arithmetic on "objects" outside their boundaries and the
	23	* gcc optimizers assume this is the case. In particular they
	24	* assume such arithmetic does not wrap.
	25	*
	26	* A miscompilation has been observed because of this on PPC.
	27	* To work around it we hide the relationship of the pointer and the object
	28	* using this macro.
	29	*
	30	* Versions of the ppc64 compiler before 4.1 had a bug where use of
	31	* RELOC_HIDE could trash r30. The bug can be worked around by changing
	32	* the inline assembly constraint from =g to =r, in this particular
	33	* case either is valid.
	34	*/
	35	#define RELOC_HIDE(ptr, off) \
	36	({ unsigned long __ptr; \
	37	__asm__ ("" : "=r"(__ptr) : "0"(ptr)); \
	38	(typeof(ptr)) (__ptr + (off)); })
	39
fb8ffd7c MY	40	/* Make the optimizer believe the variable can be manipulated arbitrarily. */
	41	#define OPTIMIZER_HIDE_VAR(var) __asm__ ("" : "=r" (var) : "0" (var))
	42
	43	#ifdef __CHECKER__
	44	#define __must_be_array(arr) 0
	45	#else
95ffaba3	46	/* &a[0] degrades to a pointer: a different type from an array */
fb8ffd7c MY	47	#define __must_be_array(a) BUILD_BUG_ON_ZERO(__same_type((a), &(a)[0]))
fb8ffd7c MY	48	#endif
95ffaba3 GR	49
	50	/*
	51	* Force always-inline if the user requests it so via the .config,
	52	* or if gcc is too old:
	53	*/
	54	#if !defined(CONFIG_ARCH_SUPPORTS_OPTIMIZED_INLINING) \|\| \
	55	!defined(CONFIG_OPTIMIZE_INLINING) \|\| (__GNUC__ < 4)
fb8ffd7c MY	56	# define inline inline __attribute__((always_inline)) notrace
	57	# define __inline__ __inline__ __attribute__((always_inline)) notrace
	58	# define __inline __inline __attribute__((always_inline)) notrace
	59	#else
	60	/* A lot of inline functions can cause havoc with function tracing */
	61	# define inline inline notrace
	62	# define __inline__ __inline__ notrace
	63	# define __inline __inline notrace
95ffaba3 GR	64	#endif
	65
	66	#define __deprecated __attribute__((deprecated))
0a5051ce	67	#ifndef __packed
fb8ffd7c	68	#define __packed __attribute__((packed))
0a5051ce JH	69	#endif
0a5051ce JH	70	#ifndef __weak
95ffaba3	71	#define __weak __attribute__((weak))
0a5051ce	72	#endif
95ffaba3 GR	73
	74	/*
	75	* it doesn't make sense on ARM (currently the only user of __naked) to trace
	76	* naked functions because then mcount is called without stack and frame pointer
	77	* being set up and there is no chance to restore the lr register to the value
	78	* before mcount was called.
fb8ffd7c MY	79	*
	80	* The asm() bodies of naked functions often depend on standard calling conventions,
	81	* therefore they must be noinline and noclone. GCC 4.[56] currently fail to enforce
	82	* this, so we must do so ourselves. See GCC PR44290.
95ffaba3	83	*/
fb8ffd7c	84	#define __naked __attribute__((naked)) noinline __noclone notrace
95ffaba3 GR	85
	86	#define __noreturn __attribute__((noreturn))
	87
	88	/*
	89	* From the GCC manual:
	90	*
	91	* Many functions have no effects except the return value and their
	92	* return value depends only on the parameters and/or global
	93	* variables. Such a function can be subject to common subexpression
	94	* elimination and loop optimization just as an arithmetic operator
	95	* would be.
	96	* [...]
	97	*/
0a5051ce	98	#ifndef __pure
fb8ffd7c	99	#define __pure __attribute__((pure))
0a5051ce JH	100	#endif
0a5051ce JH	101	#ifndef __aligned
fb8ffd7c	102	#define __aligned(x) __attribute__((aligned(x)))
0a5051ce	103	#endif
fb8ffd7c MY	104	#define __printf(a, b) __attribute__((format(printf, a, b)))
fb8ffd7c MY	105	#define __scanf(a, b) __attribute__((format(scanf, a, b)))
95ffaba3 GR	106	#define noinline __attribute__((noinline))
	107	#define __attribute_const__ __attribute__((__const__))
	108	#define __maybe_unused __attribute__((unused))
	109	#define __always_unused __attribute__((unused))
	110
	111	#define __gcc_header(x) #x
	112	#define _gcc_header(x) __gcc_header(linux/compiler-gcc##x.h)
	113	#define gcc_header(x) _gcc_header(x)
	114	#include gcc_header(__GNUC__)
fb8ffd7c MY	115
	116	#if !defined(__noclone)
	117	#define __noclone /* not needed */
	118	#endif
	119
	120	/*
	121	* A trick to suppress uninitialized variable warning without generating any
	122	* code
	123	*/
	124	#define uninitialized_var(x) x = x
	125
0a5051ce	126	#ifndef __always_inline
fb8ffd7c	127	#define __always_inline inline __attribute__((always_inline))
0a5051ce	128	#endif