Go to file
Pavel Roskin fc2572f60b Remove chansrv_cleanup(), it doesn't do anything useful
xrdp_chansrv_%8.8x_main_term and xrdp_chansrv_%8.8x_thread_done are both
wait objects, not sockets. They are created and cleaned up in chansrv.c

Wait objects are pairs of file descriptors on POSIX. They are closed
automatically when the process exits.

On Windows, wait objects are handles that are closed by CloseHandle().
Those handles should also be closed on the process exit.

In any case, there is no way for a parent process to clean up file
handles of the child process.
2017-03-17 22:25:05 -07:00
common Eliminate APP_CC and DEFAULT_CC 2017-03-14 00:21:48 -07:00
docs TLS: switch ssl_protocols to a comma separated list 2017-02-27 14:17:25 +09:00
fontdump Don't ignore files known to git 2016-02-12 23:52:46 -08:00
genkeymap Include config_ac.h from all source files 2017-03-04 00:52:34 -08:00
instfiles Remove trailing whitespace 2017-02-08 13:30:56 +09:00
keygen Eliminate APP_CC and DEFAULT_CC 2017-03-14 00:21:48 -07:00
libpainter@898058cfcd Update submodules to their current devel branches 2017-03-01 20:38:33 -08:00
librfxcodec@72efbf96ba Update submodules to their current devel branches 2017-03-01 20:38:33 -08:00
libxrdp Eliminate APP_CC and DEFAULT_CC 2017-03-14 00:21:48 -07:00
m4 Update m4/ax_type_socklen_t.m4, it works with -Wall now 2017-02-02 21:33:05 -08:00
mc Eliminate APP_CC and DEFAULT_CC 2017-03-14 00:21:48 -07:00
neutrinordp Eliminate APP_CC and DEFAULT_CC 2017-03-14 00:21:48 -07:00
pkgconfig Fix include path in xrdp-uninstalled.pc.in 2016-11-18 23:42:26 +00:00
sesman Remove chansrv_cleanup(), it doesn't do anything useful 2017-03-17 22:25:05 -07:00
tcutils Remove trailing whitespace 2017-02-08 13:30:56 +09:00
tests Eliminate APP_CC and DEFAULT_CC 2017-03-14 00:21:48 -07:00
vnc Eliminate APP_CC and DEFAULT_CC 2017-03-14 00:21:48 -07:00
vrplayer Remove trailing whitespace 2017-02-08 13:30:56 +09:00
xorg Remove trailing whitespace 2017-02-08 13:30:56 +09:00
xrdp Propel xorgxrdp as default backend, give xorgxrdp the first place 2017-03-17 09:21:51 +09:00
xrdpapi Include config_ac.h from all source files 2017-03-04 00:52:34 -08:00
xrdpvr Include config_ac.h from all source files 2017-03-04 00:52:34 -08:00
xup Eliminate APP_CC and DEFAULT_CC 2017-03-14 00:21:48 -07:00
.gitignore Add *.a to top .gitignore, add xorg/X11R7.6/.gitignore 2016-10-09 21:35:27 -07:00
.gitmodules Use special name "." for the branches in .gitmodules 2017-03-01 20:38:33 -08:00
.travis.yml Add i686 check in Travis CI 2017-02-23 11:28:44 -08:00
COPYING o moved from GNU General Public License to Apache License, Version 2.0 2012-09-19 20:51:34 -07:00
Makefile.am Add --enable-strict-locations option, describe default in its help text 2017-03-02 21:47:37 -08:00
NEWS.md Add NEWS.md 2016-12-21 16:12:22 -05:00
README.md Remove trailing whitespace 2017-02-08 13:30:56 +09:00
astyle_config.as Remove --break-blocks option, it doesn't match the existing code style 2017-02-07 13:51:22 +09:00
bootstrap bootstrap: checkout submodules if they are missing 2016-12-28 21:22:29 -08:00
coding_style.md Merge prog_std.txt into coding_style.md 2016-10-17 08:38:22 -07:00
configure.ac Add --enable-strict-locations option, describe default in its help text 2017-03-02 21:47:37 -08:00
description-pak helper file for checkinstall 2013-03-20 19:09:08 +00:00
design.txt More spelling fixes found by codespell and aspell 2016-01-30 17:39:25 -08:00
faq-compile.txt Update faq-compile.txt 2014-05-29 21:29:15 -07:00
faq-general.txt Fix incorrect use of "it's" and "its", adjust wording 2016-06-21 16:30:15 -07:00
file-loc.txt Remove librdp.so sources, it's obsoleted by neutrinordp 2017-01-19 20:13:49 -08:00
install.txt More spelling fixes found by codespell and aspell 2016-01-30 17:39:25 -08:00
postinstall-pak clear things that are handled by the init script 2013-03-21 18:20:16 +00:00
readme.txt Add README.md 2016-12-21 16:23:22 -05:00

README.md

Build Status Gitter Apache-License

Current Version: 0.9.1

xrdp - an open source RDP server

Overview

xrdp provides a graphical login to remote machines using Microsoft Remote Desktop Protocol (RDP). xrdp accepts connections from a variety of RDP clients: FreeRDP, rdesktop, NeutrinoRDP and Microsoft Remote Desktop Client (for Windows, Mac OS, iOS and Android).

RDP transport is encrypted using TLS by default.

demo

Features

Remote Desktop Access

  • Connect to a Linux desktop using RDP from anywhere (requires xorgxrdp Xorg module)
  • Reconnect to an existing session
  • Session resizing
  • RDP/VNC proxy (connect to another RDP/VNC server via xrdp)

Access to Remote Resources

  • two-way clipboard transfer (text, bitmap, file)
  • audio redirection
  • drive redirection (mount local client drives on remote machine)

Quick Start

Most Linux distributions should distribute the latest release of xrdp in their repository. You would need xrdp and xorgxrdp packages for the best experience. It is recommended that xrdp depends on xorgxrdp, so it should be sufficient to install xrdp. If xorgxrdp is not provided, use Xvnc server.

Ubuntu / Debian

apt-get install xrdp

RedHat / CentOS / Fedora

On RedHat and CentOS, make sure to enable EPEL packages first.

yum install epel-release

Install xrdp package.

yum install xrdp

yum is being replaced with dnf, so you may need to use dnf instead of yum in the above commands.

To allow outside access to the service, open port 3389 on the firewall.

firewall-cmd --permanent --zone=public --add-port=3389/tcp
firewall-cmd --reload

Environment

xrdp primarily targets to GNU/Linux. Tested on x86, x86_64, SPARC and PowerPC.

xorgxrdp and RemoteFX Codec have special optimization for x86 and x86_64 using SIMD instructions.

FreeBSD is not a primary target of xrdp. It is working on FreeBSD except for the drive redirection feature.

Other operating systems such as Mac OS are not supported so far, but we welcome your contributions.

Compiling

See also https://github.com/neutrinolabs/xrdp/wiki#building-from-sources

Prerequisites

To compile xrdp from the packaged sources, you need basic build tools - a compiler (gcc or clang) and the make program. Additionally, you would need openssl-devel, pam-devel, libX11-devel, libXfixes-devel, libXrandr-devel. More additional software would be needed depending on your configuration.

To compile xrdp from a checked out git repository, you would additionally need autoconf, automake, libtool and pkgconfig.

Get the source and build it

If compiling from the packaged source, unpack the tarball and change to the resulting directory.

If compiling from a checked out repository, please make sure you've got the submodules cloned too (use git clone --recursive https://github.com/neutrinolabs/xrdp)

Then run following commands to compile and install xrdp:

./bootstrap
./configure
make
sudo make install

Directory Structure

xrdp
├── common ······ common code
├── docs ········ documentation
├── fontdump ···· font dump for Windows
├── genkeymap ··· keymap generator
├── instfiles ··· installable data file
├── keygen ······ xrdp RSA key pair generator
├── libpainter ·· painter library
├── librfxcodec · RFX codec library
├── libxrdp ····· core RDP protocol implementation
├── m4 ·········· Autoconf macros
├── mc ·········· media center module
├── neutrinordp · RDP client module for proxying RDP connections using NeutrinoRDP
├── pkgconfig ··· pkg-config configuration
├── sesman ······ session manager for xrdp
├── tcutils ····· QT based utility program for thin clients
├── tests ······· tests for the code
├── vnc ········· VNC client module for xrdp
├── vrplayer ···· QT player redirecting video/audio to clients over xrdpvr channel
├── xorg ········ X11rdp, an Xorg backend for xrdp
├── xrdp ········ main server code
├── xrdpapi ····· virtual channel API
├── xrdpvr ······ API for playing media over RDP
└── xup ········· X11rdp and xorgxrdp client module