xpra icon
Bug tracker and wiki

This bug tracker and wiki are being discontinued
please use https://github.com/Xpra-org/xpra instead.


Changes between Version 3 and Version 4 of Logging


Ignore:
Timestamp:
01/12/17 10:15:30 (5 years ago)
Author:
Antoine Martin
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Logging

    v3 v4  
    88== Basics ==
    99
    10 Otherwise, a good first step is to start xpra from the command line and add "{{{-d CATEGORY}}}" to it. The list of categories can be found with {{{xpra -d help}}}.
    11 You can also prefix the {{{CATEGORY}}} with a dash "{{{-}}}" to disable debug logging for it. ie:
     10Otherwise, a good first step is to start xpra from the command line and add "{{{-d CATEGORY}}}" to it, for example to debug geometry issues:
     11{{{
     12xpra attach -d geometry
     13}}}
     14The full list of debugging categories can be found with {{{xpra -d help}}}, see below for a command output example.
     15
     16Use the special category value "all" to enable all logging. (this will be very verbose)
     17
     18[[BR]]
     19
     20You can also prefix the {{{CATEGORY}}} with a dash "{{{-}}}" to disable debug logging for it. For example, to log everything except "window" category:
    1221{{{
    1322xpra start :10 -d all,-window
     
    2837
    2938[[BR]]
    30 It is also possible to enable and disable debug logging at runtime using:
     39It is also possible to enable and disable debug logging of a server at runtime using:
    3140{{{
    3241xpra control :DISPLAY debug enable CATEGORY
     
    4049xpra control :DISPLAY debug status
    4150}}}
    42 
    43 }}}
     51These commands are also available trough the server's dbus interface, see #904.
     52}}}
     53
    4454
    4555{{{#!div class="box"
    4656== Detailed Logging ==
    4757
    48 Some subsystems require special environment variables to enable logging, this is to minimize the cost of logging in performance critical paths.
     58Some subsystems require special environment variables to enable logging, this is to minimize the cost of logging in performance critical paths. In particular the X11 bindings which can process thousands of events per second.
    4959
    5060For example:
     
    6676}}}
    6777
    68 
    6978Please refer to the source code for details and more up to date information.
    7079}}}
     
    7483== Logging Categories ==
    7584
    76 You can get the list of debugging categories with a brief explanation by running (version 0.16 onwards only):
     85You can get the list of debugging categories with a brief explanation by running:
    7786{{{
    7887$ xpra -d help
     
    8190 * client          : All client code
    8291 * paint           : Client window paint code
     92 * draw            : Client draw packets
    8393 * cairo           : Cairo paint code used with the GTK3 client
    8494 * opengl          : Client OpenGL rendering
    85  * events          : System and window events
    8695 * info            : About and Session info dialogs
    8796 * launcher        : The client launcher program
     
    94103 * keyboard        : Keyboard mapping and key event handling
    95104 * screen          : Screen and workarea dimension
     105 * fps             : Frames per second
    96106 * xsettings       : XSettings synchronization
    97107 * dbus            : DBUS calls
     108 * rpc             : Remote Procedure Calls
     109 * menu            : Menus
     110 * events          : System and window events
    98111Window:
    99112 * window          : All window code
     113 * damage          : Window X11 repaint events
     114 * geometry        : Window geometry
    100115 * shape           : Window shape forwarding (XShape)
    101116 * focus           : Window focus
     
    104119 * state           : Window state
    105120 * icon            : Window icons
     121 * frame           : Window frame
    106122Encoding:
    107  * codec           : FIXME: only nvenc4 and nvenc5, loader and video helper
     123 * codec           : Codec loader and video helper
    108124 * loader          : Pixel compression codec loader
    109  * video           : Video codecs
     125 * video           : Video encoding
    110126 * score           : Video pipeline scoring and selection
    111127 * encoding        : Server side encoding selection and compression
    112  * scaling         : Scaling: automatic scaling calculations
     128 * scaling         : Picture scaling
    113129 * delta           : Delta pre-compression
     130 * scroll          : Scrolling detection and compression
    114131 * xor             : XOR delta pre-compression
    115132 * subregion       : Video subregion processing
     
    122139 * cuda            : CUDA device access (nvenc)
    123140 * cython          : Cython CSC module
    124  * opencl          : OpenCL CSC module
    125141 * swscale         : swscale CSC module
     142 * libyuv          : libyuv CSC module
    126143 * decoder         : All decoders
    127144 * encoder         : All encoders
    128145 * avcodec         : avcodec decoder
    129  * libav           : libav common code (swscale and avcodec)
     146 * libav           : libav common code (used by swscale, avcodec and ffmpeg)
     147 * ffmpeg          : ffmpeg encoder
     148 * pillow          : Pillow encoder and decoder
    130149 * vpx             : libvpx encoder and decoder
    131150 * nvenc           : nvenc encoder (all versions)
    132151 * x264            : libx264 encoder
    133  * webp            : libwebp encoder and decoder
     152 * x265            : libx265 encoder
     153 * webcam          : webcam access
    134154Pointer:
    135155 * mouse           : Mouse motion
     
    139159 * util            : All utility functions
    140160 * gobject         : Command line clients
     161 * grab            : Window grabs (both keyboard and mouse)
    141162 * test            : Test code
    142163 * verbose         : Very verbose flag
    143164Network:
    144165 * network         : All network code
     166 * http            : HTTP requests
    145167 * mmap            : mmap transfers
    146168 * protocol        : Packet input and output (formatting, parsing, sending and receiving)
     169 * websocket       : Websocket layer
    147170 * crypto          : Encryption
    148171 * auth            : Authentication
     
    153176 * command         : Server control channel
    154177 * timeout         : Server timeouts
     178 * exec            : Executing commands
    155179 * mdns            : mDNS session publishing
    156180 * stats           : Server statistics
    157  * grab            : Window grabs
    158181 * xshm            : XShm pixel capture
    159182Sound:
    160183 * sound           : All sound
     184 * gstreamer       : GStreamer internal messages
    161185 * av-sync         : Audio-video sync
    162186X11: