mirror of
https://github.com/jerryscript-project/jerryscript.git
synced 2025-12-15 16:29:21 +00:00
77ccdcc585
- The context reset request message can be sent anytime from a client. - After the message received the engine will call the cleanup and init when in the source waiting mode (which means the currently processed file will be executed). - After the reinitialization is done, the engine will wait for a new client connection(rest of the work is the client's responsibility). JerryScript-DCO-1.0-Signed-off-by: Imre Kiss kissi.szeged@partner.samsung.com
225 lines
7.5 KiB
C
225 lines
7.5 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 "debugger.h"
|
|
#include "jcontext.h"
|
|
#include "jerryscript.h"
|
|
|
|
/**
|
|
* Checks whether the debugger is connected.
|
|
*
|
|
* @return true - if the debugger is connected
|
|
* false - otherwise
|
|
*/
|
|
bool
|
|
jerry_debugger_is_connected (void)
|
|
{
|
|
#ifdef JERRY_DEBUGGER
|
|
return JERRY_CONTEXT (debugger_flags) & JERRY_DEBUGGER_CONNECTED;
|
|
#else
|
|
return false;
|
|
#endif /* JERRY_DEBUGGER */
|
|
} /* jerry_debugger_is_connected */
|
|
|
|
/**
|
|
* Stop execution at the next available breakpoint.
|
|
*/
|
|
void
|
|
jerry_debugger_stop (void)
|
|
{
|
|
#ifdef JERRY_DEBUGGER
|
|
if ((JERRY_CONTEXT (debugger_flags) & JERRY_DEBUGGER_CONNECTED)
|
|
&& !(JERRY_CONTEXT (debugger_flags) & JERRY_DEBUGGER_BREAKPOINT_MODE))
|
|
{
|
|
JERRY_CONTEXT (debugger_flags) = (uint8_t) (JERRY_CONTEXT (debugger_flags) | JERRY_DEBUGGER_VM_STOP);
|
|
JERRY_CONTEXT (debugger_stop_context) = NULL;
|
|
}
|
|
#endif /* JERRY_DEBUGGER */
|
|
} /* jerry_debugger_stop */
|
|
|
|
/**
|
|
* Continue execution.
|
|
*/
|
|
void
|
|
jerry_debugger_continue (void)
|
|
{
|
|
#ifdef JERRY_DEBUGGER
|
|
if ((JERRY_CONTEXT (debugger_flags) & JERRY_DEBUGGER_CONNECTED)
|
|
&& !(JERRY_CONTEXT (debugger_flags) & JERRY_DEBUGGER_BREAKPOINT_MODE))
|
|
{
|
|
JERRY_CONTEXT (debugger_flags) = (uint8_t) (JERRY_CONTEXT (debugger_flags) & ~JERRY_DEBUGGER_VM_STOP);
|
|
JERRY_CONTEXT (debugger_stop_context) = NULL;
|
|
}
|
|
#endif /* JERRY_DEBUGGER */
|
|
} /* jerry_debugger_continue */
|
|
|
|
/**
|
|
* Sets whether the engine should stop at breakpoints.
|
|
*/
|
|
void
|
|
jerry_debugger_stop_at_breakpoint (bool enable_stop_at_breakpoint) /**< enable/disable stop at breakpoint */
|
|
{
|
|
#ifdef JERRY_DEBUGGER
|
|
if (JERRY_CONTEXT (debugger_flags) & JERRY_DEBUGGER_CONNECTED
|
|
&& !(JERRY_CONTEXT (debugger_flags) & JERRY_DEBUGGER_BREAKPOINT_MODE))
|
|
{
|
|
if (enable_stop_at_breakpoint)
|
|
{
|
|
JERRY_CONTEXT (debugger_flags) = (uint8_t) (JERRY_CONTEXT (debugger_flags) | JERRY_DEBUGGER_VM_IGNORE);
|
|
}
|
|
else
|
|
{
|
|
JERRY_CONTEXT (debugger_flags) = (uint8_t) (JERRY_CONTEXT (debugger_flags) & ~JERRY_DEBUGGER_VM_IGNORE);
|
|
}
|
|
}
|
|
#else /* !JERRY_DEBUGGER */
|
|
JERRY_UNUSED (enable_stop_at_breakpoint);
|
|
#endif /* JERRY_DEBUGGER */
|
|
} /* jerry_debugger_stop_at_breakpoint */
|
|
|
|
/**
|
|
* Debugger server initialization. Must be called after jerry_init.
|
|
*/
|
|
void
|
|
jerry_debugger_init (uint16_t port) /**< server port number */
|
|
{
|
|
#ifdef JERRY_DEBUGGER
|
|
JERRY_CONTEXT (debugger_port) = port;
|
|
jerry_debugger_accept_connection ();
|
|
#else /* !JERRY_DEBUGGER */
|
|
JERRY_UNUSED (port);
|
|
#endif /* JERRY_DEBUGGER */
|
|
} /* jerry_debugger_init */
|
|
|
|
/**
|
|
* Sets whether the engine should wait and run a source.
|
|
*
|
|
* @return enum JERRY_DEBUGGER_SOURCE_RECEIVE_FAILED - if the source is not received
|
|
* JERRY_DEBUGGER_SOURCE_RECEIVED - if a source code received
|
|
* JERRY_DEBUGGER_SOURCE_END - the end of the source codes
|
|
* JERRY_DEBUGGER_CONTEXT_RESET_RECEIVED - the end of the context
|
|
*/
|
|
jerry_debugger_wait_and_run_type_t
|
|
jerry_debugger_wait_and_run_client_source (jerry_value_t *return_value) /**< [out] parse and run return value */
|
|
{
|
|
*return_value = jerry_create_undefined ();
|
|
|
|
#ifdef JERRY_DEBUGGER
|
|
if ((JERRY_CONTEXT (debugger_flags) & JERRY_DEBUGGER_CONNECTED)
|
|
&& !(JERRY_CONTEXT (debugger_flags) & JERRY_DEBUGGER_BREAKPOINT_MODE))
|
|
{
|
|
JERRY_CONTEXT (debugger_flags) = (uint8_t) (JERRY_CONTEXT (debugger_flags) | JERRY_DEBUGGER_CLIENT_SOURCE_MODE);
|
|
jerry_debugger_uint8_data_t *client_source_data_p = NULL;
|
|
jerry_debugger_wait_and_run_type_t ret_type = JERRY_DEBUGGER_SOURCE_RECEIVE_FAILED;
|
|
|
|
/* Notify the client about that the engine is waiting for a source. */
|
|
jerry_debugger_send_type (JERRY_DEBUGGER_WAIT_FOR_SOURCE);
|
|
|
|
while (true)
|
|
{
|
|
if (jerry_debugger_receive (&client_source_data_p))
|
|
{
|
|
if (!(JERRY_CONTEXT (debugger_flags) & JERRY_DEBUGGER_CONNECTED))
|
|
{
|
|
break;
|
|
}
|
|
|
|
/* Stop executing the current context. */
|
|
if ((JERRY_CONTEXT (debugger_flags) & JERRY_DEBUGGER_CONTEXT_RESET_MODE))
|
|
{
|
|
ret_type = JERRY_DEBUGGER_CONTEXT_RESET_RECEIVED;
|
|
JERRY_CONTEXT (debugger_flags) = (uint8_t) (JERRY_CONTEXT (debugger_flags)
|
|
& ~JERRY_DEBUGGER_CONTEXT_RESET_MODE);
|
|
break;
|
|
}
|
|
|
|
/* Stop waiting for a new source file. */
|
|
if ((JERRY_CONTEXT (debugger_flags) & JERRY_DEBUGGER_CLIENT_NO_SOURCE))
|
|
{
|
|
ret_type = JERRY_DEBUGGER_SOURCE_END;
|
|
JERRY_CONTEXT (debugger_flags) = (uint8_t) (JERRY_CONTEXT (debugger_flags)
|
|
& ~JERRY_DEBUGGER_CLIENT_SOURCE_MODE);
|
|
break;
|
|
}
|
|
|
|
/* The source arrived. */
|
|
if (!(JERRY_CONTEXT (debugger_flags) & JERRY_DEBUGGER_CLIENT_SOURCE_MODE))
|
|
{
|
|
JERRY_ASSERT (client_source_data_p != NULL);
|
|
|
|
jerry_char_t *string_p = (jerry_char_t *) (client_source_data_p + 1);
|
|
size_t name_size = strlen ((const char *) string_p);
|
|
|
|
*return_value = jerry_parse_named_resource (string_p,
|
|
name_size,
|
|
(string_p + name_size + 1),
|
|
(client_source_data_p->uint8_size - name_size - 1),
|
|
false);
|
|
|
|
if (!jerry_value_has_error_flag (*return_value))
|
|
{
|
|
jerry_value_t func_val = *return_value;
|
|
*return_value = jerry_run (func_val);
|
|
jerry_release_value (func_val);
|
|
|
|
ret_type = JERRY_DEBUGGER_SOURCE_RECEIVED;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
jerry_debugger_sleep ();
|
|
}
|
|
|
|
JERRY_ASSERT (!(JERRY_CONTEXT (debugger_flags) & JERRY_DEBUGGER_CLIENT_SOURCE_MODE)
|
|
|| !(JERRY_CONTEXT (debugger_flags) & JERRY_DEBUGGER_CONNECTED));
|
|
|
|
if (client_source_data_p != NULL)
|
|
{
|
|
/* The data may partly arrived. */
|
|
jmem_heap_free_block (client_source_data_p,
|
|
client_source_data_p->uint8_size + sizeof (jerry_debugger_uint8_data_t));
|
|
}
|
|
|
|
return ret_type;
|
|
}
|
|
|
|
return JERRY_DEBUGGER_SOURCE_RECEIVE_FAILED;
|
|
#else
|
|
return JERRY_DEBUGGER_SOURCE_RECEIVE_FAILED;
|
|
#endif /* JERRY_DEBUGGER */
|
|
} /* jerry_debugger_wait_and_run_client_source */
|
|
|
|
/**
|
|
* Send the output of the program to the debugger client.
|
|
* Currently only sends print output.
|
|
*/
|
|
|
|
#ifdef JERRY_DEBUGGER
|
|
void
|
|
jerry_debugger_send_output (jerry_char_t buffer[], /**< buffer */
|
|
jerry_size_t str_size, /**< string size */
|
|
uint8_t type) /**< type of output */
|
|
{
|
|
if (JERRY_CONTEXT (debugger_flags) & JERRY_DEBUGGER_CONNECTED)
|
|
{
|
|
jerry_debugger_send_string (JERRY_DEBUGGER_OUTPUT_RESULT,
|
|
type,
|
|
(const uint8_t *) buffer,
|
|
sizeof (uint8_t) * str_size);
|
|
}
|
|
} /* jerry_debugger_send_output */
|
|
#endif /* JERRY_DEBUGGER */
|