Editing PKG files
Jump to navigation
Jump to search
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
See also {{talk}} page | See also {{talk}} page | ||
= Firmware Packages = | |||
== File Header == | |||
All values are in big endian format. | |||
typedef struct { | |||
u32 0x00, 0x53434500// magic | |||
u32 0x04, 2 // version | |||
u16 0x08, 0 // sdk type? | |||
u16 0x0a, 3 // SCE header type; pkg | |||
u32 0x0c, 0 // meta offset | |||
u64 0x10, // size of sce_hdr + sizeof meta_hdr | |||
u64 0x18, 0x80 // + content_size_real | |||
} | |||
typedef struct | |||
// | |||
= Game Packages = | |||
All game packages are signed with the ECDSA signature. The public key for it can be found in '''download_plugin.prx''' or in '''nas_plugin.prx''' (this also applies to NPDRM SELFs). Usually game packages are signed with two signatures - one for the header and the other for the entry table. | |||
== File Header == | |||
== File Header | |||
=== Retail PS3 .pkg === | |||
*Example: Scott Pilgrim VS. The World Unlock .pkg [http://zeus.dl.playstation.net/cdn/UP0001/NPUB30162_00/bG751I62Aych0U2E7hsxD5vKS28NurYg8CmJln6oQV4LUDAfXGSOyQHE45reFxIuwD5Qjo1xnQleHqulmmx9HmjNnXX8P5O5jcXlD.pkg file]: | *Example: Scott Pilgrim VS. The World Unlock .pkg [http://zeus.dl.playstation.net/cdn/UP0001/NPUB30162_00/bG751I62Aych0U2E7hsxD5vKS28NurYg8CmJln6oQV4LUDAfXGSOyQHE45reFxIuwD5Qjo1xnQleHqulmmx9HmjNnXX8P5O5jcXlD.pkg file]: | ||
'''Offset(h) 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F''' | '''Offset(h) 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F''' | ||
Line 179: | Line 34: | ||
'''00000090''' <span style="background-color:#3f48cc; color:#FFFFFF">0C 85 45 95 A8 D4 A3 9B 62 44 68 C1 38 CE D7 63</span> .…E•ЁФЈ›bDhБ8ОЧc | '''00000090''' <span style="background-color:#3f48cc; color:#FFFFFF">0C 85 45 95 A8 D4 A3 9B 62 44 68 C1 38 CE D7 63</span> .…E•ЁФЈ›bDhБ8ОЧc | ||
'''000000A0''' <span style="background-color:#3f48cc; color:#FFFFFF">0D FF 0C C5 3A 77 C6 E6 E4 62 AD 05 F3 93 D0 7A</span> .я.Е:wЖждb..у“Рz | '''000000A0''' <span style="background-color:#3f48cc; color:#FFFFFF">0D FF 0C C5 3A 77 C6 E6 E4 62 AD 05 F3 93 D0 7A</span> .я.Е:wЖждb..у“Рz | ||
'''000000B0''' <span style="background-color:#3f48cc; color:#FFFFFF">CC 02 B4 35 2B 70 47 D6</span> <span style="background-color:#a349a4 | '''000000B0''' <span style="background-color:#3f48cc; color:#FFFFFF">CC 02 B4 35 2B 70 47 D6</span> <span style="background-color:#a349a4;">EC 61 40 39 A6 5B DC BD</span> М.ґ5+pGЦмa@9¦[ЬЅ | ||
{| class="wikitable sortable" | |||
{| class="wikitable" | |||
|- | |- | ||
| style="background-color:#515243; color:#FFFFFF;" |'''Name''' | |||
| style="background-color:#515243; color:#FFFFFF;" |'''Offset''' | |||
| style="background-color:#515243; color:#FFFFFF;" |'''Size''' | |||
| style="background-color:#515243; color:#FFFFFF;" |'''Example''' | |||
| style="background-color:#515243; color:#FFFFFF;" |'''Remark''' | |||
|- | |- | ||
| <span style="background:#ff0000;">magic || 0x00 || 0x04 || 7F 50 4B 47 || | | <span style="background:#ff0000;">magic || 0x00 || 0x04 || 7F 50 4B 47 || '.PKG' | ||
|- | |- | ||
| <span style="background-color:#008000; color:#FFFFFF;">pkg_revision || 0x04 || 0x02 || 80 00 || 80 00 for finalized | | <span style="background-color:#008000; color:#FFFFFF;">pkg_revision || 0x04 || 0x02 || 80 00 || 80 00 for retail (finalized), 00 00 for debug (non finalized) | ||
|- | |- | ||
| <span style="background-color:#3F48CC; color:#FFFFFF;">pkg_type | | <span style="background-color:#3F48CC; color:#FFFFFF;">pkg_type || 0x06 || 0x02 || 00 01 || 00 01 for ps3, 00 02 for psp | ||
|- | |- | ||
| <span style="background-color:#B5E61D;"> | | <span style="background-color:#B5E61D;">pkg_info_offset || 0x08 || 0x04 || 00 00 00 C0 || 0xC0 | ||
|- | |- | ||
| <span style="background-color:#B97A57;"> | | <span style="background-color:#B97A57;">pkg_info_count || 0x0C || 0x04 || 00 00 00 08 || Item count | ||
|- | |- | ||
| <span style="background-color:#ff7f27;"> | | <span style="background-color:#ff7f27;">header_size || 0x10 || 0x04 || 00 00 00 C0 || 0xC0 | ||
|- | |- | ||
| <span style="background-color:#fff200;">item_count | | <span style="background-color:#fff200;">item_count || 0x14 || 0x04 || 00 00 00 02 || files and folders into the encrypted data | ||
|- | |- | ||
| <span style="background-color:#7f7f7f;">total_size | | <span style="background-color:#7f7f7f;">total_size || 0x18 || 0x08 || 00 00 00 00 00 00 17 C0 || 0x17C0 - total pkg file size | ||
|- | |- | ||
| <span style="background-color:#00a2e8;">data_offset || 0x20 || 0x08 || 00 00 00 00 00 00 01 80 || 0x0180 - encrypted data offset | | <span style="background-color:#00a2e8;">data_offset || 0x20 || 0x08 || 00 00 00 00 00 00 01 80 || 0x0180 - encrypted data offset | ||
Line 209: | Line 64: | ||
| <span style="background-color:#00ff00;">data_size || 0x28 || 0x08 || 00 00 00 00 00 00 15 E0 || 0x15E0 - encrypted data size | | <span style="background-color:#00ff00;">data_size || 0x28 || 0x08 || 00 00 00 00 00 00 15 E0 || 0x15E0 - encrypted data size | ||
|- | |- | ||
| <span style="background-color:#d52bd0;">contentid || 0x30 || 0x24 || | | <span style="background-color:#d52bd0;">contentid || 0x30 || 0x24 || || 'UP0001-NPUB30162_00-SCOTTPILGRIM0002' pkg content id | ||
|- | |- | ||
| padding | | padding || 0x54 || 0x0C || 00 00 00 00 00 00 00 00 00 00 00 00 || 0x0C bytes padding | ||
|- | |- | ||
| <span style="background-color:#000000; color:#ffffff;">digest || 0x60 || 0x10 || 09 8B A2 CA 2D 30 30 1F 8B 5B 82 79 C6 70 35 F3 || sha1 from debug files and attributes together merged in one block | | <span style="background-color:#000000; color:#ffffff;">digest || 0x60 || 0x10 || 09 8B A2 CA 2D 30 30 1F 8B 5B 82 79 C6 70 35 F3 || sha1 from debug files and attributes together merged in one block | ||
|- | |- | ||
| <span style="background-color:#ed1c24;">pkg_data_riv | | <span style="background-color:#ed1c24;">pkg_data_riv || 0x70 || 0x10 || D5 FA 15 9E 7F AC 82 70 BB 3E 0C EB 97 3D 30 11 || aes-128-ctr iv. uses with gpkg_key for decrypt data | ||
|- | |||
| <span style="background-color:#808000;">header_cmac_hash || 0x80 || 0x10 || 48 0D 86 60 9F 26 8E 7F 4F B4 DA A4 33 1E 9A A1 || cmac omac hash from 0x00-0x7F, PS3 gpkg_key used as key | |||
|- | |||
| <span style="background-color:#3f48cc; color:#FFFFFF;">header_npdrm_signature || 0x90 || 0x28 || || Header NPDRM ECDSA (R_sig, S_sig) | |||
|- | |||
| <span style="background-color:#a349a4;">header_sha1_hash || 0xB8 || 0x08 || EC 61 40 39 A6 5B DC BD || last 8 bytes of sha1 hash from 0x00-0x7F | |||
|- | |- | ||
|} | |} | ||
All values are in big endian format. | |||
typedef struct { | typedef struct { | ||
u32 magic; | u32 magic; | ||
u32 pkg_type; | |||
u32 pkg_info_offset; | |||
u32 | u32 pkg_info_count; | ||
u32 | u32 header_size; | ||
u32 | |||
u32 item_count; | u32 item_count; | ||
u64 total_size; | u64 total_size; | ||
u64 data_offset; | u64 data_offset; | ||
u64 data_size; | u64 data_size; | ||
char contentid[0x30]; | |||
u8 digest[0x10]; | u8 digest[0x10]; | ||
u8 | u8 k_licensee[0x10]; | ||
} PKG_HEADER; | } PKG_HEADER; | ||
typedef struct { | typedef struct { | ||
union{ | |||
u32 packet_identifier; 0-0x12 | |||
u32 size of content; | |||
union { | |||
u32 packet_identifier; | |||
u32 | |||
{ | { | ||
content | |||
} | } | ||
} ... | } ... | ||
} PKG_INFO; | |||
} | |||
Identifier : | |||
=== | 0x00000001 = DRM Type: Count = 0/5/6/7/8/9/0xA/0xB/0xC (unknown), 1 (network), 2 (local), 3/0xD (free), 4 (PSP) | ||
0x00000002 = Category/Content Type | |||
0x00000003 = Package Type/Storage Type/ Package Flags - Upgradeable,Patch,NonGame,HDDGamePatch,DiscGamePatch,RenameDirectory,ForcedInstallTo,Finalized | |||
0x00000004 = Total Package Size | |||
0x00000005 = make_package_npdrm reversion + Package version | |||
0x00000006 = Version + App Version / TitleID (on size 0xC) | |||
0x00000007 = QA Digest | |||
0x00000008 = PS3/PSP/PSP2 System Version, Package version, App Version | |||
0x00000009 | |||
0x0000000A | |||
0x0000000B | |||
0x0000000C | |||
0x0000000D | |||
0x0000000E | |||
0x0000000F | |||
0x00000010 | |||
0x00000011 | |||
0x00000012 | |||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
! content type !! type name !! install path (on ps3) !! notes | |||
|- | |- | ||
| | |0x00000001 || || || | ||
|- | |- | ||
| | |0x00000002 || || || | ||
|- | |- | ||
| | |0x00000003 || || || | ||
|- | |- | ||
| | |0x00000004 || GameData (also Patches) || /dev_hdd0/game/ || | ||
|- | |- | ||
| | |0x00000005 || Game_Exec || /dev_hdd0/game/ || | ||
|- | |- | ||
| | |0x00000006 || PS1emu || /dev_hdd0/game/ || | ||
|- | |- | ||
| | |0x00000007 || PSP & PCEngine || /dev_hdd0/game/ || | ||
|- | |- | ||
| | |0x00000008 || || || | ||
|- | |- | ||
| | |0x00000009 || Theme || /dev_hdd0/theme || | ||
|- | |- | ||
| | |0x0000000A || Widget || /dev_hdd0/widget || | ||
|- | |- | ||
| | |0x0000000B || License || /dev_hdd0/home/<current user>/exdata || | ||
|- | |- | ||
| | |0x0000000C || VSH Module || /dev_hdd0/vsh/modules/ || | ||
|- | |- | ||
| | |0x0000000D || PSN Avatar || /dev_hdd0/home/<current user>/psn_avatar || | ||
|- | |- | ||
| | |0x0000000E || PSPgo || /dev_hdd0/game/ || Displayed as Unknown Album: Corrupted Data | ||
|- | |- | ||
| | |0x0000000F || Minis || /dev_hdd0/game/ || | ||
|- | |- | ||
| | |0x00000010 || NEOGEO || /dev_hdd0/game/ || | ||
|- | |- | ||
| | |0x00000011 || VMC || /dev_hdd0/tmp/vmc/ || | ||
|- | |- | ||
| | |0x00000012 || Seen on PS2 classic || /dev_hdd0/game/ || | ||
|- | |- | ||
| | |0x00000013 || || || | ||
|- | |- | ||
| | |0x00000014 || Seen on PSP remastered || /dev_hdd0/game/ || | ||
|- | |- | ||
| | |0x00000015 || PSVita (PSP2GD) || || | ||
|- | |- | ||
| | |0x00000016 || PSVita (PSP2AC) || || | ||
|- | |- | ||
| | |0x00000017 || PSVita (PSP2LA) || || | ||
|- | |- | ||
| | |0x00000018 || || || | ||
|- | |- | ||
| | |0x00000019 || WT (Web TV?) || /dev_hdd0/game/ || | ||
|} | |} | ||
= | === File Entry === | ||
All values are in big endian format | |||
== File | |||
= | |||
All values are in big endian format | |||
typedef struct { | typedef struct { | ||
Line 696: | Line 196: | ||
u32 flags; | u32 flags; | ||
u32 padding; | u32 padding; | ||
} | } PKG_FILE_HEADER; | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |||
! field !! offset !! type !! notes | ! field !! offset !! type !! notes | ||
|- | |- | ||
Line 709: | Line 210: | ||
| data_size || 0x10 || u64 || | | data_size || 0x10 || u64 || | ||
|- | |- | ||
| flags || 0x18 || u32 || The file type | | flags || 0x18 || u32 || The file type | ||
|- | |- | ||
| padding || 0x1C || u32 || zero | | padding || 0x1C || u32 || zero | ||
|- | |||
|} | |} | ||
== | === Misc/Note === | ||
<s> | |||
From FW 4.00, install PKG from root device (but not as "bubble") for PS1 classic if not containing [[EDAT_files|.EDAT files]] license type Free will abort or install directly as bubble according to the cfw. | |||
</s> | |||
The last | == Package Footer == | ||
The last 0x20 bytes of the package contains a hash (sha1sum) of the package (sha1 of the whole file minus the last 0x20 bytes). Or in other words... to verify the integrity of a package is needed to crop the 0x20 bytes at the end, then calculate the sha1 of the resulting file, then compare with the sha1 that was cropped | |||
Is also used as part of the package identification info inside the '''TITLE_ID-ver.xml''' files in PSN servers that lists the available game patches for each game. See: [[Online_Connections#Game_Updating_Procedure|Game Updating Procedure]] page and the '''sha1sum''' in the .xml examples | |||
*Notes | *Notes | ||
**This footer area is considered part of the package and is included when counting the '''total_size''' of the package (in the header at offset 0x18), and the header is hashed too by '''header_sha1_hash ''' (at offset 0xB8), this is important in the sequence of actions needed when | **This footer area is considered part of the package and is included when counting the '''total_size''' of the package (in the header at offset 0x18), and the header is hashed too by '''header_sha1_hash ''' (at offset 0xB8), this is important in the sequence of actions needed when buiding the package and updating/adding the sha1 footer at the end | ||
** | **Homebrew packages (at least some of them) doesnt includes this footer | ||
== Package links == | == Package links == | ||
* sqlite3 db of .pkg files (pkg links, file infos, signatures, etc): [https://mega.co.nz/#!f5QhWCTB!EzxEaMNKJ3zJ40c_qfGtZTVD3a1uis645Hffj_W3hpc pkg_harvester_db.7z 6.7 MB] (includes PS3, PSP) - uncompressed pkg_harvester.db: 24.5 MB | |||
several constants used in pkg_harvester.db: | |||
several constants used in pkg_harvester.db: | |||
<syntaxhighlight lang="c"> | <syntaxhighlight lang="c"> | ||
enum class ProductEnvironment | enum class ProductEnvironment | ||
Line 1,110: | Line 269: | ||
}; | }; | ||
</syntaxhighlight> | </syntaxhighlight> | ||
{{File Formats}}<noinclude>[[Category:Main]]</noinclude> | {{File Formats}}<noinclude>[[Category:Main]]</noinclude> |