Improve experience for new users - provide more intelligent errors when

X11 or OpenSSL headers are missing, and clarify README


git-svn-id: svn://svn.code.sf.net/p/rdesktop/code/trunk/rdesktop@1424 423420c4-83ab-492f-b58f-81f9feb106b5
This commit is contained in:
Matt Chapman 2008-01-05 05:35:56 +00:00
parent b7fa2fb4da
commit b60949987c
2 changed files with 39 additions and 15 deletions

31
README
View File

@ -9,31 +9,38 @@ rdesktop currently implements the RDP version 4 and 5 protocols.
Installation
------------
rdesktop uses a typical GNU-style build procedure:
rdesktop uses a GNU-style build procedure. Typically all that is necessary
to install rdesktop is the following:
% ./configure [options]
% ./configure
% make
% make install
where documentation for [options] can be found by running "./configure --help".
Usually no options are necessary. The default is to install under /usr/local,
this can be changed with --prefix=directory.
The default is to install under /usr/local. This can be changed by adding
--prefix=directory to the configure line.
Note for CVS users
------------------
If you have downloaded a snapshot of rdesktop using CVS, you will first need to
run ./bootstrap in order to generate the build infrastructure. This is not
necessary for release versions of rdesktop.
Invocation
----------
Simply run:
% rdesktop [options] server
% rdesktop server
where server is the name of the Terminal Services machine. Note: if you
receive "Connection refused", this probably means that the server does not have
Terminal Services enabled, or there is a firewall blocking access.
where server is the name of the Terminal Services machine. (If you receive
"Connection refused", this probably means that the server does not have
Terminal Services enabled, or there is a firewall blocking access.)
The rdesktop manual page lists the possible options ("man rdesktop").
You can also specify a number of options on the command line. These are listed
in the rdesktop manual page (run "man rdesktop").
Smart-card support notes
------------------------
Smart-card support module uses PCSC-lite. You should use PCSC-lite 1.2.9 or
The smart-card support module uses PCSC-lite. You should use PCSC-lite 1.2.9 or
later.
To enable smart-card support in the rdesktop just run "./configure" with the

View File

@ -12,6 +12,18 @@ AC_LANG_C
AC_HEADER_STDC
AC_C_BIGENDIAN([AC_DEFINE(B_ENDIAN)], [AC_DEFINE(L_ENDIAN)])
AC_PATH_XTRA
if test "$no_x" = "yes"; then
echo
echo "ERROR: Could not find X Window System headers/libraries."
if test -f /etc/debian_version; then
echo "Probably you need to install the libx11-dev package."
elif test -f /etc/redhat-release; then
echo "Probably you need to install the libX11-devel package."
fi
echo "To specify paths manually, use the options --x-includes and --x-libraries."
echo
exit 1
fi
AC_PATH_PROG(PKG_CONFIG, pkg-config)
@ -67,8 +79,13 @@ AC_ARG_WITH(openssl,
if test -z "$ssldir"; then
AC_MSG_RESULT([Not found])
echo
echo "Couldn't find your OpenSSL library installation dir"
echo "Use --with-openssl option to fix this problem"
echo "ERROR: Could not find OpenSSL headers/libraries."
if test -f /etc/debian_version; then
echo "Probably you need to install the libssl-dev package."
elif test -f /etc/redhat-release; then
echo "Probably you need to install the openssl-devel package."
fi
echo "To specify a path manually, use the --with-openssl option."
echo
exit 1
fi