mirror of
https://github.com/jerryscript-project/jerryscript.git
synced 2025-12-15 16:29:21 +00:00
fdbbd0e8af
This commit changes the concept of JerryScript port implementations
from a simple directory of C source files (which get injected among
the sources of `jerry-core`) into a proper static library (which
may be linked to an application together with `jerry-core`). As a
consequence, this commit introduces a new library to the
JerryScript component architecture: the sources of the default port
implementation form `jerry-port-default`.
Changes in more detail:
- The sources in `targets/default` are moved to `jerry-port/default`
and are turned into a proper static library.
- Actually, the default port implementation has two library
variants, one that implements the bare minimum only
(`jerry-port-default-minimal`) and one that has some extra
functionalities specific to this implementation (the "full"
`jerry-port-default`).
- The new libraries have an interface header in
`jerry-port/default/include`, which extends the common
`jerryscript-port.h` API with functions specific to these
libraries.
- All non-standard port functions have now the
`jerry_port_default_` prefix (this affects `jobqueue_init` and
`jobqueue_run`).
- The jobqueue implementation functions became config macro
independent: it is now the responsibility of the linker to pick
the needed objects from the library, and omit those (e.g.,
jobqueue-related code) that are not referenced.
- Build of the libraries can be controlled with the new
`JERRY_PORT_DEFAULT` cmake option.
- The cmake option `PORT_DIR` is dropped, and `PORT_DIR/*.c` is not
appended to `jerry-core` sources.
- Instead, the `jerry` tool of `jerry-main` links to
`jerry-port-default`, while `jerry-minimal` links to
`jerry-port-default-minimal`.
- `tests/unit-core` tests are also linked to
`jerry-port-default-minimal`.
- Tools adapted.
- `build.py` has `--jerry-port-default` instead of `--port-dir`.
- `check-*.sh` have paths updated (`jerry-port/default` instead
of `targets/default`).
- Miscellaneous.
- Dropped `#ifndef`s from `jerryscript-port.h`. It is a public
header of the `jerry-core` library, which means that it must
not contain configuration-dependent parts (once the library is
built with some config macros and the archive and the headers
are installed, there is no way for the header to tell what
those config macrose were).
- Added documentation comments to the JobQueue Port API (in
`jerryscript-port.h`) and to several default port
implementation functions (in `jerry-port/default`).
JerryScript-DCO-1.0-Signed-off-by: Akos Kiss akiss@inf.u-szeged.hu
81 lines
2.4 KiB
C
81 lines
2.4 KiB
C
/* Copyright JS Foundation and other contributors, http://js.foundation
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
#include <stdlib.h>
|
|
|
|
#include "jerryscript-port.h"
|
|
#include "jerryscript-port-default.h"
|
|
|
|
#ifndef DISABLE_EXTRA_API
|
|
|
|
static bool abort_on_fail = false;
|
|
|
|
/**
|
|
* Sets whether 'abort' should be called instead of 'exit' upon exiting with
|
|
* non-zero exit code in the default implementation of jerry_port_fatal.
|
|
*
|
|
* Note:
|
|
* This function is only available if the port implementation library is
|
|
* compiled without the DISABLE_EXTRA_API macro.
|
|
*/
|
|
void jerry_port_default_set_abort_on_fail (bool flag) /**< new value of 'abort on fail' flag */
|
|
{
|
|
abort_on_fail = flag;
|
|
} /* jerry_port_default_set_abort_on_fail */
|
|
|
|
/**
|
|
* Check whether 'abort' should be called instead of 'exit' upon exiting with
|
|
* non-zero exit code in the default implementation of jerry_port_fatal.
|
|
*
|
|
* @return true - if 'abort on fail' flag is set,
|
|
* false - otherwise
|
|
*
|
|
* Note:
|
|
* This function is only available if the port implementation library is
|
|
* compiled without the DISABLE_EXTRA_API macro.
|
|
*/
|
|
bool jerry_port_default_is_abort_on_fail (void)
|
|
{
|
|
return abort_on_fail;
|
|
} /* jerry_port_default_is_abort_on_fail */
|
|
|
|
#endif /* !DISABLE_EXTRA_API */
|
|
|
|
/**
|
|
* Default implementation of jerry_port_fatal. Calls 'abort' if exit code is
|
|
* non-zero and "abort-on-fail" behaviour is enabled, 'exit' otherwise.
|
|
*
|
|
* Note:
|
|
* The "abort-on-fail" behaviour is only available if the port
|
|
* implementation library is compiled without the DISABLE_EXTRA_API macro.
|
|
*/
|
|
void jerry_port_fatal (jerry_fatal_code_t code)
|
|
{
|
|
#ifndef DISABLE_EXTRA_API
|
|
if (code != 0
|
|
&& code != ERR_OUT_OF_MEMORY
|
|
&& jerry_port_default_is_abort_on_fail ())
|
|
{
|
|
abort ();
|
|
}
|
|
else
|
|
{
|
|
#endif /* !DISABLE_EXTRA_API */
|
|
exit (code);
|
|
#ifndef DISABLE_EXTRA_API
|
|
}
|
|
#endif /* !DISABLE_EXTRA_API */
|
|
} /* jerry_port_fatal */
|