Title metadata: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
|||
Line 1: | Line 1: | ||
'''Title metadata''' is a format used to store information about a title (a single standalone game, channel, etc.) and all its installed contents, including which contents they consist of and their SHA1 hashes. | |||
Many operations are done in terms of 64-byte blocks, which means you will often see padding out to the nearest 64-byte boundary at the end of a field. | |||
= | == Structure == | ||
== | === Header === | ||
=== | {| class="wikitable" | ||
|- style="background-color: #ddd;" | |||
! Start | |||
! Length | |||
! Description | |||
|- | |||
| 0x000 | |||
| 4 | |||
| Signature type | |||
|- | |||
| 0x004 | |||
| 256 | |||
| Signature | |||
|- | |||
| 0x104 | |||
| 60 | |||
| Padding modulo 64 | |||
|- | |||
| 0x140 | |||
| 64 | |||
| Issuer | |||
|- | |||
| 0x180 | |||
| 1 | |||
| Version | |||
|- | |||
| 0x181 | |||
| 1 | |||
| ca_crl_version | |||
|- | |||
| 0x182 | |||
| 1 | |||
| signer_crl_version | |||
|- | |||
| 0x183 | |||
| 1 | |||
| Padding modulo 64 | |||
|- | |||
| 0x184 | |||
| 8 | |||
| System Version | |||
|- | |||
| 0x18C | |||
| 8 | |||
| Title ID | |||
|- | |||
| 0x194 | |||
| 4 | |||
| Title type | |||
|- | |||
| 0x198 | |||
| 2 | |||
| Group ID | |||
|- | |||
| 0x19A | |||
| 62 | |||
| reserved | |||
|- | |||
| 0x1D8 | |||
| 4 | |||
| Access rights | |||
|- | |||
| 0x1DC | |||
| 2 | |||
| Title version | |||
|- | |||
| 0x1DE | |||
| 2 | |||
| Number of contents (nbr_cont) | |||
|- | |||
| 0x1E0 | |||
| 2 | |||
| boot index | |||
|- | |||
| 0x1E2 | |||
| 2 | |||
| Padding modulo 64 | |||
|- | |||
| 0x1E4 | |||
| 36*nbr_cont | |||
| Contents | |||
|} | |||
=== Content === | |||
{| class="wikitable" | |||
|- | |||
! Start | |||
! Length | |||
! Description | |||
|- | |||
| 0x00 | |||
| 4 | |||
| Content ID | |||
|- | |||
| 0x04 | |||
| 2 | |||
| Index | |||
|- | |||
| 0x06 | |||
| 2 | |||
| Type | |||
|- | |||
| 0x08 | |||
| 8 | |||
| Size | |||
|- | |||
| 0x10 | |||
| 20 | |||
| SHA1 hash | |||
|} | |||
=== Certificates === | |||
{| class="wikitable" | |||
|- | |||
! Start | |||
! Length | |||
! Description | |||
|- | |||
| 0x000 | |||
| 4 | |||
| Signature type | |||
|- | |||
| 0x004 | |||
| 256 | |||
| Signature | |||
|- | |||
| 0x104 | |||
| 32 | |||
| Issuer | |||
|- | |||
| 0x124 | |||
| 4 | |||
| Tag | |||
|- | |||
| 0x128 | |||
| 64 | |||
| Name | |||
|- | |||
| 0x168 | |||
| | |||
| Key | |||
|} | |||
[ | == Example code application == | ||
<source lang="c"> | |||
typedef unsigned char u8; | |||
typedef unsigned short u16; | |||
typedef unsigned int u32; | |||
/* On a 32bit system, long is only 4 bytes- use long long instead */ | |||
typedef unsigned long u64; | |||
</source> | |||
<source lang="c"> | |||
typedef struct { | |||
u32 cid; // content id | |||
u16 index; // # number of the file | |||
u16 type; | |||
u64 size; | |||
u8 hash [20]; // SHA1 hash content | |||
} content_record; // size: 0x24 bytes | |||
</source> | |||
<source lang="c"> | |||
enum sig_type { | |||
RSA_2048 = 0x00010001, | |||
RSA_4096 = 0x00010000 | |||
}; | |||
</source> | |||
<source lang="c"> | |||
typedef struct { | |||
u32 sig_type; | |||
u8 sig[256]; | |||
u8 fill1[60]; | |||
u8 issuer[64]; // Root-CA%08x-CP%08x | |||
u8 version; | |||
u8 ca_crl_version; | |||
u8 signer_crl_version; | |||
u8 fill2; | |||
u64 sys_version; | |||
u64 title_id; | |||
u32 title_type; | |||
u16 group_id; // publisher | |||
u8 reserved[62]; | |||
u32 access_rights; | |||
u16 title_version; | |||
u16 num_contents; | |||
u16 boot_index; | |||
u16 fill3; | |||
content_record contents[num_contents]; | |||
} tmd; | |||
</source> | |||
The tmd is then followed by a chain of certificates, where each certificate is of the general form | |||
<source lang="c"> | |||
u32 sig_type; // | |||
u8 sig[256]; // 256 for RSA_2048, 512 for RSA_4096 | |||
u8 issuer[32]; | |||
u32 tag; // identifies what is being signed | |||
u8 name[64]; // name of thing being signed | |||
u8 key[...]; | |||
</source> |
Revision as of 18:30, 5 March 2009
Title metadata is a format used to store information about a title (a single standalone game, channel, etc.) and all its installed contents, including which contents they consist of and their SHA1 hashes.
Many operations are done in terms of 64-byte blocks, which means you will often see padding out to the nearest 64-byte boundary at the end of a field.
Structure
Header
Start | Length | Description |
---|---|---|
0x000 | 4 | Signature type |
0x004 | 256 | Signature |
0x104 | 60 | Padding modulo 64 |
0x140 | 64 | Issuer |
0x180 | 1 | Version |
0x181 | 1 | ca_crl_version |
0x182 | 1 | signer_crl_version |
0x183 | 1 | Padding modulo 64 |
0x184 | 8 | System Version |
0x18C | 8 | Title ID |
0x194 | 4 | Title type |
0x198 | 2 | Group ID |
0x19A | 62 | reserved |
0x1D8 | 4 | Access rights |
0x1DC | 2 | Title version |
0x1DE | 2 | Number of contents (nbr_cont) |
0x1E0 | 2 | boot index |
0x1E2 | 2 | Padding modulo 64 |
0x1E4 | 36*nbr_cont | Contents |
Content
Start | Length | Description |
---|---|---|
0x00 | 4 | Content ID |
0x04 | 2 | Index |
0x06 | 2 | Type |
0x08 | 8 | Size |
0x10 | 20 | SHA1 hash |
Certificates
Start | Length | Description |
---|---|---|
0x000 | 4 | Signature type |
0x004 | 256 | Signature |
0x104 | 32 | Issuer |
0x124 | 4 | Tag |
0x128 | 64 | Name |
0x168 | Key |
Example code application
typedef unsigned char u8;
typedef unsigned short u16;
typedef unsigned int u32;
/* On a 32bit system, long is only 4 bytes- use long long instead */
typedef unsigned long u64;
typedef struct {
u32 cid; // content id
u16 index; // # number of the file
u16 type;
u64 size;
u8 hash [20]; // SHA1 hash content
} content_record; // size: 0x24 bytes
enum sig_type {
RSA_2048 = 0x00010001,
RSA_4096 = 0x00010000
};
typedef struct {
u32 sig_type;
u8 sig[256];
u8 fill1[60];
u8 issuer[64]; // Root-CA%08x-CP%08x
u8 version;
u8 ca_crl_version;
u8 signer_crl_version;
u8 fill2;
u64 sys_version;
u64 title_id;
u32 title_type;
u16 group_id; // publisher
u8 reserved[62];
u32 access_rights;
u16 title_version;
u16 num_contents;
u16 boot_index;
u16 fill3;
content_record contents[num_contents];
} tmd;
The tmd is then followed by a chain of certificates, where each certificate is of the general form
u32 sig_type; //
u8 sig[256]; // 256 for RSA_2048, 512 for RSA_4096
u8 issuer[32];
u32 tag; // identifies what is being signed
u8 name[64]; // name of thing being signed
u8 key[...];