1VIRTUALX.SH(1)        User Contributed Perl Documentation       VIRTUALX.SH(1)
2
3
4

NAME

6       BeakerLib - virtualX - Helpers for handling virtual X server
7

DESCRIPTION

9       This module provides a simple way to start and stop virtual X server
10       (framebuffer).
11

FUNCTIONS

13   Virtual X Server
14       Functions providing simple way how to start and stop virtual X server.
15
16       rlVirtualXStart
17
18       Start a virtual X server on a first free display. Tries only first N
19       displays, so you can run out of them.
20
21           rlVirtualXStart name
22
23       name
24           String identifying the X server.
25
26       Returns 0 when the server is started successfully.
27
28       rlVirtualXGetDisplay
29
30       Get the DISPLAY variable for specified virtual X server.
31
32           rlVirtualXGetDisplay name
33
34       name
35           String identifying the X server.
36
37       Displays the number of display where specified virtual X server is
38       running to standard output. Returns 0 on success.
39
40       rlVirtualXStop
41
42       Kill the specified X server.
43
44           rlVirtualXStop name
45
46       name
47           String identifying the X server.
48
49       Returns 0 when the server is stopped successfully.
50
51       Example
52
53       Below is a simple example of usage. Note that a lot of usefull
54       debugging information is reported on the DEBUG level, so you can run
55       your test with "DEBUG=1 make run" to get them.
56
57           rlVirtualXStart $TEST
58           rlAssert0 "Virtual X server started" $?
59           export DISPLAY="$( rlVirtualXGetDisplay $TEST )"
60           # ...your test which needs X...
61           rlVirtualXStop $TEST
62           rlAssert0 "Virtual X server killed" $?
63
64       These are "Requires" lines for your scripts - note different package
65       names for different RHEL versions:
66
67           @echo "Requires: xorg-x11-server-Xvfb" >> $(METADATA) # RHEL-5
68           @echo "Requires: xorg-x11-Xvfb"        >> $(METADATA) # RHEL-4
69           @echo "Requires: XFree86-Xvfb"         >> $(METADATA) # RHEL-3
70

AUTHORS

72       ·   Jan Hutar <jhutar@redhat.com>
73
74       ·   Petr Splichal <psplicha@redhat.com>
75
76
77
78perl v5.10.1                      2010-05-12                    VIRTUALX.SH(1)
Impressum