mirror of
https://github.com/php/php-src.git
synced 2024-11-25 02:44:58 +08:00
5f8915786f
The `<signal.h>` header file is part of the standard C89 headers [1] and on current systems can be included unconditionally. Since file requires at least C89 or greater, the `HAVE_SIGNAL_H` symbol defined by Autoconf in Zend.m4 [2] can be ommitted and simplifed. The bundled libmagic (file) also ommits the usage of HAVE_SIGNAL_H since 5.35 however current version in PHP is very modified 5.34 version and will be refactored separately. Check for HAVE_SIGNAL_H is therefore still done in the configure.ac. Refs: [1] https://port70.net/~nsz/c/c89/c89-draft.html#4.1.2 [2] https://git.savannah.gnu.org/cgit/autoconf.git/tree/lib/autoconf/headers.m4
337 lines
13 KiB
C
337 lines
13 KiB
C
/*
|
|
+----------------------------------------------------------------------+
|
|
| PHP Version 7 |
|
|
+----------------------------------------------------------------------+
|
|
| Copyright (c) The PHP Group |
|
|
+----------------------------------------------------------------------+
|
|
| This source file is subject to version 3.01 of the PHP 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.php.net/license/3_01.txt |
|
|
| If you did not receive a copy of the PHP license and are unable to |
|
|
| obtain it through the world-wide-web, please send a note to |
|
|
| license@php.net so we can mail you a copy immediately. |
|
|
+----------------------------------------------------------------------+
|
|
| Authors: Felipe Pena <felipe@php.net> |
|
|
| Authors: Joe Watkins <joe.watkins@live.co.uk> |
|
|
| Authors: Bob Weinand <bwoebi@php.net> |
|
|
+----------------------------------------------------------------------+
|
|
*/
|
|
|
|
#ifndef PHPDBG_H
|
|
#define PHPDBG_H
|
|
|
|
#ifdef PHP_WIN32
|
|
# define PHPDBG_API __declspec(dllexport)
|
|
#elif defined(__GNUC__) && __GNUC__ >= 4
|
|
# define PHPDBG_API __attribute__ ((visibility("default")))
|
|
#else
|
|
# define PHPDBG_API
|
|
#endif
|
|
|
|
#ifndef PHP_WIN32
|
|
# include <stdint.h>
|
|
# include <stddef.h>
|
|
#else
|
|
# include "main/php_stdint.h"
|
|
#endif
|
|
#include "php.h"
|
|
#include "php_globals.h"
|
|
#include "php_variables.h"
|
|
#include "php_getopt.h"
|
|
#include "zend_builtin_functions.h"
|
|
#include "zend_extensions.h"
|
|
#include "zend_modules.h"
|
|
#include "zend_globals.h"
|
|
#include "zend_ini_scanner.h"
|
|
#include "zend_stream.h"
|
|
#include "zend_signal.h"
|
|
#if !defined(_WIN32) && !defined(ZEND_SIGNALS)
|
|
# include <signal.h>
|
|
#elif defined(PHP_WIN32)
|
|
# include "win32/signal.h"
|
|
#endif
|
|
#include "SAPI.h"
|
|
#include <fcntl.h>
|
|
#include <sys/types.h>
|
|
#if defined(_WIN32) && !defined(__MINGW32__)
|
|
# include <windows.h>
|
|
# include "config.w32.h"
|
|
# undef strcasecmp
|
|
# undef strncasecmp
|
|
# define strcasecmp _stricmp
|
|
# define strncasecmp _strnicmp
|
|
#else
|
|
# include "php_config.h"
|
|
#endif
|
|
#ifndef O_BINARY
|
|
# define O_BINARY 0
|
|
#endif
|
|
#include "php_main.h"
|
|
|
|
#ifdef ZTS
|
|
# include "TSRM.h"
|
|
#endif
|
|
|
|
#undef zend_hash_str_add
|
|
#ifdef PHP_WIN32
|
|
#define zend_hash_str_add(...) \
|
|
zend_hash_str_add(__VA_ARGS__)
|
|
#else
|
|
#define zend_hash_str_add_tmp(ht, key, len, pData) \
|
|
zend_hash_str_add(ht, key, len, pData)
|
|
#define zend_hash_str_add(...) zend_hash_str_add_tmp(__VA_ARGS__)
|
|
#endif
|
|
|
|
#ifdef HAVE_PHPDBG_READLINE
|
|
# ifdef HAVE_LIBREADLINE
|
|
# include <readline/readline.h>
|
|
# include <readline/history.h>
|
|
# endif
|
|
# ifdef HAVE_LIBEDIT
|
|
# include <editline/readline.h>
|
|
# endif
|
|
#endif
|
|
|
|
/* {{{ remote console headers */
|
|
#ifndef _WIN32
|
|
# include <sys/socket.h>
|
|
# include <sys/un.h>
|
|
# include <sys/select.h>
|
|
# include <sys/types.h>
|
|
# include <netdb.h>
|
|
#endif /* }}} */
|
|
|
|
/* {{{ strings */
|
|
#define PHPDBG_NAME "phpdbg"
|
|
#define PHPDBG_AUTHORS "Felipe Pena, Joe Watkins and Bob Weinand" /* Ordered by last name */
|
|
#define PHPDBG_ISSUES "http://bugs.php.net/report.php"
|
|
#define PHPDBG_VERSION PHP_VERSION
|
|
#define PHPDBG_INIT_FILENAME ".phpdbginit"
|
|
#define PHPDBG_DEFAULT_PROMPT "prompt>"
|
|
/* }}} */
|
|
|
|
/* Hey, apple. One shouldn't define *functions* from the standard C library as marcos. */
|
|
#ifdef memcpy
|
|
#define memcpy_tmp(...) memcpy(__VA_ARGS__)
|
|
#undef memcpy
|
|
#define memcpy(...) memcpy_tmp(__VA_ARGS__)
|
|
#endif
|
|
|
|
#if !defined(PHPDBG_WEBDATA_TRANSFER_H) && !defined(PHPDBG_WEBHELPER_H)
|
|
|
|
#ifdef ZTS
|
|
# define PHPDBG_G(v) ZEND_TSRMG(phpdbg_globals_id, zend_phpdbg_globals *, v)
|
|
#else
|
|
# define PHPDBG_G(v) (phpdbg_globals.v)
|
|
#endif
|
|
|
|
#include "phpdbg_sigsafe.h"
|
|
#include "phpdbg_out.h"
|
|
#include "phpdbg_lexer.h"
|
|
#include "phpdbg_cmd.h"
|
|
#include "phpdbg_utils.h"
|
|
#include "phpdbg_btree.h"
|
|
#include "phpdbg_watch.h"
|
|
#include "phpdbg_bp.h"
|
|
#include "phpdbg_opcode.h"
|
|
#ifdef PHP_WIN32
|
|
# include "phpdbg_sigio_win32.h"
|
|
#endif
|
|
|
|
int phpdbg_do_parse(phpdbg_param_t *stack, char *input);
|
|
|
|
#define PHPDBG_NEXT 2
|
|
#define PHPDBG_UNTIL 3
|
|
#define PHPDBG_FINISH 4
|
|
#define PHPDBG_LEAVE 5
|
|
|
|
/*
|
|
BEGIN: DO NOT CHANGE DO NOT CHANGE DO NOT CHANGE
|
|
*/
|
|
|
|
/* {{{ flags */
|
|
#define PHPDBG_HAS_FILE_BP (1ULL<<1)
|
|
#define PHPDBG_HAS_PENDING_FILE_BP (1ULL<<2)
|
|
#define PHPDBG_HAS_SYM_BP (1ULL<<3)
|
|
#define PHPDBG_HAS_OPLINE_BP (1ULL<<4)
|
|
#define PHPDBG_HAS_METHOD_BP (1ULL<<5)
|
|
#define PHPDBG_HAS_COND_BP (1ULL<<6)
|
|
#define PHPDBG_HAS_OPCODE_BP (1ULL<<7)
|
|
#define PHPDBG_HAS_FUNCTION_OPLINE_BP (1ULL<<8)
|
|
#define PHPDBG_HAS_METHOD_OPLINE_BP (1ULL<<9)
|
|
#define PHPDBG_HAS_FILE_OPLINE_BP (1ULL<<10) /* }}} */
|
|
|
|
/*
|
|
END: DO NOT CHANGE DO NOT CHANGE DO NOT CHANGE
|
|
*/
|
|
|
|
#define PHPDBG_IN_COND_BP (1ULL<<11)
|
|
#define PHPDBG_IN_EVAL (1ULL<<12)
|
|
|
|
#define PHPDBG_IS_STEPPING (1ULL<<13)
|
|
#define PHPDBG_STEP_OPCODE (1ULL<<14)
|
|
#define PHPDBG_IS_QUIET (1ULL<<15)
|
|
#define PHPDBG_IS_QUITTING (1ULL<<16)
|
|
#define PHPDBG_IS_COLOURED (1ULL<<17)
|
|
#define PHPDBG_IS_CLEANING (1ULL<<18)
|
|
#define PHPDBG_IS_RUNNING (1ULL<<19)
|
|
|
|
#define PHPDBG_IN_UNTIL (1ULL<<20)
|
|
#define PHPDBG_IN_FINISH (1ULL<<21)
|
|
#define PHPDBG_IN_LEAVE (1ULL<<22)
|
|
|
|
#define PHPDBG_IS_REGISTERED (1ULL<<23)
|
|
#define PHPDBG_IS_STEPONEVAL (1ULL<<24)
|
|
#define PHPDBG_IS_INITIALIZING (1ULL<<25)
|
|
#define PHPDBG_IS_SIGNALED (1ULL<<26)
|
|
#define PHPDBG_IS_INTERACTIVE (1ULL<<27)
|
|
#define PHPDBG_PREVENT_INTERACTIVE (1ULL<<28)
|
|
#define PHPDBG_IS_BP_ENABLED (1ULL<<29)
|
|
#define PHPDBG_IS_REMOTE (1ULL<<30)
|
|
#define PHPDBG_IS_DISCONNECTED (1ULL<<31)
|
|
#define PHPDBG_WRITE_XML (1ULL<<32)
|
|
|
|
#define PHPDBG_SHOW_REFCOUNTS (1ULL<<33)
|
|
|
|
#define PHPDBG_IN_SIGNAL_HANDLER (1ULL<<34)
|
|
|
|
#define PHPDBG_DISCARD_OUTPUT (1ULL<<35)
|
|
|
|
#define PHPDBG_HAS_PAGINATION (1ULL<<36)
|
|
|
|
#define PHPDBG_SEEK_MASK (PHPDBG_IN_UNTIL | PHPDBG_IN_FINISH | PHPDBG_IN_LEAVE)
|
|
#define PHPDBG_BP_RESOLVE_MASK (PHPDBG_HAS_FUNCTION_OPLINE_BP | PHPDBG_HAS_METHOD_OPLINE_BP | PHPDBG_HAS_FILE_OPLINE_BP)
|
|
#define PHPDBG_BP_MASK (PHPDBG_HAS_FILE_BP | PHPDBG_HAS_SYM_BP | PHPDBG_HAS_METHOD_BP | PHPDBG_HAS_OPLINE_BP | PHPDBG_HAS_COND_BP | PHPDBG_HAS_OPCODE_BP | PHPDBG_HAS_FUNCTION_OPLINE_BP | PHPDBG_HAS_METHOD_OPLINE_BP | PHPDBG_HAS_FILE_OPLINE_BP)
|
|
#define PHPDBG_IS_STOPPING (PHPDBG_IS_QUITTING | PHPDBG_IS_CLEANING)
|
|
|
|
#define PHPDBG_PRESERVE_FLAGS_MASK (PHPDBG_SHOW_REFCOUNTS | PHPDBG_IS_STEPONEVAL | PHPDBG_IS_BP_ENABLED | PHPDBG_STEP_OPCODE | PHPDBG_IS_QUIET | PHPDBG_IS_COLOURED | PHPDBG_IS_REMOTE | PHPDBG_WRITE_XML | PHPDBG_IS_DISCONNECTED | PHPDBG_HAS_PAGINATION)
|
|
|
|
#ifndef _WIN32
|
|
# define PHPDBG_DEFAULT_FLAGS (PHPDBG_IS_QUIET | PHPDBG_IS_COLOURED | PHPDBG_IS_BP_ENABLED | PHPDBG_HAS_PAGINATION)
|
|
#else
|
|
# define PHPDBG_DEFAULT_FLAGS (PHPDBG_IS_QUIET | PHPDBG_IS_BP_ENABLED | PHPDBG_HAS_PAGINATION)
|
|
#endif /* }}} */
|
|
|
|
/* {{{ output descriptors */
|
|
#define PHPDBG_STDIN 0
|
|
#define PHPDBG_STDOUT 1
|
|
#define PHPDBG_STDERR 2
|
|
#define PHPDBG_IO_FDS 3 /* }}} */
|
|
|
|
#define phpdbg_try_access \
|
|
{ \
|
|
JMP_BUF *__orig_bailout = PHPDBG_G(sigsegv_bailout); \
|
|
JMP_BUF __bailout; \
|
|
\
|
|
PHPDBG_G(sigsegv_bailout) = &__bailout; \
|
|
if (SETJMP(__bailout) == 0) {
|
|
#define phpdbg_catch_access \
|
|
} else { \
|
|
PHPDBG_G(sigsegv_bailout) = __orig_bailout;
|
|
#define phpdbg_end_try_access() \
|
|
} \
|
|
PHPDBG_G(sigsegv_bailout) = __orig_bailout; \
|
|
}
|
|
|
|
|
|
void phpdbg_register_file_handles(void);
|
|
|
|
/* {{{ structs */
|
|
ZEND_BEGIN_MODULE_GLOBALS(phpdbg)
|
|
HashTable bp[PHPDBG_BREAK_TABLES]; /* break points */
|
|
HashTable registered; /* registered */
|
|
HashTable seek; /* seek oplines */
|
|
zend_execute_data *seek_ex; /* call frame of oplines to seek to */
|
|
zend_object *handled_exception; /* last handled exception (prevent multiple handling of same exception) */
|
|
phpdbg_frame_t frame; /* frame */
|
|
uint32_t last_line; /* last executed line */
|
|
|
|
char *cur_command; /* current command */
|
|
phpdbg_lexer_data lexer; /* lexer data */
|
|
phpdbg_param_t *parser_stack; /* param stack during lexer / parser phase */
|
|
|
|
#ifndef _WIN32
|
|
struct sigaction old_sigsegv_signal; /* segv signal handler */
|
|
#endif
|
|
phpdbg_btree watchpoint_tree; /* tree with watchpoints */
|
|
phpdbg_btree watch_HashTables; /* tree with original dtors of watchpoints */
|
|
HashTable watch_elements; /* user defined watch elements */
|
|
HashTable watch_collisions; /* collision table to check if multiple watches share the same recursive watchpoint */
|
|
HashTable watch_recreation; /* watch elements pending recreation of their respective watchpoints */
|
|
HashTable watch_free; /* pointers to watch for being freed */
|
|
HashTable *watchlist_mem; /* triggered watchpoints */
|
|
HashTable *watchlist_mem_backup; /* triggered watchpoints backup table while iterating over it */
|
|
zend_bool watchpoint_hit; /* a watchpoint was hit */
|
|
void (*original_free_function)(void *); /* the original AG(mm_heap)->_free function */
|
|
phpdbg_watch_element *watch_tmp; /* temporary pointer for a watch element */
|
|
|
|
char *exec; /* file to execute */
|
|
size_t exec_len; /* size of exec */
|
|
zend_op_array *ops; /* op_array */
|
|
zval retval; /* return value */
|
|
int bp_count; /* breakpoint count */
|
|
int vmret; /* return from last opcode handler execution */
|
|
zend_bool in_execution; /* in execution? */
|
|
zend_bool unclean_eval; /* do not check for memory leaks when we needed to bail out during eval */
|
|
|
|
zend_op_array *(*compile_file)(zend_file_handle *file_handle, int type);
|
|
zend_op_array *(*init_compile_file)(zend_file_handle *file_handle, int type);
|
|
zend_op_array *(*compile_string)(zval *source_string, char *filename);
|
|
HashTable file_sources;
|
|
|
|
FILE *oplog; /* opline log */
|
|
zend_arena *oplog_arena; /* arena for storing oplog */
|
|
phpdbg_oplog_list *oplog_list; /* list of oplog starts */
|
|
phpdbg_oplog_entry *oplog_cur; /* current oplog entry */
|
|
|
|
struct {
|
|
FILE *ptr;
|
|
int fd;
|
|
} io[PHPDBG_IO_FDS]; /* io */
|
|
int eol; /* type of line ending to use */
|
|
size_t (*php_stdiop_write)(php_stream *, const char *, size_t);
|
|
int in_script_xml; /* in <stream> output mode */
|
|
struct {
|
|
zend_bool active;
|
|
int type;
|
|
int fd;
|
|
char *tag;
|
|
char *msg;
|
|
int msglen;
|
|
char *xml;
|
|
int xmllen;
|
|
} err_buf; /* error buffer */
|
|
zend_ulong req_id; /* "request id" to keep track of commands */
|
|
|
|
char *prompt[2]; /* prompt */
|
|
const phpdbg_color_t *colors[PHPDBG_COLORS]; /* colors */
|
|
char *buffer; /* buffer */
|
|
zend_bool last_was_newline; /* check if we don't need to output a newline upon next phpdbg_error or phpdbg_notice */
|
|
|
|
FILE *stdin_file; /* FILE pointer to stdin source file */
|
|
const php_stream_wrapper *orig_url_wrap_php;
|
|
|
|
char input_buffer[PHPDBG_MAX_CMD]; /* stdin input buffer */
|
|
int input_buflen; /* length of stdin input buffer */
|
|
phpdbg_signal_safe_mem sigsafe_mem; /* memory to use in async safe environment (only once!) */
|
|
|
|
JMP_BUF *sigsegv_bailout; /* bailout address for accesibility probing */
|
|
|
|
uint64_t flags; /* phpdbg flags */
|
|
|
|
char *socket_path; /* phpdbg.path ini setting */
|
|
char *sapi_name_ptr; /* store sapi name to free it if necessary to not leak memory */
|
|
int socket_fd; /* file descriptor to socket (wait command) (-1 if unused) */
|
|
int socket_server_fd; /* file descriptor to master socket (wait command) (-1 if unused) */
|
|
#ifdef PHP_WIN32
|
|
HANDLE sigio_watcher_thread; /* sigio watcher thread handle */
|
|
struct win32_sigio_watcher_data swd;
|
|
#endif
|
|
long lines; /* max number of lines to display */
|
|
ZEND_END_MODULE_GLOBALS(phpdbg) /* }}} */
|
|
|
|
#endif
|
|
|
|
#endif /* PHPDBG_H */
|