Debug Logs

Pierre Ossman (Work account) edited this page Dec 8, 2016 · 3 revisions

In many cases it is difficult to tell what is going on with the system without looking at log files. It is also often necessary to increase the amount of logging to figure things out. This page lists how to get those log files on different platforms.

Linux / Unix

Client

Simply add -Log *:stderr:100 to the vncviewer command line and it will output more logging. You can then easily pipe this to a file in order to attach to a bug report:

$ vncviewer -Log *:stderr:100 > tigervnc-viewer.log

You can also specify -Log *:file:100 and you'll get a log as /tmp/vncviewer.log instead.

Server

There are multiple ways to start the server on Linux, and they will produce a log file in different places.

vncserver

The log file is stored as ~/.vnc/<host>:<display>.log. Extra logging can be enabled by adding the arguments -Log *:stderr:100.

Xvnc

Logging is sent to stderr so a pipe is needed to store the output. E.g.:

$ Xvnc -Log *:stderr:100 > tigervnc-Xvnc.log

Xvnc via inetd

Unfortunately there is currently no way to get logging when started via inetd.

x0vncserver

Logging is sent to stderr so a pipe is needed to store the output. E.g.:

$ x0vncserver -Log *:stderr:100 > tigervnc-x0vncserver.log

Windows

Client

Add the arguments -Log *:file:100 and you'll get a log file as C:\temp\vncviewer.log. Note that you have to create c:\temp before you start the viewer.

Server

Add the arguments -Log *:file:100 and you'll get a log file as C:\temp\WinVNC4.log. Note that you have to create c:\temp before you start the server.

You can also add the arguments -Log *:EventLog:100 and you'll get the log messages in Windows normal Event Viewer.

OS X

The easiest way is to redirect logging to the file /tmp/vncviewer.log using:

$ open -a "TigerVNC Viewer 1.7.0" --args -Log *:file:100

If TigerVNC is not installed in Applications then you need to specify the path to the app bundle:

$ open "/some/path/TigerVNC Viewer 1.7.0.app" --args -Log *:file:100