Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
x2x(1)									x2x(1)

NAME
       x2x - X to X connection

SYNTAX
       x2x  <[-to <DISPLAY>] | [-from <DISPLAY>]> [options...]

DESCRIPTION
       x2x  allows the keyboard	and mouse on one ("from") X display to be used
       to control another ("to") X display.  Since x2x uses the	 XTEST	exten-
       sion, the "to" X	display	must support XTEST.

       In  the	default	 interface,  x2x  puts a window	on the "from" display.
       This window is labeled with the name of the "to"	 display.   Keystrokes
       typed  into  this  window go to the window on the "to" display that has
       the input focus.	 Clicking on the x2x window causes the	mouse  on  the
       "from" display to control the cursor on the "to"	display.  Performing a
       subsequent multiple button click	on the "to" display returns control to
       the "from" display.

       If  the	-east  or -west	options	are specified on the command line, x2x
       starts up with a	different interface.  When  the	 mouse	moves  to  the
       (east  or  west)	 side of the default screen on the "from" display, the
       cursor slides over to the "to" display.	When the mouse returns	to  to
       side  of	 the  "to"  display  that  it entered, it slides back onto the
       "from" display.

       Unless the -nosel option	is specified, x2x relays X selections from one
       display to the other.

       Here  are  a  few  hints	 for  eXcursion	 users (based on Intel version
       2.1.309).  First, use the -big option.  Second, in the  control	panel,
       under  mouse, check the box that	enables	"Automatically Capture Text on
       Button Up."  X selections will then automatically move into the Windows
       clipboard.   As	is the case with all X applications running on 2.1.309
       (including x2x),	you will need to do an extra mouse  click  after  per-
       forming	the  X	selection for this operation to	work.  x2x is known to
       work poorly with	eXcursion running on Windows 95, probably due  to  the
       Windows	95  task scheduler.  x2x does work well	with eXcursion running
       on Windows NT.

       The hints for eXcursion are also	valid for Exceed, with	the  exception
       that  X	selections  work  better, as long as you are using x2x version
       1.25 or later.

OPTIONS
       Either the -to option or	the -from option (or both) must	be  specified.

       -to display

	      Indicates	 the ("to") display that is remotely controlled	by the
	      "from" display.  Default is equivalent to	the default display.

       -from display

	      Indicates	the ("from") display that remotely controls  the  "to"
	      display.	Default	is equivalent to the default display.

       -east

	      Slide off	the east side of the "to" display onto the "from" dis-
	      play.

       -west

	      Slide off	the west side of the "to" display onto the "from" dis-
	      play.

       -font fontname

	      The font used in the x2x window. (Overridden by -east or -west.)

       -geometry specification

	      The X geometry specification for the x2x window.	(Overridden by
	      -east or -west.)

       -wait

	      Tells  x2x to poll the "to" and "from" displays at startup until
	      they are ready.  Useful for login	scripts.

       -big

	      Workaround for a bug in the cursor grab  implementations	of  at
	      least  one  X server.  Put a big window over the "to" display in
	      order to force the X server to track the cursor.

       -buttonblock

	      If this option is	enabled	with -east or -west, the  cursor  will
	      not  slide  back	onto the "from"	display	when one or more mouse
	      buttons are pressed.

       -nomouse

	      Don't capture the	mouse.	(Overridden by -east or	-west.)

       -nopointermap

	      Since x2x	uses XTEST, which sends	input at a  lower  level  than
	      the  pointer  button  mapping,  x2x needs	to understand the "to"
	      display's	button mapping and  do	appropriate  conversion.   Use
	      this option to turn off the pointer button conversion.

       -nosel

	      Don't relay the X	selection between displays.

       -noautoup

	      Normally,	 the  autoup feature in	x2x automatically lifts	up all
	      keys and mouse buttons when  it  removes	the  cursor  from  the
	      "from"  display.	 Note: the autoup feature changes the state of
	      lock functions like Caps Lock.  The state	of the	lock  function
	      may  not	correspond to the state	of the keyboard	LEDs!  To dis-
	      able this	feature, use the -noautoup command line	option.

       -resurface

	      Ugly hack	to work-around window manager ugliness.	 The -east and
	      -west  modes  actually  put  a  small  window on the side	of the
	      "from" display.  This option causes  this	 window	 to  resurface
	      itself  if  another  window  ever	 obscures it.  This option can
	      cause really nasty behavior if another application tries	to  do
	      the same thing.  Useful for login	scripts.

       -shadow display

	      Also sends mouse movements and keystrokes	to this	display.  Use-
	      ful for demos.  Amaze your friends: specify multiple shadows.

       -sticky sticky-key

	      This option is primarily for "lock" keys like Caps_Lock.	 If  a
	      lock  key	 only  seems  to  work	on every other press, try this
	      option.  The sticky option prevents  autoup  for	the  specified
	      key.   Look  in /usr/include/X11/keysymdef.h for a list of valid
	      names of keys (remove the	leading	XK_).

AUTHOR
       David Chaiken
       (chaiken@pa.dec.com)

BUGS
       This software is	experimental!  Heaven help you if your network connec-
       tion should go down.  Caveat hacker.  TANSTAAFL.

LAWYERESE
       Copyright (c) 1997 Digital Equipment Corporation.  All rights reserved.

       By downloading, installing, using, modifying or distributing this soft-
       ware, you agree to the following:

       1.  CONDITIONS.	Subject	to the following conditions, you may download,
       install,	use, modify and	distribute this	software in source and	binary
       forms:

       a) Any source code, binary code and associated documentation (including
       the online manual) used,	modified or  distributed  must	reproduce  and
       retain the above	copyright notice, this list of conditions and the fol-
       lowing disclaimer.

       b) No right is granted to use any trade name, trademark or logo of Dig-
       ital  Equipment	Corporation.   Neither the "Digital Equipment Corpora-
       tion" name nor any trademark or logo of Digital	Equipment  Corporation
       may  be	used to	endorse	or promote products derived from this software
       without the prior written permission of Digital Equipment  Corporation.

       2.   DISCLAIMER.	  THIS SOFTWARE	IS PROVIDED BY DIGITAL "AS IS" AND ANY
       EXPRESS OR IMPLIED WARRANTIES,  INCLUDING,  BUT	NOT  LIMITED  TO,  THE
       IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PUR-
       POSE ARE	DISCLAIMED.IN NO EVENT SHALL DIGITAL BE	LIABLE FOR ANY DIRECT,
       INDIRECT,  INCIDENTAL,  SPECIAL,	 EXEMPLARY,  OR	 CONSEQUENTIAL DAMAGES
       (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SER-
       VICES; LOSS OF USE, DATA, OR PROFITS; OR	BUSINESS INTERRUPTION) HOWEVER
       CAUSED AND ON ANY THEORY	OF LIABILITY, WHETHER IN CONTRACT, STRICT LIA-
       BILITY,	OR TORT	(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
       OUT OF THE USE OF THIS SOFTWARE,	EVEN IF	ADVISED	OF THE POSSIBILITY  OF
       SUCH DAMAGE.

       Windows 95 and Windows NT are trademarks	of Microsoft Corporation.
       Exceed is a trademark of	Hummingbird Communications Ltd.

									x2x(1)

NAME | SYNTAX | DESCRIPTION | OPTIONS | AUTHOR | BUGS | LAWYERESE

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=x2x&manpath=FreeBSD+Ports+7.0-RELEASE>

home | help