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       The server accepts all the standard options of Xserver(1) and the  fol‐
25       lowing additional options:
26
27       -screen widthxheight
28               sets the screen size.
29
30       -parent id
31               uses  existing  window  id  .   If a -screen argument follows a
32               -parent argument, this screen is embedded into the  given  win‐
33               dow.
34
35       -host-cursor
36               set 'cursor acceleration': The host's cursor is reused. This is
37               only really there to aid debugging by  avoiding  server  paints
38               for the cursor. Performance improvement is negligible.
39
40       -resizeable
41               Allow  the  Xephyr  window  to be resized, even if not embedded
42               into a parent window. By default, the Xephyr window has a fixed
43               size.
44
45       -no-host-grab
46               Disable grabbing the keyboard and mouse.
47

SIGNALS

49       Send  a  SIGUSR1  to the server (e.g. pkill -USR1 Xephyr) to toggle the
50       debugging mode.  In this mode red rectangles are painted to screen  ar‐
51       eas  getting painted before painting the actual content.  The delay be‐
52       tween this can be altered by setting a XEPHYR_PAUSE env var to a  value
53       in micro seconds.
54

CAVEATS

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

SEE ALSO

71       X(7), Xserver(1)
72

AUTHOR

74       Matthew Allum <mallum@o-hand.com> 2004
75
76
77
78X Version 11                  xorg-server 1.20.11                    Xephyr(1)
Impressum