mirror of
https://github.com/jerryscript-project/jerryscript.git
synced 2025-12-15 16:29:21 +00:00
a2d5acb43c
This patch: * Ensures that all calls to `jerry_port_log` in jerry-core happen via macros defined in jrt.h. Also, it unifies the names of those macros: as `JERRY_ERROR_MSG` and `JERRY_WARNING_MSG` gave a good pattern that was well aligned with the naming scheme of the log level enum, `JERRY_DLOG` and `JERRY_DDLOG` were rewritten to `JERRY_DEBUG_MSG` and `JERRY_TRACE_MSG`. * Ensures that all debug logging code parts of jerry-core (i.e., memory statistics, JS byte-code dumps, and RegExp byte-code dumps) are guarded by macros: `JMEM_STATS`, `PARSER_DUMP_BYTE_CODE`, and `REGEXP_DUMP_BYTE_CODE`, which in turn are controled by cmake build system feature flags `FEATURE_MEM_STATS`, `FEATURE_PARSER_DUMP`, and `FEATURE_REGEXP_DUMP`. * Ensures that all debug logging functionalities can be controled during run time (provided that they were enabled during build time): the engine has `JERRY_INIT_MEM_STATS[_SEPARATE]`, `JERRY_INIT_SHOW_OPCODES`, `JERRY_INIT_SHOW_REGEXP_OPCODES` init flags, and the default unix/linux command line app has corresponding command line switches.` * Drops `FEATURE_LOG`, `JERRY_ENABLE_LOG`, and `JERRY_INIT_ENABLE_LOG`, as their name was misleadingly general, even though they mostly controled the regexp engine only. The above-mentioned `*REGEXP*` things mostly act as their replacements. * Updates build, test, and measurement tool scripts, and documentation. JerryScript-DCO-1.0-Signed-off-by: Akos Kiss akiss@inf.u-szeged.hu
146 lines
4.0 KiB
C
146 lines
4.0 KiB
C
/* Copyright 2014-2016 Samsung Electronics Co., Ltd.
|
|
* Copyright 2016 University of Szeged.
|
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#ifndef JRT_H
|
|
#define JRT_H
|
|
|
|
#include <stdio.h>
|
|
#include <string.h>
|
|
|
|
#include "jerry-api.h"
|
|
#include "jerry-port.h"
|
|
#include "jrt-types.h"
|
|
|
|
/*
|
|
* Attributes
|
|
*/
|
|
#define __noreturn __attribute__((noreturn))
|
|
#define __attr_noinline___ __attribute__((noinline))
|
|
#define __attr_return_value_should_be_checked___ __attribute__((warn_unused_result))
|
|
#ifndef __attr_always_inline___
|
|
# define __attr_always_inline___ __attribute__((always_inline))
|
|
#endif /* !__attr_always_inline___ */
|
|
#ifndef __attr_const___
|
|
# define __attr_const___ __attribute__((const))
|
|
#endif /* !__attr_const___ */
|
|
#ifndef __attr_pure___
|
|
# define __attr_pure___ __attribute__((pure))
|
|
#endif /* !__attr_pure___ */
|
|
|
|
/*
|
|
* Conditions' likeliness, unlikeliness.
|
|
*/
|
|
#define likely(x) __builtin_expect (!!(x), 1)
|
|
#define unlikely(x) __builtin_expect (!!(x) , 0)
|
|
|
|
/*
|
|
* Normally compilers store const(ant)s in ROM. Thus saving RAM.
|
|
* But if your compiler does not support it then the directive below can force it.
|
|
*
|
|
* For the moment it is mainly meant for the following targets:
|
|
* - ESP8266
|
|
*/
|
|
#ifndef JERRY_CONST_DATA
|
|
# define JERRY_CONST_DATA
|
|
#endif /* JERRY_CONST_DATA */
|
|
|
|
/*
|
|
* Constants
|
|
*/
|
|
#define JERRY_BITSINBYTE 8
|
|
|
|
/*
|
|
* Make sure unused parameters, variables, or expressions trigger no compiler warning.
|
|
*/
|
|
#define JERRY_UNUSED(x) ((void) (x))
|
|
|
|
/*
|
|
* Asserts
|
|
*
|
|
* Warning:
|
|
* Don't use JERRY_STATIC_ASSERT in headers, because
|
|
* __LINE__ may be the same for asserts in a header
|
|
* and in an implementation file.
|
|
*/
|
|
#define JERRY_STATIC_ASSERT_GLUE_(a, b, c) a ## b ## _ ## c
|
|
#define JERRY_STATIC_ASSERT_GLUE(a, b, c) JERRY_STATIC_ASSERT_GLUE_ (a, b, c)
|
|
#define JERRY_STATIC_ASSERT(x, msg) \
|
|
enum { JERRY_STATIC_ASSERT_GLUE (static_assertion_failed_, __LINE__, msg) = 1 / (!!(x)) }
|
|
|
|
#ifndef JERRY_NDEBUG
|
|
extern void __noreturn jerry_assert_fail (const char *, const char *, const char *, const uint32_t);
|
|
extern void __noreturn jerry_unreachable (const char *, const char *, const uint32_t);
|
|
|
|
#define JERRY_ASSERT(x) \
|
|
do \
|
|
{ \
|
|
if (unlikely (!(x))) \
|
|
{ \
|
|
jerry_assert_fail (#x, __FILE__, __func__, __LINE__); \
|
|
} \
|
|
} while (0)
|
|
|
|
#define JERRY_UNREACHABLE() \
|
|
do \
|
|
{ \
|
|
jerry_unreachable (__FILE__, __func__, __LINE__); \
|
|
} while (0)
|
|
#else /* JERRY_NDEBUG */
|
|
#define JERRY_ASSERT(x) \
|
|
do \
|
|
{ \
|
|
if (false) \
|
|
{ \
|
|
JERRY_UNUSED (x); \
|
|
} \
|
|
} while (0)
|
|
|
|
#define JERRY_UNREACHABLE() __builtin_unreachable ()
|
|
#endif /* !JERRY_NDEBUG */
|
|
|
|
/**
|
|
* Exit on fatal error
|
|
*/
|
|
extern void __noreturn jerry_fatal (jerry_fatal_code_t);
|
|
|
|
/*
|
|
* Logging
|
|
*/
|
|
#define JERRY_ERROR_MSG(...) jerry_port_log (JERRY_LOG_LEVEL_ERROR, __VA_ARGS__)
|
|
#define JERRY_WARNING_MSG(...) jerry_port_log (JERRY_LOG_LEVEL_WARNING, __VA_ARGS__)
|
|
#define JERRY_DEBUG_MSG(...) jerry_port_log (JERRY_LOG_LEVEL_DEBUG, __VA_ARGS__)
|
|
#define JERRY_TRACE_MSG(...) jerry_port_log (JERRY_LOG_LEVEL_TRACE, __VA_ARGS__)
|
|
|
|
/**
|
|
* Size of struct member
|
|
*/
|
|
#define JERRY_SIZE_OF_STRUCT_MEMBER(struct_name, member_name) sizeof (((struct_name *) NULL)->member_name)
|
|
|
|
/**
|
|
* Aligns @a value to @a alignment. @a must be the power of 2.
|
|
*
|
|
* Returns minimum positive value, that divides @a alignment and is more than or equal to @a value
|
|
*/
|
|
#define JERRY_ALIGNUP(value, alignment) (((value) + ((alignment) - 1)) & ~((alignment) - 1))
|
|
|
|
/*
|
|
* min, max
|
|
*/
|
|
#define JERRY_MIN(v1, v2) (((v1) < (v2)) ? (v1) : (v2))
|
|
#define JERRY_MAX(v1, v2) (((v1) < (v2)) ? (v2) : (v1))
|
|
|
|
#endif /* !JRT_H */
|