1 | This directory contains scripts for testing GNU tar using
|
---|
2 | star "test archives". The archives themselves can 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 | The file `quicktest.sh' is a separate test. It is never executed
|
---|
14 | within `make check' command, you will need to run it manually.
|
---|
15 | Please, carefully read section `quicktest.sh' below before running
|
---|
16 | it.
|
---|
17 |
|
---|
18 | Following is a short description of the tests:
|
---|
19 |
|
---|
20 | * gtarfail.at and gtarfail2.at
|
---|
21 |
|
---|
22 | These tests require gtarfile.tar and gtarfile2.tar, respectively.
|
---|
23 | These files are POSIX compliant tar archives that were not accepted
|
---|
24 | by previous versions of GNU tar.
|
---|
25 |
|
---|
26 | * multi-fail.at
|
---|
27 |
|
---|
28 | Requires gnu-multi-fail-volume1.gtar and gnu-multi-fail-volume2.gtar.
|
---|
29 | These are two parts of a multi-volume archive that previous versions
|
---|
30 | of tar refused to read (at least, without -B option).
|
---|
31 |
|
---|
32 | * ustar-big-2g.at
|
---|
33 |
|
---|
34 | Requires ustar-big-2g.tar.bz2. It is a tar archive containing a file with
|
---|
35 | the largest size that a historic tar implementation is able to understand.
|
---|
36 |
|
---|
37 | * ustar-big-8g.at
|
---|
38 |
|
---|
39 | Requires ustar-big-8g.tar.bz2. This is a test for reading an archive containing
|
---|
40 | files with the largest size that may be used with ustar (POSIX.1-1990)
|
---|
41 | format.
|
---|
42 |
|
---|
43 | * pax-big-10g.at
|
---|
44 |
|
---|
45 | Requires pax-big-10g.tar.bz2. It tests handling pax (POSIX.1-2001) archves
|
---|
46 | containing very large files (in this case -- 10 GB).
|
---|
47 |
|
---|
48 | * quicktest.sh
|
---|
49 |
|
---|
50 | This is a test for compliance to POSIX.1-1990 tar specification. It
|
---|
51 | requires two files: ustar-all-quicktest.tar and quicktest.filelist,
|
---|
52 | (they usually reside in star/tartest directory), and `tartest' program
|
---|
53 | (also part of star distribution). The test must be run only with root
|
---|
54 | privileges, so it is a good idea to test contents of
|
---|
55 | ustar-all-quicktest.tar before running it.
|
---|
56 |
|
---|
57 | If `tartest' is not in your PATH, use TARTEST variable to specify its
|
---|
58 | full file name. You may pass both STAR_TESTSCRIPTS and TARTEST
|
---|
59 | variables as command line arguments to quicktest.sh, as shown in
|
---|
60 | the example below:
|
---|
61 |
|
---|
62 | ./quicktest.sh STAR_TESTSCRIPTS=testdir TARTEST=/path/to/tartest
|
---|
63 |
|
---|
64 | |
---|
65 |
|
---|
66 | Local variables:
|
---|
67 | mode: outline
|
---|
68 | paragraph-separate: "[ |
---|
69 | ]*$"
|
---|
70 | end:
|
---|