Changes between Version 1 and Version 2 of Debugging Guide

Timestamp:

Apr 6, 2012, 1:55:27 AM (14 years ago)

Author:

David Azarewicz

Comment:

--

Debugging Guide

@@ -1 +1 @@
 = Debugging Guide =
 
+If you have problems with one of the !MultiMac drivers, the developer may ask you to
+install the trace version and provide a trace dump.
 
-== Installing the trace version ==
+== Installing the Trace Version of the Driver ==
 
+To install the trace version, copy the following files from the trace
+directory of the distribution package to the directories on your boot
+drive as indicated below:
 
-== Capturing the trace  ==
+ * R8169.OS2 -> \IBMCOM\MACS
+ * R8169.NIF -> \IBMCOM\MACS
+ * R8169.SYM -> \IBMCOM\MACS
+ * TRC00F8.TFF -> \OS2\SYSTEM\TRACE
+
+To enable tracing, add these two lines to your CONFIG.SYS:
+{{{
+  TRACEBUF=512 /M=WRAP,QUEUED,NODTI /D=ALL
+  TRACE=ON 248
+}}}
+You must reboot to make the new driver active and enable tracing. This
+assumes that you have already setup this driver using mpts.exe. You do
+not need to setup the driver using mpts.exe more than once, even if you
+copy new versions of the driver into \IBMCOM\MACS. You just need to reboot
+to start using the new version.
+
+== Capturing the Trace  ==
+
+To capture the trace dump, open a command window and type:
+
+   TRACEFMT
+
+From the file menu choose save formatted trace and send that file to
+the developer.