mirror of
https://github.com/ARM-software/arm-trusted-firmware.git
synced 2025-04-17 01:54:22 +00:00
7a24cba5c2
This patch changes the build time behaviour when using deprecated API within Trusted Firmware. Previously the use of deprecated APIs would only trigger a build warning (which was always treated as a build error), when WARN_DEPRECATED = 1. Now, the use of deprecated C declarations will always trigger a build time warning. Whether this warning is treated as error or not is determined by the build flag ERROR_DEPRECATED which is disabled by default. When the build flag ERROR_DEPRECATED=1, the invocation of deprecated API or inclusion of deprecated headers will result in a build error. Also the deprecated context management helpers in context_mgmt.c are now conditionally compiled depending on the value of ERROR_DEPRECATED flag so that the APIs themselves do not result in a build error when the ERROR_DEPRECATED flag is set. NOTE: Build systems that use the macro WARN_DEPRECATED must migrate to using ERROR_DEPRECATED, otherwise deprecated API usage will no longer trigger a build error. Change-Id: I843bceef6bde979af7e9b51dddf861035ec7965a
78 lines
3.2 KiB
C
78 lines
3.2 KiB
C
/*
|
|
* Copyright (c) 2015, ARM Limited and Contributors. All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* Redistributions of source code must retain the above copyright notice, this
|
|
* list of conditions and the following disclaimer.
|
|
*
|
|
* 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.
|
|
*
|
|
* Neither the name of ARM 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.
|
|
*/
|
|
#ifndef __COMMON_DEF_H__
|
|
#define __COMMON_DEF_H__
|
|
|
|
/******************************************************************************
|
|
* Required platform porting definitions that are expected to be common to
|
|
* all platforms
|
|
*****************************************************************************/
|
|
|
|
/*
|
|
* Platform binary types for linking
|
|
*/
|
|
#define PLATFORM_LINKER_FORMAT "elf64-littleaarch64"
|
|
#define PLATFORM_LINKER_ARCH aarch64
|
|
|
|
|
|
/*
|
|
* Generic platform constants
|
|
*/
|
|
#define FIRMWARE_WELCOME_STR "Booting Trusted Firmware\n"
|
|
|
|
/*
|
|
* Some of the platform porting definitions use the 'ull' suffix in order to
|
|
* avoid subtle integer overflow errors due to implicit integer type promotion
|
|
* when working with 32-bit values.
|
|
*
|
|
* The TSP linker script includes some of these definitions to define the BL3-2
|
|
* memory map, but the GNU LD does not support the 'ull' suffix, causing the
|
|
* build process to fail. To solve this problem, the auxiliary macro MAKE_ULL(x)
|
|
* will add the 'ull' suffix only when the macro __LINKER__ is not defined
|
|
* (__LINKER__ is defined in the command line to preprocess the linker script).
|
|
* Constants in the linker script will not have the 'ull' suffix, but this is
|
|
* not a problem since the linker evaluates all constant expressions to 64 bit
|
|
* (assuming the target architecture is 64 bit).
|
|
*/
|
|
#ifndef __LINKER__
|
|
#define MAKE_ULL(x) x##ull
|
|
#else
|
|
#define MAKE_ULL(x) x
|
|
#endif
|
|
|
|
/*
|
|
* Macros to wrap declarations of deprecated APIs within Trusted Firmware.
|
|
* The callers of these APIs will continue to compile with a warning as long
|
|
* as the build flag ERROR_DEPRECATED is zero.
|
|
*/
|
|
#define __warn_deprecated __attribute__ ((deprecated))
|
|
|
|
#endif /* __COMMON_DEF_H__ */
|
|
|