grdesktop FAQ

$grdesktop: faq/faq.en.xml,v 1.1 2003/11/09 11:53:51 tsauter Exp $

Author: Thorsten Sauter

2003-11-09

Revision History
Revision 1.12003-11-09tsauter
Moved from SGML to XML
Revision 1.02002-11-01tsauter
Initial release

Abstract

This FAQ should cover most of the important questions related to grdesktop and rdesktop. If some questions are not listed here, please feel free to contact me for further help.


Table of Contents

1. Introduction
2. Compilation & Installation Issues
3. Running grdesktop

1. Introduction

Welcome to the grdesktop FAQ!

The following are items you probably shouldn't e-mail or post in the mailing list about, as they are often repeated.

2. Compilation & Installation Issues

2.1. What the hell is the docbook-to-man command?

The man-pages and other documents are written in sgml, so you need the docbook-to-man command to create the man- pages from the sgml sources.

Under RedHat (and maybe other rpm-based distries) it's calles docbook2man, which is the same command.

3. Running grdesktop

3.1. grdesktop show an error about missing keyboard dir

You will get an error dialog on each start of grdesktop? No problem, your rdesktop version doesn't support the new keymap definiton files. Just create the missing directory, and you will never seen the message.

	$ su
	Password:
	# mkdir -p /usr/X11R6/share/rdesktop/keymaps
			

This issue is fixed in grdesktop v0.17 and later which support both versions for rdesktop. (prior 1.1.0patch19 and later versions).

3.2. Nothing happens after clicking the Connect button

Probably you're using an older version of rdesktop (prior 1.2.0). You should update your rdesktop binary and apply all patches, or checkout the latest cvs version from http://www.rdesktop.org/.

If you don't want to update your rdesktop version you can patch the grdesktop 0.16 version with the patch available on the download page.

	$ tar xvzf grdesktop-0.16.tar.gz
	$ cd grdesktop-0.16
	$ patch -p0 <../rdesktop-1.1.0.patch
	$ cd ..
	$ ./configure && make && make install
			

Up to version 0.17 of grdesktop we can now detect if you are using the old version of rdesktop, so this error doesn't occure.

Please check the logfiles, for detailed error from rdesktop.

	$ cat /tmp/grdesktop-$(pidof grdesktop).log