Contents of /jpeg/rdesktop/trunk/README

==========================================
rdesktop: A Remote Desktop Protocol client
==========================================

rdesktop is a client for Microsoft Windows NT Terminal Server, Windows 2000
Terminal Services, Windows 2003 Terminal Services/Remote Desktop, Windows XP
Remote Desktop, and possibly other Terminal Services products.
rdesktop currently implements the RDP version 4 and 5 protocols.

Installation
------------
rdesktop uses a GNU-style build procedure.  Typically all that is necessary
to install rdesktop is the following::

        % ./configure
        % make
        % make install

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 server

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.)

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
------------------------
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
"--enable-smartcard" option. Also you can enable smart-card debug with
additional "--with-debug-smartcard" option.

1	==========================================
2	rdesktop: A Remote Desktop Protocol client
3	==========================================
4
5	rdesktop is a client for Microsoft Windows NT Terminal Server, Windows 2000
6	Terminal Services, Windows 2003 Terminal Services/Remote Desktop, Windows XP
7	Remote Desktop, and possibly other Terminal Services products.
8	rdesktop currently implements the RDP version 4 and 5 protocols.
9
10	Installation
11	------------
12	rdesktop uses a GNU-style build procedure. Typically all that is necessary
13	to install rdesktop is the following::
14
15	% ./configure
16	% make
17	% make install
18
19	The default is to install under /usr/local. This can be changed by adding
20	--prefix=directory to the configure line.
21
22	Note for CVS users
23	------------------
24	If you have downloaded a snapshot of rdesktop using CVS, you will first need to
25	run ./bootstrap in order to generate the build infrastructure. This is not
26	necessary for release versions of rdesktop.
27
28	Invocation
29	----------
30	Simply run::
31
32	% rdesktop server
33
34	where server is the name of the Terminal Services machine. (If you receive
35	"Connection refused", this probably means that the server does not have
36	Terminal Services enabled, or there is a firewall blocking access.)
37
38	You can also specify a number of options on the command line. These are listed
39	in the rdesktop manual page (run "man rdesktop").
40
41	Smart-card support notes
42	------------------------
43	The smart-card support module uses PCSC-lite. You should use PCSC-lite 1.2.9 or
44	later.
45
46	To enable smart-card support in the rdesktop just run "./configure" with the
47	"--enable-smartcard" option. Also you can enable smart-card debug with
48	additional "--with-debug-smartcard" option.
49