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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
|
<!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: General information</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.32</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('md__builds__remmina_remmina-ci__remmina_8wiki__usage__remmina-debugging.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">General information </div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>Plugins can have seperate log level options. They have no connection to the Remmina debug window or any environment variables. (Explained below)</p>
<p>More specifically the RDP, GVNC and SSH plugins have options in the connection profile to raise up and/or set the log level.</p>
<h1>Debugging mode</h1>
<h2>GUI way</h2>
<p>You can just open a debug window inside of Remmina.</p>
<ul>
<li>Click on the 3 dots at the top of Remmina.</li>
<li>Click on 'Debugging'</li>
</ul>
<p>Just keep that window open and you'll see there will be quite a few debug messages shortly.</p>
<h2>Terminal way</h2>
<p>Firstly, you have to be sure that Remmina isn't already running:</p>
<ul>
<li>Open a terminal (gnome-terminal, mate-terminal, xterm, alacritty, just to name a few...)</li>
</ul>
<p>Your desktop environment will surely have a terminal, so you won't have to install one.</p>
<div class="fragment"><div class="line">pkill remmina</div><div class="line">ps -ef | grep remmina</div></div><!-- fragment --><p>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: <a href="https://docs.gtk.org/glib/running.html">https://docs.gtk.org/glib/running.html</a></p>
<ul>
<li>For that we start Remmina with the <code>environment variables</code> <code>G_MESSAGES_PREFIXED</code> and <code>G_MESSAGES_DEBUG</code> both set to <code>all</code>.</li>
</ul>
<p>### Installed through apt-get, yum, pacman, rpm, or compiled with sources. </p><div class="fragment"><div class="line">G_MESSAGES_PREFIXED=all G_MESSAGES_DEBUG=all remmina</div></div><!-- fragment --><p># Installed through Flatpak </p><div class="fragment"><div class="line">G_MESSAGES_PREFIXED=all G_MESSAGES_DEBUG=all flatpak run org.remmina.Remmina</div></div><!-- fragment --><p># Installed through Snap </p><div class="fragment"><div class="line">G_MESSAGES_PREFIXED=all G_MESSAGES_DEBUG=all snap run remmina</div></div><!-- fragment --><h2>Remmina crashes</h2>
<p>When Remmina crashes we need a backtrace if possible</p>
<h3>gdb backtrace with a distribution provided package</h3>
<p>Install the remmina debug symbols if available</p>
<div class="fragment"><div class="line">gdb remmina</div></div><!-- fragment --><p>At the prompt type run, reproduce the crash, and at the prompt type <code>bt full</code></p>
<h3>gdb backtrace on a snap package</h3>
<p>You may need to reinstall remmina with <code>--devmode</code></p>
<div class="fragment"><div class="line">snap install --devmode remmina</div></div><!-- fragment --><p>To run gdb:</p>
<div class="fragment"><div class="line">snap run --gdb remmina</div></div><!-- fragment --><p>Follow the steps in <code>gdb backtrace with a distribution provided package</code>, instead of <code>run</code> it will be <code>cont</code></p>
<p>See <a href="https://snapcraft.io/docs/using-gdb-gdbserver">https://snapcraft.io/docs/using-gdb-gdbserver</a></p>
<h3>gdb backtrace on a Flatpak package</h3>
<div class="fragment"><div class="line">flatpak --user install org.remmina.Remmina.Debug</div><div class="line">flatpak run --command=sh --devel org.remmina.Remmina</div><div class="line">gdb /app/bin/remmina</div></div><!-- fragment --><p>At the prompt type run, reproduce the crash, and at the prompt type <code>bt full</code></p>
<h2>Flatpak and Snap package debugging</h2>
<p>These packages run in a confined environment, you can get a shell and do some tests, including testing with xfreerdp for instance.</p>
<h3>Flatpak</h3>
<div class="fragment"><div class="line">flatpak --user install org.remmina.Remmina.Debug</div><div class="line">flatpak run --command=sh --devel org.remmina.Remmina</div></div><!-- fragment --><p>Binaries are installed under <code>/app/bin</code></p>
<p>See <a href="https://docs.flatpak.org/en/latest/debugging.html">https://docs.flatpak.org/en/latest/debugging.html</a></p>
<h3>Snap</h3>
<p>Install remmina in <code>devmode</code></p>
<div class="fragment"><div class="line">snap install --devmode remmina</div></div><!-- fragment --><p>You can execute a shell in the confined environment</p>
<div class="fragment"><div class="line">snap run --shell remmina</div></div><!-- fragment --><p>See <a href="https://snapcraft.io/docs/debug-snaps">https://snapcraft.io/docs/debug-snaps</a> especially the considerations about AppArmor and Secomp</p>
<h2>RDP Broken pipe</h2>
<p>If you get <code>broken pipe</code> errors or if you want to check the RDP connection, install <code>nmap</code>, and from a terminal test the connectivity</p>
<div class="fragment"><div class="line">nmap -P0 -p 3389 192.168.20.30</div></div><!-- fragment --><p>Replace the IP with the one of your server</p>
<p>It should output:</p>
<div class="fragment"><div class="line">3389/tcp open ms-wbt-server</div></div><!-- fragment --><p>If the system you are using is like a gateway or a tunnel, be sure it's correctly connected to the remote RDP server.</p>
<h2>RDP <code>Timeout waiting for activation</code></h2>
<p>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. </p>
</div></div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<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>
|
