cory/tildefriends
5
6
Fork 2
Code Issues 39 Pull Requests Actions Releases 34 Wiki Activity

More docs.

Browse Source
This commit is contained in:
Cory McWilliams
2024-03-01 21:18:12 -05:00
parent a710c30572
commit f0a871e1f8
3 changed files with 297 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

56
src/taskstub.js.h
View File

@ -10,20 +10,76 @@
#include "quickjs.h"
#include "uv.h"
/** A task identifier. */
typedef int taskid_t;
/** A packet stream. */
typedef struct _tf_packetstream_t tf_packetstream_t;
/** A task. */
typedef struct _tf_task_t tf_task_t;
/** A handle to another task. */
typedef struct _tf_taskstub_t tf_taskstub_t;
/** Initialize task stub. Call before using the rest. */
void tf_taskstub_startup();
/**
** Register the task stub script interface.
** @param context The JS context.
** @return The task stub constructor.
*/
JSValue tf_taskstub_register(JSContext* context);
/**
** Get a unique identifier for the task stub.
** @param stub The task stub.
** @return An identifier for the stub.
*/
taskid_t tf_taskstub_get_id(const tf_taskstub_t* stub);
/**
** Get the JS object representing the task stub.
** @param stub The task stub.
** @return The JS object.
*/
JSValue tf_taskstub_get_task_object(const tf_taskstub_t* stub);
/**
** Get the packet stream that can be used to communicate with the task stub.
** @param stub The task stub.
** @return The packet stream.
*/
tf_packetstream_t* tf_taskstub_get_stream(const tf_taskstub_t* stub);
/**
** Get the task owning the task stub.
** @param stub The task stub.
** @return The task from which the task stub was created.
*/
tf_task_t* tf_taskstub_get_owner(const tf_taskstub_t* stub);
/**
** Create a task stub representing the parent task of the running process.
** @param task The running task.
** @param file A file descriptor of a pipe connected to a parent process task.
** @return The created task stub.
*/
tf_taskstub_t* tf_taskstub_create_parent(tf_task_t* task, uv_file file);
/**
** Report an error to a task stub.
** @param stub The stub to which to report th eerror.
** @param error The error to report.
*/
void tf_taskstub_on_error(tf_taskstub_t* stub, JSValue error);
/**
** Print to a task stub.
** @param stub The task stub to which to print.
** @param arguments The values to print.
*/
void tf_taskstub_on_print(tf_taskstub_t* stub, JSValue arguments);
/** @} */