diff --git a/Ghidra/Configurations/Public_Release/src/global/docs/ChangeHistory.html b/Ghidra/Configurations/Public_Release/src/global/docs/ChangeHistory.html index 678df44d79..0ed26c875b 100644 --- a/Ghidra/Configurations/Public_Release/src/global/docs/ChangeHistory.html +++ b/Ghidra/Configurations/Public_Release/src/global/docs/ChangeHistory.html @@ -7,13 +7,14 @@ -

Ghidra 10.0 BETA Change History (May 2021)

+

Ghidra 10.0 Change History (June 2021)

New Features

@@ -32,11 +33,12 @@
  • Build. Command gradle -I gradle/support/fetchDependencies.gradle init now downloads the Function ID datasets from the ghidra-data GitHub repository so they will be automatically included in development mode and custom builds. (GP-678, Issue #1007)
  • Build. Performing a gradle clean no longer deletes downloaded dependencies. The top-level flatRepo directory has been replaced with the dependencies directory. (GP-811, Issue #1663)
  • Build. Ghidra now requires Gradle 6.0 or later to build. Gradle 7.x is now supported. (GP-849, Issue #2949)
    • +
  • Build. Made changes to gradle code to remove warnings. (GP-993, Issue #3039)
  • Data Types. Added support for hexadecimal byte offset display within composite bitfield view. (GP-910, Issue #2959)
  • Decompiler. Decompiler analysis now automatically identifies and displays loop variables using standard for-loop syntax. When a loop variable is discovered, a condition, iteration, and optional initializer statement are displayed at the top of the loop. (GP-565)
    • -
  • Decompiler. Added the Max Instructions per Function Decompiler tool option, specifying the maximum number of instructions the Decompiler will decode in a single function before throwing an exception. Previously this, had been a hard-coded limit. (GP-767, Issue #2557)
    • +
  • Decompiler. Added the Max Instructions per Function Decompiler tool option, specifying the maximum number of instructions the Decompiler will decode in a single function before throwing an exception. Previously, this had been a hard-coded limit. (GP-767, Issue #2557)
  • Decompiler. The Decompiler now propagates datatypes across signed comparison operations, so constant integer and enum values display correctly. (GP-802, Issue #2565)
    • -
  • Demangler. Updated the Gnu Demangler Analyzer options to provide a list of available formats from which to choose. (GP-94, Issue #2214)
    • +
  • Demangler. Updated the GNU Demangler Analyzer options to provide a list of available formats from which to choose. (GP-94, Issue #2214)
  • Demangler. Updated the GNU Demangler's Namespace-building to improve analysis performance. (GP-706, Issue #2509)
  • Demangler. Improved Demangler error checking and reporting to give underlying cause of failure. (GP-850)
  • Documentation. Added basic instructions on how to install, build, and develop Ghidra to README.md. (GP-847)
    • @@ -55,8 +57,9 @@
  • Graphing. Updated Function Graph edge routing when applying the Use Condensed Layout option to reduce edges being clipped by vertices. (GP-768)
  • Graphing. Added option to disable the lightening of edges in the Function Graph. (GP-769, Issue #1106)
  • Graphing. Added a distinct visual edge highlight beyond just a different color for graph edge selection. (GP-793, Issue #2953)
    • -
  • Graphing. Added Display as Graph action to the Datatype Manager, allowing visualization of embedded and referenced types of the selected type(s). (GP-808)
    • -
  • Graphing. Fixed function graph bug that prevented the satellite view from showing the primary view lens. Fixed a layout bug that allowed from some vertices to get clipped when condensing the graph. (GP-940)
    • +
  • Graphing. Added Display as Graph action to the Data Type Manager, allowing visualization of embedded and referenced types of the selected types. (GP-808)
    • +
  • Graphing. Fixed function graph bug that prevented the satellite view from showing the primary view lens. Fixed a layout bug that allowed some vertices to get clipped when condensing the graph. (GP-940)
    • +
  • Graphing. Added graph API method to set descriptions (tooltips) on vertices and edges. (GP-949)
  • Graphing. Added Vertex and Edge attributes to GraphML export format. (GP-957, Issue #2958)
  • GUI. Added new Copy Special actions: Python Byte String, Python List, and C Array. (GP-210, Issue #744)
  • GUI. Updated the Listing to allow structure members to display Plate Comments. (GP-421, Issue #2091)
    • @@ -64,20 +67,23 @@
  • GUI. Added right-click menu Data -> Save Image action to allow user to export embedded graphic resource images. (GP-426)
  • GUI. Changed Symbol Comment Annotation to use the existing symbol when available. This allows for the direct navigation of that symbol's address instead of using the search feature of the Go To Service. (GP-675)
  • GUI. Added the Shift-F10 keybinding to allow users to show the popup context menu over the currently focused item. The Menu Key can also be used on supporting keyboards. (GP-732, Issue #2790)
    • -
  • GUI. Fixed/Improved the behavior of global menu items and toolbar items with respect to which windows they appear in. These actions can now easily be configured to be either 1) only in menu bar and tool bar of the main window, 2) in the menu bar and tool bar of all windows, or 3) only the windows that have components that generate the type of context that the action consumes. Added methods to the ActionBuilder class to support these three options. Also, updated numerous actions to make sure they appear in the appropriate windows. (GP-759)
    • +
  • GUI. Fixed/Improved the behavior of global menu items and toolbar items with respect to which windows they appear in. These actions can now easily be configured to be either 1) only in menu bar and tool bar of the main window, 2) in the menu bar and tool bar of all windows, or 3) only in the windows that have components that generate the type of context that the action consumes. Added methods to the ActionBuilder class to support these three options. Also, updated numerous actions to make sure they appear in the appropriate windows. (GP-759)
  • GUI. Improved overall UI responsiveness when performing analysis with the Symbol Table open. (GP-788)
  • GUI. Updated the Function Tags table column so that it may be used in most Ghidra tables. (GP-816, Issue #2873)
  • GUI. Updated the Defined Strings view to reload less frequently during auto-analysis. (GP-835, Issue #2889)
  • GUI. Updated function hovering in the Decompiler to find the correct function tooltip when multiple functions exist with the same name. (GP-959, Issue #2604)
  • Importer:ELF. Added markup to ELF import for .note.gnu.build-id and .gnu_debuglink sections. (GP-468)
  • Importer:ELF. Added ELF import support for SHN_MIPS_TEXT and SHN_MIPS_DATA symbol section index values and provided ability for other processor-specific ELF extensions to resolve ELF symbol memory addresses. (GP-664)
    • +
  • Importer:ELF. Changed various ELF relocations to detect and mark unsupported data relocations which refer to the EXTERNAL block. Applied EXTERNAL data relocations, which have a non-zero offset from the external symbol, will still be incorrect but will have an error bookmark to flag the condition. The relocation addend will not be applied in this case to avoid references to a completely irrelevant symbol in the EXTERNAL block. (GP-1029)
  • Importer:Mach-O. Improved support for Mach-O object files. (GP-700)
  • Importer:PE. CustomAttrib blobs in CLI/.NET metadata are now decoded. (GP-414)
  • Importer:PE. Created proper external references for PE Delay Load Imports. (GP-674, Issue #2554, #2623)
  • Importer:PE. PeLoader can now read and interpret the .pdata section of PE files that include exception handling data. (GP-729)
    • +
  • Importer:PE. Added .exports XML files for the mfc71.dll and mfc71u.dll libraries. Having them allows Ghidra to translate ordinal imports from applications compiled against MFC 7.1 (from Visual Studio .NET 2003) to class and function names with parameters. (GP-1010, Issue #3051)
  • Listing. Improved Listing view performance, especially noticeable on functions with excessively large stack frames. (GP-268, Issue #109, #2351)
  • Listing. Added a tool option to hide function auto-comments that appear, trailing a function call in the Listing. (GP-752)
  • PDB. Improved Ghidra's ability to find and pull PDB files from symbol servers and symbol storage locations. (GP-42)
    • +
  • Processors. Simplified PIC24 return instruction semantics. (GP-647)
  • Processors. Added support for register alias specification within processor spec (*.pspec). Added WREG register aliases for PIC24 processor variants. (GP-901, Issue #2956)
  • Processors. Fixed issue with the PPAGE register not being properly restored after CALL instructions in the HCS12 processor. (GP-920, Issue #1099)
  • Processors. Fixed HCS12 IDX1 addressing with negative immediate values. (GP-937, Issue #3008)
    • @@ -87,8 +93,10 @@
  • Scripting. Improved TableChooserDialog, allowing multiple rows to be processed at once. (GP-676)
  • Scripting. Updated the TableChooserDialog to allow clients to set the default column sort. (GP-792)
  • Scripting. Added Python script comment block support. (GP-843, Issue #1484, #2846)
    • +
  • Scripting. Added ApplyClassFunctionSignatureUpdatesScript and ApplyClassFunctionDefinitionUpdatesScript fix-up scripts that can be applied if a user makes changes to a virtual function recovered by the RecoverClassesFromRTTIScript. Both scripts identify differences between Function Signatures in the Listing and Function Definitions in the Data Type Manager, but the first script fixes all changes to match the signature and the second to match the definition. (GP-973, Issue #3081)
  • Sleigh. Debug info for Sleigh constructors now includes source file names. (GP-233)
  • Sleigh. The Sleigh compiler now issues a warning if it generates a temporary varnode which might be large enough to overlap another temporary varnode. (GP-520)
    • +
  • Sleigh. While register names should remain case-sensitive within a Sleigh spec during compilation/parse, register names must not duplicate in a case-insensitive manner since the Program API provides a case-insensitive register lookup by name. The Sleigh Compiler now enforces this. (GP-927)

    • Bugs

    @@ -102,17 +110,20 @@
  • Assembler. Fixed assemble Patch Instruction action to work on listings other than the primary static listing. (GP-623)
  • Assembler. Modified assembler Patch Instruction action to ignore external symbols which produced bad offsets for instructions. (GP-645)
  • Basic Infrastructure. Fixed an issue with Ghidra and its supporting launch scripts not being able to run correctly on Windows when an ampersand was in the path. Also fixed an issue with svrAdmin.bat and buildGhidraJar.bat not working if the Ghidra path contained a space. (GP-693, Issue #1726, #1728)
    • +
  • Basic Infrastructure. Corrected "LaunchSupport expected 2 to 4 arguments but got 1" error when starting Ghidra on Windows. (GP-1050, Issue #2176, #3122)
  • Build. Building of pdb.exe on Windows now works if the path to the Ghidra repository contains a space. (GP-916, Issue #2998)
  • Build. Corrected GPL DMG module build to properly utilize the jar dependencies included within the repository and distribution. (GP-934)
    • +
  • Build. Corrected an issue with gradle prepDev when the Ghidra repository is on a different drive than the user's home directory on Windows OS. (GP-970, Issue #3047, #3062)
    • +
  • Build. Fixed a bug that prevented Ghidra from launching in Single Jar Mode when its path contained a space. (GP-1039)
  • C Parsing. The C-Parser bitfield parsing has been relaxed to allow declared bitfield sizes to exceed the base datatype size. The effective bitfield size may be clamped based upon the current data organization while preserving the declared size. (GP-558)
    • -
  • Data Types. Fixed a NullPointerException that occurred when trying to edit a function data type in a data type archive when there was no open program in the tool. (GP-356, Issue #2407)
    • +
  • Data Types. Fixed a NullPointerException that occurred when trying to edit a function datatype in a datatype archive when there was no open program in the tool. (GP-356, Issue #2407)
  • Data Types. Corrected the retention of datatype archive search paths, which did not properly remember disabled paths. (GP-639)
  • Data Types. Fixed potential deadlock encountered when working with the DataTypes tree. (GP-774, Issue #2832)
  • Decompiler. Fixed endianess issue for joined, two-register returns of longlong values for MIPS 32-bit little endian variants. (GP-513)
  • Decompiler. The Decompiler no longer emits comments in the middle of conditional expressions. (GP-621, Issue #1670)
    • -
  • Decompiler. Fixed Redefinition of structure ... exceptions in the Decompiler caused by a PNG Image and other opaque datatypes. (GP-820, Issue #2734)
    • +
  • Decompiler. Fixed Redefinition of structure... exceptions in the Decompiler caused by a PNG Image and other opaque datatypes. (GP-820, Issue #2734)
  • Decompiler. Fixed infinite loop in the Decompiler when analyzing return values. (GP-821, Issue #2851)
    • -
  • Decompiler. Fixed bug in the Decompiler's handling of enumerated data types causing Shared type id exceptions. (GP-895, Issue #2909)
    • +
  • Decompiler. Fixed bug in the Decompiler's handling of enumerated datatypes causing Shared type id exceptions. (GP-895, Issue #2909)
  • DWARF. Fixed and consolidated DEX and DWARF implementations of LEB128. (GP-444, Issue #2512)
  • DWARF. Fixed unnecessary ELF header parsing when DWARF analyzer checks if it needs to run. Improved DWARF analyzer's run-once logic. (GP-695)
  • DWARF. Fixed issue with DWARF data type importing that could omit the definition of a structure. (GP-929)
    • @@ -132,13 +143,19 @@
  • GUI. Fixed Function Graph bug that caused some vertex text to get clipped when using wide address format width. (GP-755, Issue #1008)
  • GUI. Fixed bug in the Listing scroll bar that caused some screen reader software to deadlock. (GP-772, Issue #2820)
  • GUI. Fixed bug that caused the UI to freeze when clicking in the Program Tree UI. The bug manifested depending upon the contents of the system clipboard. (GP-775)
    • +
  • GUI. Updated tooltip code to limit data types name length and updated formatting to place pertinent information at the top of the tooltip. (GP-836, Issue #2029)
    • +
  • GUI. Fixed exception triggered when the Bookmarks table failed to remove a deleted symbol. (GP-989, Issue #3066)
    • +
  • GUI. Fixed exception encountered when double-clicking a structure in an archive in the closed for edit state. (GP-998)
    • +
  • GUI. Fixed Function Graph stack trace encountered when changing the graph's background color option after showing and then closing the graph. (GP-1013, Issue #3058)
  • Importer:ELF. Added support for additional PIC30 ELF relocations (4, 5, 6) and improved register symbol resolution and markup. (GP-710, Issue #2792)
  • Importer:ELF. Changed processing of ELF absolute symbols (section ID 0xfff1) to treat them as constants by defining equates instead of memory symbols. (GP-902)
  • Importer:ELF. Corrected EXTERNAL symbol alignment for PIC24, PIC30, PIC33 during ELF import. The improperly aligned symbol addresses would cause incorrect external symbol references to appear on instructions (e.g., RCALL). (GP-906)
  • Importer:PE. Fixed error when importing a PE file with an uninitialized .textbss section. (GP-397, Issue #2496)
  • Importer:PE. Fixed a bug processing RUNTIME_INFO structures that caused a failure to load PE files under certain conditions when the list is empty. (GP-924, Issue #2995)
    • +
  • Importer:PE. Fixed an issue in the PeLoader that prevented PE files with 0 data directories from being imported. (GP-997, Issue #2858)
  • Installation. Renamed database db.Record class to db.DBRecord to avoid naming conflict with java.lang.Record class and potential import issues. (GP-193)
  • Jython. Fixed pasting multi-line strings into the Python interpreter panel. (GP-487, Issue #2456)
    • +
  • Listing. A default thunk function now reflects the namespace of the thunked function similar to the way it reflects its name. This change also allows thunk functions of a this_call to have the correct this pointer parameter. Symbol table queries based upon name and/or namespace will always exclude default thunk functions. (GP-17)
  • Listing. Fixed #US table processing to correctly interpret the string as UTF-16LE for CIL binaries. (GP-318)
  • Listing. Fixed a sporadic listing operand hover stacktrace bug. (GP-987)
  • PDB. Escaped more character strings in MSDIA pdb.exe XML output. (GP-578, Issue #1690)
    • @@ -147,7 +164,7 @@
  • Processors. Fixed issue with ARM VMRS instruction parsing in thumb. (GP-735, Issue #2750)
  • Processors. Corrected issue with M68000 floating point dynamic k-factor instruction semantics. (GP-736, Issue #2754)
  • Processors. Fixed instruction semantics for x86 MOVUPS instruction. (GP-744, Issue #2789)
    • -
  • Processors. Simplified SuperH div1 instruction. (GP-753, Issue #2864)
    • +
  • Processors. Simplified SuperH div1 instruction. Corrected several SuperH instructions to set flags properly around the delay slot. (GP-753, Issue #2863, #2864)
  • Processors. Corrected issue with ARM co-processor registers and the MCR instruction. (GP-761, Issue #2451)
  • Processors. Fixed issued with x86 INSx.rep and OUTSx.rep pcode ordering. (GP-766, Issue #2829)
  • Processors. Corrected addresses for PIC24 TBLPAG and PSVPAG registers. (GP-798, Issue #2844, #2855)
    • @@ -155,7 +172,13 @@
  • Processors. Updated 8085 processor definition to disassemble XRA HL instruction. (GP-818, Issue #2447)
  • Processors. Corrected missing optional rex.w prefix for x86 conditional jump instructions. (GP-837, Issue #1163)
  • Processors. Added CALLW, ASRF, LSLF, and LSRF instructions to PIC16 language. (GP-841, Issue #1362)
    • +
  • Processors. Fixed ARM Thumb instructions which update the status flags to now correctly append an s to the instruction mnemonic. (GP-881)
  • Processors. Made corrections to wr instruction for SPARC which in some cases did not write to the appropriate ASR register. (GP-928)
    • +
  • Processors. Corrected issue with x86-64 CALL and RET instructions with 0x67 prefix pushing/popping the wrong address size from the stack. (GP-954, Issue #2976)
    • +
  • Processors. Fixed issue with delay slots modifying some instructions in SuperH processor. (GP-969, Issue #2863)
    • +
  • Processors. Corrected pcode for x86-64 RDMSR instruction. (GP-982, Issue #3046)
    • +
  • Processors. Corrected size of 20-bit signed immediate value in PPC VLE e_li instruction. (GP-1060)
    • +
  • Scripting. Fixed scripting bug where showing a TableChooserDialog while having AnalysisMode.DISABLED in use caused the dialog to be closed. (GP-1018, Issue #3103)
  • Sleigh. Fixed multiple errors in x64 vector operation semantics. (GP-799)
    • diff --git a/Ghidra/Configurations/Public_Release/src/global/docs/WhatsNew.html b/Ghidra/Configurations/Public_Release/src/global/docs/WhatsNew.html index 3a6c25d342..232fc20470 100644 --- a/Ghidra/Configurations/Public_Release/src/global/docs/WhatsNew.html +++ b/Ghidra/Configurations/Public_Release/src/global/docs/WhatsNew.html @@ -6,8 +6,9 @@