Quality/TestSuite/X11 Test Specification

Contents 1 Introduction 2 Test Coverage 2.1 Software Coverage 2.2 Hardware Coverage 2.3 Limitations 2.4 Future Improvements 3 Running the tests 3.1 Test case arguments 4 Module Design and Architecture 4.1 Architecture diagram 5 References 6 Change History

Introduction

The X Window System (commonly X or X11) is a computer software system and network protocol that provides a graphical user interface (GUI). Base X Window System is extended by X Extension libraries (mainly from freedesktop.org and XFree86 projects).

The blts-x11 test driver includes functional tests for X11 using xlib, and for various X Extensions using their user space libraries

Test Coverage

The test driver currently covers basic functionalities of X11 and it's extensions, including:

• X11 presence check
• Enumerating and checking needed X Extensions
• Basic window creation operations and drawing
• XComposite: Rendering to off-screen buffer
• XDamage: Creating and monitoring 'damage' regions
• XInput: Accessing (listing) available input devices
• XRender: Simple drawing
• XRandR: Dynamically change X screen (rotation/orientation)
• XRecord: Recording X protocol events (such as mouse movement)
• XTest: Generating input device events (for example generating mouse movement events)
• XVideo: Overlay video output

Software Coverage

Current coverage for X11 tests:

Hardware Coverage

Mainly display devices (and GPU).

Limitations

TBD

Future Improvements

Extend functional coverage of existing test and create performance tests for XVideo, XComposite and DRI2.

Running the tests

To run the X11 test cases use: $ blts_x11_test

Test case arguments

Arguments:

Switch	Function
-l	Used log file, default blts_x11.txt
-e	Execute single or multiple selected tests, for example -e 1,4,5.
-en	Execute test by name, for example -en "My test X"
-s	Show list of all tests
-?	Help message
-nc	Do not output log to terminal
-t	Maximum execution time of each test in seconds (default: 10s)

Module Design and Architecture

The test module can be compiled to both a self-sufficient command line program and a Min test framework module. Debian packaging is provided.

Architecture diagram

References

X11	X11 home page
freedesktop.org	freedesktop.org home page
XFree86	XFree86 home page

Change History

Version	Date	Handled By	Status	Comments
0.1	22-sep-2010	Iekku Huttunen	Draft	Page created