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
  11 The following is a short description of the tests:
  12
  13 * gtarfail.sh and gtarfile2.tar
  14
  15 Need gtarfile.tar and gtarfile2.tar, respectively. These are POSIX
  16 compliant tar files that were not accepted by previous versions of
  17 GNU tar.
  18
  19 * ustar-big-2g.sh
  20
  21 Needs ustar-big-2g.tar.bz2. It is a tar archive containing a file with
  22 the largest size that a historic tar implementation is able to understand.
  23
  24 * ustar-big-8g.sh
  25
  26 Needs ustar-big-8g.tar.bz2. This is a test for reading an archive containing
  27 files with the largest size that may be used with ustar (POSIX.1-1990)
  28 format.
  29
  30 * pax-big-10g.sh
  31
  32 Needs pax-big-10g.tar.bz2. It tests handling pax (POSIX.1-2001) archves
  33 containing very large files (in this case -- 1 GB).
  34
  35 * qucktest.sh
  36
  37 A test for compliance to POSIX.1-1990 tar specification. Needs
  38 the files ustar-all-quicktest.tar and quicktest.filelist. Apart
  39 from them, the `tartest' program from 'star' package is needed.
  40 This test may be run only with root privileges, so it is a good
  41 idea to test the contents of ustar-all-quicktest.tar before running
  42 it.
  43
  44 \f
  45 Local variables:
  46 mode: outline
  47 paragraph-separate: "[  \f]*$"
  48 end: