README: ABAT (Automated Basic Acceptance Test) for Intel Linux Graphics Driver
==============================================================================

Copyright (C) 2006, Intel Corporation.
Author: nian.wu@intel.com, gordon.jin@intel.com


1) Introduction
===============

These test cases perform an automated basic acceptance test on Intel Linux
graphics driver. It tests that the basic functionality of kernel modules,
2D driver and 3D driver exist, and direct rendering is enabled.

It is usually used as the first step of a full testing, and get to know the
status of the driver quality quickly.

2) Usage
========

It's simple: just execute "abat.sh", which will call other test cases.

The test takes couple of seconds, and prints some log info during running.

It will report number of PASS/FAIL/SKIP after running.


3) Prerequisite
===============

The test uses some tools (glxinfo, glxgears, xdpyinfo, xvinfo) which
shipped with xorg in usual case. Please make sure they are available, otherwise
those cases will be skipped.

If you have multiple Xorg on the system, and want to test the non-default Xorg,
you can specify it by export XORG_DIR variable.

4) Test case description
========================

It consists of 8 cases:

  <1> ldd_check.sh: check whether the correct dynamic linking libraries are in
use. This will be helpful if multiple Xorgs installed on the system;

  <2> x_start.sh: start X for test and check the log info. If X has already
been started, we just check the log info.

  <3> module_check.sh: check whether required kernel modules (agpgart,
intel_agp, drm, and i915) have been loaded;

  <4> glxinfo_check.sh: check whether glxinfo runs successfully, and direct
rendering is enabled.

  <5> xorg_ext_check.sh: check Xorg extension support: XVideo, VidMod.

  <6> glxgears_check.sh: check whether glxgears can run.

  <7> adaptor_check.sh: check whether Intel video adaptor reported.

  <8> x_close.sh: close X, if the X is started by x_start.sh.

5) Feedback
===========

Mail your ABAT result to ilg@linux.intel.com, along with information on
hardware model and chipset. We will maintain the result on:
http://intellinuxgraphics.org/testing.html

Any question, bug or suggestion, please report to nian.wu@intel.com.