mirror of
https://github.com/NationalSecurityAgency/ghidra.git
synced 2024-11-21 19:42:14 +00:00
GP-4895: Fixing old mentions of $HOME/.ghidra/.ghidra_<version>
This commit is contained in:
Ryan Kurtz
parent
c8a455e197
commit
e59a6ed7ea
@ -57,12 +57,16 @@
|
||||
<em>source bundle</em>. When enabled, its Java contents are compiled to
|
||||
</p>
|
||||
<pre>
|
||||
<user home>/.ghidra/.ghidra-<version>/osgi/compiled-bundles/<hash>/
|
||||
<user settings>/osgi/compiled-bundles/<hash>/
|
||||
</pre>
|
||||
<p>
|
||||
where <code><hash></code> is a hash of the source bundle path. These compiled artifacts are then loaded
|
||||
by the OSGi framework.
|
||||
</p>
|
||||
<p><b>NOTE: </b> The <code><user settings></code> directory is platform/configuration
|
||||
specific. Its value can be found in the Ghidra Front End GUI, under <code>Help ->
|
||||
Runtime Information -> Application Layout -> Settings Directory</code>
|
||||
</p>
|
||||
|
||||
|
||||
<h3>Exploded Bundles</h3>
|
||||
@ -71,7 +75,7 @@
|
||||
Each such subdirectory of <code>compiled-bundles/</code> is an <em>exploded
|
||||
jar</em> -- by compressing it, we get a standard OSGi Jar bundle:</p>
|
||||
<pre>
|
||||
jar cMf mybundle.jar -C $HOME/.ghidra/.ghidra_<version>/osgi/compiled-bundles/<hash> .
|
||||
jar cMf mybundle.jar -C <user settings>/osgi/compiled-bundles/<hash> .
|
||||
</pre>
|
||||
</blockquote>
|
||||
|
||||
@ -195,12 +199,12 @@
|
||||
in the `Import-Package` line of the manifest generated for <code>my_ghidra_scripts</code>:
|
||||
</p>
|
||||
<pre>
|
||||
<user home>/.ghidra/.ghidra-<version>/osgi/compiled-bundles/ab12cd89/META-INF/MANIFEST.MF:
|
||||
<user settings>/osgi/compiled-bundles/ab12cd89/META-INF/MANIFEST.MF:
|
||||
Manifest-Version: 1.0
|
||||
Bundle-ManifestVersion: 2
|
||||
Export-Package: mylib
|
||||
Import-Package: ghidra.app.script,yourlib,ghidra.app.plugin.core.osgi
|
||||
Require-Capability: osgi.ee;filter:="(&(osgi.ee=JavaSE)(version=11))"
|
||||
Require-Capability: osgi.ee;filter:="(&(osgi.ee=JavaSE)(version=21))"
|
||||
Bundle-SymbolicName: ab12cd89
|
||||
Bundle-Version: 1.0
|
||||
Bundle-Name: ab12cd89
|
||||
@ -211,12 +215,12 @@
|
||||
The manifest generated for <code>your_ghidra_scripts</code> is as follows:
|
||||
</p>
|
||||
<pre>
|
||||
<user home>/.ghidra/.ghidra-<version>/osgi/compiled-bundles/ef34ab56/META-INF/MANIFEST.MF:
|
||||
<user settings>/osgi/compiled-bundles/ef34ab56/META-INF/MANIFEST.MF:
|
||||
Manifest-Version: 1.0
|
||||
Bundle-ManifestVersion: 2
|
||||
Export-Package: yourlib
|
||||
Import-Package: ghidra.app.plugin.core.osgi
|
||||
Require-Capability: osgi.ee;filter:="(&(osgi.ee=JavaSE)(version=11))"
|
||||
Require-Capability: osgi.ee;filter:="(&(osgi.ee=JavaSE)(version=21))"
|
||||
Bundle-SymbolicName: ef34ab56
|
||||
Bundle-Version: 1.0
|
||||
Bundle-Name: ef34ab56
|
||||
@ -284,7 +288,7 @@
|
||||
<blockquote>
|
||||
<p>When Ghidra builds a source bundle, the results are written to the
|
||||
directory <br>
|
||||
<code><user home>/.ghidra/.ghidra-<version>/osgi/compiled-bundles/<hash></code>. <br>
|
||||
<code><user settings>/osgi/compiled-bundles/<hash></code>. <br>
|
||||
These files can then be loaded by the OSGi framework.</p>
|
||||
|
||||
<p>A <em>clean</em> deactivates then wipes this subdirectory for each selected bundle and
|
||||
|
||||
@ -158,7 +158,7 @@
|
||||
<P><IMG src="help/shared/note.png" border="0">When you click on the
|
||||
<B>Apply</FONT></B> or <B>OK</FONT></B> button, your
|
||||
<code>preferences</code> file in your
|
||||
<code><home>/.ghidra/.ghidra-<version></code>
|
||||
<code><user settings></code>
|
||||
folder is updated immediately.</P>
|
||||
|
||||
</BLOCKQUOTE>
|
||||
|
||||
@ -46,7 +46,7 @@
|
||||
|
||||
<LI style="list-style: none">
|
||||
<UL>
|
||||
<LI><I>[user dir]/.ghidra/.ghidra_[version]/Extensions</I> - Installed/uninstalled from
|
||||
<LI><I>[user settings]/Extensions</I> - Installed/uninstalled from
|
||||
this dialog</LI>
|
||||
|
||||
<LI><I>[installation dir]/Ghidra/Extensions/</I> - Installed/uninstalled from
|
||||
|
||||
@ -78,7 +78,7 @@
|
||||
|
||||
<BLOCKQUOTE>
|
||||
<P>The Tool Chest shows the tools that you currently have in your
|
||||
<b><user home dir>/.ghidra/.ghidra-<version>/tools</b> folder.
|
||||
<b><user settings>/tools</b> folder.
|
||||
The tools are placed there when you initially install Ghidra.
|
||||
These tools are always available to your currently open project. See <A href=
|
||||
"help/topics/Tool/Ghidra_Tool_Administration.htm">Ghidra Tool Administration</A> for
|
||||
@ -960,8 +960,8 @@
|
||||
other IDE), you will see standard output and errors in your IDE's console as well as
|
||||
the Ghidra console.</P>
|
||||
|
||||
<P>Errors and other informational messages are logged to a file in <user
|
||||
home>/.ghidra/<I><B>ghidraUser.log</B></I>. Messages are appended to the file every
|
||||
<P>Errors and other informational messages are logged to a file in
|
||||
<user settings>/<I><B>ghidraUser.log</B></I>. Messages are appended to the file every
|
||||
time you launch Ghidra. Once the log file has reached 500KB in size, however, it will
|
||||
be rolled to a backup file named <I><B>ghidraUser.log.0</B></I>. Older backup files are
|
||||
similarly rolled to another file with a one-up digit suffix as well. Ghidra stores a
|
||||
|
||||
@ -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.
|
||||
@ -138,8 +138,8 @@ public class GhidraSourceBundle extends GhidraBundle {
|
||||
}
|
||||
|
||||
/**
|
||||
* Source bundles are compiled to a path relative to the user's home:
|
||||
* {@code $USERHOME/.ghidra/.ghidra_<ghidra version>/osgi/compiled-bundles/<sourceDirHash> }
|
||||
* Source bundles are compiled to a path relative to the user's settings directory:
|
||||
* {@code <user settings>/osgi/compiled-bundles/<sourceDirHash> }
|
||||
*
|
||||
* @return the destination for compiled source bundles
|
||||
*
|
||||
@ -154,7 +154,7 @@ public class GhidraSourceBundle extends GhidraBundle {
|
||||
* a hash of the source directory path.
|
||||
*
|
||||
* <p>This hash is also used as the final path component of the compile destination:
|
||||
* <br/> {@code $USERHOME/.ghidra/.ghidra_<ghidra version>/osgi/compiled-bundles/<sourceDirHash> }
|
||||
* <br/> {@code <user settings>/osgi/compiled-bundles/<sourceDirHash> }
|
||||
*
|
||||
* @param sourceDir the source directory
|
||||
* @return a string hash of the source directory path
|
||||
|
||||
@ -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.
|
||||
@ -204,9 +204,9 @@ public class LibraryLookupTable {
|
||||
* </pre>
|
||||
* Alternatively, a user specific resource directory may be used which
|
||||
* is located at
|
||||
* <pre>
|
||||
* <USER_HOME>/.ghidra/<.ghidraVersion>/symbols/[win32|win64]
|
||||
* </pre>
|
||||
* <pre>{@code
|
||||
* <user settings>/symbols/[win32|win64]
|
||||
* }</pre>
|
||||
* The cacheMap is a static cache which always returns the same
|
||||
* instance for a given DLL name.
|
||||
*
|
||||
|
||||
@ -155,7 +155,7 @@
|
||||
<H2>Creating/Editing/Saving Themes</H2>
|
||||
|
||||
<P>New themes can be created and saved to files in the theme directory in the user's
|
||||
application directory (<code><home>/.ghidra/.ghidra-<version>/themes</code>).
|
||||
settings directory (<code><user settings>/themes</code>).
|
||||
When the application is started, this directory is scanned and any
|
||||
<CODE>*.theme</CODE> files are loaded and available to be selected as the active theme.
|
||||
The <CODE>Gui</CODE> class has
|
||||
|
||||
@ -19,10 +19,14 @@
|
||||
in their home application directory</P>
|
||||
|
||||
<P>Users can also edit and create their own themes using the Theme Editor. Custom themes are
|
||||
stored in the user's <code><home>/.ghidra/.ghidra-<version>/themes</code> directory.
|
||||
stored in the user's <code><user settings>/themes</code> directory.
|
||||
These theme files are simple text files that can
|
||||
easily be modified using any text editor. Also, users can share themes by exporting them to a
|
||||
file that can be given to other users who can them import them into their application.</P>
|
||||
|
||||
<P><b>NOTE: </b> The <code><user settings></code> directory is platform/configuration
|
||||
specific. Its value can be found in the Ghidra Front End GUI, under <code>Help ->
|
||||
Runtime Information -> Application Layout -> Settings Directory</code></P>
|
||||
|
||||
</BlOCKQUOTE>
|
||||
<H2>Theme Chooser Dialog<A name="Switch_Theme"></A></H2>
|
||||
@ -243,7 +247,7 @@
|
||||
|
||||
<P>Theme Files are used to store saved custom themes. They are simple text files and are
|
||||
stored in the user's home application directory under
|
||||
<code><home>/.ghidra/.ghidra-<version>/themes</code>. The first three properties
|
||||
<code><user settings>/themes</code>. The first three properties
|
||||
are always the theme name, the Look and Feel name, and whether the theme uses standard
|
||||
defaults or dark defaults. Finally, there is a list of overridden property "name = value"
|
||||
lines. The format is:</P>
|
||||
|
||||
@ -481,7 +481,9 @@ can be found in the <i><GhidraInstallDir></i>/Extensions directory.</p>
|
||||
</li>
|
||||
<li>
|
||||
Extensions installed from the Ghidra front-end GUI get installed at
|
||||
<i><UserDir></i>/.ghidra/.ghidra-[version]/Extensions.
|
||||
<i><UserSettings></i>/Extensions, where <i><UserSettings></i> can be looked up in
|
||||
the Ghidra front-end GUI under <i>Help -> Runtime Information -> Application Layout ->
|
||||
Settings Directory.
|
||||
</li>
|
||||
<li>
|
||||
<p>It is possible to install Ghidra extensions directly into the Ghidra installation directory.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user