Tvheadend

h1. Traces - verbose debugging

Please, *read this whole information*. If you *don't see [TRACE] lines in the log file*, you *misconfigured* something and we will ask you for new feedback which slows down the help process.

It is quite usual that a developer asks you to provide more verbose logs using the trace (verbose logs for development) which tvheadend includes. If you see --trace <comma_separated_list_of_subsystems> you need to follow this.

Compile tvheadend using --enable-trace option for the configure script see [[Building]] to compile tvheadend directly from sources. The traces are enabled by default, but packages - except debug versions - disable this functionality.

*!!! The [TRACE] lines are written only to the log file. You will not see them on console or syslog output. Please, enter the log file. !!!*

h2. Command-line

The first way to enable traces is from the command-line options (to specify the log file and all subsystems to debug), like:

<pre>

./build.linux/tvheadend -l /tmp/tvheadend.log --trace htsp,subscription,pat,pmt,bat

</pre>

This is the only way to get the traces for all tvheadend subsystems during the start.

h2. Web UI

The second way is to use the debugging tab in the configuration (this settings is not preserved thus tvheadend will reset it upon the new start):

!debugging.png!

h2. Example

You should see [  TRACE] lines in your log file (these lines are not in syslog file or journal)!

<pre>

2017-09-14 15:39:07.670 [  TRACE]:httpc: 0004: finishing

2017-09-14 15:39:07.672 [  TRACE]:mpegts: table: mux 0x283ea64430 destroy pmt 02/FF (2) pid 044C (1100)

2017-09-14 15:39:07.673 [  TRACE]:pcr: S23.5E/12343.5H/CT 1 HD: change   : 1532541106

2017-09-14 15:39:07.673 [  TRACE]:mpegts: input SAT>IP DVB-S Tuner #4 (192.168.100.237) got 68432 bytes

2017-09-14 15:39:07.673 [  DEBUG]:mpegts: 12343.5H in S23.5E - close PID 044C (1100) [16/0x7fc64400a900]

2017-09-14 15:39:07.674 [  TRACE]:mpegts: table: mux 0x283ea64430 free pmt 02/FF (2) pid 044C (1100)

2017-09-14 15:39:07.674 [  DEBUG]:mpegts: 12343.5H in S23.5E - close PID 044C (1100) [8/0x283ea64d00]

2017-09-14 15:39:07.674 [  DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0456 (1110) [8/0x283ea64d00]

2017-09-14 15:39:07.674 [  DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0460 (1120) [8/0x283ea64d00]

2017-09-14 15:39:07.674 [  DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0461 (1121) [8/0x283ea64d00]

2017-09-14 15:39:07.674 [  DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0462 (1122) [8/0x283ea64d00]

2017-09-14 15:39:07.674 [  DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0463 (1123) [8/0x283ea64d00]

2017-09-14 15:39:07.674 [  DEBUG]:mpegts: 12343.5H in S23.5E - close PID 046A (1130) [8/0x283ea64d00]

2017-09-14 15:39:07.674 [  DEBUG]:mpegts: 12343.5H in S23.5E - close PID 047E (1150) [8/0x283ea64d00]

2017-09-14 15:39:07.674 [  DEBUG]:mpegts: 12343.5H in S23.5E - close PID 0488 (1160) [8/0x283ea64d00]

2017-09-14 15:39:07.674 [  DEBUG]:mpegts: 12343.5H in S23.5E - stopping mux

2017-09-14 15:39:07.674 [  DEBUG]:satip: SAT>IP DVB-S Tuner #4 (192.168.100.237) - stopping 12343.5H in S23.5E

2017-09-14 15:39:07.674 [  TRACE]:mpegts: SAT>IP DVB-S Tuner #4 (192.168.100.237) - flush subscribers

2017-09-14 15:39:07.674 [  TRACE]:mpegts: 12343.5H in S23.5E - flush tables

2017-09-14 15:39:07.674 [  TRACE]:descrambler: mux 0x283ea64430 - flush tables

</pre>