OpenPunk
/
citra
mirror of https://github.com/citra-emu/citra.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Page: Log Filters
Pages
AES Keys Archive of 3DS Documentation Archive of 3DS Tests Building for Android Building for Linux Building for OpenBSD Building for Windows Building for macOS CPU Citra Android user data and storage Citra Legacy Builds Citra Web Service Common Issues Compatibility List Contributing Default Keyboard Bindings Developer Information Dumping Config Savegame from a 3DS Console Dumping Extra Data from a 3DS Console Dumping Game Cartridges Dumping Installed Titles Dumping Save Data from a 3DS Console Dumping System Archives and the Shared Fonts from a 3DS Console Dumping Updates and DLCs FAQ Home Installing FFmpeg for the Video Dumper Issue Labels Lifetime of an LLE library applet Log Filters Set Up APK Signing in Bitrise Stack Trace Guide for Citra Typical Git Workflow User Directory Using a Controller or Android Phone for Motion or Touch Input
10 Log Filters
Creak edited this page 2021-10-17 16:42:51 -04:00
Table of Contents

Citra supports configurable filtering of log message per-class. This is especially useful if you're debugging a subsystem and want very detailed messages from it or if you want to silence some annoyingly spammy errors (e.g. unimplemented GPU features.)

Messages are filtered in each class according to their severity, the filter will block all messages in the class that are below the configured severity. The severity levels are:

  • Trace: Extremely detailed and repetitive (many times per frame) debugging information that is likely to pollute logs.
  • Debug: Less detailed debugging information.
  • Info: Status information from important points during execution.
  • Warning: Minor or potential problems found during execution of a task.
  • Error: Major problems found during execution of a task that prevent it from being completed.
  • Critical: Major problems during execution that threathen the stability of the entire application. (This severity cannot be filtered out.)

Note that Trace is permanently filtered out in non-Debug builds for performance reasons.

Class names can be discovered from the log messages themselves. For example, this message is in the class Service:

[  10.285042] Service <Error> core/hle/service/service.h:Service::Interface::SyncRequest:84: unknown/unimplemented function '0x01020000': port=APT:U

A complete list can be found in the source in log.h

Log Filters

To configure the log filter, you need to change the configuration in Emulation > Configure... > General > Debug. Change the Logging > Global Log Filter setting.

The filter string consists of a space-separated list of filter rules, each of the format <class>:<level>. <class> is a log class name, with subclasses separated using periods. * wildcards are allowed and can be used to apply a rule to all classes . <level> a severity level name which will be set as the minimum logging level of the matched classes. Rules are applied left to right, with later rules overriding previous ones in the sequence.

A few examples of filter rules:

  • *:Info -- Resets the level of all classes to Info.
  • Service:Info -- Sets the level of Service to Info (without affecting its subclasses).
  • Service.FS:Trace -- Sets the level of the Service.FS class to Trace.

Home