e4b70a95fb
Gets rid of code that creates absolute symbols for data structures that are no longer referenced by external tools, as well as the macro that was used to generate them. The code that creates absolute symbols for context monitoring-related symbols is retained, but is now directly tied to the CONTEXT_MONITORING configuration option upon which those symbols depend. Change-Id: I6b2ce46d9ab9592a478f591cb074c4c163e9ba0f Signed-off-by: Allan Stephens <allan.stephens@windriver.com>
139 lines
4.7 KiB
C
139 lines
4.7 KiB
C
/* genOffset.h - macros to generate structure member offset definitions */
|
|
|
|
/*
|
|
* Copyright (c) 2010, 2012, 2014 Wind River Systems, Inc.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* 1) Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
*
|
|
* 2) Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
*
|
|
* 3) Neither the name of Wind River Systems nor the names of its contributors
|
|
* may be used to endorse or promote products derived from this software without
|
|
* specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
|
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
/*
|
|
DESCRIPTION
|
|
This header contains macros to allow a nanokernel implementation to
|
|
generate absolute symbols whose values represents the member offsets for
|
|
various nanokernel structures. These absolute symbols are typically
|
|
utilized by assembly source files rather than hardcoding the values in
|
|
some local header file.
|
|
|
|
WARNING: Absolute symbols can potentially be utilized by external tools --
|
|
for example, to locate a specific field within a data structure. Consequently,
|
|
changes made to such symbols may require modifications to the associated
|
|
tool(s). Typically, relocating a member of a structure merely requires
|
|
that a tool be rebuilt; however, moving a member to another structure
|
|
(or to a new sub-structure within an existing structure) may require that
|
|
the tool itself be modified. Likewise, deleting, renaming, or changing the
|
|
meaning of an absolute symbol may require modifications to a tool.
|
|
|
|
|
|
The macro "GEN_OFFSET_SYM(structure, member)" is used to generate a single
|
|
absolute symbol. The absolute symbol will appear in the object module
|
|
generated from the source file that utilizes the GEN_OFFSET_SYM() macro.
|
|
Absolute symbols representing a structure member offset have the following
|
|
form:
|
|
|
|
__<structure>_<member>_OFFSET
|
|
|
|
|
|
This header also defines the GEN_ABSOLUTE_SYM macro to simply define an
|
|
absolute symbol, irrespective of whether the value represents a structure
|
|
or offset.
|
|
|
|
The following sample file illustrates the usage of the macros available
|
|
in this file:
|
|
|
|
<START of sample source file: offsets.c>
|
|
|
|
#include <genOffset.h>
|
|
|
|
/@ include struct definitions for which offsets symbols are to be generated @/
|
|
|
|
#include <nanok.h>
|
|
|
|
GEN_ABS_SYM_BEGIN (_OffsetAbsSyms) /@ the name parameter is arbitrary @/
|
|
|
|
/@ tNANO structure member offsets @/
|
|
|
|
GEN_OFFSET_SYM (tNANO, fiber);
|
|
GEN_OFFSET_SYM (tNANO, task);
|
|
GEN_OFFSET_SYM (tNANO, current);
|
|
GEN_OFFSET_SYM (tNANO, nested);
|
|
GEN_OFFSET_SYM (tNANO, common_isp);
|
|
|
|
GEN_ABSOLUTE_SYM (__tNANO_SIZEOF, sizeof(tNANO));
|
|
|
|
GEN_ABS_SYM_END
|
|
|
|
<END of sample source file: offsets.c>
|
|
|
|
Compiling the sample offsets.c results in the following symbols in offsets.o:
|
|
|
|
$ nm offsets.o
|
|
00000010 A __tNANO_common_isp_OFFSET
|
|
00000008 A __tNANO_current_OFFSET
|
|
0000000c A __tNANO_nested_OFFSET
|
|
00000000 A __tNANO_fiber_OFFSET
|
|
00000004 A __tNANO_task_OFFSET
|
|
|
|
|
|
\NOMANUAL
|
|
*/
|
|
|
|
#ifndef _GEN_OFFSET_H
|
|
#define _GEN_OFFSET_H
|
|
|
|
/*#include "../../../../../include/absSym.h"*/
|
|
#include <absSym.h>
|
|
#include <stddef.h>
|
|
|
|
#ifdef __GNUC__
|
|
|
|
/* create an extern reference to the absolute symbol */
|
|
|
|
#define GEN_OFFSET_EXTERN(name) extern const char name[]
|
|
|
|
#elif defined(__DCC__)
|
|
|
|
/* create an extern reference to the absolute symbol */
|
|
|
|
#define GEN_OFFSET_EXTERN(name) extern const char name[]
|
|
|
|
#else /* unsupported toolchain */
|
|
|
|
#define GEN_OFFSET_EXTERN(name) \
|
|
#error GEN_OFFSET_EXTERN macro used with unsupported toolchain
|
|
|
|
#define GEN_OFFSET_SYM(name) \
|
|
#error GEN_OFFSET_SYM macro used with unsupported toolchain
|
|
|
|
#endif /* end of "unsupported toolchain" */
|
|
|
|
/* definition of the GEN_OFFSET_SYM() macros is toolchain independant */
|
|
|
|
#define GEN_OFFSET_SYM(S, M) \
|
|
GEN_ABSOLUTE_SYM(__##S##_##M##_##OFFSET, offsetof(S, M))
|
|
|
|
#endif /* _GEN_OFFSET_H */
|