]> Dogcows Code - chaz/tar/blobdiff - tests/star/README
tar: fix 1.23 Solaris regression related to PRIV_SYS_LINKDIR
[chaz/tar] / tests / star / README
index 8e1b231dcaad2b754fafad2367d5320cf71c3bd5..2b96aa6bb132bf88ac9c2491386a778c631dd688 100644 (file)
@@ -1,20 +1,23 @@
 This directory contains scripts for testing GNU tar using
 star "test archives". The archives themselves can be obtained
 This directory contains scripts for testing GNU tar using
 star "test archives". The archives themselves can be obtained
-from http://download.berlios.de/pub/star/testscripts.
+from ftp://ftp.berlios.de/pub/star/testscripts.
 
 
-The tests are ignored unless environment variable STAR_TESTSCRIPTS
-is set and points to the directory where the test archives reside.
-Sample usage:
+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
 
        make STAR_TESTSCRIPTS=testdir check
-or     
+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.
        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
 Following is a short description of the tests:
 
 * gtarfail.at and gtarfail2.at
@@ -27,7 +30,7 @@ by previous versions of GNU tar.
 
 Requires gnu-multi-fail-volume1.gtar and gnu-multi-fail-volume2.gtar.
 These are two parts of a multi-volume archive that previous versions
 
 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). 
+of tar refused to read (at least, without -B option).
 
 * ustar-big-2g.at
 
 
 * ustar-big-2g.at
 
@@ -49,9 +52,9 @@ containing very large files (in this case -- 10 GB).
 
 This is a test for compliance to POSIX.1-1990 tar specification. It
 requires two files: ustar-all-quicktest.tar and quicktest.filelist,
 
 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/tartest directory), and `tartest' program
+(they usually reside in star/testscripts directory), and `tartest' program
 (also part of star distribution). The test must be run only with root
 (also part of star distribution). The test must be run only with root
-privileges, so it is a good idea to test contents of
+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
 ustar-all-quicktest.tar before running it.
 
 If `tartest' is not in your PATH, use TARTEST variable to specify its
This page took 0.022864 seconds and 4 git commands to generate.