genode

History

Norman Feske fae63f4fa9 Merge base libraries into a single library This patch simplifies the way of how Genode's base libraries are organized. Originally, the base API was implemented in the form of many small libraries such as 'thread', 'env', 'server', etc. Most of them used to consist of only a small number of files. Because those libraries are incorporated in any build, the checking of their inter-dependencies made the build process more verbose than desired. Also, the number of libraries and their roles (core only, non-core only, shared by both core and non-core) were not easy to capture. Hereby, the base libraries have been reduced to the following few libraries: - startup.mk contains the startup code for normal Genode processes. On some platform, core is able to use the library as well. - base-common.mk contains the parts of the base library that are identical by core and non-core processes. - base.mk contains the complete base API implementation for non-core processes Consequently, the 'LIBS' declaration in 'target.mk' files becomes simpler as well. In the most simple case, only the 'base' library must be mentioned. Fixes #18		2013-02-19 14:45:55 +01:00
..
README	Imported Genode release 11.11	2011-12-22 16:19:25 +01:00
inject_input.cc	New Input::Event::FOCUS, rename keycode to code	2013-01-15 10:18:11 +01:00
inject_input.h	Update copyright headers to 2013	2013-01-10 21:44:47 +01:00
main.cc	xvfb: Adaptation to timer and framebuffer changes	2013-02-14 13:23:37 +01:00
target.mk	Merge base libraries into a single library	2013-02-19 14:45:55 +01:00

README

Xvfb is a virtual X server that uses a plain file as framebuffer instead of a
physical screen. The 'xvfb' glue program makes an Xvfb session available to the
Linux version of Genode such that both native Genode programs and X clients can
run seamlessly integrated in one Nitpicker session. Using the 'xvfb' glue
program contained in this directory.  Because Xvfb is executed as Nitpicker
client, it is possible to integrate multiple instances of Xvfb into the same
Nitpicker session.


Preconditions for compiling
---------------------------

The 'xvfb' glue program is a hybrid process using the Genode interfaces and the
Linux interfaces directly. It tracks dirty screen regions using the X damage
extension and injects user-input events into the X server using the X test
extension. So you need the development package of both extensions to compile
it. The Debian package for the X damage extension is called 'libxdamage-dev'.
The X test extension is normally installed by default.  Furthermore you need to
enhance your 'SPECS' declaration in your
'<builddir>/etc/specs.conf' file as follows:

! SPECS += x11 xdamage xtest


Usage
-----

First start Xvfb using the following command-line arguments:

! Xvfb :1 -fbdir /tmp -screen 0 1024x768x16

While Xvfb is running, '/tmp/Xvfb_screen0' will contain the content of the X
server's frame buffer. This file must be specified for the 'xvfb' declaration
in the config file. In addition, the display of X server instance must be
declared via the 'display' tag. For example:

! <config>
!   <display>:1</display>
!   <xvfb>/tmp/Xvfb_screen0</xvfb>
! </config>


Known Limitations
-----------------

* With the current version, some keycodes are not mapped correctly.
* The screen mode of Nitpicker and the Xvfb session must be the same.
  Only modes with 16bit color depth are supported.