| 0,0 → 1,285 |
|---|
| .TH x2vnc 1 |
| .SH NAME |
| x2vnc \- a dual-screen hack |
| |
| .SH SYNOPSIS |
| .B x2vnc |
| .I <options> |
| .I <host>:<display#> |
| .br |
| .B x2vnc |
| .I <options> |
| .I -listen |
| .I [<display#>] |
| .br |
| [ |
| .B \-display |
| .I display |
| ] |
| .br |
| [ |
| .B -version |
| ] |
| .br |
| [ |
| .B -shared |
| ] |
| .br |
| [ |
| .B -north |
| ] [ |
| .B -south |
| ] [ |
| .B -east |
| ] [ |
| .B -west |
| ] |
| .br |
| [ |
| .B -hotkey |
| .I key |
| ] |
| .br |
| [ |
| .B -passwdfile |
| .I passwd-file |
| ] |
| .br |
| [ |
| .B -resurface |
| ] |
| .br |
| [ |
| .B -edgewidth |
| .I width |
| ] |
| .br |
| [ |
| .B -desktop |
| .I desktop-number |
| ] |
| .br |
| [ |
| .B -timeout |
| .I seconds |
| ] |
| .br |
| [ |
| .B -wheelhack |
| ] |
| .br |
| [ |
| .B -nowheel |
| ] |
| .br |
| [ |
| .B -reversewheel |
| ] |
| .br |
| [ |
| .B -scrolllines |
| .I lines |
| ] |
| .br |
| [ |
| .B -navhack |
| ] |
| .br |
| [ |
| .B -mac |
| ] |
| .br |
| [ |
| .B -trimsel |
| ] |
| .br |
| [ |
| .B -noblank |
| ] |
| .br |
| [ |
| .B -lockdelay |
| .I seconds |
| ] |
| .br |
| [ |
| .B -debug |
| ] |
| .br |
| [ |
| .B -accel |
| .I multiplier |
| ] |
| .br |
| [ |
| .B -noreconnect |
| ] |
| .br |
| [ |
| .B -tunnel |
| ] |
| .br |
| [ |
| .B -via |
| .I host |
| ] |
| .SH DESCRIPTION |
| .I x2vnc |
| will let you use two screens on two different computers as if they were |
| connected to the same computer. The computer with the 'main' keyboard must |
| be running X-window, and the second computer should have a VNC server |
| running which will update the contents on the actual screen. This means |
| \fIXvnc\fR is not suitable, but \fIWinVNC\fR is. |
| |
| In listen mode ( |
| .B -listen |
| option specified ) |
| .I x2vnc |
| will wait for a connection from a VNC server on ports 5400 and 5500 (plus |
| the optional |
| .I display# |
| value) instead of connecting to a specified VNC server. |
| |
| For up-to-date information on x2vnc, see the x2vnc home page: |
| .B http://fredrik.hubbe.net/x2vnc.html |
| |
| .TP |
| \fB\-display\fR \fIdisplay\fR |
| The X windows display to connect from. |
| .TP |
| \fB\-shared\fR |
| Allow multiple connections to the same VNC server. |
| .TP |
| \fB\-north\fR, \fB\-south\fR, \fB\-east\fR, \fB\-west\fR, |
| Determine which edge leads to the other screen. |
| .TP |
| \fB\-passwdfile\fR \fIpassword-file\fR |
| With this option you can start x2vnc without entering a password. The file is |
| created by \fBvncpasswd\fR which comes with the X-windows VNC software. |
| If the file does not exist, \fIx2vnc\fR will ask for a password and |
| create the file. |
| .TP |
| \fB\-resurface\fR |
| This option will cause the trigger window to re-surface automatically if it is |
| covered up by another window. |
| .TP |
| \fB\-hotkey\fR \fIkey\fR |
| This option allows you to select which key to use to warp the pointer |
| to and from second computer. The default is "Control-F12", any |
| combination of modifiers can be used, such as "shift-alt-meta-ctrl-F1" |
| (or s-a-m-c-F1). |
| .TP |
| \fB\-edgewidth\fR \fIpixels\fR |
| This is a workaround for some X servers which do not allow the mouse to |
| go all the way to the edge of the screen. By setting this to 2 or greater, the |
| mouse will be able to reach the x2vnc window and thus warp to the |
| windows machine. The default value is 1. If you set this value to 0, |
| no border will be generated, which means you will have to use hotkeys |
| to switch to the oher screen. |
| .TP |
| \fB\-desktop\fR \fIdesktop-number\fR |
| With this option, you can make x2vnc non-sticky. This may not work |
| with all window-managers. Note that the first desktop is usually |
| 0 (zero). If you want x2vnc to appear on the last (rightmost) desktop, |
| use -1. This option was especially created with the sawfish edgeflipping |
| in mind, normally you would use "-west -desktop 0" or "-east -destkop -1" |
| with Sawfish to allow edgeflipping to work normally. |
| .TP |
| \fB\-timeout\fR \fIseconds\fR |
| This options tells x2vnc how long to wait before warping the cursor back |
| to the X screen if there is no activity. The reason for this is that |
| some screen savers, such as xscreensaver, cannot activate while x2vnc is |
| in control of the cursor. The default value is 590 seconds, which is |
| equivalent to 9 minutes and 50 seconds. Using a value of 0 will disable |
| timeouts completely. |
| .TP |
| \fB\-nowheel\fR |
| This option does nothing and is left for backwards compatibility only. |
| .TP |
| \fB\-wheelhack\fR |
| This will make x2vnc tranlate all mouse wheel events into arrow up/down |
| events. Only use this if your VNC server doesn't understand mouse wheel |
| events. |
| .TP |
| \fB\-reversewheel\fR |
| Invert the up/down direction of the mouse wheel emulation. |
| This option only works if -wheelhack is used. |
| .TP |
| \fB\-scrolllines\fR \fIlines\fR |
| When using mouse wheel emulation, this selects how many up/down |
| events will be sent for each tick of the mouse wheel. |
| .TP |
| \fB\-navhack\fR |
| This will map button 6 & 7 to Alt+Left/Right, which will allow the |
| navigation buttons on some mice to behave more like they do in windows. |
| .TP |
| \fB\-mac\fR |
| Macintosh specific mode, maps second mouse button to control-mouseclick. |
| .TP |
| \fB\-trimsel\fR |
| If the X selection looks like a URL, trim leading and trailing spaces. |
| This can be useful for pasting URLs into a browser. |
| .TP |
| \fB\-noblank\fR |
| Prevent screen blanking on the remote desktop while you are working |
| on the local desktop. Requires the MIT-SCREEN-SAVER or XIDLE extension |
| to work properly. If neither of these extensions are present, the |
| remote desktop will always be kept from blanking. |
| .TP |
| \fB\-lockdelay\fR \fIseconds\fR |
| This is only meaningful when using the -noblank option. When this |
| option is present. With this option, x2vnc will not attempt to |
| wake up the remote screen if you have been idle for more than |
| the specified amount of time. This is useful if you need a password |
| to unlock the remote screen and would rather leave it blanked until |
| you need it. |
| .TP |
| \fB\-debug\fR |
| This option will make x2vnc print out information about events it |
| sends and receives to stderr for debugging purposes. |
| .TP |
| \fB\-accel\fR \fImultiplier\fR |
| This option allows you to control the speed of the mouse on the |
| remote screen. 2.0 means twice as fast, 0.5 means half as fast. |
| Default is 1.0. Note that this is multiplied with a number which |
| x2vnc calculates based on screen sizes and other factors. |
| .TP |
| \fB\-noreconnect\fR |
| This option prevents x2vnc from automatically reconnecting if the |
| connection is closed. |
| .TP |
| \fB\-tunnel\fR |
| This option makes x2vnc start an SSH tunnel to the machine being |
| controlled by x2vnc. The SSH command used can be changed by setting |
| the X2VNC_SSH_CMD environment variable. The default is: |
| .br |
| \fBssh -A -X -f -L "$LOCALPORT:$REMOTEHOST:$REMOTEPORT" \\ |
| .br |
| "$GATEWAYHOST" 'ssh-add;sleep 60'\fR |
| .TP |
| \fB\-via\fR \fIhost\fR |
| This is similar to -tunnel, but tunnels through a host different than |
| the machine being controlled by x2vnc. |
| |
| |
| .SH EXAMPLES |
| Most common usage: |
| .br |
| \fBx2vnc -passwdfile $HOME/.vncpasswd -resurface host:0\fR |
| |
| To make x2vnc start (and re-start) automatically, add the following to |
| your your X startup file (usually .xinitrc): |
| .br |
| \fB |
| while :; |
| .br |
| do |
| x2vnc -passwd $HOME/.vncpasswd -resurface host:0 |
| .br |
| sleep 2 |
| .br |
| done |
| \fR |
| |
| .SH AUTHOR |
| Fredrik Hübinette, hubbe@hubbe.net |