0ab5e64ac0
* ChangeLog.1, ChangeLog.CVS, Makefile.am, NEWS, README: * README-hacking, directory, doc/Makefile.am, doc/dumpdir.texi: * doc/gendocs_template, doc/intern.texi, doc/mastermenu.el: * doc/snapshot.texi, doc/sparse.texi, doc/tar-snapshot-edit.texi: * doc/value.texi, lib/Makefile.am, scripts/backup-specs: * scripts/dump-remind.in, scripts/tar-snapshot-edit, scripts/tarcat: * scripts/xsparse.c, src/arith.h, src/buffer.c, src/compare.c: * src/create.c, src/delete.c, src/exit.c, src/suffix.c, src/tar.c: * src/tar.h, src/update.c, src/warning.c, src/xheader.c: * tests/append01.at, tests/append02.at, tests/atlocal.in: * tests/delete03.at, tests/exclude.at, tests/exclude06.at: * tests/extrac04.at, tests/extrac05.at, tests/extrac06.at: * tests/extrac07.at, tests/filerem01.at, tests/filerem02.at: * tests/incr01.at, tests/incr02.at, tests/incr03.at, tests/incr06.at: * tests/label02.at, tests/label03.at, tests/label04.at: * tests/label05.at, tests/link02.at, tests/link03.at: * tests/listed01.at, tests/listed02.at, tests/long01.at: * tests/longv7.at, tests/multiv01.at, tests/multiv02.at: * tests/multiv03.at, tests/multiv05.at, tests/multiv06.at: * tests/multiv07.at, tests/multiv08.at, tests/options.at: * tests/options02.at, tests/remfiles03.at, tests/rename01.at: * tests/rename02.at, tests/rename03.at, tests/rename04.at: * tests/rename05.at, tests/same-order01.at, tests/same-order02.at: * tests/shortfile.at, tests/shortupd.at, tests/sparse01.at: * tests/sparse02.at, tests/sparsemv.at, tests/sparsemvp.at: * tests/star/README, tests/star/gtarfail2.at: * tests/star/multi-fail.at: * tests/star/pax-big-10g.at, tests/star/quicktest.sh: * tests/star/ustar-big-2g.at, tests/star/ustar-big-8g.at: * tests/update01.at, tests/update02.at, tests/volsize.at: * tests/volume.at: Remove trailing spaces and tabs from lines, and remove trailing empty lines from files. This makes it a bit easier to share code among coreutils and other projects that do this.
This directory contains scripts for testing GNU tar using star "test archives". The archives themselves can be obtained from ftp://ftp.berlios.de/pub/star/testscripts. These tests are disabled by default. There are two ways to run them. The simplest is by `make check-full' command. It requires wget and GNU md5sum to be installed. If you don't have these utilities, download the test archives manually and set the environment variable STAR_TESTSCRIPTS to point to the directory where they reside, for example: make STAR_TESTSCRIPTS=testdir check or make TESTS_ENVIRONMENT='STAR_TESTSCRIPTS=testdir' check The file `quicktest.sh' is a separate test. It is never executed within `make check' command, you will need to run it manually. Please, carefully read section `quicktest.sh' below before running it. Following is a short description of the tests: * gtarfail.at and gtarfail2.at These tests require gtarfile.tar and gtarfile2.tar, respectively. These files are POSIX compliant tar archives that were not accepted by previous versions of GNU tar. * multi-fail.at Requires gnu-multi-fail-volume1.gtar and gnu-multi-fail-volume2.gtar. These are two parts of a multi-volume archive that previous versions of tar refused to read (at least, without -B option). * ustar-big-2g.at Requires ustar-big-2g.tar.bz2. It is a tar archive containing a file with the largest size that a historic tar implementation is able to understand. * ustar-big-8g.at Requires ustar-big-8g.tar.bz2. This is a test for reading an archive containing files with the largest size that may be used with ustar (POSIX.1-1990) format. * pax-big-10g.at Requires pax-big-10g.tar.bz2. It tests handling pax (POSIX.1-2001) archves containing very large files (in this case -- 10 GB). * quicktest.sh This is a test for compliance to POSIX.1-1990 tar specification. It requires two files: ustar-all-quicktest.tar and quicktest.filelist, (they usually reside in star/testscripts directory), and `tartest' program (also part of star distribution). The test must be run only with root privileges, so it is a good idea to verify the contents of ustar-all-quicktest.tar before running it. If `tartest' is not in your PATH, use TARTEST variable to specify its full file name. You may pass both STAR_TESTSCRIPTS and TARTEST variables as command line arguments to quicktest.sh, as shown in the example below: ./quicktest.sh STAR_TESTSCRIPTS=testdir TARTEST=/path/to/tartest Local variables: mode: outline paragraph-separate: "[ ]*$" end: