--- sourceforge.net/trunk/rdesktop/doc/rdesktop.1 2002/09/01 11:15:42 106 +++ sourceforge.net/trunk/rdesktop/doc/rdesktop.1 2003/10/28 05:07:00 520 @@ -1,108 +1,123 @@ -.TH RDESKTOP 1 "September 2002" "Manual page for rdesktop" -.\" -.\" Man page author: -.\" Hugo Trippaers -.\" Peter Åstrand +.TH rdesktop 1 "October 2002" .SH NAME .I rdesktop \- Remote Desktop Protocol client .SH SYNOPSIS -.B rdesktop [options] server +.B rdesktop [options] server[:port] .br .SH DESCRIPTION .I rdesktop -is a client for Windows NT4 Terminal Server and Windows 2000 Terminal -Services. rdesktop implements the RDP version 4 protocol, which used -by Windows NT4 Terminal Server, and parts of RDP version 5, which is -used by Windows 2000 Terminal Services. +is a client for Remote Desktop Protocol (RDP), used in a number of Microsoft +products including Windows NT Terminal Server, Windows 2000 Server, Windows XP +and Windows 2003 Server. .SH OPTIONS .TP .BR "-u " -The username for authentication on the terminal server, together with -p -this can be used for autologon. +Username for authentication on the server. .TP .BR "-d " -The domain to to which the user belongs. +Domain for authentication. .TP .BR "-s " -The startup shell for the user. Use this to start a specific application, -instead of a regular desktop. +Startup shell for the user - starts a specific application instead of Explorer. .TP .BR "-c " -The current working directory for the user. Often used in combination with -s -to setup a fixed environment for the user after logon. +The initial working directory for the user. Often used in combination with -s +to set up a fixed login environment. .TP .BR "-p " -The password to authenticate with, used in combination with -u for -autologon. Use -p - to make rdesktop request a password at startup. -WARNING: the -p option will be visible to all users when -they use tools like ps. The -P option is safer. -.TP -.BR "-P " -The program to fetch the password from. The program will be executed, -and the output will be used as the password. This is a safe way to -transfer the password to rdesktop. -.TP -.BR "-n " -Client name. The default is the hostname. +The password to authenticate with. Note that this may have no effect if +"Always prompt for password" is enabled on the server. WARNING: if you specify +a password on the command line it may be visible to other users when they use +tools like ps. Use -p - to make rdesktop request a password at startup (from +standard input). +.TP +.BR "-n " +Client hostname. Normally rdesktop automatically obtains the hostname of the +client. .TP .BR "-k " -keyboard layout on terminal server (us,sv,gr etc.) +Keyboard layout to emulate. This requires a corresponding keymap file to be +installed. The standard keymaps provided with rdesktop follow the RFC1766 +naming scheme: a language code followed by a country code if necessary - e.g. +en-us, en-gb, de, fr, sv, etc. The default is en-us (a US keyboard). .TP .BR "-g " -Desktop geometry (WxH). +Desktop geometry (WxH). If geometry is the special word "workarea", the geometry +will be fetched from the extended window manager hints property _NET_WORKAREA, from +the root window. The geometry can also be specified as a percentage of the whole +screen, e.g. "-g 80%". .TP .BR "-f" -Enable fullscreen mode. The -g option will be ignored when using -f, -rdesktop will get the current height and width from the current -desktop. +Enable fullscreen mode. This overrides the window manager and causes the +rdesktop window to fully cover the current screen. Fullscreen mode can be +toggled at any time using Ctrl-Alt-Enter. .TP .BR "-b" -Force bitmap updates. +Force the server to send screen updates as bitmaps rather than using +higher-level drawing operations. .TP .BR "-e" -Do not use encryption, this is only for people who are not allowed to -use encryption in Windows products. If you live in France you -probably need this switch. +Disable encryption. This option is only needed (and will only work) if you +have a French version of NT TSE. +.TP +.BR "-E" +Disable encryption from client to server. This sends an encrypted login packet, +but everything after this is unencrypted (including interactive logins). .TP .BR "-m" -Do not send motion events. +Do not send mouse motion events. This saves bandwidth, although some Windows +applications may rely on receiving mouse motion. .TP -.BR "-l" -Do not request licence. +.BR "-C" +Use private colourmap. This will improve colour accuracy on an 8-bit display, +but rdesktop will appear in false colour when not focused. .TP -.BR "-t " -Connect to this TCP port. The default is 3389. +.BR "-D" +Hide window manager decorations, by using MWM hints. .TP .BR "-K" -Keep window manager key bindings. +Do not override window manager key bindings. By default rdesktop attempts +to grab all keyboard input when it is in focus. +.TP +.BR "-S