first public release
[dpdk.git] / lib / librte_eal / common / include / rte_per_lcore.h
1 /*-
2  *   BSD LICENSE
3  * 
4  *   Copyright(c) 2010-2012 Intel Corporation. All rights reserved.
5  *   All rights reserved.
6  * 
7  *   Redistribution and use in source and binary forms, with or without 
8  *   modification, are permitted provided that the following conditions 
9  *   are met:
10  * 
11  *     * Redistributions of source code must retain the above copyright 
12  *       notice, this list of conditions and the following disclaimer.
13  *     * Redistributions in binary form must reproduce the above copyright 
14  *       notice, this list of conditions and the following disclaimer in 
15  *       the documentation and/or other materials provided with the 
16  *       distribution.
17  *     * Neither the name of Intel Corporation nor the names of its 
18  *       contributors may be used to endorse or promote products derived 
19  *       from this software without specific prior written permission.
20  * 
21  *   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
22  *   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
23  *   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 
24  *   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 
25  *   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 
26  *   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 
27  *   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 
28  *   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 
29  *   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
30  *   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 
31  *   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32  * 
33  *  version: DPDK.L.1.2.3-3
34  */
35
36 #ifndef _RTE_PER_LCORE_H_
37 #define _RTE_PER_LCORE_H_
38
39 /**
40  * @file
41  *
42  * Per-lcore variables in RTE
43  *
44  * This file defines an API for instantiating per-lcore "global
45  * variables" that are environment-specific. Note that in all
46  * environments, a "shared variable" is the default when you use a
47  * global variable.
48  *
49  * Parts of this are execution environment specific.
50  */
51
52 #ifdef __cplusplus
53 extern "C" {
54 #endif
55
56 #include <exec-env/rte_per_lcore.h>
57
58 #ifdef __DOXYGEN__
59 /**
60  * Macro to define a per lcore variable "var" of type "type", don't
61  * use keywords like "static" or "volatile" in type, just prefix the
62  * whole macro.
63  */
64 #define RTE_DEFINE_PER_LCORE(type, name)
65
66 /**
67  * Macro to declare an extern per lcore variable "var" of type "type"
68  */
69 #define RTE_DECLARE_PER_LCORE(type, name)
70
71 /**
72  * Read/write the per-lcore variable value
73  */
74 #define RTE_PER_LCORE(name)
75 #endif
76
77 #ifdef __cplusplus
78 }
79 #endif
80
81 #endif /* _RTE_PER_LCORE_H_ */