diff --git a/client/X11/CMakeLists.txt b/client/X11/CMakeLists.txt index 38364105d..1854f3327 100644 --- a/client/X11/CMakeLists.txt +++ b/client/X11/CMakeLists.txt @@ -32,7 +32,18 @@ add_executable(xfreerdp xf_window.h xfreerdp.c xfreerdp.h) - + +if(WITH_MANPAGES) + add_custom_command(OUTPUT xfreerdp.1 + COMMAND xmlto man ${CMAKE_CURRENT_SOURCE_DIR}/xfreerdp.1.xml + DEPENDS xfreerdp.1.xml) + + add_custom_target(xfreerdp.manpage ALL + DEPENDS xfreerdp.1) + + install(FILES xfreerdp.1 DESTINATION share/man/man1) +endif() + find_package(Xinerama) if(XINERAMA_FOUND) add_definitions(-DWITH_XINERAMA) @@ -63,3 +74,4 @@ target_link_libraries(xfreerdp freerdp-utils) target_link_libraries(xfreerdp ${X11_LIBRARIES}) install(TARGETS xfreerdp DESTINATION bin) + diff --git a/client/X11/xfreerdp.1.xml b/client/X11/xfreerdp.1.xml new file mode 100644 index 000000000..88b897dac --- /dev/null +++ b/client/X11/xfreerdp.1.xml @@ -0,0 +1,389 @@ + + + + 2011-08-27 + + The FreeRDP-Team + + + + xfreerdp + 1 + freerdp + xfreerdp + + + xfreerdp + X11 frontend to libFreeRDP + + + + 2011-08-27 + + + xfreerdp [options] server[:port] [[options] server[:port] …] + + + + + 2011-08-27 + + DESCRIPTION + + xfreerdp 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. + + + + OPTIONS + + + -0 + + + Attach to the admin console of the server. + + + + + -a bpp + + + Sets the color depth for the connection to bpp bits per pixel. + Valid values are 8, 15, 16, 24 and 32. The default value is the color depth of the FreeRDP-window. + + + + + -c dir + + + Sets the working-dir to dir. + This parameter is only used when an AlternateShell () is requested. + dir should contain the executable file specified in the AlternateShell. + + + + + -D + + + Removes the windows decorations. + + + + + -d + + + Domain used in authentication. + + + + + -f + + + start in full screen mode. This mode can always be en- and disabled using Ctrl-Alt-Enter. + + + + + -g geometry + + + Sets the size of the FreeRDP-window (and of the remote desktop, when establishing a new connection). + geometry can have one of the following forms: + + + + WxH - + in this case the resulting window will be of + WxH pixels. + + + + + P% - + in this case the resulting window will be P% + of your screen. + + + + + The special keyword workarea - + in this case the resulting window will be of the same size as your workarea. + + + + + + + + -k id + + + Sets the keyboard-layout-id to id. + + + + + -m + + + Don't send mouse motion events. + + + + + + -n hostname + + + Set the reported client hostname to hostname. + Default is to automatically detect the hostname. + + + + + -o + + + Play audio on the console instead of redirecting to the client. + + + + + -p password + + + Password used in authentication. + + + + + -s shell + + + Sets the startup-shell to shell. + This parameter should contain a complete path to the alternate shell. + If the alternete shell requires a different working directory use . + + + + + -t port + + + Connect to port, instead of the default 3389. + + + + + -u username + + + Username used in authentication. + + + + + -x flag + + + Set the experiance performance flags. + flag can be one of: + + + + m - (modem): Equivalent to 15. + + + + + b - (broadband): Equivalent to 1. + + + + + l - (lan): Equivalent to 0. + + + + + num - A number that represents a + bit-mask, were numbers mean the following + Taken from + MS-RDPBCGR Scetion 2.2.1.11.1.1.1 - Extended Info Packet: + + + 1: Disable desktop wallpaper. + + + 2: Disable full-window drag (only the window outline is displayed when the window is moved). + + + 4: Disable menu animations. + + + 8: Disable user interface themes. + + + 32: Disable mouse cursor shadows. + + + 64: Disable cursor blinking. + + + 128: Enable font smoothing. + + + 256: Enable Desktop Composition. + + + + + + + + + + -z + + + Enable compression. + + + + + --app + + + initialize a RemoteApp connection. This implies -g workarea. + FIXME: How to do RemoteApp + + + + + --ext + + + load an extension + FIXME: How to do this + + + + + --no-auth + + + Skips authentication. This is useful e.g. for the current FreeRDP server that doesn't yet support server-side authentication. + + + + + --no-fastpath + + + 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. + + + + + --no-osb + + + Disable off screen bitmaps. + + + + + --plugin + + + load a plugin + FIXME: How to do this + + + + + --rfx + + + Enable RemoteFX. + + + + + --no-rdp + + + Disable Standard RDP encryption. + + + + + --no-tls + + + Disable TLS encryption. + + + + + --no-nla + + + Disable network level authentication. + + + + + --sec proto + + + force protocol security. proto can be one of rdp, tls or nla. + + + + + --version + + + Print version information. + + + + + + + + + + LINKS + + http://www.freerdp.com/ + + + diff --git a/cmake/ConfigOptions.cmake b/cmake/ConfigOptions.cmake index c49541b80..295b0cd88 100644 --- a/cmake/ConfigOptions.cmake +++ b/cmake/ConfigOptions.cmake @@ -9,5 +9,6 @@ option(WITH_DEBUG_CERTIFICATE "Print certificate related debug messages." OFF) option(WITH_DEBUG_LICENSE "Print license debug messages." OFF) option(WITH_DEBUG_GDI "Print graphics debug messages." OFF) option(WITH_DEBUG_RFX "Print RemoteFX debug messages." OFF) +option(WITH_MANPAGES "Generate manpages." ON) option(WITH_PROFILER "Compile profiler." OFF) option(WITH_SSE2 "Use SSE2 optimization." OFF)