diff options
Diffstat (limited to 'docs/manual/retrace')
| -rw-r--r-- | docs/manual/retrace/examples.html | 37 | ||||
| -rw-r--r-- | docs/manual/retrace/index.html | 26 | ||||
| -rw-r--r-- | docs/manual/retrace/introduction.html | 21 | ||||
| -rw-r--r-- | docs/manual/retrace/usage.html | 31 |
4 files changed, 79 insertions, 36 deletions
diff --git a/docs/manual/retrace/examples.html b/docs/manual/retrace/examples.html index 211017b..2137e3a 100644 --- a/docs/manual/retrace/examples.html +++ b/docs/manual/retrace/examples.html @@ -1,10 +1,21 @@ -<!doctype html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//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 Examples</title> +<script type="text/javascript" language="JavaScript"> +<!-- +if (window.self==window.top) + window.top.location.replace("../../index.html#"+window.location.pathname+window.location.hash); +else { + var hash="#"+window.location.pathname.replace(window.top.location.pathname.replace("index.html", ""), ""); + if (window.top.location.hash!=hash) + window.top.location.hash=hash; +} +//--> +</script> </head> <body> @@ -12,13 +23,13 @@ Some typical example uses: <ol> -<li><a href="#with">Restoring a stack trace with line numbers</a> -<li><a href="#withverbose">Restoring a stack trace with line numbers (verbose)</a> -<li><a href="#without">Restoring a stack trace without line numbers</a> +<li><a href="#with">Restoring a stack trace with line numbers</a></li> +<li><a href="#withverbose">Restoring a stack trace with line numbers + (verbose)</a></li> +<li><a href="#without">Restoring a stack trace without line numbers</a></li> </ol> -<a name="with"> </a> -<h3>Restoring a stack trace with line numbers</h3> +<h3><a name="with">Restoring a stack trace with line numbers</a></h3> Assume for instance ProGuard itself has been obfuscated using the following extra options: @@ -133,8 +144,7 @@ Exception in thread "main" java.lang.Error: Random exception at proguard.ProGuard.main(ProGuard:429) </pre> -<a name="withverbose"> </a> -<h3>Restoring a stack trace with line numbers (verbose)</h3> +<h3><a name="withverbose">Restoring a stack trace with line numbers (verbose)</a></h3> In the previous example, we could also use the verbose flag: <pre> @@ -189,8 +199,7 @@ Exception in thread "main" java.lang.Error: Random exception </pre> -<a name="without"> </a> -<h3>Restoring a stack trace without line numbers</h3> +<h3><a name="without">Restoring a stack trace without line numbers</a></h3> Assume for instance ProGuard itself has been obfuscated using the following extra options, this time without preserving the line number tables: @@ -324,12 +333,12 @@ Exception in thread "main" java.lang.Error: Random exception execute at proguard.ProGuard.main(Unknown Source) </pre> -<p> -<hr> +<hr /> +<noscript><div><a target="_top" href="../../index.html" class="button">Show menu</a></div></noscript> <address> -Copyright © 2002-2009 -<a href="http://www.graphics.cornell.edu/~eric/">Eric Lafortune</a>. +Copyright © 2002-2013 +<a target="other" href="http://www.lafortune.eu/">Eric Lafortune</a>. </address> </body> </html> diff --git a/docs/manual/retrace/index.html b/docs/manual/retrace/index.html index ebb23ac..47209df 100644 --- a/docs/manual/retrace/index.html +++ b/docs/manual/retrace/index.html @@ -1,25 +1,37 @@ -<!doctype html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//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 Manual</title> +<script type="text/javascript" language="JavaScript"> +<!-- +if (window.self==window.top) + window.top.location.replace("../../index.html#"+window.location.pathname+window.location.hash); +else { + var hash="#"+window.location.pathname.replace(window.top.location.pathname.replace("index.html", ""), ""); + if (window.top.location.hash!=hash) + window.top.location.hash=hash; +} +//--> +</script> </head> <body> <h2>ReTrace</h2> <ol> -<li><a href="introduction.html">Introduction</a> -<li><a href="usage.html">Usage</a> -<li><a href="examples.html">Examples</a> +<li><a href="introduction.html">Introduction</a></li> +<li><a href="usage.html">Usage</a></li> +<li><a href="examples.html">Examples</a></li> </ol> -<hr> +<hr /> +<noscript><div><a target="_top" href="../../index.html" class="button">Show menu</a></div></noscript> <address> -Copyright © 2002-2009 -<a href="http://www.graphics.cornell.edu/~eric/">Eric Lafortune</a>. +Copyright © 2002-2013 +<a target="other" href="http://www.lafortune.eu/">Eric Lafortune</a>. </address> </body> </html> diff --git a/docs/manual/retrace/introduction.html b/docs/manual/retrace/introduction.html index 19f9471..381ad1f 100644 --- a/docs/manual/retrace/introduction.html +++ b/docs/manual/retrace/introduction.html @@ -1,10 +1,21 @@ -<!doctype html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//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> +<script type="text/javascript" language="JavaScript"> +<!-- +if (window.self==window.top) + window.top.location.replace("../../index.html#"+window.location.pathname+window.location.hash); +else { + var hash="#"+window.location.pathname.replace(window.top.location.pathname.replace("index.html", ""), ""); + if (window.top.location.hash!=hash) + window.top.location.hash=hash; +} +//--> +</script> </head> <body> @@ -56,12 +67,12 @@ 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> +<hr /> +<noscript><div><a target="_top" href="../../index.html" class="button">Show menu</a></div></noscript> <address> -Copyright © 2002-2009 -<a href="http://www.graphics.cornell.edu/~eric/">Eric Lafortune</a>. +Copyright © 2002-2013 +<a target="other" href="http://www.lafortune.eu/">Eric Lafortune</a>. </address> </body> </html> diff --git a/docs/manual/retrace/usage.html b/docs/manual/retrace/usage.html index 88587ff..6e7f6a8 100644 --- a/docs/manual/retrace/usage.html +++ b/docs/manual/retrace/usage.html @@ -1,10 +1,21 @@ -<!doctype html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//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 Usage</title> +<script type="text/javascript" language="JavaScript"> +<!-- +if (window.self==window.top) + window.top.location.replace("../../index.html#"+window.location.pathname+window.location.hash); +else { + var hash="#"+window.location.pathname.replace(window.top.location.pathname.replace("index.html", ""), ""); + if (window.top.location.hash!=hash) + window.top.location.hash=hash; +} +//--> +</script> </head> <body> @@ -17,7 +28,8 @@ ProGuard distribution. To run ReTrace, just type: <code><b>java -jar retrace.jar </b></code>[<i>options...</i>] <i>mapping_file</i> [<i>stacktrace_file</i>] </p> -These are the arguments: +Alternatively, the <code>bin</code> directory contains some short Linux and +Windows scripts containing this command. These are the arguments: <dl> <dt><i>mapping_file</i></dt> @@ -48,7 +60,7 @@ The following options are supported: de-obfuscate more general types of input than just stack traces. The default is suitable for stack traces produced by most JVMs: <pre> - (?:\s*%c:.*)|(?:\s*at\s+%c.%m\s*\(.*?(?::%l)?\)\s*) + (?:.*?\bat\s+%c.%m\s*\(.*?(?::%l)?\)\s*)|(?:(?:.*?[:"]\s+)?%c(?::.*)?) </pre> The regular expression is a Java regular expression (cfr. the documentation of <code>java.util.regex.Pattern</code>), with a few additional wildcards: @@ -87,14 +99,13 @@ the obfuscated class files: <ul> <li>If all line numbers have been preserved while obfuscating the application, - ReTrace will be able to restore the stack trace completely. - <p> + ReTrace will be able to restore the stack trace completely.</li> <li>If the line numbers have been removed, mapping obfuscated method names back to their original names has become ambiguous. Retrace will list all possible original method names for each line in the stack trace. The user can then try to deduce the actual stack trace manually, based on the logic - of the program. + of the program.</li> </ul> <p> @@ -105,12 +116,12 @@ href="../examples.html#stacktrace">example</a> in the ProGuard User Manual. Unobfuscated elements and obfuscated elements for which no mapping is available will be left unchanged. -<p> -<hr> +<hr /> +<noscript><div><a target="_top" href="../../index.html" class="button">Show menu</a></div></noscript> <address> -Copyright © 2002-2009 -<a href="http://www.graphics.cornell.edu/~eric/">Eric Lafortune</a>. +Copyright © 2002-2013 +<a target="other" href="http://www.lafortune.eu/">Eric Lafortune</a>. </address> </body> </html> |