Dogcows Code - chaz/tar/blob - tests/star/README

   1 This directory contains scripts for testing GNU tar using
   2 star "test archives". The archives themselves may be obtained
   3 from http://download.berlios.de/pub/star/testscripts.
   4
   5 The tests are ignored unless environment variable STAR_TESTSCRIPTS
   6 is set and points to the directory where the test archives reside.
   7 Sample usage:
   8
   9         make STAR_TESTSCRIPTS=testdir check
  10 or
  11         make TESTS_ENVIRONMENT='STAR_TESTSCRIPTS=testdir' check
  12
  13 Following is a short description of the tests:
  14
  15 * gtarfail.sh and gtarfile2.tar
  16
  17 These tests require gtarfile.tar and gtarfile2.tar, respectively.
  18 These files are POSIX compliant tar archives that were not accepted
  19 by previous versions of GNU tar.
  20
  21 * multi-fail.sh
  22
  23 Requires gnu-multi-fail-volume1.gtar and gnu-multi-fail-volume2.gtar.
  24 These are two parts of a multi-volume archive that previous versions
  25 of tar refused to read (at least, without -B option).
  26
  27 * ustar-big-2g.sh
  28
  29 Requires ustar-big-2g.tar.bz2. It is a tar archive containing a file with
  30 the largest size that a historic tar implementation is able to understand.
  31
  32 * ustar-big-8g.sh
  33
  34 Requires ustar-big-8g.tar.bz2. This is a test for reading an archive containing
  35 files with the largest size that may be used with ustar (POSIX.1-1990)
  36 format.
  37
  38 * pax-big-10g.sh
  39
  40 Requires pax-big-10g.tar.bz2. It tests handling pax (POSIX.1-2001) archves
  41 containing very large files (in this case -- 10 GB).
  42
  43 * qucktest.sh
  44
  45 A test for compliance to POSIX.1-1990 tar specification. It requires
  46 the files ustar-all-quicktest.tar and quicktest.filelist. Apart
  47 from them, the `tartest' program from 'star' package is needed.
  48 The test may be run only with root privileges, so it is a good
  49 idea to test the contents of ustar-all-quicktest.tar before running
  50 it.
  51
  52 \f
  53 Local variables:
  54 mode: outline
  55 paragraph-separate: "[  \f]*$"
  56 end: