doc: update after PIPEWIRE_DEBUG changes

This commit is contained in:
Wim Taymans 2022-12-16 18:29:19 +01:00
parent 6a69152185
commit 846dbce7f1
2 changed files with 6 additions and 7 deletions

View file

@ -133,15 +133,14 @@ Allowed configuration file sections are:
# Logging # Logging
The `PIPEWIRE_DEBUG` environment variable can be used to enable The `PIPEWIRE_DEBUG` environment variable can be used to enable
more debugging. This variable supports one of two formats: more debugging. This variable supports the following format:
- `PIPEWIRE_DEBUG=<level>` where `<level>` is either a numerical log level or its - `PIPEWIRE_DEBUG=[<level>][,<glob1>:<level1>][,<glob2>:<level2>,...]` where the globs are
respective key, see below.
- `PIPEWIRE_DEBUG=<glob1>:<level1>,<glob2>:<level2>,...` where the globs are
shell globs to match on log topics and the levels are the respective shell globs to match on log topics and the levels are the respective
log level to set for that topic. Globs are applied in order and a matching log level to set for that topic. Globs are applied in order and a matching
glob overrides an earlier glob for that category. For example, glob overrides an earlier glob for that category. A level without a glob
`PIPEWIRE_DEBUG=*:E,mod.*:D,mod.foo:X` enables global error messages, prefix will set the global log level and is a more preformant version of
`*:<level>`. For example, `PIPEWIRE_DEBUG=E,mod.*:D,mod.foo:X` enables global error messages,
debugging on all modules but no messages on the foo module. debugging on all modules but no messages on the foo module.
- `<level>` specifies the log level: - `<level>` specifies the log level:

View file

@ -530,7 +530,7 @@ parse_pw_debug_env(void)
if (!str || (slen = strlen(str)) == 0) if (!str || (slen = strlen(str)) == 0)
return NULL; return NULL;
/* String format is PIPEWIRE_DEBUG=<glob>:<level>[,<glob>:<level>,...], /* String format is PIPEWIRE_DEBUG=[<glob>:]<level>,...,
* converted into [{ conn.* = 0}, {glob = level}, {glob = level}, ....] , * converted into [{ conn.* = 0}, {glob = level}, {glob = level}, ....] ,
* with the connection namespace disabled by default. * with the connection namespace disabled by default.
*/ */