Add documentation on how to modify what --debugmsg +relay reports.
This commit is contained in:
parent
0dbab63fa6
commit
8417027c1e
|
@ -129,7 +129,7 @@
|
||||||
<entry>Direct port access</entry>
|
<entry>Direct port access</entry>
|
||||||
</row>
|
</row>
|
||||||
<row>
|
<row>
|
||||||
<entry>[spy]</entry>
|
<entry>[Debug]</entry>
|
||||||
<entry>no</entry>
|
<entry>no</entry>
|
||||||
<entry>What to do with certain debug messages</entry>
|
<entry>What to do with certain debug messages</entry>
|
||||||
</row>
|
</row>
|
||||||
|
@ -807,13 +807,16 @@ OPTIONAL:
|
||||||
</para>
|
</para>
|
||||||
</sect3>
|
</sect3>
|
||||||
|
|
||||||
<sect3>
|
<sect3 id="config-debug-etc">
|
||||||
<title>The [spy], [Registry], [tweak.layout], and [programs] Sections</title>
|
<title>The [Debug], [Registry], [tweak.layout], and [programs] Sections</title>
|
||||||
<para>
|
<para>
|
||||||
[spy] is used to include or exclude debug messages, and to
|
[Debug] is used to include or exclude debug messages, and to
|
||||||
output them to a file. The latter is rarely used. THESE
|
output them to a file. The latter is rarely used. THESE
|
||||||
ARE ALL OPTIONAL AND YOU PROBABLY DON'T NEED TO ADD OR
|
ARE ALL OPTIONAL AND YOU PROBABLY DON'T NEED TO ADD OR
|
||||||
REMOVE ANYTHING IN THIS SECTION TO YOUR CONFIG.
|
REMOVE ANYTHING IN THIS SECTION TO YOUR CONFIG. (In extreme
|
||||||
|
cases you may want to use these options to manage the amount
|
||||||
|
of information generated by the <parameter>--debugmsg +relay
|
||||||
|
</parameter> option.)
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<programlisting>"File" = "/blanco"</programlisting>
|
<programlisting>"File" = "/blanco"</programlisting>
|
||||||
|
@ -821,15 +824,35 @@ OPTIONAL:
|
||||||
THIS IS RARELY USED.
|
THIS IS RARELY USED.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<programlisting>"Exclude" = "WM_SIZE;WM_TIMER;"</programlisting>
|
<programlisting>"SpyExclude" = "WM_SIZE;WM_TIMER;"</programlisting>
|
||||||
Excludes debug messages about <constant>WM_SIZE</constant>
|
Excludes debug messages about <constant>WM_SIZE</constant>
|
||||||
and <constant>WM_TIMER</constant> in the logfile.
|
and <constant>WM_TIMER</constant> in the logfile.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
<programlisting>"Include" = "WM_SIZE;WM_TIMER;"</programlisting>
|
<programlisting>"SpyInclude" = "WM_SIZE;WM_TIMER;"</programlisting>
|
||||||
Includes debug messages about <constant>WM_SIZE</constant>
|
Includes debug messages about <constant>WM_SIZE</constant>
|
||||||
and <constant>WM_TIMER</constant> in the logfile.
|
and <constant>WM_TIMER</constant> in the logfile.
|
||||||
</para>
|
</para>
|
||||||
|
<para>
|
||||||
|
<programlisting>"RelayInclude" = "user32.CreateWindowA;comctl32.*"</programlisting>
|
||||||
|
Include only the listed functions in a
|
||||||
|
<parameter>--debugmsg +relay</parameter> trace. This entry is
|
||||||
|
ignored if there is a <parameter>RelayExclude</parameter> entry.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
<programlisting>"RelayExclude" = "RtlEnterCriticalSection;RtlLeaveCriticalSection"</programlisting>
|
||||||
|
Exclude the listed functions in a
|
||||||
|
<parameter>--debugmsg +relay</parameter> trace. This entry
|
||||||
|
overrides any settings in a <parameter>RelayInclude</parameter>
|
||||||
|
entry. If neither entry is present then the trace includes
|
||||||
|
everything.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
In both entries the functions may be specified either as a
|
||||||
|
function name or as a module and function. In this latter
|
||||||
|
case specify an asterisk for the function name to include
|
||||||
|
all functions in the module.
|
||||||
|
</para>
|
||||||
<para>
|
<para>
|
||||||
[Registry] can be used to tell wine where your old windows
|
[Registry] can be used to tell wine where your old windows
|
||||||
registry files exist. This section is completely optional
|
registry files exist. This section is completely optional
|
||||||
|
|
|
@ -112,7 +112,11 @@ Options:
|
||||||
complex application, your debug logs can easily top 1 MB and
|
complex application, your debug logs can easily top 1 MB and
|
||||||
higher. A <parameter>relay</parameter> trace can often
|
higher. A <parameter>relay</parameter> trace can often
|
||||||
generate more than 10 MB of log messages, depending on how
|
generate more than 10 MB of log messages, depending on how
|
||||||
long you run the application. Logging does slow down Wine
|
long you run the application. (As described in the
|
||||||
|
<link linkend = "config-debug-etc">Debug</link>
|
||||||
|
section of configuring wine you can
|
||||||
|
modify what the <parameter>relay</parameter> trace reports).
|
||||||
|
Logging does slow down Wine
|
||||||
quite a bit, so don't use <parameter>--debugmsg</parameter>
|
quite a bit, so don't use <parameter>--debugmsg</parameter>
|
||||||
unless you really do want log files.
|
unless you really do want log files.
|
||||||
</para>
|
</para>
|
||||||
|
|
Loading…
Reference in New Issue