DebuggingCrashes - Revision history

Orudge: Reformat and update

2011-07-30T17:43:28Z

Reformat and update

← Older revision		Revision as of 17:43, 30 July 2011
Line 1:		Line 1:
	When TTDPatch or TTD crash without producing a crash log file (crash###.txt), it is very hard for the developers to figure out what went wrong or how to fix it. The same applies for when TTD stops responding and hangs, so that you have to kill it with the task manager.		When TTDPatch or TTD crash without producing a crash log file (crash###.txt), it is very hard for the developers to figure out what went wrong or how to fix it. The same applies for when TTD stops responding and hangs, so that you have to kill it with the task manager.

	If a crash log is produced, simply forward it to the patch developers. This document explains how to get the information that's usually in the crash log to the patch developers so they may attempt to figure out what the problem is in the ~~absense~~ of a crash log.		If a crash log is produced, simply forward it to the patch developers. This document explains how to get the information that's usually in the crash log to the patch developers so they may attempt to figure out what the problem is in the absence of a crash log.

	The process to get this information uses a debugger, a program that can catch crashes and interrupt a hung process in a controlled manner. If you've never used a debugger before, don't worry, we have step-by-step instructions here to tell you how to use it.		The process to get this information uses a debugger, a program that can catch crashes and interrupt a hung process in a controlled manner. If you've never used a debugger before, don't worry, we have step-by-step instructions here to tell you how to use it.
Line 79:		Line 79:
	You will now get an "Entry point alert" warning. Simply click "OK". At this point the window should look like this (click on thumbnail for full size view):		You will now get an "Entry point alert" warning. Simply click "OK". At this point the window should look like this (click on thumbnail for full size view):

	[[~~File~~:postattach.png]]		[[Image:postattach.png\|291px]]

	Note the "EIP" line on the right. After 8 hex digits, it will say something with either "NTDLL" or "KERNEL32", depending on your Windows version. If it doesn't, ask for help at this point.		Note the "EIP" line on the right. After 8 hex digits, it will say something with either "NTDLL" or "KERNEL32", depending on your Windows version. If it doesn't, ask for help at this point.
Line 97:		Line 97:
	# For unknown reasons, OllyDbg sometimes fails to provide us as much information as we would like. Sometimes, the screenshot will look like this (click on thumbnail for full size view):		# For unknown reasons, OllyDbg sometimes fails to provide us as much information as we would like. Sometimes, the screenshot will look like this (click on thumbnail for full size view):

	<center>[[~~File~~:debug1.png]]</center>		<center>[[Image:debug1.png\|316px]]</center>

	<center>(It doesn't matter which letters/digits appear in the "Same number" area, but it will be the same set on every line, and all three areas marked "Empty" will be.)</center>		<center>(It doesn't matter which letters/digits appear in the "Same number" area, but it will be the same set on every line, and all three areas marked "Empty" will be.)</center>

Orudge: Reformat and update

2011-07-30T17:36:32Z

Reformat and update

Show changes

Orudge: 9 revisions

2011-06-12T19:04:19Z

9 revisions

← Older revision	Revision as of 19:04, 12 June 2011
(No difference)

dmccoy at 20:43, 3 September 2008

2008-09-03T20:43:53Z

← Older revision		Revision as of 20:43, 3 September 2008
Line 14:		Line 14:
	The process to get this information uses a debugger, a program that can catch crashes and interrupt a hung process in a controlled manner. If you've never used a debugger before, don't worry, we have step-by-step instructions here to tell you how to use it.		The process to get this information uses a debugger, a program that can catch crashes and interrupt a hung process in a controlled manner. If you've never used a debugger before, don't worry, we have step-by-step instructions here to tell you how to use it.

	If you need help at any time, the best choice is to visit the [irc://irc.~~quakenet~~.~~org~~/tycoon\|#tycoon] IRC channel, or use the chat applet on TT-Forums. There's usually a patch developer there who can help you.		If you need help at any time, the best choice is to visit the [irc://irc.oftc.net/tycoon\|#tycoon] IRC channel, or use the chat applet on TT-Forums. There's usually a patch developer there who can help you.

	==Install a debugger==		==Install a debugger==

dmccoy at 03:00, 2 May 2008

2008-05-02T03:00:45Z

← Older revision		Revision as of 03:00, 2 May 2008
Line 104:		Line 104:

	=Final notes=		=Final notes=
			# When using ))OllyDbg[[]]OllyDbg[[ to debug crashes or hangs, it is very much advisable, although not absolutely required, to start TTD in windowed mode, not full-screen mode.

	For unknown reasons, ))OllyDbg[[]]OllyDbg[[ sometimes fails to provide us as much information as we would like. Sometimes, the screenshot will look like this (click on thumbnail for full size view):		# For unknown reasons, ))OllyDbg[[]]OllyDbg[[ sometimes fails to provide us as much information as we would like. Sometimes, the screenshot will look like this (click on thumbnail for full size view):

	src="img/wiki_up/debug_thumb.png" ]</center>		src="img/wiki_up/debug_thumb.png" ]</center>

dmccoy at 17:48, 13 May 2007

2007-05-13T17:48:40Z

← Older revision		Revision as of 17:48, 13 May 2007
Line 102:		Line 102:

	When done, simply close ))OllyDbg[[]]OllyDbg[[. This will also close TTD.		When done, simply close ))OllyDbg[[]]OllyDbg[[. This will also close TTD.

			=Final notes=

			For unknown reasons, ))OllyDbg[[]]OllyDbg[[ sometimes fails to provide us as much information as we would like. Sometimes, the screenshot will look like this (click on thumbnail for full size view):

			src="img/wiki_up/debug_thumb.png" ]</center>

			<center>(It doesn't matter which letters/digits appear in the "Same number" area, but it will be the same set on every line, and all three areas marked "Empty" will be.)</center>

			If this happens, something went wrong with ))OllyDbg[[]]OllyDbg[[. Submit the screenshot as normal, but then please contact [mailto:Ollydbg@t-online.de?subject=Have%20question\|Oleh Yuschuk], and tell him you can reproduce the problem ))DaleStan[[]]DaleStan[[ reported. Please do everything he asks of you, so this issue may be resolved as quickly as possible.

dmccoy at 19:33, 12 May 2007

2007-05-12T19:33:22Z

New page

'''''How to debug crashes with no crash log or hangs'''''

=Debugging Crashes=

How to debug crashes with no crash log or hangs

{maketoc}

When TTDPatch or TTD crash without producing a crash log file (crash###.txt), it is very hard for the developers to figure out what went wrong or how to fix it. The same applies for when TTD stops responding and hangs, so that you have to kill it with the task manager.

If a crash log is produced, simply forward it to the patch developers. This document explains how to get the information that's usually in the crash log to the patch developers so they may attempt to figure out what the problem is in the absense of a crash log.

The process to get this information uses a debugger, a program that can catch crashes and interrupt a hung process in a controlled manner. If you've never used a debugger before, don't worry, we have step-by-step instructions here to tell you how to use it.

If you need help at any time, the best choice is to visit the [irc://irc.quakenet.org/tycoon|#tycoon] IRC channel, or use the chat applet on TT-Forums. There's usually a patch developer there who can help you.

==Install a debugger==

First you need to install a debugger, if you don't have it already. Download [http://www.ollydbg.de/|OllyDbg] and install it.

Run it once, and open the "Debugging options" dialog.

</center>

Now open the "Exceptions" tab, and check the "Integer division by 0" and "All FPU exceptions" boxes.

</center>

Click "OK" and quit. ))OllyDbg[[]]OllyDbg[[ is now set up properly for debugging TTD/TTDPatch.

==Debugging a crash==

If the game crashes, but does not create a crash log, you need to have the debugger catch the crash. There are two possible ways of doing this. If the crash happens before you get to the TTD title screen, or if the following instructions do not work or do not catch the crash, try those in the next section below.

This requires that you can ))Alt-Tab[[]]Alt-Tab[[ or ))Alt-Esc[[]]Alt-Esc[[ out of TTD back to Windows. If you can't ))Alt-Tab[[]]Alt-Tab[[ out, try running TTD in windowed mode. Note that you will not be able to save your game when it happens (but it would crash anyway so that's no different to what you had before).
* Start TTD normally
* When TTD shows the title screen, press ))Alt-Tab[[]]Alt-Tab[[ or ))Alt-Esc[[]]Alt-Esc[[ to return to Windows
* Start ))OllyDbg[[]]OllyDbg[[
* Select File|Attach, then choose "Transport Tycoon Deluxe" (it should have TTDLOADW.OVL in the name and path columns), then click "Attach"

</center>
* You will now get an "Entry point alert" warning. Simply click "OK".
* Continue to run TTD by pressing the "F9" key or clicking the "run" button .
* Now return to TTD in the task bar or with ))Alt-Tab[[]]Alt-Tab[[
* Reproduce the steps that caused the crash last time
* At the time of the crash, ))OllyDbg[[]]OllyDbg[[ should start flashing in the task bar
* Click on it there to bring up the window, maximize ))OllyDbg[[]]OllyDbg[[, and take a screenshot

Submit this screenshot to the patch developers. It is best to go to the [irc://irc.quakenet.org/tycoon|#tycoon] IRC channel or the forum chat applet right away, with the windows still open, to see if the patch developers need any further information at this point.

When done, simply close ))OllyDbg[[]]OllyDbg[[. This will also close TTD.

==Debugging a crash (alternate)==

If the above instructions don't catch the crash, especially if the crash happens before the title window comes up, try this method.

First, open your ttdpatch.cfg in Notepad, and enter the following line somewhere:

<pre>-+debugswitches r+-</pre>

With this, TTD/TTDPatch will no longer start up normally, so be sure to remove it again when you're done with this procedure.

Now start TTDPatch. It will do the normal steps and then show the following warning:

<pre>-+Couldn't execute TTDLOADW.OVL: DEBUG SWITCH+-</pre>

At this point, start ))OllyDbg[[]]OllyDbg[[. Select File|Open, browse to your TTD folder, and open TTDLOADW.OVL.
* You will now get an "Entry point alert" warning. Simply click "OK".
* Now press F9 or the "run" button to start TTDPatch and TTD.
* Reproduce the steps that caused the crash last time
* At the time of the crash, ))OllyDbg[[]]OllyDbg[[ should start flashing in the task bar
* Click on it there to bring up the window, maximize ))OllyDbg[[]]OllyDbg[[, and take a screenshot

Submit this screenshot to the patch developers. It is best to go to the [irc://irc.quakenet.org/tycoon|#tycoon] IRC channel or the forum chat applet right away, with the windows still open, to see if the patch developers need any further information at this point.

When done, simply close ))OllyDbg[[]]OllyDbg[[. This will also close TTD. Press any key in the TTDPatch window to close it as well.

==Debugging a hang==

Follow this procedure if TTD stops responding for a long time. This requires that you can ))Alt-Tab[[]]Alt-Tab[[ or ))Alt-Esc[[]]Alt-Esc[[ out of TTD back to Windows. If you can't ))Alt-Tab[[]]Alt-Tab[[ out, try running TTD in windowed mode. Note that you will not be able to save your game when it happens (but it would hang anyway so that's no different to what you had before).
* Reproduce what you were doing when TTD stopped responding
* When TTD stops responding again, press ))Alt-Tab[[]]Alt-Tab[[ or ))Alt-Esc[[]]Alt-Esc[[ to return to Windows
* Start ))OllyDbg[[]]OllyDbg[[
* Select File|Attach, then choose "Transport Tycoon Deluxe" (it should have TTDLOADW.OVL in the name and path columns), then click "Attach"

</center>

You will now get an "Entry point alert" warning. Simply click "OK". At this point the window should look like this (click on thumbnail for full size view):

src="img/wiki_up/postattach_t.jpg" ]</center>

Note the "EIP" line on the right. After 8 hex digits, it will say something with either "NTDLL" or "KERNEL32", depending on your Windows version. If it doesn't, ask for help at this point.

Now select "Debug|Execute till user code" or press ))Alt-F9[[]]Alt-F9[[, and check the EIP line again. It should say "TTDLOADW" after the 8 hex digits:

</center>

Note that the letters/digits don't matter, just check that it says TTDLOADW. If it doesn't, something is probably not working, so ask for help at this point.

At this point, take a screenshot of the entire ))OllyDbg[[]]OllyDbg[[ window and submit it to the patch developers. It is best to go to the [irc://irc.quakenet.org/tycoon|#tycoon] IRC channel or the forum chat applet right away, with the windows still open, to see if the patch developers need any further information at this point.

When done, simply close ))OllyDbg[[]]OllyDbg[[. This will also close TTD.

dmccoy at 18:52, 15 October 2006

2006-10-15T18:52:37Z

New page

'''''How to debug crashes with no crash log or hangs'''''

=Debugging Crashes=

How to debug crashes with no crash log or hangs

{maketoc}

When TTDPatch or TTD crash without producing a crash log file (crash###.txt), it is very hard for the developers to figure out what went wrong or how to fix it. The same applies for when TTD stops responding and hangs, so that you have to kill it with the task manager.

If a crash log is produced, simply forward it to the patch developers. This document explains how to get the information that's usually in the crash log to the patch developers so they may attempt to figure out what the problem is in the absense of a crash log.

The process to get this information uses a debugger, a program that can catch crashes and interrupt a hung process in a controlled manner. If you've never used a debugger before, don't worry, we have step-by-step instructions here to tell you how to use it.

If you need help at any time, the best choice is to visit the [irc://irc.quakenet.org/tycoon|#tycoon] IRC channel, or use the chat applet on TT-Forums. There's usually a patch developer there who can help you.

==Install a debugger==

First you need to install a debugger, if you don't have it already. Download [http://www.ollydbg.de/|OllyDbg] and install it.

Run it once, and oped the "Debugging options" dialog.

</center>

Now check the "Integer division by 0" and "All FPU exceptions" boxes.

</center>

Click "OK" and quit. ))OllyDbg[[]]OllyDbg[[ is now set up properly for debugging TTD/TTDPatch.

==Debugging a crash==

If the game crashes, but does not create a crash log, you need to have the debugger catch the crash. There are two possible ways of doing this. If the crash happens before you get to the TTD title screen, or if the following instructions do not work or do not catch the crash, try those in the next section below.

This requires that you can ))Alt-Tab[[]]Alt-Tab[[ or ))Alt-Esc[[]]Alt-Esc[[ out of TTD back to Windows. If you can't ))Alt-Tab[[]]Alt-Tab[[ out, try running TTD in windowed mode. Note that you will not be able to save your game when it happens (but it would crash anyway so that's no different to what you had before).
* Start TTD normally
* When TTD shows the title screen, press ))Alt-Tab[[]]Alt-Tab[[ or ))Alt-Esc[[]]Alt-Esc[[ to return to Windows
* Start ))OllyDbg[[]]OllyDbg[[
* Select File|Attach, then choose "Transport Tycoon Deluxe" (it should have TTDLOADW.OVL in the name and path columns), then click "Attach"

</center>
* You will now get an "Entry point alert" warning. Simply click "OK".
* Continue to run TTD by pressing the "F9" key or clicking the "run" button .
* Now return to TTD in the task bar or with ))Alt-Tab[[]]Alt-Tab[[
* Reproduce the steps that caused the crash last time
* At the time of the crash, ))OllyDbg[[]]OllyDbg[[ should start flashing in the task bar
* Click on it there to bring up the window, and take a screenshot

Submit this screenshot to the patch developers. It is best to go to the [irc://irc.quakenet.org/tycoon|#tycoon] IRC channel or the forum chat applet right away, with the windows still open, to see if the patch developers need any further information at this point.

When done, simply close ))OllyDbg[[]]OllyDbg[[. This will also close TTD.

==Debugging a crash (alternate)==

If the above instructions don't catch the crash, especially if the crash happens before the title window comes up, try this method.

First, open your ttdpatch.cfg in Notepad, and enter the following line somewhere:

<pre>-+debugswitches r+-</pre>

With this, TTD/TTDPatch will no longer start up normally, so be sure to remove it again when you're done with this procedure.

Now start TTDPatch. It will do the normal steps and then show the following warning:

<pre>-+Couldn't execute TTDLOADW.OVL: DEBUG SWITCH+-</pre>

At this point, start ))OllyDbg[[]]OllyDbg[[. Select File|Open, browse to your TTD folder, and open TTDLOADW.OVL.
* You will now get an "Entry point alert" warning. Simply click "OK".
* Now press F9 or the "run" button to start TTDPatch and TTD.
* Reproduce the steps that caused the crash last time
* At the time of the crash, ))OllyDbg[[]]OllyDbg[[ should start flashing in the task bar
* Click on it there to bring up the window, and take a screenshot

Submit this screenshot to the patch developers. It is best to go to the [irc://irc.quakenet.org/tycoon|#tycoon] IRC channel or the forum chat applet right away, with the windows still open, to see if the patch developers need any further information at this point.

When done, simply close ))OllyDbg[[]]OllyDbg[[. This will also close TTD. Press any key in the TTDPatch window to close it as well.

==Debugging a hang==

Follow this procedure if TTD stops responding for a long time. This requires that you can ))Alt-Tab[[]]Alt-Tab[[ or ))Alt-Esc[[]]Alt-Esc[[ out of TTD back to Windows. If you can't ))Alt-Tab[[]]Alt-Tab[[ out, try running TTD in windowed mode. Note that you will not be able to save your game when it happens (but it would hang anyway so that's no different to what you had before).
* Reproduce what you were doing when TTD stopped responding
* When TTD stops responding again, press ))Alt-Tab[[]]Alt-Tab[[ or ))Alt-Esc[[]]Alt-Esc[[ to return to Windows
* Start ))OllyDbg[[]]OllyDbg[[
* Select File|Attach, then choose "Transport Tycoon Deluxe" (it should have TTDLOADW.OVL in the name and path columns), then click "Attach"

</center>

You will now get an "Entry point alert" warning. Simply click "OK". At this point the window should look like this (click on thumbnail for full size view):

src="img/wiki_up/postattach_t.jpg" ]</center>

Note the "EIP" line on the right. After 8 hex digits, it will say something with either "NTDLL" or "KERNEL32", depending on your Windows version. If it doesn't, ask for help at this point.

Now select "Debug|Execute till user code" or press ))Alt-F9[[]]Alt-F9[[, and check the EIP line again. It should say "TTDLOADW" after the 8 hex digits:

</center>

Note that the letters/digits don't matter, just click until it says TTDLOADW. If it does not say TTDLOADW, it's probably not working, so ask for help at this point.

At this point, take a screenshot of the entire ))OllyDbg[[]]OllyDbg[[ window and submit it to the patch developers. It is best to go to the [irc://irc.quakenet.org/tycoon|#tycoon] IRC channel or the forum chat applet right away, with the windows still open, to see if the patch developers need any further information at this point.

When done, simply close ))OllyDbg[[]]OllyDbg[[. This will also close TTD.