Tracing Options

The Trace Fixup checks application compatibility, by configuring and setting filtering levels in the Tracing Options dialog.

For example, in the image below we choose to get all the failures from the filesystem functions. The Trace Fixup filters out by default specific failures which it considers expected.

Edit JSON Dialog

NotePress double-click in the New Value column next to the property name to change its value.

Properties

  • waitForDebugger - Hold the process until a debugger is attached in the DLL_PROCESS_ATTACH callback. The property holds a boolean and the default value is false.
  • traceFunctionEntry - Trace a function entry. It is useful when trying to see function call order because functions are logged in reverse order. The property holds a boolean and the default value is false.
  • traceCallingModule - Include the calling module in the output, and it is useful when checking recursion. The property holds a boolean and the default value is true. Setting its value to false might reduce the output noise.
  • traceMethod - Set the method of tracing. The property holds a string and the default value is OutputDebugString.
  • ignoreDllLoad - Ignore calls to NtCreateFile for DLLs. The property holds a boolean and the default value is true
  • traceLevels - Set what function calls are logged. The expected value is of type object.
  • breakOn - Used to set a DebugBreak in certain scenarios. The property holds an object and the default value is ignored.

For the traceLevels and breakOn objects, you need to specify the type the trace level applies to. The values are:

Property NameDescription
defaultThe default trace level for the function type. The default value is unexpectedFailures.
filesystemSet the trace level for file management functions. It corresponds to the functions listed in the documentation.
registrySet the trace level for registry functions. It corresponds to the functions listed in the documentation.
processAndThreadSet the race level for process and thread functions. It corresponds to the functions listed in the documentation.
dynamicLinkLibrarySet the trace level for DLL functions. It corresponds to the functions listed in the documentation.

Dialog options

  • Reset All - clears all the changes done to the config JSON.

NoteTo learn more about the Package Support Framework see Microsoft's documentation or GitHub repository.