
********************************************************************************
* WARNING!                                                                     *
*                                                                              *
* This tool may run as the root user!                                          *
* Therefore it can do pretty much harm if it gets out of control.              *
* We have tried to make the script reasonably safe but there is no warranty.   *
* Use it at YOUR OWN RISK only, and only if you know what you are doing.       *
*                                                                              *
* PLEASE DO NOT RUN IT AS ROOT ON A MACHINE THAT HOLDS IMPORTANT DATA,         *
* OR PROVIDES IMPORTANT SERVICES!                                              *
********************************************************************************

---=< Prerequisites >=---

For running the script, you need to install the following tools:

* Perl
* lsb_release (should be always present for a LSB compliant distro)
* rpm2cpio converter
* standard Unix tools (grep, diff, etc.)

---=< Usage >=---

To start working with this tool using web-UI, run the following script from the
installation directory:
# ./bin/lsb-atk-start.pl [port]
It will launch a simple web-server, and then try to open the start page in 
a browser. The optional parameter 'port' allows to specify which port should be
used by the server. By default 8889 is taken.

Use the script ./bin/lsb-atk-stop.pl if you want to shutdown the server.

If the scripts are installed into /opt/lsb/app-testkit/manager, you will need
to enter the root password to start or stop the server.

You can also work with the test via a command-line interface. Run
# /opt/lsb/bin/lsbappchk -h
# /opt/lsb/bin/lsbpkgchk -h
or
# ./bin/lsbappchk -h
# ./bin/lsbpkgchk -h
(depending on your installation method) for a detailed list of options and
their meanings. In this case the HTML report is not generated automatically.

---=< Bug reporting >=---

If you find a bug, or wish to advise a possible enhancement, please
send an e-mail to ISP RAS <linux@ispras.ru>.

---=< Credits >=---

Copyright (C) 2007 The Linux Foundation.

This program has been developed by ISP RAS <linux@ispras.ru> for LF.
