The xrdp‐chansrv program

The xrdp-chansrv program

Scope

This page applies to version v0.10.x of xrdp

FAQs

What is xrdp-chansrv?

xrdp-chansrv is a component of xrdp which runs after a user logs in.

It is responsible for handling drive redirections, copy/paste operations, and some Unicode input features.

What happens if xrdp-chansrv fails?

You might see the following symptoms:

1. A pause when reconnecting to a session
2. Drive redirections no longer work in the session
3. Copy-paste operations between the server and the client will no longer work.
4. Unicode input may no longer work.

Why does xrdp-chansrv fail?

This is normally caused by a defect in xrdp-chansrv.

Please report any failures of xrdp-chansrv you encounter to the project. This helps to make xrdp better for everyone.

How do I see if xrdp-chansrv is running?

Query the system for the process using (for example):

$ ps -C xrdp-chansrv
    PID TTY          TIME CMD
  26964 ?        00:00:00 xrdp-chansrv

Where is the log file for xrdp-chansrv?

This is normally in ~/.local/share/xrdp/xrdp-chansrv.<dname>.log, where <dname> is the name of your session display.

Can I restart xrdp-chansrv if it fails?

Follow this process to restart a failed xrdp-chansrv.

1. Make sure xrdp-chansrv is not running for the user (see above)
2. Start a terminal program
3. Unmount any redirected drives with the command fusermount -u ~/thinclient_drives command.
4. Run xrdp-chansrv in the terminal with the xrdp-chansrv command. The command will now generate logging in the terminal window.
5. Disconnect from your session and reconnect. A connection to your new chansrv process will be established.