Specifications

System Software Diagnostics Guide — September 2006 81
Dlgsnapshot Reference
[DM3]
;DETECTOR_AGENT = libdlgdm3detectoragent
FAULTDETECTOR_AGENT = libdlgdm3faultdetectoragent
;INITIALIZER_AGENT = libdlgdm3initializeragent
;CLOCKING_AGENT = libdlgdm3clockagent
;DIAGNOSTIC_AGENT = libdlgdm3diagagent
You must change it to the following (bold text shows the changed line):
[DM3]
;DETECTOR_AGENT = libdlgdm3detectoragent
FAULTDETECTOR_AGENT = libdlgdm3faultdetectoragent
;INITIALIZER_AGENT = libdlgdm3initializeragent
;CLOCKING_AGENT = libdlgdm3clockagent
DIAGNOSTIC_AGENT = libdlgdm3diagagent
When you make this change, Dlgsnapshot will run automatically when a fault is detected.
15.3.2 Running Dlgsnapshot on Demand
The Dlgsnapshot tool can also be run on demand from the command line. SeeSection 15.3.3,
“Command Line Options”, on page 81. Running Dlgsnapshot from the command line may also
stop the board, depending on the options selected.
If you try to run the Dlgsnapshot tool on a board version that doesn’t support it, you will get a
message that Dlgsnapshot is not supported and the command failed.
15.3.3 Command Line Options
The Dlgsnapshot tool uses the following command line options:
-f<number 1 to 6>
This option, which is mandatory, indicates which print buffer will be dumped. Values are as
follows:
1 – SRAM (not applicable to all releases)
2 – DRIVER_BOARD_STATE_DUMP
3 – DRIVER_BOARD_COUNTER_DUMP (Windows only)
4 – DOWNLOAD_OFFDIAG
5 – PROCESSOR_DUMP_ONLY (this value requires that you use the
-r option)
6 – DUMP_ALL (this value requires that you use the
-r option)
-a<AUID>
Dumps the print buffer of the processor specified with the
-r option on the board with the
given Addressable Unit IDentifier (AUID).
-r<processor number>
The
-r option is mandatory with -f option 5 or 6.
-l<logical ID>
Dumps the print buffer of the processor specified with the
-r option on the board with the
given logical ID.