1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.13"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Remmina - The GTK+ Remote Desktop Client: Remmina-debugging.md Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectlogo"><img alt="Logo" src="org.remmina.Remmina.png"/></td>
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">Remmina - The GTK+ Remote Desktop Client
 <span id="projectnumber">v1.4.33</span>
</div>
<div id="projectbrief">Remmina is a remote desktop client written in GTK+, aiming to be useful for system administrators and travellers, who need to work with lots of remote computers in front of either large monitors or tiny netbooks. Remmina supports multiple network protocols in an integrated and consistent user interface. Currently RDP, VNC, NX, XDMCP and SSH are supported.</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
</script>
<div id="main-nav"></div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('_remmina-debugging_8md.html','');});
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div class="header">
<div class="headertitle">
<div class="title">Remmina-debugging.md</div> </div>
</div><!--header-->
<div class="contents">
<a href="_remmina-debugging_8md.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> # General information</div><div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> Plugins can have seperate log level options. They have no connection to the Remmina debug window or any environment variables. (Explained below)</div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> </div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> More specifically the RDP, GVNC and SSH plugins have options in the connection profile to raise up and/or set the log level.</div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> </div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> # Debugging mode</div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> </div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> ## GUI way</div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> You can just open a debug window inside of Remmina.</div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> </div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> - Click on the 3 dots at the top of Remmina.</div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> - Click on 'Debugging'</div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> </div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span> Just keep that window open and you'll see there will be quite a few debug messages shortly.</div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span> </div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> ## Terminal way</div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> Firstly, you have to be sure that Remmina isn't already running:</div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span> </div><div class="line"><a name="l00020"></a><span class="lineno"> 20</span> - Open a terminal (gnome-terminal, mate-terminal, xterm, alacritty, just to name a few...)</div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> </div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span> Your desktop environment will surely have a terminal, so you won't have to install one.</div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> </div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> ```bash</div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span> pkill remmina</div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> ps -ef | grep remmina</div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> ```</div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> </div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> In order to start Remmina in debug mode, we have to tell the underlying library GLib that we want debug messages to be printed into the terminal. For more information, please visit the GLib documentation: https://docs.gtk.org/glib/running.html</div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> </div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span> - For that we start Remmina with the `environment variables` `G_MESSAGES_PREFIXED` and `G_MESSAGES_DEBUG` both set to `all`.</div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> </div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span> ### Installed through apt-get, yum, pacman, rpm, or compiled with sources.</div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> ```bash</div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> G_MESSAGES_PREFIXED=all G_MESSAGES_DEBUG=all remmina</div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span> ```</div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span> </div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span> # Installed through Flatpak</div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span> ```bash</div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span> G_MESSAGES_PREFIXED=all G_MESSAGES_DEBUG=all flatpak run org.remmina.Remmina</div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span> ```</div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span> </div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span> # Installed through Snap</div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span> ```bash</div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span> G_MESSAGES_PREFIXED=all G_MESSAGES_DEBUG=all snap run remmina</div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span> ```</div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span> </div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span> ## Remmina crashes</div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span> </div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> When Remmina crashes we need a backtrace if possible</div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span> </div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span> ### gdb backtrace with a distribution provided package</div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span> </div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span> Install the remmina debug symbols if available</div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span> </div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span> ```</div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span> gdb remmina</div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span> ```</div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span> </div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span> At the prompt type run, reproduce the crash, and at the prompt type `bt full`</div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span> </div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span> ### gdb backtrace on a snap package</div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span> </div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span> You may need to reinstall remmina with `--devmode`</div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span> </div><div class="line"><a name="l00066"></a><span class="lineno"> 66</span> ```</div><div class="line"><a name="l00067"></a><span class="lineno"> 67</span> snap install --devmode remmina</div><div class="line"><a name="l00068"></a><span class="lineno"> 68</span> ```</div><div class="line"><a name="l00069"></a><span class="lineno"> 69</span> </div><div class="line"><a name="l00070"></a><span class="lineno"> 70</span> To run gdb:</div><div class="line"><a name="l00071"></a><span class="lineno"> 71</span> </div><div class="line"><a name="l00072"></a><span class="lineno"> 72</span> ```</div><div class="line"><a name="l00073"></a><span class="lineno"> 73</span> snap run --gdb remmina</div><div class="line"><a name="l00074"></a><span class="lineno"> 74</span> ``` </div><div class="line"><a name="l00075"></a><span class="lineno"> 75</span> </div><div class="line"><a name="l00076"></a><span class="lineno"> 76</span> Follow the steps in `gdb backtrace with a distribution provided package`, instead of `run` it will be `cont`</div><div class="line"><a name="l00077"></a><span class="lineno"> 77</span> </div><div class="line"><a name="l00078"></a><span class="lineno"> 78</span> See https://snapcraft.io/docs/using-gdb-gdbserver </div><div class="line"><a name="l00079"></a><span class="lineno"> 79</span> </div><div class="line"><a name="l00080"></a><span class="lineno"> 80</span> ### gdb backtrace on a Flatpak package</div><div class="line"><a name="l00081"></a><span class="lineno"> 81</span> </div><div class="line"><a name="l00082"></a><span class="lineno"> 82</span> ```</div><div class="line"><a name="l00083"></a><span class="lineno"> 83</span> flatpak --user install org.remmina.Remmina.Debug</div><div class="line"><a name="l00084"></a><span class="lineno"> 84</span> flatpak run --command=sh --devel org.remmina.Remmina</div><div class="line"><a name="l00085"></a><span class="lineno"> 85</span> gdb /app/bin/remmina</div><div class="line"><a name="l00086"></a><span class="lineno"> 86</span> ```</div><div class="line"><a name="l00087"></a><span class="lineno"> 87</span> </div><div class="line"><a name="l00088"></a><span class="lineno"> 88</span> At the prompt type run, reproduce the crash, and at the prompt type `bt full`</div><div class="line"><a name="l00089"></a><span class="lineno"> 89</span> </div><div class="line"><a name="l00090"></a><span class="lineno"> 90</span> ## Flatpak and Snap package debugging</div><div class="line"><a name="l00091"></a><span class="lineno"> 91</span> </div><div class="line"><a name="l00092"></a><span class="lineno"> 92</span> These packages run in a confined environment, you can get a shell and do some tests, including testing with xfreerdp for instance.</div><div class="line"><a name="l00093"></a><span class="lineno"> 93</span> </div><div class="line"><a name="l00094"></a><span class="lineno"> 94</span> ### Flatpak</div><div class="line"><a name="l00095"></a><span class="lineno"> 95</span> </div><div class="line"><a name="l00096"></a><span class="lineno"> 96</span> ```</div><div class="line"><a name="l00097"></a><span class="lineno"> 97</span> flatpak --user install org.remmina.Remmina.Debug</div><div class="line"><a name="l00098"></a><span class="lineno"> 98</span> flatpak run --command=sh --devel org.remmina.Remmina</div><div class="line"><a name="l00099"></a><span class="lineno"> 99</span> ```</div><div class="line"><a name="l00100"></a><span class="lineno"> 100</span> </div><div class="line"><a name="l00101"></a><span class="lineno"> 101</span> Binaries are installed under `/app/bin`</div><div class="line"><a name="l00102"></a><span class="lineno"> 102</span> </div><div class="line"><a name="l00103"></a><span class="lineno"> 103</span> See https://docs.flatpak.org/en/latest/debugging.html</div><div class="line"><a name="l00104"></a><span class="lineno"> 104</span> </div><div class="line"><a name="l00105"></a><span class="lineno"> 105</span> ### Snap</div><div class="line"><a name="l00106"></a><span class="lineno"> 106</span> </div><div class="line"><a name="l00107"></a><span class="lineno"> 107</span> Install remmina in `devmode`</div><div class="line"><a name="l00108"></a><span class="lineno"> 108</span> </div><div class="line"><a name="l00109"></a><span class="lineno"> 109</span> ```</div><div class="line"><a name="l00110"></a><span class="lineno"> 110</span> snap install --devmode remmina</div><div class="line"><a name="l00111"></a><span class="lineno"> 111</span> ```</div><div class="line"><a name="l00112"></a><span class="lineno"> 112</span> </div><div class="line"><a name="l00113"></a><span class="lineno"> 113</span> You can execute a shell in the confined environment</div><div class="line"><a name="l00114"></a><span class="lineno"> 114</span> </div><div class="line"><a name="l00115"></a><span class="lineno"> 115</span> ```</div><div class="line"><a name="l00116"></a><span class="lineno"> 116</span> snap run --shell remmina</div><div class="line"><a name="l00117"></a><span class="lineno"> 117</span> ```</div><div class="line"><a name="l00118"></a><span class="lineno"> 118</span> </div><div class="line"><a name="l00119"></a><span class="lineno"> 119</span> See https://snapcraft.io/docs/debug-snaps especially the considerations about AppArmor and Secomp </div><div class="line"><a name="l00120"></a><span class="lineno"> 120</span> </div><div class="line"><a name="l00121"></a><span class="lineno"> 121</span> </div><div class="line"><a name="l00122"></a><span class="lineno"> 122</span> ## RDP Broken pipe</div><div class="line"><a name="l00123"></a><span class="lineno"> 123</span> </div><div class="line"><a name="l00124"></a><span class="lineno"> 124</span> If you get `broken pipe` errors or if you want to check the RDP connection, install `nmap`, and from a terminal test the connectivity</div><div class="line"><a name="l00125"></a><span class="lineno"> 125</span> </div><div class="line"><a name="l00126"></a><span class="lineno"> 126</span> </div><div class="line"><a name="l00127"></a><span class="lineno"> 127</span> ```</div><div class="line"><a name="l00128"></a><span class="lineno"> 128</span> nmap -P0 -p 3389 192.168.20.30</div><div class="line"><a name="l00129"></a><span class="lineno"> 129</span> ```</div><div class="line"><a name="l00130"></a><span class="lineno"> 130</span> </div><div class="line"><a name="l00131"></a><span class="lineno"> 131</span> Replace the IP with the one of your server</div><div class="line"><a name="l00132"></a><span class="lineno"> 132</span> </div><div class="line"><a name="l00133"></a><span class="lineno"> 133</span> </div><div class="line"><a name="l00134"></a><span class="lineno"> 134</span> It should output:</div><div class="line"><a name="l00135"></a><span class="lineno"> 135</span> </div><div class="line"><a name="l00136"></a><span class="lineno"> 136</span> ```</div><div class="line"><a name="l00137"></a><span class="lineno"> 137</span> 3389/tcp open ms-wbt-server</div><div class="line"><a name="l00138"></a><span class="lineno"> 138</span> ```</div><div class="line"><a name="l00139"></a><span class="lineno"> 139</span> </div><div class="line"><a name="l00140"></a><span class="lineno"> 140</span> If the system you are using is like a gateway or a tunnel, be sure it's correctly connected to the remote RDP server.</div><div class="line"><a name="l00141"></a><span class="lineno"> 141</span> </div><div class="line"><a name="l00142"></a><span class="lineno"> 142</span> ## RDP `Timeout waiting for activation`</div><div class="line"><a name="l00143"></a><span class="lineno"> 143</span> </div><div class="line"><a name="l00144"></a><span class="lineno"> 144</span> In the advanced tab of the RDP connection profile, set an higher timeout, the default is 900 ms, 15000 or 20000 should be anough large for most cases, tune as per your needs.</div><div class="line"><a name="l00145"></a><span class="lineno"> 145</span> </div><div class="line"><a name="l00146"></a><span class="lineno"> 146</span>  </div></div><!-- fragment --></div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="navelem"><a class="el" href="_remmina-debugging_8md.html">Remmina-debugging.md</a></li>
<li class="footer">Generated by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.13 </li>
</ul>
</div>
</body>
</html>
|
