Sarc - Revision history

Watertoon at 20:25, 9 May 2023

2023-05-09T20:25:50Z

← Older revision		Revision as of 20:25, 9 May 2023
Line 1:		Line 1:
	Sarc is a file archive format. Files are typically accessed by a binary sorted by a hash value derived from a custom hash function. ~~See for~~ a more detailed article: https://github.com/Kinnay/Nintendo-File-Formats/wiki/SARC-File-Format		Sarc is a file archive format. Files are typically accessed by a binary sorted by a hash value derived from a custom hash function. For a more detailed article, see: https://github.com/Kinnay/Nintendo-File-Formats/wiki/SARC-File-Format

	=== Header ===		=== Header ===

Watertoon: Link Kinnay's sarc documentation.

2023-05-09T20:25:30Z

Link Kinnay's sarc documentation.

← Older revision		Revision as of 20:25, 9 May 2023
Line 1:		Line 1:
	Sarc is a file archive format. Files are typically accessed by a binary sorted by a hash value derived from a custom hash function.		Sarc is a file archive format. Files are typically accessed by a binary sorted by a hash value derived from a custom hash function. See for a more detailed article: https://github.com/Kinnay/Nintendo-File-Formats/wiki/SARC-File-Format

	=== Header ===		=== Header ===

Watertoon at 20:06, 9 May 2023

2023-05-09T20:06:55Z

← Older revision		Revision as of 20:06, 9 May 2023
Line 1:		Line 1:
	Sarc is a file archive format. Files are typically accessed by a binary sorted ~~crc32~~ hash ~~table~~.		Sarc is a file archive format. Files are typically accessed by a binary sorted by a hash value derived from a custom hash function.

	=== Header ===		=== Header ===

Watertoon: Correct hash function.

2023-05-09T19:57:50Z

Correct hash function.

← Older revision		Revision as of 19:57, 9 May 2023
Line 83:		Line 83:

	==== Sfat Entry Array ====		==== Sfat Entry Array ====
	The sfat entry array follows the sfat header (header + size of header). Array is sized by the sfat header file count, and is sorted by the ~~crc32~~ hash.		The sfat entry array follows the sfat header (header + size of header). Array is sized by the sfat header file count, and is sorted by a custom hash derived from the hash seed in the sfat header.
	{\| class="wikitable"		{\| class="wikitable"
	\|+		\|+
Line 94:		Line 94:
	\|0x4		\|0x4
	\|u32		\|u32
	\|File name ~~crc32~~ hash		\|File name hash
	\|-		\|-
	\|0x4		\|0x4

Watertoon: Correct header field.

2023-05-09T19:34:53Z

Correct header field.

← Older revision		Revision as of 19:34, 9 May 2023
Line 1:		Line 1:
	Sarc is a file archive format. Files are typically accessed by a binary sorted crc32 hash table~~. There does not appear to be an official version field, but this is fine as the format does not appear to have changed~~.		Sarc is a file archive format. Files are typically accessed by a binary sorted crc32 hash table.

	=== Header ===		=== Header ===
Line 22:		Line 22:
	\|0x2		\|0x2
	\|u16		\|u16
	\|Endianess (Always ~~0xfffe~~ in ~~big~~ endian)		\|Endianess (Always reads as 0xfeff in platform's native endian)
	\|-		\|-
	\|0x8		\|0x8
Line 38:		Line 38:
	\|u32		\|u32
	\|Alignment		\|Alignment
			\|-
			\|0x14
			\|0x2
			\|u16
			\|Version
			\|-
			\|0x16
			\|0x2
			\|u16
			\|Reserved
	\|}		\|}

Watertoon: Add category.

2023-05-09T06:55:23Z

Add category.

← Older revision		Revision as of 06:55, 9 May 2023
Line 130:		Line 130:
	\|Reserved		\|Reserved
	\|}		\|}
			[[Category:File formats]]

Watertoon: Added all of sarc.

2023-05-09T06:51:57Z

Added all of sarc.

New page

Sarc is a file archive format. Files are typically accessed by a binary sorted crc32 hash table. There does not appear to be an official version field, but this is fine as the format does not appear to have changed.

=== Header ===
{| class="wikitable"
|+
!Offset
!Size
!Type
!Description
|-
|0x0
|0x4
|u32
|Magic ("SARC" in big endian)
|-
|0x4
|0x2
|u16
|Size of header (0x14)
|-
|0x6
|0x2
|u16
|Endianess (Always 0xfffe in big endian)
|-
|0x8
|0x4
|u32
|Total file size
|-
|0xc
|0x4
|u32
|File array offset
|-
|0x10
|0x4
|u32
|Alignment
|}

=== Sfat Section ===
The sfat section follows after the sarc header (header + size of header).

==== Sfat Header ====
{| class="wikitable"
|+
!Offset
!Size
!Type
!Description
|-
|0x0
|0x4
|u32
|Magic ("SFAT" in big endian)
|-
|0x4
|0x2
|u16
|Size of header (0x14)
|-
|0x6
|0x2
|u16
|File count
|-
|0x8
|0x4
|u32
|Hash seed
|}

==== Sfat Entry Array ====
The sfat entry array follows the sfat header (header + size of header). Array is sized by the sfat header file count, and is sorted by the crc32 hash.
{| class="wikitable"
|+
!Offset
!Size
!Type
!Description
|-
|0x0
|0x4
|u32
|File name crc32 hash
|-
|0x4
|0x3
|u24
|File name offset (may be invalid)
|-
|0x7
|0x1
|u8
|Number of file hash collisions
|-
|0x8
|0x4
|u32
|File array start offset
|-
|0xc
|0x4
|u32
|File array end offset
|}

=== Sfnt Section ===
Following the sfat section is the sfnt section, a header preceding an array of file path of null-terminated strings.
{| class="wikitable"
!Offset
!Size
!Type
!Description
|-
|0x0
|0x4
|u32
|Magic ("SFAT" in big endian)
|-
|0x4
|0x2
|u16
|Size of header (0x8)
|-
|0x6
|0x2
|u16
|Reserved
|}