Struct SqpkTargetInfo 

pub struct SqpkTargetInfo {
    pub platform_id: u16,
    pub region: i16,
    pub is_debug: bool,
    pub version: u16,
    pub deleted_data_size: u64,
    pub seek_count: u64,
}

SQPK T command body: declares the target platform, region, and patch statistics for all subsequent operations in a patch file.

A real FFXIV patch file begins with a T command before any write operations, so the platform declared here is in effect for all subsequent path resolution. The apply layer updates crate::apply::ApplyContext::platform from platform_id and otherwise ignores the remaining fields.

Wire format

Important: Most fields are big-endian (the struct-level #[br(big)] default), but deleted_data_size and seek_count are little-endian. This endian anomaly is present in the original C# implementation (SqpkTargetInfo.cs) and must be preserved exactly.

┌───────────────────────────────────────────────────────────────────┐
│ <reserved>        : [u8; 3]  (always zero)                        │  bytes 0–2
│ platform_id       : u16 BE   0=Win32, 1=PS3, 2=PS4               │  bytes 3–4
│ region            : i16 BE   -1=Global                            │  bytes 5–6
│ is_debug          : i16 BE   0=release, nonzero=debug             │  bytes 7–8
│ version           : u16 BE   client version                        │  bytes 9–10
│ deleted_data_size : u64 LE   ← little-endian anomaly              │  bytes 11–18
│ seek_count        : u64 LE   ← little-endian anomaly              │  bytes 19–26
│ <trailing padding>            bounded by the body slice            │
└───────────────────────────────────────────────────────────────────┘

Reference

See SqpkTargetInfo.cs in the XIVLauncher reference implementation.

Errors

Parsing returns crate::ZiPatchError::BinrwError if the body is too short to contain all required fields.

Fields

platform_id: u16

Target platform identifier.

Value	Platform	Path suffix
0	Windows / PC	win32
1	PlayStation 3	ps3
2	PlayStation 4	ps4
other	Unknown	falls back to win32

Preceded by 3 bytes of reserved/padding in the wire format. Encoded as a big-endian u16.

region: i16

Region code for the patch target.

-1 means Global (the standard international release). Other values are region-specific builds (e.g. Chinese or Korean clients). Encoded as a big-endian i16.

is_debug: bool

true when the patch targets a debug build of the game client.

Parsed from a big-endian i16: zero → false, any nonzero → true. Debug patches are not distributed through normal update channels.

version: u16

Target client version number. Informational; not used for path resolution.

Encoded as a big-endian u16.

deleted_data_size: u64

Total bytes freed (deleted) across the entire patch.

Used by patch manager UIs for progress estimation. Little-endian despite the struct-level #[br(big)] default — see the wire-format note above.

seek_count: u64

Total number of seek operations the patcher is expected to perform.

Used by patch manager UIs for progress estimation. Little-endian despite the struct-level #[br(big)] default — see the wire-format note above.

Trait Implementations

impl BinRead for SqpkTargetInfo

type Args<'__binrw_generated_args_lifetime> = ()

The type used for the args parameter of read_args() and read_options().

fn read_options<R: Read + Seek>( __binrw_generated_var_reader: &mut R, __binrw_generated_var_endian: Endian, __binrw_generated_var_arguments: Self::Args<'_>, ) -> BinResult<Self>

Read Self from the reader using the given Endian and arguments.

fn read<R>(reader: &mut R) -> Result<Self, Error>

where R: Read + Seek, Self: ReadEndian, Self::Args<'a>: for<'a> Required,

Read Self from the reader using default arguments.

fn read_be<R>(reader: &mut R) -> Result<Self, Error>

where R: Read + Seek, Self::Args<'a>: for<'a> Required,

Read Self from the reader using default arguments and assuming big-endian byte order.

fn read_le<R>(reader: &mut R) -> Result<Self, Error>

where R: Read + Seek, Self::Args<'a>: for<'a> Required,

Read Self from the reader using default arguments and assuming little-endian byte order.

fn read_ne<R>(reader: &mut R) -> Result<Self, Error>

where R: Read + Seek, Self::Args<'a>: for<'a> Required,

Read T from the reader assuming native-endian byte order.

fn read_args<R>(reader: &mut R, args: Self::Args<'_>) -> Result<Self, Error>

where R: Read + Seek, Self: ReadEndian,

Read Self from the reader using the given arguments.

fn read_be_args<R>(reader: &mut R, args: Self::Args<'_>) -> Result<Self, Error>

where R: Read + Seek,

Read Self from the reader, assuming big-endian byte order, using the given arguments.

fn read_le_args<R>(reader: &mut R, args: Self::Args<'_>) -> Result<Self, Error>

where R: Read + Seek,

Read Self from the reader, assuming little-endian byte order, using the given arguments.

fn read_ne_args<R>(reader: &mut R, args: Self::Args<'_>) -> Result<Self, Error>

where R: Read + Seek,

Read T from the reader, assuming native-endian byte order, using the given arguments.

impl Clone for SqpkTargetInfo

fn clone(&self) -> SqpkTargetInfo

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SqpkTargetInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for SqpkTargetInfo

fn eq(&self, other: &SqpkTargetInfo) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl ReadEndian for SqpkTargetInfo

const ENDIAN: EndianKind

The endianness of the type.

impl Eq for SqpkTargetInfo

impl StructuralPartialEq for SqpkTargetInfo