diff options
Diffstat (limited to 'docs/manual/retrace/introduction.html')
-rw-r--r-- | docs/manual/retrace/introduction.html | 68 |
1 files changed, 68 insertions, 0 deletions
diff --git a/docs/manual/retrace/introduction.html b/docs/manual/retrace/introduction.html new file mode 100644 index 0000000..19f9471 --- /dev/null +++ b/docs/manual/retrace/introduction.html @@ -0,0 +1,68 @@ +<!doctype html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<html> +<head> +<meta http-equiv="content-type" content="text/html; charset=iso-8859-1"> +<meta http-equiv="content-style-type" content="text/css"> +<link rel="stylesheet" type="text/css" href="../style.css"> +<title>ReTrace Introduction</title> +</head> +<body> + +<h2>Introduction</h2> + +<b>ReTrace</b> is a companion tool for <b>ProGuard</b> that 'de-obfuscates' +stack traces. +<p> +When an obfuscated program throws an exception, the resulting stack trace +typically isn't very informative. Class names and method names have been +replaced by short meaningless strings. Source file names and line numbers are +missing altogether. While this may be intentional, it can also be inconvenient +when debugging problems. +<p> + +<table class="diagram" align="center"> + +<tr> +<td rowspan="1" class="lightblock">Original code</td> +<td class="transparentblock">- <b>ProGuard</b> →</td> +<td rowspan="1" class="lightblock">Obfuscated code</td> +</tr> + +<tr> +<td rowspan="3" class="transparentblock"></td> +<td class="transparentblock">↓</td> +<td class="transparentblock">↓</td> +</tr> + +<tr> +<td class="whiteblock">Mapping file</td> +<td class="transparentblock">↓</td> +</tr> + +<tr> +<td class="transparentblock">↓</td> +<td class="transparentblock">↓</td> +</tr> + +<tr> +<td class="whiteblock">Readable stack trace</td> +<td class="transparentblock">← <b>ReTrace</b> -</td> +<td class="whiteblock">Obfuscated stack trace</td> +</tr> + +</table> +<p> +ReTrace can read an obfuscated stack trace and restore it to what it would +look like without obfuscation. The restoration is based on the mapping file +that ProGuard can write out during obfuscation. The mapping file links the +original class names and class member names to their obfuscated names. +<p> + +<hr> +<address> +Copyright © 2002-2009 +<a href="http://www.graphics.cornell.edu/~eric/">Eric Lafortune</a>. +</address> +</body> +</html> + |