Manual:Huggle/Debugging

From MediaWiki.org
Jump to navigation Jump to search

Other languages:
English • ‎español • ‎日本語
Note

  The manual is a work in progress. Please add to it with complete, tested instructions wherever you can.  

Images in the manual may differ from what you see in your version of Huggle.

Debugging huggle[edit]

When things go wrong and huggle doesn't behave as it should, there is a fairly large toolkit that can be used to debug what is wrong.

Verbosity of program[edit]

Huggle can be started in so called "debug mode" in this mode, interface contains few buttons and menus that are normally hidden and display much more technical information that normally aren't visible. You can start huggle in verbose mode by passing it -v parameter where amount of v's is level of verbosity (for example -vv is verbosity level 2).

You can also switch running huggle into debug mode (it can't be switched back though) by opening help -> about and moving the mouse cursor over name of Petrb and Addshore. Doing so (approx. 10 times) will pop up a message box.

System log[edit]

Huggle produces a system log, this log contains more information when in debug mode. It can be dumped out to a file using parameter --syslog <name of file>.

If you are reporting a bug or problem with huggle, this system log can be useful for developers in order to figure out what is wrong.

Traffic dump[edit]

One of most effective ways to diagnose the issues. Enabling traffic dump using parameter --qd will generate output file that contains raw traffic sent by huggle and received from web servers. This file can be very huge even in very short time. It may contain sensitive information and it's recommended to examine it before sending to anyone untrusted.