mirror of
https://github.com/NationalSecurityAgency/ghidra.git
synced 2026-09-19 16:40:38 -09:00
GT-2362: Improving guidance on dealing with HiDPI monitors in Linux
(#1). Also no longer recommending official OpenJDK 11 since it's not LTS. Recommending AdoptOpenJDK or Amazon Corretto.
This commit is contained in:
@@ -21,7 +21,8 @@ VMARGS=-Duser.variant=
|
|||||||
VMARGS=-Dsun.java2d.pmoffscreen=false
|
VMARGS=-Dsun.java2d.pmoffscreen=false
|
||||||
VMARGS=-Dsun.java2d.opengl=false
|
VMARGS=-Dsun.java2d.opengl=false
|
||||||
|
|
||||||
# Resolves issue with Ubuntu when running within VM
|
# Setting to false resolves issue with Ubuntu when running within VM.
|
||||||
|
# Setting to true resolves display issues on HiDPI monitors in Linux.
|
||||||
VMARGS=-Dsun.java2d.xrender=false
|
VMARGS=-Dsun.java2d.xrender=false
|
||||||
|
|
||||||
# Set acceptable HTTPS protocols
|
# Set acceptable HTTPS protocols
|
||||||
|
|||||||
@@ -18,7 +18,7 @@
|
|||||||
|
|
||||||
<h1>Ghidra Installation Guide</h1>
|
<h1>Ghidra Installation Guide</h1>
|
||||||
<p>
|
<p>
|
||||||
The installation information provided is effective as of Ghidra 9.0.1 and is subject to change with
|
The installation information provided is effective as of Ghidra 9.0.3 and is subject to change with
|
||||||
future releases.
|
future releases.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
@@ -83,7 +83,17 @@ Ghidra team if you have a specific need.</p></blockquote>
|
|||||||
<ul>
|
<ul>
|
||||||
<li>Java 11 Runtime and Development Kit (JDK) (see <a href="#JavaNotes">Java Notes</a>)</li>
|
<li>Java 11 Runtime and Development Kit (JDK) (see <a href="#JavaNotes">Java Notes</a>)</li>
|
||||||
<ul>
|
<ul>
|
||||||
<li>OpenJDK distributed from <i>jdk.java.net</i> is suggested</i></li>
|
<li>Free long term support (LTS) versions of JDK 11 are provided by:</li>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
<a href="https://adoptopenjdk.net/releases.html?variant=openjdk11&jvmVariant=hotspot">
|
||||||
|
AdoptOpenJDK</a>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<a href="https://docs.aws.amazon.com/corretto/latest/corretto-11-ug/downloads-list.html">
|
||||||
|
Amazon Corretto</a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
</ul>
|
</ul>
|
||||||
</ul>
|
</ul>
|
||||||
<p>(<a href="#top">Back to Top</a>)</p>
|
<p>(<a href="#top">Back to Top</a>)</p>
|
||||||
@@ -128,14 +138,10 @@ destination using any unzip program (built-in OS utilities, 7-Zip, WinZip, WinRA
|
|||||||
the parent directory of Java's <i>bin</i> directory). This minimizes the impact Ghidra has on
|
the parent directory of Java's <i>bin</i> directory). This minimizes the impact Ghidra has on
|
||||||
pre-existing configurations of Java that other software may rely on.
|
pre-existing configurations of Java that other software may rely on.
|
||||||
</li>
|
</li>
|
||||||
<li>
|
|
||||||
Ghidra is developed and tested against OpenJDK distributed from <i>jdk.java.net</i>. Consider
|
|
||||||
using this OpenJDK distribution for the most stable experience.
|
|
||||||
</li>
|
|
||||||
<li>
|
<li>
|
||||||
If Ghidra failed to run because <i>no versions</i> of Java were on the PATH, a
|
If Ghidra failed to run because <i>no versions</i> of Java were on the PATH, a
|
||||||
<a href="#Requirements">supported</a> JDK should be manually installed and added to the
|
<a href="#Requirements">supported</a> JDK should be manually installed and added to the
|
||||||
PATH. The following steps outline how to add an OpenJDK distribution to the operating system's
|
PATH. The following steps outline how to add a JDK distribution to the operating system's
|
||||||
PATH.
|
PATH.
|
||||||
<ul>
|
<ul>
|
||||||
<li>
|
<li>
|
||||||
@@ -545,13 +551,13 @@ be installed in a pre-existing Eclipse installation.</p>
|
|||||||
<h3><a name="LinuxIssues"></a>Linux</h3>
|
<h3><a name="LinuxIssues"></a>Linux</h3>
|
||||||
<ul>
|
<ul>
|
||||||
<li>
|
<li>
|
||||||
Some users have reported Ghidra GUI rendering issues on 4k displays and multi-monitor thin
|
Ghidra may not display correctly on Linux systems with HiDPI monitors. Setting
|
||||||
client setups. These problems are attributed to reported bugs in Java. Upgrading to a newer
|
<i>VMARGS=-Dsun.java2d.xrender=false</i> to <i><b>true</b></i> in
|
||||||
version of Java may fix the issue.
|
<i><GhidraInstallDir></i>/support/launch.properties has been known to improve this issue.
|
||||||
</li>
|
|
||||||
<li>
|
<li>
|
||||||
At the time of writing, installing the openjdk-11 package in Ubuntu 18.04 results in openjdk-10
|
Some users have reported Ghidra GUI rendering issues on multi-monitor thin client setups.
|
||||||
being installed which is incompatible with Ghidra.
|
These problems are attributed to reported bugs in Java, which will hopefully be fixed in the
|
||||||
|
future. Disabling the 2nd or 3rd monitor may be necessary to work around the issue.
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
<h3><a name="MacOSIssues"></a>macOS (OS X)</h3>
|
<h3><a name="MacOSIssues"></a>macOS (OS X)</h3>
|
||||||
|
|||||||
@@ -1,11 +1,11 @@
|
|||||||
##VERSION: 2.0
|
##VERSION: 2.0
|
||||||
##MODULE IP: Creative Commons Attribution 2.5
|
##MODULE IP: Creative Commons Attribution 2.5
|
||||||
##MODULE IP: LGPL 2.1
|
|
||||||
##MODULE IP: Nuvola Icons - LGPL 2.1
|
|
||||||
##MODULE IP: Modified Nuvola Icons - LGPL 2.1
|
|
||||||
##MODULE IP: Tango Icons - Public Domain
|
|
||||||
##MODULE IP: FAMFAMFAM Icons - CC 2.5
|
##MODULE IP: FAMFAMFAM Icons - CC 2.5
|
||||||
|
##MODULE IP: LGPL 2.1
|
||||||
|
##MODULE IP: Modified Nuvola Icons - LGPL 2.1
|
||||||
|
##MODULE IP: Nuvola Icons - LGPL 2.1
|
||||||
##MODULE IP: Public Domain
|
##MODULE IP: Public Domain
|
||||||
|
##MODULE IP: Tango Icons - Public Domain
|
||||||
.classpath||GHIDRA||||END|
|
.classpath||GHIDRA||||END|
|
||||||
.project||GHIDRA||||END|
|
.project||GHIDRA||||END|
|
||||||
CheatSheet.html||GHIDRA||||END|
|
CheatSheet.html||GHIDRA||||END|
|
||||||
|
|||||||
Reference in New Issue
Block a user