Editing System File Object (SFO) (PSF)

[[Category:Software]]
These config strings are inside the [http://www.vitadevwiki.com/index.php?title=Packages_%28.PKG%29#Game_Packages Game Package (PKG)].

See also PARAM.SFO on:
*[http://www.psdevwiki.com/ps3/Eboot.PBP#PARAM.SFO PSP], 
*[http://www.psdevwiki.com/ps3/PARAM.SFO PS3], 
*[http://www.psdevwiki.com/ps4/PARAM.SFO PS4].

See also {{talk}} page

== Internal Structure ==
The values contained in a '''S'''ystem '''F'''ile '''O'''bject can be simplyfied as inputs/outputs for/from the content:
Boot modifyers (most of the int32 datas) that are sent to the content when is executed to activate specific features or settings (e.g. audio and video modes of a game).
Information texts (most of the utf8 datas) about the content and its restrictions (e.g. title and version of a game).

=== Header SFO ===
This is the Header of a SFO/PSF file.
{| class="wikitable sortable" style="text-align: center;border:2px solid #53464F;"
|-
| style="background-color:#505346; color:#FFFFFF;" |'''Offset'''
| style="background-color:#505346; color:#FFFFFF;" |'''Data'''
| style="background-color:#505346; color:#FFFFFF;" |'''Length'''
| style="background-color:#505346; color:#FFFFFF;" |'''Notes'''
|-
| 0x00 || 00 50 53 46 || 0x04 || " PSF" Magic
|-
| 0x04 || 01 01 00 00 || 0x04 || Version
|-
| 0x08 || xx xx 00 00 || 0x04 || Key table start offset 
|-
| 0x0C || xx xx 00 00 || 0x04 || Data table start offset
|-
| 0x10 || xx 00 00 00 || 0x04 || № of entries in index table (params/values)
|-
|}

 typedef struct{
     int magic; //PSF
     int version; //1.1
     int keyTableOffset;
     int dataTableOffset;
     int indexTableEntries;
 } sfo_header_t;

=== Index table ===
Starting at offset 0x14, this structure (0x10) is repeated the number of times defined in the header ( № of parameters)

{| class="wikitable sortable" style="text-align: center;border:2px solid #53464F;"
|-
| style="background-color:#505346; color:#FFFFFF;" |'''Offset'''
| style="background-color:#505346; color:#FFFFFF;" |'''Data'''
| style="background-color:#505346; color:#FFFFFF;" |'''Length'''
| style="background-color:#505346; color:#FFFFFF;" |'''Notes'''
|-
| 0x14 || 00 00 || 0x02 || Key table offset
|-
| 0x16 || 04 0x  || 0x02 || param_fmt (type of data)
|-
| 0x18 || xx xx 00 00 || 0x04 || parameter length
|-
| 0x1C || xx xx 00 00 || 0x04 || parameter max length
|-
| 0x20 || 00 00 00 00 || 0x04 || Data table offset
|-
|}

 typedef struct{
     u16 keyOffset; //offset of keytable + keyOffset
     u16 param_fmt; //enum (see below)
     u32 paramLen;
     u32 paramMaxLen;
     u32 dataOffset; //offset of datatable + dataOffset
 } indexTableEntry_t;

Used on index table, there are 3 variables:

<small>
0x6+0x10*i<br />
(i=0,1,2,3,4,5,...)
</small>

{| border=2 style="text-align: center;"
|-
| style="background-color:#505346; color:#FFFFFF;" |'''Param_fmt'''
| style="background-color:#505346; color:#FFFFFF;" |'''Arch'''
| style="background-color:#505346; color:#FFFFFF;" |'''Format'''
| style="background-color:#505346; color:#FFFFFF;" |'''Notes'''
|-
| 04 00 || Little Endian || style="background-color:#00DDDD;" | utf-8 Special Mode || Used in contents generated by the system (e.g.: save data)
|-
| 04 02 || Little Endian || style="background-color:#DDDD00;" | utf-8 || Character string, NULL finished (0x00)
|-
| 04 04 || Little Endian || style="background-color:#DD00DD;" | integer || 32 bits unsigned
|-
|}

=== Key table ===
Ordered alphabetically, each name of parameters of this table is NULL terminated with 1 blank byte (0x00) to separate them. 

The table has padding at the end to align their size to a multiply of 4 ( if matches with a multiply of 4 this padding doesn't exist) 

=== Data table ===
*UTF-8 entries never uses all the reserved bytes, needs 1 blank byte (0x00) after the last character.

*Integer entries uses all the reserved bytes.

=== Algorithm ===

(i=0,1,2,3,4,5,...)<br />
*Get Position Value<br />
**[PSF offset] + [Value Start] + (0x14+(0x10*i))
*Get Type<br />
**[PSF offset] + (0x16 * (0x10*i))
*Get Lenght Param<br />
**[PSF offset] + (0x1C * (0x10*i))
*Get Lenght Value<br />
**[PSF offset] + (0x24+0x10*i)-(0x14+0x10*i)
*Get Position Param<br />
**[PSF offset] + [Param Start] + (0x20+(0x10*i))

for any problems, you can give a look into my sourcecode: [https://raw.github.com/wargio/vitatool/master/sfo_stuff.c sfo_stuff.c]

=== Parameters Descriptions===

====APP_VER====
{{Boxinfo3|content='''param_fmt''': utf-8<br />'''param_max_len''': 0x8 (8 bytes)<br />'''param_len''': 0x6 (6 bytes)}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital), Non-Game Application}}

The format is '''XX.YY''' where "'''XX'''" and "'''YY'''" are numbers, and the point "'''.'''" is included in the string, e.g: '''01.00''' for the first stable version released.

====ATTRIBUTE====
{{Boxinfo3|content='''param_fmt''': uint32_t<br />'''param_max_len''': 0x4 (4 bytes)<br />'''param_len''': 0x4 (4 bytes)}}
{{Boxtip1|content='''Used by''':  PSVita Game (Digital), Non-Game Application}}

Can contains 32 flags that can be turned on/off to activate/deactivate features allowed for the game/apps content.

====ATTRIBUTE2====
{{Boxinfo3|content='''param_fmt''': uint32_t<br />'''param_max_len''': 0x4 (4 bytes)<br />'''param_len''': 0x4 (4 bytes)}}
{{Boxtip1|content='''Used by''':  PSVita Game (Digital), Non-Game Application}}

This parameter can not exist on some PKG (used for special functions??)

====ATTRIBUTE_MINOR====
{{Boxinfo3|content='''param_fmt''': uint32_t<br />'''param_max_len''': 0x4 (4 bytes)<br />'''param_len''': 0x4 (4 bytes)}}
{{Boxtip1|content='''Used by''':  PSVita Game (Digital)}}

Can contains 32 flags that can be turned on/off to activate/deactivate features allowed for the game/apps content.

====CATEGORY====
{{Boxinfo3|content='''param_fmt''': utf-8<br />'''param_max_len''': 0x4 (4 bytes)<br />'''param_len''': 0x4 (4 bytes)}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital), Non-Game Application}}

See [http://www.psdevwiki.com/ps4/Param.sfo#CATEGORY PS4 Category]

{| class="wikitable" style="text-align: center;border:2px dotted #123AAA;"
|-
! {{cellcolors|#505346|white}} Value
! {{cellcolors|#505346|white}} standard name   
|-
| ac  || PS Vita Additional Content
|-
| gd  ||PS Vita Application (Game Digital)
|-
| gda ||PS Vita System Application
|-
| gdc ||PS Vita Non-Game Application
|-
| gdd ||PS Vita BG Application
|-
| gp  ||PS Vita Application Patch
|-
| gpc ||PS Vita Non-Game Application Patch
|-
| gpd ||PS Vita BG Application patch
|-
| sd  ||PS Vita Save Data
|-
|}

====CONTENT_ID====
{{Boxinfo3|content='''param_fmt''': utf-8<br />'''param_max_len''': 0x30 (48 bytes)<br />'''param_len''': 0x25 (37 bytes)}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital), Non-Game Application}}

The format is: XXYYYY-NP_COMMUNICATION_ID-LICENSE_ID.

<small>e.g.: JP0365-PCSG90004_00-SKP2TRIAL0000000</small>

See [http://www.psdevwiki.com/ps4/Content_ID Content ID]

====GC_RO_SIZE====
{{Boxinfo3|content='''param_fmt''': uint32_t<br />'''param_max_len''': 0x4 (4 bytes)<br />'''param_len''': 0x4 (4 bytes)}}
{{Boxtip1|content='''Used by''':  PSVita Game (Digital), Non-Game Application}}

Seen: 0x1C0000 (1835008), 0x380000 (3670016)

====GC_RW_SIZE====
{{Boxinfo3|content='''param_fmt''': uint32_t<br />'''param_max_len''': 0x4 (4 bytes)<br />'''param_len''': 0x4 (4 bytes)}}
{{Boxtip1|content='''Used by''':  PSVita Game (Digital), Non-Game Application}}

...

====INSTALL_DIR_SAVEDATA====
{{Boxinfo3|content='''param_fmt''': utf-8<br />'''param_max_len''': 0xc (12 bytes)<br />'''param_len''': 0x9? (9 bytes)}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital)}}

Similar to TITLE_ID, identifier of the content, in the format '''WXYZ12345'''.

Used by demo trials/cross platforms titles?

====NP_COMMUNICATION_ID====
{{Boxinfo3|content='''param_fmt''': utf8<br />'''param_max_len''': 0x10 (16 bytes)<br />'''param_len''': 0xD (13 bytes)}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital)}}

[http://www.psdevwiki.com/ps4/NP_Communication_ID '''N'''etwork '''P'''latform '''Communication''' '''ID'''].

The format is 4 letters + 5 numbers with optionally a subid (usually 0) : NPWRyyyyy_zz (e.g. NPWR00001_00)

====PARENTAL_LEVEL====
{{Boxinfo3|content='''param_fmt''': uint32_t<br />'''param_max_len''': 0x4 (4 bytes)<br />'''param_len''': 0x4 (4 bytes)}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital), Non-Game Application}}

This should be the same as in the PS3/PS4 (from 0 to 11)

It is a [http://en.wikipedia.org/wiki/Video_game_content_rating_system scale to rate the content] for the different users based in [[LiveArea:Parental_Controls|parental control settings]] and international rating systems as: [http://en.wikipedia.org/wiki/Pan_European_Game_Information PEGI], [http://en.wikipedia.org/wiki/Entertainment_Software_Rating_Board ESRB], [http://en.wikipedia.org/wiki/Computer_Entertainment_Rating_Organization CERO], etc...

====PSP2_DISP_VER====
{{Boxinfo3|content='''param_fmt''': utf-8<br />'''param_max_len''': 0x8 (4 bytes)<br />'''param_len''': 0x8? (8 bytes)}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital), Non-Game Application}}

Minimum [[Template:Firmware_revisions|Firmware]] needed to play this title.

====PSP2_SYSTEM_VER====
{{Boxinfo3|content='''param_fmt''': uint32_t<br />'''param_max_len''': 0x4 (4 bytes)<br />'''param_len''': 0x4 (4 bytes)}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital), Non-Game Application}}

Minimum [[Template:Firmware_revisions|Firmware]] needed to play this title.

====PUBTOOLINFO====
{{Boxinfo3|content='''param_fmt''': utf-8<br />'''param_max_len''': 0x200 (512 bytes)<br />'''param_len''':variable}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital), Non-Game Application}}

Contains infos (UTF-8), separated by a comma (0x2C):
*c_date=yyyymmdd (creation date format?)
*sdk_ver=xxxxxxxx (digits to indicate [[SCEI_PSVita_SDK|PSVita SDK version]]?) : seen: 01650000, 01800000, 02500000, 03000000

====REGION_DENY====
{{Boxinfo3|content='''param_fmt''': uint32_t<br />'''param_max_len''': 0x4 (4 bytes)<br />'''param_len''': 0x4 (4 bytes)}}
{{Boxtip1|content='''Used by''':  PSVita Game (Digital), Non-Game Application}}

Regions restrictions for the content.

See [http://www.psdevwiki.com/ps3/PARAM.SFO#REGION_DENY PS3 Region deny]

====SAVEDATA_MAX_SIZE====
{{Boxinfo3|content='''param_fmt''': uint32_t<br />'''param_max_len''': 0x4 (4 bytes)<br />'''param_len''': 0x4 (4 bytes)}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital), Non-Game Application}}

e.g.: 0x00000400 ( = 1024) this game can use 1024 Bytes (1MB)

Seen: 0x400 (1024), 0x800 (2048), 0x1000 (4096), 0x2000 (8192), 0x2800 (10240), 0x5000 (20480), 0x20000 (131072), 0x100000 (1048576)

====STITLE====
{{Boxinfo3|content='''param_fmt''': utf-8<br />'''param_max_len''': 0x34 (52 bytes)<br />'''param_len''': variable}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital), Non-Game Application}}

Default "subtitle of the game" for [[Languages|all languages]].

====STITLE_xx====
{{Boxinfo3|content='''param_fmt''': utf-8<br />'''param_max_len''': 0x34 (52 bytes)<br />'''param_len''': variable}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital)}}

Same than STITLE but for [[Languages|localized languages]].

An .SFO can contain several STITLE_'''xx''' where '''xx''' is a number for a regional code.

The "default" TITLE is always present when other "localized" TITLE_'''xx''' are used.

====SUPPORT_URI====
{{Boxinfo3|content='''param_fmt''': utf-8<br />'''param_max_len''': 0x10 (16 bytes)<br />'''param_len''': variable?}}
{{Boxtip1|content='''Used by''': Non-Game Application}}

e.g.:sonyreader://

====TITLE====
{{Boxinfo3|content='''param_fmt''': utf-8<br />'''param_max_len''': 0x80 (128 bytes)<br />'''param_len''': variable}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital), Non-Game Application}}

Default "title of the game" for [[Languages|all languages]].

====TITLE_xx====
{{Boxinfo3|content='''param_fmt''': utf-8<br />'''param_max_len''': 0x80 (128 bytes)<br />'''param_len''': variable}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital)}}

Same than STITLE.

====TITLE_ID====
{{Boxinfo3|content='''param_fmt''': utf-8<br />'''param_max_len''': 0x0C (12 bytes)<br />'''param_len''': 0xA (10 bytes)}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital), Non-Game Application}}

Identifier ( [http://www.psdevwiki.com/ps4/Productcode Productcode] ) of the content, in the format '''WXYZ12345'''.

See also [[Title_ID]]

====VERSION====
{{Boxinfo3|content='''param_fmt''': utf-8<br />'''param_max_len''': 0x8 (8 bytes)<br />'''param_len''': 0x6 (6 bytes)}}
{{Boxtip1|content='''Used by''': PSVita Game (Digital), Non-Game Application}}

Version content of the game: Disc revision, or Package revision. The number increases when the content is re-released or re-packaged for whatever reason that doesn't affect the main executable (e.g. when a disc game reaches platinum sales, or "game of the year edition" including extra contents).

----

=== PSF Dump (From 0xBF0 to 0x11F0) ===
The length of this is 0x5D0
<pre>
 offset   00 01 02 03 04 05 06 07  08 09 0A 0B 0C 0D 0E 0F

00000bf0  00 50 53 46 01 01 00 00  24 01 00 00 dc 01 00 00  |.PSF....$.......|  -> Header
00000c00  11 00 00 00 00 00 04 02  06 00 00 00 08 00 00 00  |................|  -> Unknown
00000c10  00 00 00 00 08 00 04 04  04 00 00 00 04 00 00 00  |................|
00000c20  08 00 00 00 12 00 04 02  03 00 00 00 04 00 00 00  |................|  
00000c30  0c 00 00 00 1b 00 04 02  25 00 00 00 30 00 00 00  |........%...0...|
00000c40  10 00 00 00 26 00 04 04  04 00 00 00 04 00 00 00  |....&...........|
00000c50  40 00 00 00 31 00 04 04  04 00 00 00 04 00 00 00  |@...1...........|
00000c60  44 00 00 00 3c 00 04 04  04 00 00 00 04 00 00 00  |D...<...........|
00000c70  48 00 00 00 4b 00 04 02  07 00 00 00 08 00 00 00  |H...K...........|
00000c80  4c 00 00 00 59 00 04 04  04 00 00 00 04 00 00 00  |L...Y...........|
00000c90  54 00 00 00 69 00 04 02  10 00 00 00 00 02 00 00  |T...i...........|
00000ca0  58 00 00 00 75 00 04 04  04 00 00 00 04 00 00 00  |X...u...........|
00000cb0  58 02 00 00 87 00 04 02  20 00 00 00 34 00 00 00  |X....... ...4...|
00000cc0  5c 02 00 00 8e 00 04 02  20 00 00 00 34 00 00 00  |\....... ...4...|
00000cd0  90 02 00 00 98 00 04 02  35 00 00 00 80 00 00 00  |........5.......|
00000ce0  c4 02 00 00 9e 00 04 02  35 00 00 00 80 00 00 00  |........5.......|
00000cf0  44 03 00 00 a7 00 04 02  0a 00 00 00 0c 00 00 00  |D...............|
00000d00  c4 03 00 00 b0 00 04 02  06 00 00 00 08 00 00 00  |................|
00000d10  d0 03 00 00 41 50 50 5f  56 45 52 00 41 54 54 52  |....APP_VER.ATTR| -> Variables
00000d20  49 42 55 54 45 00 43 41  54 45 47 4f 52 59 00 43  |IBUTE.CATEGORY.C|
00000d30  4f 4e 54 45 4e 54 5f 49  44 00 47 43 5f 52 4f 5f  |ONTENT_ID.GC_RO_|
00000d40  53 49 5a 45 00 47 43 5f  52 57 5f 53 49 5a 45 00  |SIZE.GC_RW_SIZE.|
00000d50  50 41 52 45 4e 54 41 4c  5f 4c 45 56 45 4c 00 50  |PARENTAL_LEVEL.P|
00000d60  53 50 32 5f 44 49 53 50  5f 56 45 52 00 50 53 50  |SP2_DISP_VER.PSP|
00000d70  32 5f 53 59 53 54 45 4d  5f 56 45 52 00 50 55 42  |2_SYSTEM_VER.PUB|
00000d80  54 4f 4f 4c 49 4e 46 4f  00 53 41 56 45 44 41 54  |TOOLINFO.SAVEDAT|
00000d90  41 5f 4d 41 58 5f 53 49  5a 45 00 53 54 49 54 4c  |A_MAX_SIZE.STITL|
00000da0  45 00 53 54 49 54 4c 45  5f 30 30 00 54 49 54 4c  |E.STITLE_00.TITL|
00000db0  45 00 54 49 54 4c 45 5f  30 30 00 54 49 54 4c 45  |E.TITLE_00.TITLE|
00000dc0  5f 49 44 00 56 45 52 53  49 4f 4e 00 30 31 2e 30  |_ID.VERSION.01.0| -> Parameters of Variables
00000dd0  30 00 00 00 00 00 00 00  67 64 00 00 4a 50 30 33  |0.......gd..JP03|
00000de0  36 35 2d 50 43 53 47 39  30 30 30 34 5f 30 30 2d  |65-PCSG90004_00-|
00000df0  53 4b 50 32 54 52 49 41  4c 30 30 30 30 30 30 30  |SKP2TRIAL0000000|
00000e00  00 00 00 00 00 00 00 00  00 00 00 00 00 80 1a 00  |................|
00000e30  00 00 00 00 01 00 00 00  30 31 2e 35 30 30 00 00  |........01.500..|
00000e40  00 00 50 01 63 5f 64 61  74 65 3d 32 30 31 31 31  |..P.c_date=20111| -> creation data
00000e50  32 30 35 00 00 00 00 00  00 00 00 00 00 00 00 00  |205.............|
00000e60  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |................|
*
00001040  00 00 00 00 00 04 00 00  75 6b 65 2d 74 6f 72 6e  |........uke-torn| ->SAVEDATA_MAX_SIZE + STITLE
00001050  65 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |e...............|
00001060  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |................|
00001070  00 00 00 00 00 00 00 00  00 00 00 00 75 6b 65 2d  |............uke-| ->STITLE_00
00001080  74 6f 72 6e 65 00 00 00  00 00 00 00 00 00 00 00  |torne...........|
00001090  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |................|
*
000010b0  75 6b 65 2d 74 6f 72 6e  65 00 00 00 00 00 00 00  |uke-torne.......| ->TITLE
000010c0  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |................|
*
00001130  75 6b 65 2d 74 6f 72 6e  65 28 e3 82 a6 e3 82 b1  |uke-torne(......| ->TITLE_00
00001140  e3 83 88 e3 83 ab e3 83  8d 29 00 00 00 00 00 00  |.........)......|
00001150  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |................|
*
000011b0  50 43 53 43 38 30 30 30  33 00 00 00 30 31 2e 30  |PCSC80003...01.0| ->TITLE_ID + VERSION
000011c0  30 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |0...............|
000011d0  00 00 00 00 00 00 00 01  28 00 00 00 00 00 00 30  |........(......0|
000011e0  80 00 00 00 00 00 00 00  22 00 00 10 1c c7 38 83  |........".....8.|

</pre>