Thunderbird:OpenPGP: Difference between revisions

Jump to navigation Jump to search
→‎Debugging / Tracing: Improve readability through code formatting and dividing into chapters with heading
(add information about tracing the enigmail migration with extensions.enigmail.logDirectory)
(→‎Debugging / Tracing: Improve readability through code formatting and dividing into chapters with heading)
Line 58: Line 58:
If you run into a problem, you may try the following mechanisms to obtain additional information, which may be useful for you, or for the Thunderbird developers when reporting a problem, to analyze the cause.
If you run into a problem, you may try the following mechanisms to obtain additional information, which may be useful for you, or for the Thunderbird developers when reporting a problem, to analyze the cause.


The simplest is to open the Thunderbird Error Console. You can open it from the menu, Tools, Developer Tools, Error Console. Messages shown in red are of particular interest.
=== Error Console ===
The simplest is to open the Thunderbird Error Console. You can open it from the menu Tools→Developer Tools→Error Console. Messages shown in red are of particular interest.


To view some details about the processing of messages, you may set a preference in Thunderbird. Open preferences, general, find the config editor. Add a new preference of the name temp.openpgp.logDirectory and set it to a string value, which must be the full name of a temporary directory, for example on Linux or macOS you could use value /tmp/ . Once set, Thunderbird will write messages to a file named enigdbug.txt in that directory. The log will have a lot of information, most of which is harmless or not interesting. But it may contain clues about the cause of a problem.
=== OpenPGP log ===
To view some details about the processing of messages, you may set a preference in Thunderbird. Open menu Edit→Preferences→General, find the Config Editor. Add a new preference of the name <code>temp.openpgp.logDirectory</code> and set it to a string value, which must be the full name of a temporary directory, for example on Linux or macOS you could use value <code>/tmp/</code> . Once set, Thunderbird will write messages to a file named <code>enigdbug.txt</code> in that directory. The log will have a lot of information, most of which is harmless or not interesting. But it may contain clues about the cause of a problem.


If you're trying to analyze a problem in the migration process that is performed by the Enigmail 2.2.x Add-on, please set the additional preference extensions.enigmail.logDirectory - it must also be set to a directory, but that must be a different directory than above. For example, create a directory named /tmp/enig22 and set extensions.enigmail.logDirectory to string value /tmp/enig22 . If you set both variables, then two separate files will be created, both named enigdbug.txt
=== Enigmail 2.2.x Add-on log ===
If you're trying to analyze a problem in the migration process that is performed by the Enigmail 2.2.x Add-on, please set the additional preference <code>extensions.enigmail.logDirectory</code> - it must also be set to a directory, but that must be a different directory than the one for OpenPGP log. For example, create a directory named <code>/tmp/enig22</code> and set <code>extensions.enigmail.logDirectory</code> to string value <code>/tmp/enig22</code>. If you set both variables, then two separate debug log files will be created, both named <code>enigdbug.txt</code>.


Advanced users may attempt to view internal error messages produced by the OpenPGP cryptographic engine that Thunderbird uses (the RNP library). To do so, you need to set the environment variable called RNP_LOG_CONSOLE, e.g. in a Linux terminal you could do that using the command export RNP_LOG_CONSOLE=1. Then you must start Thunderbird from within that terminal window, to ensure that it will see the environment variable that you have set.
=== RNP log ===
Advanced users may attempt to view internal error messages produced by the OpenPGP cryptographic engine that Thunderbird uses (the RNP library). To do so, you need to set the environment variable called <code>RNP_LOG_CONSOLE</code>, e.g. in a Linux terminal you could do that using the command <code>export RNP_LOG_CONSOLE=1</code>. Then you must start Thunderbird from within that terminal window, to ensure that it will see the environment variable that you have set.


[[category:Thunderbird|*]]
[[category:Thunderbird|*]]
19

edits

Navigation menu