Citrix DumpCheck Utility (Command Line)
Version 1.4
Created Date: 02/20/2006
Updated Date: 07/31/2006
Description
The Citrix DumpCheck Utility helps diagnose corrupt dumps. This tool is easier and quicker to use than launching WinDbg.exe and then loading the dump, and so on.
Unlike the Explorer extension described in CTX108825 – Citrix DumpCheck Explorer Extension version 1.4, it doesn’t require changing the environment.
Additionally this command line utility should not have problems with the old DBGENG.dll library, which can happen with the Explorer extension version.
Installing Citrix DumpCheck Utility
1. Download the archive file to a local workstation.
2. Unzip the dmpchkex.zip into a local folder.
How to Use Citrix DumpCheck Utility
C:\Tools>dmpchkex.exe
Citrix DumpCheck Utility v1.4 - written by Dmitry Vostokov
Usage: dmpchkex <file>
Specify the file name as its command line argument:
C:\Tools>dmpchkex.exe "C:\Documents and Settings\All Users\Application Data\Microsoft\Dr Watson\user.dmp"
For good dumps, you see the following message:
“Dump has been opened and closed successfully!”
For possibly corrupt dumps, you see a different message, for example:
“The file or directory is corrupted and unreadable.”
If you specify the wrong path, you receive a “The system cannot find the file specified.” error message:
This tool also shows the dump type so you can check this immediately. For example, if you ask for complete memory but got a kernel memory dump instead. Also, if you get a user mini dump instead of a full user dump the tool reminds you to set the Dr. Watson option. For example:
1. Complete memory dump:
“Dump has been opened and closed successfully!
Dump type: Complete memory dump”
2. Kernel memory dump:
“Dump has been opened and closed successfully!
Dump type: Kernel memory dump”
3. Small system dump:
“Dump has been opened and closed successfully!
Dump type: Kernel Mini Dump – please set ‘Kernel memory dump’ in Control Panel System Startup and Recovery dialog”
4. User Mini Dump:
“Dump has been opened and closed successfully!
Dump type: User Mini Dump - please set Crash Dump Type option to Full in Dr. Watson (drwtsn32.exe)”
5. Normal (Full) user dump:
“Dump has been opened and closed successfully!
Dump type: User memory dump”
Note: In rare cases when the extension tells you that the dump is corrupt, double-check it by using another method, such as WinDbg.exe. If the extension tells you that the dump was opened and closed successfully, the dump is probably good and you can send it to Dev Analysis.
However there are situations where the dump is truncated–this tool doesn’t recognize this. A good indicator is the size of the dump file. If this tool reports complete memory dump but the size of the file is less than the amount of physical memory (that is, 2 gigabytes (GB)), this is a good indication of a truncated file which might not be useful for analysis.
Uninstalling Citrix DumpCheck
To uninstall this utility, delete dmpchkex.exe.
Disclaimer
These software applications are provided to you as is with no representations, warranties or conditions of any kind. You may use and distribute it at your own risk. CITRIX DISCLAIMS ALL WARRANTIES WHATSOEVER, EXPRESS, IMPLIED, WRITTEN, ORAL OR STATUTORY, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT. Without limiting the generality of the foregoing, you acknowledge and agree that (a) the software application may exhibit errors, design flaws or other problems, possibly resulting in loss of data or damage to property; (b) it may not be possible to make the software application fully functional; and (c) Citrix may, without notice or liability to you, cease to make available the current version and/or any future versions of the software application. In no event should the code be used to support of ultra-hazardous activities, including but not limited to life support or blasting activities. NEITHER CITRIX NOR ITS AFFILIATES OR AGENTS WILL BE LIABLE, UNDER BREACH OF CONTRACT OR ANY OTHER THEORY OF LIABILITY, FOR ANY DAMAGES WHATSOEVER ARISING FROM USE OF THE SOFTWARE APPLICATION, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the code.
