Changes between Version 3 and Version 4 of Logging
- Timestamp:
- 01/12/17 10:15:30 (4 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Logging
v3 v4 8 8 == Basics == 9 9 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: 10 Otherwise, 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 {{{ 12 xpra attach -d geometry 13 }}} 14 The full list of debugging categories can be found with {{{xpra -d help}}}, see below for a command output example. 15 16 Use the special category value "all" to enable all logging. (this will be very verbose) 17 18 [[BR]] 19 20 You can also prefix the {{{CATEGORY}}} with a dash "{{{-}}}" to disable debug logging for it. For example, to log everything except "window" category: 12 21 {{{ 13 22 xpra start :10 -d all,-window … … 28 37 29 38 [[BR]] 30 It is also possible to enable and disable debug logging at runtime using:39 It is also possible to enable and disable debug logging of a server at runtime using: 31 40 {{{ 32 41 xpra control :DISPLAY debug enable CATEGORY … … 40 49 xpra control :DISPLAY debug status 41 50 }}} 42 43 }}} 51 These commands are also available trough the server's dbus interface, see #904. 52 }}} 53 44 54 45 55 {{{#!div class="box" 46 56 == Detailed Logging == 47 57 48 Some subsystems require special environment variables to enable logging, this is to minimize the cost of logging in performance critical paths. 58 Some 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. 49 59 50 60 For example: … … 66 76 }}} 67 77 68 69 78 Please refer to the source code for details and more up to date information. 70 79 }}} … … 74 83 == Logging Categories == 75 84 76 You can get the list of debugging categories with a brief explanation by running (version 0.16 onwards only):85 You can get the list of debugging categories with a brief explanation by running: 77 86 {{{ 78 87 $ xpra -d help … … 81 90 * client : All client code 82 91 * paint : Client window paint code 92 * draw : Client draw packets 83 93 * cairo : Cairo paint code used with the GTK3 client 84 94 * opengl : Client OpenGL rendering 85 * events : System and window events86 95 * info : About and Session info dialogs 87 96 * launcher : The client launcher program … … 94 103 * keyboard : Keyboard mapping and key event handling 95 104 * screen : Screen and workarea dimension 105 * fps : Frames per second 96 106 * xsettings : XSettings synchronization 97 107 * dbus : DBUS calls 108 * rpc : Remote Procedure Calls 109 * menu : Menus 110 * events : System and window events 98 111 Window: 99 112 * window : All window code 113 * damage : Window X11 repaint events 114 * geometry : Window geometry 100 115 * shape : Window shape forwarding (XShape) 101 116 * focus : Window focus … … 104 119 * state : Window state 105 120 * icon : Window icons 121 * frame : Window frame 106 122 Encoding: 107 * codec : FIXME: only nvenc4 and nvenc5,loader and video helper123 * codec : Codec loader and video helper 108 124 * loader : Pixel compression codec loader 109 * video : Video codecs125 * video : Video encoding 110 126 * score : Video pipeline scoring and selection 111 127 * encoding : Server side encoding selection and compression 112 * scaling : Scaling: automatic scaling calculations128 * scaling : Picture scaling 113 129 * delta : Delta pre-compression 130 * scroll : Scrolling detection and compression 114 131 * xor : XOR delta pre-compression 115 132 * subregion : Video subregion processing … … 122 139 * cuda : CUDA device access (nvenc) 123 140 * cython : Cython CSC module 124 * opencl : OpenCL CSC module125 141 * swscale : swscale CSC module 142 * libyuv : libyuv CSC module 126 143 * decoder : All decoders 127 144 * encoder : All encoders 128 145 * 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 130 149 * vpx : libvpx encoder and decoder 131 150 * nvenc : nvenc encoder (all versions) 132 151 * x264 : libx264 encoder 133 * webp : libwebp encoder and decoder 152 * x265 : libx265 encoder 153 * webcam : webcam access 134 154 Pointer: 135 155 * mouse : Mouse motion … … 139 159 * util : All utility functions 140 160 * gobject : Command line clients 161 * grab : Window grabs (both keyboard and mouse) 141 162 * test : Test code 142 163 * verbose : Very verbose flag 143 164 Network: 144 165 * network : All network code 166 * http : HTTP requests 145 167 * mmap : mmap transfers 146 168 * protocol : Packet input and output (formatting, parsing, sending and receiving) 169 * websocket : Websocket layer 147 170 * crypto : Encryption 148 171 * auth : Authentication … … 153 176 * command : Server control channel 154 177 * timeout : Server timeouts 178 * exec : Executing commands 155 179 * mdns : mDNS session publishing 156 180 * stats : Server statistics 157 * grab : Window grabs158 181 * xshm : XShm pixel capture 159 182 Sound: 160 183 * sound : All sound 184 * gstreamer : GStreamer internal messages 161 185 * av-sync : Audio-video sync 162 186 X11:
copyleft 2010 - 2021
