GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XEPHYR (1)

NAME

Xephyr - X server outputting to a window on a pre-existing X display

CONTENTS

Synopsis
Description
Options
Caveats
Author

SYNOPSIS

Xephyr [:display] [option ...]

DESCRIPTION

Xephyr is a kdrive server that outputs to a window on a pre-existing "host" X display. Think Xnest but with support for modern extensions like composite, damage and randr.

Unlike Xnest which is an X proxy, i.e. limited to the capabilities of the host X server, Xephyr is a real X server which uses the host X server window as "framebuffer" via fast SHM XImages.

It also has support for "visually" debugging what the server is painting.

OPTIONS

The server accepts all the standard options of Xserver(1) and the following additional options:
-screen widthxheight
  sets the screen size.
-parent id
  uses existing window id . If a -screen argument follows a -parent argument, this screen is embedded into the given window.
-host-cursor
  set ’cursor acceleration’: The host’s cursor is reused. This is only really there to aid debugging by avoiding server paints for the cursor. Performance improvement is negligible.
-resizeable
  Allow the Xephyr window to be resized, even if not embedded into a parent window. By default, the Xephyr window has a fixed size.
-no-host-grab
  Disable grabbing the keyboard and mouse.

SIGNALS

Send a SIGUSR1 to the server (e.g. pkill -USR1 Xephyr) to toggle the debugging mode. In this mode red rectangles are painted to screen areas getting painted before painting the actual content. The delay between this can be altered by setting a XEPHYR_PAUSE env var to a value in micro seconds.

CAVEATS

o Rotated displays are currently updated via full blits. This is slower than a normal orientated display. Debug mode will therefore not be of much use rotated.
o The ’-host-cursor’ cursor is static in its appearance.
o The build gets a warning about ’nanosleep’. I think the various ’-D’ build flags are causing this. I haven’t figured as yet how to work round it. It doesn’t appear to break anything however.
o Keyboard handling is basic but works.
o Mouse button 5 probably won’t work.

SEE ALSO

X(7), Xserver(1)

AUTHOR

Matthew Allum <mallum@o-hand.com> 2004
Search for    or go to Top of page |  Section 1 |  Main Index


X Version 11 XEPHYR (1) xorg-server 1.17.4

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.