1Xephyr(1)                   General Commands Manual                  Xephyr(1)
2
3
4

NAME

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

SYNOPSIS

9       Xephyr [:display] [option ...]
10

DESCRIPTION

12       Xephyr  is  a  kdrive server that outputs to a window on a pre-existing
13       "host" X display.  Think Xnest but with support for  modern  extensions
14       like composite, damage and randr.
15
16       Unlike  Xnest which is an X proxy, i.e.  limited to the capabilities of
17       the host X server, Xephyr is a real X server  which  uses  the  host  X
18       server window as "framebuffer" via fast SHM XImages.
19
20       It  also has support for "visually" debugging what the server is paint‐
21       ing.
22

OPTIONS

24       -screen widthxheight
25               sets the screen size.
26
27       -parent id
28               uses exiting window id .  If a -screen argument follows a -par‐
29               ent argument, this screen is embedded into the given window.
30
31       -host-cursor
32               set 'cursor acceleration': The host's cursor is reused. This is
33               only really there to aid debugging by  avoiding  server  paints
34               for the cursor. Performance improvement is negligible.
35

SIGNALS

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

CAVEATS

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

SEE ALSO

59       X(7), Xserver(1)
60

AUTHOR

62       Matthew Allum <mallum@o-hand.com> 2004
63
64
65
66
67
68X Version 11                   xorg-server 1.9.5                     Xephyr(1)
Impressum