Blame SOURCES/Add-description-for-available-plugins.patch

0c7016
From 0c050bb8cde65b0ac368f06bfd5ec36cccf87a83 Mon Sep 17 00:00:00 2001
0c7016
From: Ondrej Holy <oholy@redhat.com>
0c7016
Date: Fri, 9 Jun 2017 09:49:11 +0200
0c7016
Subject: [PATCH] Add description for available plugins
0c7016
0c7016
The man pages lack info about available plugins and its functionality.
0c7016
Add description for available plugins and their parameters.
0c7016
0c7016
It is based on info from upstream wiki pages:
0c7016
https://github.com/FreeRDP/FreeRDP/wiki/Plugins
0c7016
https://github.com/FreeRDP/FreeRDP/wiki/CommandLineInterface
0c7016
0c7016
Removed mention about ALSA mixer support since it is not built in RHEL.
0c7016
---
0c7016
 client/X11/xfreerdp.1.xml | 140 ++++++++++++++++++++++++++++++++++++++++++++--
0c7016
 1 file changed, 136 insertions(+), 4 deletions(-)
0c7016
0c7016
diff --git a/client/X11/xfreerdp.1.xml b/client/X11/xfreerdp.1.xml
0c7016
index 6ccf42fc8..3b1dc675e 100644
0c7016
--- a/client/X11/xfreerdp.1.xml
0c7016
+++ b/client/X11/xfreerdp.1.xml
0c7016
@@ -438,10 +438,134 @@
0c7016
         </listitem>
0c7016
       </varlistentry>
0c7016
       <varlistentry>
0c7016
-        <term>--plugin <replaceable class="parameter">pluginname</replaceable></term>
0c7016
-        <listitem>
0c7016
-          <para>
0c7016
-            load <replaceable class="parameter">pluginname</replaceable>
0c7016
+        <term>--plugin <replaceable class="parameter">plugin</replaceable> [--data <replaceable class="parameter">data</replaceable> --]</term>
0c7016
+        <listitem>
0c7016
+          <para>
0c7016
+            Load one of the following <replaceable class="parameter">plugin</replaceable>:
0c7016
+            <variablelist>
0c7016
+              <varlistentry>
0c7016
+                <term>cliprdr</term>
0c7016
+                <listitem>
0c7016
+                  <para>
0c7016
+                    Synchronize client and server clipboard data.
0c7016
+                  </para>
0c7016
+                </listitem>
0c7016
+              </varlistentry>
0c7016
+              <varlistentry>
0c7016
+                <term>drdynvc --data <replaceable class="parameter">subplugin</replaceable> [<replaceable class="parameter">subplugin</replaceable> ...] --</term>
0c7016
+                <listitem>
0c7016
+                  <para>
0c7016
+                    Enable multimedia redirection.
0c7016
+                    The <replaceable class="parameter">subplugin</replaceable> must be one of the following:
0c7016
+                  </para>
0c7016
+                  <variablelist>
0c7016
+                    <varlistentry>
0c7016
+                      <term>audin</term>
0c7016
+                      <listitem>
0c7016
+                        <para>
0c7016
+                          Redirect audio recording device to the server.
0c7016
+                        </para>
0c7016
+                      </listitem>
0c7016
+                    </varlistentry>
0c7016
+                    <varlistentry>
0c7016
+                      <term>tsmf</term>
0c7016
+                      <listitem>
0c7016
+                        <para>
0c7016
+                          Enable video redirection. The --plugin rdpsnd needs to be enabled as well.
0c7016
+                        </para>
0c7016
+                      </listitem>
0c7016
+                    </varlistentry>
0c7016
+                  </variablelist>
0c7016
+                </listitem>
0c7016
+              </varlistentry>
0c7016
+              <varlistentry>
0c7016
+                <term>rdpsnd [--data [<replaceable class="parameter">subplugin</replaceable>] [latency:<replaceable class="parameter">latency</replaceable>] --]</term>
0c7016
+                <listitem>
0c7016
+                  <para>
0c7016
+                    Enable audio output using one of the following <replaceable class="parameter">subplugin</replaceable> and with a given <replaceable class="parameter">latency</replaceable> in ms:
0c7016
+                  </para>
0c7016
+                  <variablelist>
0c7016
+                    <varlistentry>
0c7016
+                      <term>pulse</term>
0c7016
+                      <listitem>
0c7016
+                        <para>
0c7016
+                          Use PulseAudio mixer.
0c7016
+                        </para>
0c7016
+                      </listitem>
0c7016
+                    </varlistentry>
0c7016
+                  </variablelist>
0c7016
+                </listitem>
0c7016
+              </varlistentry>
0c7016
+              <varlistentry>
0c7016
+                <term>rail --data <replaceable class="parameter">executable</replaceable>[:<replaceable class="parameter">workingdir</replaceable>[:<replaceable class="parameter">arguments</replaceable>]] --</term>
0c7016
+                <listitem>
0c7016
+                  <para>
0c7016
+                    Launch one <replaceable class="parameter">executable</replaceable> in a <replaceable class="parameter">workingdir</replaceable> with given <replaceable class="parameter">arguments</replaceable>.
0c7016
+                    You must use --app before you can use rail.
0c7016
+                  </para>
0c7016
+                </listitem>
0c7016
+              </varlistentry>
0c7016
+              <varlistentry>
0c7016
+                <term>rdpdbg</term>
0c7016
+                <listitem>
0c7016
+                  <para>
0c7016
+                    Enable debugging virtual channel.
0c7016
+                  </para>
0c7016
+                </listitem>
0c7016
+              </varlistentry>
0c7016
+              <varlistentry>
0c7016
+                <term>rdpdr --data <replaceable class="parameter">subplugin</replaceable> [<replaceable class="parameter">subplugin</replaceable> ...] --</term>
0c7016
+                <listitem>
0c7016
+                  <para>
0c7016
+                    Redirect filesystem devices on your client to the server.
0c7016
+                    If you want any redirection to work with Windows Server 2012 and newer you must use --plugin rdpsnd before you use any rdpdr options.
0c7016
+                    The <replaceable class="parameter">subplugin</replaceable> must be one of the following:
0c7016
+                  </para>
0c7016
+                  <variablelist>
0c7016
+                    <varlistentry>
0c7016
+                      <term>drive:<replaceable class="parameter">name</replaceable>:<replaceable class="parameter">path</replaceable></term>
0c7016
+                      <listitem>
0c7016
+                        <para>
0c7016
+                          Redirect system <replaceable class="parameter">path</replaceable> as disk with <replaceable class="parameter">name</replaceable>.
0c7016
+                        </para>
0c7016
+                      </listitem>
0c7016
+                    </varlistentry>
0c7016
+                    <varlistentry>
0c7016
+                      <term>smartcard[:<replaceable class="parameter">name</replaceable>]</term>
0c7016
+                      <listitem>
0c7016
+                        <para>
0c7016
+                          Redirect smartcard with <replaceable class="parameter">name</replaceable>.
0c7016
+                        </para>
0c7016
+                      </listitem>
0c7016
+                    </varlistentry>
0c7016
+                    <varlistentry>
0c7016
+                      <term>serial:<replaceable class="parameter">port</replaceable>:<replaceable class="parameter">device</replaceable></term>
0c7016
+                      <listitem>
0c7016
+                        <para>
0c7016
+                          Redirect serial <replaceable class="parameter">device</replaceable> (e.g. /dev/ttyS0) to <replaceable class="parameter">port</replaceable> (e.g. COM0).
0c7016
+                        </para>
0c7016
+                      </listitem>
0c7016
+                    </varlistentry>
0c7016
+                    <varlistentry>
0c7016
+                      <term>parallel:<replaceable class="parameter">port</replaceable>:<replaceable class="parameter">device</replaceable></term>
0c7016
+                      <listitem>
0c7016
+                        <para>
0c7016
+                          Redirect parallel <replaceable class="parameter">device</replaceable> (e.g. /dev/lp0) to <replaceable class="parameter">port</replaceable> (e.g. LPT0).
0c7016
+                        </para>
0c7016
+                      </listitem>
0c7016
+                    </varlistentry>
0c7016
+                    <varlistentry>
0c7016
+                      <term>printer:<replaceable class="parameter">cupsname</replaceable>:<replaceable class="parameter">drivername</replaceable></term>
0c7016
+                      <listitem>
0c7016
+                        <para>
0c7016
+                          Redirect printer with <replaceable class="parameter">cupsname</replaceable> and <replaceable class="parameter">drivername</replaceable>.
0c7016
+                        </para>
0c7016
+                      </listitem>
0c7016
+                    </varlistentry>
0c7016
+                  </variablelist>
0c7016
+                </listitem>
0c7016
+              </varlistentry>
0c7016
+            </variablelist>
0c7016
           </para>
0c7016
         </listitem>
0c7016
       </varlistentry>
0c7016
-- 
0c7016
2.14.1
0c7016