ChangeSet ID: 1129524637441201404742063 CVSROOT: /cvsroot/wine Module name: docs Changes by: dimi@sc8-pr-cvs1.sourceforge.net 2005/10/16 21:50:37
Modified files: en : winedev-debugger.sgml
Log message: Molle Bestefich molle.bestefich@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>