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:
Ryan Kurtz
2019-04-26 09:47:30 -04:00
parent 8c3a79deb1
commit a7026ecb9b
3 changed files with 25 additions and 18 deletions

View File

@@ -21,7 +21,8 @@ VMARGS=-Duser.variant=
VMARGS=-Dsun.java2d.pmoffscreen=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
# Set acceptable HTTPS protocols

View File

@@ -18,7 +18,7 @@
<h1>Ghidra Installation Guide</h1>
<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.
</p>
@@ -83,7 +83,17 @@ Ghidra team if you have a specific need.</p></blockquote>
<ul>
<li>Java 11 Runtime and Development Kit (JDK) (see <a href="#JavaNotes">Java Notes</a>)</li>
<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>
<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
pre-existing configurations of Java that other software may rely on.
</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>
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
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.
<ul>
<li>
@@ -545,13 +551,13 @@ be installed in a pre-existing Eclipse installation.</p>
<h3><a name="LinuxIssues"></a>Linux</h3>
<ul>
<li>
Some users have reported Ghidra GUI rendering issues on 4k displays and multi-monitor thin
client setups. These problems are attributed to reported bugs in Java. Upgrading to a newer
version of Java may fix the issue.
</li>
Ghidra may not display correctly on Linux systems with HiDPI monitors. Setting
<i>VMARGS=-Dsun.java2d.xrender=false</i> to <i><b>true</b></i> in
<i>&lt;GhidraInstallDir&gt;</i>/support/launch.properties has been known to improve this issue.
<li>
At the time of writing, installing the openjdk-11 package in Ubuntu 18.04 results in openjdk-10
being installed which is incompatible with Ghidra.
Some users have reported Ghidra GUI rendering issues on multi-monitor thin client setups.
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>
</ul>
<h3><a name="MacOSIssues"></a>macOS (OS X)</h3>

View File

@@ -1,11 +1,11 @@
##VERSION: 2.0
##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: LGPL 2.1
##MODULE IP: Modified Nuvola Icons - LGPL 2.1
##MODULE IP: Nuvola Icons - LGPL 2.1
##MODULE IP: Public Domain
##MODULE IP: Tango Icons - Public Domain
.classpath||GHIDRA||||END|
.project||GHIDRA||||END|
CheatSheet.html||GHIDRA||||END|