The Linux Foundation

 
Xts5SourceBuildInstructions

From The Linux Foundation

Back to TestGroup

Contents

lsb-test-xts5 Source Build Instructions

This document has instructions on how to build the source for the lsb-test-xts5. (written based on a build on a Mandriva system, some variations expected on different distros)

Assumptions

  • bzr is installed, 0.13 or better
  • build tools are installed (make, gcc, X devel libraries/headers: -lXaw -lXmu -lXtst -lXext -lXt -lX11)
  • lsb dynamic linker is in place (/%_lib/ld-lsb-%_arch.so.3)
  • rpm-build is installed
  • TET environment variables are set (in ~/.bash_profile or similar):
export TET_ROOT=/opt/lsb-tet3-lite
export PATH=$PATH:$TET_ROOT/bin
export MANPATH=$MANPATH:$TET_ROOT/man
export PYTHONPATH=$TET_ROOT/lib/python
  • my 'pwd' is ~/LSB-work/doc-test
  • all build work is done as a "normal" user, not root
  • Distribution pre-requisites for running LSB tests are installed (package lsb-test on Mandriva)

Building Steps

Checkout a branch from Bazaar-NG

An initial branch will take some minutes to complete:

bzr branch http://bzr.freestandards.org/lsb/3.1/xts5-test xts5-test

or if you have an existing branch:

cd xts5-test
bzr pull

Build the tarball

The Makefile accepts the environment variable BZRTREES to pull from your local branch to build the tarball, rather than the remote branch.

cd xts5-test/package
BZRTREES=/home/stew/LSB-work/doc-test make tarball

You should find something like this at the end of the build:

lsb-test-xts5-5.1.5.tar.gz
xts5-5.1.5.tar.gz

The first tarball are the LSB parts, the 2nd is pulled from upstream at cvs.freedesktop.org.

Build the rpm packages

make rpm_package

You should find something like this at the end of the build:

lsb-test-xts5-5.1.5-3.lsb3.src.rpm
lsb-test-xts5-5.1.5-3.lsb3.x86_64.rpm

The tarball and package steps could of course be combined with a plain "make". I only broke them up for ease of troubleshooting.

BZTREES=/home/stew/LSB-work/doc-test make

Install and test the binary package

This is covered in more detail in Executing the lsb-xts5 Test Suite, but you can quickly test your package with (urpmi is Mandriva specific, use whatever package manager your distro provides). The test run will take some minutes to complete.

sudo urpmi lsb-test-xts5-5.1.5-3.lsb3.x86_64.rpm
su -
cd /opt/lsb/test/lsb-xts5; ./run_xts5.sh

Typical results:

tjreport xts5/results/0002e/journal 
Test was run: 20061230 12:20:34 

(big snip here...)

Total Tests Passed: 5847
Total Tests Failed (including waived): 128
Total Tests Failed (excluding waived): 128

Only six of the above were FAIL, 122 were UNRESOLVED. A review of the journal shows many as terminating with a signal 13.

Troubleshooting Build Problems

If you find issues in following the above procedure, please feel free to fix it or add notes in this area.


[Article] [Discussion] [View source] [History]