2,787
edits
Changes
no edit summary
! Cmd || Name
! Cmd || Name
|-
|-
| 0 || [1.0.0] [[#MountContent]]
| 0 || [1.0.0] [[#OpenFileSystem]]
|-
|-
| 1 || [[#SetCurrentProcess]]
| 1 || [[#SetCurrentProcess]]
== Permissions ==
== Permissions ==
Every time permissions are checked, the process registration [[#fsp-pr]] is loaded using the session processID. The permission data is populated with data from the [[NPDM]],
Every time permissions are checked, the process registration [[#fsp-pr]] is loaded using the session processID. The permission data is populated with data from the [[NPDM]].
If the processID is <= 6 (which happens only for built-in sysmodules), it will use a hardcoded registration data. The default mask in this case is 0x8000000000000000.
If the processID is <= 6 (which happens only for built-in sysmodules), it will use a hardcoded registration data. The default mask in this case is 0x8000000000000000.
! Type(s) || Mask || Name || Value || Used by
! Type(s) || Mask || Name || Value || Used by
|-
|-
| 0x0 || 0x8000000000000801 || MountContentType2 || 1 || [[#MountContent]]
| 0x0 || 0x8000000000000801 || MountLogo || 1 || [[#OpenFileSystem]], [[#OpenFileSystemWithPatch]], [[#OpenFileSystemWithId]]
|-
|-
| 0x1 || 0x8000000000000801 || MountContentType5 || 1 || [[#MountContent]]
| 0x1 || 0x8000000000000801 || MountContentMeta || 1 || [[#OpenFileSystem]], [[#OpenFileSystemWithPatch]], [[#OpenFileSystemWithId]]
|-
|-
| 0x2 || 0x8000000000000801 || MountContentType3 || 1 || [[#MountContent]]
| 0x2 || 0x8000000000000801 || MountContentControl || 1 || [[#OpenFileSystem]], [[#OpenFileSystemWithPatch]], [[#OpenFileSystemWithId]]
|-
|-
| 0x3 || 0x8000000000000801 || MountContentType4 || 1 || [[#MountContent]]
| 0x3 || 0x8000000000000801 || MountContentManual || 1 || [[#OpenFileSystem]], [[#OpenFileSystemWithPatch]], [[#OpenFileSystemWithId]]
|-
|-
| 0x4 || 0x8000000000000801 || MountContentType6 || 1 || [[#MountContent]]
| 0x4 || 0x8000000000000801 || MountContentData || 1 || [[#OpenFileSystem]], [[#OpenFileSystemWithPatch]], [[#OpenFileSystemWithId]]
|-
|-
| 0x5 || 0x8000000000000801 || MountContentType7 || 1 || [[#MountContent]]
| 0x5 || 0x8000000000000801 || MountApplicationPackage || 1 || [[#OpenFileSystem]], [[#OpenFileSystemWithPatch]], [[#OpenFileSystemWithId]]
|-
|-
| 0x6 || 0x8000000000000000 || || 3 ||
| 0x6 || 0x8000000000000000 || || 3 ||
| [2.0.0+] 0x1A || 0x8000000000004020 || ||
| [2.0.0+] 0x1A || 0x8000000000004020 || ||
|}
|}
== OpenFileSystem ==
Takes an input [[#FileSystemType]] and an u64 title-id. Returns an [[#IFileSystem]].
[2.0.0+] This function was removed.
== SetCurrentProcess ==
== SetCurrentProcess ==
== OpenFileSystemWithPatch ==
== OpenFileSystemWithPatch ==
Takes an input u32 (same as [[#MountContent]]) and an u64 title-id. Web-applet loads the u32 from u32_table[inparam]. The in32 must be 4.
Takes an input [[#FileSystemType]] and an u64 title-id. Returns an [[#IFileSystem]].
Web-applet loads the [[#FileSystemType]] (which must be '''ContentManual''') from u32_table[inparam].
Note: web-applet strings refer to both this cmd and the below "MountContent" as "MountContent", but official nn_sf_sync symbols use "OpenXX" names.
Note: web-applet strings refer to both this cmd and [[#OpenFileSystemWithId]] as "MountContent", but official nn_sf_sync symbols use "OpenXX" names.
== OpenFileSystemWithId ==
== OpenFileSystemWithId ==
Takes a type-0x19 input buffer, an in32, and an input title-id.
Takes a type-0x19 input buffer, an [[#FileSystemType]] and an u64 title-id. Returns an [[#IFileSystem]].
The in32 must be 5 if the NCA type is 0 (control).
The [[#IFileSystem]] must be '''ContentMeta''' if the NCA type is 0 (control).
The input buffer is the output string path from [[NS_Services#GetApplicationContentPath|GetApplicationContentPath]].
The input buffer is the output string path from nsam [[NS_Services#GetContentNcaPath|GetContentNcaPath]].
May return errors when attempting to access NCA-paths for an update-title with a gamecard, when the gamecard isn't inserted. May return error 0x7D402 in some cases with update-titles. Non-val2 in32 values with NCA-type1 are unusable, even for normal titles.
May return errors when attempting to access NCA-paths for an update-title with a gamecard, when the gamecard isn't inserted. May return error 0x7D402 in some cases with update-titles. Non-val2 in32 values with NCA-type1 are unusable, even for normal titles.
The official "MountApplicationPackage" func uses this with in64=0 and in32=7.
The official "MountApplicationPackage" func uses this with in64=0 and [[#FileSystemType]] '''ApplicationPackage'''.
After the in32-specific permissions are checked, it then gets the func retval for permissions-type 0x25 and func0.
After the [[#FileSystemType]] specific permissions are checked, it then gets the func retval for permissions-type 0x25 and func0.
When in32=5, it uses in64=0xffffffffffffffff internally, otherwise it checks if in64 is set to 0xffffffffffffffff then throws an error if so. When the in64 used internally is not 0xffffffffffffffff, it's compared with the NCA titleID, then an error is thrown on mismatch.
When [[#FileSystemType]] is '''ContentMeta''', it uses in64=0xffffffffffffffff internally, otherwise it checks if in64 is set to 0xffffffffffffffff then throws an error if so. When the in64 used internally is not 0xffffffffffffffff, it's compared with the NCA titleID, then an error is thrown on mismatch.
== OpenBisFileSystem ==
== OpenBisFileSystem ==
Takes a type-0x19 input buffer string and a u32 Bis partitionID(see below). Official user-process code sets instr[0] = 0 normally.
Takes a type-0x19 input buffer string and a u32 [[Flash_Filesystem|Bis partitionID]]. Official user-process code sets instr[0] = 0 normally. Returns an [[#IFileSystem]].
Returns an [[#IFileSystem]].
Only partitionIDs for FAT partitions are usable with this, otherwise error 0x2EE202 is returned. Seems to be about the same as [[#OpenBisStorage]] except this mounts the partition filesystem instead of allowing direct access to the partition sectors.
Only partitionIDs for FAT partitions are usable with this, otherwise error 0x2EE202 is returned. Seems to be about the same as [[#OpenBisStorage]] except this mounts the partition filesystem instead of allowing direct access to the partition sectors.
== OpenGameCardStorage ==
== OpenGameCardStorage ==
Takes two input u32s (gamecard handle, partition ID), and returns an [[#IStorage]] for the [[Gamecard_Format|partition]].
Takes two input u32s (gamecard handle, partition ID), and returns an [[#IStorage]] for the [[Gamecard_Format|partition]].
== OpenGameCardFileSystem ==
== OpenGameCardFileSystem ==
Takes two input u32s, with the second u32 located at +4 in rawdata after the first u32.
Takes two input u32s, with the second u32 located at +4 in rawdata after the first u32. Returns an [[#IFileSystem]].
Returns an [[#IFileSystem]].
Mounts a gamecard [[Gamecard_Partition|partition]].
Mounts a [[Gamecard_Partition|gamecard partition]].
== OpenSaveDataFileSystem ==
== OpenSaveDataFileSystem ==
Takes a type-0x9 input buffer for the path and returns [[#DirectoryEntryType]] as an output u32.
Takes a type-0x9 input buffer for the path and returns [[#DirectoryEntryType]] as an output u32.
==OpenDirectory==
== OpenDirectory ==
Takes a type-0x9 input buffer for the path and an u64 '''filter_flags'''. '''filter_flags''' controls what type of entries are read by the [[#IDirectory]]: bitmask 0x1 = directories, bitmask 0x2 = files.
Takes a type-0x9 input buffer for the path and an u64 '''filter_flags'''. '''filter_flags''' controls what type of entries are read by the [[#IDirectory]]: bitmask 0x1 = directories, bitmask 0x2 = files.
== GetGameCardUpdatePartitionInfo ==
== GetGameCardUpdatePartitionInfo ==
Returns a titleID and the title-version for it.
Returns a titleID and the title-version for it.
|-
|-
| 0 || GetEventHandle
| 0 || GetEventHandle
|}
= FileSystemType =
{| class="wikitable" border="1"
|-
! Value || Name
|-
| 0 || Invalid
|-
| 1 || Invalid
|-
| 2 || Logo
|-
| 3 || ContentControl
|-
| 4 || ContentManual
|-
| 5 || ContentMeta
|-
| 6 || ContentData
|-
| 7 || ApplicationPackage
|}
|}
|}
|}
= Save Struct =
=Save Struct=
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
For DeviceSaveData, this struct is all-zero except for the [[#SaveDataType]] field.
For DeviceSaveData, this struct is all-zero except for the [[#SaveDataType]] field.
=SaveCreate Struct=
= SaveCreate Struct =
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Total size is 0x40-bytes.
Total size is 0x40-bytes.
=DeviceSaveData=
= DeviceSaveData =
This is accessed using the same commands for SaveData with the same input u8, the only difference compared to SaveData is the Save-struct.
This is accessed using the same commands for SaveData with the same input u8, the only difference compared to SaveData is the Save-struct.
=BcatSaveData=
= BcatSaveData =
This is accessed using the same commands for SaveData with the same input u8. The Save-struct is the same as DeviceSaveData, except that the titleID field is set to <input titleID>. See above regarding SaveCreate-struct.
This is accessed using the same commands for SaveData with the same input u8. The Save-struct is the same as DeviceSaveData, except that the titleID field is set to <input titleID>. See above regarding SaveCreate-struct.
The 0x10-byte struct passed to [[#CreateSaveDataFileSystem]] has the first 0x5-bytes set to all-zero.
The 0x10-byte struct passed to [[#CreateSaveDataFileSystem]] has the first 0x5-bytes set to all-zero.
=SaveDataInfo=
= SaveDataInfo =
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-