Editing LIC.DAT

Jump to navigation Jump to search
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

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:
== Description ==
=Description=
*Checked within Level 2 Kernel and possible via lv2syscall476
Location: /dev_bdvd/PS3_GAME/LICDIR/LIC.DAT (soon LIC.EDAT)
*File size is always 0x10000 Bytes.
*Paths
**dev_bdvd/'''PS3_GAME'''/LICDIR/'''LIC.DAT'''
**dev_bdvd/'''PS3_GM01'''/LICDIR/'''LIC.DAT'''
**dev_bdvd/'''PS3_GM02'''/LICDIR/'''LIC.DAT'''
**etc...


== Example ==
Checked within Level 2 Kernel and possible via lv2syscall476<br>
{{Boxcode|float=left|width=auto|height=auto|title=Example: Dead or Alive 5|code=
00000000 50 53 33 4C 49 43 44 41 00 00 00 01 80 00 00 00 PS3LICDA........
00000010 00 00 09 00 00 00 08 00 00 00 01 00 00 00 00 01 ................
00000020 8C D3 A9 D8 00 00 00 00 00 00 00 00 00 00 00 00 ................
...
00000800 01 42 4C 45 53 30 31 36 32 33 00 00 00 00 00 00 .BLES01623......
...
}}


== Structure ==
Final File size is: 0x10000 Bytes
{|class="wikitable"
 
! Offset !! Length!! Description
See also {{talk}} page
|-
 
| 0x0 || ~0x200 || Header
= example =
|-
 
| ~0x200 || 0x600 || Padding
00000000 50 53 33 4C 49 43 44 41 00 00 00 01 80 00 00 00 PS3LICDA........
|-
00000010 00 00 09 00 00 00 08 00 00 00 01 00 00 00 00 01 ................
| 0x800 || ''Varies'' || License Table
00000020 8C D3 A9 D8 00 00 00 00 00 00 00 00 00 00 00 00 ................
|-
...
| ''Varies'' || up to 0x10000 || Padding
00000800 01 42 4C 45 53 30 31 36 32 33 00 00 00 00 00 00 .BLES01623......
|}
...
 
= structure =
The structure is dependant of how the file is generated in PC and processed by the PS3
 
Generation - The file is created in 2 steps, the file generated in first step contains the header (with a crc32 filled with zeroes intended as a placeholder) and the licenses table, in second step is calculated the crc32 of the file and is added in the header, and filled with zeroes at the end up to 0x10000


The structure is a consequence of how the file is generated in PC and validated by the PS3.
Processing - PS3 first reads the file LIC.DAT (header + licenses table, not included the padding at end), then it makes a copy of it (because is needed to edit it)... then it reads the crc32 area from the header and stores it separatedlly, then it fills the crc32 area with zeroes... and finally... it calculates the crc32 of the edited file


*CRC32 generation (in PC)
The CRC32 hash stored in the final LIC.DAT file.... is the hash of the file generated in step 1 (with the crc32 area on the header filled with zeroes) and a total size smaller than  0x10000 (because doesnt have the padding added at the end of step 2) <!-- yes, thats weird -->
<!--previous steps of how is generated the file could be longer to explain and not so easy to deduce-->
**A temporal file<!--or debug LIC.DAT for master disc?--> is created composed by: ''header'' + ''license table''. The crc32 value stored at header offset 0x20 is filled with zeroes and works as a placeholder
**Now is calculated the crc32 of the temporal file
**The crc32 calculated in previous step is stored at header offset 0x20 replacing the zeroes placeholder
**A padding is added after the '''lic_table_end''' offset to increase the final size of LIC.DAT up to 0x10000


*CRC32 validation (in PS3)
== header ==
**LIC.DAT is readed from disc, and copyed to a different location excluding the padding at the end of the file (cropped from first byte of file up to '''lic_table_end''' offset)
**The crc32 value stored at header offset 0x20 is replaced by zeroes
**Now is calculated the crc32 of the edited file
**The crc32 calculated in previous step is validated against the crc32 value stored at header offset 0x20 of the original LIC.DAT


=== Header ===
{|class="wikitable"
{|class="wikitable"
|-
! Offset !! Length !! Example !! Name !! Description
! Offset !! Length !! Example !! Name !! Description
|-
|-
| 0x0 || 0x8 || 'PS3LICDA' || '''magic''' || LIC.DAT identifyer
| 0x0 || 0x8 || 'PS3LICDA' || Magic || LIC.DAT identifyer
|-
| 0x8 || 0x4 || 0x00000001 || '''version''' || DAT structure version
|-
|-
| 0xC || 0x4 || 0x80000000 || '''flag''' || 0x80000000 = '''Retail''' (used in LIC.DAT under directory PS3_GAME)<br>0x00000000 = '''Debug''' (used in LIC.DAT under directory PS3_GM01, PS3_GM02, etc...)
| 0x8 || 0x4 || 0x1 || Version || DAT structure version
|-
|-
| 0x10 || 0x4 || 0x00000900 || '''lic_table_end''' || License table absolute end offset. Calculated by: '''lic_table_start + (lic_num * lic_size)'''
| 0xC || 0x4 || 0x80000000 || License type ? || 0x00000000 = debug<!--master disc?--><br>0x80000000 = retail
|-
|-
| 0x14 || 0x4 || 0x00000800 || '''lic_table_start''' || License table absolute start offset. Always found 0x800 (static)
| 0x10 || 0x4 || 0x00000900 || License table, absolute end offset || Calculated by: ''license table start + (license amounts * license size)'')
|-
|-
| 0x18 || 0x4 || 0x00000100 || '''lic_size''' || The '''size of a license entry''' inside the license table. Always found 0x100 (static)
| 0x14 || 0x4 || 0x00000800 || License table, absolute start offset || Always found 0x800 (static)
|-
|-
| 0x1C || 0x4 || 0x00000001 || '''lic_num''' || The '''number of licenses entries''' inside the license table.<br>0x1 = Single boot disc<br>0x2 = Dual boot disc<br>0x3 = Triple boot disc<br>Etc...
| 0x18 || 0x4 || 0x00000100 || License size || Always found 0x100 (static)
|-
|-
| 0x20 || 0x4 || 0x8CD3A9D8 || '''crc32''' || CRC32 of an area starting form absolute offset '''0x0 up to the lic_table_end''' (including the CRC32 placeholder filled with zeroes)
| 0x1C || 0x4 || 0x00000001 || License amount || Values found: 0x1 (standard discs), 0x2 (dual boot discs), 0x3 (triple boot discs)
|-
|-
| 0x24 || ? || 0x0000... || '''padding''' || The header length is unknown, probablly is aligned to 0x200 but there are lot of zeroes up to 0x800
| 0x20 || 0x4 || 0xD8A9D38C|| crc32 || CRC32 from the first byte of LIC.DAT till the end of license table (using a CRC32 value filled with zeroes in the header)
|}
|}


=== License table ===
==License table==
Composed by one or more license entries.
Composed by one or more licenses entries
 
=== License entry ===


==== License entry ====
{|class="wikitable"
{|class="wikitable"
|-
|-
! Relative Offset !! Length !! Example !! Name !! Description
! Relative Offset !! Length !! Example !! Name !! Description
|-
|-
| 0x0 || 0x1 || 0x1 || '''id_type''' || 0x01 = [[Productcode|Title ID]]<br>0x02 = [[SKU ID]]<br>0x03 = [[Content ID]]
| 0x0 || 0x1 || 0x1 || ID type || 0x01 = [[Productcode|Title ID]]<br>0x02 = [[SKU ID]]<br>0x03 = [[Content ID]]
|-
| 0x1 || 0x0A (if '''id_type''' = 0x01)<br>0x2A (if '''id_type''' = 0x02)<br>0x25 (if '''id_type''' = 0x03) || 'BLES01623' || '''id''' || Bootable content identifyer (EBOOT.BIN related)
|-
|-
| 0x0B (if '''id_type''' = 0x01)<br>0x2B (if '''id_type''' = 0x02)<br>0x26 (if '''id_type''' = 0x03) || up to 0x100 || 0x0000.... || '''padding''' || padding to fill the entry with zeroes up to the '''lic_size''' specifyed in the header
| 0x1 || ''varies'' || BLES01623 || ID ||  
|}
|}


Explanation:
The first byte indicates type and size of following text:
The first byte indicates type and size of following text:
* 0x01 means 0xA bytes, a regular TitleID (ex. BLES01623) with \0 terminating  
* 0x01 means 0xA bytes, a regular TitleID (ex. BLES01623) with \0 terminating  
Line 90: Line 68:
* 0x03 means 0x25 bytes, a regular npdrm ContentID (ex. UP0002-BLES01623_00-0000111122223333) with \0 terminating
* 0x03 means 0x25 bytes, a regular npdrm ContentID (ex. UP0002-BLES01623_00-0000111122223333) with \0 terminating


=== Padding ===
==Padding==
The padding added at the bottom of the LIC.DAT file seems to be intended to increase size to a multiplier of bluray disc sectors and to protect the laser lens because otherway it is too tiny and so stressing for the laser.
Padding addded at bottom of LIC.DAT file, to make the total size a multiplyer of X bluray disc sectors... and to protect the laser lens because otherway is too tiny and hard to locate by the laser
 
This padding is added in the last step when the file is generated in PC, and removed in the first step before the crc32 hash is validated by the PS3.
 
== Multiboot PS3 Game Discs ==
There is a special type of PS3 game disc that contains several EBOOT.BIN with several LIC.DAT files. These LIC.DAT files are a bit special because contains the TITLE_ID of all the EBOOT.BIN files of the disc. Some examples of games using this multiboot disc structure are: [https://gamefaqs.gamespot.com/ps3/712099-metal-gear-solid-the-legacy-collection/data Metal Gear Solid The Legacy Collection, Disc 1] (BLJM-91001 on PS3_DISC.SFB), and [https://gamefaqs.gamespot.com/ps3/108529-fighting-edition-tekken-6-tekken-tag-tournament-2/data Fighting edition] (BLES-02129 on PS3_DISC.SFB).
 
The path names (PS3_GM01, PS3_GM02, etc...) only allows for 2 digits in decimal format... so up to PS3_GM99 + main bootable content in PS3_GAME makes a total of 100.
 
=== Example of Dualboot: Metal Gear Solid The Legacy Collection (BLJM-91001) ===
 
Dual boot disc structure, using folders '''PS3_GAME''', and '''PS3_GM01'''.
 
*dev_bdvd/PS3_GAME/LICDIR/LIC.DAT
**Header
***'''<span style="background:#aCa9a3;">magic</span>''' "PS3LICDA"
***'''<span style="background:#968592;">version</span>''' 1
***'''<span style="background:#66ff66;">flag</span>''' 0x80000000 (retail)
***'''<span style="background:#ff66ff;">lic_table_end</span>''' 0x0A00
***'''<span style="background:#f6ff6f;">lic_table_start</span>''' 0x0800
***'''<span style="background:#9f96f6;">lic_size</span>''' 0x0100
***'''<span style="background:#6ffff6;">lic_num</span>''' 2
***'''<span style="background:#C1C132;">crc32</span>''' 01 0F 95 0E
**First License (located at offset 0x800, for the EBOOT.BIN under directory PS3_GAME)
***'''id_type''' = 0x01
***'''id''' = BLJM61001
**Second License (located at offset 0x900, for EBOOT.BIN under directory PS3_GM01)
***'''id_type''' = 0x01
***'''id''' = BLJM60351

00000000  <span style="background:#aCa9a3;">50 53 33 4C 49 43 44 41</span> <span style="background:#968592;">00 00 00 01</span> <span style="background:#66ff66;">80 00 00 00</span>  PS3LICDA....€...
00000010  <span style="background:#ff66ff;">00 00 0A 00</span> <span style="background:#f6ff6f;">00 00 08 00</span> <span style="background:#9f96f6;">00 00 01 00</span> <span style="background:#6ffff6;">00 00 00 02</span>  ................
00000020  <span style="background:#C1C132;">01 0F 95 0E</span> 00 00 00 00 00 00 00 00 00 00 00 00  ..•.............
...
00000800  01 42 4C 4A 4D 36 31 30 30 31 00 00 00 00 00 00  .BLJM61001......
...
00000900  01 42 4C 4A 4D 36 30 33 35 31 00 00 00 00 00 00  .BLJM60351......
...
0000FFF0  00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00  ................
 
*dev_bdvd/PS3_GM01/LICDIR/LIC.DAT:
**The only diffrence is the flag, set to debug = 0x00000000 (and the crc32, because the flag is included when the crc32 is calculated)
**This means the file LIC.DAT under directory PS3_GAME is different than any of the others under paths PS3_GM01, PS3_GM_02, etc... Because the flag used in the LIC.DAT under the main PS3_GAME folder is set to retail, and the flag for the other LIC.DAT files (under PS3_GM01, PS3_GM02, etc...) is set as debug
**All the others LIC.DAT files (under PS3_GM01, PS3_GM02, etc...) are identical because have the flag set as debug
 
=== Example of Tripleboot: Fighting edition (BLES-02129) ===


Triple boot disc structure, using folders '''PS3_GAME''', '''PS3_GM01''', and '''PS3_GM02'''
This padding is added as the last step when generating the file, and removed as the first step when processing it by PS3


{{File Formats}}
{{File Formats}}
<noinclude>[[Category:Main]]</noinclude>
<noinclude>[[Category:Main]]</noinclude>
Please note that all contributions to PS3 Developer wiki are considered to be released under the GNU Free Documentation License 1.2 (see PS3 Developer wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To protect the wiki against automated edit spam, we kindly ask you to solve the following hCaptcha:

Cancel Editing help (opens in new window)