From b1d257150cb52ab7de4bbd84d55452f60b8b8abe Mon Sep 17 00:00:00 2001 From: ghidragon <106987263+ghidragon@users.noreply.github.com> Date: Tue, 31 Dec 2024 16:00:39 -0500 Subject: [PATCH] GP-5196 Adding support for expressions and symbol names in address fields --- Ghidra/Features/Base/certification.manifest | 1 + .../Base/src/main/help/help/TOC_Source.xml | 2 + .../Override_Fallthrough.htm | 5 +- .../topics/MemoryMapPlugin/Memory_Map.htm | 31 +- .../MemoryMapPlugin/images/AddMappedBlock.png | Bin 24616 -> 14346 bytes .../MemoryMapPlugin/images/AddMemoryBlock.png | Bin 23385 -> 14635 bytes .../images/MemoryExpandDown.png | Bin 9398 -> 6644 bytes .../MemoryMapPlugin/images/MemoryExpandUp.png | Bin 9293 -> 6507 bytes .../MemoryMapPlugin/images/MoveMemory.png | Bin 13400 -> 8608 bytes .../images/SetImageBaseDialog.png | Bin 5922 -> 3914 bytes .../images/SplitMemoryBlock.png | Bin 17627 -> 12135 bytes .../help/topics/Misc/AddressExpressions.htm | 175 ++++ .../CreateOffsetReferencesTable.htm | 4 +- .../ReferencesPlugin/References_from.htm | 7 +- .../help/topics/RegisterPlugin/Registers.htm | 5 +- .../core/fallthrough/FallThroughDialog.java | 15 +- .../editor/VarnodeLocationCellEditor.java | 9 +- .../plugin/core/memory/AddBlockDialog.java | 50 +- .../app/plugin/core/memory/AddBlockModel.java | 16 +- .../plugin/core/memory/ExpandBlockDialog.java | 30 +- .../plugin/core/memory/MemoryMapProvider.java | 4 +- .../plugin/core/memory/MoveBlockDialog.java | 37 +- .../plugin/core/memory/MoveBlockModel.java | 11 +- .../plugin/core/memory/SplitBlockDialog.java | 232 +++-- .../EditExternalReferencePanel.java | 8 +- .../references/EditMemoryReferencePanel.java | 3 +- .../core/references/OffsetTableDialog.java | 28 +- .../core/references/OffsetTablePlugin.java | 8 +- .../register/EditRegisterValueDialog.java | 32 +- .../core/register/RegisterValuesPanel.java | 6 +- .../symboltree/EditExternalLocationPanel.java | 6 +- .../java/ghidra/app/script/GhidraScript.java | 2 +- .../java/ghidra/app/util/AddressInput.java | 607 ++++++++----- .../app/util/AddressSetEditorPanel.java | 13 +- .../ghidra/app/util/OptionsEditorPanel.java | 3 +- .../app/util/cparser/CPP/DefineTable.java | 102 +-- .../ghidra/app/util/dialog/AskAddrDialog.java | 12 +- .../core/memory/MemoryMapProvider2Test.java | 28 +- .../core/memory/MemoryMapProvider3Test.java | 22 +- .../ghidra/app/util/AddressInputTest.java | 219 +++++ .../base/values/AddressValueTest.java | 7 +- .../values/ValuesMapDialogParseErrorTest.java | 6 +- .../program/util/AddressEvaluatorTest.java | 199 +++-- .../byteviewer/ByteViewerOptionsDialog.java | 17 +- .../byteviewer/ByteViewerPlugin1Test.java | 8 +- .../markuptable/EditableListingAddress.java | 9 +- .../wizard/AddRemoveAddressRangeDialog.java | 13 +- .../textfield/HexDecimalModeTextField.java | 114 +++ .../widgets/textfield/IntegerTextField.java | 137 +-- .../expressions/ExpressionElement.java | 24 + .../expressions/ExpressionEvaluator.java | 509 +++++++++++ .../expressions/ExpressionException.java | 25 + .../expressions/ExpressionGrouper.java | 23 + .../expressions/ExpressionOperator.java | 172 ++++ .../generic/expressions/ExpressionValue.java | 42 + .../expressions/LongExpressionValue.java | 110 +++ .../expressions/ExpressionEvaluatorTest.java | 206 +++++ .../ghidra/program/util/AddressEvaluator.java | 816 +++++------------- .../program/util/AddressExpressionValue.java | 167 ++++ .../CreateAVR8GDTArchiveScript.java | 4 +- .../MemoryMapPluginScreenShots.java | 6 +- 61 files changed, 2902 insertions(+), 1445 deletions(-) create mode 100644 Ghidra/Features/Base/src/main/help/help/topics/Misc/AddressExpressions.htm create mode 100644 Ghidra/Features/Base/src/test.slow/java/ghidra/app/util/AddressInputTest.java create mode 100644 Ghidra/Framework/Docking/src/main/java/docking/widgets/textfield/HexDecimalModeTextField.java create mode 100644 Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionElement.java create mode 100644 Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionEvaluator.java create mode 100644 Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionException.java create mode 100644 Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionGrouper.java create mode 100644 Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionOperator.java create mode 100644 Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionValue.java create mode 100644 Ghidra/Framework/Generic/src/main/java/generic/expressions/LongExpressionValue.java create mode 100644 Ghidra/Framework/Generic/src/test/java/generic/expressions/ExpressionEvaluatorTest.java create mode 100644 Ghidra/Framework/SoftwareModeling/src/main/java/ghidra/program/util/AddressExpressionValue.java diff --git a/Ghidra/Features/Base/certification.manifest b/Ghidra/Features/Base/certification.manifest index 7f03be2e0c..72eaba576b 100644 --- a/Ghidra/Features/Base/certification.manifest +++ b/Ghidra/Features/Base/certification.manifest @@ -398,6 +398,7 @@ src/main/help/help/topics/MemoryMapPlugin/images/MemoryMap.png||GHIDRA||||END| src/main/help/help/topics/MemoryMapPlugin/images/MoveMemory.png||GHIDRA||||END| src/main/help/help/topics/MemoryMapPlugin/images/SetImageBaseDialog.png||GHIDRA||||END| src/main/help/help/topics/MemoryMapPlugin/images/SplitMemoryBlock.png||GHIDRA||||END| +src/main/help/help/topics/Misc/AddressExpressions.htm||GHIDRA||||END| src/main/help/help/topics/Misc/Appendix.htm||GHIDRA||||END| src/main/help/help/topics/Misc/Welcome_to_Ghidra_Help.htm||GHIDRA||||END| src/main/help/help/topics/Navigation/Navigation.htm||GHIDRA||||END| diff --git a/Ghidra/Features/Base/src/main/help/help/TOC_Source.xml b/Ghidra/Features/Base/src/main/help/help/TOC_Source.xml index 2b0315ae17..506c93713f 100644 --- a/Ghidra/Features/Base/src/main/help/help/TOC_Source.xml +++ b/Ghidra/Features/Base/src/main/help/help/TOC_Source.xml @@ -196,6 +196,8 @@ + + diff --git a/Ghidra/Features/Base/src/main/help/help/topics/FallThroughPlugin/Override_Fallthrough.htm b/Ghidra/Features/Base/src/main/help/help/topics/FallThroughPlugin/Override_Fallthrough.htm index b6e3b3149f..b7b035a1e8 100644 --- a/Ghidra/Features/Base/src/main/help/help/topics/FallThroughPlugin/Override_Fallthrough.htm +++ b/Ghidra/Features/Base/src/main/help/help/topics/FallThroughPlugin/Override_Fallthrough.htm @@ -55,8 +55,9 @@
  • Select the User radio button.
    • -
  • Enter an address, or click in the Code Browser at the address of the new - fallthrough.
    • +
  • Enter an address + (or Address Expression), or click in + the Code Browser at the address of the new fallthrough.
  • Select the Apply button to change the fallthrough and leave the dialog intact; select the OK button to change the fallthrough and dismiss the dialog.
    • diff --git a/Ghidra/Features/Base/src/main/help/help/topics/MemoryMapPlugin/Memory_Map.htm b/Ghidra/Features/Base/src/main/help/help/topics/MemoryMapPlugin/Memory_Map.htm index cdf5e0adcb..542cbfd2e2 100644 --- a/Ghidra/Features/Base/src/main/help/help/topics/MemoryMapPlugin/Memory_Map.htm +++ b/Ghidra/Features/Base/src/main/help/help/topics/MemoryMapPlugin/Memory_Map.htm @@ -243,8 +243,10 @@

    Block Name - Enter the name of the new memory block.

    -

    Start Addr - Enter the start address of the new memory block.  If the - program language defines multiple address spaces, the address space must also be +

    Start Address - Enter the start address + (or Address Expression) + of the new memory block.  If + the program language defines multiple address spaces, the address space must also be specified.  The address space selection will not appear if only one is defined. If creating an overlay memory block within an existing overlay address space that space should be selected. A block within the default address space may not span across @@ -378,11 +380,14 @@

    Length - Length of the memory block to be moved (not editable).

    -

    New Start Address - Enter the NEW starting address for the block.  +

    New Start Address - Enter the new starting address + (or Address Expression) + for the block.  The NEW ending address will be computed.

    -

    New End Address -  Enter the NEW ending address for the block. The - NEW starting address will be computed.

    +

    New End Address -  Enter the new ending address + (or Address Expression) + for the block. The NEW starting address will be computed.

    You cannot move a block under the following conditions:

    @@ -404,11 +409,15 @@ enter the split point:

      -
    • Enter an end address for the first block (block to split), or
      • +
    • Enter an end address + (or Address Expression) + for the first block (block to split), or
    • Enter a length for the first block (block to split), or
      • -
    • Enter a start address for the second block (new block), or
      • +
    • Enter a start address + (or Address Expression) + for the second block (new block), or
    • Enter a length for the second block (new block).
    @@ -482,7 +491,9 @@
    -

    New Start Address - A new start address can be entered here.  It must +

    New Start Address - A new start address + (or Address Expression) + can be entered here.  It must be before the current start address.

    End Address - Displays the end address of the block (not editable).

    @@ -521,7 +532,9 @@

    Start Address - Displays the start address of the block (not editable).

    -

    New End Address - A new end address can be entered here. It must be after +

    New End Address - A new end address + (or Address Expression) + can be entered here. It must be after the current end address.

    Block Length - Displays the length of the block.  A new value can be diff --git a/Ghidra/Features/Base/src/main/help/help/topics/MemoryMapPlugin/images/AddMappedBlock.png b/Ghidra/Features/Base/src/main/help/help/topics/MemoryMapPlugin/images/AddMappedBlock.png index a5fd31ff6f529cce9982f62235f115861b2c6dec..16ae13088ecb4bcfeed14a5b3b69227cfcbf0ef5 100644 GIT binary patch literal 14346 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 Bp4b2Y diff --git a/Ghidra/Features/Base/src/main/help/help/topics/MemoryMapPlugin/images/AddMemoryBlock.png b/Ghidra/Features/Base/src/main/help/help/topics/MemoryMapPlugin/images/AddMemoryBlock.png index ac077c9b3a6e9133c2e3a864e103b9fe1bb5a4f2..224b8e3e34ab3155a1eebcd91ace1a2319f0bc96 100644 GIT binary patch literal 14635 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 literal 9398 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 diff --git a/Ghidra/Features/Base/src/main/help/help/topics/MemoryMapPlugin/images/MoveMemory.png b/Ghidra/Features/Base/src/main/help/help/topics/MemoryMapPlugin/images/MoveMemory.png index 8b74e227455f19a31ff8828ba060dddef38bfdfa..bf19daa7e33baeb19e4295a9ee47695bc7952ac7 100644 GIT binary patch literal 8608 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 diff --git a/Ghidra/Features/Base/src/main/help/help/topics/MemoryMapPlugin/images/SetImageBaseDialog.png b/Ghidra/Features/Base/src/main/help/help/topics/MemoryMapPlugin/images/SetImageBaseDialog.png index 34c1ad85878a753ac517819c94b618694a8d9623..8091b723bd9d860c4a21e89844fa8bb2148eb177 100644 GIT binary patch literal 3914 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 F{{_xWcP0P; literal 5922 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 PzDe}7j5I4WKoS1~I8nsI diff --git a/Ghidra/Features/Base/src/main/help/help/topics/MemoryMapPlugin/images/SplitMemoryBlock.png b/Ghidra/Features/Base/src/main/help/help/topics/MemoryMapPlugin/images/SplitMemoryBlock.png index f6cf4bff4e52ffd2e97d8721c27af3cd2a003922..7fa0b6a81a87ce36edd6cb65c84962e82f1989b1 100644 GIT binary patch literal 12135 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 diff --git a/Ghidra/Features/Base/src/main/help/help/topics/Misc/AddressExpressions.htm b/Ghidra/Features/Base/src/main/help/help/topics/Misc/AddressExpressions.htm new file mode 100644 index 0000000000..31664e9ddb --- /dev/null +++ b/Ghidra/Features/Base/src/main/help/help/topics/Misc/AddressExpressions.htm @@ -0,0 +1,175 @@ + + + + + + + Address Expressions + + + + +

    Address Expressions
    +

    + +
    +

    An address expression is an arithmetic expression that is entered into an address input + field and can include symbol names or memory block names that when evaluated results in a + program address.

    + +

    Operands

    + +
    +

    Operands can be either a number or a name that evaluates to an address.

    + +

    Names

    + +
    +

    If the operand is a name, then an attempt will be made to find a unique label or + function name in the current program for that name. If that fails, then memory blocks + will be searched looking for a memory block with that name. In either case, the associated + address for that label, function, or memory block will be used in evaluating the + expression.

    + +

    Generally, symbols (addresses) must be the left operand for a binary operator and will + generate a address as the result (maintaining the address space). The one exception is + you can subtract two addresses and the result is a number.

    +
    + +

    Numbers

    + +
    +

    Numeric operands will be evaluated as either a hex number or decimal number, depending + on the Hex/Decimal Mode of the input field.

    + +

    When in hex mode, undecorated numbers will be interpreted as if they are hex values. + (so "100" would evaluate to the number 256). If in decimal mode, hex numbers can still be + entered by prefixing them with "0x".

    + +

    For fields that support either mode, the current mode will be displayed as "hint text" + in the lower right corner of the field. The mode can be toggled between decimal and hex + by pressing <CTRL> M.

    + +

    When in hex mode, there is no corresponding prefix to use to specify a number as being + decimal. So if you want to have a mixed mode expression, use decimal mode and use the + "0x" prefix for any hex numbers in the expression.

    +
    +
    + +

    Operators

    + +
    +

    Most standard operators are supported, but not all operators are supported for all + operands. Also order of operands is important when mixing numbers and addresses. For + example,a number can be added to an address, but an address can't be added to a number.

    + +

    Operator precedence is the standard precedence defined by the "C" programming + language.

    + +

    Math Operators

    + +
    +

    Supported math operators are "+ - * /". These operators generate either a number or + address result depending on the operands.

    +
    + +

    Logical and Relational Operators

    + +
    +

    Supported logical operators are "< > <= >= == != || && and !". + These operators generator a numeric value of 0 or 1.

    +
    + +

    Bit Operators

    + +
    +

    Supported bit operators are <<, >>, &, |, ^, and ~. These operators + generate either a number or address result depending on the operands.

    +
    + +

    Groups Operators

    + +
    +

    Parenthesis can be used to group sub-expressions to control the order of + operations

    +
    +
    + +

    Result

    + +
    +

    The result of the expression is always an address or a number. If the result is a + number, it is converted to an address using the selected address space (in the case where + there are multiple possible address spaces, a combo is shown for choosing the desired + address space, otherwise the default address space is used)

    +
    + +

    Examples

    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Expression
    +     		Result
    +
    ENTRY+10Address 0x10 higher than the symbol "ENTRY"
    10+ENTRYError (Can't add an address to a number)
    100000+30Address 0x100030 (hex mode)
    0x100000+30Address 0x100030 (hex mode)
    0x100000+30Address 0x10001e (decimal mode)
    0x100000+(2*10)Address 0x100020
    ENTRY + 1<<4Address that is 16 higher than the symbol "ENTRY"
    X - (X > 100) * 100If symbol "X" address > 100, Result is 100 less than X; Otherwise X
    ENTRY | FFAddress that is the symbol "ENTRY" with its last 8 bits set to FF
    +
    +
    + + diff --git a/Ghidra/Features/Base/src/main/help/help/topics/ReferencesPlugin/CreateOffsetReferencesTable.htm b/Ghidra/Features/Base/src/main/help/help/topics/ReferencesPlugin/CreateOffsetReferencesTable.htm index 0b57f92378..5306ccf774 100644 --- a/Ghidra/Features/Base/src/main/help/help/topics/ReferencesPlugin/CreateOffsetReferencesTable.htm +++ b/Ghidra/Features/Base/src/main/help/help/topics/ReferencesPlugin/CreateOffsetReferencesTable.htm @@ -49,7 +49,9 @@
  • The "Enter Base Address" field in the dialog is filled in with the first address in the - selection. You can enter a different address as the base address.
    • + selection. You can enter a different address + (or Address Expression) + as the base address.
  • The "Select Data Size" combo box has an entry for sizes 1, 2, 4, and 8. The size you select diff --git a/Ghidra/Features/Base/src/main/help/help/topics/ReferencesPlugin/References_from.htm b/Ghidra/Features/Base/src/main/help/help/topics/ReferencesPlugin/References_from.htm index ceef476d3c..2016ff571e 100644 --- a/Ghidra/Features/Base/src/main/help/help/topics/ReferencesPlugin/References_from.htm +++ b/Ghidra/Features/Base/src/main/help/help/topics/ReferencesPlugin/References_from.htm @@ -1167,9 +1167,10 @@ c

    [ Offset] The To Address entry is required for normal memory references and specifies the reference destination as a memory offset within a selected address - space.  The address offset entry is always - interpretted as a unsigned hex value  (i.e., the "0x" entry prefix is assumed). -  For those processors with multiple address-spaces, a pull-down is also provided + space. Enter an address + (or Address Expression) to specify + the referenced address. + For those processors with multiple address-spaces, a pull-down is also provided allowing the address-space to be selected. Address spaces which overlay the OTHER non-loaded space are only included if the Include OTHER overlay spaces checkbox is selected.
    diff --git a/Ghidra/Features/Base/src/main/help/help/topics/RegisterPlugin/Registers.htm b/Ghidra/Features/Base/src/main/help/help/topics/RegisterPlugin/Registers.htm index 365d8cbc20..2935b5eec7 100644 --- a/Ghidra/Features/Base/src/main/help/help/topics/RegisterPlugin/Registers.htm +++ b/Ghidra/Features/Base/src/main/help/help/topics/RegisterPlugin/Registers.htm @@ -124,7 +124,10 @@ range is smaller, then value associations for address range that was trucated is effectively cleared. For example, in the dialog shown above, if you change the end address to 01001b47 and change the value to 111, then addresses 01001b33 to 01001b47 - will have the value 111 and address 01001b48 will have no value.
    + will have the value 111 and address 01001b48 will have no value. When entering a + new start or end address, you can also enter an + Address Expression. +

    diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/fallthrough/FallThroughDialog.java b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/fallthrough/FallThroughDialog.java index 3d58ff0476..60e31073fb 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/fallthrough/FallThroughDialog.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/fallthrough/FallThroughDialog.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -117,15 +117,14 @@ class FallThroughDialog extends DialogComponentProvider implements ChangeListene } } - private void addressChanged() { + private void addressChanged(Address address) { if (changing) { return; } Runnable r = () -> { - Address addr = addrField.getAddress(); - if (addr != null || addrField.getValue().length() == 0) { - model.setCurrentFallthrough(addr); + if (address != null || addrField.getText().length() == 0) { + model.setCurrentFallthrough(address); } else { setStatusText("Invalid Address"); @@ -139,9 +138,7 @@ class FallThroughDialog extends DialogComponentProvider implements ChangeListene private JPanel create() { JPanel panel = new JPanel(new BorderLayout(0, 10)); panel.setBorder(BorderFactory.createEmptyBorder(5, 0, 0, 0)); - addrField = new AddressInput(); - addrField.setAddressFactory(model.getProgram().getAddressFactory()); - addrField.addChangeListener(e -> addressChanged()); + addrField = new AddressInput(model.getProgram(), this::addressChanged); addrField.addActionListener(e -> model.setCurrentFallthrough(addrField.getAddress())); panel.add(createHomePanel(), BorderLayout.NORTH); panel.add(createAddressPanel(), BorderLayout.CENTER); diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/function/editor/VarnodeLocationCellEditor.java b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/function/editor/VarnodeLocationCellEditor.java index fcd29e0255..89bcb26a78 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/function/editor/VarnodeLocationCellEditor.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/function/editor/VarnodeLocationCellEditor.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -148,8 +148,9 @@ class VarnodeLocationCellEditor extends AbstractCellEditor } private Component createAddressEditor(VarnodeInfo varnode) { - addressInput = new AddressInput(BorderFactory.createEmptyBorder()); - addressInput.setAddressFactory(program.getAddressFactory()); + addressInput = new AddressInput(program); + addressInput.setComponentBorders(BorderFactory.createEmptyBorder()); + Address address = varnode.getAddress(); if (address != null) { addressInput.setAddress(address); diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/AddBlockDialog.java b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/AddBlockDialog.java index f14e991a1a..e08091b5ef 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/AddBlockDialog.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/AddBlockDialog.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -35,7 +35,6 @@ import ghidra.app.util.HelpTopics; import ghidra.framework.plugintool.PluginTool; import ghidra.program.database.mem.FileBytes; import ghidra.program.model.address.Address; -import ghidra.program.model.address.AddressFactory; import ghidra.program.model.listing.Program; import ghidra.program.model.mem.Memory; import ghidra.program.model.mem.MemoryBlockType; @@ -69,7 +68,6 @@ class AddBlockDialog extends DialogComponentProvider implements ChangeListener { private JCheckBox overlayCB; private RegisterField initialValueField; private JLabel initialValueLabel; - private AddressFactory addrFactory; private AddressInput baseAddrField; // used for Bit and Byte mapped blocks private IntegerTextField schemeDestByteCountField; // used for Byte mapped blocks private IntegerTextField schemeSrcByteCountField; // used for Byte mapped blocks @@ -134,12 +132,12 @@ class AddBlockDialog extends DialogComponentProvider implements ChangeListener { } private Component buildBasicInfoPanel() { - JPanel panel = new JPanel(new PairLayout(4, 10, 150)); + JPanel panel = new JPanel(new PairLayout(5, 10, 150)); panel.setBorder(BorderFactory.createEmptyBorder(5, 7, 4, 5)); panel.add(new GLabel("Block Name:", SwingConstants.RIGHT)); panel.add(buildNameField()); - panel.add(new GLabel("Start Addr:", SwingConstants.RIGHT)); + panel.add(new GLabel("Start Address:", SwingConstants.RIGHT)); panel.add(buildAddressField()); panel.add(new GLabel("Length:", SwingConstants.RIGHT)); panel.add(buildLengthField()); @@ -422,26 +420,16 @@ class AddBlockDialog extends DialogComponentProvider implements ChangeListener { model.setFileBytes((FileBytes) fileBytesComboBox.getSelectedItem()); } - private void addrChanged() { - Address addr = null; - try { - addr = addrField.getAddress(); - } - catch (IllegalArgumentException e) { - // just let it be null - } - model.setStartAddress(addr); + private void addressChanged(Address address) { + model.setStartAddress(address); } - private void baseAddressChanged() { - Address addr = null; - try { - addr = baseAddrField.getAddress(); - } - catch (IllegalArgumentException e) { - // just let it be null - } - model.setBaseAddress(addr); + private void addressError(String errorMessage) { + model.setAddressError(errorMessage); + } + + private void baseAddressChanged(Address address) { + model.setBaseAddress(address); } private void schemeSrcByteCountChanged() { @@ -476,12 +464,11 @@ class AddBlockDialog extends DialogComponentProvider implements ChangeListener { } private JPanel buildMappedPanel() { + Program program = model.getProgram(); JPanel panel = new JPanel(new PairLayout()); - baseAddrField = new AddressInput(); - baseAddrField.setAddressFactory(addrFactory); + baseAddrField = new AddressInput(program, this::baseAddressChanged); baseAddrField.setName("Source Addr"); - baseAddrField.addChangeListener(ev -> baseAddressChanged()); baseAddrField.setAccessibleName("Source Address"); JPanel schemePanel = new JPanel(new FlowLayout(FlowLayout.LEFT)); @@ -504,7 +491,6 @@ class AddBlockDialog extends DialogComponentProvider implements ChangeListener { schemePanel.add(new GLabel(" : ")); schemePanel.add(schemeSrcByteCountField.getComponent()); - Program program = model.getProgram(); Address minAddr = program.getMinAddress(); if (minAddr == null) { minAddr = program.getAddressFactory().getDefaultAddressSpace().getAddress(0); @@ -561,12 +547,12 @@ class AddBlockDialog extends DialogComponentProvider implements ChangeListener { } private Component buildAddressField() { - addrField = new AddressInput(); + Program program = model.getProgram(); + addrField = new AddressInput(program, this::addressChanged); + addrField.setAddressErrorConsumer(this::addressError); + addrField.setAddressSpaceFilter(AddressInput.ALL_MEMORY_SPACES); addrField.setName("Start Addr"); addrField.setAccessibleName("Memory Block Start Address"); - addrFactory = model.getProgram().getAddressFactory(); - addrField.setAddressFactory(addrFactory, AddressInput.INCLUDE_ALL_MEMORY_SPACES); - addrField.addChangeListener(ev -> addrChanged()); return addrField; } diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/AddBlockModel.java b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/AddBlockModel.java index ecb9be0f45..0db19ece94 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/AddBlockModel.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/AddBlockModel.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -59,6 +59,7 @@ class AddBlockModel { private String comment; private FileBytes fileBytes; private long fileBytesOffset = -1; + private String addressErrorMessage; enum InitializedType { UNINITIALIZED, INITIALIZED_FROM_VALUE, INITIALIZED_FROM_FILE_BYTES; @@ -90,6 +91,14 @@ class AddBlockModel { void setStartAddress(Address addr) { startAddr = addr; + addressErrorMessage = null; + validateInfo(); + listener.stateChanged(null); + } + + void setAddressError(String errorMessage) { + startAddr = null; + addressErrorMessage = errorMessage; validateInfo(); listener.stateChanged(null); } @@ -432,6 +441,9 @@ class AddBlockModel { return true; } message = "Please enter a valid Start Address"; + if (addressErrorMessage != null) { + message = "Invalid Address: " + addressErrorMessage; + } return false; } diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/ExpandBlockDialog.java b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/ExpandBlockDialog.java index 1f6e981e22..0d380004b7 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/ExpandBlockDialog.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/ExpandBlockDialog.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -18,6 +18,7 @@ package ghidra.app.plugin.core.memory; import java.awt.BorderLayout; import java.awt.Cursor; import java.awt.event.ActionListener; +import java.util.function.Consumer; import javax.swing.*; import javax.swing.event.ChangeEvent; @@ -30,7 +31,7 @@ import ghidra.app.util.AddressInput; import ghidra.app.util.HelpTopics; import ghidra.framework.plugintool.PluginTool; import ghidra.program.model.address.Address; -import ghidra.program.model.address.AddressFactory; +import ghidra.program.model.listing.Program; import ghidra.program.model.mem.MemoryBlock; import ghidra.util.HelpLocation; import ghidra.util.layout.PairLayout; @@ -49,7 +50,6 @@ class ExpandBlockDialog extends DialogComponentProvider implements ChangeListene private final static String EXPAND_UP_TITLE = "Expand Block Up"; private final static String EXPAND_DOWN_TITLE = "Expand Block Down"; private int dialogType; - private AddressFactory addrFactory; private AddressInput startAddressInput; private AddressInput endAddressInput; private JTextField startField; @@ -66,7 +66,7 @@ class ExpandBlockDialog extends DialogComponentProvider implements ChangeListene * @param af * @param dialogType */ - ExpandBlockDialog(PluginTool tool, ExpandBlockModel model, MemoryBlock block, AddressFactory af, + ExpandBlockDialog(PluginTool tool, ExpandBlockModel model, MemoryBlock block, Program program, int dialogType) { super(dialogType == EXPAND_UP ? EXPAND_UP_TITLE : EXPAND_DOWN_TITLE, true); this.tool = tool; @@ -74,9 +74,8 @@ class ExpandBlockDialog extends DialogComponentProvider implements ChangeListene this.dialogType = dialogType; setHelpLocation(new HelpLocation(HelpTopics.MEMORY_MAP, dialogType == EXPAND_UP ? EXPAND_UP_TITLE : EXPAND_DOWN_TITLE)); - addrFactory = af; model.setChangeListener(this); - addWorkPanel(create(block)); + addWorkPanel(create(block, program)); addOKButton(); addCancelButton(); setOkEnabled(false); @@ -109,16 +108,16 @@ class ExpandBlockDialog extends DialogComponentProvider implements ChangeListene * Create the main work panel. * @return JPanel */ - private JPanel create(MemoryBlock block) { + private JPanel create(MemoryBlock block, Program program) { JPanel panel = new JPanel(new PairLayout(5, 5, 150)); - startAddressInput = new AddressInput(); + AddressChangeListener listener = new AddressChangeListener(); + + startAddressInput = new AddressInput(program, listener); startAddressInput.setName("NewStartAddress"); - startAddressInput.setAddressFactory(addrFactory); startAddressInput.setAccessibleName("New Start Address"); - endAddressInput = new AddressInput(); + endAddressInput = new AddressInput(program, listener); endAddressInput.setName("EndAddress"); - endAddressInput.setAddressFactory(addrFactory); endAddressInput.setAccessibleName("New End Address"); Address start = block.getStart(); @@ -161,9 +160,6 @@ class ExpandBlockDialog extends DialogComponentProvider implements ChangeListene } private void addListeners() { - - startAddressInput.addChangeListener(new AddressChangeListener()); - endAddressInput.addChangeListener(new AddressChangeListener()); lengthField.setChangeListener(new LengthChangeListener()); ActionListener al = e -> setStatusText(""); @@ -206,10 +202,10 @@ class ExpandBlockDialog extends DialogComponentProvider implements ChangeListene * Listener on the AddressInput field; update length field when the * address input field changes. */ - private class AddressChangeListener implements ChangeListener { + private class AddressChangeListener implements Consumer
    { @Override - public void stateChanged(ChangeEvent event) { + public void accept(Address address) { if (isChanging) { return; } diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/MemoryMapProvider.java b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/MemoryMapProvider.java index dfdadc9024..f76b429a55 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/MemoryMapProvider.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/MemoryMapProvider.java @@ -690,7 +690,7 @@ class MemoryMapProvider extends ComponentProviderAdapter { "OTHER overlay blocks can not be split."); } else { - SplitBlockDialog d = new SplitBlockDialog(plugin, block, program.getAddressFactory()); + SplitBlockDialog d = new SplitBlockDialog(plugin, block, program); tool.showDialog(d, this); } } @@ -711,7 +711,7 @@ class MemoryMapProvider extends ComponentProviderAdapter { } ExpandBlockDialog dialog = - new ExpandBlockDialog(tool, model, block, program.getAddressFactory(), dialogType); + new ExpandBlockDialog(tool, model, block, program, dialogType); model.initialize(block); dialog.dispose(); } diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/MoveBlockDialog.java b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/MoveBlockDialog.java index d258e42662..b2767dab70 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/MoveBlockDialog.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/MoveBlockDialog.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -28,7 +28,7 @@ import ghidra.app.util.AddressInput; import ghidra.app.util.HelpTopics; import ghidra.framework.plugintool.PluginTool; import ghidra.program.model.address.Address; -import ghidra.program.model.address.AddressFactory; +import ghidra.program.model.listing.Program; import ghidra.util.HelpLocation; import ghidra.util.Swing; import ghidra.util.layout.PairLayout; @@ -82,9 +82,9 @@ public class MoveBlockDialog extends DialogComponentProvider implements MoveBloc setOkEnabled(false); changing = true; if (!isVisible()) { - AddressFactory factory = model.getAddressFactory(); - newStartField.setAddressFactory(factory); - newEndField.setAddressFactory(factory); + Program program = model.getProgram(); + newStartField.setProgram(program); + newEndField.setProgram(program); } Address newStart = model.getNewStartAddress(); if (newStart != null) { @@ -136,8 +136,8 @@ public class MoveBlockDialog extends DialogComponentProvider implements MoveBloc } private JPanel buildMainPanel() { - JPanel panel = new JPanel(new PairLayout(5, 20, 150)); - panel.setBorder(BorderFactory.createEmptyBorder(20, 20, 20, 20)); + JPanel panel = new JPanel(new PairLayout(2, 10, 150)); + panel.setBorder(BorderFactory.createEmptyBorder(15, 20, 15, 20)); blockNameLabel = new GDLabel(".text"); blockNameLabel.setName("blockName"); // name components for junits @@ -150,15 +150,12 @@ public class MoveBlockDialog extends DialogComponentProvider implements MoveBloc lengthLabel = new GDLabel("4096 (0x1000)"); lengthLabel.setName("length"); - newStartField = new AddressInput(); + newStartField = new AddressInput(model.getProgram(), this::startChanged); newStartField.setName("newStart"); - newEndField = new AddressInput(); + newEndField = new AddressInput(model.getProgram(), this::endChanged); newEndField.setName("newEnd"); - newStartField.addChangeListener(e -> startChanged()); - newEndField.addChangeListener(e -> endChanged()); - panel.add(new GLabel("Name:", SwingConstants.RIGHT)); panel.add(blockNameLabel); panel.add(new GLabel("Start Address:", SwingConstants.RIGHT)); @@ -174,13 +171,12 @@ public class MoveBlockDialog extends DialogComponentProvider implements MoveBloc return panel; } - private void startChanged() { + private void startChanged(Address address) { if (changing) { return; } - Address newStart = newStartField.getAddress(); - if (newStart != null) { - model.setNewStartAddress(newStart); + if (address != null) { + model.setNewStartAddress(address); } else { setStatusText("Invalid Address"); @@ -188,13 +184,12 @@ public class MoveBlockDialog extends DialogComponentProvider implements MoveBloc } } - private void endChanged() { + private void endChanged(Address address) { if (changing) { return; } - Address newEnd = newEndField.getAddress(); - if (newEnd != null) { - model.setNewEndAddress(newEnd); + if (address != null) { + model.setNewEndAddress(address); } else { setStatusText("Invalid Address"); diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/MoveBlockModel.java b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/MoveBlockModel.java index 0bfed6c5c6..d9d2a75580 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/MoveBlockModel.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/MoveBlockModel.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -18,7 +18,8 @@ package ghidra.app.plugin.core.memory; import ghidra.app.cmd.memory.MoveBlockListener; import ghidra.app.cmd.memory.MoveBlockTask; import ghidra.framework.model.*; -import ghidra.program.model.address.*; +import ghidra.program.model.address.Address; +import ghidra.program.model.address.AddressOverflowException; import ghidra.program.model.listing.Program; import ghidra.program.model.mem.MemoryBlock; @@ -183,8 +184,8 @@ class MoveBlockModel implements DomainObjectListener { program = null; } - AddressFactory getAddressFactory() { - return program.getAddressFactory(); + Program getProgram() { + return program; } private Address getEndAddress(Address start) { diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/SplitBlockDialog.java b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/SplitBlockDialog.java index 667443eb2b..d3833417b8 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/SplitBlockDialog.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/memory/SplitBlockDialog.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -27,7 +27,9 @@ import docking.widgets.label.GLabel; import ghidra.app.plugin.core.misc.RegisterField; import ghidra.app.util.AddressInput; import ghidra.app.util.HelpTopics; -import ghidra.program.model.address.*; +import ghidra.program.model.address.Address; +import ghidra.program.model.address.AddressOverflowException; +import ghidra.program.model.listing.Program; import ghidra.program.model.mem.Memory; import ghidra.program.model.mem.MemoryBlock; import ghidra.util.HelpLocation; @@ -50,16 +52,14 @@ class SplitBlockDialog extends DialogComponentProvider { private JTextField blockTwoEndField; private RegisterField blockTwoLengthField; private MemoryBlock block; - private AddressFactory addrFactory; private MemoryMapPlugin plugin; - SplitBlockDialog(MemoryMapPlugin plugin, MemoryBlock block, AddressFactory af) { + SplitBlockDialog(MemoryMapPlugin plugin, MemoryBlock block, Program program) { super("Split Block"); this.plugin = plugin; this.block = block; - addrFactory = af; setHelpLocation(new HelpLocation(HelpTopics.MEMORY_MAP, "Split Block")); - addWorkPanel(create()); + addWorkPanel(create(program)); addOKButton(); addCancelButton(); setOkEnabled(false); @@ -89,8 +89,8 @@ class SplitBlockDialog extends DialogComponentProvider { * Create the work panel. * @return JPanel */ - private JPanel create() { - JPanel panelOne = new JPanel(new PairLayout(5, 5, 150)); + private JPanel create(Program program) { + JPanel panelOne = new JPanel(new PairLayout(5, 10, 150)); panelOne.setBorder(BorderFactory.createTitledBorder("Block to Split")); blockOneNameField = new JTextField(10); blockOneNameField.setName("BlockOneName"); @@ -99,7 +99,7 @@ class SplitBlockDialog extends DialogComponentProvider { blockOneStartField.setName("BlockOneStart"); blockOneStartField.getAccessibleContext().setAccessibleName("Address of Block To Split"); - blockOneEnd = new AddressInput(); + blockOneEnd = new AddressInput(program, this::blockOneEndChanged); blockOneEnd.setName("BlockOneEnd"); blockOneEnd.setAccessibleName("New Block End Adddress"); @@ -121,7 +121,7 @@ class SplitBlockDialog extends DialogComponentProvider { blockTwoNameField = new JTextField(10); blockTwoNameField.setName("BlockTwoName"); blockTwoNameField.getAccessibleContext().setAccessibleName("Name of New Block"); - blockTwoStart = new AddressInput(); + blockTwoStart = new AddressInput(program, this::blockTwoStartChanged); blockTwoStart.setName("BlockTwoStart"); blockTwoStart.setAccessibleName("New Block Start Address"); blockTwoEndField = new JTextField(10); @@ -141,11 +141,11 @@ class SplitBlockDialog extends DialogComponentProvider { panelTwo.add(blockTwoLengthField); JPanel mainPanel = new JPanel(); + mainPanel.setBorder(BorderFactory.createEmptyBorder(15, 20, 15, 20)); BoxLayout bl = new BoxLayout(mainPanel, BoxLayout.Y_AXIS); mainPanel.setLayout(bl); - mainPanel.add(Box.createVerticalStrut(5)); mainPanel.add(panelOne); - mainPanel.add(Box.createVerticalStrut(10)); + mainPanel.add(Box.createVerticalStrut(20)); mainPanel.add(panelTwo); return mainPanel; @@ -166,7 +166,6 @@ class SplitBlockDialog extends DialogComponentProvider { blockOneStartField.setText(startAddr.toString()); blockOneStartField.setEnabled(false); - blockOneEnd.setAddressFactory(addrFactory); blockOneEnd.setAddress(endAddr); blockOneEnd.setAddressSpaceEditable(false); @@ -174,7 +173,6 @@ class SplitBlockDialog extends DialogComponentProvider { blockTwoNameField.setText(name + ".split"); - blockTwoStart.setAddressFactory(addrFactory); blockTwoStart.setAddress(startAddr); blockTwoStart.setAddressSpaceEditable(false); @@ -189,8 +187,6 @@ class SplitBlockDialog extends DialogComponentProvider { blockOneLengthField.setChangeListener(new LengthChangeListener(blockOneLengthField)); blockTwoLengthField.setChangeListener(new LengthChangeListener(blockTwoLengthField)); - blockOneEnd.addChangeListener(new AddressChangeListener(blockOneEnd)); - blockTwoStart.addChangeListener(new AddressChangeListener(blockTwoStart)); ActionListener al = e -> setStatusText(""); blockOneLengthField.addActionListener(al); @@ -307,135 +303,101 @@ class SplitBlockDialog extends DialogComponentProvider { } } - /** - * Listener on the AddressInput fields; update other fields when either - * of these fields change. - */ - private class AddressChangeListener implements ChangeListener { + private void blockOneEndChanged(Address end) { + setStatusText(""); + boolean isValid = checkBlockOneEndAddress(end); + setOkEnabled(isValid); + } - AddressInput source; + private void blockTwoStartChanged(Address start) { + setStatusText(""); + boolean isValid = checkBlockTwoStartChanged(start); + setOkEnabled(isValid); + } - public AddressChangeListener(AddressInput source) { - this.source = source; + private boolean checkBlockOneEndAddress(Address end) { + + if (end == null) { + setStatusText("Invalid Address"); + return false; } - @Override - public void stateChanged(ChangeEvent event) { - setStatusText(""); - boolean ok = false; - if (source == blockOneEnd) { - ok = blockOneEndChanged(); - } - else if (source == blockTwoStart) { - ok = blockTwoStartChanged(); - } - setOkEnabled(ok); + Address start = block.getStart(); + + if (end.compareTo(start) < 0) { + setStatusText("End address must be greater than start"); + return false; } - - private Address getAddress() throws InvalidInputException { - - AddressInput field = source; - Address addr = field.getAddress(); - if (addr == null && field.hasInput()) { - throw new InvalidInputException(); - } - return addr; + if (end.compareTo(block.getEnd()) == 0) { + return false; } - - private boolean blockOneEndChanged() { - Address start = block.getStart(); - Address end = null; - try { - end = getAddress(); - } - catch (InvalidInputException e) { - setStatusText("Invalid Address"); - return false; - } - - if (end == null) { - return false; - } - if (end.compareTo(start) < 0) { - setStatusText("End address must be greater than start"); - return false; - } - if (end.compareTo(block.getEnd()) == 0) { - return false; - } - // change block One length and blockTwoStart, blockTwoLength - long length = 0; - try { - length = end.subtract(start) + 1; - } - catch (IllegalArgumentException e) { - setStatusText(e.getMessage()); - return false; - } - long blockSize = block.getSize(); - if (length > blockSize) { - setStatusText( - "End address must be less than original block end (" + block.getEnd() + ")"); - return false; - } - blockOneLengthField.setValue(Long.valueOf(length)); - - try { - Address b2Start = end.addNoWrap(1); - blockTwoStart.setAddress(b2Start); - length = block.getEnd().subtract(b2Start) + 1; - blockTwoLengthField.setValue(Long.valueOf(length)); - } - catch (Exception e) { - if (e instanceof AddressOverflowException) { - setStatusText("Could not create new start address"); - } - return false; - } - return true; + // change block One length and blockTwoStart, blockTwoLength + long length = 0; + try { + length = end.subtract(start) + 1; } + catch (IllegalArgumentException e) { + setStatusText(e.getMessage()); + return false; + } + long blockSize = block.getSize(); + if (length > blockSize) { + setStatusText( + "End address must be less than original block end (" + block.getEnd() + ")"); + return false; + } + blockOneLengthField.setValue(Long.valueOf(length)); - private boolean blockTwoStartChanged() { - Address start = null; - try { - start = getAddress(); - } - catch (InvalidInputException e) { - setStatusText("Invalid Address"); - return false; - } - Address end = block.getEnd(); - if (start == null) { - return false; - } - else if (start.compareTo(end) > 0) { - setStatusText("Start address must not be greater than end"); - return false; - } - else if (start.compareTo(block.getStart()) <= 0) { - setStatusText("Start address must be greater than original block start (" + - block.getStart() + ")"); - return false; - } - - // change block Two length, blockOneEnd, block One length - long length = end.subtract(start) + 1; + try { + Address b2Start = end.addNoWrap(1); + blockTwoStart.setAddress(b2Start); + length = block.getEnd().subtract(b2Start) + 1; blockTwoLengthField.setValue(Long.valueOf(length)); - try { - Address b1End = start.subtractNoWrap(1); - blockOneEnd.setAddress(b1End); - length = b1End.subtract(block.getStart()) + 1; - blockOneLengthField.setValue(Long.valueOf(length)); - } - catch (Exception e) { - if (e instanceof AddressOverflowException) { - setStatusText("Could not create end address for split block"); - } - return false; - } - return true; } + catch (Exception e) { + if (e instanceof AddressOverflowException) { + setStatusText("Could not create new start address"); + } + return false; + } + return true; } + private boolean checkBlockTwoStartChanged(Address start) { + if (start == null) { + setStatusText("Invalid Address"); + return false; + } + Address end = block.getEnd(); + if (start == null) { + return false; + } + else if (start.compareTo(end) > 0) { + setStatusText("Start address must not be greater than end"); + return false; + } + else if (start.compareTo(block.getStart()) <= 0) { + setStatusText("Start address must be greater than original block start (" + + block.getStart() + ")"); + return false; + } + + // change block Two length, blockOneEnd, block One length + long length = end.subtract(start) + 1; + blockTwoLengthField.setValue(Long.valueOf(length)); + try { + Address b1End = start.subtractNoWrap(1); + blockOneEnd.setAddress(b1End); + length = b1End.subtract(block.getStart()) + 1; + blockOneLengthField.setValue(Long.valueOf(length)); + } + catch (Exception e) { + if (e instanceof AddressOverflowException) { + setStatusText("Could not create end address for split block"); + } + return false; + } + return true; + } } diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/references/EditExternalReferencePanel.java b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/references/EditExternalReferencePanel.java index d035cdd865..8682ea8bfa 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/references/EditExternalReferencePanel.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/references/EditExternalReferencePanel.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -231,7 +231,7 @@ class EditExternalReferencePanel extends EditReferencePanel { updateExtLibPath(); extLabel.setText(extLoc.getLabel()); - extAddr.setAddressFactory(program.getAddressFactory()); + extAddr.setProgram(program); Address addr = extLoc.getAddress(); if (addr != null) { extAddr.setAddress(addr); @@ -260,7 +260,7 @@ class EditExternalReferencePanel extends EditReferencePanel { extLibPath.setText(null); extLabel.setText(null); - extAddr.setAddressFactory(program.getAddressFactory()); + extAddr.setProgram(program); extAddr.clear(); extLibName.requestFocus(); diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/references/EditMemoryReferencePanel.java b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/references/EditMemoryReferencePanel.java index a390606c53..875d13ad8e 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/references/EditMemoryReferencePanel.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/references/EditMemoryReferencePanel.java @@ -191,7 +191,8 @@ class EditMemoryReferencePanel extends EditReferencePanel { } private void initializeToAddressField(Address toAddr) { - toAddressField.setAddressFactory(fromCodeUnit.getProgram().getAddressFactory(), (s) -> { + Program program = fromCodeUnit.getProgram(); + toAddressField.setProgram(program, (s) -> { if (s.isLoadedMemorySpace()) { return true; } diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/references/OffsetTableDialog.java b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/references/OffsetTableDialog.java index 1ce2c350bb..b97ce8479f 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/references/OffsetTableDialog.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/references/OffsetTableDialog.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -19,8 +19,6 @@ import java.awt.event.ActionEvent; import java.awt.event.ActionListener; import javax.swing.*; -import javax.swing.event.ChangeEvent; -import javax.swing.event.ChangeListener; import docking.DialogComponentProvider; import docking.widgets.checkbox.GCheckBox; @@ -30,7 +28,7 @@ import ghidra.app.util.AddressInput; import ghidra.app.util.HelpTopics; import ghidra.framework.plugintool.PluginTool; import ghidra.program.model.address.Address; -import ghidra.program.model.address.AddressFactory; +import ghidra.program.model.listing.Program; import ghidra.util.HelpLocation; import ghidra.util.exception.CancelledException; import ghidra.util.layout.PairLayout; @@ -44,7 +42,6 @@ import ghidra.util.layout.PairLayout; public class OffsetTableDialog extends DialogComponentProvider { private AddressInput addrInput; - private AddressFactory addrFactory; private JComboBox comboBox; private Address defaultAddress; private JCheckBox signedCheckBox; @@ -52,15 +49,13 @@ public class OffsetTableDialog extends DialogComponentProvider { /** * Construct a new dialog - * @param parent parent of this dialog * @param defaultAddress address to put in the address field as a default - * @param addrFactory address factory required by AddressInput object + * @param program the program */ - OffsetTableDialog(Address defaultAddress, AddressFactory addrFactory) { + OffsetTableDialog(Address defaultAddress, Program program) { super("Create Offset References", true); this.defaultAddress = defaultAddress; - this.addrFactory = addrFactory; - addWorkPanel(buildMainPanel()); + addWorkPanel(buildMainPanel(program)); addOKButton(); addCancelButton(); setHelpLocation(new HelpLocation(HelpTopics.REFERENCES, "Create_Offset_References")); @@ -128,23 +123,16 @@ public class OffsetTableDialog extends DialogComponentProvider { signedCheckBox.setSelected(isSigned); } - private JPanel buildMainPanel() { + private JPanel buildMainPanel(Program program) { JPanel panel = new JPanel(new PairLayout(10, 5)); panel.setBorder(BorderFactory.createEmptyBorder(20, 20, 10, 20)); - addrInput = new AddressInput(); + addrInput = new AddressInput(program, a -> clearStatusText()); addrInput.addActionListener(new ActionListener() { @Override public void actionPerformed(ActionEvent e) { okCallback(); } }); - addrInput.addChangeListener(new ChangeListener() { - @Override - public void stateChanged(ChangeEvent e) { - clearStatusText(); - } - }); - addrInput.setAddressFactory(addrFactory); addrInput.setAddress(defaultAddress); panel.add(new GLabel("Enter Base Address:", SwingConstants.RIGHT)); diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/references/OffsetTablePlugin.java b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/references/OffsetTablePlugin.java index cb71a01366..ad2faf2d17 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/references/OffsetTablePlugin.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/references/OffsetTablePlugin.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -101,10 +101,10 @@ public class OffsetTablePlugin extends Plugin { true); return; } - AddressFactory addressFactory = context.getProgram().getAddressFactory(); + Program program = context.getProgram(); Address minAddress = context.getSelection().getMinAddress(); - OffsetTableDialog dialog = new OffsetTableDialog(minAddress, addressFactory); + OffsetTableDialog dialog = new OffsetTableDialog(minAddress, program); dialog.setSelectedSize(lastSelectedSize); dialog.setSigned(lastSigned); try { diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/register/EditRegisterValueDialog.java b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/register/EditRegisterValueDialog.java index a21fb4e75f..7690205dc0 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/register/EditRegisterValueDialog.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/register/EditRegisterValueDialog.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -16,17 +16,18 @@ package ghidra.app.plugin.core.register; import java.math.BigInteger; +import java.util.function.Consumer; import javax.swing.*; -import javax.swing.event.ChangeEvent; -import javax.swing.event.ChangeListener; import docking.DialogComponentProvider; import docking.widgets.label.GLabel; import ghidra.app.util.AddressInput; import ghidra.app.util.bean.FixedBitSizeValueField; -import ghidra.program.model.address.*; +import ghidra.program.model.address.Address; +import ghidra.program.model.address.AddressSpace; import ghidra.program.model.lang.Register; +import ghidra.program.model.listing.Program; import ghidra.util.HelpLocation; import ghidra.util.MessageType; import ghidra.util.layout.PairLayout; @@ -39,9 +40,9 @@ class EditRegisterValueDialog extends DialogComponentProvider { private boolean wasCancelled = true; EditRegisterValueDialog(Register register, Address start, Address end, BigInteger value, - AddressFactory factory) { + Program program) { super("Edit Register Value Range"); - addWorkPanel(buildWorkPanel(register, start, end, value, factory)); + addWorkPanel(buildWorkPanel(register, start, end, value, program)); addOKButton(); addCancelButton(); @@ -49,24 +50,15 @@ class EditRegisterValueDialog extends DialogComponentProvider { } private JComponent buildWorkPanel(Register register, Address start, Address end, - BigInteger value, AddressFactory factory) { + BigInteger value, Program program) { JTextField registerField = new JTextField(register.getName() + " (" + register.getBitLength() + ")"); registerField.setEditable(false); - startAddrField = new AddressInput(); - endAddrField = new AddressInput(); - ChangeListener changeListener = new ChangeListener() { - @Override - public void stateChanged(ChangeEvent e) { - updateOk(); - } - }; - startAddrField.setAddressFactory(factory); - endAddrField.setAddressFactory(factory); - startAddrField.addChangeListener(changeListener); - endAddrField.addChangeListener(changeListener); + Consumer
    addressChangeListener = a -> updateOk(); + startAddrField = new AddressInput(program, addressChangeListener); + endAddrField = new AddressInput(program, addressChangeListener); registerValueField = new FixedBitSizeValueField(register.getBitLength(), true, false); startAddrField.setAddress(start); diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/register/RegisterValuesPanel.java b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/register/RegisterValuesPanel.java index 2a998d17b1..ad13415478 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/register/RegisterValuesPanel.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/register/RegisterValuesPanel.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -89,7 +89,7 @@ class RegisterValuesPanel extends JPanel { Address end = range.getEndAddress(); BigInteger value = range.getValue(); EditRegisterValueDialog dialog = new EditRegisterValueDialog(selectedRegister, start, end, - value, currentProgram.getAddressFactory()); + value, currentProgram); tool.showDialog(dialog, this); if (!dialog.wasCancelled()) { diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/symboltree/EditExternalLocationPanel.java b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/symboltree/EditExternalLocationPanel.java index 1790bda493..368b92a8c2 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/symboltree/EditExternalLocationPanel.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/plugin/core/symboltree/EditExternalLocationPanel.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -300,7 +300,7 @@ class EditExternalLocationPanel extends JPanel { if (extOriginalLabelTextField != null) { extOriginalLabelTextField.setText(startingOriginalName); } - extAddressInputWidget.setAddressFactory(program.getAddressFactory()); + extAddressInputWidget.setProgram(program); if (startingLocationAddress != null) { extAddressInputWidget.setAddress(startingLocationAddress); } diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/script/GhidraScript.java b/Ghidra/Features/Base/src/main/java/ghidra/app/script/GhidraScript.java index add559fc85..bdc31cc6e7 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/script/GhidraScript.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/script/GhidraScript.java @@ -2630,7 +2630,7 @@ public abstract class GhidraScript extends FlatProgramAPI { Address choice = doAsk(Integer.class, title, message, existingValue, lastValue -> { AskAddrDialog dialog = - new AskAddrDialog(title, message, currentProgram.getAddressFactory(), lastValue); + new AskAddrDialog(title, message, currentProgram, lastValue); if (dialog.isCanceled()) { throw new CancelledException(); } diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/util/AddressInput.java b/Ghidra/Features/Base/src/main/java/ghidra/app/util/AddressInput.java index c31a4318f0..f0b3014195 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/util/AddressInput.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/util/AddressInput.java @@ -16,34 +16,44 @@ package ghidra.app.util; import java.awt.BorderLayout; -import java.awt.FontMetrics; +import java.awt.CardLayout; import java.awt.event.ActionListener; import java.util.Arrays; import java.util.Comparator; +import java.util.function.Consumer; import java.util.function.Predicate; import javax.swing.*; import javax.swing.border.Border; -import javax.swing.event.*; +import javax.swing.event.DocumentEvent; +import javax.swing.event.DocumentListener; import docking.widgets.combobox.GComboBox; import docking.widgets.table.FocusableEditor; +import docking.widgets.textfield.HexDecimalModeTextField; +import generic.expressions.ExpressionException; import ghidra.program.model.address.*; +import ghidra.program.model.listing.Program; +import ghidra.program.util.AddressEvaluator; +import utility.function.Dummy; /** - * Panel for user input of addresses. Handles case with multiple address - * spaces. + * Input field for entering address or address expression. Handles multiple address + * spaces and supports both hex and decimal number modes for evaluating numbers. */ public class AddressInput extends JPanel implements FocusableEditor { - private JTextField textField; - private JComboBox combo; + public final static Predicate ALL_MEMORY_SPACES = s -> s.isMemorySpace(); + public final static Predicate LOADED_MEMORY_SPACES = s -> s.isLoadedMemorySpace(); + + private HexDecimalModeTextField textField; + private AddressSpaceField addressSpaceField; + AddressEvaluator addressEvaluator; + private Predicate addressSpaceFilter = LOADED_MEMORY_SPACES; + private Consumer
    addressChangedConsumer; + private Consumer addressErrorConsumer = Dummy.consumer(); private boolean comboAdded; - private AddressFactory addrFactory; - private ChangeListener changeListener; - private boolean updatingAddress; - private boolean updateSpaceField; - private boolean stateChanging; - private JTextField spaceField; + private boolean assumeHex = true; + private boolean notificationsEnabled = true; private static final Comparator ADDRESS_SPACE_SORT_COMPARATOR = (s1, s2) -> { if (s1.isOverlaySpace()) { @@ -58,65 +68,132 @@ public class AddressInput extends JPanel implements FocusableEditor { }; /** - * Constructor for AddressInput. - * @param border border around each subcomponent (combo/text fields). + * Constructs an AddressInput field with no specified program or address. */ - public AddressInput(Border border) { - this(); - combo.setBorder(border); + public AddressInput() { + this(null, null, null); + } + + /** + * Constructs an AddressInput field with a consumer to be called when the address field's + * value changes. + * @param addressChangedConsumer the consumer to be called when the value in the address field + * changes + */ + public AddressInput(Consumer
    addressChangedConsumer) { + this(null, null, addressChangedConsumer); + } + + /** + * Constructs an AddressInput field and initialized with a program. + * @param program the program used to evaluate the entered address expression. + */ + public AddressInput(Program program) { + this(program, null, null); + } + + /** + * Constructs an AddressInput field and initialized with an address factory. + * @param factory the address factory used to evaluate the entered address expression. + */ + public AddressInput(AddressFactory factory) { + this(null, factory, null); + } + + /** + * Constructs an AddressInput field with a consumer to be notified when the address field + * changes and initialized with a program. + * @param program the program used to evaluate the entered address expression. + * @param addressChangedConsumer the consumer to be called when the value in the address field + * changes + */ + public AddressInput(Program program, Consumer
    addressChangedConsumer) { + this(program, null, addressChangedConsumer); + } + + /** + * Constructs an AddressInput field with a consumer to be notified when the address field + * changes and initialized with an address factory. + * @param factory the address factory used to evaluate the entered address expression. + * @param addressChangedConsumer the consumer to be called when the value in the address field + * changes + */ + public AddressInput(AddressFactory factory, Consumer
    addressChangedConsumer) { + this(null, factory, addressChangedConsumer); + } + + private AddressInput(Program program, AddressFactory factory, + Consumer
    addressChangedConsumer) { + this.addressChangedConsumer = Dummy.ifNull(addressChangedConsumer); + buildComponent(); + if (program != null) { + setProgram(program); + } + else if (factory != null) { + setAddressFactory(factory); + } + } + + /** + * Sets a filter predicate to determine which address spaces should be selectable by the user. + * If after filtering only one space is remaining, the address space portion of the address + * input field will not be shown. + * @param spaceFilter the predicate for filtering selectable address spaces. + */ + public void setAddressSpaceFilter(Predicate spaceFilter) { + this.addressSpaceFilter = spaceFilter; + updateAddressSpaceCombo(); + } + + /** + * Sets the text in the expression input textfield. + * @param text the text to initialize the input textfield + */ + public void setText(String text) { + textField.setText(text); + } + + /** + * Used to set the internal borders for use in specialized use cases such as a table field + * editor. + * @param border the border to use for the internal components that make up this input field + */ + public void setComponentBorders(Border border) { + addressSpaceField.setComponentsBorder(border); textField.setBorder(border); } /** - * Constructor for AddressInput. + * Sets the hex/decimal mode for this field. When in hex mode, all numbers are assumed to be + * hexadecimal values. When in decimal mode, all numbers are assumed to be decimal numbers + * unless prefixed with "0x". + * @param hexMode true to assume numbers are hexadecimal. */ - public AddressInput() { - - setLayout(new BorderLayout()); - textField = new JTextField(10); - textField.setName("JTextField");//for JUnits... - combo = new GComboBox<>(); - combo.setName("JComboBox");//for JUnits... - combo.getAccessibleContext().setAccessibleName("Address Space"); - add(textField, BorderLayout.CENTER); - //add(combo, BorderLayout.WEST); - comboAdded = false; - - textField.getDocument().addDocumentListener(new DocumentListener() { - @Override - public void insertUpdate(DocumentEvent e) { - stateChanged(); - } - - @Override - public void removeUpdate(DocumentEvent e) { - stateChanged(); - } - - @Override - public void changedUpdate(DocumentEvent e) { - stateChanged(); - } - }); - - combo.addActionListener(ev -> stateChanged()); + public void setAssumeHex(boolean hexMode) { + textField.setHexMode(hexMode); + hexModeChanged(hexMode); } /** * Set the field to display the given address + * @param address the new address to display */ - public void setAddress(Address addr) { - if (stateChanging) { - // called while we are in doing a state changed notification + public void setAddress(Address address) { + if (address.equals(getAddress())) { return; } - updatingAddress = true; - textField.setText(addr.toString(false)); - combo.setSelectedItem(addr.getAddressSpace()); - updatingAddress = false; - if (updateSpaceField) { - updateSpaceField = false; - spaceField.setText(addr.getAddressSpace().getName()); + notificationsEnabled = false; + try { + String addressString = address.toString(false); + addressString = removeLeadingZeros(addressString); + if (!assumeHex) { + addressString = "0x" + addressString; + } + textField.setText(addressString); + addressSpaceField.setAddressSpace(address.getAddressSpace()); + } + finally { + notificationsEnabled = true; } } @@ -124,42 +201,53 @@ public class AddressInput extends JPanel implements FocusableEditor { * Returns the address in the field or null if the address can't * be parsed. * @return The address for the current value in the text field + * @throws ExpressionException if expression can not be evaluated to a valid address. * * @throws NullPointerException if AddressFactory has not been set. */ - public Address getAddress() { - String addrStr = textField.getText(); - - AddressSpace space = getAddressSpace(); - try { - return space.getAddress(addrStr); + public Address getAddressWithExceptions() throws ExpressionException { + String addrExpression = textField.getText(); + if (addrExpression.isBlank()) { + return null; } - catch (AddressFormatException e) { + + return addressEvaluator.parseAsAddress(addrExpression); + } + + /** + * Gets the current address the field evaluates to or null if the text does not evaluate to + * a valid, unique address. + * @return the current address the field evalutes to or null if the text does not evalute to + * a valid unique address. + */ + public Address getAddress() { + try { + return getAddressWithExceptions(); + } + catch (ExpressionException e) { return null; } } /** - * Returns the address space selected in the combobox or in the input text itself - * if specified (eg: "register:1"). If the address space is not specified; returns the - * default space. + * Returns the address space selected in the combobox the default address space if the + * comboBox is not being shown. * - * @throws NullPointerException if AddressFactory has not been set. + * @return the selected address space, or the default address space if no combo added, or + * null if no program is set. */ public AddressSpace getAddressSpace() { - if (comboAdded) { - return (AddressSpace) combo.getSelectedItem(); - } - return addrFactory.getDefaultAddressSpace(); + return addressSpaceField.getAddressSpace(); } /** * Returns true if the Address input field contains text. * The getAddress() method will return null if text is not * a valid address. + * @return true if the address field is not blank */ public boolean hasInput() { - return textField.getText().length() != 0; + return !textField.getText().isBlank(); } /** @@ -167,96 +255,48 @@ public class AddressInput extends JPanel implements FocusableEditor { * @return the text in this field */ public String getText() { - return textField.getText(); - } - - public AddressFactory getAddressFactory() { - return addrFactory; + return textField.getText().trim(); } /** - * Address Space predicate which includes all loaded memory spaces. - * See {@link AddressSpace#isLoadedMemorySpace()}. - * Intended for use with {@link #setAddressFactory(AddressFactory, Predicate)}. - */ - public final static Predicate INCLUDE_LOADED_MEMORY_SPACES = (s) -> { - return s.isLoadedMemorySpace(); - }; - - /** - * Address Space predicate which includes all memory spaces, including the - * {@link AddressSpace#OTHER_SPACE} and all overlay spaces. - * Intended for use with {@link #setAddressFactory(AddressFactory, Predicate)}. - */ - public final static Predicate INCLUDE_ALL_MEMORY_SPACES = (s) -> { - return s.isMemorySpace(); - }; - - /** - * Set the address factory to be used to parse addresses. Also - * used to set the combo box with the list of valid address spaces - * if there is more than one space. Only loaded memory spaces + * Set the program to be used to parse addresses and expressions and also + * to determine the list of valid address spaces. Only loaded memory spaces * will be allowed (see {@link AddressSpace#isLoadedMemorySpace()}). - * @param factory address factory to use + * @param program the program to use to resolve address expressions + */ + public void setProgram(Program program) { + addressEvaluator = new AddressEvaluator(program, assumeHex); + updateAddressSpaceCombo(); + } + + /** + * Sets the program and the address space filter at the same time. This avoid some weird + * intermediate results if the are set separately. + * @param program the program to use to parse addresses and expressions. + * @param addessSpaceFilter the predicate to determine which address spaces are user selectable + */ + public void setProgram(Program program, Predicate addessSpaceFilter) { + this.addressSpaceFilter = addessSpaceFilter; + setProgram(program); + } + + /** + * Legacy method for setting the address factory to be used to parse address. Should only be + * used when a program is not readily available. + * @param factory the address factory to be used to parse addresses. */ public void setAddressFactory(AddressFactory factory) { - setAddressFactory(factory, INCLUDE_LOADED_MEMORY_SPACES); + addressEvaluator = new AddressEvaluator(factory, assumeHex); + updateAddressSpaceCombo(); } /** - * Set the address factory to be used to parse addresses. Also used to set the combo box - * with the list of valid address spaces if there is more than one space. The specified - * predicate will be used to determine if an address space should be included. - * @param factory address factory to use - * @param predicate callback used to determine if an address space should be included for selection + * Sets a consumer to be notified when the address input field changes, but can't be parsed + * into a valid address. + * @param addressErrorConsumer the consumer to be notified for bad address input */ - public void setAddressFactory(AddressFactory factory, Predicate predicate) { - this.addrFactory = factory; - AddressSpace[] spaces = factory.getAddressSpaces(); - - Arrays.sort(spaces, ADDRESS_SPACE_SORT_COMPARATOR); - DefaultComboBoxModel model = new DefaultComboBoxModel<>(); - combo.setModel(model); - - FontMetrics fm = combo.getFontMetrics(combo.getFont()); - int width = 0; - for (AddressSpace space : spaces) { - if (!predicate.test(space)) { - continue; - } - String s = space.toString(); - width = Math.max(width, fm.stringWidth(s)); - - model.addElement(space); - } - -// // Commented out the following 2 lines since they were causing the Combo to only -// // display "..." in some cases instead of the actual address space name. -// Dimension d = combo.getPreferredSize(); -// combo.setPreferredSize(new Dimension(width + 30, d.height)); - - if (model.getSize() > 1) { - if (!comboAdded) { - add(combo, BorderLayout.WEST); - comboAdded = true; - } - } - else if (comboAdded) { - remove(combo); - comboAdded = false; - } - invalidate(); - } - - /** - * Sets the selected combo box item - * to the default address space. - */ - public void selectDefaultAddressSpace() { - if (addrFactory != null) { - AddressSpace space = addrFactory.getDefaultAddressSpace(); - combo.setSelectedItem(space); - } + public void setAddressErrorConsumer(Consumer addressErrorConsumer) { + this.addressErrorConsumer = addressErrorConsumer; } /** @@ -273,32 +313,15 @@ public class AddressInput extends JPanel implements FocusableEditor { textField.selectAll(); } - /** - * Get the offset part of the address field. - * @return String - */ - public String getValue() { - return textField.getText(); - } - - /** - * Set the offset part of the address offset field without changing address space. - * NOTE: This method is intended for test use only and mimicks user input. - * @param value the offset value string - */ - public void setValue(String value) { - textField.setText(value); - } - /** * Set the address space and offset. * NOTE: Unlike {@link #setAddress(Address)} this method is intended for test use only - * and mimicks user input with {@link #stateChanged()} notification. + * and mimics user input with address changed notification * @param addr the address value */ - public void setValue(Address addr) { + public void simulateAddressChanged(Address addr) { setAddress(addr); - stateChanged(); + notifyAddressChanged(); } @Override @@ -318,27 +341,7 @@ public class AddressInput extends JPanel implements FocusableEditor { * @param state false means that the combo box should not be editable */ public void setAddressSpaceEditable(boolean state) { - if (!state && comboAdded) { - AddressSpace selectedSpace = (AddressSpace) combo.getSelectedItem(); - String spaceName = selectedSpace != null ? selectedSpace.getName() + ":" : " "; - spaceField = new JTextField(spaceName); - - spaceField.setEnabled(false); - remove(combo); - add(spaceField, BorderLayout.WEST); - if (textField.getText().length() == 0) { - updateSpaceField = true; - } - } - } - - /** - * Adds a change listener that will be notified anytime this address value - * in this panel changes - * @param listener the change listener to be notified. - */ - public void addChangeListener(ChangeListener listener) { - changeListener = listener; + addressSpaceField.setEditable(state); } /** @@ -352,20 +355,17 @@ public class AddressInput extends JPanel implements FocusableEditor { /** * Removes the action listener from the list to be notified. - * @param listener + * @param listener the listener to be removed */ public void removeActionListener(ActionListener listener) { this.textField.removeActionListener(listener); } - /** - * @see java.awt.Component#setEnabled(boolean) - */ @Override public void setEnabled(boolean enabled) { super.setEnabled(enabled); textField.setEnabled(enabled); - combo.setEnabled(enabled); + addressSpaceField.setEnabled(enabled); } /** @@ -377,59 +377,204 @@ public class AddressInput extends JPanel implements FocusableEditor { } /** - * Set the text field to be editable according to the state param. + * Set the text field to be editable or not. + * @param b true if the address input field can be edited */ - public void setEditable(boolean state) { - textField.setEditable(state); + public void setEditable(boolean b) { + textField.setEditable(b); + addressSpaceField.setEditable(b); } + /** + * Returns true if the address input field is editable. + * @return true if the address input field is editable. + */ public boolean isEditable() { return textField.isEditable(); } @Override public void focusEditor() { - if (comboAdded) { - combo.requestFocusInWindow(); + if (addressSpaceField.getSpaceCount() > 1 && addressSpaceField.isEnabled()) { + addressSpaceField.requestFocusInWindow(); } else { textField.requestFocusInWindow(); } } - private void stateChanged() { - if (changeListener != null && !updatingAddress && !stateChanging) { - stateChanging = true; - changeListener.stateChanged(null); - stateChanging = false; - } - } - - public void showAddressSpaceCombo(boolean showCombo) { - if (showCombo) { - if (!comboAdded) { - add(combo, BorderLayout.WEST); - comboAdded = true; - } - } - else if (comboAdded) { - remove(combo); - comboAdded = false; - } - revalidate(); - } - @Override public void requestFocus() { textField.requestFocus(); } - protected JTextField getAddressTextField() { - return textField; + private void buildComponent() { + setLayout(new BorderLayout()); + textField = new HexDecimalModeTextField(10, b -> hexModeChanged(b)); + textField.setHexMode(true); + textField.setName("JTextField");//for JUnits... + addressSpaceField = new AddressSpaceField(); + add(textField, BorderLayout.CENTER); + comboAdded = false; + + textField.getDocument().addDocumentListener(new DocumentListener() { + @Override + public void insertUpdate(DocumentEvent e) { + notifyAddressChanged(); + } + + @Override + public void removeUpdate(DocumentEvent e) { + notifyAddressChanged(); + } + + @Override + public void changedUpdate(DocumentEvent e) { + notifyAddressChanged(); + } + }); + } - protected JTextField getAddressSpaceTextField() { - return spaceField; + private void hexModeChanged(boolean hexMode) { + this.assumeHex = hexMode; + addressEvaluator.setAssumeHex(hexMode); + notifyAddressChanged(); } + private String removeLeadingZeros(String addressString) { + // if it has a colon, then is is a segmented address, don't mess with it. + if (addressString.indexOf(":") >= 0) { + return addressString; + } + for (int i = 0; i < addressString.length(); i++) { + if (addressString.charAt(i) != '0') { + return addressString.substring(i); + } + } + return "0"; + } + + private void updateAddressSpaceCombo() { + notificationsEnabled = false; + try { + addressSpaceField.updateAddressSpaces(addressEvaluator.getAddressFactory()); + } + finally { + notificationsEnabled = true; + } + addRemoveAdressSpaceField(); + } + + private void addRemoveAdressSpaceField() { + remove(addressSpaceField); + if (addressSpaceField.getSpaceCount() > 1) { + add(addressSpaceField, BorderLayout.WEST); + } + revalidate(); + } + + private void notifyAddressChanged() { + if (notificationsEnabled) { + try { + Address address = getAddressWithExceptions(); + addressChangedConsumer.accept(address); + } + catch (ExpressionException e) { + addressChangedConsumer.accept(null); + addressErrorConsumer.accept(e.getMessage()); + } + } + } + + private class AddressSpaceField extends JPanel { + private JComboBox combo; + private JTextField uneditableSpaceField; + private CardLayout layout; + private boolean editable = true; + + private AddressSpaceField() { + layout = new CardLayout(); + setLayout(layout); + + combo = new GComboBox<>(); + combo.setName("JComboBox");//for JUnits... + combo.getAccessibleContext().setAccessibleName("Address Space"); + combo.addActionListener(ev -> addressSpaceChanged()); + add(combo, "combo"); + + uneditableSpaceField = new JTextField(""); + uneditableSpaceField.setEnabled(false); + add(uneditableSpaceField, "text"); + } + + private void addressSpaceChanged() { + AddressSpace space = (AddressSpace) combo.getSelectedItem(); + addressEvaluator.setPreferredAddressSpace(space); + notifyAddressChanged(); + } + + private void setEditable(boolean state) { + this.editable = state; + updateLayout(); + } + + private void updateLayout() { + boolean showCombo = isEnabled() && editable; + layout.show(this, showCombo ? "combo" : "text"); + } + + @Override + public void setEnabled(boolean enabled) { + super.setEnabled(enabled); + updateLayout(); + } + + private int getSpaceCount() { + return combo.getModel().getSize(); + } + + private void updateAddressSpaces(AddressFactory addressFactory) { + ComboBoxModel model = createAddressSpaceModel(addressFactory); + combo.setModel(model); + AddressSpace defaultAddressSpace = addressFactory.getDefaultAddressSpace(); + if (addressSpaceFilter.test(defaultAddressSpace)) { + setAddressSpace(defaultAddressSpace); + } + else { + setAddressSpace(model.getElementAt(0)); + } + } + + private AddressSpace getAddressSpace() { + return (AddressSpace) combo.getSelectedItem(); + } + + private void setAddressSpace(AddressSpace addressSpace) { + combo.setSelectedItem(addressSpace); + String name = addressSpace.getName(); + uneditableSpaceField.setText(name); + invalidate(); + } + + private void setComponentsBorder(Border border) { + combo.setBorder(border); + uneditableSpaceField.setBorder(border); + } + + private ComboBoxModel createAddressSpaceModel(AddressFactory factory) { + AddressSpace[] spaces = factory.getAddressSpaces(); + + Arrays.sort(spaces, ADDRESS_SPACE_SORT_COMPARATOR); + DefaultComboBoxModel model = new DefaultComboBoxModel<>(); + + for (AddressSpace space : spaces) { + if (!addressSpaceFilter.test(space)) { + continue; + } + model.addElement(space); + } + return model; + } + } } diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/util/AddressSetEditorPanel.java b/Ghidra/Features/Base/src/main/java/ghidra/app/util/AddressSetEditorPanel.java index d1762da48d..c2d93997b1 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/util/AddressSetEditorPanel.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/util/AddressSetEditorPanel.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -67,10 +67,7 @@ public class AddressSetEditorPanel extends JPanel { JLabel minLabel = new GDLabel("Min:"); minLabel.setToolTipText("Enter minimum address to add or remove"); minAddressPanel.add(minLabel, BorderLayout.WEST); - minAddressField = new AddressInput(); - minAddressField.setAddressFactory(addressFactory); - ChangeListener listener = e -> validateAddRemoveButton(); - minAddressField.addChangeListener(listener); + minAddressField = new AddressInput(addressFactory, a -> validateAddRemoveButton()); minAddressPanel.add(minAddressField, BorderLayout.CENTER); JPanel maxAddressPanel = new JPanel(); @@ -78,9 +75,7 @@ public class AddressSetEditorPanel extends JPanel { JLabel maxLabel = new GDLabel("Max:"); maxLabel.setToolTipText("Enter maximum address to add or remove"); maxAddressPanel.add(maxLabel, BorderLayout.WEST); - maxAddressField = new AddressInput(); - maxAddressField.setAddressFactory(addressFactory); - maxAddressField.addChangeListener(listener); + maxAddressField = new AddressInput(addressFactory, a -> validateAddRemoveButton()); maxAddressPanel.add(maxAddressField, BorderLayout.CENTER); maxAddressPanel.setBorder(BorderFactory.createEmptyBorder(0, 10, 0, 0)); addRangeButton = new GButton(ADD_ICON); diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/util/OptionsEditorPanel.java b/Ghidra/Features/Base/src/main/java/ghidra/app/util/OptionsEditorPanel.java index 4e7fc8cb7a..d9e3038a53 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/util/OptionsEditorPanel.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/util/OptionsEditorPanel.java @@ -338,7 +338,7 @@ public class OptionsEditorPanel extends JPanel { return null; } AddressFactory addressFactory = addressFactoryService.getAddressFactory(); - AddressInput addressInput = new AddressInput(); + AddressInput addressInput = new AddressInput(a -> option.setValue(a)); addressInput.setName(option.getName()); Address addr = (Address) option.getValue(); if (addr == null && addressFactory != null) { @@ -347,7 +347,6 @@ public class OptionsEditorPanel extends JPanel { } addressInput.setAddressFactory(addressFactory); addressInput.setAddress(addr); - addressInput.addChangeListener(e -> option.setValue(addressInput.getAddress()));// addressInput.addActionListener(e -> option.setValue(addressInput.getAddress())); return addressInput; } } diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/util/cparser/CPP/DefineTable.java b/Ghidra/Features/Base/src/main/java/ghidra/app/util/cparser/CPP/DefineTable.java index 3ddf1be9c7..26651775cc 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/util/cparser/CPP/DefineTable.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/util/cparser/CPP/DefineTable.java @@ -5,9 +5,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -18,9 +18,9 @@ package ghidra.app.util.cparser.CPP; import java.util.*; +import generic.expressions.ExpressionEvaluator; import ghidra.app.util.cparser.CPP.PreProcessor.PPToken; import ghidra.program.model.data.*; -import ghidra.program.util.AddressEvaluator; import ghidra.util.Msg; /** @@ -281,14 +281,13 @@ public class DefineTable { StringBuffer buf = new StringBuffer(image); int lastReplPos = pos; - + boolean initialListSupplied = initialList != null; // initial list passed in ArrayList sublist = new ArrayList(); if (initialList != null) { sublist.addAll(initialList); } - // don't replace an infinite number of times. Fail safe for possible ininite loop while (pos < buf.length() && replaceCount < ARBITRARY_MAX_REPLACEMENTS) { // clear list of used macros when move past replacement area @@ -353,7 +352,8 @@ public class DefineTable { return true; } - int replace(StringBuffer buf, String currKey, int fromIndex, ArrayList sublist, boolean initialList) { + int replace(StringBuffer buf, String currKey, int fromIndex, ArrayList sublist, + boolean initialList) { String replacementString = null; if (sublist == null) { @@ -451,11 +451,11 @@ public class DefineTable { argValue + " args processed : " + argsfound); return replString; } - + // Handle "..." varargs // if last argument is ellipsis, then is varargs, replace the rest of the params String curArgName = argv.elementAt(index).image; - if (index == argv.size()-1 && VARARG_ELLIPSIS.equals(curArgName)) { + if (index == argv.size() - 1 && VARARG_ELLIPSIS.equals(curArgName)) { isVarArg = true; // Replace __VA_ARGS__ with the rest of params curArgName = "__VA_ARGS__"; @@ -526,14 +526,14 @@ public class DefineTable { startpos = end; } buf.append(substString.substring(startpos)); - + // Handle __VA_OPT__() // if varargs and no more params, replace with "" // if varargs and has vararg params, replace with if (isVarArg) { replace_VaOpt(buf, hadVarArgs); } - + substString = buf.toString(); return substString; } @@ -544,28 +544,29 @@ public class DefineTable { * @param buf string buffer to replace __VA_OPT__(value) within * @param hadVarArgs */ - private void replace_VaOpt(StringBuffer buf, boolean hadVarArgs) { + private void replace_VaOpt(StringBuffer buf, boolean hadVarArgs) { int optIdx = buf.indexOf("__VA_OPT__"); if (optIdx < 0) { return; } - - int lparen = buf.indexOf("(", optIdx+1); + + int lparen = buf.indexOf("(", optIdx + 1); if (lparen < 0) { return; } - - int rparen = buf.indexOf(")",lparen+1); + + int rparen = buf.indexOf(")", lparen + 1); if (rparen < 0) { return; } - + // get in between string. - String replarg = buf.substring(lparen+1, rparen); + String replarg = buf.substring(lparen + 1, rparen); if (hadVarArgs) { - buf.replace(optIdx, rparen+1, replarg); - } else { - buf.replace(optIdx, rparen+1, ""); + buf.replace(optIdx, rparen + 1, replarg); + } + else { + buf.replace(optIdx, rparen + 1, ""); } } @@ -629,7 +630,7 @@ public class DefineTable { public String expand(String image, boolean join) { return expand(image, join, null); } - + /** * do the final expansion of "##" concats in the define strings that protect normal macro substitution. * @@ -639,7 +640,7 @@ public class DefineTable { * @return */ public String expand(String image, boolean join, ArrayList list) { - + image = macroSub(image, 0, list); // get rid of ## constructs @@ -705,13 +706,13 @@ public class DefineTable { Iterator iter = getDefineNames(); while (iter.hasNext()) { String defName = iter.next(); - + String strValue = expandDefine(defName); if (strValue == null) { // couldn't expand, must have been a macro continue; } - + // strip off any casting/parentheses strValue = stripCast(strValue); @@ -720,7 +721,7 @@ public class DefineTable { if (lvalue == null) { try { - lvalue = AddressEvaluator.evaluateToLong(strValue); + lvalue = ExpressionEvaluator.evaluateToLong(strValue); } catch (Exception exc) { // ignore didn't parse well @@ -738,7 +739,8 @@ public class DefineTable { dtMgr.endTransaction(transactionID, true); } - public void populateDefineEquate(DataTypeManager openDTMgrs[], DataTypeManager dtMgr, String category, String prefix, String defName, long value) { + public void populateDefineEquate(DataTypeManager openDTMgrs[], DataTypeManager dtMgr, + String category, String prefix, String defName, long value) { String enumName = prefix + defName; // Start the Enum at 8, then resize to fit the value @@ -751,33 +753,33 @@ public class DefineTable { CategoryPath path = getCategory(currentCategoryName); path = new CategoryPath(path, category); enuum.setCategoryPath(path); - + DataType dt = resolveDataType(openDTMgrs, path, enuum); dtMgr.addDataType(dt, DataTypeConflictHandler.DEFAULT_HANDLER); } - - private DataType resolveDataType(DataTypeManager openDTMgrs[], CategoryPath path, DataType dt) { - if (openDTMgrs == null) { - return dt; - } - // If the exact data type exists in any open DTMgr, use the open DTmgr type - // instead - for (int i = 0; i < openDTMgrs.length; i++) { - // look for the data type by name - // equivalent, return it - // look for the data type by category - // equivalent, return it - DataType candidateDT = openDTMgrs[i].getDataType(dt.getCategoryPath(), dt.getName()); - - if (candidateDT != null && candidateDT.isEquivalent(candidateDT)) { - return candidateDT; - } - } + private DataType resolveDataType(DataTypeManager openDTMgrs[], CategoryPath path, DataType dt) { + if (openDTMgrs == null) { + return dt; + } + // If the exact data type exists in any open DTMgr, use the open DTmgr type + // instead - return dt; - } + for (int i = 0; i < openDTMgrs.length; i++) { + // look for the data type by name + // equivalent, return it + // look for the data type by category + // equivalent, return it + DataType candidateDT = openDTMgrs[i].getDataType(dt.getCategoryPath(), dt.getName()); + + if (candidateDT != null && candidateDT.isEquivalent(candidateDT)) { + return candidateDT; + } + } + + return dt; + } public String expandDefine(String defName) { // don't worry about macros @@ -789,13 +791,13 @@ public class DefineTable { // check if this is a numeric expression that could be simplified // String strValue = getValue(defName); - + ArrayList list = new ArrayList(); list.add(defName); - + String strExpanded = expand(strValue, true, list); strValue = strExpanded; - + return strValue; } diff --git a/Ghidra/Features/Base/src/main/java/ghidra/app/util/dialog/AskAddrDialog.java b/Ghidra/Features/Base/src/main/java/ghidra/app/util/dialog/AskAddrDialog.java index c6361928f8..24c4ef54fe 100644 --- a/Ghidra/Features/Base/src/main/java/ghidra/app/util/dialog/AskAddrDialog.java +++ b/Ghidra/Features/Base/src/main/java/ghidra/app/util/dialog/AskAddrDialog.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -25,19 +25,17 @@ import docking.DockingWindowManager; import docking.widgets.label.GLabel; import ghidra.app.util.AddressInput; import ghidra.program.model.address.Address; -import ghidra.program.model.address.AddressFactory; +import ghidra.program.model.listing.Program; public class AskAddrDialog extends DialogComponentProvider { private boolean isCanceled; private AddressInput addrInput; - public AskAddrDialog(final String title, final String message, AddressFactory af, + public AskAddrDialog(final String title, final String message, Program program, Address lastAddr) { super(title, true, true, true, false); - addrInput = new AddressInput(); - addrInput.setAddressFactory(af); - addrInput.selectDefaultAddressSpace(); + addrInput = new AddressInput(program); if (lastAddr != null) { addrInput.setAddress(lastAddr); } diff --git a/Ghidra/Features/Base/src/test.slow/java/ghidra/app/plugin/core/memory/MemoryMapProvider2Test.java b/Ghidra/Features/Base/src/test.slow/java/ghidra/app/plugin/core/memory/MemoryMapProvider2Test.java index 88bf1372ad..1ef9c9b33d 100644 --- a/Ghidra/Features/Base/src/test.slow/java/ghidra/app/plugin/core/memory/MemoryMapProvider2Test.java +++ b/Ghidra/Features/Base/src/test.slow/java/ghidra/app/plugin/core/memory/MemoryMapProvider2Test.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -251,7 +251,7 @@ public class MemoryMapProvider2Test extends AbstractGhidraHeadedIntegrationTest JButton okButton = findButton(d.getComponent(), "OK"); runSwing(() -> { - addrField.setValue("0x200"); + addrField.setText("0x200"); nameField.setText(".test"); lengthField.setText("0x100"); commentField.setText("this is a block test"); @@ -319,7 +319,7 @@ public class MemoryMapProvider2Test extends AbstractGhidraHeadedIntegrationTest JButton okButton = findButton(d.getComponent(), "OK"); runSwing(() -> { - addrField.setValue("0x01001200"); + addrField.setText("0x01001200"); nameField.setText(".test"); lengthField.setText("0x100"); commentField.setText("this is a block test"); @@ -354,7 +354,7 @@ public class MemoryMapProvider2Test extends AbstractGhidraHeadedIntegrationTest JButton okButton = findButton(d.getComponent(), "OK"); runSwing(() -> { - addrField.setValue("xxxxx"); + addrField.setText("xxxxx"); nameField.setText(".test"); lengthField.setText("0x100"); commentField.setText("this is a block test"); @@ -364,7 +364,7 @@ public class MemoryMapProvider2Test extends AbstractGhidraHeadedIntegrationTest assertFalse(okButton.isEnabled()); String msg = findLabelStr(d.getComponent(), "statusLabel"); - assertEquals("Please enter a valid Start Address", msg); + assertEquals("Invalid Address: Could not evaluate token \"xxxxx\"", msg); assertFalse(okButton.isEnabled()); close(d); } @@ -768,7 +768,7 @@ public class MemoryMapProvider2Test extends AbstractGhidraHeadedIntegrationTest assertFalse(okButton.isEnabled()); String msg = findLabelStr(d.getComponent(), "statusLabel"); assertEquals("Please enter a source address for the bit block", msg); - runSwing(() -> addrField.setValue("01001000")); + runSwing(() -> addrField.setText("01001000")); } else { assertTrue(okButton.isEnabled()); @@ -844,7 +844,7 @@ public class MemoryMapProvider2Test extends AbstractGhidraHeadedIntegrationTest assertFalse(okButton.isEnabled()); String msg = findLabelStr(d.getComponent(), "statusLabel"); assertEquals("Please enter a source address for the bit block", msg); - runSwing(() -> addrField.setValue("01001000")); + runSwing(() -> addrField.setText("01001000")); } else { assertTrue(okButton.isEnabled()); @@ -1040,7 +1040,7 @@ public class MemoryMapProvider2Test extends AbstractGhidraHeadedIntegrationTest // move the block to 0x300 Address newStart = startAddr.getAddressSpace().getAddressInThisSpaceOnly(0x300); Address newEnd = startAddr.getAddressSpace().getAddressInThisSpaceOnly(0x3ff); - runSwing(() -> startField.setValue(newStart)); + runSwing(() -> startField.simulateAddressChanged(newStart)); assertEquals(newEnd, endField.getAddress()); assertTrue(okButton.isEnabled()); @@ -1110,7 +1110,7 @@ public class MemoryMapProvider2Test extends AbstractGhidraHeadedIntegrationTest assertFalse(okButton.isEnabled()); // enter an invalid address - runSwing(() -> startField.setValue(getAddr(0x0300).toString() + "gggg")); + runSwing(() -> startField.setText(getAddr(0x0300).toString() + "gggg")); assertFalse(okButton.isEnabled()); String msg = findLabelStr(d.getComponent(), "statusLabel"); assertEquals("Invalid Address", msg); @@ -1168,7 +1168,7 @@ public class MemoryMapProvider2Test extends AbstractGhidraHeadedIntegrationTest assertFalse(okButton.isEnabled()); // enter an invalid address - runSwing(() -> endField.setValue(getAddr(0x0300).toString() + "gggg")); + runSwing(() -> endField.setText(getAddr(0x0300).toString() + "gggg")); assertFalse(okButton.isEnabled()); String msg = findLabelStr(d.getComponent(), "statusLabel"); assertEquals("Invalid Address", msg); @@ -1227,8 +1227,8 @@ public class MemoryMapProvider2Test extends AbstractGhidraHeadedIntegrationTest // enter an invalid address runSwing(() -> { - startField.setValue(getAddr(0x1000).toString()); - endField.setValue(getAddr(0x10).toString()); + startField.setText(getAddr(0x1000).toString()); + endField.setText(getAddr(0x10).toString()); }); assertFalse(okButton.isEnabled()); String msg = findLabelStr(d.getComponent(), "statusLabel"); @@ -1287,7 +1287,7 @@ public class MemoryMapProvider2Test extends AbstractGhidraHeadedIntegrationTest assertFalse(okButton.isEnabled()); // enter an invalid address - runSwing(() -> startField.setValue("00000000")); + runSwing(() -> startField.setText("00000000")); assertFalse(okButton.isEnabled()); String msg = findLabelStr(d.getComponent(), "statusLabel"); assertEquals("Block is already at 00000000", msg); diff --git a/Ghidra/Features/Base/src/test.slow/java/ghidra/app/plugin/core/memory/MemoryMapProvider3Test.java b/Ghidra/Features/Base/src/test.slow/java/ghidra/app/plugin/core/memory/MemoryMapProvider3Test.java index 1b6c087164..cae5725385 100644 --- a/Ghidra/Features/Base/src/test.slow/java/ghidra/app/plugin/core/memory/MemoryMapProvider3Test.java +++ b/Ghidra/Features/Base/src/test.slow/java/ghidra/app/plugin/core/memory/MemoryMapProvider3Test.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -231,7 +231,7 @@ public class MemoryMapProvider3Test extends AbstractGhidraHeadedIntegrationTest (RegisterField) findComponentByName(d.getComponent(), "BlockTwoLength"); JButton okButton = findButton(d.getComponent(), "OK"); - runSwing(() -> blockOneEnd.setValue("01003000")); + runSwing(() -> blockOneEnd.setText("01003000")); assertEquals(0x2001, blockOneLength.getValue().longValue()); assertEquals(getAddr(0x01003001), blockTwoStart.getAddress()); assertEquals("010075ff", blockTwoEnd.getText()); @@ -277,7 +277,7 @@ public class MemoryMapProvider3Test extends AbstractGhidraHeadedIntegrationTest (RegisterField) findComponentByName(d.getComponent(), "BlockTwoLength"); JButton okButton = findButton(d.getComponent(), "OK"); - runSwing(() -> blockTwoStart.setValue("01003000")); + runSwing(() -> blockTwoStart.setText("01003000")); assertEquals(0x2000, blockOneLength.getValue().longValue()); assertEquals(getAddr(0x01002fff), blockOneEnd.getAddress()); assertEquals("010075ff", blockTwoEnd.getText()); @@ -357,7 +357,7 @@ public class MemoryMapProvider3Test extends AbstractGhidraHeadedIntegrationTest (AddressInput) findComponentByName(d.getComponent(), "BlockOneEnd"); JButton okButton = findButton(d.getComponent(), "OK"); - runSwing(() -> blockOneEnd.setValue("01000")); + runSwing(() -> blockOneEnd.setText("01000")); assertFalse(okButton.isEnabled()); assertEquals("End address must be greater than start", findLabelStr(d.getComponent(), "statusLabel")); @@ -378,7 +378,7 @@ public class MemoryMapProvider3Test extends AbstractGhidraHeadedIntegrationTest (AddressInput) findComponentByName(d.getComponent(), "BlockTwoStart"); JButton okButton = findButton(d.getComponent(), "OK"); - runSwing(() -> blockTwoStart.setValue("01000")); + runSwing(() -> blockTwoStart.setText("01000")); assertFalse(okButton.isEnabled()); assertEquals("Start address must be greater than original block start (01001000)", findLabelStr(d.getComponent(), "statusLabel")); @@ -531,7 +531,7 @@ public class MemoryMapProvider3Test extends AbstractGhidraHeadedIntegrationTest RegisterField length = (RegisterField) findComponentByName(d.getComponent(), "BlockLength"); JButton okButton = findButton(d.getComponent(), "OK"); - runSwing(() -> start.setValue("00002000")); + runSwing(() -> start.setText("00002000")); assertEquals("0x1005600", length.getText()); assertTrue(okButton.isEnabled()); @@ -579,7 +579,7 @@ public class MemoryMapProvider3Test extends AbstractGhidraHeadedIntegrationTest assertNotNull(length); JButton okButton = findButton(d.getComponent(), "OK"); - runSwing(() -> start.setValue("01201000")); + runSwing(() -> start.setText("01201000")); assertFalse(okButton.isEnabled()); assertEquals("Start must be less than 01001000", findLabelStr(d.getComponent(), "statusLabel")); @@ -681,7 +681,7 @@ public class MemoryMapProvider3Test extends AbstractGhidraHeadedIntegrationTest JTextField end = (JTextField) findComponentByName(d.getComponent(), "EndAddress"); JButton okButton = findButton(d.getComponent(), "OK"); - runSwing(() -> start.setValue("01008000")); + runSwing(() -> start.setText("01008000")); assertEquals("0100f3ff", end.getText()); assertTrue(okButton.isEnabled()); @@ -740,7 +740,7 @@ public class MemoryMapProvider3Test extends AbstractGhidraHeadedIntegrationTest RegisterField length = (RegisterField) findComponentByName(d.getComponent(), "BlockLength"); JButton okButton = findButton(d.getComponent(), "OK"); - runSwing(() -> end.setValue("01007700")); + runSwing(() -> end.setText("01007700")); assertEquals("0x6701", length.getText()); assertTrue(okButton.isEnabled()); @@ -798,7 +798,7 @@ public class MemoryMapProvider3Test extends AbstractGhidraHeadedIntegrationTest AddressInput end = (AddressInput) findComponentByName(d.getComponent(), "EndAddress"); JButton okButton = findButton(d.getComponent(), "OK"); - runSwing(() -> end.setValue("01007000")); + runSwing(() -> end.setText("01007000")); assertFalse(okButton.isEnabled()); assertEquals("End must be greater than 010075ff", findLabelStr(d.getComponent(), "statusLabel")); diff --git a/Ghidra/Features/Base/src/test.slow/java/ghidra/app/util/AddressInputTest.java b/Ghidra/Features/Base/src/test.slow/java/ghidra/app/util/AddressInputTest.java new file mode 100644 index 0000000000..b8bc8442c0 --- /dev/null +++ b/Ghidra/Features/Base/src/test.slow/java/ghidra/app/util/AddressInputTest.java @@ -0,0 +1,219 @@ +/* ### + * IP: GHIDRA + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package ghidra.app.util; + +import static org.junit.Assert.*; + +import java.util.function.Predicate; + +import javax.swing.JFrame; + +import org.junit.*; + +import ghidra.program.database.*; +import ghidra.program.model.address.*; +import ghidra.program.model.listing.Program; +import ghidra.test.AbstractGhidraHeadedIntegrationTest; + +public class AddressInputTest extends AbstractGhidraHeadedIntegrationTest { + + private JFrame frame; + private AddressInput field; + private ProgramDB programOneSpace; + private ProgramDB programMultiSpaces; + private volatile Address changedAddress; + private volatile String errorMessage; + + @Before + public void setUp() throws Exception { + programOneSpace = createDefaultProgram("oneSpace", ProgramBuilder._TOY, this); + programMultiSpaces = createDefaultProgram("mulitSpaces", ProgramBuilder._8051, this); + field = new AddressInput(programOneSpace, this::addressChanged); + field.setAddressErrorConsumer(this::addressError); + frame = new JFrame("Test"); + frame.getContentPane().add(field); + frame.pack(); + frame.setVisible(true); + } + + @After + public void tearDown() throws Exception { + frame.setVisible(false); + programOneSpace.release(this); + programMultiSpaces.release(this); + } + + @Test + public void testDefaultState() { + assertTrue(getText().isBlank()); + assertNull(getAddress()); + } + + @Test + public void testHexOrDecimalMode() { + setText("100"); // should have defaulted to hex mode + assertEquals(addr(0x100), getAddress()); + + setHexMode(false); + assertEquals(addr(100), field.getAddress()); + + setHexMode(true); + assertEquals(addr(0x100), field.getAddress()); + } + + @Test + public void testSwitchingBetweenOneAndMultiSpaces() { + assertEquals(1, field.getComponentCount()); + setProgram(programMultiSpaces); + assertEquals(2, field.getComponentCount()); + setProgram(programOneSpace); + assertEquals(1, field.getComponentCount()); + } + + @Test + public void testSetAddress() { + setAddress(addr(0x100)); + assertEquals("100", getText()); + setHexMode(false); + setAddress(addr(0x100)); + assertEquals("0x100", getText()); + } + + @Test + public void testSettingAddressChangesResultingSpace() { + setProgram(programMultiSpaces); + setText("100"); + Address a = getAddress(); + assertEquals("CODE:0100", a.toString(true)); + Address newAddress = addr(programMultiSpaces, "EXTMEM", 0x20); + setAddress(newAddress); + setText("100"); + a = getAddress(); + assertEquals("EXTMEM:0100", a.toString(true)); + } + + @Test + public void testGetAddressWithBadExpression() { + setText("100+ ("); + assertNull(getAddress()); + } + + @Test + public void testWorksWithJustAddressFactory() { + setAddressFactory(programMultiSpaces.getAddressFactory()); + setText("100"); + assertEquals(addr(programMultiSpaces, 0x100), getAddress()); + } + + @Test + public void testGetSelectedAddressSpace() { + setProgram(programMultiSpaces); + ProgramAddressFactory factory = programMultiSpaces.getAddressFactory(); + AddressSpace codeSpace = factory.getAddressSpace("CODE"); + AddressSpace extmemSpace = factory.getAddressSpace("EXTMEM"); + + assertEquals(codeSpace, getAddressSpaceInField()); + setAddress(addr(programMultiSpaces, "EXTMEM", 100)); + assertEquals(extmemSpace, getAddressSpaceInField()); + } + + @Test + public void testSpaceFilter() { + setProgram(programMultiSpaces); + setSpaceFilter(s -> s.getName().equals("EXTMEM")); + assertEquals(1, field.getComponentCount()); + setText("100"); + assertEquals(addr(programMultiSpaces, "EXTMEM", 0x100), getAddress()); + } + + @Test + public void testAddressChangeConsumer() { + setText("200"); + assertEquals(addr(0x200), changedAddress); + setText("300"); + assertEquals(addr(0x300), changedAddress); + setText("lkjlkj"); + assertNull(changedAddress); + } + + @Test + public void testAddressErrorConsmer() { + errorMessage = null; + setText("200"); + assertNull(errorMessage); + + setText("xyz"); + assertEquals("Could not evaluate token \"xyz\"", errorMessage); + } + + private Address addr(long offset) { + return addr(programOneSpace, offset); + } + + private Address addr(ProgramDB p, long offset) { + return p.getAddressFactory().getDefaultAddressSpace().getAddress(offset); + } + + private Address addr(ProgramDB p, String spaceName, long offset) { + AddressSpace space = p.getAddressFactory().getAddressSpace(spaceName); + return space.getAddress(offset); + } + + private void setProgram(Program p) { + runSwing(() -> field.setProgram(p)); + } + + private void setAddressFactory(AddressFactory factory) { + runSwing(() -> field.setAddressFactory(factory)); + } + + private void setSpaceFilter(Predicate filter) { + runSwing(() -> field.setAddressSpaceFilter(filter)); + } + + private void setText(String value) { + runSwing(() -> field.setText(value)); + } + + private String getText() { + return runSwing(() -> field.getText()); + } + + private void setAddress(Address a) { + runSwing(() -> field.setAddress(a)); + } + + private Address getAddress() { + return runSwing(() -> field.getAddress()); + } + + private AddressSpace getAddressSpaceInField() { + return runSwing(() -> field.getAddressSpace()); + } + + private void setHexMode(boolean hexMode) { + runSwing(() -> field.setAssumeHex(hexMode)); + waitForSwing(); + } + + private void addressChanged(Address address) { + this.changedAddress = address; + } + + private void addressError(String errorMessage) { + this.errorMessage = errorMessage; + } +} diff --git a/Ghidra/Features/Base/src/test.slow/java/ghidra/features/base/values/AddressValueTest.java b/Ghidra/Features/Base/src/test.slow/java/ghidra/features/base/values/AddressValueTest.java index 7ad096c428..21fc1c5ba7 100644 --- a/Ghidra/Features/Base/src/test.slow/java/ghidra/features/base/values/AddressValueTest.java +++ b/Ghidra/Features/Base/src/test.slow/java/ghidra/features/base/values/AddressValueTest.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -21,7 +21,6 @@ import org.junit.Test; import docking.widgets.values.AbstractValue; import ghidra.app.util.AddressInput; -import ghidra.features.base.values.AddressValue; import ghidra.program.model.address.Address; import ghidra.program.model.address.AddressFactory; @@ -144,7 +143,7 @@ public class AddressValueTest extends AbstractValueIntegrationTest { protected void setTextOnAddressInput(AbstractValue nameValue, String text) { runSwing(() -> { AddressInput addressInput = (AddressInput) nameValue.getComponent(); - addressInput.setValue(text); + addressInput.setText(text); }); } } diff --git a/Ghidra/Features/Base/src/test.slow/java/ghidra/features/base/values/ValuesMapDialogParseErrorTest.java b/Ghidra/Features/Base/src/test.slow/java/ghidra/features/base/values/ValuesMapDialogParseErrorTest.java index 34325b409b..dfa1fcec4a 100644 --- a/Ghidra/Features/Base/src/test.slow/java/ghidra/features/base/values/ValuesMapDialogParseErrorTest.java +++ b/Ghidra/Features/Base/src/test.slow/java/ghidra/features/base/values/ValuesMapDialogParseErrorTest.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -43,7 +43,7 @@ public class ValuesMapDialogParseErrorTest extends AbstractValueIntegrationTest protected void setTextOnAddressInput(AbstractValue nameValue, String text) { runSwing(() -> { AddressInput addressInput = (AddressInput) nameValue.getComponent(); - addressInput.setValue(text); + addressInput.setText(text); }); } } diff --git a/Ghidra/Features/Base/src/test.slow/java/ghidra/program/util/AddressEvaluatorTest.java b/Ghidra/Features/Base/src/test.slow/java/ghidra/program/util/AddressEvaluatorTest.java index a91bfd4cb6..2f4eba2a59 100644 --- a/Ghidra/Features/Base/src/test.slow/java/ghidra/program/util/AddressEvaluatorTest.java +++ b/Ghidra/Features/Base/src/test.slow/java/ghidra/program/util/AddressEvaluatorTest.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -17,103 +17,146 @@ package ghidra.program.util; import static org.junit.Assert.*; -import org.junit.Test; +import org.junit.*; +import generic.test.AbstractGenericTest; import ghidra.program.database.ProgramBuilder; import ghidra.program.model.address.Address; -import ghidra.program.model.address.AddressFactory; import ghidra.program.model.listing.Program; -import ghidra.program.model.symbol.SourceType; import ghidra.program.model.symbol.Symbol; -import ghidra.test.AbstractGhidraHeadedIntegrationTest; -/** - * - * - * TODO To change the template for this generated type comment go to - * Window - Preferences - Java - Code Style - Code Templates - */ -public class AddressEvaluatorTest extends AbstractGhidraHeadedIntegrationTest { +public class AddressEvaluatorTest extends AbstractGenericTest { - AddressFactory addrFactory; + private Program program; + private ProgramBuilder builder; + private Symbol entry; + private Symbol entryInFoo; public AddressEvaluatorTest() { super(); } - private Address addr(String address) { - return addrFactory.getAddress(address); + @Before + public void setUp() throws Exception { + builder = new ProgramBuilder("Test", ProgramBuilder._TOY_LE, this); + builder.createMemory("TestBlock", "0x100", 100); + program = builder.getProgram(); + entry = builder.createLabel("0x100", "entry"); + builder.createNamespace("foo"); + entryInFoo = builder.createLabel("0x103", "entry", "foo"); + } + + @After + public void tearDown() { + program.release(this); } @Test - public void testEval() throws Exception { - Program p = createDefaultProgram("Test", ProgramBuilder._TOY_LE, this); - addrFactory = p.getAddressFactory(); - int txId = p.startTransaction("Test"); - try { - assertEquals(addr("0x19"), AddressEvaluator.evaluate(p, "(2+3)*5")); - assertEquals(addr("0x11"), AddressEvaluator.evaluate(p, "2+3*5")); - assertEquals(addr("0x11"), AddressEvaluator.evaluate(p, "2+(3*5)")); - assertEquals(addr("0x11"), AddressEvaluator.evaluate(p, "(2+3*5)")); - assertEquals(addr("0x16"), AddressEvaluator.evaluate(p, "0x11+5")); - assertEquals(addr("0x02"), AddressEvaluator.evaluate(p, "2-1+1")); - assertEquals(addr("0x5"), AddressEvaluator.evaluate(p, "5")); - assertEquals(addr("0x3"), AddressEvaluator.evaluate(p, "0-5+8")); - assertEquals(addr("0x3"), AddressEvaluator.evaluate(p, "-5+8")); - assertEquals(addr("0xfffffffB"), AddressEvaluator.evaluate(p, "-5")); - assertEquals(addr("0x11"), AddressEvaluator.evaluate(p, "3+(5+(3*2)+(3))")); - assertEquals(addr("0xff00"), AddressEvaluator.evaluate(p, "0xffff ^ 0xff")); - assertEquals(addr("0x123f"), AddressEvaluator.evaluate(p, "0xffff & 0x123f")); - assertEquals(addr("0x1234"), AddressEvaluator.evaluate(p, "0x1200 | 0x0034")); - assertEquals(addr("0xffffffff"), AddressEvaluator.evaluate(p, "~ 0x0")); - assertEquals(addr("0x1201"), AddressEvaluator.evaluate(p, "0x1200 | ~(0xfffffffe)")); - assertEquals(addr("0x480"), AddressEvaluator.evaluate(p, "0x1200 >> 2")); - assertEquals(addr("0x1200"), AddressEvaluator.evaluate(p, "0x480 << 2")); + public void testLongValueExpression() { + assertEval(addr("0x19"), "(2+3)*5"); + assertEval(addr("0x11"), "2+3*5"); + assertEval(addr("0x11"), "2+(3*5)"); + assertEval(addr("0x3"), "0-5+8"); + assertEval(addr("0x3"), "-5+8"); + assertEval(addr("0xfffffffB"), "-5"); + assertEval(addr("0x11"), "3+(5+(3*2)+(3))"); + } - assertEquals(addr("0x1"), AddressEvaluator.evaluate(p, "(((0x1 | 0x2) & 0x2) == 0x2)")); - assertEquals(addr("0x0"), AddressEvaluator.evaluate(p, "(((0x1 | 0x2) & 0x2) == 0x1)")); - assertEquals(addr("0x0"), AddressEvaluator.evaluate(p, "(((0x1 | 0x2) & 0x2) == 0x1)")); + @Test + public void testAssumesHex() { + assertEval(addr("0x30"), "20 + 10"); + assertEval(addr("0xf1"), "e1+10"); + } - assertEquals(addr("0x1"), AddressEvaluator.evaluate(p, "(((0x1 | 0x2) & 0x2) >= 0x1)")); - assertEquals(addr("0x0"), AddressEvaluator.evaluate(p, "(((0x1 | 0x2) & 0x2) <= 0x1)")); - - assertEquals(addr("0x4"), AddressEvaluator.evaluate(p, "(4ul)")); - assertEquals(addr("0x4"), AddressEvaluator.evaluate(p, "(4UL)")); - assertEquals(addr("0x4"), AddressEvaluator.evaluate(p, "( 4l )")); - assertEquals(addr("0x4"), AddressEvaluator.evaluate(p, "(4L)")); - assertEquals(addr("0x4"), AddressEvaluator.evaluate(p, "(4u )")); - assertEquals(addr("0x4"), AddressEvaluator.evaluate(p, "( 4U)")); - - assertEquals(null, AddressEvaluator.evaluate(p, "( 4P)")); + @Test + public void testAcceptsHexPrefix() { + assertEval(addr("0x16"), "0x11+5"); + assertEval(addr("0x35"), "20+0x15"); + } - Symbol s = p.getSymbolTable().createLabel(addr("0x100"), "entry", SourceType.IMPORTED); - Address a = s.getAddress(); - a = a.add(10); - assertEquals(a, AddressEvaluator.evaluate(p, "entry+5*2")); - assertEquals(addr("0x101"), AddressEvaluator.evaluate(p, "entry + (entry == 0x100)")); - assertEquals(addr("0x500"), AddressEvaluator.evaluate(p, - "entry + (entry == 0x100) * 0x400 + (entry < 0x100) * 0x500")); - assertEquals(addr("0x600"), AddressEvaluator.evaluate(p, - "entry + (entry > 0x100) * 0x400 + (entry <= 0x100) * 0x500")); - } - finally { - p.endTransaction(txId, true); - p.release(this); - } + @Test + public void testBitWiseExpressions() { + + assertEval(addr("0xff00"), "0xffff ^ 0xff"); + assertEval(addr("0x123f"), "0xffff & 0x123f"); + assertEval(addr("0x1234"), "0x1200 | 0x0034"); + assertEval(addr("0xffffffff"), "~ 0x0"); + assertEval(addr("0x1201"), "0x1200 | ~(0xfffffffe)"); + assertEval(addr("0x480"), "0x1200 >> 2"); + assertEval(addr("0x1200"), "0x480 << 2"); + assertEval(addr("0x103"), "0x100 | 0x1 | ~(~0x2)"); + } + + @Test + public void testLogicalExpressions() { + assertEval(addr("0x1"), "(((0x1 | 0x2) & 0x2) == 0x2)"); + assertEval(addr("0x0"), "(((0x1 | 0x2) & 0x2) == 0x1)"); + assertEval(addr("0x0"), "(((0x1 | 0x2) & 0x2) == 0x1)"); + + assertEval(addr("0x1"), "(((0x1 | 0x2) & 0x2) >= 0x1)"); + assertEval(addr("0x0"), "(((0x1 | 0x2) & 0x2) <= 0x1)"); + + } + + @Test + public void testAlternateNumberDecorations() { + assertEval(addr("0x4"), "(4ul)"); + assertEval(addr("0x4"), "(4UL)"); + assertEval(addr("0x4"), "( 4l )"); + assertEval(addr("0x4"), "(4L)"); + assertEval(addr("0x4"), "(4u )"); + assertEval(addr("0x4"), "( 4U)"); + } + + @Test + public void testInvalidInput() { + assertEval(null, "( 4P)"); + } + + @Test + public void testShift() { + assertEval(addr("0x80"), "0x100 >> 1"); + assertEval(addr("0x400"), "0x100 << 2"); + } + + @Test + public void testSymbolLookup() { + assertEval(entry.getAddress(), "entry"); + assertEval(entry.getAddress().add(10), "entry+5*2"); + assertEval(addr("0x101"), "entry + (entry == 0x100)"); + assertEval(addr("0x500"), "entry + (entry == 0x100) * 0x400 + (entry < 0x100) * 0x500"); + assertEval(addr("0x600"), "entry + (entry > 0x100) * 0x400 + (entry <= 0x100) * 0x500"); + } + + @Test + public void testSymbolInNamespaceLookup() { + assertEval(entryInFoo.getAddress(), "foo::entry"); + assertEval(entryInFoo.getAddress().add(10), "foo::entry+5*2"); + assertEval(null, "bar::entry"); + } + + @Test + public void testSymbolShift() { + assertEval(addr("0x80"), "entry >> 1"); + assertEval(addr("0x400"), "entry << 2"); + } + + @Test + public void testMemoryBlockOffset() { + assertEval(addr("0x110"), "TestBlock+10"); } @Test public void testMultiAddrSpace() throws Exception { - Program p = createDefaultProgram("Test", ProgramBuilder._TOY_LE, this); - addrFactory = p.getAddressFactory(); - try { - assertEquals(addr("0x19"), AddressEvaluator.evaluate(p, "(2+3)*5")); - assertEquals(addr("0x11"), AddressEvaluator.evaluate(p, "2+3*5")); - assertEquals(addr("0x11"), AddressEvaluator.evaluate(p, "2+(3*5)")); - assertEquals(addr("RAM:15"), AddressEvaluator.evaluate(p, "RAM:2 + 0x13")); - } - finally { - p.release(this); - } + assertEval(addr("0x15"), "ram:2 + 0x13"); + assertEval(addr("register:0x15"), "register:2 + 0x13"); + } + + private void assertEval(Address addr, String input) { + assertEquals(addr, AddressEvaluator.evaluate(program, input)); + } + + private Address addr(String address) { + return program.getAddressFactory().getAddress(address); } } diff --git a/Ghidra/Features/ByteViewer/src/main/java/ghidra/app/plugin/core/byteviewer/ByteViewerOptionsDialog.java b/Ghidra/Features/ByteViewer/src/main/java/ghidra/app/plugin/core/byteviewer/ByteViewerOptionsDialog.java index 71fd8a2006..5acec1ab73 100644 --- a/Ghidra/Features/ByteViewer/src/main/java/ghidra/app/plugin/core/byteviewer/ByteViewerOptionsDialog.java +++ b/Ghidra/Features/ByteViewer/src/main/java/ghidra/app/plugin/core/byteviewer/ByteViewerOptionsDialog.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -81,12 +81,11 @@ public class ByteViewerOptionsDialog extends DialogComponentProvider if (provider instanceof ProgramByteViewerComponentProvider) { Program program = ((ProgramByteViewerComponentProvider) provider).getProgram(); if (program != null) { - addressInputField = new AddressInput(); - addressInputField.setAddressFactory(program.getAddressFactory()); - addressInputField.showAddressSpaceCombo(false); - addressInputField.setAddress(getAlignmentAddress()); + Address alignment = getAlignmentAddress(); + addressInputField = new AddressInput(program, a -> update()); + addressInputField.setAddressSpaceFilter(s -> s == alignment.getAddressSpace()); + addressInputField.setAddress(alignment); panel.add(addressInputField); - addressInputField.addChangeListener(this); addressInputField.setAccessibleName("Alignment Address"); } } @@ -214,13 +213,13 @@ public class ByteViewerOptionsDialog extends DialogComponentProvider } private boolean hasValidFieldValues() { - if (addressInputField.getValue().length() == 0) { + if (addressInputField.getText().length() == 0) { setStatusText("Enter an alignment address"); return false; } Address alignmentAddress = addressInputField.getAddress(); if (alignmentAddress == null) { - setStatusText("Invalid alignment address:" + addressInputField.getValue()); + setStatusText("Invalid alignment address:" + addressInputField.getText()); return false; } BigInteger bytesPerLine = bytesPerLineField.getValue(); diff --git a/Ghidra/Features/ByteViewer/src/test.slow/java/ghidra/app/plugin/core/byteviewer/ByteViewerPlugin1Test.java b/Ghidra/Features/ByteViewer/src/test.slow/java/ghidra/app/plugin/core/byteviewer/ByteViewerPlugin1Test.java index e5abd211ce..6361c1058d 100644 --- a/Ghidra/Features/ByteViewer/src/test.slow/java/ghidra/app/plugin/core/byteviewer/ByteViewerPlugin1Test.java +++ b/Ghidra/Features/ByteViewer/src/test.slow/java/ghidra/app/plugin/core/byteviewer/ByteViewerPlugin1Test.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -553,7 +553,7 @@ public class ByteViewerPlugin1Test extends AbstractGhidraHeadedIntegrationTest { // current offset is 0 assertEquals(program.getMinAddress(), ai.getAddress()); - runSwing(() -> ai.setValue("0100100b")); + runSwing(() -> ai.setText("0100100b")); pressButtonByText(d.getComponent(), "OK"); // verify that offset label on the plugin shows '5' assertEquals(5, plugin.getProvider().getOffset()); @@ -587,7 +587,7 @@ public class ByteViewerPlugin1Test extends AbstractGhidraHeadedIntegrationTest { // current offset is 0 assertEquals(program.getMinAddress(), ai.getAddress()); - runSwing(() -> ai.setValue("0000:0c06")); + runSwing(() -> ai.setText("0000:0c06")); pressButtonByText(d.getComponent(), "OK"); assertEquals(10, plugin.getProvider().getOffset()); diff --git a/Ghidra/Features/VersionTracking/src/main/java/ghidra/feature/vt/gui/provider/markuptable/EditableListingAddress.java b/Ghidra/Features/VersionTracking/src/main/java/ghidra/feature/vt/gui/provider/markuptable/EditableListingAddress.java index d78b459941..f3c223b31e 100644 --- a/Ghidra/Features/VersionTracking/src/main/java/ghidra/feature/vt/gui/provider/markuptable/EditableListingAddress.java +++ b/Ghidra/Features/VersionTracking/src/main/java/ghidra/feature/vt/gui/provider/markuptable/EditableListingAddress.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -55,8 +55,7 @@ public class EditableListingAddress extends DisplayableListingAddress implements private void buildPanel() { setLayout(new PairLayout(5, 5, 50)); - addressField = new AddressInput(); - addressField.setAddressFactory(program.getAddressFactory()); + addressField = new AddressInput(program); if (address != null) { addressField.setAddress(address); } @@ -78,7 +77,7 @@ public class EditableListingAddress extends DisplayableListingAddress implements Address selectedAddress = addressField.getAddress(); if (selectedAddress == null) { throw new InvalidInputException( - "\"" + addressField.getValue() + "\" is not a valid address."); + "\"" + addressField.getText() + "\" is not a valid address."); } if (!program.getMemory().contains(selectedAddress)) { throw new InvalidInputException( diff --git a/Ghidra/Features/VersionTracking/src/main/java/ghidra/feature/vt/gui/wizard/AddRemoveAddressRangeDialog.java b/Ghidra/Features/VersionTracking/src/main/java/ghidra/feature/vt/gui/wizard/AddRemoveAddressRangeDialog.java index ba05155d14..850b07c517 100644 --- a/Ghidra/Features/VersionTracking/src/main/java/ghidra/feature/vt/gui/wizard/AddRemoveAddressRangeDialog.java +++ b/Ghidra/Features/VersionTracking/src/main/java/ghidra/feature/vt/gui/wizard/AddRemoveAddressRangeDialog.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -24,7 +24,6 @@ import docking.widgets.label.GDLabel; import ghidra.app.util.AddressInput; import ghidra.app.util.HelpTopics; import ghidra.program.model.address.Address; -import ghidra.program.model.address.AddressFactory; import ghidra.program.model.listing.Program; import ghidra.util.HelpLocation; import ghidra.util.layout.PairLayout; @@ -32,7 +31,6 @@ import ghidra.util.layout.PairLayout; public class AddRemoveAddressRangeDialog extends DialogComponentProvider { private Program program; - private AddressFactory addressFactory; private AddressRangeListener listener; private JPanel addressRangePanel; @@ -45,7 +43,6 @@ public class AddRemoveAddressRangeDialog extends DialogComponentProvider { AddressRangeListener listener) { super(programIndicator + " Address Range", true, true, true, false); this.program = program; - addressFactory = program.getAddressFactory(); this.listener = listener; setHelpLocation(new HelpLocation(HelpTopics.LABEL, "AddEditDialog")); addWorkPanel(createAddressRangePanel()); @@ -68,8 +65,7 @@ public class AddRemoveAddressRangeDialog extends DialogComponentProvider { minLabel.setToolTipText("Enter minimum address to add or remove"); addressRangePanel.add(minLabel); - minAddressField = new AddressInput(); - minAddressField.setAddressFactory(addressFactory); + minAddressField = new AddressInput(program); Dimension minPreferredSize = getPreferredSize(); minPreferredSize.width = 200; minAddressField.setPreferredSize(minPreferredSize); @@ -79,8 +75,7 @@ public class AddRemoveAddressRangeDialog extends DialogComponentProvider { maxLabel.setToolTipText("Enter maximum address to add or remove"); addressRangePanel.add(maxLabel); - maxAddressField = new AddressInput(); - maxAddressField.setAddressFactory(addressFactory); + maxAddressField = new AddressInput(program); Dimension maxPreferredSize = getPreferredSize(); maxPreferredSize.width = 200; minAddressField.setPreferredSize(maxPreferredSize); diff --git a/Ghidra/Framework/Docking/src/main/java/docking/widgets/textfield/HexDecimalModeTextField.java b/Ghidra/Framework/Docking/src/main/java/docking/widgets/textfield/HexDecimalModeTextField.java new file mode 100644 index 0000000000..d77ddc9894 --- /dev/null +++ b/Ghidra/Framework/Docking/src/main/java/docking/widgets/textfield/HexDecimalModeTextField.java @@ -0,0 +1,114 @@ +/* ### + * IP: GHIDRA + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package docking.widgets.textfield; + +import java.awt.*; +import java.awt.event.*; +import java.util.function.Consumer; + +import javax.swing.JTextField; +import javax.swing.ToolTipManager; + +import docking.DockingUtils; +import docking.util.GraphicsUtils; +import generic.theme.GThemeDefaults.Colors.Messages; +import generic.theme.Gui; + +/** + * Overrides the JTextField mainly to allow hint painting for the current radix mode. + */ +public class HexDecimalModeTextField extends JTextField { + + private static final String FONT_ID = "font.input.hint"; + private int hintWidth; + private boolean isHexMode; + private boolean showNumbericDecoration = true; + + public HexDecimalModeTextField(int columns, Consumer modeConsumer) { + super(columns); + + FontMetrics fontMetrics = getFontMetrics(Gui.getFont(FONT_ID)); + String mode = isHexMode ? "Hex" : "Dec"; + hintWidth = fontMetrics.stringWidth(mode); + + addKeyListener(new KeyAdapter() { + @Override + public void keyPressed(KeyEvent e) { + if (e.getKeyCode() == KeyEvent.VK_M && DockingUtils.isControlModifier(e)) { + isHexMode = !isHexMode; + modeConsumer.accept(isHexMode); + repaint(); + } + } + }); + + // make sure tooltips will be activated + ToolTipManager.sharedInstance().registerComponent(this); + } + + @Override + public String getToolTipText(MouseEvent event) { + + int hintStart = getBounds().width - hintWidth; + if (event.getX() > hintStart) { + String key = DockingUtils.CONTROL_KEY_NAME; + return "Press '" + key + "-M' to toggle Hex or Decimal Mode"; + } + + return null; + } + + public void setHexMode(boolean hexMode) { + this.isHexMode = hexMode; + } + + /** + * Turns on or off the faded text that displays the field's radix mode (hex or decimal). + * + * @param show true to show the radix mode. + */ + public void setShowNumberMode(boolean show) { + this.showNumbericDecoration = show; + repaint(); + } + + @Override + protected void paintComponent(Graphics g) { + super.paintComponent(g); + if (!showNumbericDecoration) { + return; + } + + Font savedFont = g.getFont(); + g.setFont(Gui.getFont(FONT_ID)); + g.setColor(Messages.HINT); + + Dimension size = getSize(); + Insets insets = getInsets(); + int x; + if (getHorizontalAlignment() == RIGHT) { + x = insets.left; + } + else { + x = size.width - insets.right - hintWidth; + } + int y = size.height - insets.bottom - 1; + String mode = isHexMode ? "Hex" : "Dec"; + GraphicsUtils.drawString(this, g, mode, x, y); + g.setFont(savedFont); + } + +} diff --git a/Ghidra/Framework/Docking/src/main/java/docking/widgets/textfield/IntegerTextField.java b/Ghidra/Framework/Docking/src/main/java/docking/widgets/textfield/IntegerTextField.java index b2236767fa..25deb873be 100644 --- a/Ghidra/Framework/Docking/src/main/java/docking/widgets/textfield/IntegerTextField.java +++ b/Ghidra/Framework/Docking/src/main/java/docking/widgets/textfield/IntegerTextField.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -15,20 +15,16 @@ */ package docking.widgets.textfield; -import java.awt.*; -import java.awt.event.*; +import java.awt.event.ActionListener; import java.math.BigInteger; import java.util.ArrayList; import java.util.List; -import javax.swing.*; +import javax.swing.JComponent; +import javax.swing.JTextField; import javax.swing.event.*; import javax.swing.text.*; -import docking.DockingUtils; -import docking.util.GraphicsUtils; -import generic.theme.GThemeDefaults.Colors.Messages; -import generic.theme.Gui; import ghidra.util.SystemUtilities; /** @@ -63,12 +59,11 @@ import ghidra.util.SystemUtilities; */ public class IntegerTextField { - private JTextField textField; + private HexDecimalModeTextField textField; private boolean isHexMode = false; private boolean allowsNegative = true; private boolean allowsHexPrefix = true; - private boolean showNumbericDecoration = true; private BigInteger maxValue; private BigInteger minValue; @@ -109,9 +104,13 @@ public class IntegerTextField { * @param initialValue the initial value */ public IntegerTextField(int columns, BigInteger initialValue) { - textField = new MyTextField(columns); + textField = new HexDecimalModeTextField(columns, b -> textFieldHexModeChanged(b)); + + AbstractDocument document = (AbstractDocument) textField.getDocument(); + document.setDocumentFilter(new HexDecimalDocumentFilter()); setValue(initialValue); - textField.getDocument().addDocumentListener(new DocumentListener() { + + document.addDocumentListener(new DocumentListener() { @Override public void removeUpdate(DocumentEvent e) { @@ -266,8 +265,7 @@ public class IntegerTextField { * @param show true to show the radix mode. */ public void setShowNumberMode(boolean show) { - this.showNumbericDecoration = show; - textField.repaint(); + textField.setShowNumberMode(show); } /** @@ -278,9 +276,15 @@ public class IntegerTextField { * the current value from decimal to hex. */ public void setHexMode() { - BigInteger currentValue = getValue(); - isHexMode = true; - updateTextField(currentValue); + BigInteger value = getValue(); + setHexMode(true); + setValue(value); + + } + + private void setHexMode(boolean hexMode) { + this.isHexMode = hexMode; + textField.setHexMode(hexMode); } /** @@ -291,9 +295,9 @@ public class IntegerTextField { * current value from hex to decimal. */ public void setDecimalMode() { - BigInteger currentValue = getValue(); - isHexMode = false; - updateTextField(currentValue); + BigInteger value = getValue(); + setHexMode(false); + setValue(value); } /** @@ -477,6 +481,12 @@ public class IntegerTextField { textField.setHorizontalAlignment(alignment); } + private void textFieldHexModeChanged(boolean hexMode) { + BigInteger value = getValue(); + this.isHexMode = hexMode; + setValue(value); + } + private String computeTextForValue(BigInteger value) { if (value == null) { return ""; @@ -525,15 +535,6 @@ public class IntegerTextField { } } - private void toggleMode() { - if (isHexMode) { - setDecimalMode(); - } - else { - setHexMode(); - } - } - private boolean passesMaxCheck(BigInteger value) { if (value == null) { return true; @@ -648,7 +649,7 @@ public class IntegerTextField { if (isValidPrefix(valueString)) { // When the input is valid, update the hex mode to match how the text was parsed. // See parseAsHex variable comment above. - isHexMode = parseAsHex; + setHexMode(parseAsHex); return true; } @@ -661,7 +662,7 @@ public class IntegerTextField { if (passesMaxCheck(value) && passesMinCheck(value)) { // When the input is valid, update the hex mode to match how the text was parsed. // See parseAsHex variable comment above. - isHexMode = parseAsHex; + setHexMode(parseAsHex); return true; } } @@ -692,76 +693,4 @@ public class IntegerTextField { // so we don't allow negatives return value.signum() < 0; } - - /** - * Overrides the JTextField mainly to allow hint painting for the current radix mode. - */ - private class MyTextField extends JTextField { - - private static final String FONT_ID = "font.input.hint"; - private int hintWidth; - - public MyTextField(int columns) { - super(columns); - - FontMetrics fontMetrics = getFontMetrics(Gui.getFont(FONT_ID)); - String mode = isHexMode ? "Hex" : "Dec"; - hintWidth = fontMetrics.stringWidth(mode); - - AbstractDocument document = (AbstractDocument) getDocument(); - document.setDocumentFilter(new HexDecimalDocumentFilter()); - - addKeyListener(new KeyAdapter() { - @Override - public void keyPressed(KeyEvent e) { - if (e.getKeyCode() == KeyEvent.VK_M && DockingUtils.isControlModifier(e)) { - toggleMode(); - repaint(); - } - } - }); - - // make sure tooltips will be activated - ToolTipManager.sharedInstance().registerComponent(this); - } - - @Override - public String getToolTipText(MouseEvent event) { - - int hintStart = getBounds().width - hintWidth; - if (event.getX() > hintStart) { - String key = DockingUtils.CONTROL_KEY_NAME; - return "Press '" + key + "-M' to toggle Hex or Decimal Mode"; - } - - return null; - } - - @Override - protected void paintComponent(Graphics g) { - super.paintComponent(g); - if (!showNumbericDecoration) { - return; - } - - Font savedFont = g.getFont(); - g.setFont(Gui.getFont(FONT_ID)); - g.setColor(Messages.HINT); - - Dimension size = getSize(); - Insets insets = getInsets(); - int x; - if (getHorizontalAlignment() == RIGHT) { - x = insets.left; - } - else { - x = size.width - insets.right - hintWidth; - } - int y = size.height - insets.bottom - 1; - String mode = isHexMode ? "Hex" : "Dec"; - GraphicsUtils.drawString(this, g, mode, x, y); - g.setFont(savedFont); - } - } - } diff --git a/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionElement.java b/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionElement.java new file mode 100644 index 0000000000..912cc39231 --- /dev/null +++ b/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionElement.java @@ -0,0 +1,24 @@ +/* ### + * IP: GHIDRA + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package generic.expressions; + +/** + * Base marker interface for {@link ExpressionGrouper}, {@link ExpressionOperator}, + * and {@link ExpressionValue} + */ +public interface ExpressionElement { + // marker interface +} diff --git a/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionEvaluator.java b/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionEvaluator.java new file mode 100644 index 0000000000..34f538f71c --- /dev/null +++ b/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionEvaluator.java @@ -0,0 +1,509 @@ +/* ### + * IP: GHIDRA + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package generic.expressions; + +import static generic.expressions.ExpressionGrouper.*; + +import java.util.*; +import java.util.function.Function; +import java.util.stream.Collectors; + +import ghidra.util.NumericUtilities; + +/** + * Class for evaluating numeric expressions. See + * {@link ExpressionOperator} for the full list of supported operators. All values are interpreted + * as longs. Optionally, an ExpressionEvalualuator can be constructed with a symbol evaluator that + * will be called on any string that can't be evaluated as an operator or number. + *

    + * ExpressionEvaluators can operate in either decimal or hex mode. If in hex mode, all numbers are + * assumed to be hexadecimal values. In decimal mode, numbers are assumed to be decimal values, but + * hexadecimal values can still be specified by prefixing them with "0x". + *

    + * There are also two convenience static methods that can be called to evaluate expressions. These + * methods will either return a Long value as the result or null if there was an error evaluating + * the expression. To get error messages related to parsing the expression, instantiate an + * ExpressionEvaluator and call {@link #parse(String)} which will throw a + * {@link ExpressionException} when the expression can't be evaluated. + */ +public class ExpressionEvaluator { + private static final String TOKEN_CHARS = "+-*/()<>|^&~ =!"; + + private boolean assumeHex = false; + + private Function evaluator; + + /** + * Evaluates the given input as a Long value. This call assumes all numbers are decimal unless + * prefixed with a "0x". + * @param input the expression to be parsed into a Long value + * @return the resulting Long value or null if the expression could not be evaluated. + */ + public static Long evaluateToLong(String input) { + return evaluateToLong(input, false); + } + + /** + * Evaluates the given input as a long value. + * @param input the expression to be parsed into a Long value + * @param assumeHex if true, numbers will be assumed to be hexadecimal values. + * @return the resulting Long value or null if the expression could not be evaluated. + */ + public static Long evaluateToLong(String input, boolean assumeHex) { + ExpressionEvaluator evaluator = new ExpressionEvaluator(assumeHex); + try { + return evaluator.parseAsLong(input); + } + catch (ExpressionException e) { + return null; + } + } + + /** + * Constructs an ExpressionEvaluator in decimal mode. + */ + public ExpressionEvaluator() { + this(false); + } + + /** + * Constructs an ExpressionEvaluator in either decimal or hex mode. + * @param assumeHex if true, the evaluator will assume all values are hexadecimal. + */ + public ExpressionEvaluator(boolean assumeHex) { + this(assumeHex, s -> null); + } + + /** + * Constructs an ExpressionEvaluator in decimal mode with a given symbol evaluator. + * @param evaluator A function that can convert a string token into a value (Must be Long + * ExpressionValues, unless this is being called by a subclass that can handle other types + * of operand values) + */ + public ExpressionEvaluator(Function evaluator) { + this(false, evaluator); + } + + /** + * Constructs an ExpressionEvaluator in either decimal or hex mode with a given symbol + * evaluator. + * @param assumeHex if true, the evaluator will assume all values are hexadecimal. + * @param evaluator A function that can convert a string token into a value (Must be Long + * ExpressionValues, unless this is being called by a subclass that can handle other types + * of operand values) + */ + public ExpressionEvaluator(boolean assumeHex, Function evaluator) { + this.assumeHex = assumeHex; + this.evaluator = Objects.requireNonNull(evaluator); + } + + /** + * Parses the given expression input, expecting the result to be long value. + * @param input the expression string + * @return the long value result. + * @throws ExpressionException if the expression could not be evaluated to a long value. + */ + public long parseAsLong(String input) throws ExpressionException { + ExpressionValue expressionValue = parse(input); + if (expressionValue instanceof LongExpressionValue longValue) { + return longValue.getLongValue(); + } + throw new ExpressionException("Expression did not evalute to a long! Got a " + + expressionValue.getClass() + " instead."); + } + + /** + * Changes the hex/decimal mode. + * @param b if true, all numbers will be assumed to be hexadecimal + */ + public void setAssumeHex(boolean b) { + this.assumeHex = b; + } + + protected ExpressionValue parse(String input) throws ExpressionException { + return this.parse(input, null); + } + + protected ExpressionValue parse(String input, ExpressionValue initial) + throws ExpressionException { + List list = new ArrayList<>(); + + // if there is a given initial value (used for relative expressions), add it to the + // sequential list of valid expression elements. + if (initial != null) { + list.add(initial); + } + + // convert the text input into a list of valid expression elements + parseToList(input, list); + + // evaluate the list of expression elements in operator precedence order. + return eval(list); + } + + /** + * Parses the input string into a list of valid elements. When this method completes, the list + * will contain only valid operators, valid operand values, or group operators. + * @param input the input string to be parsed. + * @param list the list to populate with valid elements. + * @throws ExpressionException if any part of the input string can't be parsed into a valid + * expression element. + */ + private void parseToList(String input, List list) + throws ExpressionException { + + LookAheadTokenizer parser = new LookAheadTokenizer(input); + while (parser.hasMoreTokens()) { + String token = parser.getCurrentToken(); + + if (token.isBlank()) { + parser.advance(1); + } + else if (processGroupToken(list, token)) { + parser.advance(1); + } + else if (processOperator(list, token, parser.getNextToken())) { + ExpressionOperator op = getLastOperator(list); + parser.advance(op.size()); + } + else if (processNumber(list, token)) { + parser.advance(1); + } + else if (processSymbol(list, token)) { + parser.advance(1); + } + else { + throw new ExpressionException("Could not evaluate token \"" + token + "\""); + } + } + if (list.isEmpty()) { + throw new ExpressionException("Expression is empty. Nothing to parse!"); + } + } + + /** + * Evaluates a list of valid expression elements into a single final value. + * @param list the list of valid expression elements. + * @return the final value the expression evaluates to + * @throws ExpressionException if sequence of expression elements is not in a valid order such + * that it evaluates to a single value. (such as two values not being separated by an operator) + */ + private ExpressionValue eval(List list) throws ExpressionException { + // first evaluate any sub-lists grouped by parenthesis + processGroups(list); + + // next process any unary operators + processUnaryOperators(list); + + // final process binary operators in operator precedence order. + processBinaryOperators(list); + + // if everything evaluated properly, there should only be one item left in the list + if (list.size() != 1) { + String result = list.stream().map(Object::toString).collect(Collectors.joining(" ")); + throw new ExpressionException("Parse failed! Stopped at \"" + result + "\""); + } + + ExpressionElement element = list.get(0); + if (element instanceof ExpressionValue ev) { + return ev; + } + throw new ExpressionException("Parse failed to evaluate to a value! Stopped at " + element); + } + + private void processBinaryOperators(List list) throws ExpressionException { + List> ops = ExpressionOperator.getBinaryOperatorsByPrecedence(); + + // Each set in the list contains operators at the same precedence, so they all need + // to be processed at the same time so that they are processed left to right (which + // corresponds to the list order) + for (Set set : ops) { + processBinaryOperators(list, set); + } + } + + private void processBinaryOperators(List list, + Set operators) throws ExpressionException { + // can't have a valid binary operator at index 0, so start looking at index 1 + int operatorIndex = findValidBinaryOperator(list, operators, 1); + while (operatorIndex >= 0) { + // we can safely cast here because we checked in the findValidBinaryOperator method + ExpressionOperator operator = (ExpressionOperator) list.get(operatorIndex); + ExpressionValue value1 = (ExpressionValue) list.get(operatorIndex - 1); + ExpressionValue value2 = (ExpressionValue) list.get(operatorIndex + 1); + ExpressionValue newValue = value1.applyBinaryOperator(operator, value2); + list.set(operatorIndex - 1, newValue); + list.subList(operatorIndex, operatorIndex + 2).clear(); + + // After the operator completed, the list has been changed and the sequence + // "value operator value" has been replace with the resulting value of the operation. + + // Now look for the next operator in the current set of operators we are evaluating + operatorIndex = findValidBinaryOperator(list, operators, operatorIndex); + } + + } + + private int findValidBinaryOperator(List list, + Set operators, int startIndex) { + + // can't have a valid binary operator at the last index, so stop 1 before last + for (int i = startIndex; i < list.size() - 1; i++) { + if (operators.contains(list.get(i))) { + // make sure the elements before and after the operator are value types so + // that the caller can just cast them as values. If they are not, then + // this operator won't be evaluated and at the end the evaluate process, the list + // won't be reduced to just one element. + if (list.get(i - 1) instanceof ExpressionValue & + list.get(i + 1) instanceof ExpressionValue) { + return i; + } + } + } + return -1; + } + + private void processUnaryOperators(List list) throws ExpressionException { + + int unaryOperatorIndex = findValidUnaryOperator(list); + while (unaryOperatorIndex >= 0) { + ExpressionOperator operator = (ExpressionOperator) list.get(unaryOperatorIndex); + ExpressionValue value = (ExpressionValue) list.get(unaryOperatorIndex + 1); + ExpressionValue newValue = value.applyUnaryOperator(operator); + list.remove(unaryOperatorIndex); + list.set(unaryOperatorIndex, newValue); + + unaryOperatorIndex = findValidUnaryOperator(list); + } + + } + + private int findValidUnaryOperator(List list) { + // stop 1 before end since you can't end in a valid unary operator + + for (int i = 0; i < list.size() - 1; i++) { + // check any element in the list if it is a unary operator + if (list.get(i) instanceof ExpressionOperator op) { + if (!op.isUnary()) { + continue; + } + + // make sure the next element is a value so the the caller can cast without fear + if (list.get(i + 1) instanceof ExpressionValue) { + return i; + } + } + } + return -1; + } + + /** + * Recursively for groups (sublists surrounded by parenthesis) and process the sub list of + * elements in the group before processing the outer list. As each group is evaluated, the start + * paren operator, the end paren operator and all the tokens in between are replaced by the + * single value the group evaluated to. + * @param list the list to look for grouped sub-lists. + * @throws ExpressionException if a exception occurs processing a sub list + */ + private void processGroups(List list) throws ExpressionException { + int groupStart = findGroupStart(list); + while (groupStart >= 0) { + int groupEndIndex = findGroupEnd(list, groupStart); + if (groupEndIndex < 0) { + throw new ExpressionException("Missing end parenthesis!"); + } + ExpressionValue value = eval(list.subList(groupStart + 1, groupEndIndex)); + + // After evaluating, everything between the parens will be replaced by the result. So + // replace the left paren with the results and clear the next 2 entries. + list.set(groupStart, value); + list.subList(groupStart + 1, groupStart + 3).clear(); + + groupStart = findGroupStart(list); + } + } + + private int findGroupStart(List list) { + for (int i = 0; i < list.size(); i++) { + if (list.get(i) == LEFT_PAREN) { + return i; + } + } + return -1; + } + + private int findGroupEnd(List list, int groupStart) { + int depth = 1; + for (int i = groupStart + 1; i < list.size(); i++) { + Object obj = list.get(i); + if (obj == LEFT_PAREN) { + depth++; + } + else if (obj == RIGHT_PAREN) { + if (--depth == 0) { + return i; + } + } + } + return -1; + } + + // A tokenizer that keeps track of one future token. This is so the parser can handle operator + // chars that can ether be an operator by itself or part of a 2 char operator(i.e. "<", "=", + // "<=", "<<", "==") + private class LookAheadTokenizer { + private StringTokenizer tokenizer; + private String currentToken; + private String nextToken; + + LookAheadTokenizer(String input) { + tokenizer = new StringTokenizer(input, TOKEN_CHARS, true); + currentToken = tokenizer.hasMoreTokens() ? tokenizer.nextToken() : null; + nextToken = tokenizer.hasMoreTokens() ? tokenizer.nextToken() : null; + } + + public boolean hasMoreTokens() { + return currentToken != null; + } + + public String getCurrentToken() { + return currentToken; + } + + public String getNextToken() { + return nextToken; + } + + public void advance(int count) { + for (int i = 0; i < count; i++) { + currentToken = nextToken; + nextToken = tokenizer.hasMoreTokens() ? tokenizer.nextToken() : null; + } + } + } + + private ExpressionOperator getLastOperator(List list) { + ExpressionElement lastElement = list.get(list.size() - 1); + return (ExpressionOperator) lastElement; + } + + private boolean processSymbol(List list, String token) { + ExpressionValue value = evaluateSymbol(token); + if (value != null) { + list.add(value); + return true; + } + return false; + } + + protected ExpressionValue evaluateSymbol(String token) { + return evaluator.apply(token); + } + + private boolean processOperator(List list, String token, String nextToken) { + boolean preferBinary = shouldPreferBinaryOp(list); + ExpressionOperator op = ExpressionOperator.getOperator(token, nextToken, preferBinary); + if (op != null) { + list.add(op); + return true; + } + return false; + } + + private boolean processGroupToken(List list, String token) { + if (token.equals("(")) { + list.add(LEFT_PAREN); + return true; + } + + if (token.equals(")")) { + list.add(RIGHT_PAREN); + return true; + } + return false; + } + + private boolean shouldPreferBinaryOp(List list) { + if (list.isEmpty()) { + return false; + } + ExpressionElement lastElement = list.get(list.size() - 1); + if (lastElement instanceof ExpressionValue) { + return true; + } + if (lastElement instanceof ExpressionOperator) { + return false; + } + if (lastElement == ExpressionGrouper.LEFT_PAREN) { + return false; + } + if (lastElement == ExpressionGrouper.RIGHT_PAREN) { + return true; + } + return false; + } + + private boolean processNumber(List list, String token) { + int radix = 10; + + if (assumeHex && processAsHexNumber(list, token)) { + return true; + } + token = toLowerAndRemoveEndNumberDecorators(token); + if (token.startsWith("0x")) { + radix = 16; + token = token.substring(2); + } + + try { + long value = (radix == 10) ? NumericUtilities.parseLong(token) + : NumericUtilities.parseHexLong(token); + + list.add(new LongExpressionValue(value)); + return true; + } + catch (Exception e) { + return false; + } + } + + private String toLowerAndRemoveEndNumberDecorators(String token) { + token = token.toLowerCase(); + if (token.endsWith("ull") || token.endsWith("llu")) { + token = token.substring(0, token.length() - 3); + } + else if (token.endsWith("ul") || token.endsWith("lu") || token.endsWith("ll")) { + token = token.substring(0, token.length() - 2); + } + else if (token.endsWith("l") || token.endsWith("u")) { + token = token.substring(0, token.length() - 1); + } + return token; + } + + // parses values as a hex value (e.g. parsing "10" returns 16 instead of 10) + private boolean processAsHexNumber(List list, String token) { + try { + long value = NumericUtilities.parseHexLong(token); + list.add(new LongExpressionValue(value)); + return true; + } + catch (NumberFormatException e) { + // ignore + } + return false; + } +} diff --git a/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionException.java b/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionException.java new file mode 100644 index 0000000000..8abc8eeaf5 --- /dev/null +++ b/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionException.java @@ -0,0 +1,25 @@ +/* ### + * IP: GHIDRA + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package generic.expressions; + +/** + * Exception thrown when using an {@link ExpressionEvaluator} + */ +public class ExpressionException extends Exception { + public ExpressionException(String message) { + super(message); + } +} diff --git a/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionGrouper.java b/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionGrouper.java new file mode 100644 index 0000000000..5310487fed --- /dev/null +++ b/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionGrouper.java @@ -0,0 +1,23 @@ +/* ### + * IP: GHIDRA + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package generic.expressions; + +/** + * Grouping {@link ExpressionElement}s + */ +public enum ExpressionGrouper implements ExpressionElement { + LEFT_PAREN, RIGHT_PAREN; +} diff --git a/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionOperator.java b/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionOperator.java new file mode 100644 index 0000000000..c9180c96b8 --- /dev/null +++ b/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionOperator.java @@ -0,0 +1,172 @@ +/* ### + * IP: GHIDRA + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package generic.expressions; + +import java.util.*; + +import org.apache.commons.collections4.map.LazyMap; + +/** + * Enum of support operators for the {@link ExpressionEvaluator} + */ +public enum ExpressionOperator implements ExpressionElement { + // unary + BITWISE_NOT("~", OpType.UNARY, 1), + LOGICAL_NOT("!", OpType.UNARY, 1), + UNARY_PLUS("+", OpType.UNARY, 1), + UNARY_MINUS("-", OpType.UNARY, 1), + + // multiplicative + MULTIPLY("*", OpType.BINARY, 2), + DIVIDE("/", OpType.BINARY, 2), + + // additive + ADD("+", OpType.BINARY, 3), + SUBTRACT("-", OpType.BINARY, 3), + + // shift + SHIFT_LEFT("<<", OpType.BINARY, 4), + SHIFT_RIGHT(">>", OpType.BINARY, 4), + + // relational + LESS_THAN("<", OpType.BINARY, 5), + GREATER_THAN(">", OpType.BINARY, 5), + LESS_THAN_OR_EQUAL("<=", OpType.BINARY, 5), + GREATER_THAN_OR_EQUAL(">=", OpType.BINARY, 5), + + // equality + EQUALS("==", OpType.BINARY, 6), + NOT_EQUALS("!=", OpType.BINARY, 6), + + // bitwise + BITWISE_AND("&", OpType.BINARY, 7), + BITWISE_XOR("^", OpType.BINARY, 8), + BITWISE_OR("|", OpType.BINARY, 9), + + // logical + LOGICAL_AND("&&", OpType.BINARY, 10), + LOGICAL_OR("||", OpType.BINARY, 11); + + public static List> binaryOperatorsByPrecedence; + + private String name; + private OpType type; + private int precedence; + + private ExpressionOperator(String name, OpType type, int precedence) { + this.name = name; + this.type = type; + this.precedence = precedence; + } + + @Override + public String toString() { + return name; + } + + /** + * Returns a list of all the binary operators in precedence order, organized into sets where + * each set contains all the operators of the same precedence. + * @return a list of all the binary operators in precedence order, organized into sets where + * each set contains all the operators of the same precedence. + */ + public static List> getBinaryOperatorsByPrecedence() { + if (binaryOperatorsByPrecedence == null) { + binaryOperatorsByPrecedence = buildOperatorsByPrecedenceList(); + } + return binaryOperatorsByPrecedence; + } + + private static List> buildOperatorsByPrecedenceList() { + ExpressionOperator[] values = values(); + LazyMap> map = + LazyMap.lazyMap(new TreeMap<>(), k -> new HashSet<>()); + + for (ExpressionOperator op : values) { + if (op.isBinary()) { + map.get(op.precedence).add(op); + } + } + return new ArrayList<>(map.values()); + + } + + /** + * Returns the operator for the given token and look ahead token and if we are expecting to find + * a binary operator. This method first tries merging the tokens looking for a double char + * operator first. + * @param token the first token + * @param lookahead1 the next token that may or may not be part of this operand + * @param preferBinary if we are expecting a binary operator (the previous expression element + * was an operand value). We need this to know if the token '-' is the unary operator or the + * binary operator. If the token before was an operator, then we expect a unary operator. If + * the previous was a value, then we expect a binary operator. + * @return the operator that matches the given tokens and expected type + */ + public static ExpressionOperator getOperator(String token, String lookahead1, + boolean preferBinary) { + + if (lookahead1 != null) { + String doubleToken = token + lookahead1; + ExpressionOperator operator = findOperator(doubleToken, preferBinary); + if (operator != null) { + return operator; + } + } + + return findOperator(token, preferBinary); + } + + private static ExpressionOperator findOperator(String tokens, boolean expectBinary) { + for (ExpressionOperator operator : values()) { + if (operator.name.equals(tokens)) { + if (operator.isBinary() == expectBinary) { + return operator; + } + } + } + return null; + } + + /** + * Returns the number of chars in the operator + * @return the number of chars in the operator + */ + public int size() { + return name.length(); + } + + /** + * Returns if the operator is a unary operator. + * @return if the operator is a unary operator. + */ + public boolean isUnary() { + return type == OpType.UNARY; + } + + /** + * Returns if the operator is a binary operator. + * @return if the operator is a binary operator. + */ + public boolean isBinary() { + return type == OpType.BINARY; + } + + private enum OpType { + UNARY, BINARY + } + +} diff --git a/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionValue.java b/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionValue.java new file mode 100644 index 0000000000..3cf72bab57 --- /dev/null +++ b/Ghidra/Framework/Generic/src/main/java/generic/expressions/ExpressionValue.java @@ -0,0 +1,42 @@ +/* ### + * IP: GHIDRA + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package generic.expressions; + +/** + * Operand types use by the {@link ExpressionEvaluator} must implement this interface. + */ +public interface ExpressionValue extends ExpressionElement { + + /** + * Method called to apply a unary operator to this value. + * @param operator the operator being applied + * @return the new value after the operator is applied to this value + * @throws ExpressionException if the operator is not applicable for this value + */ + public ExpressionValue applyUnaryOperator(ExpressionOperator operator) throws ExpressionException; + + /** + * Method called to apply a binary operator to this value. + * @param operator the binary operator being applied. + * @param value the other value to combine with this value by the operator + * @return the new value after the operator is applied to this value + * @throws ExpressionException if the operator is not applicable for this value or the the other + * value is not applicable for this operand and operator + */ + public ExpressionValue applyBinaryOperator(ExpressionOperator operator, ExpressionValue value) + throws ExpressionException; + +} diff --git a/Ghidra/Framework/Generic/src/main/java/generic/expressions/LongExpressionValue.java b/Ghidra/Framework/Generic/src/main/java/generic/expressions/LongExpressionValue.java new file mode 100644 index 0000000000..200a30e21b --- /dev/null +++ b/Ghidra/Framework/Generic/src/main/java/generic/expressions/LongExpressionValue.java @@ -0,0 +1,110 @@ +/* ### + * IP: GHIDRA + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package generic.expressions; + +/** + * Long operand values. See {@link ExpressionValue}. Defines supported operators and other + * operands for expression values that are long values. + */ +public class LongExpressionValue implements ExpressionValue { + + private final long value; + + public LongExpressionValue(long value) { + this.value = value; + } + + public long getLongValue() { + return value; + } + + @Override + public String toString() { + return Long.toString(value); + } + + @Override + public ExpressionValue applyUnaryOperator(ExpressionOperator operator) throws ExpressionException { + switch (operator) { + case BITWISE_NOT: + return new LongExpressionValue(~value); + case LOGICAL_NOT: + return new LongExpressionValue(value == 0 ? 1 : 0); + case UNARY_MINUS: + return new LongExpressionValue(-value); + case UNARY_PLUS: + return this; + default: + throw new ExpressionException( + "Unary Operator " + operator + " not supported by Long values!"); + } + } + + @Override + public ExpressionValue applyBinaryOperator(ExpressionOperator operator, ExpressionValue operand) + throws ExpressionException { + if (!(operand instanceof LongExpressionValue longOperand)) { + throw new ExpressionException("Unsupported operand type for Long: " + value); + } + long otherValue = longOperand.value; + + switch (operator) { + case BITWISE_AND: + return new LongExpressionValue(value & otherValue); + case BITWISE_OR: + return new LongExpressionValue(value | otherValue); + case BITWISE_XOR: + return new LongExpressionValue(value ^ otherValue); + case DIVIDE: + return new LongExpressionValue(value / otherValue); + case EQUALS: + return new LongExpressionValue(value == otherValue ? 1 : 0); + case GREATER_THAN: + return new LongExpressionValue(value > otherValue ? 1 : 0); + case GREATER_THAN_OR_EQUAL: + return new LongExpressionValue(value >= otherValue ? 1 : 0); + case SHIFT_LEFT: + return new LongExpressionValue(value << otherValue); + case LESS_THAN: + return new LongExpressionValue(value < otherValue ? 1 : 0); + case LESS_THAN_OR_EQUAL: + return new LongExpressionValue(value <= otherValue ? 1 : 0); + case LOGICAL_AND: + int b1 = value == 0 ? 0 : 1; + int b2 = otherValue == 0 ? 0 : 1; + return new LongExpressionValue(b1 & b2); + case LOGICAL_OR: + b1 = value == 0 ? 0 : 1; + b2 = otherValue == 0 ? 0 : 1; + return new LongExpressionValue(b1 | b2); + case SUBTRACT: + return new LongExpressionValue(value - otherValue); + case NOT_EQUALS: + return new LongExpressionValue(value == otherValue ? 0 : 1); + case ADD: + return new LongExpressionValue(value + otherValue); + case SHIFT_RIGHT: + return new LongExpressionValue(value >> otherValue); + case MULTIPLY: + return new LongExpressionValue(value * otherValue); + default: + throw new ExpressionException( + "Binary Operator \"" + operator + "\" not supported by Long values!"); + } + + } + +} diff --git a/Ghidra/Framework/Generic/src/test/java/generic/expressions/ExpressionEvaluatorTest.java b/Ghidra/Framework/Generic/src/test/java/generic/expressions/ExpressionEvaluatorTest.java new file mode 100644 index 0000000000..c7d974b044 --- /dev/null +++ b/Ghidra/Framework/Generic/src/test/java/generic/expressions/ExpressionEvaluatorTest.java @@ -0,0 +1,206 @@ +/* ### + * IP: GHIDRA + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package generic.expressions; + +import static org.junit.Assert.*; + +import org.junit.Test; + +public class ExpressionEvaluatorTest { + + @Test + public void testUnaryPlus() { + assertEval(100, "+100"); + } + + @Test + public void testUnaryMinus() { + assertEval(-100, "-100"); + } + + @Test + public void testAdd() { + assertEval(100, "20+10 + 70"); + } + + @Test + public void testSubtract() { + assertEval(5, "20-10-5"); + assertEval(5, "20-5-10"); + } + + @Test + public void testMultiply() { + assertEval(42, "2*3*7"); + } + + @Test + public void testDivide() { + assertEval(1, "8/4/2"); + assertEval(1, "5/4"); + } + + @Test + public void testShiftLeft() { + assertEval(4, "16>>2"); + } + + @Test + public void testShiftRight() { + assertEval(8, "1<<3"); + } + + @Test + public void testBitWiseNot() { + assertEval(-1, "~0"); + } + + @Test + public void testLogicalNot() { + assertEval(0, "!1"); + assertEval(1, "!0"); + assertEval(0, "!124"); + } + + @Test + public void testGreaterThan() { + assertEval(1, "8>5"); + assertEval(0, "5>8"); + assertEval(0, "8>8"); + } + + @Test + public void testLessThan() { + assertEval(0, "8<5"); + assertEval(1, "5<8"); + assertEval(0, "8<8"); + } + + @Test + public void testGreaterThanOrEqual() { + assertEval(1, "8>=5"); + assertEval(0, "5>=8"); + assertEval(1, "8>=8"); + } + + @Test + public void testLessThanOrEqual() { + assertEval(0, "8<=5"); + assertEval(1, "5<=8"); + assertEval(1, "8<=8"); + } + + @Test + public void testAddSubtractAssociatesLeftToRight() { + assertEval(110, "100+30-10-10"); + assertEval(110, "100-10-10+30"); + } + + @Test + public void testMultiplyDivide() { + assertEval(100, "10*30/3"); + assertEval(90, "10/3*30"); + } + + @Test + public void testBitwiseAnd() { + assertEval(0x4, "0xffff & 0x4"); + assertEval(0x0, "0x4 & 0x2"); + } + + @Test + public void testBitwiseOr() { + assertEval(0x6, "0x2 | 0x4"); + } + + @Test + public void testBitwiseXor() { + assertEval(0x2, "0x3 ^ 0x1"); + } + + @Test + public void testLogicalAnd() { + assertEval(1, "0xffff && 0x4"); + assertEval(0, "0x4 && 0"); + } + + @Test + public void testLogicalOr() { + assertEval(1, "0x2 || 0x4"); + assertEval(0, "0 || 0"); + } + + @Test + public void testMixedPrecedence() { + assertEval(23, "10+3*5-8/4"); + } + + @Test + public void testGrouping() { + assertEval(42, "6*(3+4)"); + assertEval(16, "1 << (8/2)"); + assertEval(-1, "~(-1+1)"); + assertEval(13, "1+(3 * (7+1)/2)"); + } + + @Test + public void testStackedUnaryOperators() { + assertEval(-1, "~~~0"); + } + + @Test + public void testInvalidSyntax() { + assertEvalNull("5 5"); + assertEvalNull("+"); + assertEvalNull("<< 5"); + assertEvalNull("5 +"); + assertEvalNull("(3+2"); + } + + @Test + public void testMixedValues() { + assertEval(26, "10+0x10"); + } + + @Test + public void testHexOnly() { + assertEvalHexOnly(22, "10+6"); + } + + private void assertEval(long expected, String expression) { + long result = ExpressionEvaluator.evaluateToLong(expression); + assertEquals(expected, result); + + } + + private void assertEvalHexOnly(long expected, String expression) { + ExpressionEvaluator evaluator = new ExpressionEvaluator(true); + long result; + try { + result = evaluator.parseAsLong(expression); + assertEquals(expected, result); + } + catch (ExpressionException e) { + // ignore + } + + } + + private void assertEvalNull(String expression) { + assertNull(ExpressionEvaluator.evaluateToLong(expression)); + + } +} diff --git a/Ghidra/Framework/SoftwareModeling/src/main/java/ghidra/program/util/AddressEvaluator.java b/Ghidra/Framework/SoftwareModeling/src/main/java/ghidra/program/util/AddressEvaluator.java index 665591baaf..ae03a5a009 100644 --- a/Ghidra/Framework/SoftwareModeling/src/main/java/ghidra/program/util/AddressEvaluator.java +++ b/Ghidra/Framework/SoftwareModeling/src/main/java/ghidra/program/util/AddressEvaluator.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -15,656 +15,270 @@ */ package ghidra.program.util; -import java.util.*; +import java.lang.ref.Reference; +import java.lang.ref.WeakReference; +import java.util.List; +import generic.expressions.*; +import ghidra.app.util.NamespaceUtils; +import ghidra.app.util.SymbolPath; import ghidra.program.model.address.*; import ghidra.program.model.listing.Program; -import ghidra.program.model.symbol.Symbol; -import ghidra.program.model.symbol.SymbolTable; -import ghidra.util.NumericUtilities; +import ghidra.program.model.mem.Memory; +import ghidra.program.model.mem.MemoryBlock; +import ghidra.program.model.symbol.*; /** - * The AddressEvaluator class provides a way to evaluate a string - * that represents an address and resolve it to an address for a particular program. + * Class for evaluating expressions as an Address. See + * {@link ExpressionOperator} for the full list of supported operators. All values are interpreted + * as longs or symbols that resolve to an address. + *

    + * ExpressionEvaluators can operate in either decimal or hex mode. If in hex mode, all numbers are + * assumed to be hexadecimal values. In decimal mode, numbers are assumed to be decimal values, but + * hexadecimal values can still be specified by prefixing them with "0x". + *

    + * There are also two convenience static methods that can be called to evaluate address expressions. + * These methods will either return an Address as the result or null if there was an error + * evaluating the expression. To get error messages related to parsing the expression, instantiate + * an AddressEvaluator and call {@link #parseAsAddress(String)} which will throw a + * {@link ExpressionException} when the expression can't be evaluated. */ -public class AddressEvaluator { +public class AddressEvaluator extends ExpressionEvaluator { - private static final String TOKEN_CHARS = "+-*/()<>|^&~ ="; + private Reference programReference; + private AddressFactory addressFactory; + private AddressSpace preferredSpace; /** - * Gets a legitimate address for the specified program as indicated by the string. + * Gets a valid address for the specified program as indicated by the input expression. * @param p the program to use for determining the address. - * @param baseAddr the base address to use for relative addressing. - * @param s string representation of the address desired. + * @param inputExpression string representation of the address desired. * @return the address. Otherwise, return null if the string fails to evaluate * to a unique legitimate address. */ - public static Address evaluate(Program p, Address baseAddr, String s) { - - AddressFactory af = p.getAddressFactory(); - SymbolTable st = p.getSymbolTable(); - List list = new ArrayList(); - if (baseAddr != null) { - list.add(baseAddr); - } - if (!parseToList(s, af, st, list)) { - return null; - } - Object obj = eval(list); - if (obj instanceof Address) { - return (Address) obj; - } - else if (obj instanceof Long) { - try { - return af.getDefaultAddressSpace().getAddress(((Long) obj).longValue(), true); - } - catch (Exception e) { - // ignore - } - } - return null; - } - - public static Long evaluateToLong(String s) { - List list = new ArrayList(); - - if (!parseToList(s, null, null, list)) { - return null; - } - Object obj = eval(list); - if (obj instanceof Address) { - return ((Address) obj).getOffset(); - } - else if (obj instanceof Long) { - return (Long) obj; - } - return null; - } - - protected static boolean parseToList(String s, AddressFactory af, SymbolTable st, - List list) { - StringTokenizer parser = new StringTokenizer(s, TOKEN_CHARS, true); - String lookahead = null; - while (lookahead != null || parser.hasMoreTokens()) { - String tok = null; - if (lookahead != null) { - tok = lookahead; - lookahead = null; - } - else { - tok = parser.nextToken(); - } - - if (tok.equals(" ")) { - continue; - } - - // = must be followed by =, others can be followed - if ("=!<>|&".contains(tok)) { - lookahead = parser.nextToken(); - tok = checkDoubleToken(tok, lookahead); - // if tok is now longer, consumed lookahead - if (tok.length() > 1) { - lookahead = null; - } - } - Object obj = Operator.getOperator(tok); - if (obj == null) { - obj = getValueObject(st, af, tok); - } - if (obj == null) { - return false; - } - list.add(obj); - } - return true; - } - - private static String checkDoubleToken(String tok, String lookahead) { - switch (tok) { - case "=": - if (lookahead.equals("=")) { - return "=="; - } - break; - - case "<": - if (lookahead.equals("=")) { - return "<="; - } - if (lookahead.equals("<")) { - return "<<"; - } - break; - - case ">": - if (lookahead.equals("=")) { - return ">="; - } - if (lookahead.equals(">")) { - return ">>"; - } - break; - - case "!": - if (lookahead.equals("=")) { - return "!="; - } - break; - - case "|": - if (lookahead.equals("|")) { - return "||"; - } - break; - - case "&": - if (lookahead.equals("&")) { - return "&&"; - } - break; - } - - return tok; + public static Address evaluate(Program p, String inputExpression) { + return evaluate(p, null, inputExpression); } /** - * Gets a legitimate address for the specified program as indicated by the string. + * Gets a valid address for the specified program as indicated by the input expression. * @param p the program to use for determining the address. - * @param s string representation of the address desired. + * @param baseAddr the base address to use for relative addressing. + * @param inputExpression string representation of the address desired. * @return the address. Otherwise, return null if the string fails to evaluate - * to a legitimate address. + * to a unique legitimate address. */ - public static Address evaluate(Program p, String s) { - return evaluate(p, null, s); + public static Address evaluate(Program p, Address baseAddr, String inputExpression) { + AddressEvaluator evaluator = new AddressEvaluator(p, true); + try { + return evaluator.parseAsAddress(inputExpression); + } + catch (ExpressionException e) { + return null; + } } /** - * Utility method for creating an Address object from a byte array. The Address object may or may not - * be a legitimate Address in the program's address space. This method is meant to provide a way of - * creating an Address object from a sequence of bytes that can be used for additional tests and - * comparisons. - * - * @param p - program being analyzed. - * @param addrBytes - byte array to use containing the values the address will be constructed from. - * @return - Address object constructed from the addrBytes array. Returns null if the program is null, - * addrBytes is null, or the length of addrBytes does not match the default Pointer size or does not contain - * a valid offset. - * + * Constructs an AddressEvalutor for the given program and in the specified hex/decimal mode. + * @param program the program to use to evaluate expressions into valid addresses. + * @param assumeHex if true, all numeric values are assumed to be hexadecimal numbers. */ - public static Address evaluate(Program p, byte[] addrBytes) { - - boolean isBigEndian = p.getMemory().isBigEndian(); - - int ptrSize = p.getDefaultPointerSize(); - int index = 0; - long offset = 0; - - // Make sure correct # of bytes were passed - if (addrBytes == null || addrBytes.length != ptrSize) { - return null; - } - - /* - * Make sure we account for endianness of the program. - * Computing the number of bits to shift the current byte value - * is different for Little vs. Big Endian. Need to multiply by - * 8 to shift in 1-byte increments. - */ - if (isBigEndian) { - index = 0; - while (index < addrBytes.length) { - offset += (addrBytes[index] & 0xff) << ((addrBytes.length - index - 1) * 8); - index++; - } - } - else { - // Program is LittleEndian - index = addrBytes.length - 1; - while (index >= 0) { - offset += ((addrBytes[index] & 0xff) << (index * 8)); - index--; - } - } - - AddressSpace space = p.getAddressFactory().getDefaultAddressSpace(); - try { - return space.getAddress(offset, true); - } - catch (AddressOutOfBoundsException e) { - return null; - } + public AddressEvaluator(Program program, boolean assumeHex) { + this(program, null, assumeHex); } - private static Object getValueObject(SymbolTable st, AddressFactory af, String tok) { + /** + * Constructs an AdddressEvaluator without a full program. This version will not be able to + * evaluate symbol or memory block names. This is mostly for backwards compatibility. + * @param factory the address factory for creating addresses + * @param assumeHex if true, all numeric values are assumed to be hexadecimal numbers. + */ + public AddressEvaluator(AddressFactory factory, boolean assumeHex) { + this(factory, null, assumeHex); + } - if (st == null || af == null) { - return getValueObject(tok); - } + /** + * Constructs an AddressEvalutor for the given program and in the specified hex/decimal mode. + * @param program the program to use to evaluate expressions into valid addresses. + * @param defaultSpace The address space to use when converting long values into addresses. If + * this value is null, then the default address space will be used. + * @param assumeHex if true, all numeric values are assumed to be hexadecimal numbers. + */ + public AddressEvaluator(Program program, AddressSpace defaultSpace, boolean assumeHex) { + this(program.getAddressFactory(), defaultSpace, assumeHex); + this.programReference = new WeakReference<>(program); + } - try { - return NumericUtilities.parseHexLong(tok); + private AddressEvaluator(AddressFactory factory, AddressSpace defaultSpace, boolean assumeHex) { + super(assumeHex); + this.addressFactory = factory; + this.preferredSpace = defaultSpace; + } + + /** + * Evaluates the given input expression as an address. + * @param input the expression to evaluate + * @return the Address the expression evaluates to + * @throws ExpressionException if the input expression can't be evaluated to a valid, unique + * address. + */ + public Address parseAsAddress(String input) throws ExpressionException { + return this.parseAsRelativeAddress(input, null); + } + + /** + * Evaluates the given input expression as a relative offset that will be added to the given + * base address. + * @param input the expression to evaluate as an offset + * @param baseAddress the base address the evaluted expression will be added to to get the + * resulting address. + * @return the Address after the evaluated offset is added to the given base address. + * @throws ExpressionException if the input expression can't be evaluated to a valid, unique + * address. + */ + public Address parseAsRelativeAddress(String input, Address baseAddress) + throws ExpressionException { + ExpressionValue expressionValue = baseAddress == null ? parse(input) + : parse(input, new AddressExpressionValue(baseAddress)); + + if (expressionValue instanceof AddressExpressionValue addressValue) { + return validateAddressSpace(addressValue.getAddress()); } - catch (NumberFormatException e) { - // ignore + if (expressionValue instanceof LongExpressionValue longValue) { + long offset = longValue.getLongValue(); + AddressSpace space = getAddressSpace(); + try { + return space.getAddressInThisSpaceOnly(offset); + } + catch (AddressOutOfBoundsException e) { + throw new ExpressionException(e.getMessage()); + } } - Address address = af.getAddress(tok); - if (address != null) { + throw new ExpressionException("Expression did not evalute to a long! Got a " + + expressionValue.getClass() + " instead."); + + } + + /** + * Returns the {@link AddressFactory} being used by this address evaluator + * @return the {@link AddressFactory} being used by this address evaluator + */ + public AddressFactory getAddressFactory() { + return addressFactory; + } + + /** + * Sets the {@link AddressSpace} to be used to convert long values into addresses. + * @param space the address space to convert long values into addresses + */ + public void setPreferredAddressSpace(AddressSpace space) { + this.preferredSpace = space; + } + + // checks if the given address's address space is compatible with the preferred address space + private Address validateAddressSpace(Address address) throws ExpressionException { + if (preferredSpace == null) { return address; } - - List globalSymbols = st.getLabelOrFunctionSymbols(tok, null); - if (globalSymbols.size() == 1) { - return globalSymbols.get(0).getAddress(); + AddressSpace space = address.getAddressSpace(); + if (space.equals(preferredSpace)) { + return address; } - return getValueObject(tok); + if (isOverlayRelated(space, preferredSpace)) { + return preferredSpace.getAddress(address.getOffset()); + } + throw new ExpressionException("Selected address space is not compatible with expression!"); } - private static Object getValueObject(String strValue) { - try { - int start = 0; - int radix = 10; - if (strValue.indexOf("0x") == 0) { - start = 2; - radix = 16; - } - strValue = strValue.toLowerCase(); - if (strValue.endsWith("ull") || strValue.endsWith("llu")) { - strValue = strValue.substring(start, strValue.length() - 3); - } - else if (strValue.endsWith("ul") || strValue.endsWith("lu") || strValue.endsWith("ll")) { - strValue = strValue.substring(start, strValue.length() - 2); - } - else if (strValue.endsWith("l") || strValue.endsWith("u")) { - strValue = strValue.substring(start, strValue.length() - 1); - } - else { - strValue = strValue.substring(start); - } - - return (radix == 10) ? NumericUtilities.parseLong(strValue) - : NumericUtilities.parseHexLong(strValue); - } - catch (RuntimeException e) { - // ignore - } - return null; + private boolean isOverlayRelated(AddressSpace space1, AddressSpace space2) { + AddressSpace base1 = getBaseSpace(space1); + AddressSpace base2 = getBaseSpace(space2); + return base1.equals(base2); } - private static Object eval(List list) { - - // first evaluate any grouped expressions - boolean done = false; - while (!done) { - done = true; - for (int i = 0; i < list.size(); i++) { - if (list.get(i) == Operator.LEFT_PAREN) { - done = false; - int end = findMatchingParen(list, i); - if (end < 0) { - return null; - } - Object obj = eval(list.subList(i + 1, end)); - if (obj == null) { - return null; - } - list.subList(i, i + 2).clear(); - list.set(i, obj); - } - } + private AddressSpace getBaseSpace(AddressSpace space) { + if (space instanceof OverlayAddressSpace overlaySpace) { + return overlaySpace.getOverlayedSpace(); } - - //check for leading Minus - if (list.size() > 1 && list.get(0) == Operator.MINUS) { - Object obj = list.get(1); - if (obj instanceof Long) { - obj = -((Long) obj).longValue(); - list.remove(0); - list.set(0, obj); - } - } - - //check for leading ~ - if (list.size() > 1 && list.get(0) == Operator.NOT) { - Object obj = list.get(1); - if (obj instanceof Long) { - obj = ~((Long) obj).longValue(); - list.remove(0); - list.set(0, obj); - } - } - - //check for trailing leading ~ - if (list.size() > 3 && list.get(2) == Operator.NOT) { - Object obj = list.get(3); - if (obj instanceof Long) { - obj = ~((Long) obj).longValue(); - list.remove(2); - list.set(2, obj); - } - } - - // evaluate all SHIFT because they have precedence - if (!evaluateOperator(list, Operator.RIGHTSHIFT, Operator.LEFTSHIFT)) { - return null; - } - - // evaluate all TIMES because they have precedence - if (!evaluateOperator(list, Operator.TIMES, Operator.DIVIDE)) { - return null; - } - - // evaluate Plus and Minus, same precedence, but do plus then minus - if (!evaluateOperator(list, Operator.PLUS, Operator.MINUS)) { - return null; - } - - // evaluate & ^ | - if (!evaluateOperator(list, Operator.AND, null)) { - return null; - } - if (!evaluateOperator(list, Operator.XOR, null)) { - return null; - } - if (!evaluateOperator(list, Operator.OR, null)) { - return null; - } - - if (!evaluateOperator(list, Operator.EQUALS, Operator.NOTEQUALS)) { - return null; - } - - if (!evaluateOperator(list, Operator.LESS, Operator.GREATER)) { - return null; - } - - if (!evaluateOperator(list, Operator.LESSEQUALS, Operator.GREATEREQUALS)) { - return null; - } - - if (!evaluateOperator(list, Operator.LOG_AND, null)) { - return null; - } - - if (!evaluateOperator(list, Operator.LOG_OR, null)) { - return null; - } - - if (list.size() != 1) { - return null; - } - return list.get(0); + return space; } - private static boolean evaluateOperator(List list, Operator op1, Operator op2) { - boolean done; - done = false; - while (!done) { - done = true; - for (int i = 0; i < list.size(); i++) { - Object obj = list.get(i); - if (obj == op1 || obj == op2) { - done = false; - if (i == 0 || i == list.size() - 1) { - return false; - } - Object value = computeValue(list.get(i - 1), (Operator) obj, list.get(i + 1)); - if (value == null) { - return false; - } - list.subList(i, i + 2).clear(); - list.set(i - 1, value); - } - } + private AddressSpace getAddressSpace() { + if (preferredSpace != null) { + return preferredSpace; } - return true; - } - - private static Object computeValue(Object v1, Operator op, Object v2) { - if (op == Operator.TIMES) { - if ((v1 instanceof Long) && (v2 instanceof Long)) { - return ((Long) v1).longValue() * ((Long) v2).longValue(); - } - } - if (op == Operator.DIVIDE) { - if ((v1 instanceof Long) && (v2 instanceof Long)) { - return ((Long) v1).longValue() / ((Long) v2).longValue(); - } - } - else if (op == Operator.AND) { - if ((v1 instanceof Long) && (v2 instanceof Long)) { - return ((Long) v1).longValue() & ((Long) v2).longValue(); - } - } - else if (op == Operator.XOR) { - if ((v1 instanceof Long) && (v2 instanceof Long)) { - return ((Long) v1).longValue() ^ ((Long) v2).longValue(); - } - } - else if (op == Operator.OR) { - if ((v1 instanceof Long) && (v2 instanceof Long)) { - return ((Long) v1).longValue() | ((Long) v2).longValue(); - } - } - else if (op == Operator.LEFTSHIFT) { - if ((v1 instanceof Long) && (v2 instanceof Long)) { - return ((Long) v1).longValue() << ((Long) v2).longValue(); - } - } - else if (op == Operator.RIGHTSHIFT) { - if ((v1 instanceof Long) && (v2 instanceof Long)) { - return ((Long) v1).longValue() >> ((Long) v2).longValue(); - } - } - else if (op == Operator.PLUS) { - if ((v1 instanceof Long) && (v2 instanceof Long)) { - return ((Long) v1).longValue() + ((Long) v2).longValue(); - } - else if ((v1 instanceof Address) && (v2 instanceof Long)) { - return ((Address) v1).addWrap(((Long) v2).longValue()); - } - else if ((v1 instanceof Long) && (v2 instanceof Address)) { - return ((Address) v2).addWrap(((Long) v1).longValue()); - } - } - else if (op == Operator.NOT) { - if (v2 instanceof Long) { - return ~(((Long) v2).longValue()); - } - else if (v2 instanceof Address) { - return ((Address) v2).getNewAddress(~(((Long) v2).longValue())); - } - } - else if (op == Operator.MINUS) { - if ((v1 instanceof Long) && (v2 instanceof Long)) { - return ((Long) v1).longValue() - ((Long) v2).longValue(); - } - else if ((v1 instanceof Address) && (v2 instanceof Long)) { - return ((Address) v1).subtractWrap(((Long) v2).longValue()); - } - else if ((v1 instanceof Address) && (v2 instanceof Address)) { - return ((Address) v1).subtract((Address) v2); - } - } - else if (op == Operator.EQUALS) { - Long diff = getDifference(v1, v2); - if (diff != null) { - return diff == 0L ? 1L : 0L; - } - } - else if (op == Operator.NOTEQUALS) { - Long diff = getDifference(v1, v2); - if (diff != null) { - return diff != 0L ? 1L : 0L; - } - } - else if (op == Operator.LESSEQUALS) { - Long diff = getDifference(v1, v2); - if (diff != null) { - return diff <= 0L ? 1L : 0L; - } - } - else if (op == Operator.GREATEREQUALS) { - Long diff = getDifference(v1, v2); - if (diff != null) { - return diff >= 0L ? 1L : 0L; - } - } - else if (op == Operator.LESS) { - Long diff = getDifference(v1, v2); - if (diff != null) { - return diff < 0L ? 1L : 0L; - } - } - else if (op == Operator.GREATER) { - Long diff = getDifference(v1, v2); - if (diff != null) { - return diff > 0L ? 1L : 0L; - } - } - else if (op == Operator.LOG_AND) { - if ((v1 instanceof Long) && (v2 instanceof Long)) { - boolean test = (((Long) v1).longValue()) != 0 && (((Long) v2).longValue()) != 0; - return test ? 1L : 0L; - } - } - else if (op == Operator.LOG_OR) { - if ((v1 instanceof Long) && (v2 instanceof Long)) { - boolean test = (((Long) v1).longValue()) != 0 || (((Long) v2).longValue()) != 0; - return test ? 1L : 0L; - } - } - return null; - } - - private static Long getDifference(Object v1, Object v2) { - if ((v1 instanceof Address) && (v2 instanceof Long)) { - return ((Address) v1).subtractWrap(((Long) v2).longValue()).getOffset(); - } - else if ((v1 instanceof Address) && (v2 instanceof Address)) { - return ((Address) v1).subtract((Address) v2); - } - else if ((v1 instanceof Long) && (v2 instanceof Long)) { - return ((Long) v1).longValue() - ((Long) v2).longValue(); - } - return null; - } - - private static int findMatchingParen(List list, int index) { - int depth = 1; - for (int j = index + 1; j < list.size(); j++) { - Object obj = list.get(j); - if (obj == Operator.LEFT_PAREN) { - depth++; - } - else if (obj == Operator.RIGHT_PAREN) { - if (--depth == 0) { - return j; - } - } - } - return -1; - } -} - -class Operator { - static Operator PLUS = new Operator("+"); - static Operator MINUS = new Operator("-"); - static Operator TIMES = new Operator("*"); - static Operator DIVIDE = new Operator("/"); - static Operator AND = new Operator("&"); - static Operator OR = new Operator("|"); - static Operator NOT = new Operator("~"); - static Operator XOR = new Operator("^"); - static Operator LEFTSHIFT = new Operator("<<"); - static Operator RIGHTSHIFT = new Operator(">>"); - static Operator LEFT_PAREN = new Operator("("); - static Operator RIGHT_PAREN = new Operator(")"); - static Operator LOG_OR = new Operator("||"); - static Operator LOG_AND = new Operator("&&"); - static Operator EQUALS = new Operator("=="); - static Operator NOTEQUALS = new Operator("!="); - static Operator LESS = new Operator("<"); - static Operator GREATER = new Operator(">"); - static Operator LESSEQUALS = new Operator("<="); - static Operator GREATEREQUALS = new Operator(">="); - - final String name; - - private Operator(String name) { - this.name = name; + return addressFactory.getDefaultAddressSpace(); } @Override - public String toString() { - return name; + protected ExpressionValue evaluateSymbol(String input) { + Address address = addressFactory.getAddress(input); + if (address != null) { + return new AddressExpressionValue(address); + } + + Program program = getProgram(); + if (program != null) { + return getAddressForProgram(program, input); + } + + return null; } - /** - * Gets the static object implementation of an operator. - * @param tok token string for the operator - * @return the static operator object. - */ - public static Operator getOperator(String tok) { - if (tok.equals("+")) { - return PLUS; + private ExpressionValue getAddressForProgram(Program program, String input) { + Address address = getAddressForSymbol(program, input); + if (address == null) { + address = getAddressFromMemoryMap(program, input); } - if (tok.equals("&")) { - return AND; + + return address == null ? null : new AddressExpressionValue(address); + } + + private Address getAddressFromMemoryMap(Program program, String input) { + Memory memory = program.getMemory(); + MemoryBlock block = memory.getBlock(input); + if (block != null) { + return block.getStart(); } - if (tok.equals("|")) { - return OR; + return null; + } + + private Address getAddressForSymbol(Program program, String input) { + SymbolPath symbolPath = new SymbolPath(input); + String symbolName = symbolPath.getName(); + SymbolPath parent = symbolPath.getParent(); + + Namespace namespace = null; + + if (parent != null) { + namespace = getParentNamespace(program, parent); + if (namespace == null) { + // there was a namespace specified, but not uniquely found, so can't resolve. + return null; + } } - if (tok.equals("^")) { - return XOR; + SymbolTable symbolTable = program.getSymbolTable(); + List symbols = symbolTable.getLabelOrFunctionSymbols(symbolName, namespace); + if (symbols.size() == 1) { + return symbols.get(0).getAddress(); } - else if (tok.equals("-")) { - return MINUS; + return null; + } + + private Namespace getParentNamespace(Program program, SymbolPath path) { + if (path == null) { + return null; } - else if (tok.equals("~")) { - return NOT; + List spaces = NamespaceUtils.getNamespaceByPath(program, null, path.getPath()); + if (spaces.size() == 1) { + return spaces.get(0); } - else if (tok.equals("*")) { - return TIMES; - } - else if (tok.equals("/")) { - return DIVIDE; - } - else if (tok.equals(")")) { - return RIGHT_PAREN; - } - else if (tok.equals("(")) { - return LEFT_PAREN; - } - else if (tok.equals("<<")) { - return LEFTSHIFT; - } - else if (tok.equals(">>")) { - return RIGHTSHIFT; - } - else if (tok.equals("==")) { - return EQUALS; - } - else if (tok.equals("!=")) { - return NOTEQUALS; - } - else if (tok.equals("<")) { - return LESS; - } - else if (tok.equals(">")) { - return GREATER; - } - else if (tok.equals("<=")) { - return LESSEQUALS; - } - else if (tok.equals(">=")) { - return GREATEREQUALS; - } - else if (tok.equals("||")) { - return LOG_OR; - } - else if (tok.equals("&&")) { - return LOG_AND; + return null; + } + + private Program getProgram() { + if (programReference != null) { + return programReference.get(); } return null; } diff --git a/Ghidra/Framework/SoftwareModeling/src/main/java/ghidra/program/util/AddressExpressionValue.java b/Ghidra/Framework/SoftwareModeling/src/main/java/ghidra/program/util/AddressExpressionValue.java new file mode 100644 index 0000000000..143931d8a7 --- /dev/null +++ b/Ghidra/Framework/SoftwareModeling/src/main/java/ghidra/program/util/AddressExpressionValue.java @@ -0,0 +1,167 @@ +/* ### + * IP: GHIDRA + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package ghidra.program.util; + +import generic.expressions.*; +import ghidra.program.model.address.Address; + +/** + * Address operand values. See {@link ExpressionValue}. Defines supported operators and other + * operands for expression values that are addresses. + */ +public class AddressExpressionValue implements ExpressionValue { + private Address value; + + public AddressExpressionValue(Address address) { + this.value = address; + } + + @Override + public ExpressionValue applyUnaryOperator(ExpressionOperator operator) throws ExpressionException { + long offset = value.getOffset(); + switch (operator) { + case BITWISE_NOT: + return addressExpressionOf(~offset); + case UNARY_MINUS: + return addressExpressionOf(-offset); + case UNARY_PLUS: + return this; + default: + throw new ExpressionException( + "Unary Operator " + operator + " not supported by Long values!"); + } + } + + private AddressExpressionValue addressExpressionOf(long offset) { + Address address = value.getNewAddress(offset); + return new AddressExpressionValue(addressOf(offset)); + } + + private AddressExpressionValue addressExpressionOf(Address address) { + return new AddressExpressionValue(address); + } + + private Address addressOf(long offset) { + return value.getNewAddress(offset); + } + + @Override + public ExpressionValue applyBinaryOperator(ExpressionOperator operator, ExpressionValue operand) + throws ExpressionException { + + if (operand instanceof LongExpressionValue longOperand) { + return applyBinaryOperator(operator, longOperand); + } + + if (operand instanceof AddressExpressionValue addressOperand) { + return applyBinaryOperator(operator, addressOperand); + } + throw new ExpressionException("Unsupported operand type for Long: " + value); + + } + + private ExpressionValue applyBinaryOperator(ExpressionOperator operator, + LongExpressionValue expressionValue) throws ExpressionException { + long otherValue = expressionValue.getLongValue(); + long offset = value.getOffset(); + int compareResult = Long.compareUnsigned(offset, otherValue); + + switch (operator) { + case BITWISE_AND: + return addressExpressionOf(offset & otherValue); + case BITWISE_OR: + return addressExpressionOf(offset | otherValue); + case BITWISE_XOR: + return addressExpressionOf(offset ^ otherValue); + case DIVIDE: + return addressExpressionOf(offset / otherValue); + case SUBTRACT: + return addressExpressionOf(value.subtract(otherValue)); + case ADD: + return addressExpressionOf(value.add(otherValue)); + case MULTIPLY: + return addressExpressionOf(offset * otherValue); + case SHIFT_LEFT: + return addressExpressionOf(offset << otherValue); + case SHIFT_RIGHT: + return addressExpressionOf(offset >> otherValue); + case EQUALS: + return booleanExpression(compareResult == 0); + case GREATER_THAN: + return booleanExpression(compareResult > 0); + case LESS_THAN: + return booleanExpression(compareResult < 0); + case GREATER_THAN_OR_EQUAL: + return booleanExpression(compareResult >= 0); + case LESS_THAN_OR_EQUAL: + return booleanExpression(compareResult <= 0); + + default: + throw new ExpressionException( + "Binary Operator \"" + operator + + "\" with Long operands not supported by Address values!"); + } + } + + private ExpressionValue booleanExpression(boolean b) { + return new LongExpressionValue(b ? 1 : 0); + } + + private ExpressionValue applyBinaryOperator(ExpressionOperator operator, + AddressExpressionValue expressionValue) throws ExpressionException { + Address otherValue = expressionValue.getAddress(); + long otherValueOffset = otherValue.getOffset(); + long offset = value.getOffset(); + int compareResult = value.compareTo(otherValue); + + switch (operator) { + case BITWISE_AND: + return new LongExpressionValue(offset & otherValueOffset); + case BITWISE_OR: + return new LongExpressionValue(offset | otherValueOffset); + case BITWISE_XOR: + return new LongExpressionValue(offset ^ otherValueOffset); + case SUBTRACT: + return new LongExpressionValue(value.subtract(otherValue)); + case ADD: + return new LongExpressionValue(offset + otherValueOffset); + case EQUALS: + return booleanExpression(compareResult == 0); + case GREATER_THAN: + return booleanExpression(compareResult > 0); + case LESS_THAN: + return booleanExpression(compareResult < 0); + case GREATER_THAN_OR_EQUAL: + return booleanExpression(compareResult >= 0); + case LESS_THAN_OR_EQUAL: + return booleanExpression(compareResult <= 0); + default: + throw new ExpressionException( + "Binary Operator \"" + operator + + "\" with Long operands not supported by Address values!"); + } + } + + public Address getAddress() { + return value; + } + + @Override + public String toString() { + return value.toString(); + } + +} diff --git a/Ghidra/Processors/Atmel/ghidra_scripts/CreateAVR8GDTArchiveScript.java b/Ghidra/Processors/Atmel/ghidra_scripts/CreateAVR8GDTArchiveScript.java index 22f1645005..781ece80ee 100644 --- a/Ghidra/Processors/Atmel/ghidra_scripts/CreateAVR8GDTArchiveScript.java +++ b/Ghidra/Processors/Atmel/ghidra_scripts/CreateAVR8GDTArchiveScript.java @@ -27,6 +27,7 @@ import java.util.Iterator; import org.bouncycastle.util.Arrays; +import generic.expressions.ExpressionEvaluator; import generic.jar.ResourceFile; import ghidra.app.plugin.core.datamgr.util.DataTypeArchiveUtility; import ghidra.app.script.GhidraScript; @@ -35,7 +36,6 @@ import ghidra.app.util.cparser.C.CParserUtils.CParseResults; import ghidra.app.util.cparser.CPP.*; import ghidra.program.model.data.DataTypeManager; import ghidra.program.model.data.FileDataTypeManager; -import ghidra.program.util.AddressEvaluator; import ghidra.util.Msg; public class CreateAVR8GDTArchiveScript extends GhidraScript { @@ -230,7 +230,7 @@ public class CreateAVR8GDTArchiveScript extends GhidraScript { continue; } - lvalue = AddressEvaluator.evaluateToLong(expandValue); + lvalue = ExpressionEvaluator.evaluateToLong(expandValue); if (lvalue == null) { continue; } diff --git a/Ghidra/Test/IntegrationTest/src/screen/java/help/screenshot/MemoryMapPluginScreenShots.java b/Ghidra/Test/IntegrationTest/src/screen/java/help/screenshot/MemoryMapPluginScreenShots.java index 8122eb972d..3e288f9db2 100644 --- a/Ghidra/Test/IntegrationTest/src/screen/java/help/screenshot/MemoryMapPluginScreenShots.java +++ b/Ghidra/Test/IntegrationTest/src/screen/java/help/screenshot/MemoryMapPluginScreenShots.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -140,7 +140,7 @@ public class MemoryMapPluginScreenShots extends GhidraScreenShotGenerator { DialogComponentProvider dialog = getDialog(); GhidraComboBox comboBox = (GhidraComboBox) getInstanceField("comboBox", dialog); selectItem(comboBox, "Byte Mapped"); - + runSwing(() -> dialog.setStatusText("")); captureDialog(); drawRectangleAround(comboBox, Palette.GREEN, 10);