mirror of
https://github.com/jerryscript-project/jerryscript.git
synced 2025-12-15 16:29:21 +00:00
* Fix "end of file while inside a group" doxygen warnings. * Fix "unknown command" doxygen warnings caused by incorrect argument references. Instead of `@foo`, `@a foo` is the proper format. * Fix "unknown command" doxygen warnings caused by incorrect parameter direction specifications. Instead of `@in`, `@out`, and `@in-out`, `[in]`, `[out]`, and `[in,out]` are the proper formats. * Wrapping special characters in quotes to avoid doxygen confusion. Raw pipe, semicolon, dot, backslash, etc. characters can drive doxygen into various misinterpretations and warnings. E.g.: ``` End of list marker found without any preceding list items Found unknown command ``` Putting quotes around such text snipets eliminates the errors. * Fix the documentation of `ecma_builtin_global_object_print`. Raw <> and \ sequences confused doxygen in various ways (it tried to interpret them as XML tags and doxygen commands). * Fix "ignoring title that does not match old title" doxygen warnings. At some places, the group titles were out of sync, at others, the group names were incorrect. * Fix "parameters are not documented" doxygen warnings. Fixing various typos in the inline parameter documentations (`/*`, `/**`, `/** <`, and `/**>` are all considered incorrect, the right format is `/**<`). JerryScript-DCO-1.0-Signed-off-by: Akos Kiss akiss@inf.u-szeged.hu
160 lines
4.1 KiB
C
160 lines
4.1 KiB
C
/* Copyright 2014-2015 Samsung Electronics Co., Ltd.
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
/**
|
|
* Implementation of exit with specified status code.
|
|
*/
|
|
|
|
#include "jrt.h"
|
|
#include "jrt-libc-includes.h"
|
|
|
|
#define JERRY_INTERNAL
|
|
#include "jerry-internal.h"
|
|
|
|
/*
|
|
* Exit with specified status code.
|
|
*
|
|
* If !JERRY_NDEBUG and code != 0, print status code with description
|
|
* and call assertion fail handler.
|
|
*/
|
|
void __noreturn
|
|
jerry_fatal (jerry_fatal_code_t code) /**< status code */
|
|
{
|
|
#ifndef JERRY_NDEBUG
|
|
printf ("Error: ");
|
|
|
|
switch (code)
|
|
{
|
|
case ERR_OUT_OF_MEMORY:
|
|
{
|
|
printf ("ERR_OUT_OF_MEMORY\n");
|
|
break;
|
|
}
|
|
case ERR_SYSCALL:
|
|
{
|
|
/* print nothing as it may invoke syscall recursively */
|
|
break;
|
|
}
|
|
case ERR_REF_COUNT_LIMIT:
|
|
{
|
|
printf ("ERR_REF_COUNT_LIMIT\n");
|
|
break;
|
|
}
|
|
case ERR_UNIMPLEMENTED_CASE:
|
|
{
|
|
printf ("ERR_UNIMPLEMENTED_CASE\n");
|
|
break;
|
|
}
|
|
case ERR_FAILED_INTERNAL_ASSERTION:
|
|
{
|
|
printf ("ERR_FAILED_INTERNAL_ASSERTION\n");
|
|
break;
|
|
}
|
|
}
|
|
#endif /* !JERRY_NDEBUG */
|
|
|
|
if (code != 0
|
|
&& code != ERR_OUT_OF_MEMORY
|
|
&& jerry_is_abort_on_fail ())
|
|
{
|
|
abort ();
|
|
}
|
|
else
|
|
{
|
|
exit (code);
|
|
}
|
|
|
|
/* to make compiler happy for some RTOS: 'control reaches end of non-void function' */
|
|
while (true)
|
|
{
|
|
}
|
|
} /* jerry_fatal */
|
|
|
|
/**
|
|
* Handle failed assertion
|
|
*/
|
|
void __noreturn
|
|
jerry_assert_fail (const char *assertion, /**< assertion condition string */
|
|
const char *file, /**< file name */
|
|
const char *function, /**< function name */
|
|
const uint32_t line) /**< line */
|
|
{
|
|
#if !defined (JERRY_NDEBUG) || !defined (JERRY_DISABLE_HEAVY_DEBUG)
|
|
printf ("ICE: Assertion '%s' failed at %s(%s):%lu.\n",
|
|
assertion, file, function, (unsigned long) line);
|
|
#else /* !JERRY_NDEBUG || !JERRY_DISABLE_HEAVY_DEBUG */
|
|
(void) assertion;
|
|
(void) file;
|
|
(void) function;
|
|
(void) line;
|
|
#endif /* JERRY_NDEBUG && JERRY_DISABLE_HEAVY_DEBUG */
|
|
|
|
jerry_fatal (ERR_FAILED_INTERNAL_ASSERTION);
|
|
} /* jerry_assert_fail */
|
|
|
|
/**
|
|
* Handle execution of control path that should be unreachable
|
|
*/
|
|
void __noreturn
|
|
jerry_unreachable (const char *comment, /**< comment to unreachable mark if exists,
|
|
NULL - otherwise */
|
|
const char *file, /**< file name */
|
|
const char *function, /**< function name */
|
|
const uint32_t line) /**< line */
|
|
{
|
|
#ifndef JERRY_NDEBUG
|
|
printf ("ICE: Unreachable control path at %s(%s):%lu was executed", file, function, (unsigned long) line);
|
|
#else /* !JERRY_NDEBUG */
|
|
(void) file;
|
|
(void) function;
|
|
(void) line;
|
|
#endif /* JERRY_NDEBUG */
|
|
|
|
if (comment != NULL)
|
|
{
|
|
printf ("(%s)", comment);
|
|
}
|
|
printf (".\n");
|
|
|
|
jerry_fatal (ERR_FAILED_INTERNAL_ASSERTION);
|
|
} /* jerry_unreachable */
|
|
|
|
/**
|
|
* Handle unimplemented case execution
|
|
*/
|
|
void __noreturn
|
|
jerry_unimplemented (const char *comment, /**< comment to unimplemented mark if exists,
|
|
NULL - otherwise */
|
|
const char *file, /**< file name */
|
|
const char *function, /**< function name */
|
|
const uint32_t line) /**< line */
|
|
{
|
|
#ifndef JERRY_NDEBUG
|
|
printf ("SORRY: Unimplemented case at %s(%s):%lu was executed", file, function, (unsigned long) line);
|
|
#else /* !JERRY_NDEBUG */
|
|
(void) file;
|
|
(void) function;
|
|
(void) line;
|
|
#endif /* JERRY_NDEBUG */
|
|
|
|
if (comment != NULL)
|
|
{
|
|
printf ("(%s)", comment);
|
|
}
|
|
printf (".\n");
|
|
|
|
jerry_fatal (ERR_UNIMPLEMENTED_CASE);
|
|
} /* jerry_unimplemented */
|