DWARFExpression

Encodes a single machine address value whose size is the size of an address on the target machine.

Encodes the unsigned literal value 0.

Encodes the unsigned literal value 1.

Encodes the unsigned literal value 2.

Encodes the unsigned literal value 3.

Encodes the unsigned literal value 4.

Encodes the unsigned literal value 5.

Encodes the unsigned literal value 6.

Encodes the unsigned literal value 7.

Encodes the unsigned literal value 8.

Encodes the unsigned literal value 9.

Encodes the unsigned literal value 10.

Encodes the unsigned literal value 11.

Encodes the unsigned literal value 12.

Encodes the unsigned literal value 13.

Encodes the unsigned literal value 14.

Encodes the unsigned literal value 15.

Encodes the unsigned literal value 16.

Encodes the unsigned literal value 17.

Encodes the unsigned literal value 18.

Encodes the unsigned literal value 19.

Encodes the unsigned literal value 20.

Encodes the unsigned literal value 21.

Encodes the unsigned literal value 22.

Encodes the unsigned literal value 23.

Encodes the unsigned literal value 24.

Encodes the unsigned literal value 25.

Encodes the unsigned literal value 26.

Encodes the unsigned literal value 27.

Encodes the unsigned literal value 28.

Encodes the unsigned literal value 29.

Encodes the unsigned literal value 30.

Encodes the unsigned literal value 31.

Encodes a 1-byte unsigned integer constant.

Encodes a 1-byte signed integer constant.

Encodes a 2-byte unsigned integer constant.

Encodes a 2-byte signed integer constant.

Encodes a 4-byte unsigned integer constant.

Encodes a 4-byte signed integer constant.

Encodes a 8-byte unsigned integer constant.

Encodes a 8-byte signed integer constant.

Encodes a little-endian base-128 unsigned integer constant.

Encodes a little-endian base-128 signed integer constant.

Encodes an unsigned little-endian base-128 value, which is a zero-based index into the .debug_addr section where a machine address is stored. This index is relative to the value of the DW_AT_addr_base attribute of the associated compilation unit.

Encodes an unsigned little-endian base-128 value, which is a zero-based index into the .debug_addr section where a constant, the size of a machine address, is stored. This index is relative to the value of the DW_AT_addr_base attribute of the associated compilation unit.

This operation is provided for constants that require link-time relocation but should not be interpreted by the consumer as a relocatable address ( for example, offsets to thread-local storage).

Provides a signeed little-endian base-128 offset from the address specified by the location description in the DW_AT_frame_base attribute of the current function.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 0.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 1.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 2.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 3.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 4.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 5.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 6.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 7.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 8.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 9.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 10.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 11.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 12.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 13.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 14.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 15.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 16.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 17.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 18.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 19.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 20.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 21.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 22.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 23.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 24.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 25.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 26.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 27.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 28.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 29.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 30.

The single operand of the breg operation provides a signed little-endian base-128 offset from the contents of register 31.

Provides the sum of two values specified by its two operands. The first operand being a register number which is in unsigned little-endian base-128 form. The second being an offset in signed little-endian base-128 form.

Provides an operation with three operands: The first is an unsigned little-endian base-128 integer that represents the offset of a debugging information entry in the current compilation unit, which must be a base type entry that provides the type of the constant provided. The second operand is a 1-byte unsigned integer that specifies the size of the constant value, which is the same size as the base type referenced by the first operand. The third operand is a sequence of bytes of the given size that is interpreted as a value of the referenced type.

Provides the contents of a given register interpreted as a value of a given type. The first operand is an unsigned little-endian base-128 number which identifies a register whose contents are pushed onto the stack. The second operand is an unsigned little-endian base-128 number that represents the offset of a debugging information entry in the current compilation unit which must have base type.

Duplicates the value (including its type identifier) at the top of the stack.

Pops the value (including its type identifier) at the top of the stack.

Provides a 1-byte index that is used to index into the stack. A copy of stack entry at that index is pushed onto the stack.

Duplicates the entry currently second in the stack and pushes it onto the stack.

This operation is equivalent to .pick(1).

Swaps the top two stack entries. The entry at the top of the stack (including its type identifier) becomes the second stack entry, and the second entry (including its type identifier) becomes the top of the stack.

Rotates the first three stack entries. The entry at the top of the stack (including its type identifier) becomes the third stack entry, the second stack entry (including its type identifier) becomes the top of the stack, and the third entry (including its type identifier) becomes the second entry.

Pops the top stack entry and treats it as an address.

The popped value must have an integral type. The value retrieved from that address is pushed, and has the generic type. The size of the data retrieved from the dereferenced address is the size of an address on the target machine.

Pops the top stack entry and treats it as an address.

The popped value must have an integral type. The value retrieved from that address is pushed, and has the generic type. The size of the data retrieved from the dereferenced address is specified by the operand, whose value is a 1-byte unsigned integral constant. The data retrieved is zero-extended to the size of an address on the target machine before being pushed onto the expression stack.

Pops the top stack entry and treats it as an address.

The popped value must have an integral type. The size of the data retrieved from the dereferenced address is specified by the first operand, whose value is a 1-byte unsigned integral constant. The data retrieved is zero-extended to the size of an address on the target machine before being pushed onto the expression stack. The second operand is an unsigned little-endian base-128 integer that represents the offset of a debugging information entry in the current compilation unit which must have a base type entry that provides the type of the data pushed.

Provides an extended dereference mechanism.

The entry at the top of the stack is treated as an address. The second stack entry is treated as an “address space identifier” for those architectures that support multiple address spaces. Both of these entries must have integral type identifiers.

The top two stack elements are popped, and a data item is retrieved through an implementation-defined address calculation and pushed as the new stack top together with the generic type identifier. The size of the data retrieved from the dereferenced address is the size of the generic type.

Provides an extended dereference mechanism.

The entry at the top of the stack is treated as an address. The second stack entry is treated as an “address space identifier” for those architectures that support multiple address spaces. Both of these entries must have integral type identifiers.

The top two stack elements are popped, and a data item is retrieved through an implementation-defined address calculation and pushed as the new stack top together with the generic type identifier. The size of the data retrieved from the dereferenced address is specified by the operand, whose value is a 1-byte unsigned integral constant. The data retrieved is zero-extended to the size of an address on the target machine before being pushed onto the expression stack.

Pops the top two stack entries, treats them as an address and an address space identifier, and pushes the value retrieved. The size of the data retrieved from the dereferenced address is specified by the first operand, whose value is a 1-byte unsigned integral constant. The data retrieved is zero-extended to the size of an address on the target machine before being pushed onto the expression stack. The second operand is an unsigned little-endian base-128 integer that represents the offset of a debugging information entry in the current compilation unit, which must have base type that provides the type of the data pushed.

Pushes the address of the object currently being evaluated as part of evaluationo of a user-presented expression. The object may correspond to an indepdendent variable deescribed by its own debugging information entry or it may be a component of an array, structure, or class whose address has been dynamically determined by an earlier step during user expression evaluation.

Pops a value from the stack, which must have an integral type identifier, translates this value into an address in the thread-local storage for a thread, and pushes the addreess onto the stack together with the generic type identifier. The meaning of the value on the top of the stack prior to this operation is defined by the run-time environment. If the run-time environment supports multiple thread-local storage blocks for a single thread, then the block corresponding to the executable or shared library containing this DWARF expreession is used.

Pushes the value of the Canonical Frame Address (CFA), obtained from the Call Frame Information.

Pops the top stack entry, interprets it as a signed value and pushes its absolute value. If the absolute value cannot be represented, the result is undefined.

Pops the top two stack values, performs a bitwise and operation on the two, and pushes the result.

Pops the top two stack values, divides the former second entry by the former top of the stack using signed division, and pushes the result.

Pops the top two stack values, subtracts the former second entry by the former top of the stack, and pushes the result.

Pops the top two stack values, performs a modulo operation on the two, and pushes the result.

Pops the top two stack values, multiplies the former second entry by the former top of the stack, and pushes the result.

Pops the top stack entry, interprets it as a signed value, and pushes its negation. If the negation cannot be represented, the result is undefined.

Pops the top stack entry, and pushes its bitwise complement.

Pops the top two stack entries, performs a bitwise or operation on the two, and pushes the result.

Pops the top two stack entries, adds them together, and pushes the result.

Pops the top stack entry, adds it to the unsigned little-endian base-128 constant operand interpreted as the same type as the operand popped from the top of the stack and pushes the result.

Pops the top twoo stack entries, shifts the former second entry left (filling with zero bits) by the number of bits specified by the former top of the stack, and pushes the result.

Pops the top two stack entries, shifts the former second entry right logically (filling with zero bits) by the number of bits specified by the former top of the stack, and pushes the result.

Pops the top two stack entries, shifts the former second entry right arithmetically (divides the magnitude by 2, keeps the same sign for the result) by the number of bits specified by the former top of the stack, and pushes the result.

Pops the top two stack entries, performs a bitwise exclusive-or operation on the two, and pushes the result.

Pops the top two stack values, which must have the same type, either the base type or the generic type, compares them using the = relational operator, and pushes the constant 1 onto the stack if the result is true, else pushes the constnat value 0 if the result is false.

Pops the top two stack values, which must have the same type, either the base type or the generic type, compares them using the >= relational operator, and pushes the constant 1 onto the stack if the result is true, else pushes the constnat value 0 if the result is false.

Pops the top two stack values, which must have the same type, either the base type or the generic type, compares them using the > relational operator, and pushes the constant 1 onto the stack if the result is true, else pushes the constnat value 0 if the result is false.

Pops the top two stack values, which must have the same type, either the base type or the generic type, compares them using the <= relational operator, and pushes the constant 1 onto the stack if the result is true, else pushes the constnat value 0 if the result is false.

Pops the top two stack values, which must have the same type, either the base type or the generic type, compares them using the < relational operator, and pushes the constant 1 onto the stack if the result is true, else pushes the constnat value 0 if the result is false.

Pops the top two stack values, which must have the same type, either the base type or the generic type, compares them using the != relational operator, and pushes the constant 1 onto the stack if the result is true, else pushes the constnat value 0 if the result is false.

Unconditionally branches forward or backward by the number of bytes specified in its operand.

Conditionally branches forward or backward by the number of bytes specified in its operand according to the value at the top of the stack. The top of the stack is popped, and if it is non-zero then the branch is performed.

Performs a DWARF procedure call during the evaluation of a DWARF expression or location description. The operand is the 2-byte unsigned offset of a debugging information entry in the current compilation unit.

For references from one executable or shared object file to another, the relocation must be performed by the consumer.

This operation transfers control of DWARF expression evaluation to the DW_AT_location attribute of the referenced debugging information entry. If there is no such attribute, then there is no effect. Execution returns to the point following the call when the end of the attribute is reached.

Performs a DWARF procedure call during the evaluation of a DWARF expression or location description. The operand is the 4-byte unsigned offset of a debugging information entry in the current compilation unit.

For references from one executable or shared object file to another, the relocation must be performed by the consumer.

This operation transfers control of DWARF expression evaluation to the DW_AT_location attribute of the referenced debugging information entry. If there is no such attribute, then there is no effect. Execution returns to the point following the call when the end of the attribute is reached.

Performs a DWARF procedure call during the evaluation of a DWARF expression or location description. The operand is used as the offset of a debugging information entry in a .debug_info section which may be contained in an executable or shared object file rather than that containing the operator.

For references from one executable or shared object file to another, the relocation must be performed by the consumer.

This operation transfers control of DWARF expression evaluation to the DW_AT_location attribute of the referenced debugging information entry. If there is no such attribute, then there is no effect. Execution returns to the point following the call when the end of the attribute is reached.

Pops the top stack entry, converts it to a different type, then pushes the result.

The operand is an unsigned little-endian base-128 integer that represents the offset of a debugging information entry in the current compilation unit, or value 0 which represents the generic type. If the operand is non-zero, the referenced entry must be a base type entry that provides the type to which the value is converted.

Pops the top stack entry, reinterprets the bits in its value as a value of a different type, then pushes the result.

The operand is an unsigned little-endian base-128 integer that represents the offset of a debugging information entry in the current compilation unit, or value 0 which represents the generic type. If the operand is non-zero, the referenced entry must be a base type entry that provides the type to which the value is converted.

This operation has no effect on the location stack or any of its values.

Pushes the value that the described location held upon entering the current subprogram. The first operand is an unsigned little-endian base-128 number expressing the length of the second operand in bytes. The second operand is a block containing a DWARF expression or a register location description.

Encodes the name of the register numbered 0.

Encodes the name of the register numbered 1.

Encodes the name of the register numbered 2.

Encodes the name of the register numbered 3.

Encodes the name of the register numbered 4.

Encodes the name of the register numbered 5.

Encodes the name of the register numbered 6.

Encodes the name of the register numbered 7.

Encodes the name of the register numbered 8.

Encodes the name of the register numbered 9.

Encodes the name of the register numbered 10.

Encodes the name of the register numbered 11.

Encodes the name of the register numbered 12.

Encodes the name of the register numbered 13.

Encodes the name of the register numbered 14.

Encodes the name of the register numbered 15.

Encodes the name of the register numbered 16.

Encodes the name of the register numbered 17.

Encodes the name of the register numbered 18.

Encodes the name of the register numbered 19.

Encodes the name of the register numbered 20.

Encodes the name of the register numbered 21.

Encodes the name of the register numbered 22.

Encodes the name of the register numbered 23.

Encodes the name of the register numbered 24.

Encodes the name of the register numbered 25.

Encodes the name of the register numbered 26.

Encodes the name of the register numbered 27.

Encodes the name of the register numbered 28.

Encodes the name of the register numbered 29.

Encodes the name of the register numbered 30.

Encodes the name of the register numbered 31.

Contains a single unsigned little-endian base-128 literal operand that encodes the name of a register.

Specifies an immediate value using two operands: an unsigned little-endian base-128 length, followed by a sequence of bytes of the given length that contain the value.

Specifies that the object does not exist in memory, but its value is nonetheless known and is at the top of the DWARF expression stack. In this form of location description, the DWARF expression represents the actual value of the object, rather than its location.

stackValue acts as an expression terminator.

Takes a single operand in little-endian base-128 form. This operand describes the size in bytes of the piece of the object referenced by the preceding simple location description. If the piece is located in a register, but does not occupy the entire register, the placement of the piece within that register is defined by the ABI.

Takes two operands, an unsigned little-endian base-128 form number that gives the size in bits of the piece. The second is an unsigned little- endian base-128 number that gives the offset in bits from the location defined by the preceding DWARF location description.

bitPiece is used instead of piece when the piece to be assembled into a value or assigned to is not byte-sized or is not at the start of a register or addressable unit of memory.

Interpretation of the offset depends on the location description. If the location description is empty, the offset doesn’t matter and the bitPiece operation describes a piece consisting of the given number of bits whose values are undefined. If the location is a register, the offset is from the least significant bit end of the register. If the location is a memory address, the bitPiece operation describes a sequence of bits relative to the location whose address is on the top of the DWARF stack using the bit numbering and direction conventions that are appropriate to the current language on the target system. If the location is any implicit value or stack value, the bitPiece operation describes a sequence of bits using the least significant bits of that value.

Specifies that the object is a pointer that cannot be represented as a real pointer, even though the value it would point to can be described.

In this form of location description, the DWARF expression refers to a debugging information entry that represents the actual value of the object to which the pointer would point. Thus, a consumer of the debug information would be able to show the value of the dereferenced pointer, even when it cannot show the value of the pointer itself.

The first operand is used as the offset of a debugging information entry in a .debug_info section, which may be contained in an executable or shared object file other than that containing the operator.

For references from one executable or shared object file to another, the relocation must be performed by the consumer.