mirror of
https://github.com/NationalSecurityAgency/ghidra.git
synced 2026-08-08 07:40:39 -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.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
|
||||
|
||||
@@ -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><GhidraInstallDir></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>
|
||||
|
||||
@@ -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|
|
||||
|
||||
Reference in New Issue
Block a user