/* * Copyright (c) 2018 Calvin Rose * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to * deal in the Software without restriction, including without limitation the * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or * sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS * IN THE SOFTWARE. */ #include #include "fiber.h" #include "state.h" #include "gc.h" /* Initialize a new fiber */ DstFiber *dst_fiber(DstFunction *callee, int32_t capacity) { DstFiber *fiber = dst_gcalloc(DST_MEMORY_FIBER, sizeof(DstFiber)); if (capacity < 16) { capacity = 16; } fiber->capacity = capacity; if (capacity) { Dst *data = malloc(sizeof(Dst) * capacity); if (NULL == data) { DST_OUT_OF_MEMORY; } fiber->data = data; } fiber->maxstack = DST_STACK_MAX; return dst_fiber_reset(fiber, callee); } /* Clear a fiber (reset it) */ DstFiber *dst_fiber_reset(DstFiber *fiber, DstFunction *callee) { fiber->frame = 0; fiber->stackstart = DST_FRAME_SIZE; fiber->stacktop = DST_FRAME_SIZE; fiber->root = callee; fiber->child = NULL; fiber->flags = DST_FIBER_MASK_YIELD; dst_fiber_set_status(fiber, DST_STATUS_NEW); return fiber; } /* Ensure that the fiber has enough extra capacity */ void dst_fiber_setcapacity(DstFiber *fiber, int32_t n) { Dst *newData = realloc(fiber->data, sizeof(Dst) * n); if (NULL == newData) { DST_OUT_OF_MEMORY; } fiber->data = newData; fiber->capacity = n; } /* Push a value on the next stack frame */ void dst_fiber_push(DstFiber *fiber, Dst x) { if (fiber->stacktop >= fiber->capacity) { dst_fiber_setcapacity(fiber, 2 * fiber->stacktop); } fiber->data[fiber->stacktop++] = x; } /* Push 2 values on the next stack frame */ void dst_fiber_push2(DstFiber *fiber, Dst x, Dst y) { int32_t newtop = fiber->stacktop + 2; if (newtop > fiber->capacity) { dst_fiber_setcapacity(fiber, 2 * newtop); } fiber->data[fiber->stacktop] = x; fiber->data[fiber->stacktop + 1] = y; fiber->stacktop = newtop; } /* Push 3 values on the next stack frame */ void dst_fiber_push3(DstFiber *fiber, Dst x, Dst y, Dst z) { int32_t newtop = fiber->stacktop + 3; if (newtop > fiber->capacity) { dst_fiber_setcapacity(fiber, 2 * newtop); } fiber->data[fiber->stacktop] = x; fiber->data[fiber->stacktop + 1] = y; fiber->data[fiber->stacktop + 2] = z; fiber->stacktop = newtop; } /* Push an array on the next stack frame */ void dst_fiber_pushn(DstFiber *fiber, const Dst *arr, int32_t n) { int32_t newtop = fiber->stacktop + n; if (newtop > fiber->capacity) { dst_fiber_setcapacity(fiber, 2 * newtop); } memcpy(fiber->data + fiber->stacktop, arr, n * sizeof(Dst)); fiber->stacktop = newtop; } /* Push a stack frame to a fiber */ int dst_fiber_funcframe(DstFiber *fiber, DstFunction *func) { DstStackFrame *newframe; int32_t i; int32_t oldtop = fiber->stacktop; int32_t oldframe = fiber->frame; int32_t nextframe = fiber->stackstart; int32_t nextstacktop = nextframe + func->def->slotcount + DST_FRAME_SIZE; /* Check strict arity */ if (func->def->flags & DST_FUNCDEF_FLAG_FIXARITY) { if (func->def->arity != (fiber->stacktop - fiber->stackstart)) { return 1; } } if (fiber->capacity < nextstacktop) { dst_fiber_setcapacity(fiber, 2 * nextstacktop); } /* Nil unset stack arguments (Needed for gc correctness) */ for (i = fiber->stacktop; i < nextstacktop; ++i) { fiber->data[i] = dst_wrap_nil(); } /* Set up the next frame */ fiber->frame = nextframe; fiber->stacktop = fiber->stackstart = nextstacktop; newframe = dst_fiber_frame(fiber); newframe->prevframe = oldframe; newframe->pc = func->def->bytecode; newframe->func = func; newframe->env = NULL; newframe->flags = 0; /* Check varargs */ if (func->def->flags & DST_FUNCDEF_FLAG_VARARG) { int32_t tuplehead = fiber->frame + func->def->arity; if (tuplehead >= oldtop) { fiber->data[tuplehead] = dst_wrap_tuple(dst_tuple_n(NULL, 0)); } else { fiber->data[tuplehead] = dst_wrap_tuple(dst_tuple_n( fiber->data + tuplehead, oldtop - tuplehead)); } } /* Good return */ return 0; } /* If a frame has a closure environment, detach it from * the stack and have it keep its own values */ static void dst_env_detach(DstFuncEnv *env) { /* Check for closure environment */ if (env) { size_t s = sizeof(Dst) * env->length; Dst *vmem = malloc(s); if (NULL == vmem) { DST_OUT_OF_MEMORY; } memcpy(vmem, env->as.fiber->data + env->offset, s); env->offset = 0; env->as.values = vmem; } } /* Create a tail frame for a function */ int dst_fiber_funcframe_tail(DstFiber *fiber, DstFunction *func) { int32_t i; int32_t nextframetop = fiber->frame + func->def->slotcount; int32_t nextstacktop = nextframetop + DST_FRAME_SIZE; int32_t stacksize; /* Check strict arity */ if (func->def->flags & DST_FUNCDEF_FLAG_FIXARITY) { if (func->def->arity != (fiber->stacktop - fiber->stackstart)) { return 1; } } if (fiber->capacity < nextstacktop) { dst_fiber_setcapacity(fiber, 2 * nextstacktop); } Dst *stack = fiber->data + fiber->frame; Dst *args = fiber->data + fiber->stackstart; /* Detatch old function */ if (NULL != dst_fiber_frame(fiber)->func) dst_env_detach(dst_fiber_frame(fiber)->env); dst_fiber_frame(fiber)->env = NULL; /* Check varargs */ if (func->def->flags & DST_FUNCDEF_FLAG_VARARG) { int32_t tuplehead = fiber->stackstart + func->def->arity; if (tuplehead >= fiber->stacktop) { if (tuplehead >= fiber->capacity) dst_fiber_setcapacity(fiber, 2 * (tuplehead + 1)); for (i = fiber->stacktop; i < tuplehead; ++i) fiber->data[i] = dst_wrap_nil(); fiber->data[tuplehead] = dst_wrap_tuple(dst_tuple_n(NULL, 0)); } else { fiber->data[tuplehead] = dst_wrap_tuple(dst_tuple_n( fiber->data + tuplehead, fiber->stacktop - tuplehead)); } stacksize = tuplehead - fiber->stackstart + 1; } else { stacksize = fiber->stacktop - fiber->stackstart; } if (stacksize) memmove(stack, args, stacksize * sizeof(Dst)); /* Nil unset locals (Needed for functional correctness) */ for (i = fiber->frame + stacksize; i < nextframetop; ++i) fiber->data[i] = dst_wrap_nil(); /* Set stack stuff */ fiber->stacktop = fiber->stackstart = nextstacktop; /* Set frame stuff */ dst_fiber_frame(fiber)->func = func; dst_fiber_frame(fiber)->pc = func->def->bytecode; dst_fiber_frame(fiber)->flags |= DST_STACKFRAME_TAILCALL; /* Good return */ return 0; } /* Push a stack frame to a fiber for a c function */ void dst_fiber_cframe(DstFiber *fiber, DstCFunction cfun) { DstStackFrame *newframe; int32_t oldframe = fiber->frame; int32_t nextframe = fiber->stackstart; int32_t nextstacktop = fiber->stacktop + DST_FRAME_SIZE; if (fiber->capacity < nextstacktop) { dst_fiber_setcapacity(fiber, 2 * nextstacktop); } /* Set the next frame */ fiber->frame = nextframe; fiber->stacktop = fiber->stackstart = nextstacktop; newframe = dst_fiber_frame(fiber); /* Set up the new frame */ newframe->prevframe = oldframe; newframe->pc = (uint32_t *) cfun; newframe->func = NULL; newframe->env = NULL; newframe->flags = 0; } /* Pop a stack frame from the fiber. Returns the new stack frame, or * NULL if there are no more frames */ void dst_fiber_popframe(DstFiber *fiber) { DstStackFrame *frame = dst_fiber_frame(fiber); if (fiber->frame == 0) return; /* Clean up the frame (detach environments) */ if (NULL != frame->func) dst_env_detach(frame->env); /* Shrink stack */ fiber->stacktop = fiber->stackstart = fiber->frame; fiber->frame = frame->prevframe; } /* CFuns */ static int cfun_new(DstArgs args) { DstFiber *fiber; DstFunction *func; DST_MINARITY(args, 1); DST_MAXARITY(args, 2); DST_ARG_FUNCTION(func, args, 0); if (func->def->flags & DST_FUNCDEF_FLAG_FIXARITY) { if (func->def->arity != 1) { DST_THROW(args, "expected unit arity function in fiber constructor"); } } fiber = dst_fiber(func, 64); if (args.n == 2) { const uint8_t *flags; int32_t len, i; DST_ARG_BYTES(flags, len, args, 1); fiber->flags = 0; dst_fiber_set_status(fiber, DST_STATUS_NEW); for (i = 0; i < len; i++) { if (flags[i] >= '0' && flags[i] <= '9') { fiber->flags |= DST_FIBER_MASK_USERN(flags[i] - '0'); } else { switch (flags[i]) { default: DST_THROW(args, "invalid flag, expected a, d, e, u, or y"); case ':': break; case 'a': fiber->flags |= DST_FIBER_MASK_DEBUG | DST_FIBER_MASK_ERROR | DST_FIBER_MASK_USER | DST_FIBER_MASK_YIELD; break; case 'd': fiber->flags |= DST_FIBER_MASK_DEBUG; break; case 'e': fiber->flags |= DST_FIBER_MASK_ERROR; break; case 'u': fiber->flags |= DST_FIBER_MASK_USER; break; case 'y': fiber->flags |= DST_FIBER_MASK_YIELD; break; } } } } DST_RETURN_FIBER(args, fiber); } static int cfun_status(DstArgs args) { DstFiber *fiber; const char *status = ""; DST_FIXARITY(args, 1); DST_ARG_FIBER(fiber, args, 0); uint32_t s = (fiber->flags & DST_FIBER_STATUS_MASK) >> DST_FIBER_STATUS_OFFSET; switch (s) { case DST_STATUS_DEAD: status = ":dead"; break; case DST_STATUS_ERROR: status = ":error"; break; case DST_STATUS_DEBUG: status = ":debug"; break; case DST_STATUS_PENDING: status = ":pending"; break; case DST_STATUS_USER0: status = ":user0"; break; case DST_STATUS_USER1: status = ":user1"; break; case DST_STATUS_USER2: status = ":user2"; break; case DST_STATUS_USER3: status = ":user3"; break; case DST_STATUS_USER4: status = ":user4"; break; case DST_STATUS_USER5: status = ":user5"; break; case DST_STATUS_USER6: status = ":user6"; break; case DST_STATUS_USER7: status = ":user7"; break; case DST_STATUS_USER8: status = ":user8"; break; case DST_STATUS_USER9: status = ":user9"; break; case DST_STATUS_NEW: status = ":new"; break; default: case DST_STATUS_ALIVE: status = ":alive"; break; } DST_RETURN_CSYMBOL(args, status); } /* Extract info from one stack frame */ static Dst doframe(DstStackFrame *frame) { int32_t off; DstTable *t = dst_table(3); DstFuncDef *def = NULL; if (frame->func) { dst_table_put(t, dst_csymbolv(":function"), dst_wrap_function(frame->func)); def = frame->func->def; if (def->name) { dst_table_put(t, dst_csymbolv(":name"), dst_wrap_string(def->name)); } } else { DstCFunction cfun = (DstCFunction)(frame->pc); if (cfun) { Dst name = dst_table_get(dst_vm_registry, dst_wrap_cfunction(cfun)); if (!dst_checktype(name, DST_NIL)) { dst_table_put(t, dst_csymbolv(":name"), name); } } dst_table_put(t, dst_csymbolv(":c"), dst_wrap_true()); } if (frame->flags & DST_STACKFRAME_TAILCALL) { dst_table_put(t, dst_csymbolv(":tail"), dst_wrap_true()); } if (frame->func && frame->pc) { off = (int32_t) (frame->pc - def->bytecode); dst_table_put(t, dst_csymbolv(":pc"), dst_wrap_integer(off)); if (def->sourcemap) { DstSourceMapping mapping = def->sourcemap[off]; dst_table_put(t, dst_csymbolv(":line"), dst_wrap_integer(mapping.line)); dst_table_put(t, dst_csymbolv(":column"), dst_wrap_integer(mapping.column)); } if (def->source) { dst_table_put(t, dst_csymbolv(":source"), dst_wrap_string(def->source)); } } return dst_wrap_table(t); } static int cfun_stack(DstArgs args) { DstFiber *fiber; DstArray *array; DST_FIXARITY(args, 1); DST_ARG_FIBER(fiber, args, 0); array = dst_array(0); { int32_t i = fiber->frame; DstStackFrame *frame; while (i > 0) { frame = (DstStackFrame *)(fiber->data + i - DST_FRAME_SIZE); dst_array_push(array, doframe(frame)); i = frame->prevframe; } } DST_RETURN_ARRAY(args, array); } static int cfun_current(DstArgs args) { DST_FIXARITY(args, 0); DST_RETURN_FIBER(args, dst_vm_fiber); } static int cfun_lineage(DstArgs args) { DstFiber *fiber; DstArray *array; DST_FIXARITY(args, 1); DST_ARG_FIBER(fiber, args, 0); array = dst_array(0); while (fiber) { dst_array_push(array, dst_wrap_fiber(fiber)); fiber = fiber->child; } DST_RETURN_ARRAY(args, array); } static int cfun_maxstack(DstArgs args) { DstFiber *fiber; DST_FIXARITY(args, 1); DST_ARG_FIBER(fiber, args, 0); DST_RETURN_INTEGER(args, fiber->maxstack); } static int cfun_setmaxstack(DstArgs args) { DstFiber *fiber; int32_t maxs; DST_FIXARITY(args, 2); DST_ARG_FIBER(fiber, args, 0); DST_ARG_INTEGER(maxs, args, 1); if (maxs < 0) { DST_THROW(args, "expected positive integer"); } fiber->maxstack = maxs; DST_RETURN_FIBER(args, fiber); } static const DstReg cfuns[] = { {"fiber.new", cfun_new}, {"fiber.status", cfun_status}, {"fiber.stack", cfun_stack}, {"fiber.current", cfun_current}, {"fiber.lineage", cfun_lineage}, {"fiber.maxstack", cfun_maxstack}, {"fiber.setmaxstack", cfun_setmaxstack}, {NULL, NULL} }; /* Module entry point */ int dst_lib_fiber(DstArgs args) { DstTable *env = dst_env_arg(args); dst_env_cfuns(env, cfuns); return 0; }