1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
/* Copyright (c) 2013, Linaro Limited
* All rights reserved.
*
* SPDX-License-Identifier: BSD-3-Clause
*/
/**
* @file
*
* ODP compiler hints
*/
#ifndef ODP_API_HINTS_H_
#define ODP_API_HINTS_H_
#include <odp/visibility_begin.h>
#ifdef __cplusplus
extern "C" {
#endif
/** @addtogroup odp_compiler_optim
* Macros that will give hints to the compiler.
* @{
*/
#ifdef __GNUC__
/** Define a function that does not return
*/
#define ODP_NORETURN __attribute__((__noreturn__))
/** Define a weak symbol
* This is primarily useful in defining library functions that can be
* overridden in user code.
*/
#define ODP_WEAK_SYMBOL __attribute__((__weak__))
/**
* Hot code section
*/
#define ODP_HOT_CODE __attribute__((__hot__))
/**
* Cold code section
*/
#define ODP_COLD_CODE __attribute__((__cold__))
/**
* Printf format attribute
*/
#define ODP_PRINTF_FORMAT(x, y) __attribute__((format(printf, (x), (y))))
/**
* Indicate deprecated variables, functions or types
*/
#define ODP_DEPRECATED __attribute__((__deprecated__))
/**
* Intentionally unused variables of functions
*/
#define ODP_UNUSED __attribute__((__unused__))
/**
* Branch likely taken
*/
#define odp_likely(x) __builtin_expect((x), 1)
/**
* Branch unlikely taken
*/
#define odp_unlikely(x) __builtin_expect((x), 0)
/*
* __builtin_prefetch (const void *addr, rw, locality)
*
* rw 0..1 (0: read, 1: write)
* locality 0..3 (0: dont leave to cache, 3: leave on all cache levels)
*/
/**
* Cache prefetch address
*/
#define odp_prefetch(x) __builtin_prefetch((x), 0, 3)
/**
* Cache prefetch address for storing
*/
#define odp_prefetch_store(x) __builtin_prefetch((x), 1, 3)
#else
#define ODP_WEAK_SYMBOL
#define ODP_HOT_CODE
#define ODP_COLD_CODE
#define ODP_DEPRECATED
#define ODP_UNUSED
#define odp_likely(x)
#define odp_unlikely(x)
#define odp_prefetch(x)
#define odp_prefetch_store(x)
#endif
/**
* @}
*/
#ifdef __cplusplus
}
#endif
#include <odp/visibility_end.h>
#endif
|
