Difference between revisions of "Debug filter.cfg"

From FreeSpace Wiki
Jump to: navigation, search
m (Use the templated revision information.)
(Overhaul of this page, adding a lot more information and providing a structure to add more about the use of each debug filter argument.)
Line 1: Line 1:
{{TableVersion|6515}}
+
{{TableVersion|GIT}}
  
== debug_filter.cfg ==
+
== Overview ==
  
The following list is the possible options for putting into a debug_filter.cfg which should be located in your FreeSpace2/Data directory
+
The following list is the possible options for putting into a debug_filter.cfg which should be located in your FreeSpace2 Data directory (Freespace2/data for 3.7.4 or earlier on Windows, %APPDATA%\HardLightProductions\Freespace2\data for everywhere else).
  
 
A '+' means that the item listed will have output generated to the fs2_open.log or Fred2_open.log. A '-' means to disregard those items and not print output from them.
 
A '+' means that the item listed will have output generated to the fs2_open.log or Fred2_open.log. A '-' means to disregard those items and not print output from them.
 +
 +
Strings are not case-sensitive as they are checked with stricmp().
 +
 +
== Available Options ==
 +
 +
===+AB TRAIL===
 +
 +
Debugs the creation of afterburner points on a given ship name.
 +
 +
===+AI===
 +
 +
Outputs a lot of information related to the AI code.
 +
 +
===+Alan===
 +
 +
Lots of information across various files including pre-mission screens, AI, and audio code.
 +
 +
===+allender===
 +
 +
Debugs for campaign advancement issues, arrival anchors, and some object cleanup code.
 +
 +
===+Andsager===
 +
 +
Currently unused in the code base.
 +
 +
===+BEAM===
 +
 +
Identifies bad shot_index values for type D beams, beams powering down for FOV reasons, and recycled beams.
 +
 +
===+BMP DEBUG===
 +
 +
Outputs data related to BMPMAN loads and locks, and memory usage.
 +
 +
===+BmpFastLoad===
 +
 +
Outputs when it found a bitmap.
 +
 +
===+BmpInfo===
 +
 +
Outputs when BMPMAN is loading all used bitmaps and when it completes.
 +
 +
===+BmpMan===
 +
 +
The rest of the BMPMAN specific debugging information.
 +
 +
===+CD===
 +
 +
Debugs the CD volume to the log.
 +
 +
===+collision===
 +
 +
Identifies when the game has run out of object pairs, potentially leading to failed collisions.  See objcollide.cpp.
 +
 +
===+Error===
 +
 +
Error-level issues printed to the log by default.  Can be disabled using debug_filter.cfg.
 +
 +
===+EVENTMUSIC===
 +
 +
Debugs music switching events in eventmusic.cpp.
 +
 +
===+Fred routing===
 +
 +
Debugs various dialog flows in FRED2.
 +
 +
===+General===
 +
 +
General-level issues printed to the log by default.  Can be disabled using debug_filter.cfg.
 +
 +
===+Jim===
 +
 +
Debugs the frame a weapon is set to detonate in collideshipweapon.cpp.
 +
 +
===+Joystick===
 +
 +
Debugging related to joysticks.
 +
 +
===+lethality===
 +
 +
Debugs the player's lethality and the number of turrets targeting a player.
 +
 +
===+lightning===
 +
 +
Debugs when bolts are released and when out of lightning nodes.
 +
 +
===+Maps===
 +
 +
Identifies when an animation could not be found for a given dbg_name in modelinterp.cpp.
 +
 +
===+messaging===
 +
 +
Debugs things related to the player messages in missionmessage.cpp.
 +
 +
===+Mike===
 +
 +
Debugs laser and missile counts in a frame.
 +
 +
===+missionlog===
 +
 +
Debug various things in missionlog.cpp.
 +
 +
===+MK===
 +
 +
Currently unused in the code base.
 +
 +
===+Model===
 +
 +
Reports issues with models found in the modelread.cpp code.
 +
 +
===+ModelAnim===
 +
 +
Debugs info about model animations and when they are played.
 +
 +
===+MOVIE===
 +
 +
Writes log entries when memory allocation for movies fails for various reasons.
 +
 +
===+MVE===
 +
 +
Debugs a couple of things in the decoder16.cpp file.
 +
 +
===+Network===
 +
 +
Lots of debugging related to the networking code.
 +
 +
===+OGGISH===
 +
 +
Identifies an ogg error occurred in audiostr.cpp.
 +
 +
===+OpenAL===
 +
 +
Currently debugs detected capture and playback devices.
 +
 +
===+OpenGL===
 +
 +
Logs some OpenGL errors found in gropengl.cpp.
 +
 +
===+Paging===
 +
 +
Debugs when and for what ships during a mission assets are paged in.
 +
 +
===+parse===
 +
 +
This one can get noisy, outputs lots of debugging info related to parsing files and weapons.
 +
 +
===+Particles===
 +
 +
Outputs the Num_particles high water mark in particle.cpp.
 +
 +
===+Physics===
 +
 +
Numerous log entries related to the physics and collision detection code.
 +
 +
===+Registry===
 +
 +
Debugs things read from the registry (should be gone after 3.7.4).
 +
 +
===+Sandeep===
 +
 +
Debugs when a joystick effect is played in shiphit.cpp.
 +
 +
===+SEXP===
 +
 +
Some error-logging throughout the sexp.cpp codebase.
 +
 +
===+SHADER-DEBUG===
 +
 +
Additional warning logging for the shader compilation.
 +
 +
===+Sound===
 +
 +
Additional sound related warning logging throughout the codebase.
 +
 +
===+UI===
 +
 +
A warning about bad bitmap mask switching and info about the current UI state.
 +
 +
===+Warning===
 +
 +
Warning-level issues printed to the log by default.  Can be disabled using debug_filter.cfg.
 +
 +
===+wash===
 +
 +
Engine wash output.
 +
 +
== Sample Complete debug_filter.cfg ==
 +
 +
I cannot recommend using this as-is as it will lead to a very noisy log, that will often be too large to distribute easily during troubleshooting.  Disabling parsing errors alone helps immensely with that however.
  
 
<pre>
 
<pre>
Line 12: Line 200:
 
+Alan
 
+Alan
 
+Allender
 
+Allender
+Andsager
 
 
+Beam
 
+Beam
 
+BMP DEBUG
 
+BMP DEBUG
Line 32: Line 219:
 
+Mike
 
+Mike
 
+MissionLog
 
+MissionLog
+MK
 
 
+Model
 
+Model
 
+ModelAnim
 
+ModelAnim

Revision as of 17:50, 25 July 2016

Revision information.....

FSO Revision: GIT
Note: Please update the version when the page is updated. If your edit had nothing to do with new code entries then please do not edit the version


Overview

The following list is the possible options for putting into a debug_filter.cfg which should be located in your FreeSpace2 Data directory (Freespace2/data for 3.7.4 or earlier on Windows, %APPDATA%\HardLightProductions\Freespace2\data for everywhere else).

A '+' means that the item listed will have output generated to the fs2_open.log or Fred2_open.log. A '-' means to disregard those items and not print output from them.

Strings are not case-sensitive as they are checked with stricmp().

Available Options

+AB TRAIL

Debugs the creation of afterburner points on a given ship name.

+AI

Outputs a lot of information related to the AI code.

+Alan

Lots of information across various files including pre-mission screens, AI, and audio code.

+allender

Debugs for campaign advancement issues, arrival anchors, and some object cleanup code.

+Andsager

Currently unused in the code base.

+BEAM

Identifies bad shot_index values for type D beams, beams powering down for FOV reasons, and recycled beams.

+BMP DEBUG

Outputs data related to BMPMAN loads and locks, and memory usage.

+BmpFastLoad

Outputs when it found a bitmap.

+BmpInfo

Outputs when BMPMAN is loading all used bitmaps and when it completes.

+BmpMan

The rest of the BMPMAN specific debugging information.

+CD

Debugs the CD volume to the log.

+collision

Identifies when the game has run out of object pairs, potentially leading to failed collisions. See objcollide.cpp.

+Error

Error-level issues printed to the log by default. Can be disabled using debug_filter.cfg.

+EVENTMUSIC

Debugs music switching events in eventmusic.cpp.

+Fred routing

Debugs various dialog flows in FRED2.

+General

General-level issues printed to the log by default. Can be disabled using debug_filter.cfg.

+Jim

Debugs the frame a weapon is set to detonate in collideshipweapon.cpp.

+Joystick

Debugging related to joysticks.

+lethality

Debugs the player's lethality and the number of turrets targeting a player.

+lightning

Debugs when bolts are released and when out of lightning nodes.

+Maps

Identifies when an animation could not be found for a given dbg_name in modelinterp.cpp.

+messaging

Debugs things related to the player messages in missionmessage.cpp.

+Mike

Debugs laser and missile counts in a frame.

+missionlog

Debug various things in missionlog.cpp.

+MK

Currently unused in the code base.

+Model

Reports issues with models found in the modelread.cpp code.

+ModelAnim

Debugs info about model animations and when they are played.

+MOVIE

Writes log entries when memory allocation for movies fails for various reasons.

+MVE

Debugs a couple of things in the decoder16.cpp file.

+Network

Lots of debugging related to the networking code.

+OGGISH

Identifies an ogg error occurred in audiostr.cpp.

+OpenAL

Currently debugs detected capture and playback devices.

+OpenGL

Logs some OpenGL errors found in gropengl.cpp.

+Paging

Debugs when and for what ships during a mission assets are paged in.

+parse

This one can get noisy, outputs lots of debugging info related to parsing files and weapons.

+Particles

Outputs the Num_particles high water mark in particle.cpp.

+Physics

Numerous log entries related to the physics and collision detection code.

+Registry

Debugs things read from the registry (should be gone after 3.7.4).

+Sandeep

Debugs when a joystick effect is played in shiphit.cpp.

+SEXP

Some error-logging throughout the sexp.cpp codebase.

+SHADER-DEBUG

Additional warning logging for the shader compilation.

+Sound

Additional sound related warning logging throughout the codebase.

+UI

A warning about bad bitmap mask switching and info about the current UI state.

+Warning

Warning-level issues printed to the log by default. Can be disabled using debug_filter.cfg.

+wash

Engine wash output.

Sample Complete debug_filter.cfg

I cannot recommend using this as-is as it will lead to a very noisy log, that will often be too large to distribute easily during troubleshooting. Disabling parsing errors alone helps immensely with that however.

+AB TRAIL
+AI
+Alan
+Allender
+Beam
+BMP DEBUG
+BmpFastLoad
+BmpInfo
+BmpMan
+CD
+Collision
+Error
+EVENTMUSIC
+Fred routing
+General
+Jim
+JOYSTICK
+Lethality
+Lightning
+Maps
+Messaging
+Mike
+MissionLog
+Model
+ModelAnim
+MOVIE
+MVE
+Network
+OGGISH
+OpenAL
+OpenGL
+Paging
+Parse
+Particles
+Physics
+Registry
+Sandeep
+SEXP
+SHADER-DEBUG
+Sound
+UI
+Warning
+Wash