Skip to main content

Dumpstyle

Specify the style of core dump.

Synopsis

[Debug]    dumpstyle=n

n is an integer in the range 0—4. The default value is 3.

Description

When InterSystems IRIS® data platform performs a core dump, you can set the style of the dump using this option. Values and their meanings are listed in the following.

Note:

On UNIX®, all dump styles generate a core file. The process cleans itself up as much as possible before exiting.

  • 0

    • On Windows this is the pid.dmp file.

  • 1

    • On Windows this is a Windows minidump file (type = MiniDumpWithFullMemory) named irisfpid.dmp, which can be read by WinDbg, a Microsoft debugger. This is the most complete dump option, but it can create a huge dump file.

  • 2

    • On Windows this is the old style exception processing where the process does minimal cleanup (deqallresources and GRETRELEASE) and then resignals the exception. The intention here is to catch the exception in a debugger and preserve as much information as possible to analyze.

    • On UNIX® this detaches shared memory before the Abort, so the core file does not contain the shared memory area.

  • 3

    On Windows this is a Windows minidump file (type = MiniDumpWithDataSegs | MiniDumpWithPrivateReadWriteMemory | MiniDumpWithIndirectlyReferencedMemory) named irisipid.dmp, which can be read by WinDbg. This creates a fairly large but useful dump file. This is the new default on Windows if dumpstyle is not specified.

  • 4

    On Windows this is a Windows minidump file (type = MiniDumpNormal) named irismpid.dmp, which can be read by WinDbg. This creates a small dump file containing minimal information.

The active value can be changed with $system.Config.ModifyDumpStyle(NewValue). This changes the value for all new InterSystems IRIS processes. It does not change the value in iris.cpf.

Changing This Parameter

You can change Dumpstyle by editing the CPF in a text editor (as described in Editing the Active CPF). If the CPF does not already contain the [Debug] section, you must add it yourself. For example:

[ConfigFile]
...

[Debug]      // Add the debug section if necesary
dumpstyle=2  // then, specify a value for dumpstyle.

[Databases]
...
FeedbackOpens in a new tab