X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=tests%2Fstar%2FREADME;h=a2fd0ae9d7819f8205ef65b2abdc337428bc0600;hb=cd2c8d4fbb5720cdb29c88c347d57d5188ffe898;hp=fefae5f6a244488c55f4bfa0b28776a442ea4c01;hpb=176557a004d8c479b0eecf3af4cd0d1bf10afe1d;p=chaz%2Ftar diff --git a/tests/star/README b/tests/star/README index fefae5f..a2fd0ae 100644 --- a/tests/star/README +++ b/tests/star/README @@ -7,37 +7,45 @@ is set and points to the directory where the test archives reside. Sample usage: make STAR_TESTSCRIPTS=testdir check +or + make TESTS_ENVIRONMENT='STAR_TESTSCRIPTS=testdir' check -The following is a short description of the tests: +Following is a short description of the tests: * gtarfail.sh and gtarfile2.tar -Need gtarfile.tar and gtarfile2.tar, respectively. These are POSIX -compliant tar files that were not accepted by previous versions of -GNU tar. +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.sh + +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.sh -Needs ustar-big-2g.tar.bz2. It is a tar archive containing a file with +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.sh -Needs ustar-big-8g.tar.bz2. This is a test for reading an archive containing +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.sh -Needs pax-big-10g.tar.bz2. It tests handling pax (POSIX.1-2001) archves -containing very large files (in this case -- 1 GB). +Requires pax-big-10g.tar.bz2. It tests handling pax (POSIX.1-2001) archves +containing very large files (in this case -- 10 GB). * qucktest.sh -A test for compliance to POSIX.1-1990 tar specification. Needs +A test for compliance to POSIX.1-1990 tar specification. It requires the files ustar-all-quicktest.tar and quicktest.filelist. Apart from them, the `tartest' program from 'star' package is needed. -This test may be run only with root privileges, so it is a good +The test may be run only with root privileges, so it is a good idea to test the contents of ustar-all-quicktest.tar before running it.