blob: 8631c937b4df39989510141805a95f3bb81f9cd3 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
# Bzip2 Test Files
> **Purpose**: Test file collection for bzip2 validation
> **Latest Version**: 0.0.5-1
---
## Overview
A collection of `.bz2` files used to test bzip2 functionality. Files come from various projects and cover edge cases.
---
## Directory Contents
Each test directory contains:
| File Type | Description |
|-----------|-------------|
| `README` | Source and license information |
| `*.bz2` | Compressed files (should work) |
| `*.md5` | Hash of original file |
| `*.bz2.bad` | Corrupt files (should fail) |
---
## File Types
### Good Files (`.bz2`)
Compressed files that should decompress correctly. Each has an `.md5` file for verification.
### Bad Files (`.bz2.bad`)
Deliberately corrupt files to test error handling. These should **not** decompress successfully.
---
## Verification
### Generate MD5
```bash
md5sum < file > file.md5
```
### Verify MD5
```bash
md5sum --check file.md5 < file
```
---
## Adding Test Files
### Good Files
1. Create the `.bz2` file
2. Generate `.md5`: `md5sum < original > original.md5`
3. Add to appropriate directory
4. Update README with source
### Bad Files
1. Create corrupt `.bz2` file
2. Name with `.bz2.bad` extension
3. Document the corruption type
---
## ⚠️ Security Notice
> **Vulnerability Reporting**
>
> If you find a file that causes crashes, buffer overflows, or security issues:
>
> 1. **Do NOT share publicly**
> 2. Report confidentially to maintainers
> 3. Allow 60-90 days for fix before disclosure
---
## Credits
Test files contributed by:
- Apache Commons Compress
- DotNetZip Library
- Go Lang project
- lbzip2 project
- pyflate project
Thanks to Mark Wielaard for assembling the collection.
---
## Related Documentation
- [Bzip2 Overview](./bzip2.md) — Main documentation
- [Bzip2 Tests](./bzip2-tests.md) — Test suite
- [Compiling](./bzip2-compiling.md) — Build instructions
|
