Writer Flags

Control flags that alter writing behavior and fallback logic.

Defines

	Name
	MPTAR_CTX_ALLOW_PAX_FOR_OCTAL Context flag to prefer PAX extended headers over base-256 binary encoding for large octal fields.

Macros Documentation

define MPTAR_CTX_ALLOW_PAX_FOR_OCTAL

#define MPTAR_CTX_ALLOW_PAX_FOR_OCTAL (1U << 0)

Context flag to prefer PAX extended headers over base-256 binary encoding for large octal fields.

Note: When an archive field value exceeds standard USTAR octal capacity, mptar normally encodes it using a base-256 binary representation (setting the high-order bit via MPTAR_OCTAL_BINARY_FLAG).

If this flag is set, PAX extended headers are emitted alongside binary encoding whenever binary encoding is available. Setting this flag does not prevent binary encoding from being used; rather, it allows PAX entries to be included in addition to it.

If binary encoding is not possible because the value is too large to fit in a 64-bit integer (exceeds MPTAR_INT64_MAX), a PAX entry is included automatically regardless of whether this flag is set. By default, this flag is unset, meaning PAX records are omitted when binary encoding can be used.

---

Updated on 2026-07-23 at 20:07:34 +0000