5ff8fb8a95
Allow xrdp-sesman to discover sessions still running that were created by a previous xrdp-sesman process. Implement this using a file-backed shared mmap region, visible to both the daemon and session instances of xrdp-sesman. Add a heartbeat timestamp updated by the session instance so that the daemon instance can infer whether the sessions in the mmap region are current or stale. The shared memory can also be used to pass other data between daemon and session instances, for example the session's idle time. Add locking around access to g_sessions and the mmap region. This is a PTHREAD_PROCESS_SHARED lock which protects shared memory used by separate processes. Defining DEBUG_SESSION_LOCK enables logging to help debug locking bugs. Notes: 1. The number of sessions is limited by the size of the array in shared memory, SESMAN_SHAREDMEM_MAX_SESSIONS. This could be made dynamic instead by growing the file and the mmap region. 2. If sesshm_try_open_existing_shm() finds a shm file but it looks wrong, it creates a new one. Perhaps it should instead exit with an error? 3. In sesshm_thread() if the session xrdp-sesman notices that it has been removed from the daemon's list it exits. It should kill the X server and/or window manager first. 4. This doesn't yet update idle times. I need to work out how to get this information from the X server. 5. This uses an array of sessions in the mmap region so the linked list g_sessions might be redundant now. 6. Defining DONT_USE_SHM will let xrdp-sesman run without creating or trying to use the mmap file. This could be removed in the future. 7. I think the locking fixes an theorised bug where a session can be removed from the g_sessions linked list in session_kill() (called from the signal handler) at the same time as a session is added in session_start_fork(). |
||
|---|---|---|
| common | ||
| docs | ||
| fontdump | ||
| genkeymap | ||
| instfiles | ||
| keygen | ||
| libpainter@cc66c2c55d | ||
| librfxcodec@6cb61ab7ca | ||
| libxrdp | ||
| m4 | ||
| mc | ||
| neutrinordp | ||
| pkgconfig | ||
| sesman | ||
| tcutils | ||
| tests | ||
| vnc | ||
| vrplayer | ||
| xrdp | ||
| xrdpapi | ||
| xrdpvr | ||
| xup | ||
| .gitignore | ||
| .gitmodules | ||
| .travis.yml | ||
| astyle_config.as | ||
| bootstrap | ||
| coding_style.md | ||
| configure.ac | ||
| COPYING | ||
| description-pak | ||
| design.txt | ||
| faq-compile.txt | ||
| faq-general.txt | ||
| file-loc.txt | ||
| install.txt | ||
| Makefile.am | ||
| NEWS.md | ||
| postinstall-pak | ||
| README.md | ||
Current Version: 0.9.11
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.
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 (requires to build additional modules)
- 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.
xrdp listens on 3389/tcp. Make sure your firewall accepts connection to 3389/tcp from where you want to access.
Ubuntu / Debian
apt 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.
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 macOS 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
If you want to use audio redirection, you need to build and install additional pulseaudio modules. The build instructions can be found at wiki.
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
├── xrdp ········ main server code
├── xrdpapi ····· virtual channel API
├── xrdpvr ······ API for playing media over RDP
└── xup ········· X11rdp and xorgxrdp client module