Rev 3 | Details | Compare with Previous | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
3 | magnus | 1 | .TH x2vnc 1 |
2 | .SH NAME |
||
3 | x2vnc \- a dual-screen hack |
||
4 | |||
5 | .SH SYNOPSIS |
||
6 | .B x2vnc |
||
7 | .I <options> |
||
8 | .I <host>:<display#> |
||
9 | .br |
||
10 | .B x2vnc |
||
11 | .I <options> |
||
12 | .I -listen |
||
13 | .I [<display#>] |
||
14 | .br |
||
15 | [ |
||
16 | .B \-display |
||
17 | .I display |
||
18 | ] |
||
19 | .br |
||
20 | [ |
||
21 | .B -version |
||
22 | ] |
||
23 | .br |
||
24 | [ |
||
25 | .B -shared |
||
26 | ] |
||
27 | .br |
||
28 | [ |
||
29 | .B -north |
||
30 | ] [ |
||
31 | .B -south |
||
32 | ] [ |
||
33 | .B -east |
||
34 | ] [ |
||
35 | .B -west |
||
36 | ] |
||
37 | .br |
||
38 | [ |
||
39 | .B -hotkey |
||
40 | .I key |
||
41 | ] |
||
42 | .br |
||
43 | [ |
||
44 | .B -passwdfile |
||
45 | .I passwd-file |
||
46 | ] |
||
47 | .br |
||
48 | [ |
||
49 | .B -resurface |
||
50 | ] |
||
51 | .br |
||
52 | [ |
||
53 | .B -edgewidth |
||
54 | .I width |
||
55 | ] |
||
56 | .br |
||
57 | [ |
||
58 | .B -desktop |
||
59 | .I desktop-number |
||
60 | ] |
||
61 | .br |
||
62 | [ |
||
63 | .B -timeout |
||
64 | .I seconds |
||
65 | ] |
||
66 | .br |
||
67 | [ |
||
68 | .B -wheelhack |
||
69 | ] |
||
70 | .br |
||
71 | [ |
||
72 | .B -nowheel |
||
73 | ] |
||
74 | .br |
||
75 | [ |
||
76 | .B -reversewheel |
||
77 | ] |
||
78 | .br |
||
79 | [ |
||
80 | .B -scrolllines |
||
81 | .I lines |
||
82 | ] |
||
83 | .br |
||
84 | [ |
||
85 | .B -navhack |
||
86 | ] |
||
87 | .br |
||
88 | [ |
||
89 | .B -mac |
||
90 | ] |
||
91 | .br |
||
92 | [ |
||
93 | .B -trimsel |
||
94 | ] |
||
95 | .br |
||
96 | [ |
||
97 | .B -noblank |
||
98 | ] |
||
99 | .br |
||
100 | [ |
||
101 | .B -lockdelay |
||
102 | .I seconds |
||
103 | ] |
||
104 | .br |
||
105 | [ |
||
106 | .B -debug |
||
107 | ] |
||
108 | .br |
||
109 | [ |
||
110 | .B -accel |
||
111 | .I multiplier |
||
112 | ] |
||
113 | .br |
||
114 | [ |
||
115 | .B -noreconnect |
||
116 | ] |
||
117 | .br |
||
118 | [ |
||
119 | .B -tunnel |
||
120 | ] |
||
121 | .br |
||
122 | [ |
||
123 | .B -via |
||
124 | .I host |
||
125 | ] |
||
126 | .SH DESCRIPTION |
||
127 | .I x2vnc |
||
128 | will let you use two screens on two different computers as if they were |
||
129 | connected to the same computer. The computer with the 'main' keyboard must |
||
130 | be running X-window, and the second computer should have a VNC server |
||
131 | running which will update the contents on the actual screen. This means |
||
132 | \fIXvnc\fR is not suitable, but \fIWinVNC\fR is. |
||
133 | |||
134 | In listen mode ( |
||
135 | .B -listen |
||
136 | option specified ) |
||
137 | .I x2vnc |
||
138 | will wait for a connection from a VNC server on ports 5400 and 5500 (plus |
||
139 | the optional |
||
140 | .I display# |
||
141 | value) instead of connecting to a specified VNC server. |
||
142 | |||
143 | For up-to-date information on x2vnc, see the x2vnc home page: |
||
144 | .B http://fredrik.hubbe.net/x2vnc.html |
||
145 | |||
146 | .TP |
||
147 | \fB\-display\fR \fIdisplay\fR |
||
148 | The X windows display to connect from. |
||
149 | .TP |
||
150 | \fB\-shared\fR |
||
151 | Allow multiple connections to the same VNC server. |
||
152 | .TP |
||
153 | \fB\-north\fR, \fB\-south\fR, \fB\-east\fR, \fB\-west\fR, |
||
154 | Determine which edge leads to the other screen. |
||
155 | .TP |
||
156 | \fB\-passwdfile\fR \fIpassword-file\fR |
||
157 | With this option you can start x2vnc without entering a password. The file is |
||
158 | created by \fBvncpasswd\fR which comes with the X-windows VNC software. |
||
159 | If the file does not exist, \fIx2vnc\fR will ask for a password and |
||
160 | create the file. |
||
161 | .TP |
||
162 | \fB\-resurface\fR |
||
163 | This option will cause the trigger window to re-surface automatically if it is |
||
164 | covered up by another window. |
||
165 | .TP |
||
166 | \fB\-hotkey\fR \fIkey\fR |
||
167 | This option allows you to select which key to use to warp the pointer |
||
168 | to and from second computer. The default is "Control-F12", any |
||
169 | combination of modifiers can be used, such as "shift-alt-meta-ctrl-F1" |
||
170 | (or s-a-m-c-F1). |
||
171 | .TP |
||
172 | \fB\-edgewidth\fR \fIpixels\fR |
||
173 | This is a workaround for some X servers which do not allow the mouse to |
||
174 | go all the way to the edge of the screen. By setting this to 2 or greater, the |
||
175 | mouse will be able to reach the x2vnc window and thus warp to the |
||
176 | windows machine. The default value is 1. If you set this value to 0, |
||
177 | no border will be generated, which means you will have to use hotkeys |
||
178 | to switch to the oher screen. |
||
179 | .TP |
||
180 | \fB\-desktop\fR \fIdesktop-number\fR |
||
181 | With this option, you can make x2vnc non-sticky. This may not work |
||
182 | with all window-managers. Note that the first desktop is usually |
||
183 | |||
184 | use -1. This option was especially created with the sawfish edgeflipping |
||
185 | in mind, normally you would use "-west -desktop 0" or "-east -destkop -1" |
||
186 | with Sawfish to allow edgeflipping to work normally. |
||
187 | .TP |
||
188 | \fB\-timeout\fR \fIseconds\fR |
||
189 | This options tells x2vnc how long to wait before warping the cursor back |
||
190 | to the X screen if there is no activity. The reason for this is that |
||
191 | some screen savers, such as xscreensaver, cannot activate while x2vnc is |
||
192 | in control of the cursor. The default value is 590 seconds, which is |
||
193 | equivalent to 9 minutes and 50 seconds. Using a value of 0 will disable |
||
194 | timeouts completely. |
||
195 | .TP |
||
196 | \fB\-nowheel\fR |
||
197 | This option does nothing and is left for backwards compatibility only. |
||
198 | .TP |
||
199 | \fB\-wheelhack\fR |
||
200 | This will make x2vnc tranlate all mouse wheel events into arrow up/down |
||
201 | events. Only use this if your VNC server doesn't understand mouse wheel |
||
202 | events. |
||
203 | .TP |
||
204 | \fB\-reversewheel\fR |
||
205 | Invert the up/down direction of the mouse wheel emulation. |
||
206 | This option only works if -wheelhack is used. |
||
207 | .TP |
||
208 | \fB\-scrolllines\fR \fIlines\fR |
||
209 | When using mouse wheel emulation, this selects how many up/down |
||
210 | events will be sent for each tick of the mouse wheel. |
||
211 | .TP |
||
212 | \fB\-navhack\fR |
||
213 | This will map button 6 & 7 to Alt+Left/Right, which will allow the |
||
214 | navigation buttons on some mice to behave more like they do in windows. |
||
215 | .TP |
||
216 | \fB\-mac\fR |
||
217 | Macintosh specific mode, maps second mouse button to control-mouseclick. |
||
218 | .TP |
||
219 | \fB\-trimsel\fR |
||
220 | If the X selection looks like a URL, trim leading and trailing spaces. |
||
221 | This can be useful for pasting URLs into a browser. |
||
222 | .TP |
||
223 | \fB\-noblank\fR |
||
224 | Prevent screen blanking on the remote desktop while you are working |
||
225 | on the local desktop. Requires the MIT-SCREEN-SAVER or XIDLE extension |
||
226 | to work properly. If neither of these extensions are present, the |
||
227 | remote desktop will always be kept from blanking. |
||
228 | .TP |
||
229 | \fB\-lockdelay\fR \fIseconds\fR |
||
230 | This is only meaningful when using the -noblank option. When this |
||
231 | option is present. With this option, x2vnc will not attempt to |
||
232 | wake up the remote screen if you have been idle for more than |
||
233 | the specified amount of time. This is useful if you need a password |
||
234 | to unlock the remote screen and would rather leave it blanked until |
||
235 | you need it. |
||
236 | .TP |
||
237 | \fB\-debug\fR |
||
238 | This option will make x2vnc print out information about events it |
||
239 | sends and receives to stderr for debugging purposes. |
||
240 | .TP |
||
241 | \fB\-accel\fR \fImultiplier\fR |
||
242 | This option allows you to control the speed of the mouse on the |
||
243 | remote screen. 2.0 means twice as fast, 0.5 means half as fast. |
||
244 | Default is 1.0. Note that this is multiplied with a number which |
||
245 | x2vnc calculates based on screen sizes and other factors. |
||
246 | .TP |
||
247 | \fB\-noreconnect\fR |
||
248 | This option prevents x2vnc from automatically reconnecting if the |
||
249 | connection is closed. |
||
250 | .TP |
||
251 | \fB\-tunnel\fR |
||
252 | This option makes x2vnc start an SSH tunnel to the machine being |
||
253 | controlled by x2vnc. The SSH command used can be changed by setting |
||
254 | the X2VNC_SSH_CMD environment variable. The default is: |
||
255 | .br |
||
256 | \fBssh -A -X -f -L "$LOCALPORT:$REMOTEHOST:$REMOTEPORT" \\ |
||
257 | .br |
||
258 | "$GATEWAYHOST" 'ssh-add;sleep 60'\fR |
||
259 | .TP |
||
260 | \fB\-via\fR \fIhost\fR |
||
261 | This is similar to -tunnel, but tunnels through a host different than |
||
262 | the machine being controlled by x2vnc. |
||
263 | |||
264 | |||
265 | .SH EXAMPLES |
||
266 | Most common usage: |
||
267 | .br |
||
268 | \fBx2vnc -passwdfile $HOME/.vncpasswd -resurface host:0\fR |
||
269 | |||
270 | To make x2vnc start (and re-start) automatically, add the following to |
||
271 | your your X startup file (usually .xinitrc): |
||
272 | .br |
||
273 | \fB |
||
274 | while :; |
||
275 | .br |
||
276 | do |
||
277 | x2vnc -passwd $HOME/.vncpasswd -resurface host:0 |
||
278 | .br |
||
279 | sleep 2 |
||
280 | .br |
||
281 | done |
||
282 | \fR |
||
283 | |||
284 | .SH AUTHOR |
||
285 | Fredrik Hübinette, hubbe@hubbe.net |