About Dr. Watson


Dr. Watson is a debugger for Microsoft Windows. If Dr. Watson is running and a Windows application crashes, Dr. Watson creates a report with technical information that can help developers determine what caused the application to crash.

If Soulseek crashes, please send the Dr. Watson report to Soulseek Developers, along with an explanation of what you were doing when Soulseek crashed. We appreciate your help and apologize for your inconvenience.

Most -- but not all -- crashes result in Dr. Watson logs.

This document contains information about setting up and using Dr. Watson in the different Windows versions.


Dr. Watson for Windows XP

Basic Dr. Watson information:

Program name: drwtsn32.exe
Probable Program location: C:\WINDOWS\SYSTEM32
Probable Report location: C:\Documents and Settings\All Users\Application Data\Microsoft\Dr Watson
Report Log name: drwtsn32.log
Error dump name: user.dmp

Dr. Watson is included in the Windows XP operating system. If you want to use it, you must install it as your default debugger. To do this, go to your Windows Start menu, select Run. In Open, type: drwtsn32 -i.

Install Dr. Watson

You then see a message telling you that Dr. Watson is your default debugger.

Confirm Dr. Watson

Then, configure Dr. Watson as you wish. To do this, go to your Windows Start menu, select Run. In Open, type: drwtsn32. You see the Dr. Watson for Windows Configuration window.

Dr. Watson Configuration window

Note these settings:

Log File path: This gives the location of the log file, drwtsn32.log.
Crash dump: This gives the location of the dump file, user.dmp.
Dump Symbol Table: Check these. They provide useful information.
Dump All Threat Contents:
Visual and Sound Notification: These settings determine how you are notified of errors.
Append to existing log file: Check this so that new reports are appended to (added to) the existing drwtsn32.log file. Otherwise, each new report replaces the previous one, and reports may be lost.
Create crash dump file: Check this, so that the user.dmp file will be created.
Application errors: This is a list of recent errors. [Editor's note: this list seems to be incomplete, so I look in the Log path location for the reports.]

When an application crashes, you see a Windows message such as this: application program has caused a problem and needs to close. Usually -- but not always -- a Dr. Watson log is generated.

How to send the reports to us

  1. Send the drwtsn32.log as an email attachment to crash@slsknet.org. (Preferably, zip it up before sending.)

  2. Include a description of what you were doing with Soulseek when it crashed.

  3. After sending the email, rename or delete drwtsn32.log and user.dmp, so that the log files do not grow excessively large. [Editor's note: we recommend that you rename them and keep them for a week or so as backup before deleting them.]


Dr. Watson for Windows 98 and ME

Basic Dr. Watson information:

Program name: drwatson.exe
Probable Program location: C:\WINDOWS\
Probable Report location: C:\WINDOWS\DRWATSON
Report Log name: WATSONnn.log, where nn is a number assigned automatically for each new report.

Dr. Watson is included in the Windows 98 and ME operating systems.

If you have continuing problems with application program crashes, consider starting Dr. Watson automatically when Windows starts.

To start Dr. Watson when Windows starts, put a shortcut to DRWATSON.exe in your Windows Startup group. To do this:

  1. Open My Computer
  2. Go to:
    C:
    Windows
    Start Menu
    Progam Files
    Startup
  3. Create a shortcut to drwatson.exe (example: to C:\windows\drwatson.exe).

To choose a location for the Dr. Watson logs:

  1. Start Dr. Watson
  2. Right-click on the Dr. Watson icon in your Windows taskbar, lower-right corner.
  3. Select Options. It has a place where it puts the logs.

How to send the reports to us

  1. Send the WATSONnn.LOG as an email attachment to crash@slsknet.org.

  2. Include a description of what you were doing with Soulseek when it crashed.


Top