398 lines
13 KiB
XML
398 lines
13 KiB
XML
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
|
|
<refentry>
|
|
<refentryinfo>
|
|
<date>2011-08-27</date>
|
|
<author>
|
|
<authorblurb><para>The FreeRDP-Team</para></authorblurb>
|
|
</author>
|
|
</refentryinfo>
|
|
<refmeta>
|
|
<refentrytitle>xfreerdp</refentrytitle>
|
|
<manvolnum>1</manvolnum>
|
|
<refmiscinfo class="source">freerdp</refmiscinfo>
|
|
<refmiscinfo class="manual">xfreerdp</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname><application>xfreerdp</application></refname>
|
|
<refpurpose>X11 frontend to libFreeRDP</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<refsynopsisdivinfo>
|
|
<date>2011-08-27</date>
|
|
</refsynopsisdivinfo>
|
|
<para>
|
|
<command>xfreerdp</command> [options] server[:port] [[options] server[:port] …]
|
|
</para>
|
|
</refsynopsisdiv>
|
|
<refsect1>
|
|
<refsect1info>
|
|
<date>2011-08-27</date>
|
|
</refsect1info>
|
|
<title>DESCRIPTION</title>
|
|
<para>
|
|
<command>xfreerdp</command> is a frontend to libFreeRDP,
|
|
which implements a client to the Remote Desktop Protocol (RDP).
|
|
RDP is used in a number of Microsoft products including Microsoft Windows
|
|
versions starting from NT Terminal Server. RDP is also implemented by xrdp and VirtualBox.
|
|
</para>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>OPTIONS</title>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>-0</term>
|
|
<listitem>
|
|
<para>
|
|
Attach to the admin console of the server.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>-a <replaceable class="parameter">bpp</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
Sets the color depth for the connection to <replaceable class="parameter">bpp</replaceable> bits per pixel.
|
|
Valid values are 8, 15, 16, 24 and 32. The default value is the color depth of the FreeRDP-window.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry id="WorkingDir">
|
|
<term>-c <replaceable class="parameter">dir</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
Sets the working-dir to <replaceable class="parameter">dir</replaceable>.
|
|
This parameter is only used when an AlternateShell (<xref linkend="AlternateShell"/>) is requested.
|
|
<replaceable class="parameter">dir</replaceable> should contain the executable file specified in the AlternateShell.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>-D</term>
|
|
<listitem>
|
|
<para>
|
|
Removes the windows decorations.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>-d</term>
|
|
<listitem>
|
|
<para>
|
|
Domain used in authentication.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>-f</term>
|
|
<listitem>
|
|
<para>
|
|
start in full screen mode. This mode can always be en- and disabled using Ctrl-Alt-Enter.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>-T <replaceable class="parameter">text</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
Sets the window title to <replaceable class="parameter">text</replaceable>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>-g <replaceable class="parameter">geometry</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
Sets the size of the FreeRDP-window (and of the remote desktop, when establishing a new connection).
|
|
<replaceable class="parameter">geometry</replaceable> can have one of the following forms:
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
<replaceable class="parameter">W</replaceable>x<replaceable class="parameter">H</replaceable> -
|
|
in this case the resulting window will be of
|
|
<replaceable class="parameter">W</replaceable>x<replaceable class="parameter">H</replaceable> pixels.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<replaceable class="parameter">P</replaceable>% -
|
|
in this case the resulting window will be <replaceable class="parameter">P</replaceable>%
|
|
of your screen.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
The special keyword <emphasis>workarea</emphasis> -
|
|
in this case the resulting window will be of the same size as your workarea.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>-k <replaceable class="parameter">id</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
Sets the keyboard-layout-id to <replaceable class="parameter">id</replaceable>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>-m</term>
|
|
<listitem>
|
|
<para>
|
|
Don't send mouse motion events.
|
|
<!-- TODO: what is this good for? -->
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>-n <replaceable class="parameter">hostname</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
Set the reported client hostname to <replaceable class="parameter">hostname</replaceable>.
|
|
Default is to automatically detect the hostname.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>-o</term>
|
|
<listitem>
|
|
<para>
|
|
Play audio on the console instead of redirecting to the client.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>-p <replaceable class="parameter">password</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
Password used in authentication.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry id="AlternateShell">
|
|
<term>-s <replaceable class="parameter">shell</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
Sets the startup-shell to <replaceable class="parameter">shell</replaceable>.
|
|
This parameter should contain a complete path to the alternate shell.
|
|
If the alternete shell requires a different working directory use <xref linkend="WorkingDir"/>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>-t <replaceable class="parameter">port</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
Connect to <replaceable class="parameter">port</replaceable>, instead of the default 3389.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>-u <replaceable class="parameter">username</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
Username used in authentication.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>-x <replaceable class="parameter">flag</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
Set the experiance performance flags.
|
|
<replaceable class="parameter">flag</replaceable> can be one of:
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>
|
|
m - (modem): Equivalent to 15.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
b - (broadband): Equivalent to 1.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
l - (lan): Equivalent to 0.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<replaceable class="parameter">num</replaceable> - A number that represents a
|
|
bit-mask, were numbers mean the following
|
|
<footnote><para>Taken from <ulink url="http://msdn.microsoft.com/en-us/library/cc240476%28v=prot.10%29.aspx">
|
|
MS-RDPBCGR Scetion 2.2.1.11.1.1.1 - Extended Info Packet</ulink></para></footnote>:
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>1: Disable desktop wallpaper.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>2: Disable full-window drag (only the window outline is displayed when the window is moved).</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>4: Disable menu animations.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>8: Disable user interface themes.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>32: Disable mouse cursor shadows.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>64: Disable cursor blinking.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>128: Enable font smoothing.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>256: Enable Desktop Composition.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>-z</term>
|
|
<listitem>
|
|
<para>
|
|
Enable compression.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>--app</term>
|
|
<listitem>
|
|
<para>
|
|
initialize a RemoteApp connection. This implies -g workarea.
|
|
FIXME: How to do RemoteApp
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>--ext</term>
|
|
<listitem>
|
|
<para>
|
|
load an extension
|
|
FIXME: How to do this
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>--no-auth</term>
|
|
<listitem>
|
|
<para>
|
|
Skips authentication. This is useful e.g. for the current FreeRDP server that doesn't yet support server-side authentication.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>--no-fastpath</term>
|
|
<listitem>
|
|
<para>
|
|
Disables fast-path. Use slow-path packets instead, which have larger headers.
|
|
It might be good for debugging certain issues when you suspect it might be
|
|
linked to the parsing of one of the two header types.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>--no-osb</term>
|
|
<listitem>
|
|
<para>
|
|
Disable off screen bitmaps.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>--plugin</term>
|
|
<listitem>
|
|
<para>
|
|
load a plugin
|
|
FIXME: How to do this
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>--rfx</term>
|
|
<listitem>
|
|
<para>
|
|
Enable RemoteFX.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>--no-rdp</term>
|
|
<listitem>
|
|
<para>
|
|
Disable Standard RDP encryption.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>--no-tls</term>
|
|
<listitem>
|
|
<para>
|
|
Disable TLS encryption.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>--no-nla</term>
|
|
<listitem>
|
|
<para>
|
|
Disable network level authentication.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>--sec <replaceable class="parameter">proto</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
force protocol security. <replaceable class="parameter">proto</replaceable> can be one of rdp, tls or nla.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>--version</term>
|
|
<listitem>
|
|
<para>
|
|
Print version information.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
<!-- refsect1>
|
|
<title>USAGE</title>
|
|
<para>
|
|
<command>foo</command> -f foo.conf -d2 foodata.foo
|
|
</para>
|
|
</refsect1 -->
|
|
<!-- refsect1>
|
|
<title>CAVEATS</title>
|
|
<para>
|
|
Other programs named <command>foo</command> may exist and actually
|
|
do something!
|
|
</para>
|
|
</refsect1 -->
|
|
<!-- refsect1>
|
|
<title>BUGS</title>
|
|
<para>
|
|
None. Program does nothing.
|
|
</para>
|
|
</refsect1 -->
|
|
<refsect1>
|
|
<title>LINKS</title>
|
|
<para>
|
|
<ulink url="http://www.freerdp.com/">http://www.freerdp.com/</ulink>
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|