Running in Debug Mode

Occasionally something goes wrong in OSForensics causing it to crash. In these cases we will often need to gather as much information as possible in order to fix the bug.

One of the ways we gather information is to ask you to run the application in debug mode. This will then generate a log file with additional details about what the program at any point in time and can help us to pinpoint where the crash occured

There are two ways to run OSForensics in Debug mode.

Option 1: Click the ‘Debug’ icon, highlighted in the image below. This will prompt OSForensics to restart and run in Debug mode, though only for one instance. If you re-start the program, it will no longer be running in this mode. When running in debug mode OSF will display a message at startup informing you that debug mode is active and telling you where the log file is going to be written.

OSForensics DEBUGMODE Icon

Option 2: If OSForensics won't start, to run OSForensics in debug mode you will need to edit the OSForensics shortcut. To do this, right click the OSForensics shortcut, in either the Start Menu or on the desktop, and then select properties. After this add the word DEBUGMODE to the end of the "Target" text box, as shown below.

OSForensics DEBUGMODE commandline

After doing this and selecting OK you can then use this shortcut to launch OSForensics in debug mode. When running in debug mode OSF will display a message at startup informing you that debug mode is active and telling you where the log file is going to be written.

Additionally if the problem involves the creating a index a log file will be created for each index made. These log files are stored with the index under the case folder. Typcially to find this look in the same folder as the first log file then browse to "Cases\%My Case Name%\Index\%My Index%\indexlog.txt". This is the same log file generated normally but with a few extra lines added. If the indexing process crashed and this folder does not exist the log file may have been moved into the same folder as the "OSFLog.txt" file and renamed "lastfailedindexlog.txt".