Root Explorer PHP

[ Root System Explorer ]

Editing: zend_fibers.h

/*
   +----------------------------------------------------------------------+
   | Zend Engine                                                          |
   +----------------------------------------------------------------------+
   | Copyright (c) Zend Technologies Ltd. (http://www.zend.com)           |
   +----------------------------------------------------------------------+
   | This source file is subject to version 2.00 of the Zend license,     |
   | that is bundled with this package in the file LICENSE, and is        |
   | available through the world-wide-web at the following url:           |
   | http://www.zend.com/license/2_00.txt.                                |
   | If you did not receive a copy of the Zend license and are unable to  |
   | obtain it through the world-wide-web, please send a note to          |
   | license@zend.com so we can mail you a copy immediately.              |
   +----------------------------------------------------------------------+
   | Authors: Aaron Piotrowski <aaron@trowski.com>                        |
   |          Martin Schröder <m.schroeder2007@gmail.com>                 |
   +----------------------------------------------------------------------+
*/

#ifndef ZEND_FIBERS_H
#define ZEND_FIBERS_H

#include "zend_API.h"
#include "zend_types.h"

#define ZEND_FIBER_GUARD_PAGES 1

#define ZEND_FIBER_DEFAULT_C_STACK_SIZE (4096 * (((sizeof(void *)) < 8) ? 256 : 512))
#define ZEND_FIBER_VM_STACK_SIZE (1024 * sizeof(zval))

BEGIN_EXTERN_C()

typedef enum {
	ZEND_FIBER_STATUS_INIT,
	ZEND_FIBER_STATUS_RUNNING,
	ZEND_FIBER_STATUS_SUSPENDED,
	ZEND_FIBER_STATUS_DEAD,
} zend_fiber_status;

typedef enum {
	ZEND_FIBER_FLAG_THREW     = 1 << 0,
	ZEND_FIBER_FLAG_BAILOUT   = 1 << 1,
	ZEND_FIBER_FLAG_DESTROYED = 1 << 2,
} zend_fiber_flag;

typedef enum {
	ZEND_FIBER_TRANSFER_FLAG_ERROR = 1 << 0,
	ZEND_FIBER_TRANSFER_FLAG_BAILOUT = 1 << 1
} zend_fiber_transfer_flag;

void zend_register_fiber_ce(void);
void zend_fiber_init(void);
void zend_fiber_shutdown(void);

extern ZEND_API zend_class_entry *zend_ce_fiber;

typedef struct _zend_fiber_stack zend_fiber_stack;

/* Encapsulates data needed for a context switch. */
typedef struct _zend_fiber_transfer {
	/* Fiber that will be switched to / has resumed us. */
	zend_fiber_context *context;

/* Value to that should be send to (or was received from) a fiber. */
	zval value;

/* Bitmask of flags defined in enum zend_fiber_transfer_flag. */
	uint8_t flags;
} zend_fiber_transfer;

/* Coroutine functions must populate the given transfer with a new context
 * and (optional) data before they return. */
typedef void (*zend_fiber_coroutine)(zend_fiber_transfer *transfer);
typedef void (*zend_fiber_clean)(zend_fiber_context *context);

struct _zend_fiber_context {
	/* Pointer to boost.context or ucontext_t data. */
	void *handle;

/* Pointer that identifies the fiber type. */
	void *kind;

/* Entrypoint function of the fiber. */
	zend_fiber_coroutine function;

/* Cleanup function for fiber. */
	zend_fiber_clean cleanup;

/* Assigned C stack. */
	zend_fiber_stack *stack;

/* Fiber status. */
	zend_fiber_status status;

/* Observer state */
	zend_execute_data *top_observed_frame;

/* Reserved for extensions */
	void *reserved[ZEND_MAX_RESERVED_RESOURCES];
};

struct _zend_fiber {
	/* PHP object handle. */
	zend_object std;

/* Flags are defined in enum zend_fiber_flag. */
	uint8_t flags;

/* Native C fiber context. */
	zend_fiber_context context;

/* Fiber that resumed us. */
	zend_fiber_context *caller;

/* Fiber that suspended us. */
	zend_fiber_context *previous;

/* Callback and info / cache to be used when fiber is started. */
	zend_fcall_info fci;
	zend_fcall_info_cache fci_cache;

/* Current Zend VM execute data being run by the fiber. */
	zend_execute_data *execute_data;

/* Frame on the bottom of the fiber vm stack. */
	zend_execute_data *stack_bottom;

/* Active fiber vm stack. */
	zend_vm_stack vm_stack;

/* Storage for fiber return value. */
	zval result;
};

/* These functions may be used to create custom fiber objects using the bundled fiber switching context. */
ZEND_API zend_result zend_fiber_init_context(zend_fiber_context *context, void *kind, zend_fiber_coroutine coroutine, size_t stack_size);
ZEND_API void zend_fiber_destroy_context(zend_fiber_context *context);
ZEND_API void zend_fiber_switch_context(zend_fiber_transfer *transfer);
#ifdef ZEND_CHECK_STACK_LIMIT
ZEND_API void* zend_fiber_stack_limit(zend_fiber_stack *stack);
ZEND_API void* zend_fiber_stack_base(zend_fiber_stack *stack);
#endif /* ZEND_CHECK_STACK_LIMIT */

ZEND_API void zend_fiber_switch_block(void);
ZEND_API void zend_fiber_switch_unblock(void);
ZEND_API bool zend_fiber_switch_blocked(void);

END_EXTERN_C()

static zend_always_inline zend_fiber *zend_fiber_from_context(zend_fiber_context *context)
{
	ZEND_ASSERT(context->kind == zend_ce_fiber && "Fiber context does not belong to a Zend fiber");

return (zend_fiber *)(((char *) context) - XtOffsetOf(zend_fiber, context));
}

static zend_always_inline zend_fiber_context *zend_fiber_get_context(zend_fiber *fiber)
{
	return &fiber->context;
}

#endif

[ CANCEL ]

Name	Type	Actions
.. (Parent Directory)
📁 Optimizer/	DIR
📄 zend.h	FILE	[EDIT]
📄 zend_API.h	FILE	[EDIT]
📄 zend_alloc.h	FILE	[EDIT]
📄 zend_alloc_sizes.h	FILE	[EDIT]
📄 zend_arena.h	FILE	[EDIT]
📄 zend_ast.h	FILE	[EDIT]
📄 zend_atomic.h	FILE	[EDIT]
📄 zend_attributes.h	FILE	[EDIT]
📄 zend_attributes_arginfo.h	FILE	[EDIT]
📄 zend_bitset.h	FILE	[EDIT]
📄 zend_build.h	FILE	[EDIT]
📄 zend_builtin_functions.h	FILE	[EDIT]
📄 zend_builtin_functions_arginfo.h	FILE	[EDIT]
📄 zend_call_stack.h	FILE	[EDIT]
📄 zend_closures.h	FILE	[EDIT]
📄 zend_closures_arginfo.h	FILE	[EDIT]
📄 zend_compile.h	FILE	[EDIT]
📄 zend_config.h	FILE	[EDIT]
📄 zend_constants.h	FILE	[EDIT]
📄 zend_constants_arginfo.h	FILE	[EDIT]
📄 zend_cpuinfo.h	FILE	[EDIT]
📄 zend_dtrace.h	FILE	[EDIT]
📄 zend_enum.h	FILE	[EDIT]
📄 zend_enum_arginfo.h	FILE	[EDIT]
📄 zend_errors.h	FILE	[EDIT]
📄 zend_exceptions.h	FILE	[EDIT]
📄 zend_exceptions_arginfo.h	FILE	[EDIT]
📄 zend_execute.h	FILE	[EDIT]
📄 zend_extensions.h	FILE	[EDIT]
📄 zend_fibers.h	FILE	[EDIT]
📄 zend_fibers_arginfo.h	FILE	[EDIT]
📄 zend_float.h	FILE	[EDIT]
📄 zend_gc.h	FILE	[EDIT]
📄 zend_gdb.h	FILE	[EDIT]
📄 zend_generators.h	FILE	[EDIT]
📄 zend_generators_arginfo.h	FILE	[EDIT]
📄 zend_globals.h	FILE	[EDIT]
📄 zend_globals_macros.h	FILE	[EDIT]
📄 zend_hash.h	FILE	[EDIT]
📄 zend_highlight.h	FILE	[EDIT]
📄 zend_hrtime.h	FILE	[EDIT]
📄 zend_inheritance.h	FILE	[EDIT]
📄 zend_ini.h	FILE	[EDIT]
📄 zend_ini_parser.h	FILE	[EDIT]
📄 zend_ini_scanner.h	FILE	[EDIT]
📄 zend_ini_scanner_defs.h	FILE	[EDIT]
📄 zend_interfaces.h	FILE	[EDIT]
📄 zend_interfaces_arginfo.h	FILE	[EDIT]
📄 zend_istdiostream.h	FILE	[EDIT]
📄 zend_iterators.h	FILE	[EDIT]
📄 zend_language_parser.h	FILE	[EDIT]
📄 zend_language_scanner.h	FILE	[EDIT]
📄 zend_language_scanner_defs.h	FILE	[EDIT]
📄 zend_list.h	FILE	[EDIT]
📄 zend_llist.h	FILE	[EDIT]
📄 zend_long.h	FILE	[EDIT]
📄 zend_map_ptr.h	FILE	[EDIT]
📄 zend_max_execution_timer.h	FILE	[EDIT]
📄 zend_mmap.h	FILE	[EDIT]
📄 zend_modules.h	FILE	[EDIT]
📄 zend_multibyte.h	FILE	[EDIT]
📄 zend_multiply.h	FILE	[EDIT]
📄 zend_object_handlers.h	FILE	[EDIT]
📄 zend_objects.h	FILE	[EDIT]
📄 zend_objects_API.h	FILE	[EDIT]
📄 zend_observer.h	FILE	[EDIT]
📄 zend_operators.h	FILE	[EDIT]
📄 zend_portability.h	FILE	[EDIT]
📄 zend_ptr_stack.h	FILE	[EDIT]
📄 zend_range_check.h	FILE	[EDIT]
📄 zend_signal.h	FILE	[EDIT]
📄 zend_smart_str.h	FILE	[EDIT]
📄 zend_smart_str_public.h	FILE	[EDIT]
📄 zend_smart_string.h	FILE	[EDIT]
📄 zend_smart_string_public.h	FILE	[EDIT]
📄 zend_sort.h	FILE	[EDIT]
📄 zend_stack.h	FILE	[EDIT]
📄 zend_stream.h	FILE	[EDIT]
📄 zend_string.h	FILE	[EDIT]
📄 zend_strtod.h	FILE	[EDIT]
📄 zend_strtod_int.h	FILE	[EDIT]
📄 zend_system_id.h	FILE	[EDIT]
📄 zend_type_info.h	FILE	[EDIT]
📄 zend_types.h	FILE	[EDIT]
📄 zend_variables.h	FILE	[EDIT]
📄 zend_virtual_cwd.h	FILE	[EDIT]
📄 zend_vm.h	FILE	[EDIT]
📄 zend_vm_def.h	FILE	[EDIT]
📄 zend_vm_execute.h	FILE	[EDIT]
📄 zend_vm_handlers.h	FILE	[EDIT]
📄 zend_vm_opcodes.h	FILE	[EDIT]
📄 zend_vm_trace_handlers.h	FILE	[EDIT]
📄 zend_vm_trace_lines.h	FILE	[EDIT]
📄 zend_vm_trace_map.h	FILE	[EDIT]
📄 zend_weakrefs.h	FILE	[EDIT]
📄 zend_weakrefs_arginfo.h	FILE	[EDIT]