Secure Modules Functions

Depending on the F00D SELF that is currently loaded, different commands are handled.

Request Buffer
Each request that is made sends a page aligned buffer that has a max size of a page. After as 64 byte header common to all commands, the data afterwards is specific to each command. The documentation for each command below specifies the data that goes after the header. The special command id of -1 is used to shut down the currently loaded F00D SELF.

Physical Address List
A common format used in these requests is a list of physical address and size. This simple structure is defined below. See SceSysmem for information on creating this list.

This data format is used when passing large buffers of data to F00D. This is because the memory manager in kernel could allocate contiguous virtual addresses that corresponds to varying physical addresses.

kprx_auth_sm.self
This is a special SELF that is found in the boot SLB2 partition. The raw (encrypted) SELF is found in secure world memory (placed there by an early bootloader). It is used to decrypt SELFs for ARM and load SELFs for F00D. The SELF header is passed into a page aligned buffer and a paddr list is generated from it.

0x10001
Parses the SELF header for decryption. The header is copied to the F00D private memory region first (on 1.69 with 0x1000 sized header, it is at  in F00D memory space.

SELF Path Code
This code is found by the path the SELF was loaded from. It's used by F00D to check if the SELF being loaded from an allowed partition. A path that does not start with any of the following will have  returned as the code. It could also be used to select the key used in decryption.

0x20001
Set the program segment to decrypt. This corresponds to the segment index in the ELF program headers in the SELF header passed in with the command above.

0x30001
Decrypt a buffer from the SELF corresponding to the program segment number passed in above. The segment is read in  chunks and is decrypted in place (the input buffer will contain the decrypted data). A paddr list is generated from the buffer. The input buffer and output buffer can be the same.

0x40001
Used by SceSblAuthMgr for decryption maybe?

0x50001
Used by SceSblAuthMgr to set key for decryption (?).

0x60001
Used by SceSblAuthMgr for decryption maybe?

0x70001
Used by SceSblAuthMgr for some kind of decryption process related to ACT.DAT

0x80001
Used by SceSblAuthMgr for used by the VSH function _vshSblAuthMgrVerifySpsfo.

0x2
Verify afv data

0x4
Verify activation data

0x5
Get activation data. The returned data is sent to Syscon at offset 0x520.

0x7
Check if activation is valid. The activation data is read from Syscon at offset 0x520.

0xA
Introduced in 2.12. Check if new activation is valid. Extended activation check with a signature. This is ran when installing a new afv.

0xB
Introduced in 2.12. Check if current activation is valid. Extended activation check with signature. This is ran on boot.

0x1
Returns 16 byte console id (used in vshSblAimgrGetConsoleId)

0x3
Used in vshSblAimgrGetVisibleId

0x2
Returns the console's OpenPSID. Also known as the "activation key" for PDEL and PTEL.

0x4
Used in vshSblAimgrGetPscode2

0x10006
Seems to be called on init and before resume of PSP

encdec_w_portability_sm.self
This seem to be used to do some kind of key derivation. May also be used as a general purpose encryption engine.

0x1000A
Encrypt data

0x2000A
Decrypt data

Return of 0x800f0002 means invalid service ID. For encdec_w_portability_sm, only 0x1000A and 0x2000A are supported.

Return of 0x800f1716 means invalid key slot. Valid key slots are only 1-10.

0x1000B
Supported GC commands and structures

0x4
Original PSP Kirk 4 service for encrypting data

0x7
Original PSP Kirk 7 service for decrypting data

0xC
Original PSP Kirk 0xC service for Generating a 160bit ECC private/public keypair. Call with an empty buffer of length 0x3C. The structure below is the return structure.

0xD
Original PSP Kirk 0xD service for multiplying a 160bit ECC curve point with a value. Call with a multiplier, then a x and y point value.

Result

0xE
Original PSP Kirk 0xE service for 160bit Random number generation. Call with an empty buffer, the result structure is below.

0x10
Original PSP Kirk 0x10 service for 160bit ECC signing. Call and return structure below.

Result

0x11
Original PSP Kirk 0x11 service for 160bit ECC signature verification. Call with the below structure, then function will return pass or fail.

Result

0x14
New Vita Kirk 0x14 service for Generating a 224bit ECC private/public keypair. Call with an empty buffer of length 0x54. The structure below is the return structure.

0x15
New Vita Kirk 0x15 service for multiplying a 224bit ECC curve point with a value. Call with a multiplier, then a x and y point value.

Result

0x16
New Vita Kirk 0x16 service for 160bit Random number generation. Call with an empty buffer, the result structure is below.

0x17
New Vita Kirk 0x17 service. Unknown, but buffer length is 0x3C. Almost certainly a 224bit version of 0x10

0x18
New Vita Kirk 0x18 service. Unknown, but buffer length is 0x8C. Almost certainly a 224bit version of 0x11

0x19
New Vita Kirk 0x19 service. Unknown, but buffer length is 0xE8. Related to IdStorage somehow. Almost certainly a 224bit version of 0x12

0x1B
New Vita Kirk 0x1B service. Unknown, but buffer length is 0x53.

0x1C
New Vita Kirk 0x1C service. Unknown, but buffer length is 0x40.

0x1D
New Vita Kirk 0x1D service. Unknown, but buffer length is 0xA3. Related to SceSdif somehow.

0x1E
New Vita Kirk 0x1E service. Unknown, but buffer length is 0x51. Related to SceSdif somehow.

0x1F
New Vita Kirk 0x1F service. Unknown, but buffer length is 0xB3. Related to SceSdif somehow.

0x20
New Vita Kirk 0x20 service. Unknown, but buffer length is 0x116. Related to SceSdif somehow.

0x21
New Vita Kirk 0x21 service. Unknown, but buffer length is 0x34.

0x22
New Vita Kirk 0x22 service. Unknown, but buffer length is 0x3C.

0x23
New Vita Kirk 0x23 service. Unknown, but buffer length is 0x20.

0xE0002
Used to decrypt lists stored in updates. Same format as 0x40002.

update_service_sm.self
This is used by SceSblSsUpdateMgr to decrypt update packages extracted from PUP files. Both 0x40002 and 0x50002 reference buffers in the following way: an inner paddr list is generated for the buffer containing the data to encrypt/decrypt, then an outer paddr list is generated for the inner list. That means there's two levels of indirection in the paddr list.

0x10002
Verify PUP header.

0x20002
Verify PUP segment.

0x30002
Verify watermark.

0x40002
Decrypt package. Allocate a page aligned buffer and read the complete pkg file into the buffer. The buffer is decrypted in place.

0x50002
Re-encrypt enp files

0xA0002
Verify additional data.