Debug filter.cfg: Difference between revisions

More
    Zacam (talk | contribs)
    98 edits
    Creation of debug_filter.cfg page
     
    m category added
     
    (6 intermediate revisions by 3 users not shown)
    Line 1: Line 1:
    == debug_filter.cfg ==
    {{TableVersion|bd0a144/20170214}}


    The following list is (as of 3.6.13 SVN 6515) is all of the possible options for putting into a debug_filter.cfg which should be located in your FreeSpace2/Data directory
    == Overview ==


    A '+' means that the item listed will have output generated ot the fs2_open.log or Fred2_open.log. A '-' means to disregard those items and not print output from them.
    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\FreeSpaceOpen\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.
     
    ===+CFileDebug===
     
    Outputs the full path where a requested file was found in cfile.cpp.
     
    ===+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.  Seems to be removed after 3.7.4, probably during the FFMpeg conversion.
     
    ===+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.  Seems to be removed after 3.7.4, probably during the FFMpeg conversion.
     
    ===+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.
     
    ===+Speech===
     
    Some statements to help identify issues with loading text to speech.
     
    ===+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.
     
    ===+Weapons===
     
    Debugs when a weapon is not being loaded in weapons.cpp.
     
    == 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 10: Line 212:
    +Alan
    +Alan
    +Allender
    +Allender
    +Andsager
    +Beam
    +Beam
    +BMP DEBUG
    +BMP DEBUG
    Line 17: Line 218:
    +BmpMan
    +BmpMan
    +CD
    +CD
    +CFileDebug
    +Collision
    +Collision
    +Error
    +Error
    Line 30: Line 232:
    +Mike
    +Mike
    +MissionLog
    +MissionLog
    +MK
    +Model
    +Model
    +ModelAnim
    +ModelAnim
    Line 48: Line 249:
    +SHADER-DEBUG
    +SHADER-DEBUG
    +Sound
    +Sound
    +Speech
    +UI
    +UI
    +Warning
    +Warning
    +Wash
    +Wash
    +Weapons
    </pre>
    </pre>
    [[Category:Source Code Project]]

    Latest revision as of 12:01, 14 September 2021

    Revision information.....

    FSO Revision: bd0a144/20170214
    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\FreeSpaceOpen\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.

    +CFileDebug

    Outputs the full path where a requested file was found in cfile.cpp.

    +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. Seems to be removed after 3.7.4, probably during the FFMpeg conversion.

    +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. Seems to be removed after 3.7.4, probably during the FFMpeg conversion.

    +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.

    +Speech

    Some statements to help identify issues with loading text to speech.

    +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.

    +Weapons

    Debugs when a weapon is not being loaded in weapons.cpp.

    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
+CFileDebug
+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
+Speech
+UI
+Warning
+Wash
+Weapons
    Retrieved from "http://64.226.123.83/index.php?title=Debug_filter.cfg&oldid=63508"