xref: /freebsd/sys/contrib/openzfs/tests/zfs-tests/tests/functional/zstream/test-stream-creation-scripts/README (revision d0b3ecdc274930e190ea233b6b69ff03782eaf8d)
1The scripts in this directory were used to generate most of the static
2test streams used by the zstream test suite. They're not really
3intended to be run again and are here more as documentation than as
4code.
5
6Some of the python scripts use the 'lorem' pip module, so you need to
7run the make-venv.sh to set up before running them. The venv is created
8in /tmp and the scripts hard-code that path for python.
9
10The "all-drr-types" streams have to be generated in two pieces because
11of the way redaction works. A *base* stream and an *incr* stream
12collectively include every possible type of record, but neither
13substream is complete on its own.
14
15Many test streams are big-endian, so given hardware's convergence on
16little-endian order, you will probably need to create big-endian
17streams under emulation with, e.g., QEMU. As of mid-2026, the easiest
18target for big-endian emulation is an IBM s390x CPU, which is supported
19by both QEMU and Ubuntu.
20