= 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 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:

 * driver.OS2 -> \IBMCOM\MACS
 * driver.NIF -> \IBMCOM\MACS
 * driver.SYM -> \IBMCOM\MACS
 * TRC00F8.TFF -> \OS2\SYSTEM\TRACE

where driver is the driver that you are testing, such as R8169, NVETH, or E1000E.

To enable tracing, add these two lines to your CONFIG.SYS:
{{{
  TRACEBUF=512 /M=NOWRAP,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... and zip that file and send it to
the developer.