From b2e6da302476d47e22fc3edea618f5867bac3f5e Mon Sep 17 00:00:00 2001 From: Nigel Tao Date: Tue, 29 Sep 2026 22:31:20 +1000 Subject: [PATCH] lib/suitar: allow implicitly-sized entries --- doc/spec/suitar-spec.md | 116 +++++++++---- lib/suitar/suitar.go | 184 ++++++++++++++++++--- lib/suitar/suitar_test.go | 108 +++++++++++- test/data/various-peacocks.dense.suitar | Bin 0 -> 14848 bytes test/data/various-peacocks.implicit.suitar | Bin 0 -> 16896 bytes 5 files changed, 350 insertions(+), 58 deletions(-) create mode 100644 test/data/various-peacocks.dense.suitar create mode 100644 test/data/various-peacocks.implicit.suitar diff --git a/doc/spec/suitar-spec.md b/doc/spec/suitar-spec.md index 1af3bae4..e714e69c 100644 --- a/doc/spec/suitar-spec.md +++ b/doc/spec/suitar-spec.md @@ -14,8 +14,9 @@ archive containing 1 file) as [Farbfeld](https://tools.suckless.org/farbfeld/) or [NIE](./nie-spec.md) is to image files: an uncompressed, "designed for Unix pipes" format that is trivial to read or write in a few hundred lines of code, ideally in a memory-safe programming language. It's a format for what the -Chromium web browser's "Rule of 2" security advice calls -[https://chromium.googlesource.com/chromium/src/+/master/docs/security/rule-of-2.md#normalization](Normalization). +Chromium web browser's +[https://chromium.googlesource.com/chromium/src/+/master/docs/security/rule-of-2.md](Rule of 2) +security advice calls Normalization. ## Subset of TAR @@ -37,7 +38,7 @@ destination FS / OS) may choose to reject them. For example, answering "are these two file names duplicates (and does the destination FS / OS accept or reject duplicates)?" may depend on the -_destination_ FS / OS's case-sensitivity and Unicode Normalization +_destination_ FS / OS's case-sensitivity and Unicode normalization configuration (and whether case folding and normalization elides DICPs, Unicode Default-Ignorable Code Points), not the _source_ SUITAR archive per se. @@ -51,9 +52,9 @@ Compared to plain TAR (and refer to [the GNU TAR manual](https://ftp.gnu.org/old-gnu/Manuals/tar-1.12/html_node/tar_123.html)), SUITAR has further restrictions: -- Entries are either regular files (`REGTYPE`), sparse files (`GNUTYPE_SPARSE`) - or directories (`DIRTYPE`). There is no support for hard links, symlinks, - device files or other non-standard files. +- Entries are either regular files (`REGTYPE` or `AREGTYPE`), sparse files + (`GNUTYPE_SPARSE`) or directories (`DIRTYPE`). There is no support for hard + links, symlinks, device files or other non-standard files. - Sparse files must be completely sparse. Their content must be one contiguous span of NUL (zero) bytes that covers the entire file. - File and directory names must obey the "File Name Validity" rules, below. @@ -73,16 +74,6 @@ There is no support for various TAR variants, such as "the PAX extensions to TAR" or "the USTAR extensions to TAR", other than what's implied by the subset of the GNU extensions that SUITAR explicitly uses. -Encoders have no meaningful choices, bar one exception. There is only one valid -SUITAR encoding (unlike full TAR's backwards-compatible choice between base-8 -or base-256 encoding of various sufficiently small numbers) for any given file -or directory entry (its combination of type, name, size, mode, modTime and -contents). - -The one exception is that, if a file's contents are all NUL bytes (including -zero-sized files), an encoder can choose between a `REGTYPE` regular file (with -explicit NULs) or a `GNUTYPE_SPARSE` sparse file (with implicit NULs). - ### File Name Validity @@ -118,12 +109,70 @@ number of 512-byte blocks: - 1 `GNUTYPE_LONGNAME` header block. - 1 or more payload blocks containing the file or directory name. -- 1 `REGTYPE`, `GNUTYPE_SPARSE` or `DIRTYPE` header block. +- 1 `REGTYPE`, `AREGTYPE`, `GNUTYPE_SPARSE` or `DIRTYPE` header block. - If `REGTYPE`, 0 or more payload blocks containing the file contents. -- If not `REGTYPE`, no further blocks. +- If `AREGTYPE`, see "Implicitly-Sized Files" below. +- If neither `REGTYPE` or `AREGTYPE`, no further blocks. -### Header Blocks +## Implicitly-Sized Files + +For TAR itself, each entry's contents is preceded by the entry's header that +states the entire contents' size in bytes. SUITAR keeps that formal structure +but also uses additional convention to represent entries whose size is only +known at the end, not the start, of the entry. + +For example, when decompressing `foobar.dat.gz` from a GZIP stream to SUITAR +(an archive with one entry: `foobar.dat`), the uncompressed `foobar.dat` size +is not known until the end of the GZIP-formatted input stream is reached. + +For historical reasons, TAR itself has two typeflag codes for regular files +(`REGTYPE` and `AREGTYPE`) and both codes are largely equivalent. SUITAR, by +convention, treats them differently: `REGTYPE` is for the common case, where +the contents' size is known up-front, and `AREGTYPE` means the contents that +follow are partial and to be continued. + +An implicitly-sized file is partitioned into 2 or more chunks. The final chunk +is `REGTYPE` and all other chunks are `AREGTYPE`. Each chunk's size is explicit +(and zero is a valid size) but the number of chunks isn't known until the final +`REGTYPE` chunk is delivered. The entry's structure is: + +- 1 `GNUTYPE_LONGNAME` header block. +- 1 or more payload blocks containing the file or directory name. +- 1 or more non-final chunks, each being: + - 1 `AREGTYPE` header block, stating the chunk contents' size. + - 0 or more payload blocks containing the chunk contents. +- 1 final chunk, being: + - 1 `REGTYPE` header block, stating the chunk contents' size. + - 0 or more payload blocks containing the chunk contents. + +"0 non-final chunks" is actually valid in some sense, equivalent to an +explicitly-sized `REGTYPE` entry (of exactly one chunk). + +The file name still comes from the `GNUTYPE_LONGNAME` payload. There is only +one `GNUTYPE_LONGNAME` header block, not one per chunk. + +Other metadata (mode and modTime, but not file size) comes from the initial +chunk's header block. For non-initial chunks, the mode must be `"644"` and the +modTime must be zero. + + +### Implicitly-Sized Fallback Behavior + +Other TAR-reading tools and libraries, which do not understand SUITAR's +"implicitly-sized files" convention, will fall back to treating all non-initial +chunks as separate regular files. These will all have the same file name +(`"\x13sUItAR"`, due to the SUITAR magic signature), which does not satisfy the +File Name Validity rules, but this fallback name will not be presented by +decoders that understand the convention. + +SUITAR encoders are discouraged from using this implicitly-sized files +convention unless the surrounding context ensures that the decoders also speak +SUITAR, not just TAR per se. This can be more likely if writing SUITAR over a +Unix pipe (with a known program on the other end), compared to writing to disk. + + +## Header Blocks Like all blocks, each header block is 512 bytes long. Each header block also starts with a 12-byte magic signature (that is not valid UTF-8), identifying @@ -165,6 +214,7 @@ These `?` bytes are the 3-byte mode (`"644"` or `"755"`), physical size or modTime as an 8-byte big-endian `uint64`, 6-byte checksum (see below) or 1-byte type, which must be one of: +- `'\x00'` for `AREGTYPE`. - `'0'` for `REGTYPE`. - `'5'` for `DIRTYPE`, in which case mode must be `"755"` and physical size must be all zeroes. @@ -190,17 +240,20 @@ template (and `?` again indicates an 8-byte big-endian `uint64`): ### Header Checksum -A 512-byte header block's checksum value is simply the sum of each byte (after -converting from `uint8` to `uint32`, to avoid overflow) in the block, at -offsets in the two half-open ranges `0 .. 148` and `156 .. 512`, which excludes -the 8 bytes for the 6-byte checksum itself plus another two hard-coded bytes -`"\x00\x20"`. +A 512-byte header block's checksum value is simply 256 plus the sum of each +byte (after converting from `uint8` to `uint32`, to avoid overflow) in the +block, at offsets in the two half-open ranges `0 .. 148` and `156 .. 512`, +which excludes the 8 bytes for the 6-byte checksum itself plus another two +hard-coded bytes `"\x00\x20"`. + +That "256 plus" is equivalent to summing over the entire `0 .. 512` range if +valuing the 8 checksum bytes in the range `148 .. 156` as being `'\x20'`. That checksum value is written as a 6-byte ASCII octal number in the header. For example, `4853` (decimal) would be encoded as `"011365"` (octal). -### Payload Blocks +## Payload Blocks Each entry has one or more payload blocks, between its two header blocks, containing the file or directory name. The name length (including a trailing @@ -210,10 +263,13 @@ must range within `1 .. 4095`. Rounding up that including-a-trailing-NUL length to a multiple of 512 gives the number of 512-byte payload blocks that contain the name. All padding bytes in the name's final payload block must be NUL. -For `REGTYPE` entries, the second header block's physical size value gives the -reconstructed file's size and rounding that up to a multiple of 512 gives the -number of 512-byte payload blocks that contain the file contents. Again, all -padding bytes in the contents' final payload block must be NUL. +For `REGTYPE` or `AREGTYPE` entries, the name payload is followed by one or +more chunks. Concatenating the chunks' contents reconstructs the file. Only the +final chunk is `REGTYPE` and all others are `AREGTYPE`. Each chunk has one +header block and zero or more payload blocks. The header block's physical size +value gives the chunk's size and rounding that up to a multiple of 512 gives +the number of 512-byte payload blocks that contain the chunk contents. Again, +all padding bytes in the contents' final payload block must be NUL. For other entries (`DIRTYPE` or `GNUTYPE_SPARSE`), there are no further payload blocks after the second header block. @@ -222,7 +278,7 @@ For `GNUTYPE_SPARSE` entries, the second header block's logical size value gives the reconstructed file's size and its contents are all NUL bytes. -# Reference Implementation +## Reference Implementation The [google/wuffs](https://github.com/google/wuffs) repository, which holds this specification document, also holds a diff --git a/lib/suitar/suitar.go b/lib/suitar/suitar.go index 9ad3dda6..75826399 100644 --- a/lib/suitar/suitar.go +++ b/lib/suitar/suitar.go @@ -38,6 +38,7 @@ var ( errClosed = errors.New("suitar: closed") errHeaderSize = errors.New("suitar: inconsistent Header.Size and Write length") errHeaderTypeflag = errors.New("suitar: inconsistent Header.Typeflag for Write") + errImplicitSize = errors.New("suitar: implicit size is too large") errWriteANonNul = errors.New("suitar: Write a non-NUL byte to a sparse entry") ) @@ -96,6 +97,7 @@ const ( TypeGNUSparse = 'S' // Sparse file (its contents are all NUL bytes). typeGNULongName = 'L' + typeRegA = '\x00' ) // Valid values for Header.Mode. The zero value is invalid. @@ -104,6 +106,15 @@ const ( Mode755 = int64(0o755) // "rwxr-xr-x" mode bits, also known as permission bits. ) +// SizeIsImplicit can be passed in the Writer.WriteHeader's argument's +// Header.Size field to mean that the contents' size-in-bytes is not yet known, +// but is implied by the total length of the []byte passed to Writer.Write, up +// until the next call to Writer.WriteHeader or Writer.Close. +// +// When reading, the actual size is returned by Reader.NumBytesRead. Call this +// after Reader.Read has returned io.EOF and before the next Reader.Next call. +const SizeIsImplicit = int64(-1) + // IsValidHeaderName returns whether name is a valid Header.Name field value. func IsValidHeaderName(name string) bool { return (len(name) < 4096) && @@ -248,7 +259,8 @@ type Header struct { // - Typeflag must be one of three values (TypeReg, TypeDir, TypeGNUSparse). // In particular, it cannot be zero. // - Name must satisfy IsValidHeaderName. -// - Size must be non-negative. It must be 0 if Typeflag is TypeDir. +// - Size must be non-negative or, if Typeflag is TypeReg, it can also be -1, +// the value of SizeIsImplicit. It must be 0 if Typeflag is TypeDir. // - Mode must be one of two values (Mode644, Mode755). It must be Mode755 if // Typeflag is TypeDir. // - ModTime.Unix() must be a non-negative int64. In particular, ModTime must @@ -275,9 +287,14 @@ func (h *Header) Valid() bool { } } + size := h.Size + if (size == -1) && (h.Typeflag == TypeReg) { + size = 0 + } + const maxExcl = 1 << 53 m := h.ModTime.Unix() - return (0 <= h.Size) && (h.Size < maxExcl) && + return (0 <= size) && (size < maxExcl) && (0 <= m) && (m < maxExcl) && IsValidHeaderName(h.Name) } @@ -292,7 +309,7 @@ type Writer struct { err error w io.Writer header Header - remaining int64 + remaining int64 // If negative, ^remaining is the accumulated implicit size. bIndex int32 block block nameBuf [4096]byte @@ -301,9 +318,29 @@ type Writer struct { func (w *Writer) flush() error { if w.err != nil { return w.err + + } else if w.remaining < 0 { + initBlock(&w.block, TypeReg, int64(w.bIndex), Mode644, 0) + if _, err := w.w.Write(w.block[:]); err != nil { + w.err = err + return w.err + } + + if w.bIndex != 0 { + end := (w.bIndex + 511) &^ 511 + clear(w.nameBuf[w.bIndex:end]) + if _, err := w.w.Write(w.nameBuf[:end]); err != nil { + w.err = err + return w.err + } + w.bIndex = 0 + } + return nil + } else if (w.remaining != 0) && (w.header.Typeflag != TypeGNUSparse) { w.err = errHeaderSize return w.err + } else if w.bIndex != 0 { clear(w.block[w.bIndex:]) if _, err := w.w.Write(w.block[:]); err != nil { @@ -378,6 +415,9 @@ func initBlock(b *block, typeflag byte, size int64, mode int64, modTime int64) { physicalSize := size if typeflag == TypeGNUSparse { physicalSize = 0 + } else if size < 0 { + physicalSize = 0 + typeflag = typeRegA } setI64(b, 0x07C, physicalSize) @@ -411,13 +451,15 @@ func (w *Writer) Write(b []byte) (int, error) { return 0, w.err } - tooMuch := int64(len(b)) > w.remaining + tooMuch := (int64(len(b)) > w.remaining) && (w.remaining >= 0) if tooMuch { b = b[:w.remaining] } ret := 0 - if w.header.Typeflag == TypeReg { + if w.remaining < 0 { + ret, w.err = w.writeImplicitlySized(b) + } else if w.header.Typeflag == TypeReg { ret, w.err = w.writeReg(b) } else if w.header.Typeflag == TypeGNUSparse { ret, w.err = w.writeSparse(b) @@ -434,6 +476,62 @@ func (w *Writer) Write(b []byte) (int, error) { return ret, w.err } +func (w *Writer) writeImplicitlySized(b []byte) (int, error) { + if len(b) == 0 { + return 0, nil + } + + const maxExcl = 1 << 53 + if n := int64(len(b)); (n >= maxExcl) || ((n + ^w.remaining) >= maxExcl) { + return 0, errImplicitSize + } + + if (w.bIndex > 0) || (len(b) < (len(w.nameBuf) - int(w.bIndex))) { + n := copy(w.nameBuf[w.bIndex:], b) + w.bIndex += int32(n) + b = b[n:] + if len(b) == 0 { + return n, nil + } + } + + ret := 0 + + split := len(b) &^ 511 + prefix, suffix := b[:split], b[split:] + + if size := int64(w.bIndex) + int64(len(prefix)); size > 0 { + initBlock(&w.block, typeRegA, size, Mode644, 0) + if _, err := w.w.Write(w.block[:]); err != nil { + return ret, err + } + } + + if w.bIndex > 0 { + n, err := w.w.Write(w.nameBuf[:w.bIndex]) + ret += n + if err != nil { + return ret, err + } + w.bIndex = 0 + } + + if len(prefix) > 0 { + n, err := w.w.Write(prefix) + ret += n + if err != nil { + return ret, err + } + } + + if len(suffix) > 0 { + w.bIndex = int32(copy(w.nameBuf[:], suffix)) + ret += len(suffix) + } + + return ret, nil +} + func (w *Writer) writeReg(b []byte) (int, error) { if len(b) == 0 { return 0, nil @@ -508,18 +606,21 @@ func NewReader(r io.Reader) *Reader { // Reader provides sequential reading of a SUITAR archive. type Reader struct { - err error - r io.Reader - remaining int64 - numPadding int32 - sparse bool - block block - nameBuf [4096]byte + err error + r io.Reader + remaining int64 + numBytesRead int64 + numPadding int32 + sparse bool + sizeIsImplicit bool + block block + nameBuf [4096]byte } // Next advances to the next entry in the SUITAR archive, preparing to read the // file's contents (as r is also an io.Reader). func (r *Reader) Next() (Header, error) { + r.numBytesRead = 0 if r.err != nil { return Header{}, r.err } else if r.remaining > 0 { @@ -532,7 +633,7 @@ func (r *Reader) Next() (Header, error) { if _, err := readFullNoEOF(r.r, r.block[:]); err != nil { r.err = err return Header{}, r.err - } else if r.block[0x09C] == 0 { + } else if r.block[0] == 0 { // SUITAR ends with 2 blocks (1024 bytes) of zeroes. if !isAllZeroes(r.block[:]) { r.err = errBadHeader @@ -579,6 +680,11 @@ func (r *Reader) Next() (Header, error) { r.remaining = size r.numPadding = int32(roundUp512(uint64(size)) - uint64(size)) r.sparse = typeflag == TypeGNUSparse + r.sizeIsImplicit = typeflag == typeRegA + if r.sizeIsImplicit { + typeflag = TypeReg + size = SizeIsImplicit + } return Header{ Typeflag: typeflag, @@ -611,7 +717,7 @@ func parseBlock1(b *block) (byte, int64, int64, int64, error) { } typeflag := b[0x09C] - if (typeflag != TypeReg) && (typeflag != TypeDir) && (typeflag != TypeGNUSparse) { + if (typeflag != TypeReg) && (typeflag != TypeDir) && (typeflag != TypeGNUSparse) && (typeflag != typeRegA) { return 0, 0, 0, 0, errBadHeader } @@ -649,15 +755,45 @@ func parseBlock1(b *block) (byte, int64, int64, int64, error) { // Read satisfies io.Reader. func (r *Reader) Read(b []byte) (int, error) { + n, err := r.read(b) + r.numBytesRead += int64(n) + return n, err +} + +func (r *Reader) read(b []byte) (int, error) { if r.err != nil { return 0, r.err - } else if r.remaining == 0 { - return 0, io.EOF - } else if len(b) == 0 { - return 0, nil + } + + for r.remaining == 0 { + if !r.sizeIsImplicit { + return 0, io.EOF + } + if _, err := readFullNoEOF(r.r, r.block[:0x200]); err != nil { + r.err = err + return 0, err + } + typeflag, size, mode, modTime, err := parseBlock1(&r.block) + if err != nil { + r.err = err + return 0, err + } else if ((typeflag != TypeReg) && (typeflag != typeRegA)) || (mode != Mode644) || (modTime != 0) { + r.err = errBadHeader + return 0, err + } else if (r.numBytesRead + size) >= (1 << 53) { + r.err = errImplicitSize + return 0, err + } + r.remaining = size + r.numPadding = int32(roundUp512(uint64(size)) - uint64(size)) + r.sizeIsImplicit = typeflag == typeRegA } b = b[:int(min(r.remaining, int64(len(b))))] + if len(b) == 0 { + return 0, nil + } + if r.sparse { n := len(b) clear(b) @@ -688,7 +824,11 @@ func (r *Reader) Read(b []byte) (int, error) { r.numPadding = 0 } if (err == nil) || (err == io.EOF) { - return n, io.EOF + if r.sizeIsImplicit { + return n, nil + } else { + return n, io.EOF + } } } else if err == io.EOF { @@ -698,3 +838,9 @@ func (r *Reader) Read(b []byte) (int, error) { r.err = err return n, r.err } + +// NumBytesRead returns the number of bytes read by all previous Reader.Read +// calls. The counter resets to zero on each Reader.Next call. +func (r *Reader) NumBytesRead() int64 { + return r.numBytesRead +} diff --git a/lib/suitar/suitar_test.go b/lib/suitar/suitar_test.go index d3d4513b..c6eade72 100644 --- a/lib/suitar/suitar_test.go +++ b/lib/suitar/suitar_test.go @@ -17,6 +17,7 @@ import ( "fmt" "hash/crc32" "io" + "math/rand" "os" "reflect" "testing" @@ -32,8 +33,12 @@ func (c *crcWriter) Write(b []byte) (int, error) { return len(b), nil } -func testWriter(tt *testing.T, sparse bool) { - f, err := os.Open("../../test/data/archive.tar") +func testWriter(tt *testing.T, sparse bool, implicit bool) { + srcFilename := "../../test/data/archive.tar" + if implicit { + srcFilename = "../../test/data/various-peacocks.dense.suitar" + } + f, err := os.Open(srcFilename) if err != nil { tt.Fatalf("os.Open: %v", err) } @@ -51,10 +56,15 @@ func testWriter(tt *testing.T, sparse bool) { tt.Fatalf("Next: %v", err) } + size := tHeader.Size + if implicit { + size = SizeIsImplicit + } + sHeader := &Header{ Typeflag: tHeader.Typeflag, Name: tHeader.Name, - Size: tHeader.Size, + Size: size, Mode: tHeader.Mode, ModTime: tHeader.ModTime, } @@ -79,11 +89,11 @@ func testWriter(tt *testing.T, sparse bool) { } got := buf.Bytes() - wantFilename := "../../test/data/archive" + wantFilename := "../../test/data/archive.dense.suitar" if sparse { - wantFilename += ".sparse.suitar" - } else { - wantFilename += ".dense.suitar" + wantFilename = "../../test/data/archive.sparse.suitar" + } else if implicit { + wantFilename = "../../test/data/various-peacocks.implicit.suitar" } want, err := os.ReadFile(wantFilename) if err != nil { @@ -181,8 +191,9 @@ func testReader(tt *testing.T, sparse bool, ignore bool) { } } -func TestWriterDense(tt *testing.T) { testWriter(tt, false) } -func TestWriterSparse(tt *testing.T) { testWriter(tt, true) } +func TestWriterDense(tt *testing.T) { testWriter(tt, false, false) } +func TestWriterSparse(tt *testing.T) { testWriter(tt, true, false) } +func TestWriterImplicit(tt *testing.T) { testWriter(tt, false, true) } func TestReaderDenseCheck(tt *testing.T) { testReader(tt, false, false) } func TestReaderDenseIgnore(tt *testing.T) { testReader(tt, false, true) } func TestReaderSparseCheck(tt *testing.T) { testReader(tt, true, false) } @@ -424,3 +435,82 @@ func testWriteTooMuch(tt *testing.T, typeflag byte) { func TestWriteTooMuchRegular(tt *testing.T) { testWriteTooMuch(tt, TypeReg) } func TestWriteTooMuchSparse(tt *testing.T) { testWriteTooMuch(tt, TypeGNUSparse) } + +func TestSizeIsImplicit(tt *testing.T) { + pi, err := os.ReadFile("../../test/data/pi.txt") + if err != nil { + tt.Fatalf("ReadFile: %v", err) + } + + writeSizes := []int{ + 1, 2, 3, 4, + 10, 20, 50, 100, + 250, 251, 252, 253, + 254, 255, 256, 257, + 401, 402, 403, 404, + 510, 511, 512, 513, + 1024, 1234, 4094, 4095, + 4096, 4097, 4098, -1, + } + + totalSizes := []int(nil) + + buf := bytes.Buffer{} + sWriter := NewWriter(&buf) + + rng := rand.New(rand.NewSource(0)) + for i := range 100 { + if err := sWriter.WriteHeader(&Header{ + Typeflag: TypeReg, + Name: fmt.Sprintf("%03d.dat", i), + Size: SizeIsImplicit, + Mode: Mode644, + ModTime: time.Unix(0, 0), + }); err != nil { + tt.Fatalf("WriteHeader: %v", err) + } + totalSize := 0 + + for range 20 { + writeSize := min(writeSizes[rng.Intn(len(writeSizes))], len(pi)-totalSize) + if writeSize <= 0 { + break + } + if _, err := sWriter.Write(pi[totalSize : totalSize+writeSize]); err != nil { + tt.Fatalf("Write: %v", err) + } + totalSize += writeSize + } + + totalSizes = append(totalSizes, totalSize) + } + + if err := sWriter.Close(); err != nil { + tt.Fatalf("Close: %v", err) + } + + sReader := NewReader(&buf) + for i, totalSize := range totalSizes { + sHeader, err := sReader.Next() + if err == io.EOF { + break + } else if err != nil { + tt.Fatalf("Next: %v", err) + } else if sHeader.Size != SizeIsImplicit { + tt.Fatalf("sHeader.Size: got %d, want %d", sHeader.Size, SizeIsImplicit) + } else if want := fmt.Sprintf("%03d.dat", i); sHeader.Name != want { + tt.Fatalf("sHeader.Name: got %q, want %q", sHeader.Name, want) + } + + got, err := io.ReadAll(sReader) + if err != nil { + tt.Fatalf("ReadAll: %v", err) + } else if len(got) != totalSize { + tt.Fatalf("bytes read: got %d, want %d", len(got), totalSize) + } else if !bytes.Equal(got, pi[:totalSize]) { + tt.Fatalf("bytes read: contents differ") + } else if n := sReader.NumBytesRead(); n != int64(totalSize) { + tt.Fatalf("NumBytesRead: got %d, want %d", n, totalSize) + } + } +} diff --git a/test/data/various-peacocks.dense.suitar b/test/data/various-peacocks.dense.suitar new file mode 100644 index 0000000000000000000000000000000000000000..7f3af1cf6a87168189f246f29c6d2ccc419d82ba GIT binary patch literal 14848 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 QMCGUzqaiRF0#pwH05V!>-~a#s literal 0 HcmV?d00001 diff --git a/test/data/various-peacocks.implicit.suitar b/test/data/various-peacocks.implicit.suitar new file mode 100644 index 0000000000000000000000000000000000000000..a9bcd87ec1eb70f560cad23d77fd54e029f68818 GIT binary patch literal 16896 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