Akos Kiss
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
132 lines
3.2 KiB
C
132 lines
3.2 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 "jerryscript.h"
|
|
#include "jerryscript-port.h"
|
|
#include "jerryscript-port-default.h"
|
|
#include "jmem.h"
|
|
#include "jrt.h"
|
|
|
|
typedef struct jerry_port_queueitem_t jerry_port_queueitem_t;
|
|
|
|
/**
|
|
* Description of the queue item.
|
|
*/
|
|
struct jerry_port_queueitem_t
|
|
{
|
|
jerry_port_queueitem_t *next_p; /**< points to next item */
|
|
jerry_job_handler_t handler; /**< the handler for the job*/
|
|
void *job_p; /**< points to the job */
|
|
};
|
|
|
|
/**
|
|
* Description of a job queue (FIFO).
|
|
*/
|
|
typedef struct
|
|
{
|
|
jerry_port_queueitem_t *head_p; /**< points to the head item of the queue */
|
|
jerry_port_queueitem_t *tail_p; /**< points to the tail item of the queue*/
|
|
} jerry_port_jobqueue_t;
|
|
|
|
static jerry_port_jobqueue_t queue;
|
|
|
|
/**
|
|
* Initialize the job queue.
|
|
*/
|
|
void jerry_port_default_jobqueue_init (void)
|
|
{
|
|
queue.head_p = NULL;
|
|
queue.tail_p = NULL;
|
|
} /* jerry_port_default_jobqueue_init */
|
|
|
|
/**
|
|
* Enqueue a job.
|
|
*/
|
|
void jerry_port_jobqueue_enqueue (jerry_job_handler_t handler, /**< the handler for the job */
|
|
void *job_p) /**< the job */
|
|
{
|
|
jerry_port_queueitem_t *item_p = jmem_heap_alloc_block (sizeof (jerry_port_queueitem_t));
|
|
item_p->job_p = job_p;
|
|
item_p->handler = handler;
|
|
item_p->next_p = NULL;
|
|
|
|
if (queue.head_p == NULL)
|
|
{
|
|
queue.head_p = item_p;
|
|
queue.tail_p = item_p;
|
|
|
|
return;
|
|
}
|
|
|
|
queue.tail_p->next_p = item_p;
|
|
queue.tail_p = item_p;
|
|
} /* jerry_port_jobqueue_enqueue */
|
|
|
|
/**
|
|
* Dequeue and get the job.
|
|
*
|
|
* @return pointer to jerry_port_queueitem_t.
|
|
* It should be freed with jmem_heap_free_block.
|
|
*/
|
|
static jerry_port_queueitem_t *
|
|
jerry_port_default_jobqueue_dequeue (void)
|
|
{
|
|
if (queue.head_p == NULL)
|
|
{
|
|
return NULL;
|
|
}
|
|
|
|
jerry_port_queueitem_t *item_p = queue.head_p;
|
|
queue.head_p = queue.head_p->next_p;
|
|
|
|
return item_p;
|
|
} /* jerry_port_default_jobqueue_dequeue */
|
|
|
|
/**
|
|
* Start the jobqueue.
|
|
*
|
|
* @return jerry value.
|
|
* If exception happens in the handler, stop the queue
|
|
* and return the exception.
|
|
* Otherwise, return undefined.
|
|
*/
|
|
jerry_value_t
|
|
jerry_port_default_jobqueue_run (void)
|
|
{
|
|
jerry_value_t ret;
|
|
|
|
while (true)
|
|
{
|
|
jerry_port_queueitem_t *item_p = jerry_port_default_jobqueue_dequeue ();
|
|
|
|
if (item_p == NULL)
|
|
{
|
|
return jerry_create_undefined ();
|
|
}
|
|
|
|
void *job_p = item_p->job_p;
|
|
jerry_job_handler_t handler = item_p->handler;
|
|
jmem_heap_free_block (item_p, sizeof (jerry_port_queueitem_t));
|
|
ret = handler (job_p);
|
|
|
|
if (jerry_value_has_error_flag (ret))
|
|
{
|
|
return ret;
|
|
}
|
|
|
|
jerry_release_value (ret);
|
|
}
|
|
} /* jerry_port_default_jobqueue_run */
|