docs/en winedev-debugger.sgml
Dimi Paun
dimi at users.sourceforge.net
Sun Oct 16 23:50:37 CDT 2005
ChangeSet ID: 1129524637441201404742063
CVSROOT: /cvsroot/wine
Module name: docs
Changes by: dimi at sc8-pr-cvs1.sourceforge.net 2005/10/16 21:50:37
Modified files:
en : winedev-debugger.sgml
Log message:
Molle Bestefich <molle.bestefich at gmail.com>
- Link to AppDB for IDA Pro.
- Move 'useful programs' to it's own section2.
- Add <xref>s instead of naming sections.
Old revision New revision Changes Path
1.3 1.4 +94 -102 docs/en/winedev-debugger.sgml
Index: docs/en/winedev-debugger.sgml
diff -u -p docs/en/winedev-debugger.sgml:1.3 docs/en/winedev-debugger.sgml:1.4
--- docs/en/winedev-debugger.sgml 17 Oct 2005 4:50:37 -0000
+++ /dev/null 17 Oct 2005 4:50:37 -0000
@@ -388,9 +388,8 @@ winedbg hl.exe -windowed
which dumps ALL included debug information in wine.
It is often necessary to limit the debug output produced.
That can be done by piping the output through <command>grep</command>,
- or alternatively with the registry value RelayExclude located
- under
- <programlisting>HKCU\\Software\\Wine\\Debug</programlisting>.
+ or alternatively with registry keys. See
+ <xref linkend="cfg-dbg-relay"> for more information.
</para>
</listitem>
<listitem>
@@ -483,20 +482,20 @@ winedbg hl.exe -windowed
<ulink url="http://www.geocities.com/GoVest/">here</>.
</para>
<para>
+ You can also use the newer and better
+ <application>Interactive Disassembler</> (IDA) from DataRescue.
+ Take a look in the
+ <ulink url="http://appdb.winehq.org/appview.php?appId=565">AppDB</>
+ for links to various versions of IDA.
+ </para>
+ <para>
Another popular disassembler is
<application>Windows Disassembler 32</> from URSoft.
Look for a file called <filename>w32dsm87.zip</> (or similar) on
<ulink url="http://www.winsite.com/">winsite.com</> or
<ulink url="http://www.softpedia.com/">softpedia.com</>.
- </para>
- <para>
- You can also use the newer (and in the full version better)
- <application>Interactive Disassembler</> (IDA) from
- DataRescue. The version of IDA that has been most actively used by
- Wine project enthusiasts is named <filename>ida35bx.zip</filename>,
- although that version now seems impossible to locate. Take a look
- in the 'useful programs' section later on for links to working
- versions of IDA.
+ It seems that Windows Disassembler 32 currently has problems
+ working correctly under Wine, so use IDA or GoVest.
</para>
<para>
Also of considerable fame amongst disassemblers is
@@ -507,7 +506,7 @@ winedbg hl.exe -windowed
work under Wine.
</para>
<para>
- If nothing works for you, try one of the disassemblers found in
+ If nothing works for you, you might try one of the disassemblers found in
<ulink url="http://directory.google.com/Top/Computers/Programming/Disassemblers/DOS_and_Windows/">Google's directory</>.
</para>
<para>
@@ -778,93 +777,6 @@ Call KERNEL.96: FREELIBRARY(0x031f) ret=
set this breakpoint without error message.
</para>
</listitem>
- <listitem>
- <para>
- Some useful programs:
- </para>
- <variablelist>
- <varlistentry>
- <term>
- <application>GoVest</application>:
- <filename>govest.zip</filename> is available from
- <ulink url="http://www.geocities.com/GoVest/">http://www.geocities.com/GoVest/</>.
- </term>
- <listitem>
- <para>
- The win32 disassembler that currently works
- the best with Wine.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <application>IDA</application>:
- <filename>ida35bx.zip</filename> is near impossible to
- locate, but you might try a trial version of the new IDA Pro
- from
- <ulink url="http://www.datarescue.com/">http://www.datarescue.com</ulink>
- or try locating the free version of IDA Pro 4.3 by
- <ulink url="http://www.google.com/search?q=%22IDA+Pro+freeware%22+4.3">Googling</>.
- The newer versions mentioned above currently has problems
- installing under Wine. In the mean time, you can use the
- free version of IDA Pro 3.85b, which you can also find by
- <ulink url="http://www.google.com/search?q=IDA+Pro+freeware+3.85b">Googling</>.
- Version 3.85b does not have a GUI. It does have a textual
- interface, which currently has problems launching under
- Wine. To get it to launch correctly, start it with
- <application>winedbg</> instead of <application>wine</>.
- Remember to 'c'ontinue the program after starting it.
- </term>
- <listitem>
- <para>
- <emphasis>Very</emphasis> good DOS disassembler! It's badly needed
- for debugging Wine sometimes.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <application>XRAY</application>:
- <filename>
- <ulink url="http://garbo.uwasa.fi/pub/pc/sysinfo/xray15.zip">
- http://garbo.uwasa.fi/pub/pc/sysinfo/xray15.zip</ulink>
- </filename>
- </term>
- <listitem>
- <para>
- Traces DOS calls (Int 21h, DPMI, ...). Use it with
- Windows to correct file management problems etc.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <application>pedump</application>:
- <filename>
- <ulink url="ftp://ftp.simtel.net/pub/simtelnet/win95/prog/pedump.zip">
- ftp://ftp.simtel.net/pub/simtelnet/win95/prog/pedump.zip</ulink>
- </filename>
- </term>
- <listitem>
- <para>
- Dumps the imports and exports of a PE (Portable
- Executable) DLL.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <application>winedump</application>:
- </term>
- <listitem>
- <para>
- Dumps the imports and exports of a PE (Portable
- Executable) DLL (included in wine tree).
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
</itemizedlist>
</sect2>
@@ -909,6 +821,86 @@ winedbg myprog.exe
command.
</para>
</sect2>
+
+ <sect2 id="useful-programs">
+ <title>Useful programs</title>
+
+ <para>
+ Some useful programs:
+ </para>
+
+ <variablelist>
+ <varlistentry>
+ <term>
+ <application>GoVest</application>:
+ <filename>govest.zip</filename> is available from
+ <ulink url="http://www.geocities.com/GoVest/">http://www.geocities.com/GoVest/</>.
+ </term>
+ <listitem>
+ <para>
+ Simple win32 disassembler that works well with Wine.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <application>IDA</application>:
+ </term>
+ <listitem>
+ <para>
+ IDA Pro is highly recommended, but is not free.
+ DataRescue does however make trial versions available.
+ </para>
+ <para>
+ Take a look in the
+ <ulink url="http://appdb.winehq.org/appview.php?appId=565">AppDB</>
+ for links to various versions of IDA.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <application>XRAY</application>:
+ <filename>
+ <ulink url="http://garbo.uwasa.fi/pub/pc/sysinfo/xray15.zip">
+ http://garbo.uwasa.fi/pub/pc/sysinfo/xray15.zip</ulink>
+ </filename>
+ </term>
+ <listitem>
+ <para>
+ Traces DOS calls (Int 21h, DPMI, ...). Use it with
+ Windows to correct file management problems etc.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <application>pedump</application>:
+ <filename>
+ <ulink url="ftp://ftp.simtel.net/pub/simtelnet/win95/prog/pedump.zip">
+ ftp://ftp.simtel.net/pub/simtelnet/win95/prog/pedump.zip</ulink>
+ </filename>
+ </term>
+ <listitem>
+ <para>
+ Dumps the imports and exports of a PE (Portable
+ Executable) DLL.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <application>winedump</application>: (included in wine tree)
+ </term>
+ <listitem>
+ <para>
+ Dumps the imports and exports of a PE (Portable
+ Executable) DLL.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect2>
</sect1>
@@ -1196,7 +1188,7 @@ set $BreakAllThreadsStartup = 1
</variablelist>
</sect2>
- <sect2>
+ <sect2 id="cfg-dbg-relay">
<title>Configuring +relay behaviour</title>
<para>
When setting <parameter>WINEDEBUG</> to +relay and debugging,
@@ -1235,7 +1227,7 @@ set $BreakAllThreadsStartup = 1
</programlisting>
<para>
Exclude the bottom-most calls with RelayExclude after making
- sure that they are irrelevant and run your application again.
+ sure that they are irrelevant, then run your application again.
</para>
</sect2>
</sect1>
More information about the wine-cvs
mailing list