3dbrew - User contributions [en]

Config Savegame

2026-02-18T16:16:43Z

TimmSkiller: Update config block 0x00030002

This page describes the format of the [[Config_Services|Cfg]] [[System_SaveData|NAND]] savegame. These blocks can be accessed with the Cfg service commands.

==Structure of save-file "/config"==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x2
| Total entries
|-
| 0x2
| 0x2
| Data entries offset
|-
| 0x4
| 0x4558
| Block entries
|-
| 0x455C
|
| Data for the entries
|}

The filesize for this /config file is 0x8000-bytes.

==Configuration block entry ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| BlkID
|-
| 0x4
| 0x4
| Offset to the data for this block when size is >4, otherwise this word is the data for this block
|-
| 0x8
| 0x2
| Size
|-
| 0xA
| 0x2
| Access Flags
|}

===Access Flags===
{| class="wikitable" border="1"
|-
! Bit Mask
! Description
|-
| 0x2
| User Readable (cfg:u)
|-
| 0x4
| System Writable (cfg:s / cfg:i)
|-
| 0x8
| System Readable (cfg:s / cfg:i)
|}

Config blocks will typically either use 0xC for system readable/writable or 0xE for all 3.

==Configuration blocks==
{| class="wikitable" border="1"
|-
! BlkID
! Size
! Access Flags
! Description
|-
| 0x00000000
| 0x2
| 0xC
| Config savegame version?
|-
| 0x00010000
| 0x1
| 0xC
| [[Hardware_calibration#RTC|RTC compensation value]]
|-
| 0x00020000
| 0x134
| 0xC
| [[Hardware_calibration#CDC|Codec]]
|-
| 0x00030000
| 0x1
| 0xC
| Leap Year Counter (read By PTM)
|-
| 0x00030001
| 0x8
| 0xE
| User time offset (read by CECD): displayed timestamp - rtc timestamp
|-
| 0x00030002
| 0x8
| 0xC
| Difference (in nanoseconds) between UTC server time and RTC time. Updated by [[Friend_Services|the Friends sysmodule]] after every [[Online_Play|NASC]] login. Used by System settings to calculate the real current time according to the online play authentication server, in order to determine the user's actual age based on the given date of birth (related to COPPA, since this is used to check whether the user is at least 13 years old).
|-
| 0x00040000
| 0x10
| 0xC
| [[Hardware_calibration#Touch|Touch calibration]] (read by HID)
|-
| 0x00040001
| 0x1C
| 0xC
| Analog Stick Calibration Param?(read by HID)
|-
| 0x00040002
| 0x12
| 0xC
| [[Hardware_calibration#Gyro|Gyroscope]] (read by HID)
|-
| 0x00040003
| 0xC
| 0xC
| [[Hardware_calibration#Accel|Accelerometer]] (read by HID)
|-
| 0x00040004
| 0x1C
| 0xC
| [[Hardware_calibration#CStick|CStick calibration data]]
|-
| 0x00050000
| 0x2
| 0xC
| [[Hardware_calibration#Screen_flicker|Screen flicker]]
|-
| 0x00050001
| 0x2
| 0xC
| Backlight controls (u8 ABL_powersave_enable, u8 brightness_level) (read by GSP)
|-
| 0x00050002
| 0x38
| 0xC
| [[Hardware_calibration#BLPWM|Backlight PWM]] (read by GSP)
|-
| 0x00050003
| 0x20
| 0xC
| [[Hardware_calibration#ABL|Power saving mode (ABL) calibration]] (read by GSP)
|-
| 0x00050004
| 0x20
| 0xC
| [[Hardware_calibration#ABL|Power saving mode (ABL) calibration]] (for legacy FIRM)
|-
| 0x00050005
| 0x20
| 0xE
| Stereo display settings (HWCAL block 0x470)
|-
| 0x00050006
| 0x2
| 0xC
| [[Hardware_calibration#ULCD_delay|3D switching delay]]
|-
| 0x00050007
| 0x4
| 0xC
| ?
|-
| 0x00050008
| 0x10C
| 0xC
| [[Hardware_calibration#ABL_extra|Power saving mode (ABL) extra config]]
|-
| 0x00050009
| 0x8
| 0xC
| new3DS only(?) backlight control (5th byte: auto-brightness enable)
|-
| 0x00060000
| 0x96
| 0xC
| ??? (HWCAL block 0x500)
|-
| 0x00070000
| 0x214
| 0xE
| [[Hardware_calibration#3D_filters|3D filters]]
|-
| 0x00070001
| 0x1
| 0xE
| Sound output mode (mono=0, stereo=1, surround=2)
|-
| 0x00070002
| 0x8
| 0xE
| [[Hardware_calibration#Microphone_echo_cancel|Microphone echo cancellation params]]
|-
| 0x00080000
| 0xC00
| 0xC
| WiFi configuration slot 0
|-
| 0x00080001
| 0xC00
| 0xC
| WiFi configuration slot 1
|-
| 0x00080002
| 0xC00
| 0xC
| WiFi configuration slot 2
|-
| 0x00090000
| 0x8
| 0xE
| This contains a u64 ID, used by processes using [[NWMUDS:InitializeWithVersion]]. The first word is the same as [[CfgS:GetLocalFriendCodeSeed|LocalFriendCodeSeed]], while the latter is a separate word.
|-
| 0x00090001
| 0x8
| 0xE
| Same content as 0x0009000? This console-unique u64 is used by [[Cfg:GenHashConsoleUnique|GenHashConsoleUnique]]. It is generated by <code>((0x3FFFFFFFF) & LocalFriendCodeSeed) | (random16 << 48))</code>, where random16 is generated by [[PSPXI:GenerateRandomBytes|GenerateRandomBytes]]
|-
| 0x00090002
| 0x4
| 0xE
| The first two bytes are the same random16 used in 0x00090001. The second two bytes are zeros.
|-
| 0x000A0000
| 0x1C
| 0xE
| [[#User Name Block 0x000A0000|User Name]]
|-
| 0x000A0001
| 0x2
| 0xE
| Birthday (u8 month, u8 day)
|-
| 0x000A0002
| 0x1
| 0xE
| Language
|-
| 0x000B0000
| 0x4
| 0xE
| CountryInfo
|-
| 0x000B0001
| 0x800
| 0xE
| Country name in UTF-16, every 0x80-bytes is an entry for each language, in the order of the Language table below (not all entries are set)
|-
| 0x000B0002
| 0x800
| 0xE
| State name in UTF-16, every 0x80-bytes is an entry for each language
|-
| 0x000B0003
| 0x4
| 0xE
| Coordinates. A pair of s16 represents latitude and longitude, respectively. One need to multiply both value by 180/32768 to get coordinates in degrees

|-
| 0x000C0000
| 0xC0
| 0xE
| [[#Parental Control Settings Block 0x000C0000|Parental Controls - Main data]]
|-
| 0x000C0001
| 0x14
| 0xE
| COPPACS restriction data
|-
| 0x000C0002
| 0x200
| 0xE
| [[#Parental Control Settings Block 0x000C0002|Parental Controls - Registered e-Mail address and custom secret question]]
|-
| 0x000D0000
| 0x4
| 0xE
| u16 at offset 0x0: [[SMDH#EULA_Version|EULA Version]] which was agreed to. u16 @ 0x02: latest version
|-
| 0x000E0000
| 0x1
| 0xE
| ? (related to SpotPass options in Internet Settings?)
|-
| 0x000F0000
| 0x10
| 0xC
| Debug configuration, read by [[NS]] on dev-units: on startup, NS does <code>svcKernelSetState(6, 1, (u64)debug_flags & 1);
svcKernelSetState(6, 2, (u64)debug_flags & 2);</code> (see [[SVC#KernelSetState|here]]) where <code>debug_flags</code> is the u32 located at offset 0xC in this struct. Then it compares the u32 from +8 in this config-block with the [[Configuration_Memory#APPMEMTYPE|APPMEMTYPE]]. When those don't match NS starts a FIRM-launch (with the same FIRM titleID as the currently running one) to boot into a FIRM with the APPMEMTYPE value from this config-block. The byte at offset 0x0 is related to the memtype as well.
|-
| 0x000F0001
| 0x8
| 0xC
| ?
|-
| 0x000F0003
| 0x1
| 0xC
| Home Menu button disable
|-
| 0x000F0004
| 0x4
| 0xC
| The first u8 is the System-Model [[Cfg:GetSystemModel|value]], the last 3-bytes are unknown
|-
| 0x000F0005
| 0x4
| 0xC
| The first u8 indicates whether network updates are enabled (however, NIM only checks this flag with developer [[Configuration_Memory#ENVINFO|ENVINFO]]).
|-
| 0x000F0006
| 0x28
| 0xC
| In NIM, taken as a (hopefully null terminated) string used for the "X-Device-Token" http header field for NPNS url.
|-
| 0x00100000
| 0x2
| 0xC
| TWL EULA info ({bool agreed; u8 agreedVersion})
|-
| 0x00100001
| 0x94
| 0xC
| Stores Parental Restrictions PIN/Secret Answer and other info for TWL mode
|-
| 0x00100002
| 0x1
| 0xC
| TWL country code
|-
| 0x00100003
| 0x10
| 0xC
| TWL movable unique ID, used for DSiWare exports
|-
| 0x00110000
| 0x4
| 0xC
| The low u16 indicates whether the system setup is required, such as when the system is booted for the first time or after doing a [[System Settings|System Format]]: 0 = setup required, non-zero = no setup required
|-
| 0x00110001
| 0x8
| 0xC
| TitleID of the menu to launch, used by [[NS]] on dev units (this block can be edited on dev units with [[3DS Development Unit Software#Config|Config]])
|-
| 0x00120000
| 0x8
| 0xC
| Volume Slider Bounds (Read by HID and PTM)
|-
| 0x00130000
| 0x4
| 0xE
| If response is 0x100 then debug mode is enabled.
|-
| 0x00150000
| 0x4
| 0xC
| Clock Sequence (u16) used for generating UUIDs in [[ACT_Services|ACT]].
|-
| 0x00150001
| 0x8
| 0xC
| ?
|-
| 0x00150002
| 0x4
| 0xE
| [[Friend_Services#Server_Types|NFS (Nintendo Friend Server) Environment]] in the format <code>%c%d</code>. Set by the [[ACT_Services|ACT]] sysmodule. Used in the [[NIM_Services#NIM|NIM]] sysmodule for making the NPNS URL.
|-
| 0x00160000
| 0x4
| 0xE
| Unknown, first byte is used by config service-cmd [[Config_Services|0x00070040]]. (Unknown whether the last 3-bytes are used)
|-
| 0x00170000
| 0x4
| 0xE
| Miiverse (OLV) access key
|-
| 0x00180000
| 0x4
| 0xC
| QTM Infrared LED related, can be 0 or 1
|-
| 0x00180001
| 0x18
| 0xC
| [[Hardware_calibration#QTM|QTM calibration data]]
|-
| 0x00190000
| 0x1
| 0xC
| Unknown. NFC-module checks for value1/non-value1.
|}

The developer unit TID block only exists on developer units.

===Stereo Display Settings===
All values are hard-coded in cfg module.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Value
! Description
|-
| 0x0
| 4
| 62.0f
|assumed pupillary distance in mm?
|-
| 0x4
| 4
| 289.0f
|assumed distance in mm between player's eyes and upper screen?
|-
| 0x8
| 4
| 76.80f
|width in mm of (old) 3DS upper screen (doesn't vary for different models?)
|-
| 0xC
| 4
| 46.08f
|height in mm of (old) 3DS upper screen (doesn't vary for different models?)
|-
| 0x10
| 4
| 10.0f
|
|-
| 0x14
| 4
| 5.0f
|
|-
| 0x18
| 4
| 55.58f
|
|-
| 0x1C
| 4
| 21.57f
|
|}

===Languages===
{| class="wikitable" border="1"
|-
! ID
! Description
|-
| 0
| JP
|-
| 1
| EN
|-
| 2
| FR
|-
| 3
| DE
|-
| 4
| IT
|-
| 5
| ES
|-
| 6
| ZH
|-
| 7
| KO
|-
| 8
| NL
|-
| 9
| PT
|-
| 10
| RU
|-
| 11
| TW
|}

===CountryInfo===
{| class="wikitable" border="1"
|-
! Byte
! Description
|-
| 0
|?
|-
| 1
|?
|-
| 2
| State/Province code.
|-
| 3
| Country code, same as DSi/Wii country codes. Value 0xFF is invalid.
|}

===User Name Block 0x000A0000===
{| class="wikitable" border="1"
|-
! Byte
! Description
|-
| 0x00-0x15
| User name (UTF-16)
|-
| 0x16-0x17
| u16 NGWord flag to denote that the user name is inappropriate
|-
| 0x18-0x1B
| u32 NGWord version the username was last checked with. If this value is less than the u32 stored in the NGWord CFA "romfs:/version.dat", the system then checks the username string with the bad-word list CFA again, then updates this field with the value from the CFA
|}

While the user name is NULL-terminated, the terminator is not applied when the user name is 10 characters long, which leads to online access breaking (002-0109) and buffer overflows when the user name is retrieved, even in DS games.

===WiFi Slot Structure===

====Network structure====
This is used twice in the actual WiFi slot structure.
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| Whether the network was set or not?
|-
| 0x1
| 0x1
| Whether to use this network strucutre to connect?
|-
| 0x2
| 0x1
| Whether this structure is the first (0) or the second (1) in the larger WiFi slot structure?
|-
| 0x3
| 0x1
| Padding ?
|-
| 0x4
| 0x20
| SSID of the network, without a trailing nullbyte.
|-
| 0x24
| 0x1
| Length of the SSID.
|-
| 0x25
| 0x1
| [[Nintendo_Zone#Beacon_payload_format|AP crypto key type]]
|-
| 0x26
| 0x2
| Padding ?
|-
| 0x28
| 0x40
| Plaintext of the passphrase of the network, without a trailing nullbyte.
|-
| 0x68
| 0x20
| PBKDF2 of the passphrase and SSID (http://jorisvr.nl/wpapsk.html).
|-
|}

====Actual structure====
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x2
| ?
|-
| 0x2
| 0x2
| [https://github.com/lammertb/libcrc/blob/v2.0/src/crc16.c#L43-L76 CRC-16 checksum] of the next 0x410 bytes.
|-
| 0x4
| 0x88
| First network structure. Only set if the network was set "normally", or was the last to be set using WPS during the session.
|-
| 0x8C
| 0x20
| Padding.
|-
| 0xAC
| 0x88
| Second network structure. Only set if the network was set using WPS, otherwise 0-filled.
|-
| 0x134
| 0x20C
| Padding.
|-
| 0x340
| 0x1
| Whether to automatically get the IP address (use DHCP) or not, defaults to 1.
|-
| 0x341
| 0x1
| Whether to automatically get the DNS or not, defaults to 1.
|-
| 0x342
| 0x2
| Padding ?
|-
| 0x344
| 0x4
| IP address, to use if 0x340 is false.
|-
| 0x348
| 0x4
| IP address of the gateway, to use if 0x340 is false.
|-
| 0x34C
| 0x4
| Subnetwork mask, to use if 0x340 is false.
|-
| 0x350
| 0x4
| IP address of the primary DNS , to use if 0x341 is false.
|-
| 0x354
| 0x4
| IP address of the secondary DNS, to use if 0x341 is false.
|-
| 0x358
| 0x4
| Always 0x01050000 ? Only set if the network was the last to be set during the session.
|-
| 0x35C
| 0x4
| IP address to use. Only set if the network was the last to be set during the session.
|-
| 0x360
| 0x6
| MAC address of the AP. Only set if the network was the last to be set during the session.
|-
| 0x366
| 0x1
| Channel. Only set if the network was the last to be set during the session.
|-
| 0x367
| 0x1
| Padding ? Only set if the network was the last to be set during the session.
|-
| 0x368
| 0x1
| Whether to use a proxy or not, defaults to 0.
|-
| 0x369
| 0x1
| Whether to use a basic authentication for the proxy, defaults to 0.
|-
| 0x36A
| 0x2
| Port to use for the proxy, defaults to 1.
|-
| 0x36C
| 0x30
| URL/address of the proxy, including a trailing nullbyte.
|-
| 0x39C
| 0x34
| Padding.
|-
| 0x3D0
| 0x20
| Username to use for basic authentication, including a trailing nullbyte.
|-
| 0x3F0
| 0x20
| Password to use for basic authentication, including a trailing nullbyte.
|-
| 0x410
| 0x2
| Padding ?
|-
| 0x412
| 0x2
| MTU value, defaults to 1400 and ranges between 576 and 1500, inclusive.
|-
| 0x414
| 0x7EC
| Padding.
|-
|}

===LCD display config===
There seems to be some sort of LCD display configuration stored in this cfg. When using the cfg-save from an Old3DS on a New3DS without formatting the cfg first, the bottom-screen display is somewhat off(which is fixed by formatting the cfg-save).

===Parental Control Settings Block 0x00100001===
{| class="wikitable" border="1"
|-
! Byte
! Size in bytes
! Description
|-
| 0x0
| 0xD
| Unknown.
|-
| 0xD
| 0x4
| PIN
|-
| 0x11
| 0x40
| Secret Answer (UTF-16)
|}

===Parental Control Settings Block 0x000C0000===
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x00
| 0x04
| [[#Parental Control Restriction Bitmask|Parental Control Restriction Bitmask]]
|-
| 0x04
| 0x04
| Unknown
|-
| 0x08
| 0x01
| Rating system used for configuration
|-
| 0x09
| 0x01
| Maximum allowed age (20 = No restriction)
|-
| 0x0A
| 0x01
| Secret Question Type (0-5: Pre-defined, 6: Custom)
|-
| 0x0B
| 0x01
| Unknown
|-
| 0x0C
| 0x08
| Parental Controls PIN code (with NULL-termination, although restricted to 4 digits)
|-
| 0x14
| 0x44
| Secret Answer (UTF-16)
|}

====Parental Control Restriction Bitmask====
{| class="wikitable" border="1"
|-
! Bit
! Restriction name
|-
| 0
| Global Parental Controls Enable
|-
| 1
| Internet Browser
|-
| 2
| Display of 3D Images (disabled on 2DS)
|-
| 3
| Sharing Images/Audio/Video/Long Text Data
|-
| 4
| Online Interaction
|-
| 5
| StreetPass
|-
| 6
| Friend Registration
|-
| 7
| DS Download Play
|-
| 8
| Nintendo 3DS Shopping Services (eShop / EC Applet)
|-
| 9
| View Distributed Videos
|-
| 10
| Miiverse (View)
|-
| 11
| Miiverse (Post)
|-
| 31
| "Child Online Privacy Protection" (see [[Cfg:GetRegionCanadaUSA|CFG:IsCoppacsSupported]])
|}

===Parental Control Settings Block 0x000C0002===
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0000
| 0x0001
| Boolean, whether an e-Mail has been registered
|-
| 0x0001
| 0x0101
| Registered e-Mail address (Plaintext)
|-
| 0x0102
| 0x0068
| Custom Secret Question (UTF-16)
|}

User talk:TimmSkiller

2025-12-26T13:56:02Z

TimmSkiller: Created page with "👋👋"

👋👋

User:TimmSkiller

2025-12-25T13:49:04Z

TimmSkiller: Created page with "👋"

👋

NCCH/Extended Header

2025-11-06T16:56:01Z

TimmSkiller: Use separate rows for Flag1 and Flag2 to avoid confusion

This page documents the format of the '''NCCH Extended Header''', or '''exheader''' for short.

The exheader has two sections:

* The actual exheader data, containing System Control Info (SCI) and Access Control Info (ACI);
* A signed copy of NCCH HDR public key, and exheader ACI. This version of the ACI is used as limitation to the actual ACI.

== Main Structure ==
All values are little endian unless otherwise specified.

See also: [https://github.com/3DSGuy/Project_CTR/blob/20f708450b9c6e7f64eafa6c2a8eeb25a630c69a/ctrtool/exheader.h]

{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| <code>0x0</code>
| <code>0x200</code>
| SCI
|-
| <code>0x200</code>
| <code>0x200</code>
| ACI
|-
| <code>0x400</code>
| <code>0x100</code>
| <code>AccessDesc</code> signature (RSA-2048-SHA256)
|-
| <code>0x500</code>
| <code>0x100</code>
| NCCH header RSA-2048 modulus
|-
| <code>0x600</code>
| <code>0x200</code>
| ACI (for limitation of first ACI)
|}

The <code>AccessDesc</code> signature covers the NCCH header modulus and second ACI. The <code>AccessDesc</code> public key is initialised by the boot ROM.

When loading the exheader, [[FIRM|Process9]] compares the exheader data with the data in the <code>AccessDesc</code> (note that not everything is compared here). When these don't match, an error is returned. The Process9 code handling this validation was updated with [[6.0.0-11|v6.0]]; the only change in this function seems to be the check for the "Ideal processor" field.

== System Control Info ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| <code>0x0</code>
| <code>0x8</code>
| Application title (default is "CtrApp")
|-
| <code>0x8</code>
| <code>0x5</code>
| Reserved
|-
| <code>0xD</code>
| <code>0x1</code>
| Flag (bit 0: <code>CompressExefsCode</code>, bit 1: <code>SDApplication</code>)
|-
| <code>0xE</code>
| <code>0x2</code>
| Remaster version
|-
| <code>0x10</code>
| <code>0xC</code>
| Text code set info
|-
| <code>0x1C</code>
| <code>0x4</code>
| Stack size
|-
| <code>0x20</code>
| <code>0xC</code>
| Read-only code set info
|-
| <code>0x2C</code>
| <code>0x4</code>
| Reserved
|-
| <code>0x30</code>
| <code>0xC</code>
| Data code set info
|-
| <code>0x3C</code>
| <code>0x4</code>
| BSS size
|-
| <code>0x40</code>
| <code>0x180</code> (<code>48*8</code>)
| Dependency [[Title list#00040130 - System Modules|module]] (program ID) list
|-
| <code>0x1C0</code>
| <code>0x40</code>
| <code>SystemInfo</code>
|}

Most of these fields are used in [[LOADER:LoadProcess]].

=== Code Set Info ===
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| <code>0x0</code>
| <code>4</code>
| Address
|-
| <code>0x4</code>
| <code>4</code>
| Physical region size (in page-multiples)
|-
| <code>0x8</code>
| <code>4</code>
| Size (in bytes)
|}

=== System Info ===
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| <code>0x0</code>
| <code>0x8</code>
| <code>SaveData</code> Size
|-
| <code>0x8</code>
| <code>0x8</code>
| Jump ID
|-
| <code>0x10</code>
| <code>0x30</code>
| Reserved
|}

== Access Control Info ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| <code>0x0</code>
| <code>0x170</code>
| [[#ARM11 Local System Capabilities|ARM11 local system capabilities]]
|-
| <code>0x170</code>
| <code>0x80</code>
| [[#ARM11 Kernel Capabilities|ARM11 kernel capabilities]]
|-
| <code>0x1F0</code>
| <code>0x10</code>
| [[#ARM9 Access Control|ARM9 access control]]
|}

=== ARM11 Local System Capabilities ===
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| <code>0x0</code>
| <code>0x8</code>
| Program ID
|-
| <code>0x8</code>
| <code>0x4</code>
| Core version (The Title ID low of the required [[FIRM]])
|-
| <code>0xC</code>
| <code>0x1</code>
| [[#Flag1|Flag1]] (implemented starting from [[8.0.0-18]])
|-
| <code>0xD</code>
| <code>0x1</code>
| [[#Flag2|Flag2]] (implemented starting from [[8.0.0-18]])
|-
| <code>0xE</code>
| <code>0x1</code>
| [[#Flag0|Flag0]]
|-
| <code>0xF</code>
| <code>0x1</code>
| Priority
|-
| <code>0x10</code>
| <code>0x20</code> (<code>16*2</code>)
| Resource limit descriptors. The first byte here controls the maximum allowed [[PMApp:SetAppResourceLimit|<code>CpuTime</code>]].
|-
| <code>0x30</code>
| <code>0x20</code>
| [[#Storage Info|Storage info]]
|-
| <code>0x50</code>
| <code>0x100</code> (<code>32*8</code>)
| [[#Service Access Control|Service access control]]
|-
| <code>0x150</code>
| <code>0x10</code> (<code>2*8</code>)
| Extended service access control, support for this was implemented with [[9.3.0-21|9.3.0-X]].
|-
| <code>0x160</code>
| <code>0xF</code>
| Reserved
|-
| <code>0x16F</code>
| <code>0x1</code>
| Resource limit category. (0 = <code>APPLICATION</code>, 1 = <code>SYS_APPLET</code>, 2 = <code>LIB_APPLET</code>, 3 = <code>OTHER</code> (sysmodules running under the BASE memregion))
|}

==== Flag0 ====
{| class="wikitable" border="1"
|-
! Bits
! Description
|-
| <code>0-1</code>
| Ideal processor
|-
| <code>2-3</code>
| Affinity mask
|-
| <code>4-7</code>
| Old3DS system mode
|}

===== Old3DS System Mode =====
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| <code>0</code>
| <code>Prod</code> (64MB of usable application memory)
|-
| <code>1</code>
| <code>Undefined</code> (unusable)
|-
| <code>2</code>
| <code>Dev1</code> (96MB of usable application memory)
|-
| <code>3</code>
| <code>Dev2</code> (80MB of usable application memory)
|-
| <code>4</code>
| <code>Dev3</code> (72MB of usable application memory)
|-
| <code>5</code>
| <code>Dev4</code> (32MB of usable application memory)
|-
| <code>6-7</code>
| <code>Undefined</code> Same as <code>Prod</code>?
|}

In the exheader data, the ideal processor field is a bit-index, while in the <code>AccessDesc</code> the ideal processor field is a bitmask. When the bit specified by the exheader field is not set in the <code>AccessDesc</code> field, an error is returned.

<pre>if((1 << exheaderval) & accessdescval == 0) return error</pre>

During a FIRM-launch when a <code>TitleInfo</code> structure was specified, the field at offset [[FIRM#FIRM_Launch_Parameters|0x400]] in the FIRM-launch parameters is set to the SystemMode of the specified title, however in some cases other values are written there. With [[8.0.0-18]] NS will now check the output of [[PTM|PTMSYSM]] command <code>0x040A0000</code>, when the output is non-zero and a certain NS state field is value-zero, the following is executed otherwise this is skipped. With that check passed on [[8.0.0-18]], NS will then check (<code>Flag2 & 0xF</code>). When that is <code>value2</code>, the output value (used for the FIRM-launcher parameter field mentioned above) is set to <code>value7</code>. Otherwise, when that value is non-zero, the output value is set to 6.

==== Flag1 ====
{| class="wikitable" border="1"
|-
! Bits
! Description
|-
| <code>0</code>
| <code>EnableL2Cache</code> (Unknown what this actually does, New3DS-only presumably)
|-
| <code>1</code>
| <code>cpuspeed_804MHz</code> (Default "cpuspeed" when not set)
|-
| <code>2-7</code>
| Unused
|}

In order for the exheader to have any of the above new bits set, the <code>AccessDesc</code> must have the corresponding bit set, otherwise the invalid-exheader error is returned.

Homebrew which runs under a title which has the above <code>cpuspeed</code> flag set, runs much faster on New3DS. It's unknown how exactly the system handles these flags.

When launching titles / perhaps other things with [[APT]], [[NS]] uses [[PTMSYSM:ConfigureNew3DSCPU]] with data which originally came from these flags; NS does this regardless of what the running 3DS system is. However, due to a bug(?) in NS the value sent to that command is always either 0x0 or 0x3. When calculating that value, the code only ever uses the cpuspeed field, not the cache field: code to actually load and check the value of the cache field appears to be missing.

==== Flag2 ====
{| class="wikitable" border="1"
|-
! Bit
! Description
|-
| <code>0-3</code>
| New3DS system mode
|-
| <code>4-7</code>
| Unused
|}

===== New3DS System Mode =====
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| <code>0</code>
| <code>Legacy</code> (use Old3DS system mode)
|-
| <code>1</code>
| <code>Prod</code> (124MB of usable application memory)
|-
| <code>2</code>
| <code>Dev1</code> (178MB of usable application memory)
|-
| <code>3</code>
| <code>Dev2</code> (124MB of usable application memory)
|-
| <code>4-7</code>
| <code>Undefined</code> Same as <code>Prod</code>?
|}

When in <code>Legacy</code> mode, the actual memory layout is the same as in <code>New3DS Prod</code>, except the available application memory as reported to the application is reduced to the Old3DS size.

The exheader value for the New3DS system mode value must be ≤ to the <code>AccessDesc</code> value, otherwise the invalid-exheader error is returned.

==== Storage Info ====
Used in [[FSReg:Register]].

{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| <code>0x0</code>
| <code>8</code>
| Extdata ID
|-
| <code>0x8</code>
| <code>8</code>
| System savedata IDs
|-
| <code>0x10</code>
| <code>8</code>
| Storage accessible unique IDs
|-
| <code>0x18</code>
| <code>7</code>
| Filesystem access info
|-
| <code>0x1F</code>
| <code>1</code>
| Other attributes
|}

File System Access Info:
{| class="wikitable" border="1"
|-
! Bit and bitmask
! Description
|-
| <code>0</code>, <code>0x1</code>
| Category system application
|-
| <code>1</code>, <code>0x2</code>
| Category hardware check
|-
| <code>2</code>, <code>0x4</code>
| Category filesystem tool
|-
| <code>3</code>, <code>0x8</code>
| Debug
|-
| <code>4</code>, <code>0x10</code>
| TWL card backup
|-
| <code>5</code>, <code>0x20</code>
| TWL NAND data
|-
| <code>6</code>, <code>0x40</code>
| BOSS
|-
| <code>7</code>, <code>0x80</code>
| [[FS:OpenArchive|<code>sdmc:/</code>]]
|-
| <code>8</code>, <code>0x100</code>
| Core
|-
| <code>9</code>, <code>0x200</code>
| [[Flash Filesystem|<code>nand:/ro/</code>]] (Read Only)
|-
| <code>10</code>, <code>0x400</code>
| [[Flash Filesystem|<code>nand:/rw/</code>]]
|-
| <code>11</code>, <code>0x800</code>
| [[Flash Filesystem|<code>nand:/ro/</code>]] (Write Access)
|-
| <code>12</code>, <code>0x1000</code>
| Category system settings
|-
| <code>13</code>, <code>0x2000</code>
| Cardboard
|-
| <code>14</code>, <code>0x4000</code>
| Export/Import IVS
|-
| <code>15</code>, <code>0x8000</code>
| [[FS:OpenArchive|<code>sdmc:/</code>]] (Write-only)
|-
| <code>16</code>, <code>0x10000</code>
| Switch cleanup (Introduced in [[3.0.0-5|3.0.0]]?)
|-
| <code>17</code>, <code>0x20000</code>
| Savedata move (Introduced in [[5.0.0-11|5.0.0]])
|-
| <code>18</code>, <code>0x40000</code>
| Shop (Introduced in [[5.0.0-11|5.0.0]])
|-
| <code>19</code>, <code>0x80000</code>
| Shell (Introduced in [[5.0.0-11|5.0.0]])
|-
| <code>20</code>, <code>0x100000</code>
| Category home menu (Introduced in [[6.0.0-11|6.0.0]])
|-
| <code>21</code>, <code>0x200000</code>
| Seed DB. Introduced in [[9.6.0-24|9.6.0-X]] [[FIRM]]. [[Home Menu]] has this bit set starting with [[9.6.0-24|9.6.0-X]].
|}

====Other Attributes====

{| class="wikitable" border="1"
|-
! Bit
! Description
|-
| <code>0</code>
| Not use ROMFS
|-
| <code>1</code>
| Use Extended savedata access.
|}

When Bit1 is set, the "Extdata ID" and "Storage Accessable Unique IDs" regions are used to store a total of 6 "Accessible Save IDs". Introduced in [[6.0.0-11|6.0.0]].

==== Service Access Control ====
This is the list of [[Services_API|services]] which the process is allowed to access, this is registered with the [[Services|services]] manager. Each service listed in the exheader must be listed in the <code>AccessDesc</code>, otherwise the invalid exheader error is returned. The order of the services for exheader/<code>AccessDesc</code> doesn't matter. The <code>AccessDesc</code> can list services which are not in the exheader, but normally the service-access-control data for exheader/<code>AccessDesc</code> are exactly the same.

This list is submitted to [[SRVPM:RegisterProcess]].

=== ARM11 Kernel Capabilities ===
The kernel capability descriptors are passed to [[SVC|svcCreateProcess]].

{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| <code>0x0</code>
| <code>0x70</code> (<code>28*4</code>)
| Descriptors
|-
| <code>0x70</code>
| <code>0x10</code>
| Reserved
|}

There are different descriptor types, determined by the number of leading ones in the binary value representation of bits 20-31. The different types are laid out as follows:

{| class="wikitable" border="1"
|-
! Pattern of bits 20-31
! Type
! Fields
|-
| <code>0b1110xxxxxxxx</code>
| Interrupt info
|
|-
| <code>0b11110xxxxxxx</code>
| System call mask
| Bits 24-26: System call mask table index; Bits 0-23: mask
|-
| <code>0b1111110xxxxx</code>
| Kernel release version
| Bits 8-15: Major version; Bits 0-7: Minor version
|-
| <code>0b11111110xxxx</code>
| Handle table size
| Bits 0-18: size
|-
| <code>0b111111110xxx</code>
| [[#ARM11_Kernel_Flags|Kernel flags]]
| See below
|-
| <code>0b11111111100x</code>
| Map IO/static address range
| Describes a memory mapping like the 0b111111111110 descriptor, but an entire range rather than a single page is mapped. Another 0b11111111100x descriptor must follow this one to denote the (exclusive) end of the address range to map. Bit20 on the first descriptor: map read-only (otherwise RW), bit20 on the second descriptor: map static (cacheable, otherwise IO if the bit is not set)
|-
| <code>0b111111111110</code>
| Map IO memory page
| Bits 0-19: page index to map (virtual address >> 12; the physical address is determined per-page according to [[Memory layout]]); Bit 20: Map read-only (otherwise read-write)
|}

==== ARM11 Kernel Flags ====
{| class="wikitable" border="1"
|-
! Bit
! Description
|-
| <code>0</code>
| Allow debug
|-
| <code>1</code>
| Force debug
|-
| <code>2</code>
| Allow non-alphanum
|-
| <code>3</code>
| Shared page writing
|-
| <code>4</code>
| Privilege priority
|-
| <code>5</code>
| Allow <code>main()</code> args
|-
| <code>6</code>
| Shared device memory
|-
| <code>7</code>
| Runnable on sleep
|-
| <code>8-11</code>
| Memory type (1: application, 2: system, 3: base)
|-
| <code>12</code>
| [[Memory_layout#NATIVE_FIRM.2FSAFE_MODE_FIRM_Userland_Memory|Special memory]]
|-
| <code>13</code>
| Process has access to CPU core 2 (New3DS only)
|}

=== ARM9 Access Control ===
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| <code>0x0</code>
| <code>15</code>
| Descriptors
|-
| <code>0xF</code>
| <code>1</code>
| ARM9 Descriptor Version. Originally this value had to be ≥ 2. Starting with [[9.3.0-21|9.3.0-X]] this value has to be either value 2 or value 3.
|}

Descriptors:
{| class="wikitable" border="1"
|-
! Bit
! Description
|-
| <code>0</code>
| Mount [[Flash Filesystem|<code>nand:/</code>]]
|-
| <code>1</code>
| Mount [[Flash Filesystem|<code>nand:/ro/</code>]] (Write Access)
|-
| <code>2</code>
| Mount [[Flash Filesystem|<code>twln:/</code>]]
|-
| <code>3</code>
| Mount [[Flash Filesystem|<code>wnand:/</code>]]
|-
| <code>4</code>
| Mount card SPI
|-
| <code>5</code>
| Use SDIF3
|-
| <code>6</code>
| Create seed
|-
| <code>7</code>
| Use card SPI
|-
| <code>8</code>
| SD application (Not checked)
|-
| <code>9</code>
| Mount [[SD Filesystem|sdmc:/]] (Write Access)
|}

GPIO Services

2025-09-15T09:50:55Z

TimmSkiller: /* GPIO Bits */

[[Category:Services]]
= GPIO Service Names =
{| class="wikitable" border="1"
|-
! Service name
! Permitted GPIO bitmasks
|-
| gpio:CDC
| 0x48
|-
| gpio:MCU
| 0x48020
|-
| gpio:HID
| 0x4301
|-
| gpio:NWM
| 0x40020
|-
| gpio:IR
| 0xEC0
|-
| gpio:NFC
| 0x13000
|-
| gpio:QTM
| 0x20000
|}

For the mapping between GPIO bitmasks and IRQs see: [[GPIO:BindInterrupt#Supported_values]].

The commands for these services are identical.

The input bitmask for each command is masked with the above permission bitmask, if the result is non-zero an error is occurred.

= GPIO Services =
{| class="wikitable" border="1"
|-
! Command Header
! Description
! Uses [[GPIO_Registers|GPIO Regs]]
|-
| 0x00010040
| u32 GetRegPart1(u32 mask)
| 0x10147010, 0x10147020
|-
| 0x00020080
| void SetRegPart1(u32 value, u32 mask)
| 0x10147010, 0x10147020
|-
| 0x00030040
| u32 GetRegPart2(u32 mask)
| 0x10147010, 0x10147024
|-
| 0x00040080
| u32 SetRegPart2(u32 value, u32 mask)
| 0x10147010, 0x10147024
|-
| 0x00050040
| u32 GetInterruptMask(u32 mask)
| 0x10147010, 0x10147024
|-
| 0x00060080
| void SetInterruptMask(u32 value, u32 mask)
| 0x10147010, 0x10147024
|-
| 0x00070040
| [[GPIO:GetGPIOData|GetGPIOData]]
| 0x10147000, 0x10147010, 0x10147014, 0x10147020, 0x10147028
|-
| 0x00080080
| [[GPIO:SetGPIOData|SetGPIOData]]
| 0x10147010, 0x10147014, 0x10147020, 0x10147028
|-
| 0x00090082
| [[GPIO:BindInterrupt|BindInterrupt]]
| None
|-
| 0x000A0042
| [[GPIO:UnbindInterrupt|UnbindInterrupt]]
| None
|}

=GPIO Bitmask=
The bitmask used by the service commands determines which bits in the GPIO registers to access. The output value from [[GPIO:GetGPIOData|GetGPIOData]] uses the same format as the bitmask: the values of bits in the output field are set to the value of GPIO data when those bits are set in the input bitmask.

{| class="wikitable" border="1"
|-
! Bits in the bitmask
! Register
! Bits from register
! Handled with [[GPIO:SetGPIOData]]
|-
| 0-2 (0x7)
| 0x10147000
| 0-2
| No
|-
| 3-4 (0x18)
| 0x10147010
| 0-1
| Yes
|-
| 5 (0x20)
| 0x10147014
| 0
| Yes
|-
| 6-17 (0x3FFC0)
| 0x10147020
| 0-11
| Yes
|-
| 18 (0x40000)
| 0x10147028
| 0
| Yes
|}

==GPIO Bits==
{| class="wikitable" border="1"
|-
! Bit
! Bitmask
! Accessible via GPIO service
! Used by
! Description
|-
| 0
| 0x1
| gpio:HID
| HID-sysmodule
| Used with [[HID_Shared_Memory|HID]] PAD state.
|-
| 1
| 0x2
| None
|
| Not known to be used by ''anything'', with the latest system-version at least.
|-
| 2
| 0x4
| None
|
| Not known to be used by ''anything'', with the latest system-version at least.
|-
| 3
| 0x8
| gpio:CDC
| ?
| ?
|-
| 4
| 0x10
| None
|
| Not known to be used by ''anything'', with the latest system-version at least.
|-
| 5
| 0x20
| gpio:MCU, gpio:NWM
| NWM-sysmodule, MCU-sysmodule
| WiFi mode. 0 = CTR, 1 = "MP" (DS WiFi?)
|-
| 6
| 0x40
| gpio:CDC, gpio:IR
| ?
| ?
|-
| 7
| 0x80
| gpio:IR
| Boot11
| ?
|-
| 8
| 0x100
| gpio:HID
| HID sysmodule
| Used with gyroscope
|-
| 9
| 0x200
| gpio:HID, gpio:IR
| HID-sysmodule and IR-sysmodule
| Unknown, used with ir:rst.
|-
| 10
| 0x400
| gpio:IR
| IR-sysmodule, Boot11
| IR [[IRU:SetIRLEDState|send]]. 1 = IR LED enable, 0 = IR LED disable.
|-
| 11
| 0x800
| gpio:IR
| IR-sysmodule
| IR [[IRU:GetIRLEDRecvState|receive]]
|-
| 12
| 0x1000
| gpio:NFC
| ?
| ?
|-
| 13
| 0x2000
| gpio:NFC
| ?
| ?
|-
| 14
| 0x4000
| gpio:HID
| HID-sysmodule
| Used with [[HID_Shared_Memory|HID]] PAD state.
|-
| 15
| 0x8000
| gpio:MCU
| MCU-sysmodule
| MCU Interrupt.
|-
| 16
| 0x10000
| gpio:NFC
| ?
| ?
|-
| 17
| 0x20000
| gpio:QTM
| ?
| ?
|-
| 18
| 0x40000
| gpio:MCU, gpio:NWM
| NWM-sysmodule, MCU-sysmodule
| Wifi enable. 1=Enabled, 0=Disabled.
|}

GPIO Services

2025-09-13T11:33:52Z

TimmSkiller: /* GPIO Bits */

[[Category:Services]]
= GPIO Service Names =
{| class="wikitable" border="1"
|-
! Service name
! Permitted GPIO bitmasks
|-
| gpio:CDC
| 0x48
|-
| gpio:MCU
| 0x48020
|-
| gpio:HID
| 0x4301
|-
| gpio:NWM
| 0x40020
|-
| gpio:IR
| 0xEC0
|-
| gpio:NFC
| 0x13000
|-
| gpio:QTM
| 0x20000
|}

For the mapping between GPIO bitmasks and IRQs see: [[GPIO:BindInterrupt#Supported_values]].

The commands for these services are identical.

The input bitmask for each command is masked with the above permission bitmask, if the result is non-zero an error is occurred.

= GPIO Services =
{| class="wikitable" border="1"
|-
! Command Header
! Description
! Uses [[GPIO_Registers|GPIO Regs]]
|-
| 0x00010040
| u32 GetRegPart1(u32 mask)
| 0x10147010, 0x10147020
|-
| 0x00020080
| void SetRegPart1(u32 value, u32 mask)
| 0x10147010, 0x10147020
|-
| 0x00030040
| u32 GetRegPart2(u32 mask)
| 0x10147010, 0x10147024
|-
| 0x00040080
| u32 SetRegPart2(u32 value, u32 mask)
| 0x10147010, 0x10147024
|-
| 0x00050040
| u32 GetInterruptMask(u32 mask)
| 0x10147010, 0x10147024
|-
| 0x00060080
| void SetInterruptMask(u32 value, u32 mask)
| 0x10147010, 0x10147024
|-
| 0x00070040
| [[GPIO:GetGPIOData|GetGPIOData]]
| 0x10147000, 0x10147010, 0x10147014, 0x10147020, 0x10147028
|-
| 0x00080080
| [[GPIO:SetGPIOData|SetGPIOData]]
| 0x10147010, 0x10147014, 0x10147020, 0x10147028
|-
| 0x00090082
| [[GPIO:BindInterrupt|BindInterrupt]]
| None
|-
| 0x000A0042
| [[GPIO:UnbindInterrupt|UnbindInterrupt]]
| None
|}

=GPIO Bitmask=
The bitmask used by the service commands determines which bits in the GPIO registers to access. The output value from [[GPIO:GetGPIOData|GetGPIOData]] uses the same format as the bitmask: the values of bits in the output field are set to the value of GPIO data when those bits are set in the input bitmask.

{| class="wikitable" border="1"
|-
! Bits in the bitmask
! Register
! Bits from register
! Handled with [[GPIO:SetGPIOData]]
|-
| 0-2 (0x7)
| 0x10147000
| 0-2
| No
|-
| 3-4 (0x18)
| 0x10147010
| 0-1
| Yes
|-
| 5 (0x20)
| 0x10147014
| 0
| Yes
|-
| 6-17 (0x3FFC0)
| 0x10147020
| 0-11
| Yes
|-
| 18 (0x40000)
| 0x10147028
| 0
| Yes
|}

==GPIO Bits==
{| class="wikitable" border="1"
|-
! Bit
! Bitmask
! Accessible via GPIO service
! Used by
! Description
|-
| 0
| 0x1
| gpio:HID
| HID-sysmodule
| Used with [[HID_Shared_Memory|HID]] PAD state.
|-
| 1
| 0x2
| None
|
| Not known to be used by ''anything'', with the latest system-version at least.
|-
| 2
| 0x4
| None
|
| Not known to be used by ''anything'', with the latest system-version at least.
|-
| 3
| 0x8
| gpio:CDC
| ?
| ?
|-
| 4
| 0x10
| None
|
| Not known to be used by ''anything'', with the latest system-version at least.
|-
| 5
| 0x20
| gpio:MCU, gpio:NWM
| ?
| ?
|-
| 6
| 0x40
| gpio:CDC, gpio:IR
| ?
| ?
|-
| 7
| 0x80
| gpio:IR
| Boot11
| ?
|-
| 8
| 0x100
| gpio:HID
| HID sysmodule
| Used with gyroscope
|-
| 9
| 0x200
| gpio:HID, gpio:IR
| HID-sysmodule and IR-sysmodule
| Unknown, used with ir:rst.
|-
| 10
| 0x400
| gpio:IR
| IR-sysmodule, Boot11
| IR [[IRU:SetIRLEDState|send]]. 1 = IR LED enable, 0 = IR LED disable.
|-
| 11
| 0x800
| gpio:IR
| IR-sysmodule
| IR [[IRU:GetIRLEDRecvState|receive]]
|-
| 12
| 0x1000
| gpio:NFC
| ?
| ?
|-
| 13
| 0x2000
| gpio:NFC
| ?
| ?
|-
| 14
| 0x4000
| gpio:HID
| HID-sysmodule
| Used with [[HID_Shared_Memory|HID]] PAD state.
|-
| 15
| 0x8000
| gpio:MCU
| MCU-sysmodule
| MCU Interrupt.
|-
| 16
| 0x10000
| gpio:NFC
| ?
| ?
|-
| 17
| 0x20000
| gpio:QTM
| ?
| ?
|-
| 18
| 0x40000
| gpio:MCU, gpio:NWM
| NWM-sysmodule
| Wifi enable. 1=Enabled, 0=Disabled.
|}

Title list

2025-08-18T14:37:11Z

TimmSkiller: Added missing EULA archive title ids

==== CTR Title List Notes ====
Reports/title-lists [https://yls8.mtheall.com/ninupdates/reports.php here] are automatically obtained from the system update SOAP.

== CTR System Titles ==
{| class="wikitable sortable" border="1"
|-
! Category Bit Mask
! Title Type
! Internal Description
! Bit Mask(s)
|-
| 0x0010
| Application
| SYSTEM_APPLICATION
| Normal<nowiki> | </nowiki>System
|-
| 0x001B
| System Data Archives
| SYSTEM_CONTENT
| Contents<nowiki> | </nowiki>CannotExecution<nowiki> | </nowiki>System
|-
| 0x009B
| Shared Data Archives
| SHARED_CONTENT
| Contents<nowiki> | </nowiki>CannotExecution<nowiki> | </nowiki>System<nowiki> | </nowiki>NotRequireRightForMount
|-
| 0x00DB
| System Data Archives
| AUTO_UPDATE_CONTENT
| Contents<nowiki> | </nowiki>CannotExecution<nowiki> | </nowiki>System<nowiki> | </nowiki>NotRequireUserApproval<nowiki> | </nowiki>NotRequireRightForMount
|-
| 0x0030
| Applet
| APPLET
| Normal<nowiki> | </nowiki>System<nowiki> | </nowiki>RequireBatchUpdate
|-
| 0x0130
| Module
| BASE
| Normal<nowiki> | </nowiki>System<nowiki> | </nowiki>RequireBatchUpdate<nowiki> | </nowiki>CanSkipConvertJumpId
|-
| 0x0138
| Firmware
| FIRMWARE
| Normal<nowiki> | </nowiki>CannotExecution<nowiki> | </nowiki>System<nowiki> | </nowiki>RequireBatchUpdate<nowiki> | </nowiki>CanSkipConvertJumpId
|}

=== 00040010 - System Applications ===
==== System Application Notes ====
System Application titles have a unique title low that varies by region.
Regardless of version, the ExeFS:/.code for mset is the same for USA/EUR/JPN.
The [[4.0.0-7]] version of mset([[4.1.0-8]] for TWN) has the same ExeFS:/.code for all regions(JPN, USA, EUR, CHN, KOR, TWN).
The [[5.0.0-11]] mset ExeFS:/.code is the same for all regions as well, except for CHN. The [[7.0.0-13]] mset ExeFS:/.code is unique for the following regions: CHN, KOR, and TWN.
A limited number of system-applications are included with gamecard-sysupdates. They are: [[System Settings]], [[Download Play]], SAFE_MODE [[System Settings#System Updater|System Updater]], and [[Nintendo 3DS Sound]] (this one was only in firms 3.0.0 - 6.2.0 inclusive).
The only system-applications included with the New3DS gamecard-sysupdate partition are: "menu" stub and "friend" stub.

{| class="wikitable sortable" border="1"
|-
! JPN TIDLow
! USA TIDLow
! EUR TIDLow
! CHN TIDLow
! KOR TIDLow
! TWN TIDLow
! [[Product code]]
! Description
! JPN Versions
! EUR Versions
! USA Versions
! CHN Versions
! KOR Versions
! TWN Versions
! Status
|-
| 00020000
| 00021000
| 00022000
| 00026000
| 00027000
| 00028000
| CTR-N-HAS?
| [[System Settings]] (mset)
| [[1.0.0-0|v0]], [[2.0.0-2|v1027]], [[3.0.0-5|v2060]], [[4.0.0-7|v3074]], [[5.0.0-11|v4097]], [[6.0.0-11|v5127]], [[7.0.0-13|v6157]], [[7.2.0-17|v7173]], [[8.1.0-0_New3DS|v8198]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v9224]], [[9.6.0-24|v10245]], [[10.6.0-31|v10256]], [[11.5.0-38|v11266]]
| [[1.0.0-0|v0]], [[2.0.0-2|v1027]], [[3.0.0-5|v2061]], [[4.0.0-7|v3075]], [[5.0.0-11|v4097]], [[6.0.0-11|v5127]], [[7.0.0-13|v6157]], [[7.2.0-17|v7174]], [[9.0.0-20|v8202]], [[9.6.0-24|v9220]], [[11.4.0-37|v10241]](New2DSXL), [[11.5.0-38|v10256]]
| [[1.0.0-0|v0]], [[2.0.0-2|v1027]], [[3.0.0-5|v2062]], [[4.0.0-7|v3078]], [[5.0.0-11|v4098]], [[6.0.0-11|v5128]], [[7.0.0-13|v6157]], [[7.2.0-17|v7174]], [[9.0.0-20|v8203]], [[9.6.0-24|v9221]], [[11.5.0-38|v10241]]
| [[4.0.0-7|v8]], [[4.4.0-10|v1024]](CHN-only sysupdate for just mset), [[5.0.0-11|v2049]], [[7.0.0-13|v3075]]
| [[4.0.0-7|v1026]], [[5.0.0-11|v2049]], [[7.0.0-13|v4098]]
| [[4.1.0-8|v8]], [[4.2.0-9|v1024]], [[5.0.0-11|v2050]], [[7.0.0-13|v3074]]
| Active
|-
| 00020100
| 00021100
| 00022100
| 00026100
| 00027100
| 00028100
| CTR-N-HDL?
| [[Download Play]] (dlplay)
| [[1.0.0-0|v0]], [[2.1.0-4|v1026]], [[4.0.0-7|v2051]], [[9.0.0-20|v3072]](Also for [[8.1.0-0_New3DS]])
| [[1.0.0-0|v0]], [[2.1.0-4|v1026]], [[4.0.0-7|v2051]], [[9.0.0-20|v3073]]
| [[1.0.0-0|v0]], [[2.1.0-4|v1026]], [[4.0.0-7|v2051]], [[9.0.0-20|v3073]]
| [[4.0.0-7|v4]]
| [[4.0.0-7|v1027]]
| [[4.1.0-8|v4]]
| Active
|-
| 00020200
| 00021200
| 00022200
| 00026200
| 00027200
| 00028200
| CTR-N-HMK?
| [[Activity Log]] (PLOG)
| [[1.0.0-0|v0]], [[2.0.0-2|v1026]], [[3.0.0-5|v2051]], [[10.6.0-31|v2080]]
| [[1.0.0-0|v0]], [[2.0.0-2|v1026]], [[3.0.0-5|v2054]], [[7.0.0-13|v2064]]
| Same as EUR
| [[4.0.0-7|v3]]
| [[4.0.0-7|v2]], [[7.0.0-13|v16]]
| [[4.1.0-8|v2]]
| Active
|-
| 00020300
| 00021300
| 00022300
| 00026300
| 00027300
| 00028300
| ?
| [[Health and Safety Information]] (safe)
| [[1.0.0-0|v0]], [[4.0.0-7|v1024]], [[6.0.0-11|v2050]]
| [[1.0.0-0|v0]], [[3.0.0-5|v1024]], [[4.0.0-7|v2050]], [[6.0.0-11|v3077]]
| [[1.0.0-0|v0]], [[4.0.0-7|v1026]], [[6.1.0-12U|v2051]]
| [[4.0.0-7|v5]]
| [[4.0.0-7|v2]]
| [[4.1.0-8|v5]]
| Active
|-
| 20020300
| 20021300
| 20022300
| N/A
| 20027300
| N/A
| CTR-N-HAC?
| [[New_3DS]] [[Health and Safety Information]] (ssafe)
| [[8.1.0-0_New3DS|v2]], [[9.3.0-21|v17]]
| [[8.1.0-0_New3DS|v1]], [[11.4.0-37|v16]](New2DSXL)
| Same as EUR.
| N/A
| [[9.6.0-24|v2]]
| N/A
| Active
|-
| 00020400
| 00021400
| 00022400
| 00026400
| 00027400
| 00028400
| CTR-N-HEP?
| [[Nintendo 3DS Camera]] (CtrApp)
| [[1.0.0-0|v0]], [[2.1.0-4|v16]], [[3.0.0-5|v1038]], [[4.0.0-7|v2048]], [[6.0.0-11|v3073]], [[9.0.0-20|v4097]](Also for [[8.1.0-0_New3DS]]), [[10.6.0-31|v4112]], [[11.5.0-38|v5120]]
| [[1.0.0-0|v0]], [[2.1.0-4|v16]], [[3.0.0-5|v1039]], [[4.0.0-7|v2048]], [[6.0.0-11|v3073]], [[7.0.0-13|v3088]], [[9.0.0-20|v4097]], [[11.4.0-37|v5120]](New2DSXL), [[11.5.0-38|v5120]]
| [[1.0.0-0|v0]], [[2.1.0-4|v16]], [[3.0.0-5|v1039]], [[4.0.0-7|v2048]], [[6.1.0-12U|v3074]], [[7.0.0-13|v3088]], [[9.0.0-20|v4097]], [[11.5.0-38|v5120]]
| [[4.0.0-7|v3]]
| [[4.0.0-7|v2]], [[7.0.0-13|v1040]]
| [[4.1.0-8|v3]]
| Active
|-
| 00020500
| 00021500
| 00022500
| 00026500
| 00027500
| 00028500
| CTR-N-HES?
| [[Nintendo 3DS Sound]] (CtrApp)
| [[1.0.0-0|v0]], [[2.1.0-4|v1027]], [[3.0.0-5|v2049]], [[4.0.0-7|v3072]], [[7.0.0-13|v3089]], [[11.4.0-37|v4096]]
| [[1.0.0-0|v0]], [[2.1.0-4|v1027]], [[3.0.0-5|v2049]], [[4.0.0-7|v3072]], [[7.0.0-13|v3088]], [[11.4.0-37|v4096]]
| [[1.0.0-0|v0]], [[2.1.0-4|v1027]], [[3.0.0-5|v2049]], [[4.0.0-7|v3072]], [[7.0.0-13|v3088]], [[11.4.0-37|v4096]]
| [[4.0.0-7|v2]], [[11.4.0-37|v1024]]
| [[4.0.0-7|v2]], [[7.0.0-13|v16]],[[11.4.0-37|v4096]]
| [[4.1.0-8|v3]], [[11.4.0-37|v1024]]
| Active
|-
| 00020700
| 00021700
| 00022700
| 00026700
| 00027700
| 00028700
| CTR-N-HED?
| [[Mii Maker]] (EDIT)
| [[1.0.0-0|v0]], [[2.0.0-2|v1026]], [[7.0.0-13|v2055]], [[10.6.0-31|v2064]]
| Same as JPN
| Same as JPN
| [[4.0.0-7|v1]]
| [[4.0.0-7|v1]], [[7.0.0-13|v16]]
| [[4.1.0-8|v2]]
| Active
|-
| 00020800
| 00021800
| 00022800
| 00026800
| 00027800
| 00028800
| CTR-N-HME?
| [[StreetPass Mii Plaza]] (MEET)
| [[1.0.0-0|v0]], v1027, [[2.1.0-4|v2048]], [[3.0.0-5|v3087]], [[3.0.0-6|v4096]], [[6.0.0-11|v5121]]
| [[1.0.0-0|v0]], v1027, [[2.1.0-4|v2048]], [[3.0.0-5|v3087]], [[3.0.0-6|v4096]], [[6.0.0-11|v5122]]
| [[1.0.0-0|v0]], v1027, [[2.1.0-4|v2048]], [[3.0.0-5|v3087]], [[3.0.0-6|v4096]], [[6.1.0-12U|v5124]], [[7.0.0-13|v5136]]
| [[4.0.0-7|v0]], [[4.4.0-10|v4096]]
| [[4.0.0-7|v1]], [[4.4.0-10|v4096]], [[7.0.0-13|v5120]]
| [[4.1.0-8|v1]], [[4.4.0-10|v4096]]
| Active
|-
| 00020900
| 00021900
| 00022900
| N/A
| 00027900
| 00028900
| CTR-N-HGR?
| [[eShop]] (tiger)
| [[2.0.0-2|v4]], [[2.1.0-3|v1026]], [[3.0.0-5|v2057]], [[4.0.0-7|v3081]], [[4.1.0-8|v4096]], [[4.2.0-9|v5123]], [[4.3.0-10|v6146]], [[5.0.0-11|v7169]], [[7.0.0-13|v8206]], [[7.1.0-14|v9231]], [[7.2.0-17|v10245]], [[8.0.0-18|v11265]], [[8.1.0-19|v12288]], [[9.0.0-20|v13320]], [[9.3.0-21|v15366]], [[9.5.0-22|v16384]], [[9.6.0-24|v17421]], [[9.7.0-25|v18432]], [[10.0.0-27|v19465]], [[10.4.0-29|v20483]], [[10.7.0-32|v21504]], [[11.3.0-36|v23552]], [[11.5.0-38|v25600]]
| [[2.0.0-2|v4]], [[2.1.0-3|v1026]], [[3.0.0-5|v2058]], [[4.0.0-7|v3081]], [[4.1.0-8|v4096]], [[4.2.0-9|v5123]], [[4.3.0-10|v6146]], [[5.0.0-11|v7171]], [[7.0.0-13|v8206]], [[7.1.0-14|v9231]], [[7.2.0-17|v10245]], [[8.0.0-18|v11265]], [[8.1.0-19|v12288]], [[9.0.0-20|v13320]], [[9.3.0-21|v15366]], [[9.5.0-22|v16384]], [[9.6.0-24|v17421]], [[9.7.0-25|v18432]], [[10.0.0-27|v19465]], [[10.4.0-29|v20482]], [[10.7.0-32|v21505]], [[11.2.0-35|v22528]], [[11.3.0-36|v23552]], [[11.4.0-37|v24576]](New2DSXL), [[11.5.0-38|v25600]]
| [[2.0.0-2|v4]], [[2.1.0-3|v1026]], [[3.0.0-5|v2058]], [[4.0.0-7|v3081]], [[4.1.0-8|v4096]], [[4.2.0-9|v5123]], [[4.3.0-10|v6146]], [[5.0.0-11|v7170]], [[7.0.0-13|v8206]], [[7.1.0-14|v9231]], [[7.2.0-17|v10246]], [[8.0.0-18|v11265]], [[8.1.0-19|v12288]], [[9.0.0-20|v13321]], [[9.3.0-21|v15366]], [[9.5.0-22|v16384]], [[9.6.0-24|v17422]], [[9.7.0-25|v18432]], [[10.0.0-27|v19465]], [[10.4.0-29|v20482]], [[10.7.0-32|v21506]], [[11.3.0-36|v23552]], [[11.5.0-38|v25600]]
| N/A
| [[4.0.0-7|v3082]], [[4.1.0-8|v4096]], [[4.2.0-9|v5123]], [[4.3.0-10|v6146]], [[5.0.0-11|v7169]], [[7.0.0-13|v8205]], [[7.1.0-14|v9231]], [[8.1.0-19|v12288]], [[9.0.0-20|v13320]], [[9.3.0-21|v15366]], [[9.5.0-22|v16384]], [[9.6.0-24|v17420]], [[9.7.0-25|v18432]], [[10.0.0-27|v19465]], [[10.4.0-29|v20482]]
| [[4.1.0-8|v4096]], [[4.2.0-9|v5123]], [[4.3.0-10|v6146]], [[5.0.0-11|v7170]], [[7.0.0-13|v8205]], [[7.1.0-14|v9231]], [[8.1.0-19|v12288]], [[9.3.0-21|v15366]], [[9.5.0-22|v16384]], [[9.6.0-24|v17421]], [[9.7.0-25|v18432]], [[10.0.0-27|v19465]]
| Active
|-
| 00020A00
| 00021A00
| 00022A00
| N/A
| 00027A00
| 00028A00
| CTR-N-HCB?
| [[System Transfer]] (CARDBOARD)
| [[2.0.0-2|v4]], [[3.0.0-5|v1035]], [[4.0.0-7|v2050]], [[5.0.0-11|v3074]], [[7.0.0-13|v4109]], [[9.0.0-20|v5130]], [[9.6.0-24|v6154]]
| [[2.0.0-2|v4]], [[3.0.0-5|v1035]], [[4.0.0-7|v2050]], [[5.0.0-11|v3073]], [[7.0.0-13|v4109]], [[9.0.0-20|v5131]], [[9.6.0-24|v6155]]
| [[2.0.0-2|v4]], [[3.0.0-5|v1035]], [[4.0.0-7|v2051]], [[5.0.0-11|v3073]], [[7.0.0-13|v4109]], [[9.0.0-20|v5131]], [[9.6.0-24|v6156]]
| N/A
| [[4.0.0-7|v2]], [[5.0.0-11|v1025]], [[7.0.0-13|v2061]], [[9.0.0-20|v3082]]
| [[4.1.0-8|v2]], [[5.0.0-11|v1025]], [[7.0.0-13|v2061]]
| Active
|-
| 00020B00
| 00021B00
| 00022B00
| N/A
| N/A
| N/A
| CTR-N-HMA?
| [[Nintendo Zone]] ("Nintendo") (MARS)
| [[1.0.0-0|v0]], [[3.0.0-5|v1034]]
| Same as JPN
| Same as JPN
| N/A
| N/A
| N/A
| Active
|-
| 00020D00
| 00021D00
| 00022D00
| 00026D00
| 00027D00
| 00028D00
| CTR-N-HCH?
| [[Face Raiders]]
| [[1.0.0-0|v0]], [[2.1.0-4|v1028]]
| [[1.0.0-0|v0]], [[2.1.0-4|v1028]], [[7.0.0-13|v1040]]
| Same as EUR
| [[4.0.0-7|v0]]
| [[4.0.0-7|v0]]
| [[4.1.0-8|v2]]
| Active
|-
| 20020D00
| 20021D00
| 20022D00
| N/A
| 20027D00
| N/A
| ?
| [[New_3DS]] [[Face Raiders]] (FACE)
| [[8.1.0-0_New3DS|v2050]]
| [[8.1.0-0_New3DS|v2049]]
| Same as EUR.
| N/A
| [[9.6.0-24|v2049]]
| N/A
| Active
|-
| 00020E00
| 00021E00
| 00022E00
| 00026E00
| 00027E00
| 00028E00
| CTR-N-HAR?
| [[AR Games]] (AR_ACT)
| [[1.0.0-0|v0]], [[2.1.0-4|v1026]]
| [[1.0.0-0|v0]], [[2.1.0-4|v1026]], [[7.0.0-13|v1040]]
| [[1.0.0-0|v0]], [[2.1.0-4|v1027]], [[7.0.0-13|v1040]]
| [[4.0.0-7|v0]]
| [[4.0.0-7|v0]], [[7.0.0-13|v16]]
| [[4.1.0-8|v1]]
| Active
|-
| 00020F00
| 00021F00
| 00022F00
| 00026F00
| 00027F00
| 00028F00
| CTR-N-HSH?
| SAFE_MODE [[System Settings#System Updater|System Updater]] (mset)
| [[1.0.0-0|v0]], [[3.0.0-5|v1024]], [[6.0.0-11|v2049]]
| [[1.0.0-0|v0]], [[3.0.0-5|v1024]], [[6.0.0-11|v2050]]
| Same as JPN
| [[4.0.0-7|v1]], [[6.0.0-11|v1026]]
| [[4.0.0-7|v1]]
| [[4.1.0-8|v1]]
| Active
|-
| 00023000
| 00024000
| 00025000
| N/A
| N/A
| N/A
| (Variable?)
| Promotional video
| [[1.1.0-1|v2]], [[2.0.0-2|v2048]]
| [[1.1.0-1|v0]], [[2.0.0-2|v2048]]
| [[1.1.0-1|v0]], [[2.0.0-2|v2048]]
| N/A
| N/A
| N/A
| Stubbed
|-
| 0002BF00
| 0002C000
| 0002C100
| N/A
| N/A
| N/A
| CTR-N-HAF?
| [[Nintendo Network ID Settings]] (act)
| [[7.0.0-13|v14]], [[7.2.0-17|v1029]], [[9.0.0-20|v2051]], [[9.3.0-21|v3072]]
| Same as JPN
| Same as JPN
| N/A
| N/A
| N/A
| Active
|-
| 20023100
| 20024100
| 20025100
| N/A
| N/A
| N/A
| CTR-N-HAJ?
| [[microSD Management]] ('mcopy') ([[New_3DS]]-only)
| [[8.1.0-0_New3DS|v8]], [[9.0.0-20|v1024]]
| [[8.1.0-0_New3DS|v4]]
| [[8.1.0-0_New3DS|v5]]
| N/A
| N/A
| N/A
| Available
|-
| 2002C800
| 2002CF00
| 2002D000
| N/A
| 2002D700
| N/A
| CTR-P-CTAP
| [[New_3DS]] HOME menu digital manual
| [[8.1.0-0_New3DS|v2]], [[9.0.0-20|v18]], [[9.3.0-21|v34]], [[9.6.0-24|v50]]
| [[8.1.0-0_New3DS|v1]], [[9.3.0-21|v17]], [[9.6.0-24|v34]], [[11.4.0-37|v48]](New2DSXL)
| [[8.1.0-0_New3DS|v1]], [[9.3.0-21|v18]], [[9.6.0-24|v33]]
| N/A
| [[9.6.0-24|v2]]
| N/A
| Stubbed
|-
| 2002C900
| 2002D100
| 2002D200
| N/A
| 2002D800
| N/A
| CTR-P-CTAP
| [[New_3DS]] Friends list digital manual
| [[8.1.0-0_New3DS|v1]]
| Same as JPN.
| [[8.1.0-0_New3DS|v0]], [[9.3.0-21|v16]]
| N/A
| [[9.6.0-24|v2]]
| N/A
| Stubbed
|-
| 2002CA00
| 2002D300
| 2002D400
| N/A
| 2002D900
| N/A
| CTR-P-CTAP
| [[New_3DS]] Notifications digital manual
| [[8.1.0-0_New3DS|v0]], v1([[Home_Menu|JPN-only]] Oct 2, 2014 "sysupdate", actually uploaded on 09-29-14. Identical to v0, same TMDs besides title-versions)
| [[8.1.0-0_New3DS|v2]]
| [[8.1.0-0_New3DS|v0]]
| N/A
| [[9.6.0-24|v2]]
| N/A
| Stubbed
|-
| 2002CB00
| 2002D500
| 2002D600
| N/A
| 2002DA00
| N/A
| CTR-P-CTAP
| [[New_3DS]] Game Notes digital manual
| [[8.1.0-0_New3DS|v0]], [[9.0.0-20|v1]]
| [[8.1.0-0_New3DS|v2]]
| Same as EUR.
| N/A
| [[9.6.0-24|v1]]
| N/A
| Stubbed
|}

=== 0004001B - [[NCCH#CFA|System Data Archives]] ===
{| class="wikitable sortable" border="1"
|-
! TitleID Low
! Description
! Versions
|-
| 00010002
| [[ClCertA]]
| [[1.0.0-0|v0]]
|-
| 00010702
| [[NS CFA]]
| [[3.0.0-5|v0]], [[6.0.0-11|v1028]], [[6.3.0-12|v2048]], [[7.0.0-13|v3073]], [[9.0.0-20|v4096]](also for [[8.1.0-0_New3DS]])
|-
| 00010802
| This CFA only contains a 1-byte "dummy.txt" in the RomFS, which contains '0'.
| [[6.3.0-12|v0]], [[9.5.0-23|v1024]], [[10.5.0-30|v2048]], [[11.0.0-33|v3072]]
|-
| 00018002
| Same contents as 00010802. Starting with [[7.1.0-15]], the "dummy.txt" file was removed from RomFS: this CFA RomFS now contains web-browser data(similar to 00018102) for NNID / networking, etc.
| [[7.0.0-13|v14]], [[7.1.0-15|v1025]], [[7.2.0-17|v2055]], [[9.0.0-20|v3078]], [[9.3.0-21|v4096]], [[9.6.0-24|v5120]]
|-
| 00018102
| This contains local web-browser data(html/js, gfx, etc) for the Miiverse Offline-mode.
| [[7.0.0-13|v11]], [[9.0.0-20|v1025]](also for [[8.1.0-0_New3DS]])
|-
| 00018202
| This contains the webkit/OSS [[CRO0|CROs]] used with the Miiverse applet and the "act" application.
| [[7.0.0-13|v7]], [[8.1.0-0_New3DS|v1026]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v2050]]
|-
| 00019002
| [[Fangate_updater]]
| [[9.3.0-21|v2]], [[9.6.0-24|v1026]]
|}

=== 00040030 - System Applets===
==== System Applet Notes ====
Most of these processes are applets, see [[NS_and_APT_Services|here]] for details.
All of the below processes use the "SYSTEM" [[SVC|memory-region]].
The ExeFS for Home Menu is exactly the same for USA/EUR/JPN.
The Miiverse applet seems to use a web browser with webkit.

{| class="wikitable sortable" border="1"
|-
! JPN TitleIDLow
! USA TitleIDLow
! EUR TitleIDLow
! CHN TitleIDLow
! KOR TitleIDLow
! TWN TitleIDLow
! [[Product code]]
! Description
! JPN Versions
! USA Versions
! EUR Versions
|-
|colspan=6 align=center| 00008102
| CTR-P-CTAP
| [[NS#Alternate menu|Test Menu]] (Demo1)
|colspan=3 align=center| ..., v64, ..., v27648
|-
| 00008202
| 00008F02
| 00009802
| 0000A102
| 0000A902
| 0000B102
| CTR-P-HMM?
| [[Home Menu]] (menu)
| [[1.0.0-0|v0]], [[2.0.0-2|v1027]], [[2.1.0-3|v2049]], [[2.2.0-X|v3075]], [[3.0.0-5|v4111]], [[4.0.0-7|v5131]], [[4.2.0-9|v6146]], [[5.0.0-11|v7172]], [[6.0.0-11|v8198]], [[7.0.0-13|v9230]], [[8.1.0-0_New3DS|v10250]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v13313]], [[9.1.0-20J|v14336]], [[9.2.0-20|v15360]], [[9.3.0-21|v16402]], [[9.4.0-21|v17408]], [[9.5.0-22|v18432]], [[9.6.0-24|v19476]], [[9.7.0-25|v20487]], [[9.8.0-25|v22528]], [[10.1.0-27|v23552]], [[10.2.0-28|v24576]], [[10.3.0-28|v25600]], [[10.4.0-29|v26626]], [[10.6.0-31|v27648]], [[11.1.0-34|v28672]], [[11.3.0-36|v29696]], [[11.5.0-38|v30721]]
| [[1.0.0-0|v0]], [[2.0.0-2|v1027]], [[2.1.0-3|v2049]], [[2.2.0-X|v3075]], [[3.0.0-5|v4111]], [[4.0.0-7|v5131]], [[4.2.0-9|v6146]], [[5.0.0-11|v7172]], [[6.0.0-11|v8198]], [[7.0.0-13|v9230]], [[9.0.0-20|v11272]], [[9.2.0-20|v12288]], [[9.3.0-21|v13330]], [[9.4.0-21|v14336]], [[9.5.0-22|v15360]], [[9.6.0-24|v16404]], [[9.7.0-25|v17415]], [[9.8.0-25|v19456]], [[9.9.0-26|v20480]], [[10.1.0-27|v21504]], [[10.2.0-28|v22528]], [[10.3.0-28|v23552]], [[10.4.0-29|v24578]], [[10.6.0-31|v25600]], [[11.1.0-34|v26624]], [[11.3.0-36|v27648]], [[11.5.0-38|v28673]], [[11.17.0-50|v30720]]
| [[1.0.0-0|v0]], [[2.0.0-2|v1027]], [[2.1.0-3|v2049]], [[2.2.0-X|v3075]], [[3.0.0-5|v4111]], [[4.0.0-7|v5131]], [[4.2.0-9|v6146]], [[5.0.0-11|v7172]], [[6.0.0-11|v8198]], [[7.0.0-13|v9230]], [[9.0.0-20|v11272]], [[9.2.0-20|v12288]], [[9.3.0-21|v13330]], [[9.4.0-21|v14336]], [[9.5.0-22|v15360]], [[9.6.0-24|v16404]], [[9.7.0-25|v17415]], [[9.8.0-25|v19456]], [[10.1.0-27|v20480]], [[10.2.0-28|v21504]], [[10.3.0-28|v22528]], [[10.4.0-29|v23554]], [[10.6.0-31|v24576]], [[11.1.0-34|v25600]], [[11.3.0-36|v26624]], [[11.4.0-37|v27649]](New2DSXL), [[11.5.0-38|v27649]]
|-
| 00008402
| 00009002
| 00009902
| 0000A202
| 0000AA02
| 0000B202
| CTR-N-HCS?
| Camera applet used by Home-menu (CtrApp)
|colspan=3| v0, v1036, [[9.0.0-20|v2049]](Also for [[8.1.0-0_New3DS]])
|-
| 00008502
| 00009102
| 00009A02
| ?
| ?
| ?
| ?
| Not available on CDN
| ?
| ?
| ?
|-
| 00008602
| 00009202
| 00009B02
| 0000A402
| 0000AC02
| 0000B402
| CTR-N-HMV?
| Instruction Manual, applet for displaying instruction manuals
|colspan=3| v0, v1026, v2048, v3072, [[5.0.0-11|v4097]], [[9.0.0-20|v5120]](Also for [[8.1.0-0_New3DS]])
|-
| 00008702
| 00009302
| 00009C02
| 0000A502
| 0000AD02
| 0000B502
| CTR-N-HGM?
| Game Notes (Cherry)
|colspan=3| v0, v1026, v2049, [[5.0.0-11|v3073]], [[9.0.0-20|v4096]](Also for [[8.1.0-0_New3DS]])
|-
| 00008802
| 00009402
| 00009D02
| 0000A602
| 0000AE02
| 0000B602
|
| [[Internet Browser]] (spider)
|colspan=3| [[2.0.0-2|v6]], [[2.1.0-4|v1024]], [[4.0.0-7|v2050]], [[5.0.0-11|v3074 (EUR)/v3075(USA,JAP)]], [[7.0.0-13|v3088]], [[7.1.0-16|v4096]], [[9.5.0-23|v5121]], [[9.9.0-26|v6149]], [[10.2.0-28|v7168]], [[10.6.0-31|v8192]], [[10.7.0-32|v9232]], [[11.1.0-34|v10240]], [[11.9.0-42|v11297]]
|-
| 20008802
| 20009402
| 20009D02
| ?
| 2000AE02
| N/A
| CTR-N-HBR?
| [[New 3DS]] [[Internet Browser]] (SKATER)
|colspan=3| [[8.1.0-0_New3DS|v10]], [[9.3.0-21|v1027]], [[9.6.0-24|v2051]], [[9.9.0-26|v3077]], [[10.2.0-28|v4096]], [[10.4.0-29|v5121]], [[10.6.0-31|v6144]], [[10.7.0-32|v7184]], [[11.1.0-34|v8192]], [[11.9.0-42|v10272]]
|-
|colspan=6| 00008A02
|
| Fatal error viewer ([[ErrDisp]])
|colspan=3| v0, v1025, [[2.2.0-X|v2048]], [[3.0.0-5|v3072]], [[4.0.0-7|v4096]], [[5.0.0-11|v5121]], [[8.0.0-18|v6144]], [[9.0.0-20|v7168]](Also for [[8.1.0-0_New3DS]])
|-
|colspan=6| 00008A03
|
| SAFE_MODE [[ErrDisp]]
|colspan=3| v0
|-
| 20008A03
| 20008A03
| 20008A03
| ?
| 20008A03
| N/A
|
| [[New_3DS]] SAFE_MODE [[ErrDisp]]
|colspan=3| [[8.1.0-0_New3DS|v7169]]
|-
| 00008D02
| 00009602
| 00009F02
| 0000A702
| 0000AF02
| 0000B702
| CTR-N-HFR?
| Friend List (friend)
|colspan=3| v0, v1026, [[2.2.0-X|v2051]], v3082, v4099, [[7.0.0-13|v5120]], [[9.0.0-20|v6144]](Also for [[8.1.0-0_New3DS]]) (EUR v6, v1024, v3082, v4099, [[7.0.0-13|v5120]], [[9.0.0-20|v6144]])
|-
| 00008E02
| 00009702
| 0000A002
| 0000A802
| 0000B002
| 0000B802
| CTR-N-HCR?
| Notifications (newslist)
|colspan=3| v0, v1029, v2054, v3075, [[9.0.0-20|v4097]] (EUR v6, v1024, v2054, v3075, [[9.0.0-20|v4097]]) (JPN: ..., [[8.1.0-0_New3DS|v4096]], [[9.0.0-20|v5121]])
|-
| 0000C002
| 0000C802
| 0000D002
| 0000D802
| 0000DE02
| 0000E402
| CTR-N-HKY?
| Software Keyboard (swkbd)
|colspan=3| v0, v1026, v2053, [[7.0.0-13|v3072]], [[9.0.0-20|v4096]](Also for [[8.1.0-0_New3DS]])
|-
| 0000C003
| 0000C803
| 0000D003
| 0000D803
| 0000DE03
| 0000E403
|
| SAFE_MODE Software Keyboard (swkbd)
|colspan=3| v0
|-
| 2000C003
| 2000C803
| 2000D003
| ?
| 2000DE03
| N/A
|
| [[New 3DS]] SAFE_MODE Software Keyboard (swkbd)
| [[8.1.0-0_New3DS|v1024]]
|colspan=2|[[9.0.0-20|v0]]
|-
| 0000C102
| 0000C902
| 0000D102
| 0000D902
| 0000DF02
| 0000E502
| CTR-N-HMS?
| Mii picker (appletEd)
|colspan=3| v0, v1026, [[9.0.0-20|v2048]](Also for [[8.1.0-0_New3DS]]), [[9.3.0-21|v3077]]
|-
| 0000C302
| 0000CB02
| 0000D302
| 0000DB02
| 0000E102
| 0000E702
| CTR-N-HCC?
| Picture picker (PNOTE_AP)
|colspan=3| v0, v1024, [[8.1.0-0_New3DS|v2049]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v3075]], [[9.3.0-21|v4096]]
|-
| 0000C402
| 0000CC02
| 0000D402
| 0000DC02
| 0000E202
| 0000E802
| CTR-N-HMC?
| [[Nintendo 3DS Sound|Voice memo]] picker (SNOTE_AP)
|colspan=3| v0, v3, [[8.0.0-18|v1026]], [[9.0.0-20|v2048]](Also for [[8.1.0-0_New3DS]])
|-
|colspan=3| 0000C502
|colspan=3| 0000CF02
| CTR-N-HEEA
CTR-N-HEEK
| Non-critical (online, etc) error display (error)
|colspan=3| v0, v1026, v2053, v3074, [[8.1.0-0_New3DS|v4096]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v5128]], [[9.6.0-24|v6145]]
|-
|colspan=3| 0000C503
|colspan=3| 0000CF03
|
| SAFE_MODE error applet
|colspan=3| v0
|-
| 2000C503
| 2000C503
| 2000C503
| ?
| 2000CF03
| N/A
|
| [[New 3DS]] SAFE_MODE error applet
|colspan=3| [[8.1.0-0_New3DS|v1024]]
|-
|colspan=3| 0000CD02
|colspan=3| 0000D502
| CTR-N-HADA
CTR-N-HADK
| [[Circle Pad Pro]] test/calibration applet (extrapad)
|colspan=3| v1, v1026, [[8.1.0-0_New3DS|v2048]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v3073]], [[11.4.0-37|v4097]](New2DSXL), [[11.5.0-38|v4097]]
|-
| 0000C602
| 0000CE02
| 0000D602
| N/A
| 0000E302
| 0000E902
| CTR-N-HAA?
| eShop applet, used by applications for accessing the eShop, for DLC/etc. Also used by the eShop application itself. (mint)
|colspan=3| v5, v1028, [[4.2.0-9|v2050]], [[5.0.0-11|v3072]], [[7.0.0-13|v4109]], [[7.2.0-17|v5125]](v5123 for JPN), [[8.0.0-18|v6145]], [[8.1.0-0_New3DS|v7168]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v8200]], [[9.3.0-21|v9224]], [[9.6.0-24|v10247]], [[9.8.0-25|v11264]], [[10.0.0-27|v12293]], [[10.1.0-27|v13312]], [[10.3.0-28|v14337]], [[10.4.0-29|v15360]], [[10.7.0-32|v16384]], [[11.2.0-35|v17408]](EUR), [[11.3.0-36|v18432]], [[11.5.0-38|v19457]]
|-
| 0000BC02
| 0000BD02
| 0000BE02
| ?
| N/A
| ?
| CTR-N-HAE?
| Miiverse (olv)
|colspan=3| [[7.0.0-13|v14]], [[7.2.0-17|v1024]], [[9.0.0-20|v2048]](Also for [[8.1.0-0_New3DS]]), [[9.3.0-21|v3072]], [[9.6.0-24|v4096]]
|-
|colspan=3| 0000F602
| ?
| N/A
| ?
| CTR-N-HAGA
| Likely the "system library" for Miiverse (memolib)
|colspan=3| [[7.0.0-13|v5]], [[8.1.0-0_New3DS|v1024]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v2050]], [[9.3.0-21|v3072]]
|-
| 00008302
| 00008B02
| 0000BA02
| ?
| N/A
| ?
| CTR-N-HAH?
| In-app Miiverse-posting applet (solv3)
|colspan=3| [[9.0.0-20|v6]]
|-
| 00009502
| 00009E02
| 0000B902
| ?
| 00008C02
| 0000BF02
| CTR-N-HA3?
| Cabinet ([[amiibo Settings]])
|colspan=3| [[9.3.0-21|v7]], (v1024 for TWN), [[9.6.0-24|v1031]]
|}

=== 0004009B - [[NCCH#CFA|Shared Data Archives]] ===
{| class="wikitable sortable" border="1"
|-
! JPN TitleIDLow
! USA TitleIDLow
! EUR TitleIDLow
! CHN TitleIDLow
! KOR TitleIDLow
! TWN TitleIDLow
! Description
! Versions
|-
| 00010202
| 00010202
| 00010202
| 00010202
| 00010202
| 00010202
| Probably Mii-related, contains "CFL_Res.dat" in the RomFS.
| v0
|-
| 00010402
| 00010402
| 00010402
| 00010402
| 00010402
| 00010402
| Region Manifest. Mounted as "area:"
| v0, v1024, v2050, v3072, [[7.0.0-13|v4098]], [[9.6.0-24|v5122]]
|-
| 00010602
| 00010602
| 00010602
| 00010602
| 00010602
| 00010602
| Non-Nintendo TLS Root-CA Certificates (RomFS contains files with filename "CACERT_PUBLIC_CA_<val>.der", where <val> is 5..8)
| v2, [[10.5.0-30|v1024]]
|-
|
|
|
| 00011002
|
|
| "CHN/CN" Dictionary.
| v1
|-
|
|
|
|
|
| 00011102
| "TWN/TN" dictionary.
| v1
|-
|
|
| 00011202
|
|
|
| "NL/NL" dictionary.
| v0
|-
|
|
| 00011302
|
|
|
| "EN/GB" dictionary.
| v0
|-
|
| 00011402
|
|
|
|
| "EN/US" dictionary.
| v0
|-
|
|
| 00011502
|
|
|
| "FR/FR/regular" dictionary.
| v0
|-
|
| 00011602
|
|
|
|
| "FR/CA/regular" dictionary.
| v0
|-
|
|
| 00011702
|
|
|
| "DE/regular" dictionary.
| v0
|-
|
|
| 00011802
|
|
|
| "IT/IT" dictionary.
| v0
|-
| 00011902
|
|
|
|
|
| "JA_small/32" dictionary.
| v0
|-
|
|
|
|
| 00011A02
|
| "KO/KO" dictionary.
| v1
|-
|
|
| 00011B02
|
|
|
| "PT/PT/regular" dictionary.
| v0
|-
|
|
| 00011C02
|
|
|
| "RU/regular" dictionary.
| v0
|-
|
| 00011D02
| 00011D02
|
|
|
| "ES/ES" dictionary.
| v0
|-
|
| 00011E02
|
|
|
|
| "PT/BR/regular" dictionary.
| v0
|-
| 00012202
| 00012302
| 00012102
| 00012402
| 00012502
| 00012602
| ?contains a lists with error strings
| v1026, v2053, v3073, [[4.2.0-9|v4096]], [[5.0.0-11|v5120]], [[7.0.0-13|v6149]], [[7.2.0-17|v7168]], [[8.0.0-18|v8192]], [[9.0.0-20|v9218]], [[9.3.0-21|v10242]], [[9.6.0-24|v11269]], [[10.0.0-27|v12289]], [[10.4.0-29|v13312]], [[10.7.0-32|v13313]] (JPN: [[11.1.0-34|v14336]]) (KOR: [[9.6.0-24|v6148]], [[10.0.0-27|v7169]], [[10.3.0-28|v8193]], [[10.4.0-29|v9216]], [[11.1.0-34|v10240]])
|-
| 00013202
| 00013302
| 00013102
| 00013402
| 00013502
| 00013602
| Mounted as "eula:"
| v0, v1024, v2049 USA: v1024, v2051, [[7.0.0-13|v3074]], [[7.2.0-17|v4100]](EUR-only), [[9.0.0-20|v4099]], [[9.9.0-26|v6144]], [[10.4.0-29|v7168]] (KOR: [[9.7.0-25|v1025]])
|-
| 00014002
| 00014002
| 00014002
| 00014002
| 00014002
| 00014002
| JPN/EUR/USA [[System Font]] ("font:")
| v0
|-
| 00014102
| 00014102
| 00014102
| 00014102
| 00014102
| 00014102
| CHN [[System Font]] ("font:")
| v0, v1024
|-
| 00014202
| 00014202
| 00014202
| 00014202
| 00014202
| 00014202
| KOR [[System Font]] ("font:")
| v0, v1024
|-
| 00014302
| 00014302
| 00014302
| 00014302
| 00014302
| 00014302
| TWN [[System Font]] ("font:")
| v0, v1024
|-
| 00015202
| 00015302
| 00015102
| N/A
| 00015502
| 0015602
| Mounted as "rate:"
| v0 (EUR: v0, v1024) (KOR: v1024)
|}

=== 000400DB - [[NCCH#CFA|System Data Archives]] ===
==== System Data Archive Notes ====
These [[NVer]] titleIDs can be found @ offset 0x320 in every [[CCI]].

{| class="wikitable sortable" border="1"
|-
! JPN TitleIDLow
! USA TitleIDLow
! EUR TitleIDLow
! CHN TitleIDLow
! KOR TitleIDLow
! TWN TitleIDLow
! Description
! USA/EUR/JPN Versions
! CHN Versions
! TWN Versions
! KOR Versions
|-
| 00010302
| 00010302
| 00010302
| 00010302
| 00010302
| 00010302
| NGWord bad word list
|colspan=4| [[1.0.0-0|v0]], [[2.0.0-2|v1024]], [[3.0.0-5|v2052]], [[4.0.0-7|v3072]], [[4.3.0-10|v4096]], [[5.0.0-11|v5120]], [[9.0.0-20|v6144]], [[9.3.0-21|v7168]], [[9.6.0-24|v8192]], [[11.1.0-34|v9217]]
|-
| 00010502
| 00010502
| 00010502
| 00010502
| 00010502
| 00010502
| [[Nintendo Zone]] hotspot list
|colspan=4| [[1.0.0-0|v0]], [[2.0.0-2|v1024]], [[3.0.0-5|v2048]], [[4.0.0-7|v3073]], [[4.3.0-10|v4096]], [[4.4.0-10|v5120]], [[4.5.0-10|v6144]], [[5.0.0-11|v7169]], [[6.0.0-11|v8192]], [[6.2.0-12|v9216]], [[7.0.0-13|v10242]], [[7.2.0-17|v11267]], [[8.0.0-18|v12288]], [[9.0.0-20|v14336]], [[9.3.0-21|v15360]], [[9.6.0-24|v16386]], [[10.0.0-27|v17409]], [[10.4.0-29|v18432]], [[11.1.0-34|v19457]], [[11.5.0-38|v20480]], [[11.9.0-42|v22528]]
|-
| 00016202
| 00016302
| 00016102
| 00016402
| 00016502
| 00016602
| [[NVer]]
| [[1.0.0-0|v0]], [[1.1.0-1|v16]], [[2.0.0-2|v32]], [[2.1.0-3|v48]], [[2.1.0-4|v64]], [[3.0.0-5|v80]], [[3.0.0-6|v96]], [[4.0.0-7|v112]], [[4.1.0-8|v128]], [[4.2.0-9|v144]], [[4.3.0-10|v160]], [[5.0.0-11|v176]], non-USA=[[6.0.0-11|v192]]/USA=[[6.1.0-12U|v192]], [[7.0.0-13|v208]], [[7.1.0-14|v224]], [[7.1.0-15|v240]], [[7.1.0-16|v256]], [[7.2.0-17|v272]], [[8.0.0-18|v288]], [[8.1.0-19|v304]], [[9.0.0-20|v320]], [[9.3.0-21|v336]], [[9.5.0-22|v352]], [[9.5.0-23|v368]], [[9.6.0-24|v384]], [[9.7.0-25|v400]], [[9.9.0-26|v416]], [[10.0.0-27|v432]], [[10.2.0-28|v448]], [[10.4.0-29|v464]], [[10.5.0-30|v480]], [[10.6.0-31|v496]], [[10.7.0-32|v512]], [[11.0.0-33|v528]], [[11.1.0-34|v544]], [[11.2.0-35|v560]], [[11.3.0-36|v576]], [[11.5.0-38|v608]], ..., [[11.9.0-42|v672]]
| [[4.0.0-7|v113]], [[4.2.0-9|v128]], [[5.0.0-11|v129]], [[7.1.0-16|v130]], [[7.2.0-17|v272]], [[9.5.0-23|v131]], [[9.9.0-26|v132]]
| [[4.1.0-8|v114]], [[4.2.0-9|v133]], [[4.3.0-10|v134]], [[5.0.0-11|v136]], [[7.0.0-13|v144]], [[7.1.0-14|v160]] [[7.1.0-16|v192]], [[7.2.0-17|v272]], [[8.0.0-18|v208]], [[8.1.0-19|v224]], [[9.0.0-20|v240]], [[9.5.0-22|v272]], [[9.5.0-23|v288]], [[9.6.0-24|v304]], [[9.7.0-25|v320]], [[9.9.0-26|v336]], [[10.0.0-27|v352]], [[10.2.0-28|v368]], [[10.4.0-29|v384]], [[10.5.0-30|v400]], [[10.6.0-31|v416]], [[10.7.0-32|v432]], [[11.0.0-33|v448]], [[11.1.0-34|v464]], [[11.2.0-35|v480]], [[11.3.0-36|v496]], ..., [[11.9.0-42|v544]]
| [[4.0.0-7|v113]], [[4.1.0-8|v114]], [[4.2.0-9|v133]], [[4.3.0-10|v134]], [[5.0.0-11|v136]], [[7.0.0-13|v160]], [[7.1.0-14|v176]], [[7.1.0-16|v176]], [[7.2.0-17|v272]], [[8.0.0-18|v224]], [[8.1.0-19|v240]], [[9.0.0-20|v256]], [[9.3.0-21|v272]], [[9.5.0-22|v288]], [[9.5.0-23|v304]], [[9.6.0-24|v320]], [[9.7.0-25|v336]], [[9.9.0-26|v352]], [[10.0.0-27|v368]], [[10.2.0-28|v384]], [[10.4.0-29|v400]], [[10.5.0-30|v416]], [[10.6.0-31|v432]], [[10.7.0-32|v448]], [[11.0.0-33|v464]], [[11.1.0-34|v480]], [[11.2.0-35|v496]], [[11.3.0-36|v512]], ..., [[11.9.0-42|v576]]
|-
| 20016202
| 20016302
| 20016102
| N/A
| 20016502
| N/A
| [[New_3DS]] [[NVer]]
| [[8.1.0-0_New3DS|v0]], [[9.0.0-20|v320]], [[9.3.0-21|v336]], [[9.5.0-22|v352]], [[9.5.0-22|v352]], [[9.5.0-23|v368]], [[9.6.0-24|v384]], [[9.7.0-25|v400]], [[9.9.0-26|v416]], [[10.0.0-27|v432]], [[10.2.0-28|v448]], [[10.4.0-29|v464]], [[10.5.0-30|v480]], [[10.6.0-31|v496]], [[10.7.0-32|v512]], [[11.0.0-33|v528]], [[11.1.0-34|v544]], [[11.2.0-35|v560]], [[11.3.0-36|v576]], ..., [[11.9.0-42|v672]]
| N/A
| N/A
| [[9.6.0-24|v320]], [[9.7.0-25|v336]], [[9.9.0-26|v352]], [[10.0.0-27|v368]], [[10.2.0-28|v384]], [[10.4.0-29|v400]], [[10.5.0-30|v416]], [[10.6.0-31|v432]], [[10.7.0-32|v448]], [[11.0.0-33|v464]], [[11.2.0-35|v496]], [[11.3.0-36|v512]], ..., [[11.9.0-42|v576]]
|-
| 00017202
| 00017302
| 00017102
| 00017402
| 00017502
| 00017602
| [[CVer]]
| [[1.0.0-0|v1024]], [[1.1.0-1|v1045]], [[2.0.0-2|v2049]], [[2.1.0-3|v2069]], [[2.2.0-X|v2088]] [[3.0.0-5|v3088]], [[4.0.0-7|v4098]], [[4.1.0-8|v4113]], [[4.2.0-9|v4130]], [[4.3.0-10|v4145]], [[4.4.0-10|v4163]], [[4.5.0-10|v4176]], [[5.0.0-11|v5120]], [[5.1.0-11|v5136]], [[6.0.0-11|v6146]], [[6.1.0-11|v6160]], [[6.2.0-12|v6178]], [[6.3.0-12|v6192]], [[7.0.0-13|v7175]], [[7.1.0-14|v7187]], [[7.2.0-17|v7203]], [[8.0.0-18|v8196]], [[8.1.0-18|v8208]], [[8.1.0-0_New3DS|v8215]](8.1.0-0_New3DS), [[9.0.0-20|v9218]], [[9.1.0-20J|v9232]](JPN-only), [[9.2.0-20|v9248]], [[9.3.0-21|v9264]], [[9.4.0-21|v9280]], [[9.5.0-22|v9296]], [[9.6.0-24|v9319]], [[9.7.0-25|v9328]], [[9.8.0-25|v9344]], [[9.9.0-26|v9360]], [[10.0.0-27|v10240]], [[10.1.0-27|v10256]], [[10.2.0-28|v10272]], [[10.3.0-28|v10288]], [[10.4.0-29|v10304]], [[10.5.0-30|v10320]], [[10.6.0-31|v10336]], [[10.7.0-32|v10352]], [[11.0.0-33|v11264]], [[11.1.0-34|v11280]], [[11.2.0-35|v11296]], [[11.3.0-36|v11312]], [[11.4.0-37|...]], [[11.5.0-38|v11344]], ..., [[11.9.0-42|v11408]]
| [[1.0.0-0|v1024]], [[1.1.0-1|v1045]], [[2.0.0-2|v2049]], [[2.1.0-3|v2069]], [[2.2.0-X|v2088]] [[3.0.0-5|v3088]], [[4.0.0-7|v4098]], [[4.1.0-8|v4113]], [[4.2.0-9|v4130]], [[4.3.0-10|v4145]], [[4.4.0-10|v4163]], [[4.5.0-10|v4176]], [[5.0.0-11|v5120]], [[5.1.0-11|v5136]], [[6.0.0-11|v6146]], [[6.1.0-11|v6160]], [[6.2.0-12|v6178]], [[6.3.0-12|v6192]], [[7.0.0-13|v7175]], [[7.1.0-14|v7187]], [[7.2.0-17|v7203]], [[8.0.0-18|v8196]], [[8.1.0-18|v8208]], [[9.0.0-20|v9217]], [[9.3.0-21|v9264]], [[9.5.0-22|v9296]], [[9.6.0-24|v9319]], [[9.7.0-25|v9328]], [[9.8.0-25|v9344]], [[9.9.0-26|v9360]], [[10.0.0-27|v10240]], [[10.2.0-28|v10272]], [[10.4.0-29|v10304]], [[10.5.0-30|v10320]], [[10.6.0-31|v10336]], [[10.7.0-32|v10352]], [[11.2.0-35|v11296]], [[11.3.0-36|v11312]], ..., [[11.9.0-42|v11408]]
| Same as CHN
| Same as CHN + [[11.1.0-34|v11280]]
|}

=== 00040130 - System [[Services API|Modules]] ===
==== System Module Notes ====
Once Home Menu finishes loading, all of the below system modules are running, except for MP, RO, and act which are automatically [[Process_Manager_Services|loaded]] when a process requires them.
When [[Process_Manager_Services|PM]]-module terminates processes, it will check whether the processes listed as dependencies for this process are listed as dependencies for other processes.
Any processes which are no longer listed in any processes dependencies lists are then terminated. On [[New_3DS]], the only New3DS-specific system-module which automatically gets loaded during system boot is qtm.
All of the below system modules use the "BASE" [[SVC|memory-region]](specified in the exheader), except when listed otherwise for certain modules.
When handling the exheader dependency list starting with [[8.0.0-18]], Old3DS FIRM [[Process_Manager_Services|PM]]-module now skips handling titles in this list which have any bits in programID-low bitmask 0xF0000000 set(with [[8.0.0-18]] this is hard-coded).
The exheader dependency list handling change is for the [[New 3DS]] system-module(s), which do not exist on Old3DS.
When the New3DS pm-module is launching any title except [[NS]], it first attempts to launch the title with programID-low bitmask 0x20000000 set, then with that bitmask clear if launching fails.

{| class="wikitable sortable" border="1"
|-
! TitleID Low
! Description
! Versions
|-
| 00001002
| [[Services|sm]] (Stored in [[FIRM|NATIVE_FIRM]])
| N/A
|-
| 00001003
| SAFE_MODE [[Services|sm]] (Stored in SAFE_MODE NATIVE_FIRM)
| N/A
|-
| 00001102
| [[Filesystem services‎|fs]] (Stored in [[FIRM|NATIVE_FIRM]])
| N/A
|-
| 00001103
| SAFE_MODE [[Filesystem services‎|fs]] (Stored in SAFE_MODE NATIVE_FIRM)
| N/A
|-
| 00001202
| [[Process Manager Services|pm]] (Stored in [[FIRM|NATIVE_FIRM]])
| N/A
|-
| 00001203
| SAFE_MODE [[Process Manager Services|pm]] (Stored in SAFE_MODE NATIVE_FIRM)
| N/A
|-
| 00001302
| [[Loader Services‎|loader]] (Stored in [[FIRM|NATIVE_FIRM]])
| N/A
|-
| 00001303
| SAFE_MODE [[Loader Services‎|loader]] (Stored in SAFE_MODE NATIVE_FIRM)
| N/A
|-
| 00001402
| [[PXI Services‎|pxi]] (Stored in [[FIRM|NATIVE_FIRM]])
| N/A
|-
| 00001403
| SAFE_MODE [[PXI Services‎|pxi]] (Stored in SAFE_MODE NATIVE_FIRM)
| N/A
|-
| 00001502
| [[Application Manager Services|AM]] ( Application Manager )
| [[1.0.0-0|v0]], [[2.0.0-2|v1026]], [[3.0.0-5|v2053]], [[4.0.0-7|v3072]], [[5.0.0-11|v4098]], [[6.0.0-11|v5120]], [[8.0.0-18|v6148]], [[8.1.0-0_New3DS|v7168]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v8192]], [[10.0.0-27|v9217]]
|-
| 00001503
| SAFE_MODE [[Application Manager Services|AM]]
| [[1.0.0-0|v0]]
|-
| 20001503
| [[New_3DS]] SAFE_MODE [[Application Manager Services|AM]]
| [[8.1.0-0_New3DS|v7169]]
|-
| 00001602
| [[Camera Services|Camera]]
| [[1.0.0-0|v0]], [[2.0.0-2|v1026]], [[3.0.0-5|v2048]], [[4.0.0-7|v3074]], [[5.0.0-11|v4098]], [[6.0.0-11|v5120]], [[7.1.0-14|v6146]], [[8.0.0-18|v7172]], [[9.0.0-20|v9216]], [[9.3.0-21|v10242]], [[10.0.0-27|v11265]]
|-
| 20001602
| [[New_3DS]] [[Camera Services|Camera]]
| [[8.1.0-0_New3DS|v8200]], [[9.0.0-20|v9218]], [[9.3.0-21|v10242]], [[10.0.0-27|v11265]], [[11.4.0-37|v12288]](New2DSXL)
|-
| 00001702
| [[Config Services|Config]] (cfg)
| [[1.0.0-0|v0]], [[2.0.0-2|v1024]], [[3.0.0-5|v2049]], v3072, [[4.0.0-7|v4096]], [[5.0.0-11|v5122]], [[6.0.0-11|v6145]], [[6.1.0-11|v7168]], [[7.0.0-13|v8196]], [[7.2.0-17|v9220]], [[8.0.0-18|v10243]], [[8.1.0-0_New3DS|v11265]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v12290]], [[9.3.0-21|v13315]], [[9.6.0-24|v14342]], [[11.4.0-37|v15360]](New2DSXL)[[11.5.0-38|v15360]]
|-
| 00001703
| SAFE_MODE [[Config Services|Config]] (cfg)
| [[1.0.0-0|v0]]
|-
| 20001703
| [[New_3DS]] SAFE_MODE [[Config Services|Config]] (cfg)
| [[8.1.0-0_New3DS|v11265]]
|-
| 00001802
| [[Codec Services|Codec]]
| [[1.0.0-0|v0]], [[2.0.0-2|v1025]], [[2.2.0-X|v2048]], [[3.0.0-5|v3072]], [[5.0.0-11|v4098]], [[7.0.0-13|v5120]], [[8.0.0-18|v6144]], [[9.0.0-20|v7168]](Also for [[8.1.0-0_New3DS]])
|-
| 00001803
| SAFE_MODE [[Codec Services|Codec]]
| [[1.0.0-0|v0]]
|-
| 20001803
| [[New_3DS]] SAFE_MODE [[Codec Services|Codec]]
| [[8.1.0-0_New3DS|v7169]]
|-
| 00001A02
| [[DSP Services|DSP]]
| [[1.0.0-0|v0]], [[3.0.0-5|v1024]], [[4.0.0-7|v2048]], [[5.0.0-11|v3074]], [[6.0.0-11|v4096]], [[8.0.0-18|v5120]], [[9.7.0-25|v6145]], [[11.1.0-34|v7169]]
|-
| 00001A03
| SAFE_MODE [[DSP Services|DSP]]
| [[1.0.0-0|v0]]
|-
| 20001A03
| [[New_3DS]] SAFE_MODE [[DSP Services|DSP]]
| [[8.1.0-0_New3DS|v6145]]
|-
| 00001B02
| [[GPIO Services|GPIO]]
| [[1.0.0-0|v0]], [[5.0.0-11|v1025]], [[8.0.0-18|v2048]], [[9.5.0-22|v3073]]
|-
| 00001B03
| SAFE_MODE [[GPIO Services|GPIO]]
| [[1.0.0-0|v0]]
|-
| 20001B03
| [[New_3DS]] SAFE_MODE [[GPIO Services|GPIO]]
| [[8.1.0-0_New3DS|v3073]]
|-
| 00001C02
| [[GSP Services|GSP]]
| [[1.0.0-0|v0]], [[1.1.0-1|v1040]], [[2.0.0-2|v2049]], [[3.0.0-5|v3075]], v4098, [[4.0.0-7|v5120]], [[5.0.0-11|v6145]], [[6.0.0-11|v7168]], [[8.0.0-18|v8196]], [[9.0.0-20|v10240]], [[9.3.0-21|v11264]], [[9.6.0-24|v12294]], [[11.3.0-36|v13312]], [[11.5.0-38|v14336]]
|-
| 20001C02
| [[New_3DS]] [[GSP Services|GSP]]
| [[8.1.0-0_New3DS|v10243]], [[9.3.0-21|v11267]], [[9.6.0-24|v12294]], [[11.3.0-36|v13312]], [[11.4.0-37|v14336]](New2DSXL)
|-
| 00001C03
| SAFE_MODE [[GSP Services|GSP]]
| [[1.0.0-0|v0]]
|-
| 20001C03
| [[New_3DS]] SAFE_MODE [[GSP Services|GSP]]
| [[8.1.0-0_New3DS|v9217]]
|-
| 00001D02
| [[HID Services|HID]] (Human Interface Devices)
| [[1.0.0-0|v0]], [[2.0.0-2|v1025]], [[2.2.0-X|v2048]], [[3.0.0-5|v3072]], [[4.0.0-7|v4096]], [[5.0.0-11|v5121]], [[7.2.0-17|v6148]], [[8.0.0-18|v7168]], [[8.1.0-0_New3DS|v8192]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v9216]], [[9.3.0-21|v10240]]
|-
| 00001D03
| SAFE_MODE [[HID Services|HID]]
| [[1.0.0-0|v0]]
|-
| 20001D03
| [[New_3DS]] SAFE_MODE [[HID Services|HID]]
| [[8.1.0-0_New3DS|v8193]]
|-
| 00001E02
| [[I2C Services|i2c]]
| [[1.0.0-0|v0]], [[3.0.0-5|v1024]], [[5.0.0-11|v2049]], [[8.0.0-18|v3076]], [[9.3.0-21|v5120]]
|-
| 20001E02
| [[New_3DS]] [[I2C Services|i2c]]
| [[8.1.0-0_New3DS|v4096]], [[9.3.0-21|v5121]]
|-
| 00001E03
| SAFE_MODE [[I2C Services|i2c]]
| [[1.0.0-0|v0]]
|-
| 20001E03
| [[New_3DS]] SAFE_MODE [[I2C Services|i2c]]
| [[8.1.0-0_New3DS|v4097]]
|-
| 00001F02
| [[MCU Services|MCU]]
| [[1.0.0-0|v0]], [[2.0.0-2|v1026]], [[2.1.0-3|v2048]], [[3.0.0-5|v3072]], [[4.0.0-7|v4102]], [[5.0.0-11|v5122]], [[6.0.0-11|v6145]], [[7.0.0-13|v7168]], [[8.0.0-18|v8192]]
|-
| 20001F02
| [[New_3DS]] [[MCU Services|MCU]]
| [[8.1.0-0_New3DS|v8192]], [[11.4.0-37|v9216]](New2DSXL)
|-
| 00001F03
| SAFE_MODE [[MCU Services|MCU]]
| [[1.0.0-0|v0]]
|-
| 20001F03
| [[New_3DS]] SAFE_MODE [[MCU Services|MCU]]
| [[8.1.0-0_New3DS|v9217]]
|-
| 00002002
| [[MIC Services|MIC]] (Microphone)
| [[1.0.0-0|v0]], [[5.0.0-11|v1025]], [[8.0.0-18|v2048]]
|-
| 00002102
| [[PDN Services|PDN]]
| [[1.0.0-0|v0]], [[5.0.0-11|v1025]], [[8.0.0-18|v2048]]
|-
| 00002103
| SAFE_MODE [[PDN Services|PDN]]
| [[1.0.0-0|v0]]
|-
| 20002103
| [[New_3DS]] SAFE_MODE [[PDN Services|PDN]]
| [[8.1.0-0_New3DS|v3073]]
|-
| 00002202
| [[PTM Services|PTM]] (Play time, pedometer, and battery manager)
| [[1.0.0-0|v0]], [[2.0.0-2|v1026]], [[2.2.0-X|v2048]], [[3.0.0-5|v3075]], v4096, [[4.0.0-7|v5120]], [[5.0.0-11|v6146]], [[6.0.0-11|v7168]], [[7.0.0-13|v8192]], [[8.0.0-18|v9219]], [[9.6.0-24|v11264]]
|-
| 20002202
| [[New_3DS]] [[PTM Services|PTM]] (Play time, pedometer, and battery manager)
| [[8.1.0-0_New3DS|v10240]], [[9.6.0-24|v11264]]
|-
| 00002203
| SAFE_MODE [[PTM Services|PTM]]
| [[1.0.0-0|v0]]
|-
| 20002203
| [[New_3DS]] SAFE_MODE [[PTM Services|PTM]]
| [[8.1.0-0_New3DS|v10241]]
|-
| 00002302
| [[SPI Services|spi]]
| [[1.0.0-0|v0]], [[2.0.0-2|v1025]], [[5.0.0-11|v2049]], [[8.0.0-18|v3072]]
|-
| 20002302
| [[New_3DS]] [[SPI Services|spi]]
| [[8.1.0-0_New3DS|v4096]]
|-
| 00002303
| SAFE_MODE [[SPI Services|spi]]
| [[1.0.0-0|v0]]
|-
| 20002303
| [[New_3DS]] SAFE_MODE [[SPI Services|spi]]
| [[8.1.0-0_New3DS|v4097]]
|-
| 00002402
| [[AC Services|AC]] (Network manager)
| [[1.0.0-0|v0]], [[1.1.0-1|v1024]], [[2.0.0-2|v2052]], [[2.1.0-3|v3072]], [[3.0.0-5|v4101]], [[5.0.0-11|v5122]], [[7.0.0-13|v6145]], [[8.0.0-18|v7172]], [[9.0.0-20|v8192]](Also for [[8.1.0-0_New3DS]]), [[9.3.0-21|v9216]]
|-
| 00002403
| SAFE_MODE [[AC Services|AC]]
| [[1.0.0-0|v0]]
|-
| 20002403
| [[New_3DS]] SAFE_MODE [[AC Services|AC]]
| [[8.1.0-0_New3DS|v8193]]
|-
| 00002602
| [[CECD Services|Cecd]] (StreetPass)
| [[1.0.0-0|v0]], [[2.0.0-2|v1026]], [[2.2.0-X|v2048]], [[3.0.0-5|v3073]], [[4.0.0-7|v4097]], [[5.0.0-11|v5122]], [[6.0.0-11|v6144]], [[6.2.0-12|v7170]], [[7.0.0-13|v8193]], [[8.0.0-18|v9216]], [[9.0.0-20|v10240]]
|-
| 00002702
| [[CSND Services|CSND]]
| [[1.0.0-0|v0]], [[2.0.0-2|v1025]], [[4.0.0-7|v2048]], [[5.0.0-11|v3073]], [[8.0.0-18|v4096]], [[9.0.0-20|v5120]]
|-
| 00002703
| SAFE_MODE [[CSND Services|CSND]]
| [[1.0.0-0|v0]]
|-
| 20002703
| [[New_3DS]] SAFE_MODE [[CSND Services|CSND]]
| [[8.1.0-0_New3DS|v5121]]
|-
| 00002802
| [[DLP Services|DLP]] ([[Download Play]])
| [[1.0.0-0|v0]], [[2.0.0-2|v1026]], [[2.2.0-X|v2048]], [[3.0.0-5|v3078]], [[5.0.0-11|v4099]], [[8.0.0-18|v5123]], [[9.0.0-20|v6145]](Also for [[8.1.0-0_New3DS]]), [[9.6.0-24|v7174]], [[10.0.0-27|v8192]]
|-
| 00002902
| [[HTTP Services|HTTP]]
| [[1.0.0-0|v0]], [[2.0.0-2|v1026]], [[2.1.0-3|v2049]], [[2.2.0-X|v3072]], [[3.0.0-5|v4099]], [[4.0.0-7|v5122]], [[5.0.0-11|v6145]], [[7.0.0-13|v7171]], [[7.1.0-14|v8192]], [[8.0.0-18|v9220]], [[8.1.0-18|v10245]], [[8.1.0-0_New3DS|v11264]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v12288]], [[9.6.0-24|v13318]], [[11.4.0-37|v14336]]
|-
| 00002903
| SAFE_MODE [[HTTP Services|HTTP]]
| [[1.0.0-0|v0]]
|-
| 20002903
| [[New_3DS]] SAFE_MODE [[HTTP Services|HTTP]]
| [[8.1.0-0_New3DS|v10241]]
|-
| 00002A02
| [[MP Services|MP]]
| [[1.0.0-0|v0]], [[5.0.0-11|v1025]], [[8.0.0-18|v2048]]
|-
| 00002A03
| SAFE_MODE [[MP Services|MP]]
| [[1.0.0-0|v0]]
|-
| 00002B02
| [[NDM Services|NDM]]
| [[1.0.0-0|v0]], [[2.0.0-2|v1025]], [[3.0.0-5|v2049]], [[4.0.0-7|v3072]], [[5.0.0-11|v4098]], [[8.0.0-18|v5124]], [[8.1.0-0_New3DS|v6144]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v7169]]
|-
| 00002C02
| [[NIM Services|NIM]]
| [[1.0.0-0|v0]], [[2.0.0-2|v1028]], [[3.0.0-5|v2055]], [[4.0.0-7|v3074]], [[5.0.0-11|v4100]], [[6.0.0-11|v5120]], [[7.0.0-13|v6148]], [[7.2.0-17|v7174]], [[8.0.0-18|v8195]], [[8.1.0-0_New3DS|v9217]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v10249]], [[9.3.0-21|v11267]], [[9.6.0-24|v12296]], [[10.0.0-27|v13313]]
|-
| 00002C03
| SAFE_MODE [[NIM Services|NIM]]
| [[1.0.0-0|v0]]
|-
| 20002C03
| [[New_3DS]] SAFE_MODE [[NIM Services|NIM]]
| [[8.1.0-0_New3DS|v9217]]
|-
| 00002D02
| [[NWM Services|NWM]] ( Low-level wifi manager )
| [[1.0.0-0|v0]], [[1.1.0-1|v1024]], [[2.0.0-2|v2052]], [[2.2.0-X|v3072]], [[3.0.0-5|v4101]], [[4.0.0-7|v5120]], [[5.0.0-11|v6148]], [[6.0.0-11|v7169]], [[7.2.0-17|v8196]], [[8.0.0-18|v9216]], [[9.0.0-20|v10240]]
|-
| 00002D03
| SAFE_MODE [[NWM Services|NWM]]
| [[1.0.0-0|v0]], [[6.0.0-11|v5120]]
|-
| 20002D03
| [[New_3DS]] SAFE_MODE [[NWM Services|NWM]]
| [[8.1.0-0_New3DS|v10241]]
|-
| 00002E02
| [[Socket Services|Sockets]]
| [[1.0.0-0|v0]], [[1.1.0-1|v1024]], [[2.0.0-2|v2053]], [[3.0.0-5|v3075]], [[4.0.0-7|v4096]], [[5.0.0-11|v5121]], [[8.0.0-18|v6144]], [[9.0.0-20|v7168]], [[10.6.0-31|v8192]]
|-
| 00002E03
| SAFE_MODE [[Socket Services|Sockets]]
| [[1.0.0-0|v0]]
|-
| 20002E03
| [[New_3DS]] SAFE_MODE [[Socket Services|Sockets]]
| [[8.1.0-0_New3DS|v7169]]
|-
| 00002F02
| [[SSL Services|SSL]]
| [[1.0.0-0|v0]], [[2.0.0-2|v1024]], [[2.1.0-3|v2048]], [[3.0.0-5|v3072]], [[4.0.0-7|v4096]], [[5.0.0-11|v5122]], [[8.0.0-18|v6144]], [[9.0.0-20|v7168]], [[9.6.0-24|v8198]], [[11.14.0-46|v9217]]
|-
| 00002F03
| SAFE_MODE [[SSL Services|SSL]]
| [[1.0.0-0|v0]]
|-
| 20002F03
| [[New_3DS]] SAFE_MODE [[SSL Services|SSL]]
| [[8.1.0-0_New3DS|v7169]]
|-
| 00003000
| [[FIRM|Process9]] (in SAFE_MODE and normal NATIVE_FIRM)
|
|-
| 00003102
| [[Process Services‎|PS]] ( Process Manager )
| [[1.0.0-0|v0]], [[2.0.0-2|v1025]], [[5.0.0-11|v2049]], [[6.0.0-11|v3072]], [[8.0.0-18|v4096]], [[9.0.0-20|v5120]]
|-
| 00003103
| SAFE_MODE [[Process Services‎|PS]]
| [[1.0.0-0|v0]]
|-
| 20003103
| [[New_3DS]] SAFE_MODE [[Process Services‎|PS]]
| [[8.1.0-0_New3DS|v5121]]
|-
| 00003202
| [[Friend Services‎|friends]] (Friends list)
| [[1.0.0-0|v0]], [[2.0.0-2|v1028]], [[2.2.0-X|v2048]], [[3.0.0-5|v3072]], [[4.0.0-7|v4096]], [[5.0.0-11|v5122]], [[7.0.0-13|v6145]], [[8.0.0-18|v7172]], [[9.0.0-20|v8192]](Also for [[8.1.0-0_New3DS]]), [[10.5.0-30|v9216]], [[10.7.0-32|v10240]], [[11.0.0-33|v11264]], [[11.1.0-34|v12288]], [[11.2.0-35|v13312]], [[11.3.0-36|v14336]], [[11.4.0-37|v15360]]
|-
| 00003203
| SAFE_MODE [[Friend Services‎|friends]] (Friends list)
| [[1.0.0-0|v0]]
|-
| 20003203
| [[New_3DS]] SAFE_MODE [[Friend Services‎|friends]] (Friends list)
| [[8.1.0-0_New3DS|v8193]]
|-
| 00003302
| [[IR Services‎|IR]] (Infrared)
| [[1.0.0-0|v0]], [[2.0.0-2|v1026]], [[2.2.0-X|v2048]], [[3.0.0-5|v3072]], [[4.0.0-7|v4096]], [[5.0.0-11|v5121]], [[8.0.0-18|v6148]], [[8.1.0-0_New3DS|v7170]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v8192]], [[9.3.0-21|v9216]], [[9.6.0-24|v10246]], [[10.0.0-27|v11265]], [[10.6.0-31|v12289]]
|-
| 00003303
| SAFE_MODE [[IR Services‎|IR]]
| [[1.0.0-0|v0]]
|-
| 20003303
| [[New_3DS]] SAFE_MODE [[IR Services‎|IR]]
| [[8.1.0-0_New3DS|v7169]]
|-
| 00003402
| [[BOSS Services‎|BOSS]] (SpotPass)
| [[1.0.0-0|v0]], [[1.1.0-1|v1024]], [[2.0.0-2|v2053]], [[2.2.0-X|v3073]], [[3.0.0-5|v4101]], [[4.0.0-7|v5122]], [[5.0.0-11|v6146]], [[6.0.0-11|v7169]], [[6.2.0-12|v8193]], [[7.0.0-13|v9222]], [[8.0.0-18|v10240]], [[9.0.0-20|v11266]], [[10.0.0-27|v12289]], [[10.4.0-29|v13314]]
|-
| 00003502
| [[News Services‎|News]] (Notifications)
| [[1.0.0-0|v0]], [[2.0.0-2|v1028]], [[2.2.0-X|v2048]], [[3.0.0-5|v3072]], [[5.0.0-11|v4097]], [[8.0.0-18|v5120]], [[9.0.0-20|v6147]], [[9.7.0-25|v7168]]
|-
| 00003702
| [[RO_Services|RO]]
| [[2.0.0-2|v0]], [[4.0.0-7|v1024]], [[5.0.0-11|v2049]], [[7.2.0-17|v3074]], [[8.0.0-18|v4096]], [[9.0.0-20|v5120]](Also for [[8.1.0-0_New3DS]]), [[9.3.0-21|v6148]]
|-
| 00003802
| [[ACT Services‎|act]] (handles Nintendo Network '''a'''c'''c'''oun'''t'''s)
| [[7.0.0-13|v1029]], [[7.1.0-14|v2050]], [[7.2.0-17|v3077]], [[8.0.0-18|v4099]], [[8.1.0-0_New3DS|v5120]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v6144]], [[9.3.0-21|v7168]], [[9.6.0-24|v8198]], [[11.4.0-37|v9216]](New2DSXL), [[11.5.0-38|v9216]]
|-
| 00004002
| Old3DS [[NFC_Services|nfc]]
| [[9.3.0-21|v2053]], [[9.6.0-24|v4106]], [[9.7.0-25|v5121]], [[10.0.0-27|v6145]], [[10.6.0-31|v7168]], [[10.7.0-32|v8192]]
|-
| 20004002
| [[New_3DS]] [[NFC_Services|nfc]]
| [[8.1.0-0_New3DS|v0]], [[9.0.0-20|v1024]], [[9.3.0-21|v2053]], [[9.5.0-22|v3073]], [[9.6.0-24|v4102]], [[10.0.0-27|v6145]], [[10.6.0-31|v7168]]
|-
| 20004102
| [[New_3DS]] [[MVD Services|mvd]]
| [[8.1.0-0_New3DS|v0]], [[9.0.0-20|v1024]]
|-
| 20004202
| [[New_3DS]] [[QTM Services|qtm]]
| [[8.1.0-0_New3DS|v8]], [[9.0.0-20|v1024]], [[9.3.0-21|v2052]], [[11.4.0-37|v3072]](New2DSXL)
|-
| 00008002
| [[NS]] (Memory-region: "SYSTEM")
| [[1.0.0-0|v0]], [[2.0.0-2|v1028]], [[2.2.0-X|v2048]], [[3.0.0-5|v3077]], v4096, [[4.0.0-7|v5121]], [[5.0.0-11|v6148]], [[5.1.0-11|v7168]], [[6.0.0-11|v8193]], [[6.1.0-11|v9216]], [[7.0.0-13|v10248]], [[7.2.0-17|v11268]], [[8.0.0-18|v12291]], [[8.1.0-0_New3DS|v13312]]([[8.1.0-0_New3DS]]), [[9.0.0-20|v14336]], [[9.3.0-21|v15360]], [[9.6.0-24|v16390]], [[9.8.0-25|v17408]], [[10.0.0-27|v18433]], [[10.4.0-29|v19458]], [[11.1.0-34|v20482]], [[11.3.0-36|v21504]]
|-
| 00008003
| SAFE_MODE [[NS]] (Memory-region: "SYSTEM")
| [[1.0.0-0|v0]]
|-
| 20008003
| [[New_3DS]] SAFE_MODE [[NS]] (Memory-region: "SYSTEM")
| [[8.1.0-0_New3DS|v13313]]
|}

=== 00040138 - [[FIRM|System Firmware]] ===
==== System Firmare Notes ====
NATIVE_FIRM and SAFE_MODE_FIRM for the initial versions are exactly the same, besides [[Configuration_Memory|core-version]] fields. SAFE_MODE_FIRM is used for running SAFE_MODE titles, on retail SAFE_MODE_FIRM seems to be only used for running the [[System_Settings#System_Updater|System Updater]] application. When a GBA VC title is launched, AGB_FIRM is launched to handle running this title. GBA VC savegames stored under SD card /title/<TID>/data use a custom format, this is handled by AGB_FIRM.

{| class="wikitable sortable" border="1"
|-
! TitleID Low
! Description
! USA/EUR/JPN Versions
! CHN Versions
! KOR Versions
! TWN Versions
|-
| 00000001
| Unknown, very similar to SAFE_MODE_FIRM. Exists only on dev units and seems to only be used by SystemUpdaters.
| v0
|
|
|
|-
| 00000002
| NATIVE_FIRM (Native Firmware)
| [[1.0.0-0|v432]], [[1.1.0-1|v1472]], [[2.0.0-2|v2516]], [[2.1.0-3|v3553]], [[2.2.0-X|v4595]], [[3.0.0-5|v5647]], [[4.0.0-7|v6677]], [[4.1.0-8|v7712]], [[5.0.0-11|v8758]], [[5.1.0-11|v9792]], [[6.0.0-11|v10833]], [[6.1.0-11|v11872]], [[7.0.0-13|v12916]], [[7.2.0-17|v13956]], v15043, [[8.0.0-18|v15047]], [[9.0.0-20|v17120]], [[9.3.0-21|v18182]], [[9.5.0-22|v19216]], [[9.6.0-24|v20262]], [[10.0.0-27|v21288]], [[10.2.0-28|v22313]], [[10.4.0-29|v23341]], [[11.0.0-33|v24368]], [[11.1.0-34|v25396]], [[11.2.0-35|v26432]], [[11.3.0-36|v27476]]
| Same as USA/EUR/JPN starting with the USA/EUR/JPN [[4.0.0-7]] title-version
| Same as CHN.
| Same as CHN.
|-
| 20000002
| [[New_3DS]] NATIVE_FIRM (Native Firmware)
| [[8.1.0-0_New3DS|v16085]], [[9.0.0-20|v17120]], [[9.3.0-21|v18182]], [[9.5.0-22|v19218]], [[9.6.0-24|v20262]], [[10.0.0-27|v21288]], [[10.2.0-28|v22313]], [[10.4.0-29|v23341]], [[11.0.0-33|v24368]], [[11.1.0-34|v25396]], [[11.2.0-35|v26432]], [[11.3.0-36|v27476]]
| N/A
| Same as CHN.
| Same as CHN.
|-
| 00000003
| SAFE_MODE_FIRM
| [[1.0.0-0|v432]], [[3.0.0-5|v5632]]
| Same as USA/EUR/JPN starting with the USA/EUR/JPN [[3.0.0-5]] title-version
| Same as CHN.
| Same as CHN.
|-
| 20000003
| [[New_3DS]] SAFE_MODE_FIRM
| [[8.1.0-0_New3DS|v16081]]
| N/A
| Same as CHN.
| Same as CHN.
|-
| 00000102
| TWL_FIRM ( DSi Firmware )
| [[1.0.0-0|v432]], [[2.0.0-2|v1489]], [[3.0.0-5|v2565]], v3601, [[4.0.0-7|v4625]], [[4.4.0-10|v5681]], [[4.5.0-10|v6704]], [[6.0.0-11|v7762]], [[6.2.0-12|v8817]]
| Same as USA/EUR/JPN starting with the USA/EUR/JPN [[4.0.0-7]] title-version
| Same as CHN.
| Same as CHN.
|-
| 20000102
| [[New_3DS]] TWL_FIRM ( DSi Firmware )
| [[8.1.0-0_New3DS|v9936]]
| N/A
| Same as CHN.
| Same as CHN.
|-
| 00000202
| AGB_FIRM ( GBA Firmware )
| [[3.0.0-5|v519]], v1553, [[4.0.0-7|v2576]], [[6.0.0-11|v3665]]
| [[4.0.0-7|v2576]]
| [[4.0.0-7|v2576]], [[6.0.0-11|v3665]]
| Same as CHN.
|-
| 20000202
| [[New_3DS]] AGB_FIRM ( GBA Firmware )
| [[8.1.0-0_New3DS|v4816]]
| N/A
| N/A
| N/A
|}

== Application Titles ==
{| class="wikitable sortable" border="1"
|-
! Category Bit Mask
! Content Category
! Bit Mask(s)
|-
| 0x0000
| [[Title list/eShop Titles|Application / eShop]]
| Normal
|-
| 0x0001
| Download Play Child
| DlpChild
|-
| 0x0002
| [[EShop Demos|Demo]]
| Demo
|-
| 0x000E
| [[Title list/Patches|Patch]]
| CannotExecution<nowiki> | </nowiki>Patch
|-
| 0x008C
| [[Title list/DLC|Downloadable Content]]
| NotRequireRightForMount<nowiki> | </nowiki>CannotExecution<nowiki> | </nowiki>AddOnContents
|}

=== 00040001 - [[Download Play]] Titles ===
==== Download Play Notes ====
This titleID-high/programID-high is used for the titles sent over [[Download Play]]. Only one 00040001 Download Play title is installed to NAND /title at a time. There can be a maximum of 255 Download Play child titles per Unique ID, indexed by Title ID Variation. The legal index range: 0x0 - 0xff.

== Factory Titles ==
==== Factory Titles Notes ====
This section is for hard-coded titleIDs referenced in codebins on retail. This can include [[Factory_Setup|factory]]/[[Nintendo_Service_Center_Tools|repair]] titles as well.

{| class="wikitable sortable" border="1"
|-
! TitleID
! Description
! Versions
|-
| 000400000F802A00
| Unknown. Appears to be a [[9.8.0-25|gamecard]] title. See also [[11.3.0-36|here]].
Used during [[Nintendo_Service_Center_Tools|repair]], first non-system title listed in [[PTM_Services|playlog]] from repair.
| ?
|-
| 000400000F802100
| Used during [[Nintendo_Service_Center_Tools|repair]], second non-system title listed in [[PTM_Services|playlog]] from repair.
| ?
|-
| 000400000F802200
| Used during [[Nintendo_Service_Center_Tools|repair]], third non-system title listed in [[PTM_Services|playlog]] from repair.
| ?
|-
| 000400000FFFFD00
| Used by retail NS for appID 0xF11, but this isn't available on retail CDN.
| ?
|-
| 000400000FFFFC00
| Used by retail NS for appID 0xF12, but this isn't available on retail CDN.
| ?
|-
| 000400000FFFFB00
| Used by retail NS for appID 0xF13, but this isn't available on retail CDN.
| ?
|-
| 000400000FFFF900
| Used by retail NS for appID 0xF14, but this isn't available on retail CDN.
| ?
|-
| 000400000FFFF800
| Used by retail NS for appID 0xF15, but this isn't available on retail CDN.
| ?
|-
| 000400000FFFF700
| Used by retail NS for appID 0xF16, but this isn't available on retail CDN.
| ?
|-
| 000400000FFFF600
| Used by retail NS for appID 0xF17, but this isn't available on retail CDN.
| ?
|-
| 000400000FFFF500
| Used by retail NS for appID 0xF18, but this isn't available on retail CDN.
| ?
|-
| 0004003000008900
| Used by retail NS for appID 0xF10, but this isn't available on retail CDN.
| ?
|-
| 0004013000001902
| dmnt, debugger sysmodule. This use devunit-only HIO for devunit<>pc comms. This only exists for development units(launched by NS during startup depending on certain [[Configuration_Memory]] fields' values).
This is installed at the [[Factory_Setup|factory]], then later deleted at the factory on retail units.
| ?
|-
| 0004013000003602
| "debugger". This only exist for development units(launched by NS during startup depending on certain [[Configuration_Memory]] fields' values).
| ?
|-
| 000401300FEF0000
| Referenced in eShop Metadata (NS_UID 50010000000584), but does not exist on retail CDN
|}

== TWL (DSi) Titles ==
==== TWL Title Notes ====
Bitmask 0x1 for TWL titles denotes a system title (determining whether the title will be updated during a System Update).

It appears to be sufficient, but not necessary, to make the title invisible on the [[Home Menu]].

Bitmask 0x2 for TWL titles may indicate no-execute.

Bitmask 0x4 for TWL titles indicates internal storage.

Bitmask 0x10 for TWL titles is found on developer tools.

{| class="wikitable sortable" border="1"
|-
! Content Category
! Bit Mask(s)
! Category Bit Mask
|-
| Application (DSiWare)
| TWL<nowiki> | </nowiki>0x4
| 0x8004
|-
| System Application
| TWL<nowiki> | </nowiki>0x1<nowiki> | </nowiki>0x4
| 0x8005
|-
| System Archive
| TWL<nowiki> | </nowiki>0x1<nowiki> | </nowiki>0x2<nowiki> | </nowiki>0x4<nowiki> | </nowiki>0x8
| 0x800F
|-
| Developer Tool
| TWL<nowiki> | </nowiki>0x1<nowiki> | </nowiki>0x4<nowiki> | </nowiki>0x10
| 0x8015
|}

=== 00048005 - System Applications===
{| class="wikitable sortable" border="1"
|-
! TitleID Low
! Region
! Description
! Versions
! Information
|-
| 42383841(B88A)
| ALL
| [[DS Internet]]
| v0, [[2.1.0-4|v1025]], [[3.0.0-5|v2048]]
| [[DS Internet]] is the DS-mode application, (also integrated in every online-enabled DS game) and now accessible through [[System Settings]] for configuring network settings for DS software.
|-
| 484E4441(HNDA)
| ALL
| [[Download Play]]
| v1024
| This [[Download Play]] application is the DS-mode Download Play client, launched by the 3DS-mode Download Play application.
|-
| 484E4443(HNDC)
| CHN
| [[Download Play]]
| v1024
| See Above Description.
|-
| 484E444B(HNDK)
| KOR
| [[Download Play]]
| v1024
| See Above Description.
|}

=== 0004800F - System Data Archives===
==== System Data Archive Notes ====
New system updates only block DS flash-cards when whitelist is updated, or when TWL_FIRM is updated.
The whitelist contains the data used for detecting flash-cards, this is used by TWL_FIRM.

{| class="wikitable sortable" border="1"
|-
! TitleID Low
! Description
! Versions
|-
| 484E4841(HNHA)
| [[Nintendo DS Cart Whitelist]] -
| v0, [[2.0.0-2|v1026]], [[2.2.0-X|v2048]], [[3.0.0-5|v3072]], [[4.0.0-7|v4096]], [[4.2.0-9|v5120]], [[4.3.0-10|v6145]], [[4.4.0-10|v7168]], [[4.5.0-10|v8192]], [[5.0.0-11|v9216]], [[6.0.0-11|v10240]], [[7.0.0-13|v11264]]
|-
| 484E4C41(HNLA)
| [[Version Data]]
| v0
|}

=== 00048004 - DSiWare Ports ===
==== DSiWare Port Notes ====
Although these have a titleID high separate from DSi and a titleID is stored in the SRLs, the content of these SRLs are identical to DSi.
See [[3DS DSiWare Titles]] for a complete list.

FS:SendInitializeInfoTo9

2025-08-04T11:55:49Z

TimmSkiller:

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x0839|0|0}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x0839|1|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEnd}}

=Description=
First waits until PTM has set bit0 of [[Configuration_Memory#Shared_Memory_Page_For_ARM11_Processes|address 0x1FF81086 in configuration memory]], indicating that [[Configuration_Memory#MCU_HW_INFO|MCU_HW_INFO]] has been written.

Then, [[Configuration_Memory#MCU_HW_INFO|MCU_HW_INFO]] is retrieved from configuration memory and is passed into [[FSPXI:SendInitializeInfoTo9]].

FSPXI:SendInitializeInfoTo9

2025-08-04T11:51:56Z

TimmSkiller: Created page with "=Request= {{IPC/Request}} {{IPC/RequestHeader|0x0036|1|0}} {{IPC/RequestEntry|RUNNING_HW}} {{IPC/RequestEnd}} =Response= {{IPC/Request}} {{#vardefine:ipc_offset|0}} {{IPC/RequestHeader|0x0036|1|0}} {{IPC/RequestEntry|Result code}} {{IPC/RequestEnd}} =Description= Initializes internal state (related to gamecard slot hardware?) in Process9 according to the given hardware type."

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x0036|1|0}}
{{IPC/RequestEntry|[[Configuration_Memory#RUNNING_HW|RUNNING_HW]]}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x0036|1|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEnd}}

=Description=
Initializes internal state (related to gamecard slot hardware?) in Process9 according to the given hardware type.

PDNC:Control

2025-08-03T08:15:06Z

TimmSkiller: Redirected page to PDNC:Enable

#REDIRECT [[PDNC:Enable]]

PDN Services

2025-08-03T08:10:50Z

TimmSkiller: /* PDN Camera Service "pdn:c" */

[[Category:Services]]

= PDN PTM Service "pdn:s" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010000
| [[PDNS:GetWakeStatus|GetWakeStatus]]
|-
| 0x00020080
| [[PDNS:ConfigureWakeEvents|ConfigureWakeEvents]]
|-
| 0x00030040
| [[PDNS:Acknowledge|Acknowledge]]
|}

= PDN DSP Service "pdn:d" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C0
| [[PDND:Control|Control]]
|}

= PDN I2S Service "pdn:i" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010040
| [[PDNI:Control1|Control1]]
|-
| 0x00020040
| [[PDNI:Control2|Control2]]
|}

Used by [[Codec Services]].

= PDN GSP service "pdn:g" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C0
| [[PDNG:Control|Control]]
|}

= PDN Camera Service "pdn:c" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010040
| [[PDNC:Control|Control]]
|-
| 0x000200000
| [[PDNC:IsEnabled|IsEnabled]]
|}

PDNC:IsEnabled

2025-08-03T08:10:21Z

TimmSkiller: Created page with "=Request= {{IPC/Request}} {{IPC/RequestHeader|0x0001|1|0}} {{IPC/RequestEnd}} =Response= {{IPC/Request}} {{#vardefine:ipc_offset|0}} {{IPC/RequestHeader|0x0001|2|0}} {{IPC/RequestEntry|Result code}} {{IPC/RequestEntry|bool, whether or not the camera clock is enabled}} {{IPC/RequestEnd}} =Description= Returns bit0 of PDN_CAMERA_CNT."

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x0001|1|0}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x0001|2|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEntry|bool, whether or not the camera clock is enabled}}
{{IPC/RequestEnd}}

=Description=
Returns bit0 of [[PDN_Registers#PDN_CAMERA_CNT|PDN_CAMERA_CNT]].

PDNC:Enable

2025-08-03T08:09:13Z

TimmSkiller: Created page with "=Request= {{IPC/Request}} {{IPC/RequestHeader|0x0001|1|0}} {{IPC/RequestEntry|bool, enable clock}} {{IPC/RequestEnd}} =Response= {{IPC/Request}} {{#vardefine:ipc_offset|0}} {{IPC/RequestHeader|0x0001|1|0}} {{IPC/RequestEntry|Result code}} {{IPC/RequestEnd}} =Description= Enables or disables the camera clock using PDN_CAMERA_CNT."

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x0001|1|0}}
{{IPC/RequestEntry|bool, enable clock}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x0001|1|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEnd}}

=Description=
Enables or disables the camera clock using [[PDN_Registers#PDN_CAMERA_CNT|PDN_CAMERA_CNT]].

PDN Services

2025-08-03T08:07:19Z

TimmSkiller: /* PDN GSP service "pdn:g" */

[[Category:Services]]

= PDN PTM Service "pdn:s" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010000
| [[PDNS:GetWakeStatus|GetWakeStatus]]
|-
| 0x00020080
| [[PDNS:ConfigureWakeEvents|ConfigureWakeEvents]]
|-
| 0x00030040
| [[PDNS:Acknowledge|Acknowledge]]
|}

= PDN DSP Service "pdn:d" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C0
| [[PDND:Control|Control]]
|}

= PDN I2S Service "pdn:i" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010040
| [[PDNI:Control1|Control1]]
|-
| 0x00020040
| [[PDNI:Control2|Control2]]
|}

Used by [[Codec Services]].

= PDN GSP service "pdn:g" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C0
| [[PDNG:Control|Control]]
|}

= PDN Camera Service "pdn:c" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010040
| This sets bit0 in [[PDN Registers#PDN_CAMERA_CNT|PDN_CAMERA_CNT]] to u8 cmd+4.
|-
| 0x000200000
| This writes [[PDN Registers#PDN_CAMERA_CNT|PDN_CAMERA_CNT]] & 1 to u8 cmdreply+8.
|}

PDNG:Control

2025-08-03T08:07:03Z

TimmSkiller: Created page with "=Request= {{IPC/Request}} {{IPC/RequestHeader|0x0001|3|0}} {{IPC/RequestEntry|bool, enable}} {{IPC/RequestEntry|bool, reset}} {{IPC/RequestEntry|bool, resetRegisters}} {{IPC/RequestEnd}} =Response= {{IPC/Request}} {{#vardefine:ipc_offset|0}} {{IPC/RequestHeader|0x0001|1|0}} {{IPC/RequestEntry|Result code}} {{IPC/RequestEnd}} =Description= Controls the GPU by enabling and/or resetting it using PDN_GPU_CNT."

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x0001|3|0}}
{{IPC/RequestEntry|bool, enable}}
{{IPC/RequestEntry|bool, reset}}
{{IPC/RequestEntry|bool, resetRegisters}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x0001|1|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEnd}}

=Description=
Controls the GPU by enabling and/or resetting it using [[PDN_Registers#PDN_GPU_CNT|PDN_GPU_CNT]].

PDN Services

2025-08-03T08:05:22Z

TimmSkiller: /* PDN I2S Service "pdn:i" */

[[Category:Services]]

= PDN PTM Service "pdn:s" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010000
| [[PDNS:GetWakeStatus|GetWakeStatus]]
|-
| 0x00020080
| [[PDNS:ConfigureWakeEvents|ConfigureWakeEvents]]
|-
| 0x00030040
| [[PDNS:Acknowledge|Acknowledge]]
|}

= PDN DSP Service "pdn:d" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C0
| [[PDND:Control|Control]]
|}

= PDN I2S Service "pdn:i" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010040
| [[PDNI:Control1|Control1]]
|-
| 0x00020040
| [[PDNI:Control2|Control2]]
|}

Used by [[Codec Services]].

= PDN GSP service "pdn:g" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C0
| (bool enableClock, bool resetEngines, bool resetRegisters) Enables and/or resets the GPU, see [[PDN Registers#PDN_GPU_CNT|PDN_GPU_CNT]]
|}

= PDN Camera Service "pdn:c" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010040
| This sets bit0 in [[PDN Registers#PDN_CAMERA_CNT|PDN_CAMERA_CNT]] to u8 cmd+4.
|-
| 0x000200000
| This writes [[PDN Registers#PDN_CAMERA_CNT|PDN_CAMERA_CNT]] & 1 to u8 cmdreply+8.
|}

PDNI:Control2

2025-08-03T08:02:15Z

TimmSkiller: Created page with "=Request= {{IPC/Request}} {{IPC/RequestHeader|0x0001|1|0}} {{IPC/RequestEntry|bool, enable I2S2 clock}} {{IPC/RequestEnd}} =Response= {{IPC/Request}} {{#vardefine:ipc_offset|0}} {{IPC/RequestHeader|0x0001|1|0}} {{IPC/RequestEntry|Result code}} {{IPC/RequestEnd}} =Description= Enables or disables the I2S2 clock using PDN_I2S_CNT."

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x0001|1|0}}
{{IPC/RequestEntry|bool, enable I2S2 clock}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x0001|1|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEnd}}

=Description=
Enables or disables the I2S2 clock using [[PDN_Registers#PDN_I2S_CNT|PDN_I2S_CNT]].

PDNI:Control1

2025-08-03T08:01:59Z

TimmSkiller: Created page with "=Request= {{IPC/Request}} {{IPC/RequestHeader|0x0001|1|0}} {{IPC/RequestEntry|bool, enable I2S1 clock}} {{IPC/RequestEnd}} =Response= {{IPC/Request}} {{#vardefine:ipc_offset|0}} {{IPC/RequestHeader|0x0001|1|0}} {{IPC/RequestEntry|Result code}} {{IPC/RequestEnd}} =Description= Enables or disables the I2S1 clock using PDN_I2S_CNT."

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x0001|1|0}}
{{IPC/RequestEntry|bool, enable I2S1 clock}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x0001|1|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEnd}}

=Description=
Enables or disables the I2S1 clock using [[PDN_Registers#PDN_I2S_CNT|PDN_I2S_CNT]].

PDN Services

2025-08-03T07:58:55Z

TimmSkiller: /* PDN DSP Service "pdn:d" */

[[Category:Services]]

= PDN PTM Service "pdn:s" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010000
| [[PDNS:GetWakeStatus|GetWakeStatus]]
|-
| 0x00020080
| [[PDNS:ConfigureWakeEvents|ConfigureWakeEvents]]
|-
| 0x00030040
| [[PDNS:Acknowledge|Acknowledge]]
|}

= PDN DSP Service "pdn:d" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C0
| [[PDND:Control|Control]]
|}

= PDN I2S Service "pdn:i" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010040
| This sets bit0 in [[PDN Registers#PDN_I2S1_CNT|PDN_I2S1_CNT]] to u8 cmd+4.
|-
| 0x00020040
| This sets bit1 in [[PDN Registers#PDN_I2S2_CNT|PDN_I2S2_CNT]] to u8 cmd+4.
|}

Used by [[Codec Services]].

= PDN GSP service "pdn:g" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C0
| (bool enableClock, bool resetEngines, bool resetRegisters) Enables and/or resets the GPU, see [[PDN Registers#PDN_GPU_CNT|PDN_GPU_CNT]]
|}

= PDN Camera Service "pdn:c" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010040
| This sets bit0 in [[PDN Registers#PDN_CAMERA_CNT|PDN_CAMERA_CNT]] to u8 cmd+4.
|-
| 0x000200000
| This writes [[PDN Registers#PDN_CAMERA_CNT|PDN_CAMERA_CNT]] & 1 to u8 cmdreply+8.
|}

PDND:Control

2025-08-03T07:58:37Z

TimmSkiller: Created page with "=Request= {{IPC/Request}} {{IPC/RequestHeader|0x0001|3|0}} {{IPC/RequestEntry|bool, enable}} {{IPC/RequestEntry|bool, reset}} {{IPC/RequestEntry|bool, resetRegisters}} {{IPC/RequestEnd}} =Response= {{IPC/Request}} {{#vardefine:ipc_offset|0}} {{IPC/RequestHeader|0x0001|1|0}} {{IPC/RequestEntry|Result code}} {{IPC/RequestEnd}} =Description= Controls the DSP by enabling, resetting, or holding it in reset using PDN_DSP_CNT."

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x0001|3|0}}
{{IPC/RequestEntry|bool, enable}}
{{IPC/RequestEntry|bool, reset}}
{{IPC/RequestEntry|bool, resetRegisters}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x0001|1|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEnd}}

=Description=
Controls the DSP by enabling, resetting, or holding it in reset using [[PDN_Registers#PDN_DSP_CNT|PDN_DSP_CNT]].

PDN Services

2025-08-03T07:54:00Z

TimmSkiller: /* PDN PTM Service "pdn:s" */

[[Category:Services]]

= PDN PTM Service "pdn:s" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010000
| [[PDNS:GetWakeStatus|GetWakeStatus]]
|-
| 0x00020080
| [[PDNS:ConfigureWakeEvents|ConfigureWakeEvents]]
|-
| 0x00030040
| [[PDNS:Acknowledge|Acknowledge]]
|}

= PDN DSP Service "pdn:d" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C0
| (bool enable, bool reset, bool deassertResetAfterReset) Enables and/or resets the DSP and/or holds it in reset
|}

= PDN I2S Service "pdn:i" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010040
| This sets bit0 in [[PDN Registers#PDN_I2S1_CNT|PDN_I2S1_CNT]] to u8 cmd+4.
|-
| 0x00020040
| This sets bit1 in [[PDN Registers#PDN_I2S2_CNT|PDN_I2S2_CNT]] to u8 cmd+4.
|}

Used by [[Codec Services]].

= PDN GSP service "pdn:g" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C0
| (bool enableClock, bool resetEngines, bool resetRegisters) Enables and/or resets the GPU, see [[PDN Registers#PDN_GPU_CNT|PDN_GPU_CNT]]
|}

= PDN Camera Service "pdn:c" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010040
| This sets bit0 in [[PDN Registers#PDN_CAMERA_CNT|PDN_CAMERA_CNT]] to u8 cmd+4.
|-
| 0x000200000
| This writes [[PDN Registers#PDN_CAMERA_CNT|PDN_CAMERA_CNT]] & 1 to u8 cmdreply+8.
|}

PDNS:Acknowledge

2025-08-03T07:53:39Z

TimmSkiller: Created page with "=Request= {{IPC/Request}} {{IPC/RequestHeader|0x0003|1|0}} {{IPC/RequestEntry|Wake events to clear/acknowledge}} {{IPC/RequestEnd}} =Response= {{IPC/Request}} {{#vardefine:ipc_offset|0}} {{IPC/RequestHeader|0x0003|1|0}} {{IPC/RequestEntry|Result code}} {{IPC/RequestEnd}} =Description= Acknowledges the specified wake events. This writes to PDN_WAKE_REASON to acknowledge the specified set of wake events."

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x0003|1|0}}
{{IPC/RequestEntry|[[PDN_Registers#PDN_WAKE_ENABLE|Wake events]] to clear/acknowledge}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x0003|1|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEnd}}

=Description=
Acknowledges the specified wake events.

This writes to [[PDN_Registers#PDN_WAKE_REASON|PDN_WAKE_REASON]] to acknowledge the specified set of wake events.

PDN Services

2025-08-03T07:52:01Z

TimmSkiller:

[[Category:Services]]

= PDN PTM Service "pdn:s" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010000
| [[PDNS:GetWakeStatus|GetWakeStatus]]
|-
| 0x00020080
| [[PDNS:ConfigureWakeEvents|ConfigureWakeEvents]]
|-
| 0x00030040
| Acknowledge. Writes cmdword[1] to [[PDN Registers#PDN_WAKE_REASON|PDN_WAKE_REASON]].
|}

= PDN DSP Service "pdn:d" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C0
| (bool enable, bool reset, bool deassertResetAfterReset) Enables and/or resets the DSP and/or holds it in reset
|}

= PDN I2S Service "pdn:i" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010040
| This sets bit0 in [[PDN Registers#PDN_I2S1_CNT|PDN_I2S1_CNT]] to u8 cmd+4.
|-
| 0x00020040
| This sets bit1 in [[PDN Registers#PDN_I2S2_CNT|PDN_I2S2_CNT]] to u8 cmd+4.
|}

Used by [[Codec Services]].

= PDN GSP service "pdn:g" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C0
| (bool enableClock, bool resetEngines, bool resetRegisters) Enables and/or resets the GPU, see [[PDN Registers#PDN_GPU_CNT|PDN_GPU_CNT]]
|}

= PDN Camera Service "pdn:c" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010040
| This sets bit0 in [[PDN Registers#PDN_CAMERA_CNT|PDN_CAMERA_CNT]] to u8 cmd+4.
|-
| 0x000200000
| This writes [[PDN Registers#PDN_CAMERA_CNT|PDN_CAMERA_CNT]] & 1 to u8 cmdreply+8.
|}

PDNS:ConfigureWakeEvents

2025-08-03T07:51:33Z

TimmSkiller: Created page with "=Request= {{IPC/Request}} {{IPC/RequestHeader|0x0002|2|0}} {{IPC/RequestEntry|Wake events to enable}} {{IPC/RequestEntry|Wake events to clear/acknowledge}} {{IPC/RequestEnd}} =Response= {{IPC/Request}} {{#vardefine:ipc_offset|0}} {{IPC/RequestHeader|0x0002|1|0}} {{IPC/RequestEntry|Result code}} {{IPC/RequestEnd}} =Description= Configures events that will wake the system, and acknowledges specified wake..."

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x0002|2|0}}
{{IPC/RequestEntry|[[PDN_Registers#PDN_WAKE_ENABLE|Wake events]] to enable}}
{{IPC/RequestEntry|[[PDN_Registers#PDN_WAKE_ENABLE|Wake events]] to clear/acknowledge}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x0002|1|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEnd}}

=Description=
Configures events that will wake the system, and acknowledges specified wake events.

First, wake events that should be enabled are acknowledged (because they occurred before this policy change) using [[PDN_Registers#PDN_WAKE_REASON|PDN_WAKE_REASON]]. Then, [[PDN_Registers#PDN_WAKE_ENABLE|PDN_WAKE_ENABLE]] is updated to the given set of events to enable. Finally, all wake events other than the enabled ones are cleared/acknowledged in [[PDN_Registers#PDN_WAKE_REASON|PDN_WAKE_REASON]].

PDN Services

2025-08-03T07:30:15Z

TimmSkiller: link to GetWakeStatus command page

[[Category:Services]]

= PDN PTM Service "pdn:s" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010000
| [[PDNS:GetWakeStatus|GetWakeStatus]]
|-
| 0x00020080
| ConfigureWakeEvents. [[PDN Registers#PDN_WAKE_REASON|PDN_WAKE_REASON]] = cmdword[2] & cmdword[1]. This then writes cmdword[1] to [[PDN Registers#PDN_WAKE_ENABLE|PDN_WAKE_ENABLE]]. [[PDN Registers#PDN_WAKE_REASON|PDN_WAKE_REASON]] = cmdword[2] & ~cmdword[1].
|-
| 0x00030040
| Acknowledge. Writes cmdword[1] to [[PDN Registers#PDN_WAKE_REASON|PDN_WAKE_REASON]].
|}

= PDN DSP Service "pdn:d" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C0
| (bool enable, bool reset, bool deassertResetAfterReset) Enables and/or resets the DSP and/or holds it in reset
|}

= PDN I2S Service "pdn:i" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010040
| This sets bit0 in [[PDN Registers#PDN_I2S1_CNT|PDN_I2S1_CNT]] to u8 cmd+4.
|-
| 0x00020040
| This sets bit1 in [[PDN Registers#PDN_I2S2_CNT|PDN_I2S2_CNT]] to u8 cmd+4.
|}

Used by [[Codec Services]].

= PDN GSP service "pdn:g" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C0
| (bool enableClock, bool resetEngines, bool resetRegisters) Enables and/or resets the GPU, see [[PDN Registers#PDN_GPU_CNT|PDN_GPU_CNT]]
|}

= PDN Camera Service "pdn:c" =
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x00010040
| This sets bit0 in [[PDN Registers#PDN_CAMERA_CNT|PDN_CAMERA_CNT]] to u8 cmd+4.
|-
| 0x000200000
| This writes [[PDN Registers#PDN_CAMERA_CNT|PDN_CAMERA_CNT]] & 1 to u8 cmdreply+8.
|}

PDNS:GetWakeStatus

2025-08-03T07:29:27Z

TimmSkiller: Created page with "=Request= {{IPC/Request}} {{IPC/RequestHeader|0x0001|0|0}} {{IPC/RequestEnd}} =Response= {{IPC/Request}} {{#vardefine:ipc_offset|0}} {{IPC/RequestHeader|0x0001|3|0}} {{IPC/RequestEntry|Result code}} {{IPC/RequestEntry|PDN_WAKE_ENABLE value}} {{IPC/RequestEntry|PDN_WAKE_REASON value}} {{IPC/RequestEnd}} =Description= Returns the current values of the PDN_WAKE_REASON and..."

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x0001|0|0}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x0001|3|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEntry|[[PDN_Registers#PDN_WAKE_ENABLE|PDN_WAKE_ENABLE]] value}}
{{IPC/RequestEntry|[[PDN_Registers#PDN_WAKE_REASON|PDN_WAKE_REASON]] value}}
{{IPC/RequestEnd}}

=Description=
Returns the current values of the [[PDN_Registers#PDN_WAKE_REASON|PDN_WAKE_REASON]] and [[PDN_Registers#PDN_WAKE_ENABLE|PDN_WAKE_ENABLE]] registers.

Filesystem services

2025-07-11T07:00:01Z

TimmSkiller: /* Filenames and Paths */

= Services =
{{Anchor|FS}}{{Anchor|FSUSER}}{{Anchor|fs:USER}}
== Filesystem service "fs:USER" ==
You can at most have 32 FS archive handles.

{| class="wikitable" border="1"
|-
! Command Header
! Available since system version
! Description
! scope="col" width="400" | Required [[NCCH/Extended_Header|exheader]] access info bitmask
|-
| 0x000100C6
|?
| [[FS:Dummy1|Dummy1]]
| None
|-
| 0x040100C4
|?
| [[FS:Control|Control]]
| None
|-
| 0x08010002
|?
| [[FS:Initialize|Initialize]]
| None
|-
| 0x080201C2
|?
| [[FS:OpenFile|OpenFile]]
| None
|-
| 0x08030204
|?
| [[FS:OpenFileDirectly|OpenFileDirectly]]
| None
|-
| 0x08040142
|?
| [[FS:DeleteFile|DeleteFile]]
| None
|-
| 0x08050244
|?
| [[FS:RenameFile|RenameFile]]
| None
|-
| 0x08060142
|?
| [[FS:DeleteDirectory|DeleteDirectory]]
| None
|-
| 0x08070142
|?
| [[FS:DeleteDirectoryRecursively|DeleteDirectoryRecursively]]
| None
|-
| 0x08080202
|?
| [[FS:CreateFile|CreateFile]]
| None
|-
| 0x08090182
|?
| [[FS:CreateDirectory|CreateDirectory]]
| None
|-
| 0x080A0244
|?
| [[FS:RenameDirectory|RenameDirectory]]
| None
|-
| 0x080B0102
|?
| [[FS:OpenDirectory|OpenDirectory]]
| None
|-
| 0x080C00C2
|?
| [[FS:OpenArchive|OpenArchive]]
| Each archive ID code has separate access info bitmasks, if it has any
|-
| 0x080D0144
|?
| [[FS:ControlArchive|ControlArchive]]
| None
|-
| 0x080E0080
|?
| [[FS:CloseArchive|CloseArchive]]
| None
|-
| 0x080F0180
|?
| [[FS:Obsoleted_2_0_FormatThisUserSaveData|Obsoleted_2_0_FormatThisUserSaveData]]
| None
|-
| 0x08100200
|?
| [[FS:Obsoleted_3_0_CreateSystemSaveData|Obsoleted_3_0_CreateSystemSaveData]]
| 0x4, for when the input saveID doesn't match the exheader saveID
|-
| 0x08110040
|?
| [[FS:Obsoleted_3_0_DeleteSystemSaveData|Obsoleted_3_0_DeleteSystemSaveData]]
| 0x1004, for when the input saveID doesn't match the exheader saveID
|-
| 0x08120080
|?
| [[FS:GetFreeBytes|GetFreeBytes]]
| None
|-
| 0x08130000
|?
| [[FS:GetCardType|GetCardType]]
| 0x1017
|-
| 0x08140000
|?
| [[FS:GetSdmcArchiveResource|GetSdmcArchiveResource]]
| None
|-
| 0x08150000
|?
| [[FS:GetNandArchiveResource|GetNandArchiveResource]]
| 0x1007
|-
| 0x08160000
|?
| [[FS:GetSdmcFatfsError|GetSdmcFatfsError]]
| 0x2
|-
| 0x08170000
|?
| [[FS:IsSdmcDetected|IsSdmcDetected]]
| None
|-
| 0x08180000
|?
| [[FS:IsSdmcWritable|IsSdmcWritable]]
| None
|-
| 0x08190042
|?
| [[FS:GetSdmcCid|GetSdmcCid]]
| 0x2
|-
| 0x081A0042
|?
| [[FS:GetNandCid|GetNandCid]]
| 0x2
|-
| 0x081B0000
|?
| [[FS:GetSdmcSpeedInfo|GetSdmcSpeedInfo]]
| 0x2
|-
| 0x081C0000
|?
| [[FS:GetNandSpeedInfo|GetNandSpeedInfo]]
| 0x2
|-
| 0x081D0042
|?
| [[FS:GetSdmcLog|GetSdmcLog]]
| 0x2
|-
| 0x081E0042
|?
| [[FS:GetNandLog|GetNandLog]]
| 0x2
|-
| 0x081F0000
|?
| [[FS:ClearSdmcLog|ClearSdmcLog]]
| 0x2
|-
| 0x08200000
|?
| [[FS:ClearNandLog|ClearNandLog]]
| 0x2
|-
| 0x08210000
|?
| [[FS:CardSlotIsInserted|CardSlotIsInserted]]
| 0x1017
|-
| 0x08220000
|?
| [[FS:CardSlotPowerOn|CardSlotPowerOn]]
| 0x2
|-
| 0x08230000
|?
| [[FS:CardSlotPowerOff|CardSlotPowerOff]]
| 0x2
|-
| 0x08240000
|?
| [[FS:CardSlotGetCardIFPowerStatus|CardSlotGetCardIFPowerStatus]]
| 0x2
|-
| 0x08250040
|?
| [[FS:CardNorDirectCommand|CardNorDirectCommand]]
| 0x2
|-
| 0x08260080
|?
| [[FS:CardNorDirectCommandWithAddress|CardNorDirectCommandWithAddress]]
| 0x2
|-
| 0x08270082
|?
| [[FS:CardNorDirectRead|CardNorDirectRead]]
| 0x2
|-
| 0x082800C2
|?
| [[FS:CardNorDirectReadWithAddress|CardNorDirectReadWithAddress]]
| 0x2
|-
| 0x08290082
|?
| [[FS:CardNorDirectWrite|CardNorDirectWrite]]
| 0x2
|-
| 0x082A00C2
|?
| [[FS:CardNorDirectWriteWithAddress|CardNorDirectWriteWithAddress]]
| 0x2
|-
| 0x082B00C2
|?
| [[FS:CardNorDirectRead_4xIO|CardNorDirectRead_4xIO]]
| 0x2
|-
| 0x082C0082
|?
| [[FS:CardNorDirectCpuWriteWithoutVerify|CardNorDirectCpuWriteWithoutVerify]]
| 0x2
|-
| 0x082D0040
|?
| [[FS:CardNorDirectSectorEraseWithoutVerify|CardNorDirectSectorEraseWithoutVerify]]
| 0x2
|-
| 0x082E0040
|?
| [[FS:GetProductInfo|GetProductInfo]]
| 0x1005
|-
| 0x082F0040
|?
| [[FS:GetProgramLaunchInfo|GetProgramLaunchInfo]]
| 0x1005
|-
| 0x08300182
|?
| [[FS:Obsoleted_3_0_CreateExtSaveData|Obsoleted_3_0_CreateExtSaveData]]
| 0xC, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08310180
|?
| [[FS:Obsoleted_3_0_CreateSharedExtSaveData|Obsoleted_3_0_CreateSharedExtSaveData]]
| 0x1005
|-
| 0x08320102
|?
| [[FS:Obsoleted_3_0_ReadExtSaveDataIcon|Obsoleted_3_0_ReadExtSaveDataIcon]]
| 0x100D, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08330082
|?
| [[FS:Obsoleted_3_0_EnumerateExtSaveData|Obsoleted_3_0_EnumerateExtSaveData]]
| 0x1005
|-
| 0x08340082
|?
| [[FS:Obsoleted_3_0_EnumerateSharedExtSaveData|Obsoleted_3_0_EnumerateSharedExtSaveData]]
| 0x1005
|-
| 0x08350080
|?
| [[FS:Obsoleted_3_0_DeleteExtSaveData|Obsoleted_3_0_DeleteExtSaveData]]
| 0x100D, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08360080
|?
| [[FS:Obsoleted_3_0_DeleteSharedExtSaveData|Obsoleted_3_0_DeleteSharedExtSaveData]]
| 0x1005
|-
| 0x08370040
|?
| [[FS:SetCardSpiBaudRate|SetCardSpiBaudRate]]
| 0x2
|-
| 0x08380040
|?
| [[FS:SetCardSpiBusMode|SetCardSpiBusMode]]
| 0x2
|-
| 0x08390000
|?
| [[FS:SendInitializeInfoTo9|SendInitializeInfoTo9]]
| None
|-
| 0x083A0100
|?
| [[FS:GetSpecialContentIndex|GetSpecialContentIndex]]
| 0x1005
|-
| 0x083B00C2
|?
| [[FS:GetLegacyRomHeader|GetLegacyRomHeader]]
| 0x1015
|-
| 0x083C00C2
|?
| [[FS:GetLegacyBannerData|GetLegacyBannerData]]
| 0x1015
|-
| 0x083D0100
|?
| [[FS:CheckAuthorityToAccessExtSaveData|CheckAuthorityToAccessExtSaveData]]
| 0x44
|-
| 0x083E00C2
|?
| [[FS:QueryTotalQuotaSize|QueryTotalQuotaSize]]
| None
|-
| 0x083F00C0
|?
| [[FS:Obsoleted_3_0_GetExtDataBlockSize|Obsoleted_3_0_GetExtDataBlockSize]]
| None
|-
| 0x08400040
|?
| [[FS:AbnegateAccessRight|AbnegateAccessRight]]
|?
|-
| 0x08410000
|?
| [[FS:DeleteSdmcRoot|DeleteSdmcRoot]]
| 0x1005
|-
| 0x08420040
|?
| [[FS:DeleteAllExtSaveDataOnNand|DeleteAllExtSaveDataOnNand]]
| 0x1005
|-
| 0x08430000
|?
| [[FS:InitializeCtrFileSystem|InitializeCtrFileSystem]]
| None
|-
| 0x08440000
|?
| [[FS:CreateSeed|CreateSeed]]
| 0x2
|-
| 0x084500C2
|?
| [[FS:GetFormatInfo|GetFormatInfo]]
|?
|-
| 0x08460102
|?
| [[FS:GetLegacyRomHeader2|GetLegacyRomHeader2]]
| 0x1015
|-
| 0x08470180
|?
| [[FS:Obsoleted_2_0_FormatCtrCardUserSaveData|Obsoleted_2_0_FormatCtrCardUserSaveData]]
| 0x6
|-
| 0x08480042
|?
| [[FS:GetSdmcCtrRootPath|GetSdmcCtrRootPath]]
| 0x100D
|-
| 0x08490040
|?
| [[FS:GetArchiveResource|GetArchiveResource]]
|?
|-
| 0x084A0002
|?
| [[FS:ExportIntegrityVerificationSeed|ExportIntegrityVerificationSeed]]
| 0x4000
|-
| 0x084B0002
|?
| [[FS:ImportIntegrityVerificationSeed|ImportIntegrityVerificationSeed]]
| 0x4000
|-
| 0x084C0242
|?
| [[FS:FormatSaveData|FormatSaveData]]
| 0x6, in some cases this write isn't needed however
|-
| 0x084D0102
|?
| [[FS:GetLegacySubBannerData|GetLegacySubBannerData]]
| 0x1015
|-
| 0x084E0342
|?
| [[FS:UpdateSha256Context|UpdateSha256Context]]
| 0x5
|-
| 0x084F0102
|?
| [[FS:ReadSpecialFile|ReadSpecialFile]]
| None
|-
| 0x08500040
|?
| [[FS:GetSpecialFileSize|GetSpecialFileSize]]
| None
|-
| 0x08510242
| [[3.0.0-5]]
| [[FS:CreateExtSaveData|CreateExtSaveData]]
| Shared extdata: 0x101005. Regular extdata in certain cases: 0xC
|-
| 0x08520100
| [[3.0.0-5]]
| [[FS:DeleteExtSaveData|DeleteExtSaveData]]
| Shared extdata: 0x101005. Regular extdata in certain cases: 0x10100D
|-
| 0x08530142
| [[3.0.0-5]]
| [[FS:ReadExtSaveDataIcon|ReadExtSaveDataIcon]]
| 0x10100D (this doesn't apply in certain cases, however)
|-
| 0x085400C0
| [[3.0.0-5]]
| [[FS:GetExtDataBlockSize|GetExtDataBlockSize]]
| 0x10100D (this doesn't apply in certain cases, however)
|-
| 0x08550102
| [[3.0.0-5]]
| [[FS:EnumerateExtSaveData|EnumerateExtSaveData]]
| 0x101005
|-
| 0x08560240
| [[3.0.0-5]]
| [[FS:CreateSystemSaveData|CreateSystemSaveData]]
| 0x4 (this doesn't apply in certain cases, however)
|-
| 0x08570080
| [[3.0.0-5]]
| [[FS:DeleteSystemSaveData|DeleteSystemSaveData]]
| 0x1004 (this doesn't apply in certain cases, however)
|-
| 0x08580000
| [[3.0.0-5]]
| [[FS:StartDeviceMoveAsSource|StartDeviceMoveAsSource]]
| 0x2004
|-
| 0x08590200
| [[3.0.0-5]]
| [[FS:StartDeviceMoveAsDestination|StartDeviceMoveAsDestination]]
| 0x2004
|-
| 0x085A00C0
| [[3.0.0-5]]
| [[FS:SetArchivePriority|SetArchivePriority]]
| None
|-
| 0x085B0080
| [[3.0.0-5]]
| [[FS:GetArchivePriority|GetArchivePriority]]
| None
|-
| 0x085C00C0
| [[3.0.0-5]]
| [[FS:SetCtrCardLatencyParameter|SetCtrCardLatencyParameter]]
| 0xE
|-
| 0x085D01C0
| [[3.0.0-5]]
| [[FS:SetFsCompatibilityInfo|SetFsCompatibilityInfo]]
| 0x100001
|-
| 0x085E0040
| [[3.0.0-5]]
| [[FS:ResetCardCompatibilityParameter|ResetCardCompatibilityParameter]]
| 0xE
|-
| 0x085F0040
| [[3.0.0-5]]
| [[FS:SwitchCleanupInvalidSaveData|SwitchCleanupInvalidSaveData]]
| 0x12004
|-
| 0x08600042
| [[3.0.0-5]]
| [[FS:EnumerateSystemSaveData|EnumerateSystemSaveData]]
| 0x2004
|-
| 0x08610042
| [[3.0.0-5]]
| [[FS:InitializeWithSdkVersion|InitializeWithSdkVersion]]
| None
|-
| 0x08620040
| [[3.0.0-5]]
| [[FS:SetPriority|SetPriority]]
| None
|-
| 0x08630000
| [[3.0.0-5]]
| [[FS:GetPriority|GetPriority]]
| None
|-
| 0x08640000
| [[3.0.0-5]]
| [[FS:Obsoleted_4_0_GetNandInfo|Obsoleted_4_0_GetNandInfo]]
| Stubbed, this returns an error
|-
| 0x08650140
| [[4.0.0-7]]
| [[FS:SetSaveDataSecureValue|SetSaveDataSecureValue]]
| 0x121004 (in certain cases this doesn't apply, however)
|-
| 0x086600C0
| [[4.0.0-7]]
| [[FS:GetSaveDataSecureValue|GetSaveDataSecureValue]]
| 0x121004 (in certain cases this doesn't apply, however)
|-
| 0x086700C4
| [[4.0.0-7]]
| [[FS:ControlSecureSave|ControlSecureSave]]
| 0x121004
|-
| 0x08680000
| [[4.0.0-7]]
| [[FS:GetMediaType|GetMediaType]]
| None
|-
| 0x08690000
| [[4.0.0-7]]
| [[FS:Obsoleted_4_0_GetNandEraseCount|Obsoleted_4_0_GetNandEraseCount]]
| Stubbed, this returns an error.
|-
| 0x086A0082
| [[4.0.0-7]]
| [[FS:ReadNandReport|ReadNandReport]]
| None
|-
| 0x086B00C2
|?
| [[FS:SetOtherSaveDataSecureValue|SetOtherSaveDataSecureValue]]
| 0x121004
|-
| 0x086C00C2
|?
| [[FS:GetOtherSaveDataSecureValue|GetOtherSaveDataSecureValue]]
| 0x121004
|-
| 0x086D0080
|?
| [[FS:BeginSaveDataMove|BeginSaveDataMove]]
| 0x20004
|-
| 0x086E00C0
|?
| [[FS:SetThisSaveDataSecureValue|SetThisSaveDataSecureValue]]
|None
|-
| 0x086F0040
|?
| [[FS:GetThisSaveDataSecureValue|GetThisSaveDataSecureValue]]
| None
|-
| 0x087000C2
|?
| [[FS:CheckArchive|CheckArchive]]
|None
|-
| 0x08710140
| ?
| [[FS:TransferSaveDataCMAC|TransferSaveDataCMAC]]
| 0x20004
|-
| 0x08720200
|?
| [[FS:RegisterTitleContentOverlay|RegisterTitleContentOverlay]]
| 0x80004
|-
| 0x08730100
|?
| [[FS:UnregisterTitleContentOverlay|UnregisterTitleContentOverlay]]
| 0x80004
|-
| 0x08740000
|?
| [[FS:UnregisterAllTitleContentOverlays|UnregisterAllTitleContentOverlays]]
| 0x80004
|-
| 0x08750140
|?
| [[FS:SetSaveArchiveSecureValue|SetSaveArchiveSecureValue]]
|None
|-
| 0x087600C0
|?
| [[FS:GetSaveArchiveSecureValue|GetSaveArchiveSecureValue]]
|None
|-
| 0x08770140
|?
| [[FS:RegisterSpecialTitleContent|RegisterSpecialTitleContent]]
| 0x80004
|-
| 0x08780100
|?
| [[FS:UnregisterSpecialTitleContent|UnregisterSpecialTitleContent]]
| 0x80004
|-
| 0x087900C2
| ?
| Same as [[FS:GetLegacyBannerData|GetLegacyBannerData]], except for the last parameter this internally passes u8 value 0x1 instead of 0x0, for the FSPXI command.
| 0x101015
|-
| 0x087A0180
| [[9.6.0-24|9.6.0-X]]
| [[FS:AddSeed|AddSeed]]
| 0x200000
|-
| 0x087B0080
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetSeed|GetSeed]]
| 0x200000
|-
| 0x087C0080
| [[9.6.0-24|9.6.0-X]]
| [[FS:DeleteSeed|DeleteSeed]]
| 0x200000
|-
| 0x087D0000
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetNumSeeds|GetNumSeeds]]
| 0x200000
|-
| 0x087E0042
| [[9.6.0-24|9.6.0-X]]
| [[FS:ListSeeds|ListSeeds]]
| 0x200000
|-
| 0x087F0100
| [[9.6.0-24|9.6.0-X]]
| [[FS:TitleContentHasSeed|TitleContentHasSeed]]
| 0x200000
|-
| 0x08800880
| [[9.6.0-24|9.6.0-X]]
| [[FS:AddTitleTag|AddTitleTag]]
| 0x200000
|-
| 0x08810080
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetTitleTag|GetTitleTag]]
| 0x200000
|-
| 0x08820080
| [[9.6.0-24|9.6.0-X]]
| [[FS:DeleteTitleTag|DeleteTitleTag]]
| 0x200000
|-
| 0x08830000
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetNumTitleTags|GetNumTitleTags]]
| 0x200000
|-
| 0x08840042
| [[9.6.0-24|9.6.0-X]]
| [[FS:ListTitleTags|ListTitleTags]]
| 0x200000
|-
| 0x088500C0
| [[9.6.0-24|9.6.0-X]]
| [[FS:CheckTitleSeed|CheckTitleSeed]]
| 0x200000
|-
| 0x088600C0
| [[11.1.0-34|11.1.0-X]]
| [[FS:CheckUpdatedDat|CheckUpdatedDat]]
| 0x80000
|}

Note: The question marks from Dummy1 to GetSpecialFileSize on the "available since system version" field are mainly there because I think that most of these are necessary for the main system to function, so theoretically that would mean that since the creation of the 3DS these were available, or since launch if that makes more sense. But because of the peculiar nature of some of the functions, they will remain question marks until they can be confirmed 100%.

When access rights are required for a command, at least one of the bits in the process access info specified in the above table for the command must be set. Error 0xD9004676 is returned when a process attempts to use a command which it doesn't have access rights for the command. The exheader access info field is all zero's for most applications. Note that the permissions listed in the above table is for system-version v2.x, therefore permission bit(s) added with newer FIRM may be missing from this.

Each session for fs:USER has separate permissions, initially these are set to all zero's for new fs:USER sessions. The permissions/etc for fs:USER sessions are initialized via [[FS:Initialize]](loaded from the user process exheader).

{{Anchor|FSLDR}}{{Anchor|fs:LDR}}

== Filesystem service "fs:LDR" ==
This service is identical to fs:USER, except [[FS:OpenArchive]] archive 0x2345678E can only be accessed with fs:LDR.

{{Anchor|FSReg}}{{Anchor|FSREG}}{{Anchor|fs:REG}}
== ProgramRegistry service "fs:REG" ==
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C6
| [[FSReg:Dummy1|Dummy1]]
|-
| 0x040103C0
| [[FSReg:Register|Register]]
|-
| 0x04020040
| [[FSReg:Unregister|Unregister]]
|-
| 0x040300C0
| [[FSReg:GetProgramInfo|GetProgramInfo]]
|-
| 0x04040100
| [[FSReg:LoadProgram|LoadProgram]]
|-
| 0x04050080
| [[FSReg:UnloadProgram|UnloadProgram]]
|-
| 0x04060080
| [[FSReg:CheckHostLoadId|CheckHostLoadId]]
|}

Only two sessions can be opened for this service at a time, hence no other processes can use this due to [[Process_Manager_Services|pm-module]] and [[Loader_Services|loader]] using this.

=File and directory access=
==Files==
File session handles obtained via [[FS:OpenFile]] and [[FS:OpenFileDirectly]] can be used to access files through a service-like interface, despite not being an actual service registered using [[SRV:RegisterService]]. To use this service-like interface, simply call the SendSyncRequest SVC with a file session handle, using the IPC buffer in thread-local storage for parameters and responses, just like you would with a proper service.

{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C6
| [[FSFile:Dummy1|Dummy1]]
|-
| 0x040100C4
| [[FSFile:Control|Control]]
|-
| 0x08010100
| [[FSFile:OpenSubFile|OpenSubFile]]
|-
| 0x080200C2
| [[FSFile:Read|Read]]
|-
| 0x08030102
| [[FSFile:Write|Write]]
|-
| 0x08040000
| [[FSFile:GetSize|GetSize]]
|-
| 0x08050080
| [[FSFile:SetSize|SetSize]]
|-
| 0x08060000
| [[FSFile:GetAttributes|GetAttributes]]
|-
| 0x08070040
| [[FSFile:SetAttributes|SetAttributes]]
|-
| 0x08080000
| [[FSFile:Close|Close]]
|-
| 0x08090000
| [[FSFile:Flush|Flush]]
|-
| 0x080A0040
| [[FSFile:SetPriority|SetPriority]]
|-
| 0x080B0000
| [[FSFile:GetPriority|GetPriority]]
|-
| 0x080C0000
| [[FSFile:OpenLinkFile|OpenLinkFile]]
|-
| 0x0C010100
| [[FSFile:GetAvailable|GetAvailable]]
|}

==Directories==
Directory session handles obtained via [[FS:OpenDirectory]] are usable via a service-like interface, following the exact same procedure described above for file sessions.
{| class="wikitable" border="1"
|-
! Command Header
! Available since system version
! Description
|-
| 0x000100C6
| [[1.0.0-0]]
| [[FSDir:Dummy1|Dummy1]]
|-
| 0x040100C4
| [[1.0.0-0]]
| [[FSDir:Control|Control]]
|-
| 0x08010042
| [[1.0.0-0]]
| [[FSDir:Read|Read]]
|-
| 0x08020000
| [[1.0.0-0]]
| [[FSDir:Close|Close]]
|-
| 0x08030040
| ?
| [[FSDir:SetPriority|SetPriority]]
|-
| 0x08040000
| ?
| [[FSDir:GetPriority|GetPriority]]
|}

= Archives =
{| class="wikitable" border="1"
|-
! ArchiveId
! Description
! Accessible via [[Filesystem_services|FS]]
! Accessible via [[Filesystem_services_PXI|FSPXI]]
! Only accessible by Process9 internally
! Requires binary [[FS:OpenFile|Lowpath]]
! Required exheader FS access info bitmask
|-
| 0x00000003
| SelfNCCH (including [[#RomFS|RomFS]])
| Yes
| No
| No
| No
| None
|-
| 0x00000004
| SaveData (the saveID/mediatype for this is loaded from data originally from the user process' exheader)
| Yes
| No
| No
| No
| None
|-
| 0x00000006
| ExtSaveData
| Yes
| No
| No
| Yes
| 0x100D, when the input extdataID isn't listed in the exheader.
|-
| 0x00000007
| Shared ExtSaveData
| Yes
| No
| No
| Yes
| None
|-
| 0x00000008
| SystemSaveData
| Yes
| No
| No
| Yes
| 0x4, when the input saveID doesn't match the exheader system-saveID.
|-
| 0x00000009
| SDMC
| Yes
| Yes
| No
| No
| 0x8E
|-
| 0x0000000A
| SDMC Write-Only
| Yes
| No
| No
| No
| 0x808E
|-
| 0x12345678
| ExtSaveData for BOSS
| Yes
| No
| No
| Yes
| 0x44
|-
| 0x12345679
| CARD SPI FS
| Yes
| Yes
| No
| No
| 0x16
|-
| 0x1234567B
| ExtSaveData, and ExtSaveData for BOSS
| No
| Yes
| No
| Yes
|
|-
| 0x1234567C
| SystemSaveData
| No
| Yes
| No
| Yes
|
|-
| 0x1234567D
| NAND RW
| Yes
| Yes
| No
| No
| 0x800
|-
| 0x1234567E
| NAND RO
| Yes
| Yes
| No
| No
| 0x200
|-
| 0x1234567F
| NAND RO Write FS
| No
| Yes
| No
| No
| ?
|-
| 0x12345680
| Extdata transfer. Used for transferring [[Extdata#NAND_Shared_Extdata|NAND Shared Extdata]] during [[System_Transfer#System_Save_Data_/_Shared_Extdata_Transfer|system tranfers]].
| Yes
| Yes
| No
| Yes
| ?
|-
| 0x12345681
| System Savedata transfer. Used for transferring [[System_SaveData|System Save Data]] during [[System_Transfer#System_Save_Data_/_Shared_Extdata_Transfer|system tranfers]].
| Yes
| Yes
| No
| Yes
| ?
|-
| 0x12345682
| Unknown. There's code for this in spider v9.9, but that code isn't actually used.
| Yes
| No
| No
| Yes
| ?
|-
| 0x2345678A
| Title access. With FS, this allows accessing NCCH/NCSD contents (ExeFS, RomFS, checking if a content uses a seed, checking the validity of the installed seed). FSPXI, additionally, allows opening raw NCCH/NCSD NCCH contents and DSiWare contents for reading, along with encrypted save data.
| Yes
| Yes
| No
| Yes
| 0x1005
|-
| 0x2345678B
| Used internally by Process9 as the lowest level title access archive. Allows for opening various sections of a title (TMD, CMD, raw contents, DLC contents, raw save data (including public/private/banner saves for DSiWare), title and/or content import context files and /data directories for save data.
| No
| No
| Yes
| Yes
|
|-
| 0x2345678C
| Used internally to access [[Title_Database|Title Database (/dbs)]] files. For SD, <code>title.db</code> and <code>import.db</code>. For NAND, <code>title.db</code>, <code>import.db</code>, <code>tmp_t.db</code>, <code>tmp_i.db</code>, and <code>jumpid.db</code>.
| No
| No
| Yes
| Yes
|
|-
| 0x2345678D
| Used internally to access non-title /dbs files on the NAND: <code>certs.db</code> and <code>ticket.db</code>.
| No
| No
| Yes
| No
|
|-
| 0x2345678E
| FSPXI: Program Access (limited subset of merged main title + update/patch title access). For fs:LDR(used by the "loader" FIRM ARM11-process), only <code>exefs:/.code</code>. Not accessible with fs:USER.
| Yes
| Yes
| No
| Yes
| None, see description.
|-
| 0x567890AB
| NAND CTR FS
| No
| Yes
| No
| No
| ?
|-
| 0x567890AC
| TWL PHOTO
| Yes
| Yes
| No
| No
| ?
|-
| 0x567890AD
| TWLS (DSi Sound stores recordings here). This is mapped to the FAT12 image stored in the file at [[Twln/shared2/0000]].
| No
| Yes
| No
| No
| ?
|-
| 0x567890AE
| NAND TWL FS
| Yes
| Yes
| No
| No
| 0x100
|-
| 0x567890AF
| NAND W FS
| Yes
| Yes
| No
| No
| 0x100
|-
| 0x567890B0
| Internally creates the same "ID Storage" wrapper over the NAND that is used for SystemSaveData and Shared ExtData, but all operations are stubbed and return 0xE0C046F8.
| No
| Yes
| No
| No
|
|-
| 0x567890B1
| Gamecard SaveData (for check). This is a wrapper for UserSaveDataForCheck: the OpenArchive code for that is called with archive-lowpath TID=0/mediatype=2(gamecard).
| Yes
| No
| No
| No
| 0x6
|-
| 0x567890B2
| UserSaveData (for check). This is the same as the regular SaveData archive, except with this the savedata ID and mediatype is loaded from the input archive lowpath.
| Yes
| No
| No
| Yes
| 0x6
|-
| 0x567890B3
| [[3DS_Virtual_Console#NAND_Savegame|AGB Save Data]]
| No
| No
| Yes
| No
| -
|-
| 0x567890B4
| Similar to 0x567890B2 but can only access Accessible Save specified in [[NCCH/Extended_Header#Storage_Info|exheader]]?
| Yes
| No
| No
| Yes
| ?
|}

Archives listed as not requiring a binary lowpath, use lowpath type [[FS:OpenFile|empty]].

The above permission bitmasks are from v2.x, see the above Services section for how these are handled.

Archives CTR NAND, NAND RO Write FS, TWL NAND, NAND W FS, and CARD SPI FS require the corresponding process exheader access control mount flag to be set, in the exheader for any of the currently running ARM11 processes, for [[Filesystem_services_PXI|FSPXI]]. The access rights checked by [[Filesystem services|FS]] module for archive mounting with fs:USER, are stored in the process' exheader accessinfo.

The CARDSPI archive allows access to the gamecard CARD1 raw savedata flash(aka "cardspi:/" in [[FIRM|Process9]]), the file lowpath must be WCHAR "/". The "NAND W FS" archive allows access to the raw NAND image(aka "wnand:/" in Process9), the file lowpath must be WCHAR "/".

= Filenames and Paths =
{{Anchor|PathType}}
==PathType==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| -1
| Returned internally by Process9, when errors occur it seems(in particular when no nul-terminator was found in the input path). The data ptr is set to NULL.
|-
| 0x0
| INVALID - Specifies an invalid path
|-
| 0x1
| EMPTY - Specifies an empty path
|-
| 0x2
| BINARY - Non-text based path. Meaning is per-archive
|-
| 0x3
| ASCII - Text-based path with 7-bit ASCII characters padded to 8-bits each (signed char)
|-
| 0x4
| UTF16 - Text-based path with UTF-16 characters
|}

In IPC requests, sizes of ASCII and UTF16 paths must include space for the null-terminator.

== Binary LowPath ==
The format of the data that a binary LowPath points to is custom per archive.

=== SystemSaveData / Extdata / Shared Extdata Archive Path Data Format ===

==== DataAccessPath ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8 [[Mediatypes|Mediatype]]
|-
| 0x1 || 0x1 || only for NAND data (System Savedata / Shared Extdata), otherwise left 0:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || Accesses from/to <code>nand:/data/<ID0 of current system></code>
|-
| 1 || Accesses from/to <code>nand:/fixdata</code>
|-
| 2 || Accesses from/to <code>nand:/data/<ID0 from [[Filesystem_services#DeviceMoveContext|Device Move Context]]></code>
|}
|-
| 0x2 || 0x2 || padding
|}

==== SystemSaveData ====

===== FS =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 1
| save ID low (save ID high is 0)
|}

====== File Path ======
The file path is a cleartext ASCII or UTF16 file path (<code><file path></code>).

The file path would access the file at <code><base path>/sysdata/<save ID low>/<save ID high>/<file path></code>.
Note that <code>/<file path></code> refers to the virtual file system inside the </code><save ID high></code> file.

===== FSPXI / FS System Savedata Transfer / FSPXI System Savedata Transfer =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|}

====== File Path ======
{| class="wikitable" border="1"
|-
! Index word !! Description
|-
| 0 || save ID low
|-
| 1 || save ID high
|}

The file path would access the file at <code><base path>/sysdata/<save ID low>/<save ID high></code>.

==== Extdata / Shared Extdata ====

===== FS / FS Extdata Transfer / FSPXI Extdata Transfer =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 1
| ext save ID low
|-
| 2
| ext save ID high
|}

This refers to the extdata filesystem structure's base directory at <code><base path>/extdata/<ext save ID low>/<ext save ID high></code>.

====== File Path ======
The file path is a cleartext ASCII or UTF16 file path (<code><file path></code>).

For FS Extdata, this would acccess <code><base path>/extdata/<save ID low>/<save ID high>/<directory ID>/<file ID>/<file path></code>, and <code>/<file path></code> refers to the virtual file system inside the </code><file ID></code> file.

For FS / FSPXI Extdata Transfer, this accesses <code><base path>/extdata/<save ID low>/<save ID high>/<file path></code>.

=== UserSaveDataForCheck Archive Path Data Format ===
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Mediatypes|Mediatype]] (must be non-zero)
|-
| 1
| Lower word saveid
|-
| 2
| Upper word saveid
|}

The file/directory lowpath for this FS archive is a text path in the [[Savegames|savegame]] filesystem.

=== 0x567890B4 Archive Path Data Format ===
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Mediatypes|Mediatype]]
|-
| 1
| <code><nowiki>Lower_word_saveid >> 8</nowiki></code> ?
|-
| 2
| Unknown. Game calculate this using formula <code><nowiki>0xFFFFFF00 | unknown_b</nowiki></code>
|}

=== Title Access Archive Path Data Format ===
==== Title Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || High-level NCCH content access
|-
| 1 || Save data access (high-level, decrypted)
|-
| 2 || Raw content (low-level NCCH/SRL) access
|-
| 3 || Banner save data access (for DSiWare titles)
|-
| 4 || FS only: Save data transfer (internally uses generated data from [[FS:BeginSaveDataMove]] as the IV for "Save data access (low-level, encrypted)")
|-
| 5 || Save data access (low-level, encrypted)
|}

==== NCCH Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || RomFS
|-
| 1 || <code>exefs:/.code</code>
|-
| 2 || System Menu Data (<code>exefs:/icon</code>, <code>exefs:/banner</code>, <code>exefs:/logo</code>)
|-
| 3 || NCCH Header(s)
|-
| 4 || "is seeded" check
|-
| 5 || Seed verify/validate
|}

==== NCCH Header Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || [[NCCH/Extended_Header|Extheader]] (0x0-0x400)
|-
| 1 || [[NCCH/Extended_Header|Extheader]] AccessDesc (0x400-0x800)
|-
| 2 || Raw [[NCCH#NCCH_Header|NCCH Header]]
|}

==== Archive Path ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || Program ID (Title ID)
|-
| 0x9 || 0x1 || [[Mediatypes|Media Type]]
|-
| 0xA || 0x7 || padding
|}

==== File Path ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || [[Filesystem_services#Title_Access_Type|Title Access Type]]
|-
| 0x4 || 0x10 || Dynamic data depending on [[Filesystem_services#Title_Access_Type|Title Access Type]]:

{| class="wikitable" border="1"
|-
! High Level NCCH Access !! Save Data Access (high level) !! Raw Content !! FS only: Save Data Transfer
|-
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Content index from TMD for NAND/SD titles
NCSD partition index for gamecards
|-
| 0x4 || 0x4 || [[Filesystem_services#NCCH_Access_Type|NCCH Access Type]]
|-
| 0x8 || 0x8 || Dynamic data depending on [[Filesystem_services#NCCH_Access_Type|NCCH Access Type]]:
For ExeFS, (System Menu Data / <code>exefs:/.code</code>),

{| class="wikitable" border="1"
| 8-byte ExeFS file name
|}

For Header Access,

{| class="wikitable" border="1"
| [[Filesystem_services#NCCH_Header_Access_Type|u64, NCCH Header Access Type]]
|}

For RomFS,

{| class="wikitable" border="1"
| [[NCCH#Content_Types|u64, Allowed content types flag]]
(<code>(1 << allowed_type_a) |

(1 << allowed_type_b)...</code>)
|}

|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x10 || 16-byte IV for save data crypto
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Content index from TMD for NAND/SD titles
NCSD partition index for gamecards
|-
| 0x4 || 0xC || padding
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Save data transfer key from [[FS:BeginSaveDataMove]]
|-
| 0x4 || 0xC || padding
|}
|}
|-
| 0x14 || 0x10 || 16-byte seed for titles that require one, or for validating a seed against the check value in the [[NCCH#NCCH_Header|NCCH Header]]'s check value.
If the title does not use a seed, this should not be included and size 0x14 should be used instead of 0x24.
|}

For encrypted save data access and banner save data access, the entire 0x10 portion of the dynamic data is left blank.

The "is seeded check" NCCH access type opens a virtual 1-byte file that reads either 0 or 1; this value is generated on-the-fly and will be 1 if ncchflags[7] has bit5 set (content uses seed), and 0 otherwise.

For NCCH sections that require a seed (e.g. <code>.code</code>, RomFS, etc.), the additional seed portion of the low path must be populated with the correct seed.

The "Seed Verify/Validate" NCCH access type also requires the seed portion of the lowpath. The target NCCH content is opened (with the opened file interface being stubbed, meaning no real reads/writes can be performed on it), and the given seed is used to calculate the seed check hash, and part of it is compared to the check value in the NCCH header. If it matches, opening the "file" succeeds, otherwise 0xD900458C is returned. If attempt is made to use the seed validation type on a content that does not use a seed, error 0xC92044E6 is returned.

==== FS Limitations ====

For FS, this archive functions the same, except for the following limitations:

- Only the title access types "High Level NCCH Access" and "High Level Save Data Access", and "Save Data Transfer" are allowed.

- For high level NCCH access, the types "RomFS", "System Menu Data", "Seeded check", and "Seed Check/Verify" are allowed.

- For "Seed Check/Verify", rather than providing the title seed in the file path (as is the case for FSPXI), the seed is retrieved from the seed database (meaning the file lowpath size is always 0x14 for FS).

=== Program Access / SelfNCCH access ===

Provides access to a "merged" archive of a base title and, optionally, a separate update (patch) title.

If no patch title exists, the base title is considered to be the patch title, i.e. turning all "patch" accesses into accesses to the base title.

==== Program Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description !! Accesses
|-
| 0 || RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default) || Base title
|-
| 1 || <code>exefs:/.code</code> || Patch title
|-
| 2 || System Menu Data (<code>exefs:/icon</code>, <code>exefs:/banner</code>, <code>exefs:/logo</code>) || Base title
|-
| 3 || Save Data (high level, decrypted) || -
|-
| 4 || RomFS (all [[NCCH#Content_Type|content types]]) || Base title
|-
| 5 || RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default) || Patch title
|}

==== Archive Path ====
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || u64, Program Handle from [[PXIPM:RegisterProgram]]
|}

==== File Path ====
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || [[Filesystem_services#Program_Access_Type|Program Access Type]]
|-
| 0x4 || 0x8 || Dynamic data depending on [[Filesystem_services#Program_Access_Type|Program Access Type]]:
{| class="wikitable" border="1"
|-
! ExeFS files (System Menu Data, etc.) !! RomFS of base title (all [[NCCH#Content_Type|content types]])
|-
|
{| class="wikitable" border="1"
| 8-character ExeFS filename
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, content index of target content
|-
| 0x4 || 0x4 || padding
|}
|}
|}

==== FS Limitations ====

- FSPXI allows all access types.

- When used through fs:LDR by loader, FS only provides access to <code>exefs:/.code</code>.

- For SelfNCCH access, the only allowed access types are "RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default)" of the Base or Patch title, and "System Menu Data". Attempting to access "Save Data" results in error 0xE0E046BE, "RomFS (all [[NCCH#Content_Type|content types]])" in 0xF9604784, and "<code>exefs:/.code</code>" in 0xD9004676.

=== [[RomFS]] ===

Archives 0x3 and 0x2345678E both allow for accessing the [[RomFS#Level_3_Format|level-3 IVFC images]] for RomFS access. The main CXI RomFS is accessible via an all-zero 0xc-byte binary file-lowpath. The update RomFS can be accessed with the first u32 in the binary file-lowpath being set to 0x5. The user must handle parsing the filesystem used in the exposed image itself.

With FSPXI the returned data for RomFS is the entire RomFS section from the NCCH, starting at the IVFC header.

The 0x3 archive is an interface for the 0x2345678E archive with the current process programID+mediatype. The file lowpath is 3-words. These words are written to 0x2345678E-archive file_lowpath+0, with the rest of that lowpath set to all-zero(lowpath is different from archive 0x2345678A). File lowpath:
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| See above. The only values which FS-module doesn't allow to be used here are:
* 0x1: Error 0xE0E046BE.
* 0x3: Error 0xE0E046BE.
* 0x4: FS-module executes svcBreak when using this.
|-
| 1-2
| See above. Not validated by FS-module.
|}

=Anti Savegame Restore=
Anti Savegame Restore, internally referred to as ''Save Data Rollback Prevention'', is a feature originally implemented in the FS module with [[4.0.0-7]], which prevents the user from restoring previous versions of a savegame image. This feature is not used (in practice) for gamecard games. When an old version of the save is detected, the application will display an error regarding old savegame version, then delete and recreate the save data (similar to when it is corrupted).

==Implementation==
When creating the savedata, the application generates a secure value (a 64 bit unsigned integer), then stores it in either the [[DISA_and_DIFF#DISA_header|DISA save image header]] or the [[Filesystem_services#Anti_Savegame_Restore_Save_Data|Anti Savegame Restore Save Data]]. The application then uses the anti-savegame-restore commands ([[FS:SetSaveDataSecureValue]], [[FS:GetSaveDataSecureValue]], [[FS:SetOtherSaveDataSecureValue]], [[FS:GetOtherSaveDataSecureValue]], [[FS:SetThisSaveDataSecureValue]], [[FS:GetThisSaveDataSecureValue]], [[FS:SetSaveArchiveSecureValue]] and [[FS:GetSaveArchiveSecureValue]]) to verify the value known to the game for comparison with the value returned by FS, and to update the value in the corresponding storage location.

Each time the application writes to the savegame, the value should be updated by both the application and through FS. Usually, applications update this value by incrementing it. However, generating a new random-number or other methods of updating it can be used as well.

==Anti Savegame Restore Save Data==
The save data used for this feature is stored in [[System_SaveData|System Save Data]] ID 0x00010011 and contains only one file, named <code>DB</code>:

===Main Structure===
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1000 || Header
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8, version (usually 0)
|-
| 0x1 || 0x3 || padding
|-
| 0x4 || 0x4 || u32, number of secure value entries
|-
| 0x8 || 0xFF8 || completely unused, padding
|}
|-
| 0x1000 || 0x1C000 (8 * 14336) || [[Filesystem_services#SecureValueKey|Secure value keys]]
|-
| 0x1D000 || 0x1C000 (8 * 14336) || u64s, Secure values
|}

===SecureValueKey===
Depending on which command is used, secure value keys can be interpreted as:
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || u64, Title ID
|}
or:
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, [[Filesystem_services#SecureValueSlot|Secure Value Slot]]
|-
| 0x4 || 0x4 || u32, Unique ID
|}

==Applications using this feature==
* Animal Crossing: New Leaf
* Pokemon X & Y
* Pokemon Omega Ruby & Alpha Sapphire
* Pokemon Omega Ruby & Alpha Sapphire Demo
* Pokemon Shuffle
* Super Smash Bros
* Pokemon Red,Blue and Yellow (GB(C) VC)
* Rusty's Real Deal Baseball
* Megami Meguri

=SEEDDB and TITLETAG=
With [[9.6.0-24|9.6.0-X]] new [[System_SaveData]] with save ID 0x0001000F was added. This save data contains both the NCCH seed database (SEEDDB) and the title tag database (TITLETAG).

These databases are managed by the commands [[FS:AddSeed]], [[FS:GetSeed]], [[FS:DeleteSeed]], [[FS:GetNumSeeds]] and [[FS:ListSeeds]] for SEEDDB, and [[FS:AddTitleTag]], [[FS:GetTitleTag]], [[FS:DeleteTitleTag]], [[FS:GetNumTitleTags]], and [[FS:ListTitleTags]] for TITLETAG respectively.

Both the [[Home_Menu|HOME Menu]] and the [[NIM_Services|NIM]] module have access to these commands.

==SEEDDB==

Stored in the system savedata archive 0x0001000F as a file named <code>SEEDDB</code>, it contains the title-unique seed-data used for the new [[NCCH]] keyY generation added with FIRM [[9.6.0-24|9.6.0-X]].

The file follows a simple key-value format allowing the storage of seed data for up to 2000 unique title IDs.

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1000 || Header
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8, version (usually 0)
|-
| 0x1 || 0x3 || padding
|-
| 0x4 || 0x4 || u32, number of seed entries
|-
| 0x8 || 0xFF8 || completely unused, padding
|}
|-
| 0x1000 || 0x3E80 (8 * 2000) || u64s, Title IDs
|-
| 0x4E80 || 0x7D00 (16 * 2000) || Seed data, 16 bytes per seed
|}

==TITLETAG Database==

Stored in the system savedata archive 0x0001000F as a file named <code>TITLETAG</code>, it contains information used by the [[Home_Menu|HOME Menu]] to handle cases when a to-be-released title has been purchased already, that is, to properly install the seed required for [[NCCH]] keyY generation added with FIRM [[9.6.0-24|9.6.0-X]].

When a to-be-released title is purchased, the [[NIM_Services|NIM]] module installs a [[Filesystem_services#TitleTag|title tag]] with enough information about the title for the [[Home_Menu|HOME Menu]] to be able to initiate a seed import once the title has been released (and thus, the title's NCCH content lock seed). Until the title's seed is released, and while the title tag remains in the database, the HOME Menu will prevent the user from launching the software as it would not run without the seed. Once released, information from the title tag is used to download the seed, and, if successful, the title tag is removed from the database, making the software playable.

The file follows a simple key-value format allowing the storage of title tag data for up to 2000 unique title IDs.

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1000 || Header
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8, version (usually 0)
|-
| 0x1 || 0x3 || padding
|-
| 0x4 || 0x4 || u32, number of entries
|-
| 0x8 || 0xFF8 || completely unused, padding
|}
|-
| 0x1000 || 0x3E80 (8 * 2000) || u64s, Title IDs
|-
| 0x4E80 || 0x3E800 (0x80 * 2000) || [[Filesystem_services#TitleTag|Title Tag]] data, 0x80 bytes per entry
|}

= Common Types =
== MediaType ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0
| NAND
|-
| 1
| SD
|-
| 2
| Game Card
|}

== SystemMediaType ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0
| CTR NAND
|-
| 1
| TWL NAND
|-
| 2
| SD
|-
| 3
| TWL Photo
|}

== OpenFlags ==
{| class="wikitable" border="1"
|-
! Bit
! Description
|-
| 0
| Read
|-
| 1
| Write
|-
| 2
| Create
|}

== Attributes ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| Is Directory
|-
| 0x1
| 0x1
| Is Hidden
|-
| 0x2
| 0x1
| Is Archive
|-
| 0x3
| 0x1
| Is Read-Only
|}

== WriteOption ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| Flush
|-
| 0x1
| 0x1
| Update Time Stamp
|-
| 0x2
| 0x1
| Reserved
|-
| 0x3
| 0x1
| Reserved
|}

== DirectoryEntry ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x20C
| UTF-16 Entry Name
|-
| 0x20C
| 0xA
| 8.3 short filename name
|-
| 0x216
| 0x4
| 8.3 short filename extension
|-
| 0x21A
| 0x1
| Always 1
|-
| 0x21B
| 0x1
| Reserved
|-
| 0x21C
| 0x4
| [[Filesystem_services#Attributes|Attributes]]
|-
| 0x220
| 0x8
| Entry Size
|}

== ArchiveResource ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| Sector byte-size
|-
| 0x4
| 0x4
| Cluster byte-size
|-
| 0x8
| 0x4
| Partition capacity in clusters
|-
| 0xC
| 0x4
| Available free space in clusters
|}

== ProgramInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x8
| Program ID
|-
| 0x8
| 0x1
| [[Filesystem_services#MediaType|Media Type]]
|-
| 0x9
| 0x7
| Padding
|}

== ProductInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| Product Code
|-
| 0x10
| 0x2
| Company Code
|-
| 0x12
| 0x2
| Remaster Version
|}

== IntegrityVerificationSeed ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| AES-CBC MAC over a SHA256 hash, which hashes the first 0x110-bytes of the cleartext SEED.
|-
| 0x10
| 0x120
| The [[nand/private/movable.sed]], encrypted with AES-CBC using the above MAC for the counter.
|}

== ExtSaveDataInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 0x4
| 0x8
| Save ID
|-
| 0xC
| 0x4
| Reserved
|}

== SystemSaveDataInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 0x4
| 0x4
| Save ID
|}

== SecureValueSlot ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x1000
| SD Application
|}

== SecureValueEntry ==
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, [[Filesystem_services#SecureValueSlot|Secure Value Slot]]
|-
| 0x4 || 0x1 || When used as an input entry:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || This entry should be removed.
|-
| 1 || This entry should be updated with the given value.
|}
When returned from a command:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || No entry with the given slot and title ID was found, or: this entry is unused.
|-
| 1 || The entry with the given slot and title ID was found, or: this entry is used.
|}
|-
| 0x5 || 0x3 || padding
|-
| 0x8 || 0x8 || u64, Secure Value
|}

== TitleTag ==
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Magic, <code>PREP</code> (PREPurchase install)
|-
| 0x4 || 0x4 || s32, Release date year
|-
| 0x8 || 0x1 || u8, Release date month
|-
| 0x9 || 0x1 || u8, Release date day
|-
| 0xA || 0x2 || u16, Country code
|-
| 0xC || 0x4 || u32, Seed status (0: not downloaded yet, 1: last download attempt failed, 2: seed installed successfully)
|-
| 0x10 || 0x4 || Result code from last seed installation attempt
|-
| 0x14 || 0x4 || Support error code from last seed installation attempt
|-
| 0x18 || 0x68 || reserved padding (unused)
|}

== CardSpiBaudRate ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x0
| 512KHz
|-
| 0x1
| 1MHz
|-
| 0x2
| 2MHz
|-
| 0x3
| 4MHz
|-
| 0x4
| 8MHz
|-
| 0x5
| 16MHz
|}

== CardSpiBusMode ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x0
| 1-bit
|-
| 0x1
| 4-bit
|}

== SpecialContentType ==
{| class="wikitable" border="1"
|-
! Value
! Description
! Found in
|-
| 0x1
| CTR (Old3DS) Update Partition
| Gamecards
|-
| 0x2
| Manual
| Gamecards, Digital titles
|-
| 0x3
| DLP Child
| Gamecards, Digital titles
|-
| 0x4
| KTR (New3DS) Update Partition
| Gamecards
|-
|}

== DeviceMoveContext ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| IVs (ID0 of source console)
|-
| 0x10
| 0x10
| Encrypt Parameter (used to calculate the IV for encryption)
|}

=Errors=
See [[Filesystem_services_PXI]].

[[Category:Services]]

Filesystem services

2025-07-10T09:36:17Z

TimmSkiller: /* Archive Path */

= Services =
{{Anchor|FS}}{{Anchor|FSUSER}}{{Anchor|fs:USER}}
== Filesystem service "fs:USER" ==
You can at most have 32 FS archive handles.

{| class="wikitable" border="1"
|-
! Command Header
! Available since system version
! Description
! scope="col" width="400" | Required [[NCCH/Extended_Header|exheader]] access info bitmask
|-
| 0x000100C6
|?
| [[FS:Dummy1|Dummy1]]
| None
|-
| 0x040100C4
|?
| [[FS:Control|Control]]
| None
|-
| 0x08010002
|?
| [[FS:Initialize|Initialize]]
| None
|-
| 0x080201C2
|?
| [[FS:OpenFile|OpenFile]]
| None
|-
| 0x08030204
|?
| [[FS:OpenFileDirectly|OpenFileDirectly]]
| None
|-
| 0x08040142
|?
| [[FS:DeleteFile|DeleteFile]]
| None
|-
| 0x08050244
|?
| [[FS:RenameFile|RenameFile]]
| None
|-
| 0x08060142
|?
| [[FS:DeleteDirectory|DeleteDirectory]]
| None
|-
| 0x08070142
|?
| [[FS:DeleteDirectoryRecursively|DeleteDirectoryRecursively]]
| None
|-
| 0x08080202
|?
| [[FS:CreateFile|CreateFile]]
| None
|-
| 0x08090182
|?
| [[FS:CreateDirectory|CreateDirectory]]
| None
|-
| 0x080A0244
|?
| [[FS:RenameDirectory|RenameDirectory]]
| None
|-
| 0x080B0102
|?
| [[FS:OpenDirectory|OpenDirectory]]
| None
|-
| 0x080C00C2
|?
| [[FS:OpenArchive|OpenArchive]]
| Each archive ID code has separate access info bitmasks, if it has any
|-
| 0x080D0144
|?
| [[FS:ControlArchive|ControlArchive]]
| None
|-
| 0x080E0080
|?
| [[FS:CloseArchive|CloseArchive]]
| None
|-
| 0x080F0180
|?
| [[FS:Obsoleted_2_0_FormatThisUserSaveData|Obsoleted_2_0_FormatThisUserSaveData]]
| None
|-
| 0x08100200
|?
| [[FS:Obsoleted_3_0_CreateSystemSaveData|Obsoleted_3_0_CreateSystemSaveData]]
| 0x4, for when the input saveID doesn't match the exheader saveID
|-
| 0x08110040
|?
| [[FS:Obsoleted_3_0_DeleteSystemSaveData|Obsoleted_3_0_DeleteSystemSaveData]]
| 0x1004, for when the input saveID doesn't match the exheader saveID
|-
| 0x08120080
|?
| [[FS:GetFreeBytes|GetFreeBytes]]
| None
|-
| 0x08130000
|?
| [[FS:GetCardType|GetCardType]]
| 0x1017
|-
| 0x08140000
|?
| [[FS:GetSdmcArchiveResource|GetSdmcArchiveResource]]
| None
|-
| 0x08150000
|?
| [[FS:GetNandArchiveResource|GetNandArchiveResource]]
| 0x1007
|-
| 0x08160000
|?
| [[FS:GetSdmcFatfsError|GetSdmcFatfsError]]
| 0x2
|-
| 0x08170000
|?
| [[FS:IsSdmcDetected|IsSdmcDetected]]
| None
|-
| 0x08180000
|?
| [[FS:IsSdmcWritable|IsSdmcWritable]]
| None
|-
| 0x08190042
|?
| [[FS:GetSdmcCid|GetSdmcCid]]
| 0x2
|-
| 0x081A0042
|?
| [[FS:GetNandCid|GetNandCid]]
| 0x2
|-
| 0x081B0000
|?
| [[FS:GetSdmcSpeedInfo|GetSdmcSpeedInfo]]
| 0x2
|-
| 0x081C0000
|?
| [[FS:GetNandSpeedInfo|GetNandSpeedInfo]]
| 0x2
|-
| 0x081D0042
|?
| [[FS:GetSdmcLog|GetSdmcLog]]
| 0x2
|-
| 0x081E0042
|?
| [[FS:GetNandLog|GetNandLog]]
| 0x2
|-
| 0x081F0000
|?
| [[FS:ClearSdmcLog|ClearSdmcLog]]
| 0x2
|-
| 0x08200000
|?
| [[FS:ClearNandLog|ClearNandLog]]
| 0x2
|-
| 0x08210000
|?
| [[FS:CardSlotIsInserted|CardSlotIsInserted]]
| 0x1017
|-
| 0x08220000
|?
| [[FS:CardSlotPowerOn|CardSlotPowerOn]]
| 0x2
|-
| 0x08230000
|?
| [[FS:CardSlotPowerOff|CardSlotPowerOff]]
| 0x2
|-
| 0x08240000
|?
| [[FS:CardSlotGetCardIFPowerStatus|CardSlotGetCardIFPowerStatus]]
| 0x2
|-
| 0x08250040
|?
| [[FS:CardNorDirectCommand|CardNorDirectCommand]]
| 0x2
|-
| 0x08260080
|?
| [[FS:CardNorDirectCommandWithAddress|CardNorDirectCommandWithAddress]]
| 0x2
|-
| 0x08270082
|?
| [[FS:CardNorDirectRead|CardNorDirectRead]]
| 0x2
|-
| 0x082800C2
|?
| [[FS:CardNorDirectReadWithAddress|CardNorDirectReadWithAddress]]
| 0x2
|-
| 0x08290082
|?
| [[FS:CardNorDirectWrite|CardNorDirectWrite]]
| 0x2
|-
| 0x082A00C2
|?
| [[FS:CardNorDirectWriteWithAddress|CardNorDirectWriteWithAddress]]
| 0x2
|-
| 0x082B00C2
|?
| [[FS:CardNorDirectRead_4xIO|CardNorDirectRead_4xIO]]
| 0x2
|-
| 0x082C0082
|?
| [[FS:CardNorDirectCpuWriteWithoutVerify|CardNorDirectCpuWriteWithoutVerify]]
| 0x2
|-
| 0x082D0040
|?
| [[FS:CardNorDirectSectorEraseWithoutVerify|CardNorDirectSectorEraseWithoutVerify]]
| 0x2
|-
| 0x082E0040
|?
| [[FS:GetProductInfo|GetProductInfo]]
| 0x1005
|-
| 0x082F0040
|?
| [[FS:GetProgramLaunchInfo|GetProgramLaunchInfo]]
| 0x1005
|-
| 0x08300182
|?
| [[FS:Obsoleted_3_0_CreateExtSaveData|Obsoleted_3_0_CreateExtSaveData]]
| 0xC, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08310180
|?
| [[FS:Obsoleted_3_0_CreateSharedExtSaveData|Obsoleted_3_0_CreateSharedExtSaveData]]
| 0x1005
|-
| 0x08320102
|?
| [[FS:Obsoleted_3_0_ReadExtSaveDataIcon|Obsoleted_3_0_ReadExtSaveDataIcon]]
| 0x100D, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08330082
|?
| [[FS:Obsoleted_3_0_EnumerateExtSaveData|Obsoleted_3_0_EnumerateExtSaveData]]
| 0x1005
|-
| 0x08340082
|?
| [[FS:Obsoleted_3_0_EnumerateSharedExtSaveData|Obsoleted_3_0_EnumerateSharedExtSaveData]]
| 0x1005
|-
| 0x08350080
|?
| [[FS:Obsoleted_3_0_DeleteExtSaveData|Obsoleted_3_0_DeleteExtSaveData]]
| 0x100D, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08360080
|?
| [[FS:Obsoleted_3_0_DeleteSharedExtSaveData|Obsoleted_3_0_DeleteSharedExtSaveData]]
| 0x1005
|-
| 0x08370040
|?
| [[FS:SetCardSpiBaudRate|SetCardSpiBaudRate]]
| 0x2
|-
| 0x08380040
|?
| [[FS:SetCardSpiBusMode|SetCardSpiBusMode]]
| 0x2
|-
| 0x08390000
|?
| [[FS:SendInitializeInfoTo9|SendInitializeInfoTo9]]
| None
|-
| 0x083A0100
|?
| [[FS:GetSpecialContentIndex|GetSpecialContentIndex]]
| 0x1005
|-
| 0x083B00C2
|?
| [[FS:GetLegacyRomHeader|GetLegacyRomHeader]]
| 0x1015
|-
| 0x083C00C2
|?
| [[FS:GetLegacyBannerData|GetLegacyBannerData]]
| 0x1015
|-
| 0x083D0100
|?
| [[FS:CheckAuthorityToAccessExtSaveData|CheckAuthorityToAccessExtSaveData]]
| 0x44
|-
| 0x083E00C2
|?
| [[FS:QueryTotalQuotaSize|QueryTotalQuotaSize]]
| None
|-
| 0x083F00C0
|?
| [[FS:Obsoleted_3_0_GetExtDataBlockSize|Obsoleted_3_0_GetExtDataBlockSize]]
| None
|-
| 0x08400040
|?
| [[FS:AbnegateAccessRight|AbnegateAccessRight]]
|?
|-
| 0x08410000
|?
| [[FS:DeleteSdmcRoot|DeleteSdmcRoot]]
| 0x1005
|-
| 0x08420040
|?
| [[FS:DeleteAllExtSaveDataOnNand|DeleteAllExtSaveDataOnNand]]
| 0x1005
|-
| 0x08430000
|?
| [[FS:InitializeCtrFileSystem|InitializeCtrFileSystem]]
| None
|-
| 0x08440000
|?
| [[FS:CreateSeed|CreateSeed]]
| 0x2
|-
| 0x084500C2
|?
| [[FS:GetFormatInfo|GetFormatInfo]]
|?
|-
| 0x08460102
|?
| [[FS:GetLegacyRomHeader2|GetLegacyRomHeader2]]
| 0x1015
|-
| 0x08470180
|?
| [[FS:Obsoleted_2_0_FormatCtrCardUserSaveData|Obsoleted_2_0_FormatCtrCardUserSaveData]]
| 0x6
|-
| 0x08480042
|?
| [[FS:GetSdmcCtrRootPath|GetSdmcCtrRootPath]]
| 0x100D
|-
| 0x08490040
|?
| [[FS:GetArchiveResource|GetArchiveResource]]
|?
|-
| 0x084A0002
|?
| [[FS:ExportIntegrityVerificationSeed|ExportIntegrityVerificationSeed]]
| 0x4000
|-
| 0x084B0002
|?
| [[FS:ImportIntegrityVerificationSeed|ImportIntegrityVerificationSeed]]
| 0x4000
|-
| 0x084C0242
|?
| [[FS:FormatSaveData|FormatSaveData]]
| 0x6, in some cases this write isn't needed however
|-
| 0x084D0102
|?
| [[FS:GetLegacySubBannerData|GetLegacySubBannerData]]
| 0x1015
|-
| 0x084E0342
|?
| [[FS:UpdateSha256Context|UpdateSha256Context]]
| 0x5
|-
| 0x084F0102
|?
| [[FS:ReadSpecialFile|ReadSpecialFile]]
| None
|-
| 0x08500040
|?
| [[FS:GetSpecialFileSize|GetSpecialFileSize]]
| None
|-
| 0x08510242
| [[3.0.0-5]]
| [[FS:CreateExtSaveData|CreateExtSaveData]]
| Shared extdata: 0x101005. Regular extdata in certain cases: 0xC
|-
| 0x08520100
| [[3.0.0-5]]
| [[FS:DeleteExtSaveData|DeleteExtSaveData]]
| Shared extdata: 0x101005. Regular extdata in certain cases: 0x10100D
|-
| 0x08530142
| [[3.0.0-5]]
| [[FS:ReadExtSaveDataIcon|ReadExtSaveDataIcon]]
| 0x10100D (this doesn't apply in certain cases, however)
|-
| 0x085400C0
| [[3.0.0-5]]
| [[FS:GetExtDataBlockSize|GetExtDataBlockSize]]
| 0x10100D (this doesn't apply in certain cases, however)
|-
| 0x08550102
| [[3.0.0-5]]
| [[FS:EnumerateExtSaveData|EnumerateExtSaveData]]
| 0x101005
|-
| 0x08560240
| [[3.0.0-5]]
| [[FS:CreateSystemSaveData|CreateSystemSaveData]]
| 0x4 (this doesn't apply in certain cases, however)
|-
| 0x08570080
| [[3.0.0-5]]
| [[FS:DeleteSystemSaveData|DeleteSystemSaveData]]
| 0x1004 (this doesn't apply in certain cases, however)
|-
| 0x08580000
| [[3.0.0-5]]
| [[FS:StartDeviceMoveAsSource|StartDeviceMoveAsSource]]
| 0x2004
|-
| 0x08590200
| [[3.0.0-5]]
| [[FS:StartDeviceMoveAsDestination|StartDeviceMoveAsDestination]]
| 0x2004
|-
| 0x085A00C0
| [[3.0.0-5]]
| [[FS:SetArchivePriority|SetArchivePriority]]
| None
|-
| 0x085B0080
| [[3.0.0-5]]
| [[FS:GetArchivePriority|GetArchivePriority]]
| None
|-
| 0x085C00C0
| [[3.0.0-5]]
| [[FS:SetCtrCardLatencyParameter|SetCtrCardLatencyParameter]]
| 0xE
|-
| 0x085D01C0
| [[3.0.0-5]]
| [[FS:SetFsCompatibilityInfo|SetFsCompatibilityInfo]]
| 0x100001
|-
| 0x085E0040
| [[3.0.0-5]]
| [[FS:ResetCardCompatibilityParameter|ResetCardCompatibilityParameter]]
| 0xE
|-
| 0x085F0040
| [[3.0.0-5]]
| [[FS:SwitchCleanupInvalidSaveData|SwitchCleanupInvalidSaveData]]
| 0x12004
|-
| 0x08600042
| [[3.0.0-5]]
| [[FS:EnumerateSystemSaveData|EnumerateSystemSaveData]]
| 0x2004
|-
| 0x08610042
| [[3.0.0-5]]
| [[FS:InitializeWithSdkVersion|InitializeWithSdkVersion]]
| None
|-
| 0x08620040
| [[3.0.0-5]]
| [[FS:SetPriority|SetPriority]]
| None
|-
| 0x08630000
| [[3.0.0-5]]
| [[FS:GetPriority|GetPriority]]
| None
|-
| 0x08640000
| [[3.0.0-5]]
| [[FS:Obsoleted_4_0_GetNandInfo|Obsoleted_4_0_GetNandInfo]]
| Stubbed, this returns an error
|-
| 0x08650140
| [[4.0.0-7]]
| [[FS:SetSaveDataSecureValue|SetSaveDataSecureValue]]
| 0x121004 (in certain cases this doesn't apply, however)
|-
| 0x086600C0
| [[4.0.0-7]]
| [[FS:GetSaveDataSecureValue|GetSaveDataSecureValue]]
| 0x121004 (in certain cases this doesn't apply, however)
|-
| 0x086700C4
| [[4.0.0-7]]
| [[FS:ControlSecureSave|ControlSecureSave]]
| 0x121004
|-
| 0x08680000
| [[4.0.0-7]]
| [[FS:GetMediaType|GetMediaType]]
| None
|-
| 0x08690000
| [[4.0.0-7]]
| [[FS:Obsoleted_4_0_GetNandEraseCount|Obsoleted_4_0_GetNandEraseCount]]
| Stubbed, this returns an error.
|-
| 0x086A0082
| [[4.0.0-7]]
| [[FS:ReadNandReport|ReadNandReport]]
| None
|-
| 0x086B00C2
|?
| [[FS:SetOtherSaveDataSecureValue|SetOtherSaveDataSecureValue]]
| 0x121004
|-
| 0x086C00C2
|?
| [[FS:GetOtherSaveDataSecureValue|GetOtherSaveDataSecureValue]]
| 0x121004
|-
| 0x086D0080
|?
| [[FS:BeginSaveDataMove|BeginSaveDataMove]]
| 0x20004
|-
| 0x086E00C0
|?
| [[FS:SetThisSaveDataSecureValue|SetThisSaveDataSecureValue]]
|None
|-
| 0x086F0040
|?
| [[FS:GetThisSaveDataSecureValue|GetThisSaveDataSecureValue]]
| None
|-
| 0x087000C2
|?
| [[FS:CheckArchive|CheckArchive]]
|None
|-
| 0x08710140
| ?
| [[FS:TransferSaveDataCMAC|TransferSaveDataCMAC]]
| 0x20004
|-
| 0x08720200
|?
| [[FS:RegisterTitleContentOverlay|RegisterTitleContentOverlay]]
| 0x80004
|-
| 0x08730100
|?
| [[FS:UnregisterTitleContentOverlay|UnregisterTitleContentOverlay]]
| 0x80004
|-
| 0x08740000
|?
| [[FS:UnregisterAllTitleContentOverlays|UnregisterAllTitleContentOverlays]]
| 0x80004
|-
| 0x08750140
|?
| [[FS:SetSaveArchiveSecureValue|SetSaveArchiveSecureValue]]
|None
|-
| 0x087600C0
|?
| [[FS:GetSaveArchiveSecureValue|GetSaveArchiveSecureValue]]
|None
|-
| 0x08770140
|?
| [[FS:RegisterSpecialTitleContent|RegisterSpecialTitleContent]]
| 0x80004
|-
| 0x08780100
|?
| [[FS:UnregisterSpecialTitleContent|UnregisterSpecialTitleContent]]
| 0x80004
|-
| 0x087900C2
| ?
| Same as [[FS:GetLegacyBannerData|GetLegacyBannerData]], except for the last parameter this internally passes u8 value 0x1 instead of 0x0, for the FSPXI command.
| 0x101015
|-
| 0x087A0180
| [[9.6.0-24|9.6.0-X]]
| [[FS:AddSeed|AddSeed]]
| 0x200000
|-
| 0x087B0080
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetSeed|GetSeed]]
| 0x200000
|-
| 0x087C0080
| [[9.6.0-24|9.6.0-X]]
| [[FS:DeleteSeed|DeleteSeed]]
| 0x200000
|-
| 0x087D0000
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetNumSeeds|GetNumSeeds]]
| 0x200000
|-
| 0x087E0042
| [[9.6.0-24|9.6.0-X]]
| [[FS:ListSeeds|ListSeeds]]
| 0x200000
|-
| 0x087F0100
| [[9.6.0-24|9.6.0-X]]
| [[FS:TitleContentHasSeed|TitleContentHasSeed]]
| 0x200000
|-
| 0x08800880
| [[9.6.0-24|9.6.0-X]]
| [[FS:AddTitleTag|AddTitleTag]]
| 0x200000
|-
| 0x08810080
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetTitleTag|GetTitleTag]]
| 0x200000
|-
| 0x08820080
| [[9.6.0-24|9.6.0-X]]
| [[FS:DeleteTitleTag|DeleteTitleTag]]
| 0x200000
|-
| 0x08830000
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetNumTitleTags|GetNumTitleTags]]
| 0x200000
|-
| 0x08840042
| [[9.6.0-24|9.6.0-X]]
| [[FS:ListTitleTags|ListTitleTags]]
| 0x200000
|-
| 0x088500C0
| [[9.6.0-24|9.6.0-X]]
| [[FS:CheckTitleSeed|CheckTitleSeed]]
| 0x200000
|-
| 0x088600C0
| [[11.1.0-34|11.1.0-X]]
| [[FS:CheckUpdatedDat|CheckUpdatedDat]]
| 0x80000
|}

Note: The question marks from Dummy1 to GetSpecialFileSize on the "available since system version" field are mainly there because I think that most of these are necessary for the main system to function, so theoretically that would mean that since the creation of the 3DS these were available, or since launch if that makes more sense. But because of the peculiar nature of some of the functions, they will remain question marks until they can be confirmed 100%.

When access rights are required for a command, at least one of the bits in the process access info specified in the above table for the command must be set. Error 0xD9004676 is returned when a process attempts to use a command which it doesn't have access rights for the command. The exheader access info field is all zero's for most applications. Note that the permissions listed in the above table is for system-version v2.x, therefore permission bit(s) added with newer FIRM may be missing from this.

Each session for fs:USER has separate permissions, initially these are set to all zero's for new fs:USER sessions. The permissions/etc for fs:USER sessions are initialized via [[FS:Initialize]](loaded from the user process exheader).

{{Anchor|FSLDR}}{{Anchor|fs:LDR}}

== Filesystem service "fs:LDR" ==
This service is identical to fs:USER, except [[FS:OpenArchive]] archive 0x2345678E can only be accessed with fs:LDR.

{{Anchor|FSReg}}{{Anchor|FSREG}}{{Anchor|fs:REG}}
== ProgramRegistry service "fs:REG" ==
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C6
| [[FSReg:Dummy1|Dummy1]]
|-
| 0x040103C0
| [[FSReg:Register|Register]]
|-
| 0x04020040
| [[FSReg:Unregister|Unregister]]
|-
| 0x040300C0
| [[FSReg:GetProgramInfo|GetProgramInfo]]
|-
| 0x04040100
| [[FSReg:LoadProgram|LoadProgram]]
|-
| 0x04050080
| [[FSReg:UnloadProgram|UnloadProgram]]
|-
| 0x04060080
| [[FSReg:CheckHostLoadId|CheckHostLoadId]]
|}

Only two sessions can be opened for this service at a time, hence no other processes can use this due to [[Process_Manager_Services|pm-module]] and [[Loader_Services|loader]] using this.

=File and directory access=
==Files==
File session handles obtained via [[FS:OpenFile]] and [[FS:OpenFileDirectly]] can be used to access files through a service-like interface, despite not being an actual service registered using [[SRV:RegisterService]]. To use this service-like interface, simply call the SendSyncRequest SVC with a file session handle, using the IPC buffer in thread-local storage for parameters and responses, just like you would with a proper service.

{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C6
| [[FSFile:Dummy1|Dummy1]]
|-
| 0x040100C4
| [[FSFile:Control|Control]]
|-
| 0x08010100
| [[FSFile:OpenSubFile|OpenSubFile]]
|-
| 0x080200C2
| [[FSFile:Read|Read]]
|-
| 0x08030102
| [[FSFile:Write|Write]]
|-
| 0x08040000
| [[FSFile:GetSize|GetSize]]
|-
| 0x08050080
| [[FSFile:SetSize|SetSize]]
|-
| 0x08060000
| [[FSFile:GetAttributes|GetAttributes]]
|-
| 0x08070040
| [[FSFile:SetAttributes|SetAttributes]]
|-
| 0x08080000
| [[FSFile:Close|Close]]
|-
| 0x08090000
| [[FSFile:Flush|Flush]]
|-
| 0x080A0040
| [[FSFile:SetPriority|SetPriority]]
|-
| 0x080B0000
| [[FSFile:GetPriority|GetPriority]]
|-
| 0x080C0000
| [[FSFile:OpenLinkFile|OpenLinkFile]]
|-
| 0x0C010100
| [[FSFile:GetAvailable|GetAvailable]]
|}

==Directories==
Directory session handles obtained via [[FS:OpenDirectory]] are usable via a service-like interface, following the exact same procedure described above for file sessions.
{| class="wikitable" border="1"
|-
! Command Header
! Available since system version
! Description
|-
| 0x000100C6
| [[1.0.0-0]]
| [[FSDir:Dummy1|Dummy1]]
|-
| 0x040100C4
| [[1.0.0-0]]
| [[FSDir:Control|Control]]
|-
| 0x08010042
| [[1.0.0-0]]
| [[FSDir:Read|Read]]
|-
| 0x08020000
| [[1.0.0-0]]
| [[FSDir:Close|Close]]
|-
| 0x08030040
| ?
| [[FSDir:SetPriority|SetPriority]]
|-
| 0x08040000
| ?
| [[FSDir:GetPriority|GetPriority]]
|}

= Archives =
{| class="wikitable" border="1"
|-
! ArchiveId
! Description
! Accessible via [[Filesystem_services|FS]]
! Accessible via [[Filesystem_services_PXI|FSPXI]]
! Only accessible by Process9 internally
! Requires binary [[FS:OpenFile|Lowpath]]
! Required exheader FS access info bitmask
|-
| 0x00000003
| SelfNCCH (including [[#RomFS|RomFS]])
| Yes
| No
| No
| No
| None
|-
| 0x00000004
| SaveData (the saveID/mediatype for this is loaded from data originally from the user process' exheader)
| Yes
| No
| No
| No
| None
|-
| 0x00000006
| ExtSaveData
| Yes
| No
| No
| Yes
| 0x100D, when the input extdataID isn't listed in the exheader.
|-
| 0x00000007
| Shared ExtSaveData
| Yes
| No
| No
| Yes
| None
|-
| 0x00000008
| SystemSaveData
| Yes
| No
| No
| Yes
| 0x4, when the input saveID doesn't match the exheader system-saveID.
|-
| 0x00000009
| SDMC
| Yes
| Yes
| No
| No
| 0x8E
|-
| 0x0000000A
| SDMC Write-Only
| Yes
| No
| No
| No
| 0x808E
|-
| 0x12345678
| ExtSaveData for BOSS
| Yes
| No
| No
| Yes
| 0x44
|-
| 0x12345679
| CARD SPI FS
| Yes
| Yes
| No
| No
| 0x16
|-
| 0x1234567B
| ExtSaveData, and ExtSaveData for BOSS
| No
| Yes
| No
| Yes
|
|-
| 0x1234567C
| SystemSaveData
| No
| Yes
| No
| Yes
|
|-
| 0x1234567D
| NAND RW
| Yes
| Yes
| No
| No
| 0x800
|-
| 0x1234567E
| NAND RO
| Yes
| Yes
| No
| No
| 0x200
|-
| 0x1234567F
| NAND RO Write FS
| No
| Yes
| No
| No
| ?
|-
| 0x12345680
| Extdata transfer. Used for transferring [[Extdata#NAND_Shared_Extdata|NAND Shared Extdata]] during [[System_Transfer#System_Save_Data_/_Shared_Extdata_Transfer|system tranfers]].
| Yes
| Yes
| No
| Yes
| ?
|-
| 0x12345681
| System Savedata transfer. Used for transferring [[System_SaveData|System Save Data]] during [[System_Transfer#System_Save_Data_/_Shared_Extdata_Transfer|system tranfers]].
| Yes
| Yes
| No
| Yes
| ?
|-
| 0x12345682
| Unknown. There's code for this in spider v9.9, but that code isn't actually used.
| Yes
| No
| No
| Yes
| ?
|-
| 0x2345678A
| Title access. With FS, this allows accessing NCCH/NCSD contents (ExeFS, RomFS, checking if a content uses a seed, checking the validity of the installed seed). FSPXI, additionally, allows opening raw NCCH/NCSD NCCH contents and DSiWare contents for reading, along with encrypted save data.
| Yes
| Yes
| No
| Yes
| 0x1005
|-
| 0x2345678B
| Used internally by Process9 as the lowest level title access archive. Allows for opening various sections of a title (TMD, CMD, raw contents, DLC contents, raw save data (including public/private/banner saves for DSiWare), title and/or content import context files and /data directories for save data.
| No
| No
| Yes
| Yes
|
|-
| 0x2345678C
| Used internally to access [[Title_Database|Title Database (/dbs)]] files. For SD, <code>title.db</code> and <code>import.db</code>. For NAND, <code>title.db</code>, <code>import.db</code>, <code>tmp_t.db</code>, <code>tmp_i.db</code>, and <code>jumpid.db</code>.
| No
| No
| Yes
| Yes
|
|-
| 0x2345678D
| Used internally to access non-title /dbs files on the NAND: <code>certs.db</code> and <code>ticket.db</code>.
| No
| No
| Yes
| No
|
|-
| 0x2345678E
| FSPXI: Program Access (limited subset of merged main title + update/patch title access). For fs:LDR(used by the "loader" FIRM ARM11-process), only <code>exefs:/.code</code>. Not accessible with fs:USER.
| Yes
| Yes
| No
| Yes
| None, see description.
|-
| 0x567890AB
| NAND CTR FS
| No
| Yes
| No
| No
| ?
|-
| 0x567890AC
| TWL PHOTO
| Yes
| Yes
| No
| No
| ?
|-
| 0x567890AD
| TWLS (DSi Sound stores recordings here). This is mapped to the FAT12 image stored in the file at [[Twln/shared2/0000]].
| No
| Yes
| No
| No
| ?
|-
| 0x567890AE
| NAND TWL FS
| Yes
| Yes
| No
| No
| 0x100
|-
| 0x567890AF
| NAND W FS
| Yes
| Yes
| No
| No
| 0x100
|-
| 0x567890B0
| Internally creates the same "ID Storage" wrapper over the NAND that is used for SystemSaveData and Shared ExtData, but all operations are stubbed and return 0xE0C046F8.
| No
| Yes
| No
| No
|
|-
| 0x567890B1
| Gamecard SaveData (for check). This is a wrapper for UserSaveDataForCheck: the OpenArchive code for that is called with archive-lowpath TID=0/mediatype=2(gamecard).
| Yes
| No
| No
| No
| 0x6
|-
| 0x567890B2
| UserSaveData (for check). This is the same as the regular SaveData archive, except with this the savedata ID and mediatype is loaded from the input archive lowpath.
| Yes
| No
| No
| Yes
| 0x6
|-
| 0x567890B3
| [[3DS_Virtual_Console#NAND_Savegame|AGB Save Data]]
| No
| No
| Yes
| No
| -
|-
| 0x567890B4
| Similar to 0x567890B2 but can only access Accessible Save specified in [[NCCH/Extended_Header#Storage_Info|exheader]]?
| Yes
| No
| No
| Yes
| ?
|}

Archives listed as not requiring a binary lowpath, use lowpath type [[FS:OpenFile|empty]].

The above permission bitmasks are from v2.x, see the above Services section for how these are handled.

Archives CTR NAND, NAND RO Write FS, TWL NAND, NAND W FS, and CARD SPI FS require the corresponding process exheader access control mount flag to be set, in the exheader for any of the currently running ARM11 processes, for [[Filesystem_services_PXI|FSPXI]]. The access rights checked by [[Filesystem services|FS]] module for archive mounting with fs:USER, are stored in the process' exheader accessinfo.

The CARDSPI archive allows access to the gamecard CARD1 raw savedata flash(aka "cardspi:/" in [[FIRM|Process9]]), the file lowpath must be WCHAR "/". The "NAND W FS" archive allows access to the raw NAND image(aka "wnand:/" in Process9), the file lowpath must be WCHAR "/".

= Filenames and Paths =
{{Anchor|PathType}} PathType:
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| -1
| Returned internally by Process9, when errors occur it seems(in particular when no nul-terminator was found in the input path). The data ptr is set to NULL.
|-
| 0x0
| INVALID - Specifies an invalid path
|-
| 0x1
| EMPTY - Specifies an empty path
|-
| 0x2
| BINARY - Non-text based path. Meaning is per-archive
|-
| 0x3
| ASCII - Text-based path with 7-bit ASCII characters padded to 8-bits each (signed char)
|-
| 0x4
| UTF16 - Text-based path with UTF-16 characters
|}

In IPC requests, sizes of ASCII and UTF16 paths must include space for the null-terminator.

== Binary LowPath ==
The format of the data that a binary LowPath points to is custom per archive.

=== SystemSaveData / Extdata / Shared Extdata Archive Path Data Format ===

==== DataAccessPath ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8 [[Mediatypes|Mediatype]]
|-
| 0x1 || 0x1 || only for NAND data (System Savedata / Shared Extdata), otherwise left 0:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || Accesses from/to <code>nand:/data/<ID0 of current system></code>
|-
| 1 || Accesses from/to <code>nand:/fixdata</code>
|-
| 2 || Accesses from/to <code>nand:/data/<ID0 from [[Filesystem_services#DeviceMoveContext|Device Move Context]]></code>
|}
|-
| 0x2 || 0x2 || padding
|}

==== SystemSaveData ====

===== FS =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 1
| save ID low (save ID high is 0)
|}

====== File Path ======
The file path is a cleartext ASCII or UTF16 file path (<code><file path></code>).

The file path would access the file at <code><base path>/sysdata/<save ID low>/<save ID high>/<file path></code>.
Note that <code>/<file path></code> refers to the virtual file system inside the </code><save ID high></code> file.

===== FSPXI / FS System Savedata Transfer / FSPXI System Savedata Transfer =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|}

====== File Path ======
{| class="wikitable" border="1"
|-
! Index word !! Description
|-
| 0 || save ID low
|-
| 1 || save ID high
|}

The file path would access the file at <code><base path>/sysdata/<save ID low>/<save ID high></code>.

==== Extdata / Shared Extdata ====

===== FS / FS Extdata Transfer / FSPXI Extdata Transfer =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 1
| ext save ID low
|-
| 2
| ext save ID high
|}

This refers to the extdata filesystem structure's base directory at <code><base path>/extdata/<ext save ID low>/<ext save ID high></code>.

====== File Path ======
The file path is a cleartext ASCII or UTF16 file path (<code><file path></code>).

For FS Extdata, this would acccess <code><base path>/extdata/<save ID low>/<save ID high>/<directory ID>/<file ID>/<file path></code>, and <code>/<file path></code> refers to the virtual file system inside the </code><file ID></code> file.

For FS / FSPXI Extdata Transfer, this accesses <code><base path>/extdata/<save ID low>/<save ID high>/<file path></code>.

=== UserSaveDataForCheck Archive Path Data Format ===
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Mediatypes|Mediatype]] (must be non-zero)
|-
| 1
| Lower word saveid
|-
| 2
| Upper word saveid
|}

The file/directory lowpath for this FS archive is a text path in the [[Savegames|savegame]] filesystem.

=== 0x567890B4 Archive Path Data Format ===
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Mediatypes|Mediatype]]
|-
| 1
| <code><nowiki>Lower_word_saveid >> 8</nowiki></code> ?
|-
| 2
| Unknown. Game calculate this using formula <code><nowiki>0xFFFFFF00 | unknown_b</nowiki></code>
|}

=== Title Access Archive Path Data Format ===
==== Title Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || High-level NCCH content access
|-
| 1 || Save data access (high-level, decrypted)
|-
| 2 || Raw content (low-level NCCH/SRL) access
|-
| 3 || Banner save data access (for DSiWare titles)
|-
| 4 || FS only: Save data transfer (internally uses generated data from [[FS:BeginSaveDataMove]] as the IV for "Save data access (low-level, encrypted)")
|-
| 5 || Save data access (low-level, encrypted)
|}

==== NCCH Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || RomFS
|-
| 1 || <code>exefs:/.code</code>
|-
| 2 || System Menu Data (<code>exefs:/icon</code>, <code>exefs:/banner</code>, <code>exefs:/logo</code>)
|-
| 3 || NCCH Header(s)
|-
| 4 || "is seeded" check
|-
| 5 || Seed verify/validate
|}

==== NCCH Header Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || [[NCCH/Extended_Header|Extheader]] (0x0-0x400)
|-
| 1 || [[NCCH/Extended_Header|Extheader]] AccessDesc (0x400-0x800)
|-
| 2 || Raw [[NCCH#NCCH_Header|NCCH Header]]
|}

==== Archive Path ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || Program ID (Title ID)
|-
| 0x9 || 0x1 || [[Mediatypes|Media Type]]
|-
| 0xA || 0x7 || padding
|}

==== File Path ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || [[Filesystem_services#Title_Access_Type|Title Access Type]]
|-
| 0x4 || 0x10 || Dynamic data depending on [[Filesystem_services#Title_Access_Type|Title Access Type]]:

{| class="wikitable" border="1"
|-
! High Level NCCH Access !! Save Data Access (high level) !! Raw Content !! FS only: Save Data Transfer
|-
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Content index from TMD for NAND/SD titles
NCSD partition index for gamecards
|-
| 0x4 || 0x4 || [[Filesystem_services#NCCH_Access_Type|NCCH Access Type]]
|-
| 0x8 || 0x8 || Dynamic data depending on [[Filesystem_services#NCCH_Access_Type|NCCH Access Type]]:
For ExeFS, (System Menu Data / <code>exefs:/.code</code>),

{| class="wikitable" border="1"
| 8-byte ExeFS file name
|}

For Header Access,

{| class="wikitable" border="1"
| [[Filesystem_services#NCCH_Header_Access_Type|u64, NCCH Header Access Type]]
|}

For RomFS,

{| class="wikitable" border="1"
| [[NCCH#Content_Types|u64, Allowed content types flag]]
(<code>(1 << allowed_type_a) |

(1 << allowed_type_b)...</code>)
|}

|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x10 || 16-byte IV for save data crypto
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Content index from TMD for NAND/SD titles
NCSD partition index for gamecards
|-
| 0x4 || 0xC || padding
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Save data transfer key from [[FS:BeginSaveDataMove]]
|-
| 0x4 || 0xC || padding
|}
|}
|-
| 0x14 || 0x10 || 16-byte seed for titles that require one, or for validating a seed against the check value in the [[NCCH#NCCH_Header|NCCH Header]]'s check value.
If the title does not use a seed, this should not be included and size 0x14 should be used instead of 0x24.
|}

For encrypted save data access and banner save data access, the entire 0x10 portion of the dynamic data is left blank.

The "is seeded check" NCCH access type opens a virtual 1-byte file that reads either 0 or 1; this value is generated on-the-fly and will be 1 if ncchflags[7] has bit5 set (content uses seed), and 0 otherwise.

For NCCH sections that require a seed (e.g. <code>.code</code>, RomFS, etc.), the additional seed portion of the low path must be populated with the correct seed.

The "Seed Verify/Validate" NCCH access type also requires the seed portion of the lowpath. The target NCCH content is opened (with the opened file interface being stubbed, meaning no real reads/writes can be performed on it), and the given seed is used to calculate the seed check hash, and part of it is compared to the check value in the NCCH header. If it matches, opening the "file" succeeds, otherwise 0xD900458C is returned. If attempt is made to use the seed validation type on a content that does not use a seed, error 0xC92044E6 is returned.

==== FS Limitations ====

For FS, this archive functions the same, except for the following limitations:

- Only the title access types "High Level NCCH Access" and "High Level Save Data Access", and "Save Data Transfer" are allowed.

- For high level NCCH access, the types "RomFS", "System Menu Data", "Seeded check", and "Seed Check/Verify" are allowed.

- For "Seed Check/Verify", rather than providing the title seed in the file path (as is the case for FSPXI), the seed is retrieved from the seed database (meaning the file lowpath size is always 0x14 for FS).

=== Program Access / SelfNCCH access ===

Provides access to a "merged" archive of a base title and, optionally, a separate update (patch) title.

If no patch title exists, the base title is considered to be the patch title, i.e. turning all "patch" accesses into accesses to the base title.

==== Program Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description !! Accesses
|-
| 0 || RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default) || Base title
|-
| 1 || <code>exefs:/.code</code> || Patch title
|-
| 2 || System Menu Data (<code>exefs:/icon</code>, <code>exefs:/banner</code>, <code>exefs:/logo</code>) || Base title
|-
| 3 || Save Data (high level, decrypted) || -
|-
| 4 || RomFS (all [[NCCH#Content_Type|content types]]) || Base title
|-
| 5 || RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default) || Patch title
|}

==== Archive Path ====
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || u64, Program Handle from [[PXIPM:RegisterProgram]]
|}

==== File Path ====
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || [[Filesystem_services#Program_Access_Type|Program Access Type]]
|-
| 0x4 || 0x8 || Dynamic data depending on [[Filesystem_services#Program_Access_Type|Program Access Type]]:
{| class="wikitable" border="1"
|-
! ExeFS files (System Menu Data, etc.) !! RomFS of base title (all [[NCCH#Content_Type|content types]])
|-
|
{| class="wikitable" border="1"
| 8-character ExeFS filename
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, content index of target content
|-
| 0x4 || 0x4 || padding
|}
|}
|}

==== FS Limitations ====

- FSPXI allows all access types.

- When used through fs:LDR by loader, FS only provides access to <code>exefs:/.code</code>.

- For SelfNCCH access, the only allowed access types are "RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default)" of the Base or Patch title, and "System Menu Data". Attempting to access "Save Data" results in error 0xE0E046BE, "RomFS (all [[NCCH#Content_Type|content types]])" in 0xF9604784, and "<code>exefs:/.code</code>" in 0xD9004676.

=== [[RomFS]] ===

Archives 0x3 and 0x2345678E both allow for accessing the [[RomFS#Level_3_Format|level-3 IVFC images]] for RomFS access. The main CXI RomFS is accessible via an all-zero 0xc-byte binary file-lowpath. The update RomFS can be accessed with the first u32 in the binary file-lowpath being set to 0x5. The user must handle parsing the filesystem used in the exposed image itself.

With FSPXI the returned data for RomFS is the entire RomFS section from the NCCH, starting at the IVFC header.

The 0x3 archive is an interface for the 0x2345678E archive with the current process programID+mediatype. The file lowpath is 3-words. These words are written to 0x2345678E-archive file_lowpath+0, with the rest of that lowpath set to all-zero(lowpath is different from archive 0x2345678A). File lowpath:
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| See above. The only values which FS-module doesn't allow to be used here are:
* 0x1: Error 0xE0E046BE.
* 0x3: Error 0xE0E046BE.
* 0x4: FS-module executes svcBreak when using this.
|-
| 1-2
| See above. Not validated by FS-module.
|}

=Anti Savegame Restore=
Anti Savegame Restore, internally referred to as ''Save Data Rollback Prevention'', is a feature originally implemented in the FS module with [[4.0.0-7]], which prevents the user from restoring previous versions of a savegame image. This feature is not used (in practice) for gamecard games. When an old version of the save is detected, the application will display an error regarding old savegame version, then delete and recreate the save data (similar to when it is corrupted).

==Implementation==
When creating the savedata, the application generates a secure value (a 64 bit unsigned integer), then stores it in either the [[DISA_and_DIFF#DISA_header|DISA save image header]] or the [[Filesystem_services#Anti_Savegame_Restore_Save_Data|Anti Savegame Restore Save Data]]. The application then uses the anti-savegame-restore commands ([[FS:SetSaveDataSecureValue]], [[FS:GetSaveDataSecureValue]], [[FS:SetOtherSaveDataSecureValue]], [[FS:GetOtherSaveDataSecureValue]], [[FS:SetThisSaveDataSecureValue]], [[FS:GetThisSaveDataSecureValue]], [[FS:SetSaveArchiveSecureValue]] and [[FS:GetSaveArchiveSecureValue]]) to verify the value known to the game for comparison with the value returned by FS, and to update the value in the corresponding storage location.

Each time the application writes to the savegame, the value should be updated by both the application and through FS. Usually, applications update this value by incrementing it. However, generating a new random-number or other methods of updating it can be used as well.

==Anti Savegame Restore Save Data==
The save data used for this feature is stored in [[System_SaveData|System Save Data]] ID 0x00010011 and contains only one file, named <code>DB</code>:

===Main Structure===
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1000 || Header
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8, version (usually 0)
|-
| 0x1 || 0x3 || padding
|-
| 0x4 || 0x4 || u32, number of secure value entries
|-
| 0x8 || 0xFF8 || completely unused, padding
|}
|-
| 0x1000 || 0x1C000 (8 * 14336) || [[Filesystem_services#SecureValueKey|Secure value keys]]
|-
| 0x1D000 || 0x1C000 (8 * 14336) || u64s, Secure values
|}

===SecureValueKey===
Depending on which command is used, secure value keys can be interpreted as:
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || u64, Title ID
|}
or:
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, [[Filesystem_services#SecureValueSlot|Secure Value Slot]]
|-
| 0x4 || 0x4 || u32, Unique ID
|}

==Applications using this feature==
* Animal Crossing: New Leaf
* Pokemon X & Y
* Pokemon Omega Ruby & Alpha Sapphire
* Pokemon Omega Ruby & Alpha Sapphire Demo
* Pokemon Shuffle
* Super Smash Bros
* Pokemon Red,Blue and Yellow (GB(C) VC)
* Rusty's Real Deal Baseball
* Megami Meguri

=SEEDDB and TITLETAG=
With [[9.6.0-24|9.6.0-X]] new [[System_SaveData]] with save ID 0x0001000F was added. This save data contains both the NCCH seed database (SEEDDB) and the title tag database (TITLETAG).

These databases are managed by the commands [[FS:AddSeed]], [[FS:GetSeed]], [[FS:DeleteSeed]], [[FS:GetNumSeeds]] and [[FS:ListSeeds]] for SEEDDB, and [[FS:AddTitleTag]], [[FS:GetTitleTag]], [[FS:DeleteTitleTag]], [[FS:GetNumTitleTags]], and [[FS:ListTitleTags]] for TITLETAG respectively.

Both the [[Home_Menu|HOME Menu]] and the [[NIM_Services|NIM]] module have access to these commands.

==SEEDDB==

Stored in the system savedata archive 0x0001000F as a file named <code>SEEDDB</code>, it contains the title-unique seed-data used for the new [[NCCH]] keyY generation added with FIRM [[9.6.0-24|9.6.0-X]].

The file follows a simple key-value format allowing the storage of seed data for up to 2000 unique title IDs.

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1000 || Header
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8, version (usually 0)
|-
| 0x1 || 0x3 || padding
|-
| 0x4 || 0x4 || u32, number of seed entries
|-
| 0x8 || 0xFF8 || completely unused, padding
|}
|-
| 0x1000 || 0x3E80 (8 * 2000) || u64s, Title IDs
|-
| 0x4E80 || 0x7D00 (16 * 2000) || Seed data, 16 bytes per seed
|}

==TITLETAG Database==

Stored in the system savedata archive 0x0001000F as a file named <code>TITLETAG</code>, it contains information used by the [[Home_Menu|HOME Menu]] to handle cases when a to-be-released title has been purchased already, that is, to properly install the seed required for [[NCCH]] keyY generation added with FIRM [[9.6.0-24|9.6.0-X]].

When a to-be-released title is purchased, the [[NIM_Services|NIM]] module installs a [[Filesystem_services#TitleTag|title tag]] with enough information about the title for the [[Home_Menu|HOME Menu]] to be able to initiate a seed import once the title has been released (and thus, the title's NCCH content lock seed). Until the title's seed is released, and while the title tag remains in the database, the HOME Menu will prevent the user from launching the software as it would not run without the seed. Once released, information from the title tag is used to download the seed, and, if successful, the title tag is removed from the database, making the software playable.

The file follows a simple key-value format allowing the storage of title tag data for up to 2000 unique title IDs.

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1000 || Header
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8, version (usually 0)
|-
| 0x1 || 0x3 || padding
|-
| 0x4 || 0x4 || u32, number of entries
|-
| 0x8 || 0xFF8 || completely unused, padding
|}
|-
| 0x1000 || 0x3E80 (8 * 2000) || u64s, Title IDs
|-
| 0x4E80 || 0x3E800 (0x80 * 2000) || [[Filesystem_services#TitleTag|Title Tag]] data, 0x80 bytes per entry
|}

= Common Types =
== MediaType ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0
| NAND
|-
| 1
| SD
|-
| 2
| Game Card
|}

== SystemMediaType ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0
| CTR NAND
|-
| 1
| TWL NAND
|-
| 2
| SD
|-
| 3
| TWL Photo
|}

== OpenFlags ==
{| class="wikitable" border="1"
|-
! Bit
! Description
|-
| 0
| Read
|-
| 1
| Write
|-
| 2
| Create
|}

== Attributes ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| Is Directory
|-
| 0x1
| 0x1
| Is Hidden
|-
| 0x2
| 0x1
| Is Archive
|-
| 0x3
| 0x1
| Is Read-Only
|}

== WriteOption ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| Flush
|-
| 0x1
| 0x1
| Update Time Stamp
|-
| 0x2
| 0x1
| Reserved
|-
| 0x3
| 0x1
| Reserved
|}

== DirectoryEntry ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x20C
| UTF-16 Entry Name
|-
| 0x20C
| 0xA
| 8.3 short filename name
|-
| 0x216
| 0x4
| 8.3 short filename extension
|-
| 0x21A
| 0x1
| Always 1
|-
| 0x21B
| 0x1
| Reserved
|-
| 0x21C
| 0x4
| [[Filesystem_services#Attributes|Attributes]]
|-
| 0x220
| 0x8
| Entry Size
|}

== ArchiveResource ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| Sector byte-size
|-
| 0x4
| 0x4
| Cluster byte-size
|-
| 0x8
| 0x4
| Partition capacity in clusters
|-
| 0xC
| 0x4
| Available free space in clusters
|}

== ProgramInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x8
| Program ID
|-
| 0x8
| 0x1
| [[Filesystem_services#MediaType|Media Type]]
|-
| 0x9
| 0x7
| Padding
|}

== ProductInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| Product Code
|-
| 0x10
| 0x2
| Company Code
|-
| 0x12
| 0x2
| Remaster Version
|}

== IntegrityVerificationSeed ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| AES-CBC MAC over a SHA256 hash, which hashes the first 0x110-bytes of the cleartext SEED.
|-
| 0x10
| 0x120
| The [[nand/private/movable.sed]], encrypted with AES-CBC using the above MAC for the counter.
|}

== ExtSaveDataInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 0x4
| 0x8
| Save ID
|-
| 0xC
| 0x4
| Reserved
|}

== SystemSaveDataInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 0x4
| 0x4
| Save ID
|}

== SecureValueSlot ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x1000
| SD Application
|}

== SecureValueEntry ==
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, [[Filesystem_services#SecureValueSlot|Secure Value Slot]]
|-
| 0x4 || 0x1 || When used as an input entry:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || This entry should be removed.
|-
| 1 || This entry should be updated with the given value.
|}
When returned from a command:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || No entry with the given slot and title ID was found, or: this entry is unused.
|-
| 1 || The entry with the given slot and title ID was found, or: this entry is used.
|}
|-
| 0x5 || 0x3 || padding
|-
| 0x8 || 0x8 || u64, Secure Value
|}

== TitleTag ==
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Magic, <code>PREP</code> (PREPurchase install)
|-
| 0x4 || 0x4 || s32, Release date year
|-
| 0x8 || 0x1 || u8, Release date month
|-
| 0x9 || 0x1 || u8, Release date day
|-
| 0xA || 0x2 || u16, Country code
|-
| 0xC || 0x4 || u32, Seed status (0: not downloaded yet, 1: last download attempt failed, 2: seed installed successfully)
|-
| 0x10 || 0x4 || Result code from last seed installation attempt
|-
| 0x14 || 0x4 || Support error code from last seed installation attempt
|-
| 0x18 || 0x68 || reserved padding (unused)
|}

== CardSpiBaudRate ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x0
| 512KHz
|-
| 0x1
| 1MHz
|-
| 0x2
| 2MHz
|-
| 0x3
| 4MHz
|-
| 0x4
| 8MHz
|-
| 0x5
| 16MHz
|}

== CardSpiBusMode ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x0
| 1-bit
|-
| 0x1
| 4-bit
|}

== SpecialContentType ==
{| class="wikitable" border="1"
|-
! Value
! Description
! Found in
|-
| 0x1
| CTR (Old3DS) Update Partition
| Gamecards
|-
| 0x2
| Manual
| Gamecards, Digital titles
|-
| 0x3
| DLP Child
| Gamecards, Digital titles
|-
| 0x4
| KTR (New3DS) Update Partition
| Gamecards
|-
|}

== DeviceMoveContext ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| IVs (ID0 of source console)
|-
| 0x10
| 0x10
| Encrypt Parameter (used to calculate the IV for encryption)
|}

=Errors=
See [[Filesystem_services_PXI]].

[[Category:Services]]

System SaveData

2025-07-01T20:18:48Z

TimmSkiller: /* System Module Savegames */

Savegames stored in NAND are located at [[Flash_Filesystem|nand:/data/<ID0>/sysdata/<SaveID-Low>/<SaveID-High>]], where SaveID-High is the filename. SaveID-High is normally 00000000.

Access to system savedata via [[Filesystem_services|fs:USER]] is determined by the [[NCCH#CXI|exheader_storageinfo]] accessinfo and systemsavedataid. Most ARM11 processes using fs:USER only have access to the SaveIDs specified by systemsavedataid, when a certain accessinfo bit is set the process can access all system-savedata however. The 8-byte systemsavedataid is two SaveID-Low words which the process has access to, normally only the first word is used. When the process doesn't have access to any system-savedata via systemsavedataid, systemsavedataid is all-zero.

=NAND Savegames=
The SaveID for system modules is usually 0x00010000 | [[Titles|uniqueID]]. The SaveID for other system processes (like applications) is 0x00020000 | [[Titles|uniqueID]].

==System Module Savegames==
{| class="wikitable" border="1"
|-
! SaveID
! Description
|-
| 0x0001000F
| [[Filesystem_services|FS]] module savedata, used for [[Filesystem_services#SEEDDB|SEEDDB]] and [[Filesystem_services#TITLETAG_Database|TITLETAG]] storage.
|-
| 0x00010011
| [[Filesystem_services|FS]] module savedata, used for [[Filesystem_services#Anti_Savegame_Restore|Anti Savegame Restore]].
|-
| 0x00010015
| [[Application_Manager_Services|AM]] module savedata
|-
| 0x00010017
| [[Config Savegame]]
|-
| 0x00010022
| [[PTM]] [[PTM_Savegame|savegame]]
|-
| 0x00010026
| [[StreetPass|CECD]] savegame
|-
| 0x0001002C
| [[NIM_Services|NIM]] savegame
|-
| 0x00010032
| [[FRD_Savegame|Friends module savegame]]
|-
| 0x00010034
| [[SpotPass|BOSS]] module [[BOSS Savegame|savegame]]
|-
| 0x00010035
| News module savegame
|-
| 0x00010038
| Act module savegame
|-
| 0x00010040
| [[NFC_Services|NFC]] module savegame
|}

==System application and applet savegames==
{| class="wikitable" border="1"
|-
! JPN SaveID
! USA SaveID
! EUR SaveID
! Description
|-
| 0x000200C5
| Same as JPN
| Same as JPN
| "error" applet savegame
|-
| 0x00020082
| 0x0002008F
| 0x00020098
| [[Home Menu]] savegame
|-
| 0x00020086
| 0x00020092
| 0x0002009B
| Instruction Manual applet savegame
|-
| 0x00020087
| 0x00020093
| 0x0002009C
| Game Notes applet savegame
|-
| 0x00020088
| 0x00020094
| 0x0002009D
| Old3DS/New3DS [[Internet Browser]] savegame
|-
| 0x0002008D
| 0x00020096
| 0x0002009F
| Friend List applet savegame
|-
| 0x000200BB
| Same as JPN
| Same as JPN
| Additional savedata for the New3DS [[Internet Browser]]. This only contains "t.bin" with filesize 0xadf80. This contains all browser history: each entry has the URL, UTF-16 title string, and icon gfx. This includes old pages which are not currently open in the browser as tabs?
|-
| 0x000200BC
| 0x000200BD
| 0x000200BE
| olv applet savegame (Miiverse)
|-
| 0x000200C6
| Same as JPN
| Same as JPN
| mint applet savegame
|-
| 0x00020200
| 0x00020210
| 0x00020220
| [[System Settings]] savegame
|-
| 0x00020202
| 0x00020212
| 0x00020222
| [[Activity Log]] application savegame
|-
| 0x00020204
| 0x00020214
| 0x00020224
| [[Nintendo 3DS Camera]] application savegame
|-
| 0x00020205
| 0x00020215
| 0x00020225
| [[Nintendo 3DS Sound]] application savegame
|-
| 0x00020207
| 0x00020217
| 0x00020227
| [[Mii Maker]] application savegame
|-
| 0x00020208
| 0x00020218
| 0x00020228
| [[StreetPass Mii Plaza]] application savegame
|-
| 0x00020209
| 0x00020219
| 0x00020229
| [[eShop]] application savegame
|-
| 0x0002020A
| 0x0002021A
| 0x0002022A
| [[System Transfer]] savegame
|-
| 0x0002020B
| 0x0002021B
| 0x0002022B
| [[Nintendo Zone]] savegame
|-
| 0x0002020D
| 0x0002021D
| 0x0002022D
| [[Face Raiders]] savegame
|-
| 0x0002020E
| 0x0002021E
| 0x0002022E
| [[AR Games]] savegame
|-
| 0x000202BF
| 0x000202C0
| 0x000202C1
| act (NNID settings) application savegame
|-
| 0x00020231
| 0x00020241
| 0x00020251
| [[microSD Management]] application savegame
|}

Filesystem services

2025-07-01T20:15:21Z

TimmSkiller:

= Services =
{{Anchor|FS}}{{Anchor|FSUSER}}{{Anchor|fs:USER}}
== Filesystem service "fs:USER" ==
You can at most have 32 FS archive handles.

{| class="wikitable" border="1"
|-
! Command Header
! Available since system version
! Description
! scope="col" width="400" | Required [[NCCH/Extended_Header|exheader]] access info bitmask
|-
| 0x000100C6
|?
| [[FS:Dummy1|Dummy1]]
| None
|-
| 0x040100C4
|?
| [[FS:Control|Control]]
| None
|-
| 0x08010002
|?
| [[FS:Initialize|Initialize]]
| None
|-
| 0x080201C2
|?
| [[FS:OpenFile|OpenFile]]
| None
|-
| 0x08030204
|?
| [[FS:OpenFileDirectly|OpenFileDirectly]]
| None
|-
| 0x08040142
|?
| [[FS:DeleteFile|DeleteFile]]
| None
|-
| 0x08050244
|?
| [[FS:RenameFile|RenameFile]]
| None
|-
| 0x08060142
|?
| [[FS:DeleteDirectory|DeleteDirectory]]
| None
|-
| 0x08070142
|?
| [[FS:DeleteDirectoryRecursively|DeleteDirectoryRecursively]]
| None
|-
| 0x08080202
|?
| [[FS:CreateFile|CreateFile]]
| None
|-
| 0x08090182
|?
| [[FS:CreateDirectory|CreateDirectory]]
| None
|-
| 0x080A0244
|?
| [[FS:RenameDirectory|RenameDirectory]]
| None
|-
| 0x080B0102
|?
| [[FS:OpenDirectory|OpenDirectory]]
| None
|-
| 0x080C00C2
|?
| [[FS:OpenArchive|OpenArchive]]
| Each archive ID code has separate access info bitmasks, if it has any
|-
| 0x080D0144
|?
| [[FS:ControlArchive|ControlArchive]]
| None
|-
| 0x080E0080
|?
| [[FS:CloseArchive|CloseArchive]]
| None
|-
| 0x080F0180
|?
| [[FS:Obsoleted_2_0_FormatThisUserSaveData|Obsoleted_2_0_FormatThisUserSaveData]]
| None
|-
| 0x08100200
|?
| [[FS:Obsoleted_3_0_CreateSystemSaveData|Obsoleted_3_0_CreateSystemSaveData]]
| 0x4, for when the input saveID doesn't match the exheader saveID
|-
| 0x08110040
|?
| [[FS:Obsoleted_3_0_DeleteSystemSaveData|Obsoleted_3_0_DeleteSystemSaveData]]
| 0x1004, for when the input saveID doesn't match the exheader saveID
|-
| 0x08120080
|?
| [[FS:GetFreeBytes|GetFreeBytes]]
| None
|-
| 0x08130000
|?
| [[FS:GetCardType|GetCardType]]
| 0x1017
|-
| 0x08140000
|?
| [[FS:GetSdmcArchiveResource|GetSdmcArchiveResource]]
| None
|-
| 0x08150000
|?
| [[FS:GetNandArchiveResource|GetNandArchiveResource]]
| 0x1007
|-
| 0x08160000
|?
| [[FS:GetSdmcFatfsError|GetSdmcFatfsError]]
| 0x2
|-
| 0x08170000
|?
| [[FS:IsSdmcDetected|IsSdmcDetected]]
| None
|-
| 0x08180000
|?
| [[FS:IsSdmcWritable|IsSdmcWritable]]
| None
|-
| 0x08190042
|?
| [[FS:GetSdmcCid|GetSdmcCid]]
| 0x2
|-
| 0x081A0042
|?
| [[FS:GetNandCid|GetNandCid]]
| 0x2
|-
| 0x081B0000
|?
| [[FS:GetSdmcSpeedInfo|GetSdmcSpeedInfo]]
| 0x2
|-
| 0x081C0000
|?
| [[FS:GetNandSpeedInfo|GetNandSpeedInfo]]
| 0x2
|-
| 0x081D0042
|?
| [[FS:GetSdmcLog|GetSdmcLog]]
| 0x2
|-
| 0x081E0042
|?
| [[FS:GetNandLog|GetNandLog]]
| 0x2
|-
| 0x081F0000
|?
| [[FS:ClearSdmcLog|ClearSdmcLog]]
| 0x2
|-
| 0x08200000
|?
| [[FS:ClearNandLog|ClearNandLog]]
| 0x2
|-
| 0x08210000
|?
| [[FS:CardSlotIsInserted|CardSlotIsInserted]]
| 0x1017
|-
| 0x08220000
|?
| [[FS:CardSlotPowerOn|CardSlotPowerOn]]
| 0x2
|-
| 0x08230000
|?
| [[FS:CardSlotPowerOff|CardSlotPowerOff]]
| 0x2
|-
| 0x08240000
|?
| [[FS:CardSlotGetCardIFPowerStatus|CardSlotGetCardIFPowerStatus]]
| 0x2
|-
| 0x08250040
|?
| [[FS:CardNorDirectCommand|CardNorDirectCommand]]
| 0x2
|-
| 0x08260080
|?
| [[FS:CardNorDirectCommandWithAddress|CardNorDirectCommandWithAddress]]
| 0x2
|-
| 0x08270082
|?
| [[FS:CardNorDirectRead|CardNorDirectRead]]
| 0x2
|-
| 0x082800C2
|?
| [[FS:CardNorDirectReadWithAddress|CardNorDirectReadWithAddress]]
| 0x2
|-
| 0x08290082
|?
| [[FS:CardNorDirectWrite|CardNorDirectWrite]]
| 0x2
|-
| 0x082A00C2
|?
| [[FS:CardNorDirectWriteWithAddress|CardNorDirectWriteWithAddress]]
| 0x2
|-
| 0x082B00C2
|?
| [[FS:CardNorDirectRead_4xIO|CardNorDirectRead_4xIO]]
| 0x2
|-
| 0x082C0082
|?
| [[FS:CardNorDirectCpuWriteWithoutVerify|CardNorDirectCpuWriteWithoutVerify]]
| 0x2
|-
| 0x082D0040
|?
| [[FS:CardNorDirectSectorEraseWithoutVerify|CardNorDirectSectorEraseWithoutVerify]]
| 0x2
|-
| 0x082E0040
|?
| [[FS:GetProductInfo|GetProductInfo]]
| 0x1005
|-
| 0x082F0040
|?
| [[FS:GetProgramLaunchInfo|GetProgramLaunchInfo]]
| 0x1005
|-
| 0x08300182
|?
| [[FS:Obsoleted_3_0_CreateExtSaveData|Obsoleted_3_0_CreateExtSaveData]]
| 0xC, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08310180
|?
| [[FS:Obsoleted_3_0_CreateSharedExtSaveData|Obsoleted_3_0_CreateSharedExtSaveData]]
| 0x1005
|-
| 0x08320102
|?
| [[FS:Obsoleted_3_0_ReadExtSaveDataIcon|Obsoleted_3_0_ReadExtSaveDataIcon]]
| 0x100D, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08330082
|?
| [[FS:Obsoleted_3_0_EnumerateExtSaveData|Obsoleted_3_0_EnumerateExtSaveData]]
| 0x1005
|-
| 0x08340082
|?
| [[FS:Obsoleted_3_0_EnumerateSharedExtSaveData|Obsoleted_3_0_EnumerateSharedExtSaveData]]
| 0x1005
|-
| 0x08350080
|?
| [[FS:Obsoleted_3_0_DeleteExtSaveData|Obsoleted_3_0_DeleteExtSaveData]]
| 0x100D, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08360080
|?
| [[FS:Obsoleted_3_0_DeleteSharedExtSaveData|Obsoleted_3_0_DeleteSharedExtSaveData]]
| 0x1005
|-
| 0x08370040
|?
| [[FS:SetCardSpiBaudRate|SetCardSpiBaudRate]]
| 0x2
|-
| 0x08380040
|?
| [[FS:SetCardSpiBusMode|SetCardSpiBusMode]]
| 0x2
|-
| 0x08390000
|?
| [[FS:SendInitializeInfoTo9|SendInitializeInfoTo9]]
| None
|-
| 0x083A0100
|?
| [[FS:GetSpecialContentIndex|GetSpecialContentIndex]]
| 0x1005
|-
| 0x083B00C2
|?
| [[FS:GetLegacyRomHeader|GetLegacyRomHeader]]
| 0x1015
|-
| 0x083C00C2
|?
| [[FS:GetLegacyBannerData|GetLegacyBannerData]]
| 0x1015
|-
| 0x083D0100
|?
| [[FS:CheckAuthorityToAccessExtSaveData|CheckAuthorityToAccessExtSaveData]]
| 0x44
|-
| 0x083E00C2
|?
| [[FS:QueryTotalQuotaSize|QueryTotalQuotaSize]]
| None
|-
| 0x083F00C0
|?
| [[FS:Obsoleted_3_0_GetExtDataBlockSize|Obsoleted_3_0_GetExtDataBlockSize]]
| None
|-
| 0x08400040
|?
| [[FS:AbnegateAccessRight|AbnegateAccessRight]]
|?
|-
| 0x08410000
|?
| [[FS:DeleteSdmcRoot|DeleteSdmcRoot]]
| 0x1005
|-
| 0x08420040
|?
| [[FS:DeleteAllExtSaveDataOnNand|DeleteAllExtSaveDataOnNand]]
| 0x1005
|-
| 0x08430000
|?
| [[FS:InitializeCtrFileSystem|InitializeCtrFileSystem]]
| None
|-
| 0x08440000
|?
| [[FS:CreateSeed|CreateSeed]]
| 0x2
|-
| 0x084500C2
|?
| [[FS:GetFormatInfo|GetFormatInfo]]
|?
|-
| 0x08460102
|?
| [[FS:GetLegacyRomHeader2|GetLegacyRomHeader2]]
| 0x1015
|-
| 0x08470180
|?
| [[FS:Obsoleted_2_0_FormatCtrCardUserSaveData|Obsoleted_2_0_FormatCtrCardUserSaveData]]
| 0x6
|-
| 0x08480042
|?
| [[FS:GetSdmcCtrRootPath|GetSdmcCtrRootPath]]
| 0x100D
|-
| 0x08490040
|?
| [[FS:GetArchiveResource|GetArchiveResource]]
|?
|-
| 0x084A0002
|?
| [[FS:ExportIntegrityVerificationSeed|ExportIntegrityVerificationSeed]]
| 0x4000
|-
| 0x084B0002
|?
| [[FS:ImportIntegrityVerificationSeed|ImportIntegrityVerificationSeed]]
| 0x4000
|-
| 0x084C0242
|?
| [[FS:FormatSaveData|FormatSaveData]]
| 0x6, in some cases this write isn't needed however
|-
| 0x084D0102
|?
| [[FS:GetLegacySubBannerData|GetLegacySubBannerData]]
| 0x1015
|-
| 0x084E0342
|?
| [[FS:UpdateSha256Context|UpdateSha256Context]]
| 0x5
|-
| 0x084F0102
|?
| [[FS:ReadSpecialFile|ReadSpecialFile]]
| None
|-
| 0x08500040
|?
| [[FS:GetSpecialFileSize|GetSpecialFileSize]]
| None
|-
| 0x08510242
| [[3.0.0-5]]
| [[FS:CreateExtSaveData|CreateExtSaveData]]
| Shared extdata: 0x101005. Regular extdata in certain cases: 0xC
|-
| 0x08520100
| [[3.0.0-5]]
| [[FS:DeleteExtSaveData|DeleteExtSaveData]]
| Shared extdata: 0x101005. Regular extdata in certain cases: 0x10100D
|-
| 0x08530142
| [[3.0.0-5]]
| [[FS:ReadExtSaveDataIcon|ReadExtSaveDataIcon]]
| 0x10100D (this doesn't apply in certain cases, however)
|-
| 0x085400C0
| [[3.0.0-5]]
| [[FS:GetExtDataBlockSize|GetExtDataBlockSize]]
| 0x10100D (this doesn't apply in certain cases, however)
|-
| 0x08550102
| [[3.0.0-5]]
| [[FS:EnumerateExtSaveData|EnumerateExtSaveData]]
| 0x101005
|-
| 0x08560240
| [[3.0.0-5]]
| [[FS:CreateSystemSaveData|CreateSystemSaveData]]
| 0x4 (this doesn't apply in certain cases, however)
|-
| 0x08570080
| [[3.0.0-5]]
| [[FS:DeleteSystemSaveData|DeleteSystemSaveData]]
| 0x1004 (this doesn't apply in certain cases, however)
|-
| 0x08580000
| [[3.0.0-5]]
| [[FS:StartDeviceMoveAsSource|StartDeviceMoveAsSource]]
| 0x2004
|-
| 0x08590200
| [[3.0.0-5]]
| [[FS:StartDeviceMoveAsDestination|StartDeviceMoveAsDestination]]
| 0x2004
|-
| 0x085A00C0
| [[3.0.0-5]]
| [[FS:SetArchivePriority|SetArchivePriority]]
| None
|-
| 0x085B0080
| [[3.0.0-5]]
| [[FS:GetArchivePriority|GetArchivePriority]]
| None
|-
| 0x085C00C0
| [[3.0.0-5]]
| [[FS:SetCtrCardLatencyParameter|SetCtrCardLatencyParameter]]
| 0xE
|-
| 0x085D01C0
| [[3.0.0-5]]
| [[FS:SetFsCompatibilityInfo|SetFsCompatibilityInfo]]
| 0x100001
|-
| 0x085E0040
| [[3.0.0-5]]
| [[FS:ResetCardCompatibilityParameter|ResetCardCompatibilityParameter]]
| 0xE
|-
| 0x085F0040
| [[3.0.0-5]]
| [[FS:SwitchCleanupInvalidSaveData|SwitchCleanupInvalidSaveData]]
| 0x12004
|-
| 0x08600042
| [[3.0.0-5]]
| [[FS:EnumerateSystemSaveData|EnumerateSystemSaveData]]
| 0x2004
|-
| 0x08610042
| [[3.0.0-5]]
| [[FS:InitializeWithSdkVersion|InitializeWithSdkVersion]]
| None
|-
| 0x08620040
| [[3.0.0-5]]
| [[FS:SetPriority|SetPriority]]
| None
|-
| 0x08630000
| [[3.0.0-5]]
| [[FS:GetPriority|GetPriority]]
| None
|-
| 0x08640000
| [[3.0.0-5]]
| [[FS:Obsoleted_4_0_GetNandInfo|Obsoleted_4_0_GetNandInfo]]
| Stubbed, this returns an error
|-
| 0x08650140
| [[4.0.0-7]]
| [[FS:SetSaveDataSecureValue|SetSaveDataSecureValue]]
| 0x121004 (in certain cases this doesn't apply, however)
|-
| 0x086600C0
| [[4.0.0-7]]
| [[FS:GetSaveDataSecureValue|GetSaveDataSecureValue]]
| 0x121004 (in certain cases this doesn't apply, however)
|-
| 0x086700C4
| [[4.0.0-7]]
| [[FS:ControlSecureSave|ControlSecureSave]]
| 0x121004
|-
| 0x08680000
| [[4.0.0-7]]
| [[FS:GetMediaType|GetMediaType]]
| None
|-
| 0x08690000
| [[4.0.0-7]]
| [[FS:Obsoleted_4_0_GetNandEraseCount|Obsoleted_4_0_GetNandEraseCount]]
| Stubbed, this returns an error.
|-
| 0x086A0082
| [[4.0.0-7]]
| [[FS:ReadNandReport|ReadNandReport]]
| None
|-
| 0x086B00C2
|?
| [[FS:SetOtherSaveDataSecureValue|SetOtherSaveDataSecureValue]]
| 0x121004
|-
| 0x086C00C2
|?
| [[FS:GetOtherSaveDataSecureValue|GetOtherSaveDataSecureValue]]
| 0x121004
|-
| 0x086D0080
|?
| [[FS:BeginSaveDataMove|BeginSaveDataMove]]
| 0x20004
|-
| 0x086E00C0
|?
| [[FS:SetThisSaveDataSecureValue|SetThisSaveDataSecureValue]]
|None
|-
| 0x086F0040
|?
| [[FS:GetThisSaveDataSecureValue|GetThisSaveDataSecureValue]]
| None
|-
| 0x087000C2
|?
| [[FS:CheckArchive|CheckArchive]]
|None
|-
| 0x08710140
| ?
| [[FS:TransferSaveDataCMAC|TransferSaveDataCMAC]]
| 0x20004
|-
| 0x08720200
|?
| [[FS:RegisterTitleContentOverlay|RegisterTitleContentOverlay]]
| 0x80004
|-
| 0x08730100
|?
| [[FS:UnregisterTitleContentOverlay|UnregisterTitleContentOverlay]]
| 0x80004
|-
| 0x08740000
|?
| [[FS:UnregisterAllTitleContentOverlays|UnregisterAllTitleContentOverlays]]
| 0x80004
|-
| 0x08750140
|?
| [[FS:SetSaveArchiveSecureValue|SetSaveArchiveSecureValue]]
|None
|-
| 0x087600C0
|?
| [[FS:GetSaveArchiveSecureValue|GetSaveArchiveSecureValue]]
|None
|-
| 0x08770140
|?
| [[FS:RegisterSpecialTitleContent|RegisterSpecialTitleContent]]
| 0x80004
|-
| 0x08780100
|?
| [[FS:UnregisterSpecialTitleContent|UnregisterSpecialTitleContent]]
| 0x80004
|-
| 0x087900C2
| ?
| Same as [[FS:GetLegacyBannerData|GetLegacyBannerData]], except for the last parameter this internally passes u8 value 0x1 instead of 0x0, for the FSPXI command.
| 0x101015
|-
| 0x087A0180
| [[9.6.0-24|9.6.0-X]]
| [[FS:AddSeed|AddSeed]]
| 0x200000
|-
| 0x087B0080
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetSeed|GetSeed]]
| 0x200000
|-
| 0x087C0080
| [[9.6.0-24|9.6.0-X]]
| [[FS:DeleteSeed|DeleteSeed]]
| 0x200000
|-
| 0x087D0000
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetNumSeeds|GetNumSeeds]]
| 0x200000
|-
| 0x087E0042
| [[9.6.0-24|9.6.0-X]]
| [[FS:ListSeeds|ListSeeds]]
| 0x200000
|-
| 0x087F0100
| [[9.6.0-24|9.6.0-X]]
| [[FS:TitleContentHasSeed|TitleContentHasSeed]]
| 0x200000
|-
| 0x08800880
| [[9.6.0-24|9.6.0-X]]
| [[FS:AddTitleTag|AddTitleTag]]
| 0x200000
|-
| 0x08810080
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetTitleTag|GetTitleTag]]
| 0x200000
|-
| 0x08820080
| [[9.6.0-24|9.6.0-X]]
| [[FS:DeleteTitleTag|DeleteTitleTag]]
| 0x200000
|-
| 0x08830000
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetNumTitleTags|GetNumTitleTags]]
| 0x200000
|-
| 0x08840042
| [[9.6.0-24|9.6.0-X]]
| [[FS:ListTitleTags|ListTitleTags]]
| 0x200000
|-
| 0x088500C0
| [[9.6.0-24|9.6.0-X]]
| [[FS:CheckTitleSeed|CheckTitleSeed]]
| 0x200000
|-
| 0x088600C0
| [[11.1.0-34|11.1.0-X]]
| [[FS:CheckUpdatedDat|CheckUpdatedDat]]
| 0x80000
|}

Note: The question marks from Dummy1 to GetSpecialFileSize on the "available since system version" field are mainly there because I think that most of these are necessary for the main system to function, so theoretically that would mean that since the creation of the 3DS these were available, or since launch if that makes more sense. But because of the peculiar nature of some of the functions, they will remain question marks until they can be confirmed 100%.

When access rights are required for a command, at least one of the bits in the process access info specified in the above table for the command must be set. Error 0xD9004676 is returned when a process attempts to use a command which it doesn't have access rights for the command. The exheader access info field is all zero's for most applications. Note that the permissions listed in the above table is for system-version v2.x, therefore permission bit(s) added with newer FIRM may be missing from this.

Each session for fs:USER has separate permissions, initially these are set to all zero's for new fs:USER sessions. The permissions/etc for fs:USER sessions are initialized via [[FS:Initialize]](loaded from the user process exheader).

{{Anchor|FSLDR}}{{Anchor|fs:LDR}}

== Filesystem service "fs:LDR" ==
This service is identical to fs:USER, except [[FS:OpenArchive]] archive 0x2345678E can only be accessed with fs:LDR.

{{Anchor|FSReg}}{{Anchor|FSREG}}{{Anchor|fs:REG}}
== ProgramRegistry service "fs:REG" ==
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C6
| [[FSReg:Dummy1|Dummy1]]
|-
| 0x040103C0
| [[FSReg:Register|Register]]
|-
| 0x04020040
| [[FSReg:Unregister|Unregister]]
|-
| 0x040300C0
| [[FSReg:GetProgramInfo|GetProgramInfo]]
|-
| 0x04040100
| [[FSReg:LoadProgram|LoadProgram]]
|-
| 0x04050080
| [[FSReg:UnloadProgram|UnloadProgram]]
|-
| 0x04060080
| [[FSReg:CheckHostLoadId|CheckHostLoadId]]
|}

Only two sessions can be opened for this service at a time, hence no other processes can use this due to [[Process_Manager_Services|pm-module]] and [[Loader_Services|loader]] using this.

=File and directory access=
==Files==
File session handles obtained via [[FS:OpenFile]] and [[FS:OpenFileDirectly]] can be used to access files through a service-like interface, despite not being an actual service registered using [[SRV:RegisterService]]. To use this service-like interface, simply call the SendSyncRequest SVC with a file session handle, using the IPC buffer in thread-local storage for parameters and responses, just like you would with a proper service.

{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C6
| [[FSFile:Dummy1|Dummy1]]
|-
| 0x040100C4
| [[FSFile:Control|Control]]
|-
| 0x08010100
| [[FSFile:OpenSubFile|OpenSubFile]]
|-
| 0x080200C2
| [[FSFile:Read|Read]]
|-
| 0x08030102
| [[FSFile:Write|Write]]
|-
| 0x08040000
| [[FSFile:GetSize|GetSize]]
|-
| 0x08050080
| [[FSFile:SetSize|SetSize]]
|-
| 0x08060000
| [[FSFile:GetAttributes|GetAttributes]]
|-
| 0x08070040
| [[FSFile:SetAttributes|SetAttributes]]
|-
| 0x08080000
| [[FSFile:Close|Close]]
|-
| 0x08090000
| [[FSFile:Flush|Flush]]
|-
| 0x080A0040
| [[FSFile:SetPriority|SetPriority]]
|-
| 0x080B0000
| [[FSFile:GetPriority|GetPriority]]
|-
| 0x080C0000
| [[FSFile:OpenLinkFile|OpenLinkFile]]
|-
| 0x0C010100
| [[FSFile:GetAvailable|GetAvailable]]
|}

==Directories==
Directory session handles obtained via [[FS:OpenDirectory]] are usable via a service-like interface, following the exact same procedure described above for file sessions.
{| class="wikitable" border="1"
|-
! Command Header
! Available since system version
! Description
|-
| 0x000100C6
| [[1.0.0-0]]
| [[FSDir:Dummy1|Dummy1]]
|-
| 0x040100C4
| [[1.0.0-0]]
| [[FSDir:Control|Control]]
|-
| 0x08010042
| [[1.0.0-0]]
| [[FSDir:Read|Read]]
|-
| 0x08020000
| [[1.0.0-0]]
| [[FSDir:Close|Close]]
|-
| 0x08030040
| ?
| [[FSDir:SetPriority|SetPriority]]
|-
| 0x08040000
| ?
| [[FSDir:GetPriority|GetPriority]]
|}

= Archives =
{| class="wikitable" border="1"
|-
! ArchiveId
! Description
! Accessible via [[Filesystem_services|FS]]
! Accessible via [[Filesystem_services_PXI|FSPXI]]
! Only accessible by Process9 internally
! Requires binary [[FS:OpenFile|Lowpath]]
! Required exheader FS access info bitmask
|-
| 0x00000003
| SelfNCCH (including [[#RomFS|RomFS]])
| Yes
| No
| No
| No
| None
|-
| 0x00000004
| SaveData (the saveID/mediatype for this is loaded from data originally from the user process' exheader)
| Yes
| No
| No
| No
| None
|-
| 0x00000006
| ExtSaveData
| Yes
| No
| No
| Yes
| 0x100D, when the input extdataID isn't listed in the exheader.
|-
| 0x00000007
| Shared ExtSaveData
| Yes
| No
| No
| Yes
| None
|-
| 0x00000008
| SystemSaveData
| Yes
| No
| No
| Yes
| 0x4, when the input saveID doesn't match the exheader system-saveID.
|-
| 0x00000009
| SDMC
| Yes
| Yes
| No
| No
| 0x8E
|-
| 0x0000000A
| SDMC Write-Only
| Yes
| No
| No
| No
| 0x808E
|-
| 0x12345678
| ExtSaveData for BOSS
| Yes
| No
| No
| Yes
| 0x44
|-
| 0x12345679
| CARD SPI FS
| Yes
| Yes
| No
| No
| 0x16
|-
| 0x1234567B
| ExtSaveData, and ExtSaveData for BOSS
| No
| Yes
| No
| Yes
|
|-
| 0x1234567C
| SystemSaveData
| No
| Yes
| No
| Yes
|
|-
| 0x1234567D
| NAND RW
| Yes
| Yes
| No
| No
| 0x800
|-
| 0x1234567E
| NAND RO
| Yes
| Yes
| No
| No
| 0x200
|-
| 0x1234567F
| NAND RO Write FS
| No
| Yes
| No
| No
| ?
|-
| 0x12345680
| Extdata transfer. Used for transferring [[Extdata#NAND_Shared_Extdata|NAND Shared Extdata]] during [[System_Transfer#System_Save_Data_/_Shared_Extdata_Transfer|system tranfers]].
| Yes
| Yes
| No
| Yes
| ?
|-
| 0x12345681
| System Savedata transfer. Used for transferring [[System_SaveData|System Save Data]] during [[System_Transfer#System_Save_Data_/_Shared_Extdata_Transfer|system tranfers]].
| Yes
| Yes
| No
| Yes
| ?
|-
| 0x12345682
| Unknown. There's code for this in spider v9.9, but that code isn't actually used.
| Yes
| No
| No
| Yes
| ?
|-
| 0x2345678A
| Title access. With FS, this allows accessing NCCH/NCSD contents (ExeFS, RomFS, checking if a content uses a seed, checking the validity of the installed seed). FSPXI, additionally, allows opening raw NCCH/NCSD NCCH contents and DSiWare contents for reading, along with encrypted save data.
| Yes
| Yes
| No
| Yes
| 0x1005
|-
| 0x2345678B
| Used internally by Process9 as the lowest level title access archive. Allows for opening various sections of a title (TMD, CMD, raw contents, DLC contents, raw save data (including public/private/banner saves for DSiWare), title and/or content import context files and /data directories for save data.
| No
| No
| Yes
| Yes
|
|-
| 0x2345678C
| Used internally to access [[Title_Database|Title Database (/dbs)]] files. For SD, <code>title.db</code> and <code>import.db</code>. For NAND, <code>title.db</code>, <code>import.db</code>, <code>tmp_t.db</code>, <code>tmp_i.db</code>, and <code>jumpid.db</code>.
| No
| No
| Yes
| Yes
|
|-
| 0x2345678D
| Used internally to access non-title /dbs files on the NAND: <code>certs.db</code> and <code>ticket.db</code>.
| No
| No
| Yes
| No
|
|-
| 0x2345678E
| FSPXI: Program Access (limited subset of merged main title + update/patch title access). For fs:LDR(used by the "loader" FIRM ARM11-process), only <code>exefs:/.code</code>. Not accessible with fs:USER.
| Yes
| Yes
| No
| Yes
| None, see description.
|-
| 0x567890AB
| NAND CTR FS
| No
| Yes
| No
| No
| ?
|-
| 0x567890AC
| TWL PHOTO
| Yes
| Yes
| No
| No
| ?
|-
| 0x567890AD
| TWLS (DSi Sound stores recordings here). This is mapped to the FAT12 image stored in the file at [[Twln/shared2/0000]].
| No
| Yes
| No
| No
| ?
|-
| 0x567890AE
| NAND TWL FS
| Yes
| Yes
| No
| No
| 0x100
|-
| 0x567890AF
| NAND W FS
| Yes
| Yes
| No
| No
| 0x100
|-
| 0x567890B0
| Internally creates the same "ID Storage" wrapper over the NAND that is used for SystemSaveData and Shared ExtData, but all operations are stubbed and return 0xE0C046F8.
| No
| Yes
| No
| No
|
|-
| 0x567890B1
| Gamecard SaveData (for check). This is a wrapper for UserSaveDataForCheck: the OpenArchive code for that is called with archive-lowpath TID=0/mediatype=2(gamecard).
| Yes
| No
| No
| No
| 0x6
|-
| 0x567890B2
| UserSaveData (for check). This is the same as the regular SaveData archive, except with this the savedata ID and mediatype is loaded from the input archive lowpath.
| Yes
| No
| No
| Yes
| 0x6
|-
| 0x567890B3
| [[3DS_Virtual_Console#NAND_Savegame|AGB Save Data]]
| No
| No
| Yes
| No
| -
|-
| 0x567890B4
| Similar to 0x567890B2 but can only access Accessible Save specified in [[NCCH/Extended_Header#Storage_Info|exheader]]?
| Yes
| No
| No
| Yes
| ?
|}

Archives listed as not requiring a binary lowpath, use lowpath type [[FS:OpenFile|empty]].

The above permission bitmasks are from v2.x, see the above Services section for how these are handled.

Archives CTR NAND, NAND RO Write FS, TWL NAND, NAND W FS, and CARD SPI FS require the corresponding process exheader access control mount flag to be set, in the exheader for any of the currently running ARM11 processes, for [[Filesystem_services_PXI|FSPXI]]. The access rights checked by [[Filesystem services|FS]] module for archive mounting with fs:USER, are stored in the process' exheader accessinfo.

The CARDSPI archive allows access to the gamecard CARD1 raw savedata flash(aka "cardspi:/" in [[FIRM|Process9]]), the file lowpath must be WCHAR "/". The "NAND W FS" archive allows access to the raw NAND image(aka "wnand:/" in Process9), the file lowpath must be WCHAR "/".

= Filenames and Paths =
{{Anchor|PathType}} PathType:
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| -1
| Returned internally by Process9, when errors occur it seems(in particular when no nul-terminator was found in the input path). The data ptr is set to NULL.
|-
| 0x0
| INVALID - Specifies an invalid path
|-
| 0x1
| EMPTY - Specifies an empty path
|-
| 0x2
| BINARY - Non-text based path. Meaning is per-archive
|-
| 0x3
| ASCII - Text-based path with 7-bit ASCII characters padded to 8-bits each (signed char)
|-
| 0x4
| UTF16 - Text-based path with UTF-16 characters
|}

In IPC requests, sizes of ASCII and UTF16 paths must include space for the null-terminator.

== Binary LowPath ==
The format of the data that a binary LowPath points to is custom per archive.

=== SystemSaveData / Extdata / Shared Extdata Archive Path Data Format ===

==== DataAccessPath ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8 [[Mediatypes|Mediatype]]
|-
| 0x1 || 0x1 || only for NAND data (System Savedata / Shared Extdata), otherwise left 0:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || Accesses from/to <code>nand:/data/<ID0 of current system></code>
|-
| 1 || Accesses from/to <code>nand:/fixdata</code>
|-
| 2 || Accesses from/to <code>nand:/data/<ID0 from [[Filesystem_services#DeviceMoveContext|Device Move Context]]></code>
|}
|-
| 0x2 || 0x2 || padding
|}

==== SystemSaveData ====

===== FS =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 1
| save ID low (save ID high is 0)
|}

====== File Path ======
The file path is a cleartext ASCII or UTF16 file path (<code><file path></code>).

The file path would access the file at <code><base path>/sysdata/<save ID low>/<save ID high>/<file path></code>.
Note that <code>/<file path></code> refers to the virtual file system inside the </code><save ID high></code> file.

===== FSPXI / FS System Savedata Transfer / FSPXI System Savedata Transfer =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|}

====== File Path ======
{| class="wikitable" border="1"
|-
! Index word !! Description
|-
| 0 || save ID low
|-
| 1 || save ID high
|}

The file path would access the file at <code><base path>/sysdata/<save ID low>/<save ID high></code>.

==== Extdata / Shared Extdata ====

===== FS / FS Extdata Transfer / FSPXI Extdata Transfer =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 1
| ext save ID low
|-
| 2
| ext save ID high
|}

This refers to the extdata filesystem structure's base directory at <code><base path>/extdata/<ext save ID low>/<ext save ID high></code>.

====== File Path ======
The file path is a cleartext ASCII or UTF16 file path (<code><file path></code>).

For FS Extdata, this would acccess <code><base path>/extdata/<save ID low>/<save ID high>/<directory ID>/<file ID>/<file path></code>, and <code>/<file path></code> refers to the virtual file system inside the </code><file ID></code> file.

For FS / FSPXI Extdata Transfer, this accesses <code><base path>/extdata/<save ID low>/<save ID high>/<file path></code>.

=== UserSaveDataForCheck Archive Path Data Format ===
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Mediatypes|Mediatype]] (must be non-zero)
|-
| 1
| Lower word saveid
|-
| 2
| Upper word saveid
|}

The file/directory lowpath for this FS archive is a text path in the [[Savegames|savegame]] filesystem.

=== 0x567890B4 Archive Path Data Format ===
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Mediatypes|Mediatype]]
|-
| 1
| <code><nowiki>Lower_word_saveid >> 8</nowiki></code> ?
|-
| 2
| Unknown. Game calculate this using formula <code><nowiki>0xFFFFFF00 | unknown_b</nowiki></code>
|}

=== Title Access Archive Path Data Format ===
==== Title Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || High-level NCCH content access
|-
| 1 || Save data access (high-level, decrypted)
|-
| 2 || Raw content (low-level NCCH/SRL) access
|-
| 3 || Banner save data access (for DSiWare titles)
|-
| 4 || FS only: Save data transfer (internally uses generated data from [[FS:BeginSaveDataMove]] as the IV for "Save data access (low-level, encrypted)")
|-
| 5 || Save data access (low-level, encrypted)
|}

==== NCCH Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || RomFS
|-
| 1 || <code>exefs:/.code</code>
|-
| 2 || System Menu Data (<code>exefs:/icon</code>, <code>exefs:/banner</code>, <code>exefs:/logo</code>)
|-
| 3 || NCCH Header(s)
|-
| 4 || "is seeded" check
|-
| 5 || Seed verify/validate
|}

==== NCCH Header Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || [[NCCH/Extended_Header|Extheader]] (0x0-0x400)
|-
| 1 || [[NCCH/Extended_Header|Extheader]] AccessDesc (0x400-0x800)
|-
| 2 || Raw [[NCCH#NCCH_Header|NCCH Header]]
|}

==== Archive Path ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || Program ID (Title ID)
|-
| 0xB || 0x1 || [[Mediatypes|Media Type]]
|-
| 0xC || 0x4 || padding
|}

==== File Path ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || [[Filesystem_services#Title_Access_Type|Title Access Type]]
|-
| 0x4 || 0x10 || Dynamic data depending on [[Filesystem_services#Title_Access_Type|Title Access Type]]:

{| class="wikitable" border="1"
|-
! High Level NCCH Access !! Save Data Access (high level) !! Raw Content !! FS only: Save Data Transfer
|-
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Content index from TMD for NAND/SD titles
NCSD partition index for gamecards
|-
| 0x4 || 0x4 || [[Filesystem_services#NCCH_Access_Type|NCCH Access Type]]
|-
| 0x8 || 0x8 || Dynamic data depending on [[Filesystem_services#NCCH_Access_Type|NCCH Access Type]]:
For ExeFS, (System Menu Data / <code>exefs:/.code</code>),

{| class="wikitable" border="1"
| 8-byte ExeFS file name
|}

For Header Access,

{| class="wikitable" border="1"
| [[Filesystem_services#NCCH_Header_Access_Type|u64, NCCH Header Access Type]]
|}

For RomFS,

{| class="wikitable" border="1"
| [[NCCH#Content_Types|u64, Allowed content types flag]]
(<code>(1 << allowed_type_a) |

(1 << allowed_type_b)...</code>)
|}

|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x10 || 16-byte IV for save data crypto
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Content index from TMD for NAND/SD titles
NCSD partition index for gamecards
|-
| 0x4 || 0xC || padding
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Save data transfer key from [[FS:BeginSaveDataMove]]
|-
| 0x4 || 0xC || padding
|}
|}
|-
| 0x14 || 0x10 || 16-byte seed for titles that require one, or for validating a seed against the check value in the [[NCCH#NCCH_Header|NCCH Header]]'s check value.
If the title does not use a seed, this should not be included and size 0x14 should be used instead of 0x24.
|}

For encrypted save data access and banner save data access, the entire 0x10 portion of the dynamic data is left blank.

The "is seeded check" NCCH access type opens a virtual 1-byte file that reads either 0 or 1; this value is generated on-the-fly and will be 1 if ncchflags[7] has bit5 set (content uses seed), and 0 otherwise.

For NCCH sections that require a seed (e.g. <code>.code</code>, RomFS, etc.), the additional seed portion of the low path must be populated with the correct seed.

The "Seed Verify/Validate" NCCH access type also requires the seed portion of the lowpath. The target NCCH content is opened (with the opened file interface being stubbed, meaning no real reads/writes can be performed on it), and the given seed is used to calculate the seed check hash, and part of it is compared to the check value in the NCCH header. If it matches, opening the "file" succeeds, otherwise 0xD900458C is returned. If attempt is made to use the seed validation type on a content that does not use a seed, error 0xC92044E6 is returned.

==== FS Limitations ====

For FS, this archive functions the same, except for the following limitations:

- Only the title access types "High Level NCCH Access" and "High Level Save Data Access", and "Save Data Transfer" are allowed.

- For high level NCCH access, the types "RomFS", "System Menu Data", "Seeded check", and "Seed Check/Verify" are allowed.

- For "Seed Check/Verify", rather than providing the title seed in the file path (as is the case for FSPXI), the seed is retrieved from the seed database (meaning the file lowpath size is always 0x14 for FS).

=== Program Access / SelfNCCH access ===

Provides access to a "merged" archive of a base title and, optionally, a separate update (patch) title.

If no patch title exists, the base title is considered to be the patch title, i.e. turning all "patch" accesses into accesses to the base title.

==== Program Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description !! Accesses
|-
| 0 || RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default) || Base title
|-
| 1 || <code>exefs:/.code</code> || Patch title
|-
| 2 || System Menu Data (<code>exefs:/icon</code>, <code>exefs:/banner</code>, <code>exefs:/logo</code>) || Base title
|-
| 3 || Save Data (high level, decrypted) || -
|-
| 4 || RomFS (all [[NCCH#Content_Type|content types]]) || Base title
|-
| 5 || RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default) || Patch title
|}

==== Archive Path ====
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || u64, Program Handle from [[PXIPM:RegisterProgram]]
|}

==== File Path ====
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || [[Filesystem_services#Program_Access_Type|Program Access Type]]
|-
| 0x4 || 0x8 || Dynamic data depending on [[Filesystem_services#Program_Access_Type|Program Access Type]]:
{| class="wikitable" border="1"
|-
! ExeFS files (System Menu Data, etc.) !! RomFS of base title (all [[NCCH#Content_Type|content types]])
|-
|
{| class="wikitable" border="1"
| 8-character ExeFS filename
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, content index of target content
|-
| 0x4 || 0x4 || padding
|}
|}
|}

==== FS Limitations ====

- FSPXI allows all access types.

- When used through fs:LDR by loader, FS only provides access to <code>exefs:/.code</code>.

- For SelfNCCH access, the only allowed access types are "RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default)" of the Base or Patch title, and "System Menu Data". Attempting to access "Save Data" results in error 0xE0E046BE, "RomFS (all [[NCCH#Content_Type|content types]])" in 0xF9604784, and "<code>exefs:/.code</code>" in 0xD9004676.

=== [[RomFS]] ===

Archives 0x3 and 0x2345678E both allow for accessing the [[RomFS#Level_3_Format|level-3 IVFC images]] for RomFS access. The main CXI RomFS is accessible via an all-zero 0xc-byte binary file-lowpath. The update RomFS can be accessed with the first u32 in the binary file-lowpath being set to 0x5. The user must handle parsing the filesystem used in the exposed image itself.

With FSPXI the returned data for RomFS is the entire RomFS section from the NCCH, starting at the IVFC header.

The 0x3 archive is an interface for the 0x2345678E archive with the current process programID+mediatype. The file lowpath is 3-words. These words are written to 0x2345678E-archive file_lowpath+0, with the rest of that lowpath set to all-zero(lowpath is different from archive 0x2345678A). File lowpath:
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| See above. The only values which FS-module doesn't allow to be used here are:
* 0x1: Error 0xE0E046BE.
* 0x3: Error 0xE0E046BE.
* 0x4: FS-module executes svcBreak when using this.
|-
| 1-2
| See above. Not validated by FS-module.
|}

=Anti Savegame Restore=
Anti Savegame Restore, internally referred to as ''Save Data Rollback Prevention'', is a feature originally implemented in the FS module with [[4.0.0-7]], which prevents the user from restoring previous versions of a savegame image. This feature is not used (in practice) for gamecard games. When an old version of the save is detected, the application will display an error regarding old savegame version, then delete and recreate the save data (similar to when it is corrupted).

==Implementation==
When creating the savedata, the application generates a secure value (a 64 bit unsigned integer), then stores it in either the [[DISA_and_DIFF#DISA_header|DISA save image header]] or the [[Filesystem_services#Anti_Savegame_Restore_Save_Data|Anti Savegame Restore Save Data]]. The application then uses the anti-savegame-restore commands ([[FS:SetSaveDataSecureValue]], [[FS:GetSaveDataSecureValue]], [[FS:SetOtherSaveDataSecureValue]], [[FS:GetOtherSaveDataSecureValue]], [[FS:SetThisSaveDataSecureValue]], [[FS:GetThisSaveDataSecureValue]], [[FS:SetSaveArchiveSecureValue]] and [[FS:GetSaveArchiveSecureValue]]) to verify the value known to the game for comparison with the value returned by FS, and to update the value in the corresponding storage location.

Each time the application writes to the savegame, the value should be updated by both the application and through FS. Usually, applications update this value by incrementing it. However, generating a new random-number or other methods of updating it can be used as well.

==Anti Savegame Restore Save Data==
The save data used for this feature is stored in [[System_SaveData|System Save Data]] ID 0x00010011 and contains only one file, named <code>DB</code>:

===Main Structure===
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1000 || Header
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8, version (usually 0)
|-
| 0x1 || 0x3 || padding
|-
| 0x4 || 0x4 || u32, number of secure value entries
|-
| 0x8 || 0xFF8 || completely unused, padding
|}
|-
| 0x1000 || 0x1C000 (8 * 14336) || [[Filesystem_services#SecureValueKey|Secure value keys]]
|-
| 0x1D000 || 0x1C000 (8 * 14336) || u64s, Secure values
|}

===SecureValueKey===
Depending on which command is used, secure value keys can be interpreted as:
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || u64, Title ID
|}
or:
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, [[Filesystem_services#SecureValueSlot|Secure Value Slot]]
|-
| 0x4 || 0x4 || u32, Unique ID
|}

==Applications using this feature==
* Animal Crossing: New Leaf
* Pokemon X & Y
* Pokemon Omega Ruby & Alpha Sapphire
* Pokemon Omega Ruby & Alpha Sapphire Demo
* Pokemon Shuffle
* Super Smash Bros
* Pokemon Red,Blue and Yellow (GB(C) VC)
* Rusty's Real Deal Baseball
* Megami Meguri

=SEEDDB and TITLETAG=
With [[9.6.0-24|9.6.0-X]] new [[System_SaveData]] with save ID 0x0001000F was added. This save data contains both the NCCH seed database (SEEDDB) and the title tag database (TITLETAG).

These databases are managed by the commands [[FS:AddSeed]], [[FS:GetSeed]], [[FS:DeleteSeed]], [[FS:GetNumSeeds]] and [[FS:ListSeeds]] for SEEDDB, and [[FS:AddTitleTag]], [[FS:GetTitleTag]], [[FS:DeleteTitleTag]], [[FS:GetNumTitleTags]], and [[FS:ListTitleTags]] for TITLETAG respectively.

Both the [[Home_Menu|HOME Menu]] and the [[NIM_Services|NIM]] module have access to these commands.

==SEEDDB==

Stored in the system savedata archive 0x0001000F as a file named <code>SEEDDB</code>, it contains the title-unique seed-data used for the new [[NCCH]] keyY generation added with FIRM [[9.6.0-24|9.6.0-X]].

The file follows a simple key-value format allowing the storage of seed data for up to 2000 unique title IDs.

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1000 || Header
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8, version (usually 0)
|-
| 0x1 || 0x3 || padding
|-
| 0x4 || 0x4 || u32, number of seed entries
|-
| 0x8 || 0xFF8 || completely unused, padding
|}
|-
| 0x1000 || 0x3E80 (8 * 2000) || u64s, Title IDs
|-
| 0x4E80 || 0x7D00 (16 * 2000) || Seed data, 16 bytes per seed
|}

==TITLETAG Database==

Stored in the system savedata archive 0x0001000F as a file named <code>TITLETAG</code>, it contains information used by the [[Home_Menu|HOME Menu]] to handle cases when a to-be-released title has been purchased already, that is, to properly install the seed required for [[NCCH]] keyY generation added with FIRM [[9.6.0-24|9.6.0-X]].

When a to-be-released title is purchased, the [[NIM_Services|NIM]] module installs a [[Filesystem_services#TitleTag|title tag]] with enough information about the title for the [[Home_Menu|HOME Menu]] to be able to initiate a seed import once the title has been released (and thus, the title's NCCH content lock seed). Until the title's seed is released, and while the title tag remains in the database, the HOME Menu will prevent the user from launching the software as it would not run without the seed. Once released, information from the title tag is used to download the seed, and, if successful, the title tag is removed from the database, making the software playable.

The file follows a simple key-value format allowing the storage of title tag data for up to 2000 unique title IDs.

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1000 || Header
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8, version (usually 0)
|-
| 0x1 || 0x3 || padding
|-
| 0x4 || 0x4 || u32, number of entries
|-
| 0x8 || 0xFF8 || completely unused, padding
|}
|-
| 0x1000 || 0x3E80 (8 * 2000) || u64s, Title IDs
|-
| 0x4E80 || 0x3E800 (0x80 * 2000) || [[Filesystem_services#TitleTag|Title Tag]] data, 0x80 bytes per entry
|}

= Common Types =
== MediaType ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0
| NAND
|-
| 1
| SD
|-
| 2
| Game Card
|}

== SystemMediaType ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0
| CTR NAND
|-
| 1
| TWL NAND
|-
| 2
| SD
|-
| 3
| TWL Photo
|}

== OpenFlags ==
{| class="wikitable" border="1"
|-
! Bit
! Description
|-
| 0
| Read
|-
| 1
| Write
|-
| 2
| Create
|}

== Attributes ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| Is Directory
|-
| 0x1
| 0x1
| Is Hidden
|-
| 0x2
| 0x1
| Is Archive
|-
| 0x3
| 0x1
| Is Read-Only
|}

== WriteOption ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| Flush
|-
| 0x1
| 0x1
| Update Time Stamp
|-
| 0x2
| 0x1
| Reserved
|-
| 0x3
| 0x1
| Reserved
|}

== DirectoryEntry ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x20C
| UTF-16 Entry Name
|-
| 0x20C
| 0xA
| 8.3 short filename name
|-
| 0x216
| 0x4
| 8.3 short filename extension
|-
| 0x21A
| 0x1
| Always 1
|-
| 0x21B
| 0x1
| Reserved
|-
| 0x21C
| 0x4
| [[Filesystem_services#Attributes|Attributes]]
|-
| 0x220
| 0x8
| Entry Size
|}

== ArchiveResource ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| Sector byte-size
|-
| 0x4
| 0x4
| Cluster byte-size
|-
| 0x8
| 0x4
| Partition capacity in clusters
|-
| 0xC
| 0x4
| Available free space in clusters
|}

== ProgramInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x8
| Program ID
|-
| 0x8
| 0x1
| [[Filesystem_services#MediaType|Media Type]]
|-
| 0x9
| 0x7
| Padding
|}

== ProductInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| Product Code
|-
| 0x10
| 0x2
| Company Code
|-
| 0x12
| 0x2
| Remaster Version
|}

== IntegrityVerificationSeed ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| AES-CBC MAC over a SHA256 hash, which hashes the first 0x110-bytes of the cleartext SEED.
|-
| 0x10
| 0x120
| The [[nand/private/movable.sed]], encrypted with AES-CBC using the above MAC for the counter.
|}

== ExtSaveDataInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 0x4
| 0x8
| Save ID
|-
| 0xC
| 0x4
| Reserved
|}

== SystemSaveDataInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 0x4
| 0x4
| Save ID
|}

== SecureValueSlot ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x1000
| SD Application
|}

== SecureValueEntry ==
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, [[Filesystem_services#SecureValueSlot|Secure Value Slot]]
|-
| 0x4 || 0x1 || When used as an input entry:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || This entry should be removed.
|-
| 1 || This entry should be updated with the given value.
|}
When returned from a command:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || No entry with the given slot and title ID was found, or: this entry is unused.
|-
| 1 || The entry with the given slot and title ID was found, or: this entry is used.
|}
|-
| 0x5 || 0x3 || padding
|-
| 0x8 || 0x8 || u64, Secure Value
|}

== TitleTag ==
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Magic, <code>PREP</code> (PREPurchase install)
|-
| 0x4 || 0x4 || s32, Release date year
|-
| 0x8 || 0x1 || u8, Release date month
|-
| 0x9 || 0x1 || u8, Release date day
|-
| 0xA || 0x2 || u16, Country code
|-
| 0xC || 0x4 || u32, Seed status (0: not downloaded yet, 1: last download attempt failed, 2: seed installed successfully)
|-
| 0x10 || 0x4 || Result code from last seed installation attempt
|-
| 0x14 || 0x4 || Support error code from last seed installation attempt
|-
| 0x18 || 0x68 || reserved padding (unused)
|}

== CardSpiBaudRate ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x0
| 512KHz
|-
| 0x1
| 1MHz
|-
| 0x2
| 2MHz
|-
| 0x3
| 4MHz
|-
| 0x4
| 8MHz
|-
| 0x5
| 16MHz
|}

== CardSpiBusMode ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x0
| 1-bit
|-
| 0x1
| 4-bit
|}

== SpecialContentType ==
{| class="wikitable" border="1"
|-
! Value
! Description
! Found in
|-
| 0x1
| CTR (Old3DS) Update Partition
| Gamecards
|-
| 0x2
| Manual
| Gamecards, Digital titles
|-
| 0x3
| DLP Child
| Gamecards, Digital titles
|-
| 0x4
| KTR (New3DS) Update Partition
| Gamecards
|-
|}

== DeviceMoveContext ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| IVs (ID0 of source console)
|-
| 0x10
| 0x10
| Encrypt Parameter (used to calculate the IV for encryption)
|}

=Errors=
See [[Filesystem_services_PXI]].

[[Category:Services]]

Filesystem services

2025-07-01T20:14:06Z

TimmSkiller: /* Anti Savegame Restore Save Data */

= Services =
{{Anchor|FS}}{{Anchor|FSUSER}}{{Anchor|fs:USER}}
== Filesystem service "fs:USER" ==
You can at most have 32 FS archive handles.

{| class="wikitable" border="1"
|-
! Command Header
! Available since system version
! Description
! scope="col" width="400" | Required [[NCCH/Extended_Header|exheader]] access info bitmask
|-
| 0x000100C6
|?
| [[FS:Dummy1|Dummy1]]
| None
|-
| 0x040100C4
|?
| [[FS:Control|Control]]
| None
|-
| 0x08010002
|?
| [[FS:Initialize|Initialize]]
| None
|-
| 0x080201C2
|?
| [[FS:OpenFile|OpenFile]]
| None
|-
| 0x08030204
|?
| [[FS:OpenFileDirectly|OpenFileDirectly]]
| None
|-
| 0x08040142
|?
| [[FS:DeleteFile|DeleteFile]]
| None
|-
| 0x08050244
|?
| [[FS:RenameFile|RenameFile]]
| None
|-
| 0x08060142
|?
| [[FS:DeleteDirectory|DeleteDirectory]]
| None
|-
| 0x08070142
|?
| [[FS:DeleteDirectoryRecursively|DeleteDirectoryRecursively]]
| None
|-
| 0x08080202
|?
| [[FS:CreateFile|CreateFile]]
| None
|-
| 0x08090182
|?
| [[FS:CreateDirectory|CreateDirectory]]
| None
|-
| 0x080A0244
|?
| [[FS:RenameDirectory|RenameDirectory]]
| None
|-
| 0x080B0102
|?
| [[FS:OpenDirectory|OpenDirectory]]
| None
|-
| 0x080C00C2
|?
| [[FS:OpenArchive|OpenArchive]]
| Each archive ID code has separate access info bitmasks, if it has any
|-
| 0x080D0144
|?
| [[FS:ControlArchive|ControlArchive]]
| None
|-
| 0x080E0080
|?
| [[FS:CloseArchive|CloseArchive]]
| None
|-
| 0x080F0180
|?
| [[FS:Obsoleted_2_0_FormatThisUserSaveData|Obsoleted_2_0_FormatThisUserSaveData]]
| None
|-
| 0x08100200
|?
| [[FS:Obsoleted_3_0_CreateSystemSaveData|Obsoleted_3_0_CreateSystemSaveData]]
| 0x4, for when the input saveID doesn't match the exheader saveID
|-
| 0x08110040
|?
| [[FS:Obsoleted_3_0_DeleteSystemSaveData|Obsoleted_3_0_DeleteSystemSaveData]]
| 0x1004, for when the input saveID doesn't match the exheader saveID
|-
| 0x08120080
|?
| [[FS:GetFreeBytes|GetFreeBytes]]
| None
|-
| 0x08130000
|?
| [[FS:GetCardType|GetCardType]]
| 0x1017
|-
| 0x08140000
|?
| [[FS:GetSdmcArchiveResource|GetSdmcArchiveResource]]
| None
|-
| 0x08150000
|?
| [[FS:GetNandArchiveResource|GetNandArchiveResource]]
| 0x1007
|-
| 0x08160000
|?
| [[FS:GetSdmcFatfsError|GetSdmcFatfsError]]
| 0x2
|-
| 0x08170000
|?
| [[FS:IsSdmcDetected|IsSdmcDetected]]
| None
|-
| 0x08180000
|?
| [[FS:IsSdmcWritable|IsSdmcWritable]]
| None
|-
| 0x08190042
|?
| [[FS:GetSdmcCid|GetSdmcCid]]
| 0x2
|-
| 0x081A0042
|?
| [[FS:GetNandCid|GetNandCid]]
| 0x2
|-
| 0x081B0000
|?
| [[FS:GetSdmcSpeedInfo|GetSdmcSpeedInfo]]
| 0x2
|-
| 0x081C0000
|?
| [[FS:GetNandSpeedInfo|GetNandSpeedInfo]]
| 0x2
|-
| 0x081D0042
|?
| [[FS:GetSdmcLog|GetSdmcLog]]
| 0x2
|-
| 0x081E0042
|?
| [[FS:GetNandLog|GetNandLog]]
| 0x2
|-
| 0x081F0000
|?
| [[FS:ClearSdmcLog|ClearSdmcLog]]
| 0x2
|-
| 0x08200000
|?
| [[FS:ClearNandLog|ClearNandLog]]
| 0x2
|-
| 0x08210000
|?
| [[FS:CardSlotIsInserted|CardSlotIsInserted]]
| 0x1017
|-
| 0x08220000
|?
| [[FS:CardSlotPowerOn|CardSlotPowerOn]]
| 0x2
|-
| 0x08230000
|?
| [[FS:CardSlotPowerOff|CardSlotPowerOff]]
| 0x2
|-
| 0x08240000
|?
| [[FS:CardSlotGetCardIFPowerStatus|CardSlotGetCardIFPowerStatus]]
| 0x2
|-
| 0x08250040
|?
| [[FS:CardNorDirectCommand|CardNorDirectCommand]]
| 0x2
|-
| 0x08260080
|?
| [[FS:CardNorDirectCommandWithAddress|CardNorDirectCommandWithAddress]]
| 0x2
|-
| 0x08270082
|?
| [[FS:CardNorDirectRead|CardNorDirectRead]]
| 0x2
|-
| 0x082800C2
|?
| [[FS:CardNorDirectReadWithAddress|CardNorDirectReadWithAddress]]
| 0x2
|-
| 0x08290082
|?
| [[FS:CardNorDirectWrite|CardNorDirectWrite]]
| 0x2
|-
| 0x082A00C2
|?
| [[FS:CardNorDirectWriteWithAddress|CardNorDirectWriteWithAddress]]
| 0x2
|-
| 0x082B00C2
|?
| [[FS:CardNorDirectRead_4xIO|CardNorDirectRead_4xIO]]
| 0x2
|-
| 0x082C0082
|?
| [[FS:CardNorDirectCpuWriteWithoutVerify|CardNorDirectCpuWriteWithoutVerify]]
| 0x2
|-
| 0x082D0040
|?
| [[FS:CardNorDirectSectorEraseWithoutVerify|CardNorDirectSectorEraseWithoutVerify]]
| 0x2
|-
| 0x082E0040
|?
| [[FS:GetProductInfo|GetProductInfo]]
| 0x1005
|-
| 0x082F0040
|?
| [[FS:GetProgramLaunchInfo|GetProgramLaunchInfo]]
| 0x1005
|-
| 0x08300182
|?
| [[FS:Obsoleted_3_0_CreateExtSaveData|Obsoleted_3_0_CreateExtSaveData]]
| 0xC, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08310180
|?
| [[FS:Obsoleted_3_0_CreateSharedExtSaveData|Obsoleted_3_0_CreateSharedExtSaveData]]
| 0x1005
|-
| 0x08320102
|?
| [[FS:Obsoleted_3_0_ReadExtSaveDataIcon|Obsoleted_3_0_ReadExtSaveDataIcon]]
| 0x100D, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08330082
|?
| [[FS:Obsoleted_3_0_EnumerateExtSaveData|Obsoleted_3_0_EnumerateExtSaveData]]
| 0x1005
|-
| 0x08340082
|?
| [[FS:Obsoleted_3_0_EnumerateSharedExtSaveData|Obsoleted_3_0_EnumerateSharedExtSaveData]]
| 0x1005
|-
| 0x08350080
|?
| [[FS:Obsoleted_3_0_DeleteExtSaveData|Obsoleted_3_0_DeleteExtSaveData]]
| 0x100D, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08360080
|?
| [[FS:Obsoleted_3_0_DeleteSharedExtSaveData|Obsoleted_3_0_DeleteSharedExtSaveData]]
| 0x1005
|-
| 0x08370040
|?
| [[FS:SetCardSpiBaudRate|SetCardSpiBaudRate]]
| 0x2
|-
| 0x08380040
|?
| [[FS:SetCardSpiBusMode|SetCardSpiBusMode]]
| 0x2
|-
| 0x08390000
|?
| [[FS:SendInitializeInfoTo9|SendInitializeInfoTo9]]
| None
|-
| 0x083A0100
|?
| [[FS:GetSpecialContentIndex|GetSpecialContentIndex]]
| 0x1005
|-
| 0x083B00C2
|?
| [[FS:GetLegacyRomHeader|GetLegacyRomHeader]]
| 0x1015
|-
| 0x083C00C2
|?
| [[FS:GetLegacyBannerData|GetLegacyBannerData]]
| 0x1015
|-
| 0x083D0100
|?
| [[FS:CheckAuthorityToAccessExtSaveData|CheckAuthorityToAccessExtSaveData]]
| 0x44
|-
| 0x083E00C2
|?
| [[FS:QueryTotalQuotaSize|QueryTotalQuotaSize]]
| None
|-
| 0x083F00C0
|?
| [[FS:Obsoleted_3_0_GetExtDataBlockSize|Obsoleted_3_0_GetExtDataBlockSize]]
| None
|-
| 0x08400040
|?
| [[FS:AbnegateAccessRight|AbnegateAccessRight]]
|?
|-
| 0x08410000
|?
| [[FS:DeleteSdmcRoot|DeleteSdmcRoot]]
| 0x1005
|-
| 0x08420040
|?
| [[FS:DeleteAllExtSaveDataOnNand|DeleteAllExtSaveDataOnNand]]
| 0x1005
|-
| 0x08430000
|?
| [[FS:InitializeCtrFileSystem|InitializeCtrFileSystem]]
| None
|-
| 0x08440000
|?
| [[FS:CreateSeed|CreateSeed]]
| 0x2
|-
| 0x084500C2
|?
| [[FS:GetFormatInfo|GetFormatInfo]]
|?
|-
| 0x08460102
|?
| [[FS:GetLegacyRomHeader2|GetLegacyRomHeader2]]
| 0x1015
|-
| 0x08470180
|?
| [[FS:Obsoleted_2_0_FormatCtrCardUserSaveData|Obsoleted_2_0_FormatCtrCardUserSaveData]]
| 0x6
|-
| 0x08480042
|?
| [[FS:GetSdmcCtrRootPath|GetSdmcCtrRootPath]]
| 0x100D
|-
| 0x08490040
|?
| [[FS:GetArchiveResource|GetArchiveResource]]
|?
|-
| 0x084A0002
|?
| [[FS:ExportIntegrityVerificationSeed|ExportIntegrityVerificationSeed]]
| 0x4000
|-
| 0x084B0002
|?
| [[FS:ImportIntegrityVerificationSeed|ImportIntegrityVerificationSeed]]
| 0x4000
|-
| 0x084C0242
|?
| [[FS:FormatSaveData|FormatSaveData]]
| 0x6, in some cases this write isn't needed however
|-
| 0x084D0102
|?
| [[FS:GetLegacySubBannerData|GetLegacySubBannerData]]
| 0x1015
|-
| 0x084E0342
|?
| [[FS:UpdateSha256Context|UpdateSha256Context]]
| 0x5
|-
| 0x084F0102
|?
| [[FS:ReadSpecialFile|ReadSpecialFile]]
| None
|-
| 0x08500040
|?
| [[FS:GetSpecialFileSize|GetSpecialFileSize]]
| None
|-
| 0x08510242
| [[3.0.0-5]]
| [[FS:CreateExtSaveData|CreateExtSaveData]]
| Shared extdata: 0x101005. Regular extdata in certain cases: 0xC
|-
| 0x08520100
| [[3.0.0-5]]
| [[FS:DeleteExtSaveData|DeleteExtSaveData]]
| Shared extdata: 0x101005. Regular extdata in certain cases: 0x10100D
|-
| 0x08530142
| [[3.0.0-5]]
| [[FS:ReadExtSaveDataIcon|ReadExtSaveDataIcon]]
| 0x10100D (this doesn't apply in certain cases, however)
|-
| 0x085400C0
| [[3.0.0-5]]
| [[FS:GetExtDataBlockSize|GetExtDataBlockSize]]
| 0x10100D (this doesn't apply in certain cases, however)
|-
| 0x08550102
| [[3.0.0-5]]
| [[FS:EnumerateExtSaveData|EnumerateExtSaveData]]
| 0x101005
|-
| 0x08560240
| [[3.0.0-5]]
| [[FS:CreateSystemSaveData|CreateSystemSaveData]]
| 0x4 (this doesn't apply in certain cases, however)
|-
| 0x08570080
| [[3.0.0-5]]
| [[FS:DeleteSystemSaveData|DeleteSystemSaveData]]
| 0x1004 (this doesn't apply in certain cases, however)
|-
| 0x08580000
| [[3.0.0-5]]
| [[FS:StartDeviceMoveAsSource|StartDeviceMoveAsSource]]
| 0x2004
|-
| 0x08590200
| [[3.0.0-5]]
| [[FS:StartDeviceMoveAsDestination|StartDeviceMoveAsDestination]]
| 0x2004
|-
| 0x085A00C0
| [[3.0.0-5]]
| [[FS:SetArchivePriority|SetArchivePriority]]
| None
|-
| 0x085B0080
| [[3.0.0-5]]
| [[FS:GetArchivePriority|GetArchivePriority]]
| None
|-
| 0x085C00C0
| [[3.0.0-5]]
| [[FS:SetCtrCardLatencyParameter|SetCtrCardLatencyParameter]]
| 0xE
|-
| 0x085D01C0
| [[3.0.0-5]]
| [[FS:SetFsCompatibilityInfo|SetFsCompatibilityInfo]]
| 0x100001
|-
| 0x085E0040
| [[3.0.0-5]]
| [[FS:ResetCardCompatibilityParameter|ResetCardCompatibilityParameter]]
| 0xE
|-
| 0x085F0040
| [[3.0.0-5]]
| [[FS:SwitchCleanupInvalidSaveData|SwitchCleanupInvalidSaveData]]
| 0x12004
|-
| 0x08600042
| [[3.0.0-5]]
| [[FS:EnumerateSystemSaveData|EnumerateSystemSaveData]]
| 0x2004
|-
| 0x08610042
| [[3.0.0-5]]
| [[FS:InitializeWithSdkVersion|InitializeWithSdkVersion]]
| None
|-
| 0x08620040
| [[3.0.0-5]]
| [[FS:SetPriority|SetPriority]]
| None
|-
| 0x08630000
| [[3.0.0-5]]
| [[FS:GetPriority|GetPriority]]
| None
|-
| 0x08640000
| [[3.0.0-5]]
| [[FS:Obsoleted_4_0_GetNandInfo|Obsoleted_4_0_GetNandInfo]]
| Stubbed, this returns an error
|-
| 0x08650140
| [[4.0.0-7]]
| [[FS:SetSaveDataSecureValue|SetSaveDataSecureValue]]
| 0x121004 (in certain cases this doesn't apply, however)
|-
| 0x086600C0
| [[4.0.0-7]]
| [[FS:GetSaveDataSecureValue|GetSaveDataSecureValue]]
| 0x121004 (in certain cases this doesn't apply, however)
|-
| 0x086700C4
| [[4.0.0-7]]
| [[FS:ControlSecureSave|ControlSecureSave]]
| 0x121004
|-
| 0x08680000
| [[4.0.0-7]]
| [[FS:GetMediaType|GetMediaType]]
| None
|-
| 0x08690000
| [[4.0.0-7]]
| [[FS:Obsoleted_4_0_GetNandEraseCount|Obsoleted_4_0_GetNandEraseCount]]
| Stubbed, this returns an error.
|-
| 0x086A0082
| [[4.0.0-7]]
| [[FS:ReadNandReport|ReadNandReport]]
| None
|-
| 0x086B00C2
|?
| [[FS:SetOtherSaveDataSecureValue|SetOtherSaveDataSecureValue]]
| 0x121004
|-
| 0x086C00C2
|?
| [[FS:GetOtherSaveDataSecureValue|GetOtherSaveDataSecureValue]]
| 0x121004
|-
| 0x086D0080
|?
| [[FS:BeginSaveDataMove|BeginSaveDataMove]]
| 0x20004
|-
| 0x086E00C0
|?
| [[FS:SetThisSaveDataSecureValue|SetThisSaveDataSecureValue]]
|None
|-
| 0x086F0040
|?
| [[FS:GetThisSaveDataSecureValue|GetThisSaveDataSecureValue]]
| None
|-
| 0x087000C2
|?
| [[FS:CheckArchive|CheckArchive]]
|None
|-
| 0x08710140
| ?
| [[FS:TransferSaveDataCMAC|TransferSaveDataCMAC]]
| 0x20004
|-
| 0x08720200
|?
| [[FS:RegisterTitleContentOverlay|RegisterTitleContentOverlay]]
| 0x80004
|-
| 0x08730100
|?
| [[FS:UnregisterTitleContentOverlay|UnregisterTitleContentOverlay]]
| 0x80004
|-
| 0x08740000
|?
| [[FS:UnregisterAllTitleContentOverlays|UnregisterAllTitleContentOverlays]]
| 0x80004
|-
| 0x08750140
|?
| [[FS:SetSaveArchiveSecureValue|SetSaveArchiveSecureValue]]
|None
|-
| 0x087600C0
|?
| [[FS:GetSaveArchiveSecureValue|GetSaveArchiveSecureValue]]
|None
|-
| 0x08770140
|?
| [[FS:RegisterSpecialTitleContent|RegisterSpecialTitleContent]]
| 0x80004
|-
| 0x08780100
|?
| [[FS:UnregisterSpecialTitleContent|UnregisterSpecialTitleContent]]
| 0x80004
|-
| 0x087900C2
| ?
| Same as [[FS:GetLegacyBannerData|GetLegacyBannerData]], except for the last parameter this internally passes u8 value 0x1 instead of 0x0, for the FSPXI command.
| 0x101015
|-
| 0x087A0180
| [[9.6.0-24|9.6.0-X]]
| [[FS:AddSeed|AddSeed]]
| 0x200000
|-
| 0x087B0080
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetSeed|GetSeed]]
| 0x200000
|-
| 0x087C0080
| [[9.6.0-24|9.6.0-X]]
| [[FS:DeleteSeed|DeleteSeed]]
| 0x200000
|-
| 0x087D0000
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetNumSeeds|GetNumSeeds]]
| 0x200000
|-
| 0x087E0042
| [[9.6.0-24|9.6.0-X]]
| [[FS:ListSeeds|ListSeeds]]
| 0x200000
|-
| 0x087F0100
| [[9.6.0-24|9.6.0-X]]
| [[FS:TitleContentHasSeed|TitleContentHasSeed]]
| 0x200000
|-
| 0x08800880
| [[9.6.0-24|9.6.0-X]]
| [[FS:AddTitleTag|AddTitleTag]]
| 0x200000
|-
| 0x08810080
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetTitleTag|GetTitleTag]]
| 0x200000
|-
| 0x08820080
| [[9.6.0-24|9.6.0-X]]
| [[FS:DeleteTitleTag|DeleteTitleTag]]
| 0x200000
|-
| 0x08830000
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetNumTitleTags|GetNumTitleTags]]
| 0x200000
|-
| 0x08840042
| [[9.6.0-24|9.6.0-X]]
| [[FS:ListTitleTags|ListTitleTags]]
| 0x200000
|-
| 0x088500C0
| [[9.6.0-24|9.6.0-X]]
| [[FS:CheckTitleSeed|CheckTitleSeed]]
| 0x200000
|-
| 0x088600C0
| [[11.1.0-34|11.1.0-X]]
| [[FS:CheckUpdatedDat|CheckUpdatedDat]]
| 0x80000
|}

Note: The question marks from Dummy1 to GetSpecialFileSize on the "available since system version" field are mainly there because I think that most of these are necessary for the main system to function, so theoretically that would mean that since the creation of the 3DS these were available, or since launch if that makes more sense. But because of the peculiar nature of some of the functions, they will remain question marks until they can be confirmed 100%.

When access rights are required for a command, at least one of the bits in the process access info specified in the above table for the command must be set. Error 0xD9004676 is returned when a process attempts to use a command which it doesn't have access rights for the command. The exheader access info field is all zero's for most applications. Note that the permissions listed in the above table is for system-version v2.x, therefore permission bit(s) added with newer FIRM may be missing from this.

Each session for fs:USER has separate permissions, initially these are set to all zero's for new fs:USER sessions. The permissions/etc for fs:USER sessions are initialized via [[FS:Initialize]](loaded from the user process exheader).

{{Anchor|FSLDR}}{{Anchor|fs:LDR}}

== Filesystem service "fs:LDR" ==
This service is identical to fs:USER, except [[FS:OpenArchive]] archive 0x2345678E can only be accessed with fs:LDR.

{{Anchor|FSReg}}{{Anchor|FSREG}}{{Anchor|fs:REG}}
== ProgramRegistry service "fs:REG" ==
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C6
| [[FSReg:Dummy1|Dummy1]]
|-
| 0x040103C0
| [[FSReg:Register|Register]]
|-
| 0x04020040
| [[FSReg:Unregister|Unregister]]
|-
| 0x040300C0
| [[FSReg:GetProgramInfo|GetProgramInfo]]
|-
| 0x04040100
| [[FSReg:LoadProgram|LoadProgram]]
|-
| 0x04050080
| [[FSReg:UnloadProgram|UnloadProgram]]
|-
| 0x04060080
| [[FSReg:CheckHostLoadId|CheckHostLoadId]]
|}

Only two sessions can be opened for this service at a time, hence no other processes can use this due to [[Process_Manager_Services|pm-module]] and [[Loader_Services|loader]] using this.

=File and directory access=
==Files==
File session handles obtained via [[FS:OpenFile]] and [[FS:OpenFileDirectly]] can be used to access files through a service-like interface, despite not being an actual service registered using [[SRV:RegisterService]]. To use this service-like interface, simply call the SendSyncRequest SVC with a file session handle, using the IPC buffer in thread-local storage for parameters and responses, just like you would with a proper service.

{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C6
| [[FSFile:Dummy1|Dummy1]]
|-
| 0x040100C4
| [[FSFile:Control|Control]]
|-
| 0x08010100
| [[FSFile:OpenSubFile|OpenSubFile]]
|-
| 0x080200C2
| [[FSFile:Read|Read]]
|-
| 0x08030102
| [[FSFile:Write|Write]]
|-
| 0x08040000
| [[FSFile:GetSize|GetSize]]
|-
| 0x08050080
| [[FSFile:SetSize|SetSize]]
|-
| 0x08060000
| [[FSFile:GetAttributes|GetAttributes]]
|-
| 0x08070040
| [[FSFile:SetAttributes|SetAttributes]]
|-
| 0x08080000
| [[FSFile:Close|Close]]
|-
| 0x08090000
| [[FSFile:Flush|Flush]]
|-
| 0x080A0040
| [[FSFile:SetPriority|SetPriority]]
|-
| 0x080B0000
| [[FSFile:GetPriority|GetPriority]]
|-
| 0x080C0000
| [[FSFile:OpenLinkFile|OpenLinkFile]]
|-
| 0x0C010100
| [[FSFile:GetAvailable|GetAvailable]]
|}

==Directories==
Directory session handles obtained via [[FS:OpenDirectory]] are usable via a service-like interface, following the exact same procedure described above for file sessions.
{| class="wikitable" border="1"
|-
! Command Header
! Available since system version
! Description
|-
| 0x000100C6
| [[1.0.0-0]]
| [[FSDir:Dummy1|Dummy1]]
|-
| 0x040100C4
| [[1.0.0-0]]
| [[FSDir:Control|Control]]
|-
| 0x08010042
| [[1.0.0-0]]
| [[FSDir:Read|Read]]
|-
| 0x08020000
| [[1.0.0-0]]
| [[FSDir:Close|Close]]
|-
| 0x08030040
| ?
| [[FSDir:SetPriority|SetPriority]]
|-
| 0x08040000
| ?
| [[FSDir:GetPriority|GetPriority]]
|}

= Archives =
{| class="wikitable" border="1"
|-
! ArchiveId
! Description
! Accessible via [[Filesystem_services|FS]]
! Accessible via [[Filesystem_services_PXI|FSPXI]]
! Only accessible by Process9 internally
! Requires binary [[FS:OpenFile|Lowpath]]
! Required exheader FS access info bitmask
|-
| 0x00000003
| SelfNCCH (including [[#RomFS|RomFS]])
| Yes
| No
| No
| No
| None
|-
| 0x00000004
| SaveData (the saveID/mediatype for this is loaded from data originally from the user process' exheader)
| Yes
| No
| No
| No
| None
|-
| 0x00000006
| ExtSaveData
| Yes
| No
| No
| Yes
| 0x100D, when the input extdataID isn't listed in the exheader.
|-
| 0x00000007
| Shared ExtSaveData
| Yes
| No
| No
| Yes
| None
|-
| 0x00000008
| SystemSaveData
| Yes
| No
| No
| Yes
| 0x4, when the input saveID doesn't match the exheader system-saveID.
|-
| 0x00000009
| SDMC
| Yes
| Yes
| No
| No
| 0x8E
|-
| 0x0000000A
| SDMC Write-Only
| Yes
| No
| No
| No
| 0x808E
|-
| 0x12345678
| ExtSaveData for BOSS
| Yes
| No
| No
| Yes
| 0x44
|-
| 0x12345679
| CARD SPI FS
| Yes
| Yes
| No
| No
| 0x16
|-
| 0x1234567B
| ExtSaveData, and ExtSaveData for BOSS
| No
| Yes
| No
| Yes
|
|-
| 0x1234567C
| SystemSaveData
| No
| Yes
| No
| Yes
|
|-
| 0x1234567D
| NAND RW
| Yes
| Yes
| No
| No
| 0x800
|-
| 0x1234567E
| NAND RO
| Yes
| Yes
| No
| No
| 0x200
|-
| 0x1234567F
| NAND RO Write FS
| No
| Yes
| No
| No
| ?
|-
| 0x12345680
| Extdata transfer. Used for transferring [[Extdata#NAND_Shared_Extdata|NAND Shared Extdata]] during [[System_Transfer#System_Save_Data_/_Shared_Extdata_Transfer|system tranfers]].
| Yes
| Yes
| No
| Yes
| ?
|-
| 0x12345681
| System Savedata transfer. Used for transferring [[System_SaveData|System Save Data]] during [[System_Transfer#System_Save_Data_/_Shared_Extdata_Transfer|system tranfers]].
| Yes
| Yes
| No
| Yes
| ?
|-
| 0x12345682
| Unknown. There's code for this in spider v9.9, but that code isn't actually used.
| Yes
| No
| No
| Yes
| ?
|-
| 0x2345678A
| Title access. With FS, this allows accessing NCCH/NCSD contents (ExeFS, RomFS, checking if a content uses a seed, checking the validity of the installed seed). FSPXI, additionally, allows opening raw NCCH/NCSD NCCH contents and DSiWare contents for reading, along with encrypted save data.
| Yes
| Yes
| No
| Yes
| 0x1005
|-
| 0x2345678B
| Used internally by Process9 as the lowest level title access archive. Allows for opening various sections of a title (TMD, CMD, raw contents, DLC contents, raw save data (including public/private/banner saves for DSiWare), title and/or content import context files and /data directories for save data.
| No
| No
| Yes
| Yes
|
|-
| 0x2345678C
| Used internally to access [[Title_Database|Title Database (/dbs)]] files. For SD, <code>title.db</code> and <code>import.db</code>. For NAND, <code>title.db</code>, <code>import.db</code>, <code>tmp_t.db</code>, <code>tmp_i.db</code>, and <code>jumpid.db</code>.
| No
| No
| Yes
| Yes
|
|-
| 0x2345678D
| Used internally to access non-title /dbs files on the NAND: <code>certs.db</code> and <code>ticket.db</code>.
| No
| No
| Yes
| No
|
|-
| 0x2345678E
| FSPXI: Program Access (limited subset of merged main title + update/patch title access). For fs:LDR(used by the "loader" FIRM ARM11-process), only <code>exefs:/.code</code>. Not accessible with fs:USER.
| Yes
| Yes
| No
| Yes
| None, see description.
|-
| 0x567890AB
| NAND CTR FS
| No
| Yes
| No
| No
| ?
|-
| 0x567890AC
| TWL PHOTO
| Yes
| Yes
| No
| No
| ?
|-
| 0x567890AD
| TWLS (DSi Sound stores recordings here). This is mapped to the FAT12 image stored in the file at [[Twln/shared2/0000]].
| No
| Yes
| No
| No
| ?
|-
| 0x567890AE
| NAND TWL FS
| Yes
| Yes
| No
| No
| 0x100
|-
| 0x567890AF
| NAND W FS
| Yes
| Yes
| No
| No
| 0x100
|-
| 0x567890B0
| Internally creates the same "ID Storage" wrapper over the NAND that is used for SystemSaveData and Shared ExtData, but all operations are stubbed and return 0xE0C046F8.
| No
| Yes
| No
| No
|
|-
| 0x567890B1
| Gamecard SaveData (for check). This is a wrapper for UserSaveDataForCheck: the OpenArchive code for that is called with archive-lowpath TID=0/mediatype=2(gamecard).
| Yes
| No
| No
| No
| 0x6
|-
| 0x567890B2
| UserSaveData (for check). This is the same as the regular SaveData archive, except with this the savedata ID and mediatype is loaded from the input archive lowpath.
| Yes
| No
| No
| Yes
| 0x6
|-
| 0x567890B3
| [[3DS_Virtual_Console#NAND_Savegame|AGB Save Data]]
| No
| No
| Yes
| No
| -
|-
| 0x567890B4
| Similar to 0x567890B2 but can only access Accessible Save specified in [[NCCH/Extended_Header#Storage_Info|exheader]]?
| Yes
| No
| No
| Yes
| ?
|}

Archives listed as not requiring a binary lowpath, use lowpath type [[FS:OpenFile|empty]].

The above permission bitmasks are from v2.x, see the above Services section for how these are handled.

Archives CTR NAND, NAND RO Write FS, TWL NAND, NAND W FS, and CARD SPI FS require the corresponding process exheader access control mount flag to be set, in the exheader for any of the currently running ARM11 processes, for [[Filesystem_services_PXI|FSPXI]]. The access rights checked by [[Filesystem services|FS]] module for archive mounting with fs:USER, are stored in the process' exheader accessinfo.

The CARDSPI archive allows access to the gamecard CARD1 raw savedata flash(aka "cardspi:/" in [[FIRM|Process9]]), the file lowpath must be WCHAR "/". The "NAND W FS" archive allows access to the raw NAND image(aka "wnand:/" in Process9), the file lowpath must be WCHAR "/".

= Filenames and Paths =
{{Anchor|PathType}} PathType:
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| -1
| Returned internally by Process9, when errors occur it seems(in particular when no nul-terminator was found in the input path). The data ptr is set to NULL.
|-
| 0x0
| INVALID - Specifies an invalid path
|-
| 0x1
| EMPTY - Specifies an empty path
|-
| 0x2
| BINARY - Non-text based path. Meaning is per-archive
|-
| 0x3
| ASCII - Text-based path with 7-bit ASCII characters padded to 8-bits each (signed char)
|-
| 0x4
| UTF16 - Text-based path with UTF-16 characters
|}

In IPC requests, sizes of ASCII and UTF16 paths must include space for the null-terminator.

== Binary LowPath ==
The format of the data that a binary LowPath points to is custom per archive.

=== SystemSaveData / Extdata / Shared Extdata Archive Path Data Format ===

==== DataAccessPath ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8 [[Mediatypes|Mediatype]]
|-
| 0x1 || 0x1 || only for NAND data (System Savedata / Shared Extdata), otherwise left 0:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || Accesses from/to <code>nand:/data/<ID0 of current system></code>
|-
| 1 || Accesses from/to <code>nand:/fixdata</code>
|-
| 2 || Accesses from/to <code>nand:/data/<ID0 from [[Filesystem_services#DeviceMoveContext|Device Move Context]]></code>
|}
|-
| 0x2 || 0x2 || padding
|}

==== SystemSaveData ====

===== FS =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 1
| save ID low (save ID high is 0)
|}

====== File Path ======
The file path is a cleartext ASCII or UTF16 file path (<code><file path></code>).

The file path would access the file at <code><base path>/sysdata/<save ID low>/<save ID high>/<file path></code>.
Note that <code>/<file path></code> refers to the virtual file system inside the </code><save ID high></code> file.

===== FSPXI / FS System Savedata Transfer / FSPXI System Savedata Transfer =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|}

====== File Path ======
{| class="wikitable" border="1"
|-
! Index word !! Description
|-
| 0 || save ID low
|-
| 1 || save ID high
|}

The file path would access the file at <code><base path>/sysdata/<save ID low>/<save ID high></code>.

==== Extdata / Shared Extdata ====

===== FS / FS Extdata Transfer / FSPXI Extdata Transfer =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 1
| ext save ID low
|-
| 2
| ext save ID high
|}

This refers to the extdata filesystem structure's base directory at <code><base path>/extdata/<ext save ID low>/<ext save ID high></code>.

====== File Path ======
The file path is a cleartext ASCII or UTF16 file path (<code><file path></code>).

For FS Extdata, this would acccess <code><base path>/extdata/<save ID low>/<save ID high>/<directory ID>/<file ID>/<file path></code>, and <code>/<file path></code> refers to the virtual file system inside the </code><file ID></code> file.

For FS / FSPXI Extdata Transfer, this accesses <code><base path>/extdata/<save ID low>/<save ID high>/<file path></code>.

=== UserSaveDataForCheck Archive Path Data Format ===
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Mediatypes|Mediatype]] (must be non-zero)
|-
| 1
| Lower word saveid
|-
| 2
| Upper word saveid
|}

The file/directory lowpath for this FS archive is a text path in the [[Savegames|savegame]] filesystem.

=== 0x567890B4 Archive Path Data Format ===
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Mediatypes|Mediatype]]
|-
| 1
| <code><nowiki>Lower_word_saveid >> 8</nowiki></code> ?
|-
| 2
| Unknown. Game calculate this using formula <code><nowiki>0xFFFFFF00 | unknown_b</nowiki></code>
|}

=== Title Access Archive Path Data Format ===
==== Title Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || High-level NCCH content access
|-
| 1 || Save data access (high-level, decrypted)
|-
| 2 || Raw content (low-level NCCH/SRL) access
|-
| 3 || Banner save data access (for DSiWare titles)
|-
| 4 || FS only: Save data transfer (internally uses generated data from [[FS:BeginSaveDataMove]] as the IV for "Save data access (low-level, encrypted)")
|-
| 5 || Save data access (low-level, encrypted)
|}

==== NCCH Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || RomFS
|-
| 1 || <code>exefs:/.code</code>
|-
| 2 || System Menu Data (<code>exefs:/icon</code>, <code>exefs:/banner</code>, <code>exefs:/logo</code>)
|-
| 3 || NCCH Header(s)
|-
| 4 || "is seeded" check
|-
| 5 || Seed verify/validate
|}

==== NCCH Header Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || [[NCCH/Extended_Header|Extheader]] (0x0-0x400)
|-
| 1 || [[NCCH/Extended_Header|Extheader]] AccessDesc (0x400-0x800)
|-
| 2 || Raw [[NCCH#NCCH_Header|NCCH Header]]
|}

==== Archive Path ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || Program ID (Title ID)
|-
| 0xB || 0x1 || [[Mediatypes|Media Type]]
|-
| 0xC || 0x4 || padding
|}

==== File Path ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || [[Filesystem_services#Title_Access_Type|Title Access Type]]
|-
| 0x4 || 0x10 || Dynamic data depending on [[Filesystem_services#Title_Access_Type|Title Access Type]]:

{| class="wikitable" border="1"
|-
! High Level NCCH Access !! Save Data Access (high level) !! Raw Content !! FS only: Save Data Transfer
|-
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Content index from TMD for NAND/SD titles
NCSD partition index for gamecards
|-
| 0x4 || 0x4 || [[Filesystem_services#NCCH_Access_Type|NCCH Access Type]]
|-
| 0x8 || 0x8 || Dynamic data depending on [[Filesystem_services#NCCH_Access_Type|NCCH Access Type]]:
For ExeFS, (System Menu Data / <code>exefs:/.code</code>),

{| class="wikitable" border="1"
| 8-byte ExeFS file name
|}

For Header Access,

{| class="wikitable" border="1"
| [[Filesystem_services#NCCH_Header_Access_Type|u64, NCCH Header Access Type]]
|}

For RomFS,

{| class="wikitable" border="1"
| [[NCCH#Content_Types|u64, Allowed content types flag]]
(<code>(1 << allowed_type_a) |

(1 << allowed_type_b)...</code>)
|}

|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x10 || 16-byte IV for save data crypto
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Content index from TMD for NAND/SD titles
NCSD partition index for gamecards
|-
| 0x4 || 0xC || padding
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Save data transfer key from [[FS:BeginSaveDataMove]]
|-
| 0x4 || 0xC || padding
|}
|}
|-
| 0x14 || 0x10 || 16-byte seed for titles that require one, or for validating a seed against the check value in the [[NCCH#NCCH_Header|NCCH Header]]'s check value.
If the title does not use a seed, this should not be included and size 0x14 should be used instead of 0x24.
|}

For encrypted save data access and banner save data access, the entire 0x10 portion of the dynamic data is left blank.

The "is seeded check" NCCH access type opens a virtual 1-byte file that reads either 0 or 1; this value is generated on-the-fly and will be 1 if ncchflags[7] has bit5 set (content uses seed), and 0 otherwise.

For NCCH sections that require a seed (e.g. <code>.code</code>, RomFS, etc.), the additional seed portion of the low path must be populated with the correct seed.

The "Seed Verify/Validate" NCCH access type also requires the seed portion of the lowpath. The target NCCH content is opened (with the opened file interface being stubbed, meaning no real reads/writes can be performed on it), and the given seed is used to calculate the seed check hash, and part of it is compared to the check value in the NCCH header. If it matches, opening the "file" succeeds, otherwise 0xD900458C is returned. If attempt is made to use the seed validation type on a content that does not use a seed, error 0xC92044E6 is returned.

==== FS Limitations ====

For FS, this archive functions the same, except for the following limitations:

- Only the title access types "High Level NCCH Access" and "High Level Save Data Access", and "Save Data Transfer" are allowed.

- For high level NCCH access, the types "RomFS", "System Menu Data", "Seeded check", and "Seed Check/Verify" are allowed.

- For "Seed Check/Verify", rather than providing the title seed in the file path (as is the case for FSPXI), the seed is retrieved from the seed database (meaning the file lowpath size is always 0x14 for FS).

=== Program Access / SelfNCCH access ===

Provides access to a "merged" archive of a base title and, optionally, a separate update (patch) title.

If no patch title exists, the base title is considered to be the patch title, i.e. turning all "patch" accesses into accesses to the base title.

==== Program Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description !! Accesses
|-
| 0 || RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default) || Base title
|-
| 1 || <code>exefs:/.code</code> || Patch title
|-
| 2 || System Menu Data (<code>exefs:/icon</code>, <code>exefs:/banner</code>, <code>exefs:/logo</code>) || Base title
|-
| 3 || Save Data (high level, decrypted) || -
|-
| 4 || RomFS (all [[NCCH#Content_Type|content types]]) || Base title
|-
| 5 || RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default) || Patch title
|}

==== Archive Path ====
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || u64, Program Handle from [[PXIPM:RegisterProgram]]
|}

==== File Path ====
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || [[Filesystem_services#Program_Access_Type|Program Access Type]]
|-
| 0x4 || 0x8 || Dynamic data depending on [[Filesystem_services#Program_Access_Type|Program Access Type]]:
{| class="wikitable" border="1"
|-
! ExeFS files (System Menu Data, etc.) !! RomFS of base title (all [[NCCH#Content_Type|content types]])
|-
|
{| class="wikitable" border="1"
| 8-character ExeFS filename
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, content index of target content
|-
| 0x4 || 0x4 || padding
|}
|}
|}

==== FS Limitations ====

- FSPXI allows all access types.

- When used through fs:LDR by loader, FS only provides access to <code>exefs:/.code</code>.

- For SelfNCCH access, the only allowed access types are "RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default)" of the Base or Patch title, and "System Menu Data". Attempting to access "Save Data" results in error 0xE0E046BE, "RomFS (all [[NCCH#Content_Type|content types]])" in 0xF9604784, and "<code>exefs:/.code</code>" in 0xD9004676.

=== [[RomFS]] ===

Archives 0x3 and 0x2345678E both allow for accessing the [[RomFS#Level_3_Format|level-3 IVFC images]] for RomFS access. The main CXI RomFS is accessible via an all-zero 0xc-byte binary file-lowpath. The update RomFS can be accessed with the first u32 in the binary file-lowpath being set to 0x5. The user must handle parsing the filesystem used in the exposed image itself.

With FSPXI the returned data for RomFS is the entire RomFS section from the NCCH, starting at the IVFC header.

The 0x3 archive is an interface for the 0x2345678E archive with the current process programID+mediatype. The file lowpath is 3-words. These words are written to 0x2345678E-archive file_lowpath+0, with the rest of that lowpath set to all-zero(lowpath is different from archive 0x2345678A). File lowpath:
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| See above. The only values which FS-module doesn't allow to be used here are:
* 0x1: Error 0xE0E046BE.
* 0x3: Error 0xE0E046BE.
* 0x4: FS-module executes svcBreak when using this.
|-
| 1-2
| See above. Not validated by FS-module.
|}

=Anti Savegame Restore=
Anti Savegame Restore, internally referred to as ''Save Data Rollback Prevention'', is a feature originally implemented in the FS module with [[4.0.0-7]], which prevents the user from restoring previous versions of a savegame image. This feature is not used (in practice) for gamecard games. When an old version of the save is detected, the application will display an error regarding old savegame version, then delete and recreate the save data (similar to when it is corrupted).

==Implementation==
When creating the savedata, the application generates a secure value (a 64 bit unsigned integer), then stores it in either the [[DISA_and_DIFF#DISA_header|DISA save image header]] or the [[Filesystem_services#Anti_Savegame_Restore_Save_Data|Anti Savegame Restore Save Data]]. The application then uses the anti-savegame-restore commands ([[FS:SetSaveDataSecureValue]], [[FS:GetSaveDataSecureValue]], [[FS:SetOtherSaveDataSecureValue]], [[FS:GetOtherSaveDataSecureValue]], [[FS:SetThisSaveDataSecureValue]], [[FS:GetThisSaveDataSecureValue]], [[FS:SetSaveArchiveSecureValue]] and [[FS:GetSaveArchiveSecureValue]]) to verify the value known to the game for comparison with the value returned by FS, and to update the value in the corresponding storage location.

Each time the application writes to the savegame, the value should be updated by both the application and through FS. Usually, applications update this value by incrementing it. However, generating a new random-number or other methods of updating it can be used as well.

==Anti Savegame Restore Save Data==
The save data used for this feature is stored in [[System_SaveData|System Save Data]] ID 0x00010011 and contains only one file, named <code>DB</code>:

===Main Structure===
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1000 || Header
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8, version (usually 0)
|-
| 0x1 || 0x3 || padding
|-
| 0x4 || 0x4 || u32, number of secure value entries
|-
| 0x8 || 0xFF8 || completely unused, padding
|}
|-
| 0x1000 || 0x1C000 (8 * 14336) || [[Filesystem_services#SecureValueKey|Secure value keys]]
|-
| 0x1D000 || 0x1C000 (8 * 14336) || u64s, Secure values
|}

===SecureValueKey===
Depending on which command is used, secure value keys can be interpreted as:
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || u64, Title ID
|}
or:
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, [[Filesystem_services#SecureValueSlot|Secure Value Slot]]
|-
| 0x4 || 0x4 || u32, Unique ID
|}

==Applications using this feature==
* Animal Crossing: New Leaf
* Pokemon X & Y
* Pokemon Omega Ruby & Alpha Sapphire
* Pokemon Omega Ruby & Alpha Sapphire Demo
* Pokemon Shuffle
* Super Smash Bros
* Pokemon Red,Blue and Yellow (GB(C) VC)
* Rusty's Real Deal Baseball
* Megami Meguri

=SEEDDB and TITLETAG=
With [[9.6.0-24|9.6.0-X]] new [[System_SaveData]] with save ID 0x0001000F was added. This save data contains both the NCCH seed database (SEEDDB) and the title tag database (TITLETAG).

These databases are managed by the commands [[FS:AddSeed]], [[FS:GetSeed]], [[FS:DeleteSeed]], [[FS:GetNumSeeds]] and [[FS:ListSeeds]] for SEEDDB, and [[FS:AddTitleTag]], [[FS:GetTitleTag]], [[FS:DeleteTitleTag]], [[FS:GetNumTitleTags]], and [[FS:ListTitleTags]] for TITLETAG respectively.

Both the [[Home_Menu|HOME Menu]] and the [[NIM_Services|NIM]] module have access to these commands.

==SEEDDB==

Stored in the system savedata archive 0x0001000F as a file named <code>SEEDDB</code>, it contains the title-unique seed-data used for the new [[NCCH]] keyY generation added with FIRM [[9.6.0-24|9.6.0-X]].

The file follows a simple key-value format allowing the storage of seed data for up to 2000 unique title IDs.

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1000 || Header
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8, version (usually 0)
|-
| 0x1 || 0x3 || padding
|-
| 0x4 || 0x4 || u32, number of seed entries
|-
| 0x8 || 0xFF8 || completely unused, padding
|}
|-
| 0x1000 || 0x3E80 (8 * 2000) || u64s, Title IDs
|-
| 0x4E80 || 0x7D00 (16 * 2000) || Seed data, 16 bytes per seed
|}

==TITLETAG==

Stored in the system savedata archive 0x0001000F as a file named <code>TITLETAG</code>, it contains information used by the [[Home_Menu|HOME Menu]] to handle cases when a to-be-released title has been purchased already, that is, to properly install the seed required for [[NCCH]] keyY generation added with FIRM [[9.6.0-24|9.6.0-X]].

When a to-be-released title is purchased, the [[NIM_Services|NIM]] module installs a [[Filesystem_services#TitleTag|title tag]] with enough information about the title for the [[Home_Menu|HOME Menu]] to be able to initiate a seed import once the title has been released (and thus, the title's NCCH content lock seed). Until the title's seed is released, and while the title tag remains in the database, the HOME Menu will prevent the user from launching the software as it would not run without the seed. Once released, information from the title tag is used to download the seed, and, if successful, the title tag is removed from the database, making the software playable.

The file follows a simple key-value format allowing the storage of title tag data for up to 2000 unique title IDs.

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1000 || Header
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8, version (usually 0)
|-
| 0x1 || 0x3 || padding
|-
| 0x4 || 0x4 || u32, number of entries
|-
| 0x8 || 0xFF8 || completely unused, padding
|}
|-
| 0x1000 || 0x3E80 (8 * 2000) || u64s, Title IDs
|-
| 0x4E80 || 0x3E800 (0x80 * 2000) || [[Filesystem_services#TitleTag|Title Tag]] data, 0x80 bytes per entry
|}

= Common Types =
== MediaType ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0
| NAND
|-
| 1
| SD
|-
| 2
| Game Card
|}

== SystemMediaType ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0
| CTR NAND
|-
| 1
| TWL NAND
|-
| 2
| SD
|-
| 3
| TWL Photo
|}

== OpenFlags ==
{| class="wikitable" border="1"
|-
! Bit
! Description
|-
| 0
| Read
|-
| 1
| Write
|-
| 2
| Create
|}

== Attributes ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| Is Directory
|-
| 0x1
| 0x1
| Is Hidden
|-
| 0x2
| 0x1
| Is Archive
|-
| 0x3
| 0x1
| Is Read-Only
|}

== WriteOption ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| Flush
|-
| 0x1
| 0x1
| Update Time Stamp
|-
| 0x2
| 0x1
| Reserved
|-
| 0x3
| 0x1
| Reserved
|}

== DirectoryEntry ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x20C
| UTF-16 Entry Name
|-
| 0x20C
| 0xA
| 8.3 short filename name
|-
| 0x216
| 0x4
| 8.3 short filename extension
|-
| 0x21A
| 0x1
| Always 1
|-
| 0x21B
| 0x1
| Reserved
|-
| 0x21C
| 0x4
| [[Filesystem_services#Attributes|Attributes]]
|-
| 0x220
| 0x8
| Entry Size
|}

== ArchiveResource ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| Sector byte-size
|-
| 0x4
| 0x4
| Cluster byte-size
|-
| 0x8
| 0x4
| Partition capacity in clusters
|-
| 0xC
| 0x4
| Available free space in clusters
|}

== ProgramInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x8
| Program ID
|-
| 0x8
| 0x1
| [[Filesystem_services#MediaType|Media Type]]
|-
| 0x9
| 0x7
| Padding
|}

== ProductInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| Product Code
|-
| 0x10
| 0x2
| Company Code
|-
| 0x12
| 0x2
| Remaster Version
|}

== IntegrityVerificationSeed ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| AES-CBC MAC over a SHA256 hash, which hashes the first 0x110-bytes of the cleartext SEED.
|-
| 0x10
| 0x120
| The [[nand/private/movable.sed]], encrypted with AES-CBC using the above MAC for the counter.
|}

== ExtSaveDataInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 0x4
| 0x8
| Save ID
|-
| 0xC
| 0x4
| Reserved
|}

== SystemSaveDataInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 0x4
| 0x4
| Save ID
|}

== SecureValueSlot ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x1000
| SD Application
|}

== SecureValueEntry ==
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, [[Filesystem_services#SecureValueSlot|Secure Value Slot]]
|-
| 0x4 || 0x1 || When used as an input entry:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || This entry should be removed.
|-
| 1 || This entry should be updated with the given value.
|}
When returned from a command:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || No entry with the given slot and title ID was found, or: this entry is unused.
|-
| 1 || The entry with the given slot and title ID was found, or: this entry is used.
|}
|-
| 0x5 || 0x3 || padding
|-
| 0x8 || 0x8 || u64, Secure Value
|}

== TitleTag ==
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Magic, <code>PREP</code> (PREPurchase install)
|-
| 0x4 || 0x4 || s32, Release date year
|-
| 0x8 || 0x1 || u8, Release date month
|-
| 0x9 || 0x1 || u8, Release date day
|-
| 0xA || 0x2 || u16, Country code
|-
| 0xC || 0x4 || u32, Seed status (0: not downloaded yet, 1: last download attempt failed, 2: seed installed successfully)
|-
| 0x10 || 0x4 || Result code from last seed installation attempt
|-
| 0x14 || 0x4 || Support error code from last seed installation attempt
|-
| 0x18 || 0x68 || reserved padding (unused)
|}

== CardSpiBaudRate ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x0
| 512KHz
|-
| 0x1
| 1MHz
|-
| 0x2
| 2MHz
|-
| 0x3
| 4MHz
|-
| 0x4
| 8MHz
|-
| 0x5
| 16MHz
|}

== CardSpiBusMode ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x0
| 1-bit
|-
| 0x1
| 4-bit
|}

== SpecialContentType ==
{| class="wikitable" border="1"
|-
! Value
! Description
! Found in
|-
| 0x1
| CTR (Old3DS) Update Partition
| Gamecards
|-
| 0x2
| Manual
| Gamecards, Digital titles
|-
| 0x3
| DLP Child
| Gamecards, Digital titles
|-
| 0x4
| KTR (New3DS) Update Partition
| Gamecards
|-
|}

== DeviceMoveContext ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| IVs (ID0 of source console)
|-
| 0x10
| 0x10
| Encrypt Parameter (used to calculate the IV for encryption)
|}

=Errors=
See [[Filesystem_services_PXI]].

[[Category:Services]]

Filesystem services

2025-07-01T20:13:37Z

TimmSkiller: rework SEEDDB into "SEEDDB and TITLETAG" section

= Services =
{{Anchor|FS}}{{Anchor|FSUSER}}{{Anchor|fs:USER}}
== Filesystem service "fs:USER" ==
You can at most have 32 FS archive handles.

{| class="wikitable" border="1"
|-
! Command Header
! Available since system version
! Description
! scope="col" width="400" | Required [[NCCH/Extended_Header|exheader]] access info bitmask
|-
| 0x000100C6
|?
| [[FS:Dummy1|Dummy1]]
| None
|-
| 0x040100C4
|?
| [[FS:Control|Control]]
| None
|-
| 0x08010002
|?
| [[FS:Initialize|Initialize]]
| None
|-
| 0x080201C2
|?
| [[FS:OpenFile|OpenFile]]
| None
|-
| 0x08030204
|?
| [[FS:OpenFileDirectly|OpenFileDirectly]]
| None
|-
| 0x08040142
|?
| [[FS:DeleteFile|DeleteFile]]
| None
|-
| 0x08050244
|?
| [[FS:RenameFile|RenameFile]]
| None
|-
| 0x08060142
|?
| [[FS:DeleteDirectory|DeleteDirectory]]
| None
|-
| 0x08070142
|?
| [[FS:DeleteDirectoryRecursively|DeleteDirectoryRecursively]]
| None
|-
| 0x08080202
|?
| [[FS:CreateFile|CreateFile]]
| None
|-
| 0x08090182
|?
| [[FS:CreateDirectory|CreateDirectory]]
| None
|-
| 0x080A0244
|?
| [[FS:RenameDirectory|RenameDirectory]]
| None
|-
| 0x080B0102
|?
| [[FS:OpenDirectory|OpenDirectory]]
| None
|-
| 0x080C00C2
|?
| [[FS:OpenArchive|OpenArchive]]
| Each archive ID code has separate access info bitmasks, if it has any
|-
| 0x080D0144
|?
| [[FS:ControlArchive|ControlArchive]]
| None
|-
| 0x080E0080
|?
| [[FS:CloseArchive|CloseArchive]]
| None
|-
| 0x080F0180
|?
| [[FS:Obsoleted_2_0_FormatThisUserSaveData|Obsoleted_2_0_FormatThisUserSaveData]]
| None
|-
| 0x08100200
|?
| [[FS:Obsoleted_3_0_CreateSystemSaveData|Obsoleted_3_0_CreateSystemSaveData]]
| 0x4, for when the input saveID doesn't match the exheader saveID
|-
| 0x08110040
|?
| [[FS:Obsoleted_3_0_DeleteSystemSaveData|Obsoleted_3_0_DeleteSystemSaveData]]
| 0x1004, for when the input saveID doesn't match the exheader saveID
|-
| 0x08120080
|?
| [[FS:GetFreeBytes|GetFreeBytes]]
| None
|-
| 0x08130000
|?
| [[FS:GetCardType|GetCardType]]
| 0x1017
|-
| 0x08140000
|?
| [[FS:GetSdmcArchiveResource|GetSdmcArchiveResource]]
| None
|-
| 0x08150000
|?
| [[FS:GetNandArchiveResource|GetNandArchiveResource]]
| 0x1007
|-
| 0x08160000
|?
| [[FS:GetSdmcFatfsError|GetSdmcFatfsError]]
| 0x2
|-
| 0x08170000
|?
| [[FS:IsSdmcDetected|IsSdmcDetected]]
| None
|-
| 0x08180000
|?
| [[FS:IsSdmcWritable|IsSdmcWritable]]
| None
|-
| 0x08190042
|?
| [[FS:GetSdmcCid|GetSdmcCid]]
| 0x2
|-
| 0x081A0042
|?
| [[FS:GetNandCid|GetNandCid]]
| 0x2
|-
| 0x081B0000
|?
| [[FS:GetSdmcSpeedInfo|GetSdmcSpeedInfo]]
| 0x2
|-
| 0x081C0000
|?
| [[FS:GetNandSpeedInfo|GetNandSpeedInfo]]
| 0x2
|-
| 0x081D0042
|?
| [[FS:GetSdmcLog|GetSdmcLog]]
| 0x2
|-
| 0x081E0042
|?
| [[FS:GetNandLog|GetNandLog]]
| 0x2
|-
| 0x081F0000
|?
| [[FS:ClearSdmcLog|ClearSdmcLog]]
| 0x2
|-
| 0x08200000
|?
| [[FS:ClearNandLog|ClearNandLog]]
| 0x2
|-
| 0x08210000
|?
| [[FS:CardSlotIsInserted|CardSlotIsInserted]]
| 0x1017
|-
| 0x08220000
|?
| [[FS:CardSlotPowerOn|CardSlotPowerOn]]
| 0x2
|-
| 0x08230000
|?
| [[FS:CardSlotPowerOff|CardSlotPowerOff]]
| 0x2
|-
| 0x08240000
|?
| [[FS:CardSlotGetCardIFPowerStatus|CardSlotGetCardIFPowerStatus]]
| 0x2
|-
| 0x08250040
|?
| [[FS:CardNorDirectCommand|CardNorDirectCommand]]
| 0x2
|-
| 0x08260080
|?
| [[FS:CardNorDirectCommandWithAddress|CardNorDirectCommandWithAddress]]
| 0x2
|-
| 0x08270082
|?
| [[FS:CardNorDirectRead|CardNorDirectRead]]
| 0x2
|-
| 0x082800C2
|?
| [[FS:CardNorDirectReadWithAddress|CardNorDirectReadWithAddress]]
| 0x2
|-
| 0x08290082
|?
| [[FS:CardNorDirectWrite|CardNorDirectWrite]]
| 0x2
|-
| 0x082A00C2
|?
| [[FS:CardNorDirectWriteWithAddress|CardNorDirectWriteWithAddress]]
| 0x2
|-
| 0x082B00C2
|?
| [[FS:CardNorDirectRead_4xIO|CardNorDirectRead_4xIO]]
| 0x2
|-
| 0x082C0082
|?
| [[FS:CardNorDirectCpuWriteWithoutVerify|CardNorDirectCpuWriteWithoutVerify]]
| 0x2
|-
| 0x082D0040
|?
| [[FS:CardNorDirectSectorEraseWithoutVerify|CardNorDirectSectorEraseWithoutVerify]]
| 0x2
|-
| 0x082E0040
|?
| [[FS:GetProductInfo|GetProductInfo]]
| 0x1005
|-
| 0x082F0040
|?
| [[FS:GetProgramLaunchInfo|GetProgramLaunchInfo]]
| 0x1005
|-
| 0x08300182
|?
| [[FS:Obsoleted_3_0_CreateExtSaveData|Obsoleted_3_0_CreateExtSaveData]]
| 0xC, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08310180
|?
| [[FS:Obsoleted_3_0_CreateSharedExtSaveData|Obsoleted_3_0_CreateSharedExtSaveData]]
| 0x1005
|-
| 0x08320102
|?
| [[FS:Obsoleted_3_0_ReadExtSaveDataIcon|Obsoleted_3_0_ReadExtSaveDataIcon]]
| 0x100D, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08330082
|?
| [[FS:Obsoleted_3_0_EnumerateExtSaveData|Obsoleted_3_0_EnumerateExtSaveData]]
| 0x1005
|-
| 0x08340082
|?
| [[FS:Obsoleted_3_0_EnumerateSharedExtSaveData|Obsoleted_3_0_EnumerateSharedExtSaveData]]
| 0x1005
|-
| 0x08350080
|?
| [[FS:Obsoleted_3_0_DeleteExtSaveData|Obsoleted_3_0_DeleteExtSaveData]]
| 0x100D, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08360080
|?
| [[FS:Obsoleted_3_0_DeleteSharedExtSaveData|Obsoleted_3_0_DeleteSharedExtSaveData]]
| 0x1005
|-
| 0x08370040
|?
| [[FS:SetCardSpiBaudRate|SetCardSpiBaudRate]]
| 0x2
|-
| 0x08380040
|?
| [[FS:SetCardSpiBusMode|SetCardSpiBusMode]]
| 0x2
|-
| 0x08390000
|?
| [[FS:SendInitializeInfoTo9|SendInitializeInfoTo9]]
| None
|-
| 0x083A0100
|?
| [[FS:GetSpecialContentIndex|GetSpecialContentIndex]]
| 0x1005
|-
| 0x083B00C2
|?
| [[FS:GetLegacyRomHeader|GetLegacyRomHeader]]
| 0x1015
|-
| 0x083C00C2
|?
| [[FS:GetLegacyBannerData|GetLegacyBannerData]]
| 0x1015
|-
| 0x083D0100
|?
| [[FS:CheckAuthorityToAccessExtSaveData|CheckAuthorityToAccessExtSaveData]]
| 0x44
|-
| 0x083E00C2
|?
| [[FS:QueryTotalQuotaSize|QueryTotalQuotaSize]]
| None
|-
| 0x083F00C0
|?
| [[FS:Obsoleted_3_0_GetExtDataBlockSize|Obsoleted_3_0_GetExtDataBlockSize]]
| None
|-
| 0x08400040
|?
| [[FS:AbnegateAccessRight|AbnegateAccessRight]]
|?
|-
| 0x08410000
|?
| [[FS:DeleteSdmcRoot|DeleteSdmcRoot]]
| 0x1005
|-
| 0x08420040
|?
| [[FS:DeleteAllExtSaveDataOnNand|DeleteAllExtSaveDataOnNand]]
| 0x1005
|-
| 0x08430000
|?
| [[FS:InitializeCtrFileSystem|InitializeCtrFileSystem]]
| None
|-
| 0x08440000
|?
| [[FS:CreateSeed|CreateSeed]]
| 0x2
|-
| 0x084500C2
|?
| [[FS:GetFormatInfo|GetFormatInfo]]
|?
|-
| 0x08460102
|?
| [[FS:GetLegacyRomHeader2|GetLegacyRomHeader2]]
| 0x1015
|-
| 0x08470180
|?
| [[FS:Obsoleted_2_0_FormatCtrCardUserSaveData|Obsoleted_2_0_FormatCtrCardUserSaveData]]
| 0x6
|-
| 0x08480042
|?
| [[FS:GetSdmcCtrRootPath|GetSdmcCtrRootPath]]
| 0x100D
|-
| 0x08490040
|?
| [[FS:GetArchiveResource|GetArchiveResource]]
|?
|-
| 0x084A0002
|?
| [[FS:ExportIntegrityVerificationSeed|ExportIntegrityVerificationSeed]]
| 0x4000
|-
| 0x084B0002
|?
| [[FS:ImportIntegrityVerificationSeed|ImportIntegrityVerificationSeed]]
| 0x4000
|-
| 0x084C0242
|?
| [[FS:FormatSaveData|FormatSaveData]]
| 0x6, in some cases this write isn't needed however
|-
| 0x084D0102
|?
| [[FS:GetLegacySubBannerData|GetLegacySubBannerData]]
| 0x1015
|-
| 0x084E0342
|?
| [[FS:UpdateSha256Context|UpdateSha256Context]]
| 0x5
|-
| 0x084F0102
|?
| [[FS:ReadSpecialFile|ReadSpecialFile]]
| None
|-
| 0x08500040
|?
| [[FS:GetSpecialFileSize|GetSpecialFileSize]]
| None
|-
| 0x08510242
| [[3.0.0-5]]
| [[FS:CreateExtSaveData|CreateExtSaveData]]
| Shared extdata: 0x101005. Regular extdata in certain cases: 0xC
|-
| 0x08520100
| [[3.0.0-5]]
| [[FS:DeleteExtSaveData|DeleteExtSaveData]]
| Shared extdata: 0x101005. Regular extdata in certain cases: 0x10100D
|-
| 0x08530142
| [[3.0.0-5]]
| [[FS:ReadExtSaveDataIcon|ReadExtSaveDataIcon]]
| 0x10100D (this doesn't apply in certain cases, however)
|-
| 0x085400C0
| [[3.0.0-5]]
| [[FS:GetExtDataBlockSize|GetExtDataBlockSize]]
| 0x10100D (this doesn't apply in certain cases, however)
|-
| 0x08550102
| [[3.0.0-5]]
| [[FS:EnumerateExtSaveData|EnumerateExtSaveData]]
| 0x101005
|-
| 0x08560240
| [[3.0.0-5]]
| [[FS:CreateSystemSaveData|CreateSystemSaveData]]
| 0x4 (this doesn't apply in certain cases, however)
|-
| 0x08570080
| [[3.0.0-5]]
| [[FS:DeleteSystemSaveData|DeleteSystemSaveData]]
| 0x1004 (this doesn't apply in certain cases, however)
|-
| 0x08580000
| [[3.0.0-5]]
| [[FS:StartDeviceMoveAsSource|StartDeviceMoveAsSource]]
| 0x2004
|-
| 0x08590200
| [[3.0.0-5]]
| [[FS:StartDeviceMoveAsDestination|StartDeviceMoveAsDestination]]
| 0x2004
|-
| 0x085A00C0
| [[3.0.0-5]]
| [[FS:SetArchivePriority|SetArchivePriority]]
| None
|-
| 0x085B0080
| [[3.0.0-5]]
| [[FS:GetArchivePriority|GetArchivePriority]]
| None
|-
| 0x085C00C0
| [[3.0.0-5]]
| [[FS:SetCtrCardLatencyParameter|SetCtrCardLatencyParameter]]
| 0xE
|-
| 0x085D01C0
| [[3.0.0-5]]
| [[FS:SetFsCompatibilityInfo|SetFsCompatibilityInfo]]
| 0x100001
|-
| 0x085E0040
| [[3.0.0-5]]
| [[FS:ResetCardCompatibilityParameter|ResetCardCompatibilityParameter]]
| 0xE
|-
| 0x085F0040
| [[3.0.0-5]]
| [[FS:SwitchCleanupInvalidSaveData|SwitchCleanupInvalidSaveData]]
| 0x12004
|-
| 0x08600042
| [[3.0.0-5]]
| [[FS:EnumerateSystemSaveData|EnumerateSystemSaveData]]
| 0x2004
|-
| 0x08610042
| [[3.0.0-5]]
| [[FS:InitializeWithSdkVersion|InitializeWithSdkVersion]]
| None
|-
| 0x08620040
| [[3.0.0-5]]
| [[FS:SetPriority|SetPriority]]
| None
|-
| 0x08630000
| [[3.0.0-5]]
| [[FS:GetPriority|GetPriority]]
| None
|-
| 0x08640000
| [[3.0.0-5]]
| [[FS:Obsoleted_4_0_GetNandInfo|Obsoleted_4_0_GetNandInfo]]
| Stubbed, this returns an error
|-
| 0x08650140
| [[4.0.0-7]]
| [[FS:SetSaveDataSecureValue|SetSaveDataSecureValue]]
| 0x121004 (in certain cases this doesn't apply, however)
|-
| 0x086600C0
| [[4.0.0-7]]
| [[FS:GetSaveDataSecureValue|GetSaveDataSecureValue]]
| 0x121004 (in certain cases this doesn't apply, however)
|-
| 0x086700C4
| [[4.0.0-7]]
| [[FS:ControlSecureSave|ControlSecureSave]]
| 0x121004
|-
| 0x08680000
| [[4.0.0-7]]
| [[FS:GetMediaType|GetMediaType]]
| None
|-
| 0x08690000
| [[4.0.0-7]]
| [[FS:Obsoleted_4_0_GetNandEraseCount|Obsoleted_4_0_GetNandEraseCount]]
| Stubbed, this returns an error.
|-
| 0x086A0082
| [[4.0.0-7]]
| [[FS:ReadNandReport|ReadNandReport]]
| None
|-
| 0x086B00C2
|?
| [[FS:SetOtherSaveDataSecureValue|SetOtherSaveDataSecureValue]]
| 0x121004
|-
| 0x086C00C2
|?
| [[FS:GetOtherSaveDataSecureValue|GetOtherSaveDataSecureValue]]
| 0x121004
|-
| 0x086D0080
|?
| [[FS:BeginSaveDataMove|BeginSaveDataMove]]
| 0x20004
|-
| 0x086E00C0
|?
| [[FS:SetThisSaveDataSecureValue|SetThisSaveDataSecureValue]]
|None
|-
| 0x086F0040
|?
| [[FS:GetThisSaveDataSecureValue|GetThisSaveDataSecureValue]]
| None
|-
| 0x087000C2
|?
| [[FS:CheckArchive|CheckArchive]]
|None
|-
| 0x08710140
| ?
| [[FS:TransferSaveDataCMAC|TransferSaveDataCMAC]]
| 0x20004
|-
| 0x08720200
|?
| [[FS:RegisterTitleContentOverlay|RegisterTitleContentOverlay]]
| 0x80004
|-
| 0x08730100
|?
| [[FS:UnregisterTitleContentOverlay|UnregisterTitleContentOverlay]]
| 0x80004
|-
| 0x08740000
|?
| [[FS:UnregisterAllTitleContentOverlays|UnregisterAllTitleContentOverlays]]
| 0x80004
|-
| 0x08750140
|?
| [[FS:SetSaveArchiveSecureValue|SetSaveArchiveSecureValue]]
|None
|-
| 0x087600C0
|?
| [[FS:GetSaveArchiveSecureValue|GetSaveArchiveSecureValue]]
|None
|-
| 0x08770140
|?
| [[FS:RegisterSpecialTitleContent|RegisterSpecialTitleContent]]
| 0x80004
|-
| 0x08780100
|?
| [[FS:UnregisterSpecialTitleContent|UnregisterSpecialTitleContent]]
| 0x80004
|-
| 0x087900C2
| ?
| Same as [[FS:GetLegacyBannerData|GetLegacyBannerData]], except for the last parameter this internally passes u8 value 0x1 instead of 0x0, for the FSPXI command.
| 0x101015
|-
| 0x087A0180
| [[9.6.0-24|9.6.0-X]]
| [[FS:AddSeed|AddSeed]]
| 0x200000
|-
| 0x087B0080
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetSeed|GetSeed]]
| 0x200000
|-
| 0x087C0080
| [[9.6.0-24|9.6.0-X]]
| [[FS:DeleteSeed|DeleteSeed]]
| 0x200000
|-
| 0x087D0000
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetNumSeeds|GetNumSeeds]]
| 0x200000
|-
| 0x087E0042
| [[9.6.0-24|9.6.0-X]]
| [[FS:ListSeeds|ListSeeds]]
| 0x200000
|-
| 0x087F0100
| [[9.6.0-24|9.6.0-X]]
| [[FS:TitleContentHasSeed|TitleContentHasSeed]]
| 0x200000
|-
| 0x08800880
| [[9.6.0-24|9.6.0-X]]
| [[FS:AddTitleTag|AddTitleTag]]
| 0x200000
|-
| 0x08810080
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetTitleTag|GetTitleTag]]
| 0x200000
|-
| 0x08820080
| [[9.6.0-24|9.6.0-X]]
| [[FS:DeleteTitleTag|DeleteTitleTag]]
| 0x200000
|-
| 0x08830000
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetNumTitleTags|GetNumTitleTags]]
| 0x200000
|-
| 0x08840042
| [[9.6.0-24|9.6.0-X]]
| [[FS:ListTitleTags|ListTitleTags]]
| 0x200000
|-
| 0x088500C0
| [[9.6.0-24|9.6.0-X]]
| [[FS:CheckTitleSeed|CheckTitleSeed]]
| 0x200000
|-
| 0x088600C0
| [[11.1.0-34|11.1.0-X]]
| [[FS:CheckUpdatedDat|CheckUpdatedDat]]
| 0x80000
|}

Note: The question marks from Dummy1 to GetSpecialFileSize on the "available since system version" field are mainly there because I think that most of these are necessary for the main system to function, so theoretically that would mean that since the creation of the 3DS these were available, or since launch if that makes more sense. But because of the peculiar nature of some of the functions, they will remain question marks until they can be confirmed 100%.

When access rights are required for a command, at least one of the bits in the process access info specified in the above table for the command must be set. Error 0xD9004676 is returned when a process attempts to use a command which it doesn't have access rights for the command. The exheader access info field is all zero's for most applications. Note that the permissions listed in the above table is for system-version v2.x, therefore permission bit(s) added with newer FIRM may be missing from this.

Each session for fs:USER has separate permissions, initially these are set to all zero's for new fs:USER sessions. The permissions/etc for fs:USER sessions are initialized via [[FS:Initialize]](loaded from the user process exheader).

{{Anchor|FSLDR}}{{Anchor|fs:LDR}}

== Filesystem service "fs:LDR" ==
This service is identical to fs:USER, except [[FS:OpenArchive]] archive 0x2345678E can only be accessed with fs:LDR.

{{Anchor|FSReg}}{{Anchor|FSREG}}{{Anchor|fs:REG}}
== ProgramRegistry service "fs:REG" ==
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C6
| [[FSReg:Dummy1|Dummy1]]
|-
| 0x040103C0
| [[FSReg:Register|Register]]
|-
| 0x04020040
| [[FSReg:Unregister|Unregister]]
|-
| 0x040300C0
| [[FSReg:GetProgramInfo|GetProgramInfo]]
|-
| 0x04040100
| [[FSReg:LoadProgram|LoadProgram]]
|-
| 0x04050080
| [[FSReg:UnloadProgram|UnloadProgram]]
|-
| 0x04060080
| [[FSReg:CheckHostLoadId|CheckHostLoadId]]
|}

Only two sessions can be opened for this service at a time, hence no other processes can use this due to [[Process_Manager_Services|pm-module]] and [[Loader_Services|loader]] using this.

=File and directory access=
==Files==
File session handles obtained via [[FS:OpenFile]] and [[FS:OpenFileDirectly]] can be used to access files through a service-like interface, despite not being an actual service registered using [[SRV:RegisterService]]. To use this service-like interface, simply call the SendSyncRequest SVC with a file session handle, using the IPC buffer in thread-local storage for parameters and responses, just like you would with a proper service.

{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C6
| [[FSFile:Dummy1|Dummy1]]
|-
| 0x040100C4
| [[FSFile:Control|Control]]
|-
| 0x08010100
| [[FSFile:OpenSubFile|OpenSubFile]]
|-
| 0x080200C2
| [[FSFile:Read|Read]]
|-
| 0x08030102
| [[FSFile:Write|Write]]
|-
| 0x08040000
| [[FSFile:GetSize|GetSize]]
|-
| 0x08050080
| [[FSFile:SetSize|SetSize]]
|-
| 0x08060000
| [[FSFile:GetAttributes|GetAttributes]]
|-
| 0x08070040
| [[FSFile:SetAttributes|SetAttributes]]
|-
| 0x08080000
| [[FSFile:Close|Close]]
|-
| 0x08090000
| [[FSFile:Flush|Flush]]
|-
| 0x080A0040
| [[FSFile:SetPriority|SetPriority]]
|-
| 0x080B0000
| [[FSFile:GetPriority|GetPriority]]
|-
| 0x080C0000
| [[FSFile:OpenLinkFile|OpenLinkFile]]
|-
| 0x0C010100
| [[FSFile:GetAvailable|GetAvailable]]
|}

==Directories==
Directory session handles obtained via [[FS:OpenDirectory]] are usable via a service-like interface, following the exact same procedure described above for file sessions.
{| class="wikitable" border="1"
|-
! Command Header
! Available since system version
! Description
|-
| 0x000100C6
| [[1.0.0-0]]
| [[FSDir:Dummy1|Dummy1]]
|-
| 0x040100C4
| [[1.0.0-0]]
| [[FSDir:Control|Control]]
|-
| 0x08010042
| [[1.0.0-0]]
| [[FSDir:Read|Read]]
|-
| 0x08020000
| [[1.0.0-0]]
| [[FSDir:Close|Close]]
|-
| 0x08030040
| ?
| [[FSDir:SetPriority|SetPriority]]
|-
| 0x08040000
| ?
| [[FSDir:GetPriority|GetPriority]]
|}

= Archives =
{| class="wikitable" border="1"
|-
! ArchiveId
! Description
! Accessible via [[Filesystem_services|FS]]
! Accessible via [[Filesystem_services_PXI|FSPXI]]
! Only accessible by Process9 internally
! Requires binary [[FS:OpenFile|Lowpath]]
! Required exheader FS access info bitmask
|-
| 0x00000003
| SelfNCCH (including [[#RomFS|RomFS]])
| Yes
| No
| No
| No
| None
|-
| 0x00000004
| SaveData (the saveID/mediatype for this is loaded from data originally from the user process' exheader)
| Yes
| No
| No
| No
| None
|-
| 0x00000006
| ExtSaveData
| Yes
| No
| No
| Yes
| 0x100D, when the input extdataID isn't listed in the exheader.
|-
| 0x00000007
| Shared ExtSaveData
| Yes
| No
| No
| Yes
| None
|-
| 0x00000008
| SystemSaveData
| Yes
| No
| No
| Yes
| 0x4, when the input saveID doesn't match the exheader system-saveID.
|-
| 0x00000009
| SDMC
| Yes
| Yes
| No
| No
| 0x8E
|-
| 0x0000000A
| SDMC Write-Only
| Yes
| No
| No
| No
| 0x808E
|-
| 0x12345678
| ExtSaveData for BOSS
| Yes
| No
| No
| Yes
| 0x44
|-
| 0x12345679
| CARD SPI FS
| Yes
| Yes
| No
| No
| 0x16
|-
| 0x1234567B
| ExtSaveData, and ExtSaveData for BOSS
| No
| Yes
| No
| Yes
|
|-
| 0x1234567C
| SystemSaveData
| No
| Yes
| No
| Yes
|
|-
| 0x1234567D
| NAND RW
| Yes
| Yes
| No
| No
| 0x800
|-
| 0x1234567E
| NAND RO
| Yes
| Yes
| No
| No
| 0x200
|-
| 0x1234567F
| NAND RO Write FS
| No
| Yes
| No
| No
| ?
|-
| 0x12345680
| Extdata transfer. Used for transferring [[Extdata#NAND_Shared_Extdata|NAND Shared Extdata]] during [[System_Transfer#System_Save_Data_/_Shared_Extdata_Transfer|system tranfers]].
| Yes
| Yes
| No
| Yes
| ?
|-
| 0x12345681
| System Savedata transfer. Used for transferring [[System_SaveData|System Save Data]] during [[System_Transfer#System_Save_Data_/_Shared_Extdata_Transfer|system tranfers]].
| Yes
| Yes
| No
| Yes
| ?
|-
| 0x12345682
| Unknown. There's code for this in spider v9.9, but that code isn't actually used.
| Yes
| No
| No
| Yes
| ?
|-
| 0x2345678A
| Title access. With FS, this allows accessing NCCH/NCSD contents (ExeFS, RomFS, checking if a content uses a seed, checking the validity of the installed seed). FSPXI, additionally, allows opening raw NCCH/NCSD NCCH contents and DSiWare contents for reading, along with encrypted save data.
| Yes
| Yes
| No
| Yes
| 0x1005
|-
| 0x2345678B
| Used internally by Process9 as the lowest level title access archive. Allows for opening various sections of a title (TMD, CMD, raw contents, DLC contents, raw save data (including public/private/banner saves for DSiWare), title and/or content import context files and /data directories for save data.
| No
| No
| Yes
| Yes
|
|-
| 0x2345678C
| Used internally to access [[Title_Database|Title Database (/dbs)]] files. For SD, <code>title.db</code> and <code>import.db</code>. For NAND, <code>title.db</code>, <code>import.db</code>, <code>tmp_t.db</code>, <code>tmp_i.db</code>, and <code>jumpid.db</code>.
| No
| No
| Yes
| Yes
|
|-
| 0x2345678D
| Used internally to access non-title /dbs files on the NAND: <code>certs.db</code> and <code>ticket.db</code>.
| No
| No
| Yes
| No
|
|-
| 0x2345678E
| FSPXI: Program Access (limited subset of merged main title + update/patch title access). For fs:LDR(used by the "loader" FIRM ARM11-process), only <code>exefs:/.code</code>. Not accessible with fs:USER.
| Yes
| Yes
| No
| Yes
| None, see description.
|-
| 0x567890AB
| NAND CTR FS
| No
| Yes
| No
| No
| ?
|-
| 0x567890AC
| TWL PHOTO
| Yes
| Yes
| No
| No
| ?
|-
| 0x567890AD
| TWLS (DSi Sound stores recordings here). This is mapped to the FAT12 image stored in the file at [[Twln/shared2/0000]].
| No
| Yes
| No
| No
| ?
|-
| 0x567890AE
| NAND TWL FS
| Yes
| Yes
| No
| No
| 0x100
|-
| 0x567890AF
| NAND W FS
| Yes
| Yes
| No
| No
| 0x100
|-
| 0x567890B0
| Internally creates the same "ID Storage" wrapper over the NAND that is used for SystemSaveData and Shared ExtData, but all operations are stubbed and return 0xE0C046F8.
| No
| Yes
| No
| No
|
|-
| 0x567890B1
| Gamecard SaveData (for check). This is a wrapper for UserSaveDataForCheck: the OpenArchive code for that is called with archive-lowpath TID=0/mediatype=2(gamecard).
| Yes
| No
| No
| No
| 0x6
|-
| 0x567890B2
| UserSaveData (for check). This is the same as the regular SaveData archive, except with this the savedata ID and mediatype is loaded from the input archive lowpath.
| Yes
| No
| No
| Yes
| 0x6
|-
| 0x567890B3
| [[3DS_Virtual_Console#NAND_Savegame|AGB Save Data]]
| No
| No
| Yes
| No
| -
|-
| 0x567890B4
| Similar to 0x567890B2 but can only access Accessible Save specified in [[NCCH/Extended_Header#Storage_Info|exheader]]?
| Yes
| No
| No
| Yes
| ?
|}

Archives listed as not requiring a binary lowpath, use lowpath type [[FS:OpenFile|empty]].

The above permission bitmasks are from v2.x, see the above Services section for how these are handled.

Archives CTR NAND, NAND RO Write FS, TWL NAND, NAND W FS, and CARD SPI FS require the corresponding process exheader access control mount flag to be set, in the exheader for any of the currently running ARM11 processes, for [[Filesystem_services_PXI|FSPXI]]. The access rights checked by [[Filesystem services|FS]] module for archive mounting with fs:USER, are stored in the process' exheader accessinfo.

The CARDSPI archive allows access to the gamecard CARD1 raw savedata flash(aka "cardspi:/" in [[FIRM|Process9]]), the file lowpath must be WCHAR "/". The "NAND W FS" archive allows access to the raw NAND image(aka "wnand:/" in Process9), the file lowpath must be WCHAR "/".

= Filenames and Paths =
{{Anchor|PathType}} PathType:
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| -1
| Returned internally by Process9, when errors occur it seems(in particular when no nul-terminator was found in the input path). The data ptr is set to NULL.
|-
| 0x0
| INVALID - Specifies an invalid path
|-
| 0x1
| EMPTY - Specifies an empty path
|-
| 0x2
| BINARY - Non-text based path. Meaning is per-archive
|-
| 0x3
| ASCII - Text-based path with 7-bit ASCII characters padded to 8-bits each (signed char)
|-
| 0x4
| UTF16 - Text-based path with UTF-16 characters
|}

In IPC requests, sizes of ASCII and UTF16 paths must include space for the null-terminator.

== Binary LowPath ==
The format of the data that a binary LowPath points to is custom per archive.

=== SystemSaveData / Extdata / Shared Extdata Archive Path Data Format ===

==== DataAccessPath ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8 [[Mediatypes|Mediatype]]
|-
| 0x1 || 0x1 || only for NAND data (System Savedata / Shared Extdata), otherwise left 0:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || Accesses from/to <code>nand:/data/<ID0 of current system></code>
|-
| 1 || Accesses from/to <code>nand:/fixdata</code>
|-
| 2 || Accesses from/to <code>nand:/data/<ID0 from [[Filesystem_services#DeviceMoveContext|Device Move Context]]></code>
|}
|-
| 0x2 || 0x2 || padding
|}

==== SystemSaveData ====

===== FS =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 1
| save ID low (save ID high is 0)
|}

====== File Path ======
The file path is a cleartext ASCII or UTF16 file path (<code><file path></code>).

The file path would access the file at <code><base path>/sysdata/<save ID low>/<save ID high>/<file path></code>.
Note that <code>/<file path></code> refers to the virtual file system inside the </code><save ID high></code> file.

===== FSPXI / FS System Savedata Transfer / FSPXI System Savedata Transfer =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|}

====== File Path ======
{| class="wikitable" border="1"
|-
! Index word !! Description
|-
| 0 || save ID low
|-
| 1 || save ID high
|}

The file path would access the file at <code><base path>/sysdata/<save ID low>/<save ID high></code>.

==== Extdata / Shared Extdata ====

===== FS / FS Extdata Transfer / FSPXI Extdata Transfer =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 1
| ext save ID low
|-
| 2
| ext save ID high
|}

This refers to the extdata filesystem structure's base directory at <code><base path>/extdata/<ext save ID low>/<ext save ID high></code>.

====== File Path ======
The file path is a cleartext ASCII or UTF16 file path (<code><file path></code>).

For FS Extdata, this would acccess <code><base path>/extdata/<save ID low>/<save ID high>/<directory ID>/<file ID>/<file path></code>, and <code>/<file path></code> refers to the virtual file system inside the </code><file ID></code> file.

For FS / FSPXI Extdata Transfer, this accesses <code><base path>/extdata/<save ID low>/<save ID high>/<file path></code>.

=== UserSaveDataForCheck Archive Path Data Format ===
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Mediatypes|Mediatype]] (must be non-zero)
|-
| 1
| Lower word saveid
|-
| 2
| Upper word saveid
|}

The file/directory lowpath for this FS archive is a text path in the [[Savegames|savegame]] filesystem.

=== 0x567890B4 Archive Path Data Format ===
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Mediatypes|Mediatype]]
|-
| 1
| <code><nowiki>Lower_word_saveid >> 8</nowiki></code> ?
|-
| 2
| Unknown. Game calculate this using formula <code><nowiki>0xFFFFFF00 | unknown_b</nowiki></code>
|}

=== Title Access Archive Path Data Format ===
==== Title Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || High-level NCCH content access
|-
| 1 || Save data access (high-level, decrypted)
|-
| 2 || Raw content (low-level NCCH/SRL) access
|-
| 3 || Banner save data access (for DSiWare titles)
|-
| 4 || FS only: Save data transfer (internally uses generated data from [[FS:BeginSaveDataMove]] as the IV for "Save data access (low-level, encrypted)")
|-
| 5 || Save data access (low-level, encrypted)
|}

==== NCCH Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || RomFS
|-
| 1 || <code>exefs:/.code</code>
|-
| 2 || System Menu Data (<code>exefs:/icon</code>, <code>exefs:/banner</code>, <code>exefs:/logo</code>)
|-
| 3 || NCCH Header(s)
|-
| 4 || "is seeded" check
|-
| 5 || Seed verify/validate
|}

==== NCCH Header Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || [[NCCH/Extended_Header|Extheader]] (0x0-0x400)
|-
| 1 || [[NCCH/Extended_Header|Extheader]] AccessDesc (0x400-0x800)
|-
| 2 || Raw [[NCCH#NCCH_Header|NCCH Header]]
|}

==== Archive Path ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || Program ID (Title ID)
|-
| 0xB || 0x1 || [[Mediatypes|Media Type]]
|-
| 0xC || 0x4 || padding
|}

==== File Path ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || [[Filesystem_services#Title_Access_Type|Title Access Type]]
|-
| 0x4 || 0x10 || Dynamic data depending on [[Filesystem_services#Title_Access_Type|Title Access Type]]:

{| class="wikitable" border="1"
|-
! High Level NCCH Access !! Save Data Access (high level) !! Raw Content !! FS only: Save Data Transfer
|-
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Content index from TMD for NAND/SD titles
NCSD partition index for gamecards
|-
| 0x4 || 0x4 || [[Filesystem_services#NCCH_Access_Type|NCCH Access Type]]
|-
| 0x8 || 0x8 || Dynamic data depending on [[Filesystem_services#NCCH_Access_Type|NCCH Access Type]]:
For ExeFS, (System Menu Data / <code>exefs:/.code</code>),

{| class="wikitable" border="1"
| 8-byte ExeFS file name
|}

For Header Access,

{| class="wikitable" border="1"
| [[Filesystem_services#NCCH_Header_Access_Type|u64, NCCH Header Access Type]]
|}

For RomFS,

{| class="wikitable" border="1"
| [[NCCH#Content_Types|u64, Allowed content types flag]]
(<code>(1 << allowed_type_a) |

(1 << allowed_type_b)...</code>)
|}

|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x10 || 16-byte IV for save data crypto
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Content index from TMD for NAND/SD titles
NCSD partition index for gamecards
|-
| 0x4 || 0xC || padding
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Save data transfer key from [[FS:BeginSaveDataMove]]
|-
| 0x4 || 0xC || padding
|}
|}
|-
| 0x14 || 0x10 || 16-byte seed for titles that require one, or for validating a seed against the check value in the [[NCCH#NCCH_Header|NCCH Header]]'s check value.
If the title does not use a seed, this should not be included and size 0x14 should be used instead of 0x24.
|}

For encrypted save data access and banner save data access, the entire 0x10 portion of the dynamic data is left blank.

The "is seeded check" NCCH access type opens a virtual 1-byte file that reads either 0 or 1; this value is generated on-the-fly and will be 1 if ncchflags[7] has bit5 set (content uses seed), and 0 otherwise.

For NCCH sections that require a seed (e.g. <code>.code</code>, RomFS, etc.), the additional seed portion of the low path must be populated with the correct seed.

The "Seed Verify/Validate" NCCH access type also requires the seed portion of the lowpath. The target NCCH content is opened (with the opened file interface being stubbed, meaning no real reads/writes can be performed on it), and the given seed is used to calculate the seed check hash, and part of it is compared to the check value in the NCCH header. If it matches, opening the "file" succeeds, otherwise 0xD900458C is returned. If attempt is made to use the seed validation type on a content that does not use a seed, error 0xC92044E6 is returned.

==== FS Limitations ====

For FS, this archive functions the same, except for the following limitations:

- Only the title access types "High Level NCCH Access" and "High Level Save Data Access", and "Save Data Transfer" are allowed.

- For high level NCCH access, the types "RomFS", "System Menu Data", "Seeded check", and "Seed Check/Verify" are allowed.

- For "Seed Check/Verify", rather than providing the title seed in the file path (as is the case for FSPXI), the seed is retrieved from the seed database (meaning the file lowpath size is always 0x14 for FS).

=== Program Access / SelfNCCH access ===

Provides access to a "merged" archive of a base title and, optionally, a separate update (patch) title.

If no patch title exists, the base title is considered to be the patch title, i.e. turning all "patch" accesses into accesses to the base title.

==== Program Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description !! Accesses
|-
| 0 || RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default) || Base title
|-
| 1 || <code>exefs:/.code</code> || Patch title
|-
| 2 || System Menu Data (<code>exefs:/icon</code>, <code>exefs:/banner</code>, <code>exefs:/logo</code>) || Base title
|-
| 3 || Save Data (high level, decrypted) || -
|-
| 4 || RomFS (all [[NCCH#Content_Type|content types]]) || Base title
|-
| 5 || RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default) || Patch title
|}

==== Archive Path ====
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || u64, Program Handle from [[PXIPM:RegisterProgram]]
|}

==== File Path ====
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || [[Filesystem_services#Program_Access_Type|Program Access Type]]
|-
| 0x4 || 0x8 || Dynamic data depending on [[Filesystem_services#Program_Access_Type|Program Access Type]]:
{| class="wikitable" border="1"
|-
! ExeFS files (System Menu Data, etc.) !! RomFS of base title (all [[NCCH#Content_Type|content types]])
|-
|
{| class="wikitable" border="1"
| 8-character ExeFS filename
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, content index of target content
|-
| 0x4 || 0x4 || padding
|}
|}
|}

==== FS Limitations ====

- FSPXI allows all access types.

- When used through fs:LDR by loader, FS only provides access to <code>exefs:/.code</code>.

- For SelfNCCH access, the only allowed access types are "RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default)" of the Base or Patch title, and "System Menu Data". Attempting to access "Save Data" results in error 0xE0E046BE, "RomFS (all [[NCCH#Content_Type|content types]])" in 0xF9604784, and "<code>exefs:/.code</code>" in 0xD9004676.

=== [[RomFS]] ===

Archives 0x3 and 0x2345678E both allow for accessing the [[RomFS#Level_3_Format|level-3 IVFC images]] for RomFS access. The main CXI RomFS is accessible via an all-zero 0xc-byte binary file-lowpath. The update RomFS can be accessed with the first u32 in the binary file-lowpath being set to 0x5. The user must handle parsing the filesystem used in the exposed image itself.

With FSPXI the returned data for RomFS is the entire RomFS section from the NCCH, starting at the IVFC header.

The 0x3 archive is an interface for the 0x2345678E archive with the current process programID+mediatype. The file lowpath is 3-words. These words are written to 0x2345678E-archive file_lowpath+0, with the rest of that lowpath set to all-zero(lowpath is different from archive 0x2345678A). File lowpath:
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| See above. The only values which FS-module doesn't allow to be used here are:
* 0x1: Error 0xE0E046BE.
* 0x3: Error 0xE0E046BE.
* 0x4: FS-module executes svcBreak when using this.
|-
| 1-2
| See above. Not validated by FS-module.
|}

=Anti Savegame Restore=
Anti Savegame Restore, internally referred to as ''Save Data Rollback Prevention'', is a feature originally implemented in the FS module with [[4.0.0-7]], which prevents the user from restoring previous versions of a savegame image. This feature is not used (in practice) for gamecard games. When an old version of the save is detected, the application will display an error regarding old savegame version, then delete and recreate the save data (similar to when it is corrupted).

==Implementation==
When creating the savedata, the application generates a secure value (a 64 bit unsigned integer), then stores it in either the [[DISA_and_DIFF#DISA_header|DISA save image header]] or the [[Filesystem_services#Anti_Savegame_Restore_Save_Data|Anti Savegame Restore Save Data]]. The application then uses the anti-savegame-restore commands ([[FS:SetSaveDataSecureValue]], [[FS:GetSaveDataSecureValue]], [[FS:SetOtherSaveDataSecureValue]], [[FS:GetOtherSaveDataSecureValue]], [[FS:SetThisSaveDataSecureValue]], [[FS:GetThisSaveDataSecureValue]], [[FS:SetSaveArchiveSecureValue]] and [[FS:GetSaveArchiveSecureValue]]) to verify the value known to the game for comparison with the value returned by FS, and to update the value in the corresponding storage location.

Each time the application writes to the savegame, the value should be updated by both the application and through FS. Usually, applications update this value by incrementing it. However, generating a new random-number or other methods of updating it can be used as well.

==Anti Savegame Restore Save Data==
The save data used for this feature is stored in [[System_SaveData|System Save Data]] ID 0x00010011 and contains only one file, named <code>DB</code>:

===SecureValueKey===
Depending on which command is used, secure value keys can be interpreted as:
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || u64, Title ID
|}
or:
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, [[Filesystem_services#SecureValueSlot|Secure Value Slot]]
|-
| 0x4 || 0x4 || u32, Unique ID
|}

===Main Structure===
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1000 || Header
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8, version (usually 0)
|-
| 0x1 || 0x3 || padding
|-
| 0x4 || 0x4 || u32, number of secure value entries
|-
| 0x8 || 0xFF8 || completely unused, padding
|}
|-
| 0x1000 || 0x1C000 (8 * 14336) || [[Filesystem_services#SecureValueKey|Secure value keys]]
|-
| 0x1D000 || 0x1C000 (8 * 14336) || u64s, Secure values
|}

==Applications using this feature==
* Animal Crossing: New Leaf
* Pokemon X & Y
* Pokemon Omega Ruby & Alpha Sapphire
* Pokemon Omega Ruby & Alpha Sapphire Demo
* Pokemon Shuffle
* Super Smash Bros
* Pokemon Red,Blue and Yellow (GB(C) VC)
* Rusty's Real Deal Baseball
* Megami Meguri

=SEEDDB and TITLETAG=
With [[9.6.0-24|9.6.0-X]] new [[System_SaveData]] with save ID 0x0001000F was added. This save data contains both the NCCH seed database (SEEDDB) and the title tag database (TITLETAG).

These databases are managed by the commands [[FS:AddSeed]], [[FS:GetSeed]], [[FS:DeleteSeed]], [[FS:GetNumSeeds]] and [[FS:ListSeeds]] for SEEDDB, and [[FS:AddTitleTag]], [[FS:GetTitleTag]], [[FS:DeleteTitleTag]], [[FS:GetNumTitleTags]], and [[FS:ListTitleTags]] for TITLETAG respectively.

Both the [[Home_Menu|HOME Menu]] and the [[NIM_Services|NIM]] module have access to these commands.

==SEEDDB==

Stored in the system savedata archive 0x0001000F as a file named <code>SEEDDB</code>, it contains the title-unique seed-data used for the new [[NCCH]] keyY generation added with FIRM [[9.6.0-24|9.6.0-X]].

The file follows a simple key-value format allowing the storage of seed data for up to 2000 unique title IDs.

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1000 || Header
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8, version (usually 0)
|-
| 0x1 || 0x3 || padding
|-
| 0x4 || 0x4 || u32, number of seed entries
|-
| 0x8 || 0xFF8 || completely unused, padding
|}
|-
| 0x1000 || 0x3E80 (8 * 2000) || u64s, Title IDs
|-
| 0x4E80 || 0x7D00 (16 * 2000) || Seed data, 16 bytes per seed
|}

==TITLETAG==

Stored in the system savedata archive 0x0001000F as a file named <code>TITLETAG</code>, it contains information used by the [[Home_Menu|HOME Menu]] to handle cases when a to-be-released title has been purchased already, that is, to properly install the seed required for [[NCCH]] keyY generation added with FIRM [[9.6.0-24|9.6.0-X]].

When a to-be-released title is purchased, the [[NIM_Services|NIM]] module installs a [[Filesystem_services#TitleTag|title tag]] with enough information about the title for the [[Home_Menu|HOME Menu]] to be able to initiate a seed import once the title has been released (and thus, the title's NCCH content lock seed). Until the title's seed is released, and while the title tag remains in the database, the HOME Menu will prevent the user from launching the software as it would not run without the seed. Once released, information from the title tag is used to download the seed, and, if successful, the title tag is removed from the database, making the software playable.

The file follows a simple key-value format allowing the storage of title tag data for up to 2000 unique title IDs.

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1000 || Header
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8, version (usually 0)
|-
| 0x1 || 0x3 || padding
|-
| 0x4 || 0x4 || u32, number of entries
|-
| 0x8 || 0xFF8 || completely unused, padding
|}
|-
| 0x1000 || 0x3E80 (8 * 2000) || u64s, Title IDs
|-
| 0x4E80 || 0x3E800 (0x80 * 2000) || [[Filesystem_services#TitleTag|Title Tag]] data, 0x80 bytes per entry
|}

= Common Types =
== MediaType ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0
| NAND
|-
| 1
| SD
|-
| 2
| Game Card
|}

== SystemMediaType ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0
| CTR NAND
|-
| 1
| TWL NAND
|-
| 2
| SD
|-
| 3
| TWL Photo
|}

== OpenFlags ==
{| class="wikitable" border="1"
|-
! Bit
! Description
|-
| 0
| Read
|-
| 1
| Write
|-
| 2
| Create
|}

== Attributes ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| Is Directory
|-
| 0x1
| 0x1
| Is Hidden
|-
| 0x2
| 0x1
| Is Archive
|-
| 0x3
| 0x1
| Is Read-Only
|}

== WriteOption ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| Flush
|-
| 0x1
| 0x1
| Update Time Stamp
|-
| 0x2
| 0x1
| Reserved
|-
| 0x3
| 0x1
| Reserved
|}

== DirectoryEntry ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x20C
| UTF-16 Entry Name
|-
| 0x20C
| 0xA
| 8.3 short filename name
|-
| 0x216
| 0x4
| 8.3 short filename extension
|-
| 0x21A
| 0x1
| Always 1
|-
| 0x21B
| 0x1
| Reserved
|-
| 0x21C
| 0x4
| [[Filesystem_services#Attributes|Attributes]]
|-
| 0x220
| 0x8
| Entry Size
|}

== ArchiveResource ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| Sector byte-size
|-
| 0x4
| 0x4
| Cluster byte-size
|-
| 0x8
| 0x4
| Partition capacity in clusters
|-
| 0xC
| 0x4
| Available free space in clusters
|}

== ProgramInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x8
| Program ID
|-
| 0x8
| 0x1
| [[Filesystem_services#MediaType|Media Type]]
|-
| 0x9
| 0x7
| Padding
|}

== ProductInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| Product Code
|-
| 0x10
| 0x2
| Company Code
|-
| 0x12
| 0x2
| Remaster Version
|}

== IntegrityVerificationSeed ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| AES-CBC MAC over a SHA256 hash, which hashes the first 0x110-bytes of the cleartext SEED.
|-
| 0x10
| 0x120
| The [[nand/private/movable.sed]], encrypted with AES-CBC using the above MAC for the counter.
|}

== ExtSaveDataInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 0x4
| 0x8
| Save ID
|-
| 0xC
| 0x4
| Reserved
|}

== SystemSaveDataInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 0x4
| 0x4
| Save ID
|}

== SecureValueSlot ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x1000
| SD Application
|}

== SecureValueEntry ==
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, [[Filesystem_services#SecureValueSlot|Secure Value Slot]]
|-
| 0x4 || 0x1 || When used as an input entry:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || This entry should be removed.
|-
| 1 || This entry should be updated with the given value.
|}
When returned from a command:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || No entry with the given slot and title ID was found, or: this entry is unused.
|-
| 1 || The entry with the given slot and title ID was found, or: this entry is used.
|}
|-
| 0x5 || 0x3 || padding
|-
| 0x8 || 0x8 || u64, Secure Value
|}

== TitleTag ==
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Magic, <code>PREP</code> (PREPurchase install)
|-
| 0x4 || 0x4 || s32, Release date year
|-
| 0x8 || 0x1 || u8, Release date month
|-
| 0x9 || 0x1 || u8, Release date day
|-
| 0xA || 0x2 || u16, Country code
|-
| 0xC || 0x4 || u32, Seed status (0: not downloaded yet, 1: last download attempt failed, 2: seed installed successfully)
|-
| 0x10 || 0x4 || Result code from last seed installation attempt
|-
| 0x14 || 0x4 || Support error code from last seed installation attempt
|-
| 0x18 || 0x68 || reserved padding (unused)
|}

== CardSpiBaudRate ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x0
| 512KHz
|-
| 0x1
| 1MHz
|-
| 0x2
| 2MHz
|-
| 0x3
| 4MHz
|-
| 0x4
| 8MHz
|-
| 0x5
| 16MHz
|}

== CardSpiBusMode ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x0
| 1-bit
|-
| 0x1
| 4-bit
|}

== SpecialContentType ==
{| class="wikitable" border="1"
|-
! Value
! Description
! Found in
|-
| 0x1
| CTR (Old3DS) Update Partition
| Gamecards
|-
| 0x2
| Manual
| Gamecards, Digital titles
|-
| 0x3
| DLP Child
| Gamecards, Digital titles
|-
| 0x4
| KTR (New3DS) Update Partition
| Gamecards
|-
|}

== DeviceMoveContext ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| IVs (ID0 of source console)
|-
| 0x10
| 0x10
| Encrypt Parameter (used to calculate the IV for encryption)
|}

=Errors=
See [[Filesystem_services_PXI]].

[[Category:Services]]

Anti Savegame Restore

2025-07-01T13:21:30Z

TimmSkiller: Changed redirect target from Filesystem Services#Anti Savegame Restore to Filesystem services#Anti Savegame Restore

#REDIRECT [[Filesystem_services#Anti_Savegame_Restore]]

Anti Savegame Restore

2025-07-01T13:21:22Z

TimmSkiller: Redirected page to Filesystem Services#Anti Savegame Restore

#REDIRECT [[Filesystem_Services#Anti_Savegame_Restore]]

Filesystem services

2025-07-01T13:20:07Z

TimmSkiller: Move anti savegame restore here

= Services =
{{Anchor|FS}}{{Anchor|FSUSER}}{{Anchor|fs:USER}}
== Filesystem service "fs:USER" ==
You can at most have 32 FS archive handles.

{| class="wikitable" border="1"
|-
! Command Header
! Available since system version
! Description
! scope="col" width="400" | Required [[NCCH/Extended_Header|exheader]] access info bitmask
|-
| 0x000100C6
|?
| [[FS:Dummy1|Dummy1]]
| None
|-
| 0x040100C4
|?
| [[FS:Control|Control]]
| None
|-
| 0x08010002
|?
| [[FS:Initialize|Initialize]]
| None
|-
| 0x080201C2
|?
| [[FS:OpenFile|OpenFile]]
| None
|-
| 0x08030204
|?
| [[FS:OpenFileDirectly|OpenFileDirectly]]
| None
|-
| 0x08040142
|?
| [[FS:DeleteFile|DeleteFile]]
| None
|-
| 0x08050244
|?
| [[FS:RenameFile|RenameFile]]
| None
|-
| 0x08060142
|?
| [[FS:DeleteDirectory|DeleteDirectory]]
| None
|-
| 0x08070142
|?
| [[FS:DeleteDirectoryRecursively|DeleteDirectoryRecursively]]
| None
|-
| 0x08080202
|?
| [[FS:CreateFile|CreateFile]]
| None
|-
| 0x08090182
|?
| [[FS:CreateDirectory|CreateDirectory]]
| None
|-
| 0x080A0244
|?
| [[FS:RenameDirectory|RenameDirectory]]
| None
|-
| 0x080B0102
|?
| [[FS:OpenDirectory|OpenDirectory]]
| None
|-
| 0x080C00C2
|?
| [[FS:OpenArchive|OpenArchive]]
| Each archive ID code has separate access info bitmasks, if it has any
|-
| 0x080D0144
|?
| [[FS:ControlArchive|ControlArchive]]
| None
|-
| 0x080E0080
|?
| [[FS:CloseArchive|CloseArchive]]
| None
|-
| 0x080F0180
|?
| [[FS:Obsoleted_2_0_FormatThisUserSaveData|Obsoleted_2_0_FormatThisUserSaveData]]
| None
|-
| 0x08100200
|?
| [[FS:Obsoleted_3_0_CreateSystemSaveData|Obsoleted_3_0_CreateSystemSaveData]]
| 0x4, for when the input saveID doesn't match the exheader saveID
|-
| 0x08110040
|?
| [[FS:Obsoleted_3_0_DeleteSystemSaveData|Obsoleted_3_0_DeleteSystemSaveData]]
| 0x1004, for when the input saveID doesn't match the exheader saveID
|-
| 0x08120080
|?
| [[FS:GetFreeBytes|GetFreeBytes]]
| None
|-
| 0x08130000
|?
| [[FS:GetCardType|GetCardType]]
| 0x1017
|-
| 0x08140000
|?
| [[FS:GetSdmcArchiveResource|GetSdmcArchiveResource]]
| None
|-
| 0x08150000
|?
| [[FS:GetNandArchiveResource|GetNandArchiveResource]]
| 0x1007
|-
| 0x08160000
|?
| [[FS:GetSdmcFatfsError|GetSdmcFatfsError]]
| 0x2
|-
| 0x08170000
|?
| [[FS:IsSdmcDetected|IsSdmcDetected]]
| None
|-
| 0x08180000
|?
| [[FS:IsSdmcWritable|IsSdmcWritable]]
| None
|-
| 0x08190042
|?
| [[FS:GetSdmcCid|GetSdmcCid]]
| 0x2
|-
| 0x081A0042
|?
| [[FS:GetNandCid|GetNandCid]]
| 0x2
|-
| 0x081B0000
|?
| [[FS:GetSdmcSpeedInfo|GetSdmcSpeedInfo]]
| 0x2
|-
| 0x081C0000
|?
| [[FS:GetNandSpeedInfo|GetNandSpeedInfo]]
| 0x2
|-
| 0x081D0042
|?
| [[FS:GetSdmcLog|GetSdmcLog]]
| 0x2
|-
| 0x081E0042
|?
| [[FS:GetNandLog|GetNandLog]]
| 0x2
|-
| 0x081F0000
|?
| [[FS:ClearSdmcLog|ClearSdmcLog]]
| 0x2
|-
| 0x08200000
|?
| [[FS:ClearNandLog|ClearNandLog]]
| 0x2
|-
| 0x08210000
|?
| [[FS:CardSlotIsInserted|CardSlotIsInserted]]
| 0x1017
|-
| 0x08220000
|?
| [[FS:CardSlotPowerOn|CardSlotPowerOn]]
| 0x2
|-
| 0x08230000
|?
| [[FS:CardSlotPowerOff|CardSlotPowerOff]]
| 0x2
|-
| 0x08240000
|?
| [[FS:CardSlotGetCardIFPowerStatus|CardSlotGetCardIFPowerStatus]]
| 0x2
|-
| 0x08250040
|?
| [[FS:CardNorDirectCommand|CardNorDirectCommand]]
| 0x2
|-
| 0x08260080
|?
| [[FS:CardNorDirectCommandWithAddress|CardNorDirectCommandWithAddress]]
| 0x2
|-
| 0x08270082
|?
| [[FS:CardNorDirectRead|CardNorDirectRead]]
| 0x2
|-
| 0x082800C2
|?
| [[FS:CardNorDirectReadWithAddress|CardNorDirectReadWithAddress]]
| 0x2
|-
| 0x08290082
|?
| [[FS:CardNorDirectWrite|CardNorDirectWrite]]
| 0x2
|-
| 0x082A00C2
|?
| [[FS:CardNorDirectWriteWithAddress|CardNorDirectWriteWithAddress]]
| 0x2
|-
| 0x082B00C2
|?
| [[FS:CardNorDirectRead_4xIO|CardNorDirectRead_4xIO]]
| 0x2
|-
| 0x082C0082
|?
| [[FS:CardNorDirectCpuWriteWithoutVerify|CardNorDirectCpuWriteWithoutVerify]]
| 0x2
|-
| 0x082D0040
|?
| [[FS:CardNorDirectSectorEraseWithoutVerify|CardNorDirectSectorEraseWithoutVerify]]
| 0x2
|-
| 0x082E0040
|?
| [[FS:GetProductInfo|GetProductInfo]]
| 0x1005
|-
| 0x082F0040
|?
| [[FS:GetProgramLaunchInfo|GetProgramLaunchInfo]]
| 0x1005
|-
| 0x08300182
|?
| [[FS:Obsoleted_3_0_CreateExtSaveData|Obsoleted_3_0_CreateExtSaveData]]
| 0xC, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08310180
|?
| [[FS:Obsoleted_3_0_CreateSharedExtSaveData|Obsoleted_3_0_CreateSharedExtSaveData]]
| 0x1005
|-
| 0x08320102
|?
| [[FS:Obsoleted_3_0_ReadExtSaveDataIcon|Obsoleted_3_0_ReadExtSaveDataIcon]]
| 0x100D, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08330082
|?
| [[FS:Obsoleted_3_0_EnumerateExtSaveData|Obsoleted_3_0_EnumerateExtSaveData]]
| 0x1005
|-
| 0x08340082
|?
| [[FS:Obsoleted_3_0_EnumerateSharedExtSaveData|Obsoleted_3_0_EnumerateSharedExtSaveData]]
| 0x1005
|-
| 0x08350080
|?
| [[FS:Obsoleted_3_0_DeleteExtSaveData|Obsoleted_3_0_DeleteExtSaveData]]
| 0x100D, for when the input extdataID doesn't match the exheader extdataID
|-
| 0x08360080
|?
| [[FS:Obsoleted_3_0_DeleteSharedExtSaveData|Obsoleted_3_0_DeleteSharedExtSaveData]]
| 0x1005
|-
| 0x08370040
|?
| [[FS:SetCardSpiBaudRate|SetCardSpiBaudRate]]
| 0x2
|-
| 0x08380040
|?
| [[FS:SetCardSpiBusMode|SetCardSpiBusMode]]
| 0x2
|-
| 0x08390000
|?
| [[FS:SendInitializeInfoTo9|SendInitializeInfoTo9]]
| None
|-
| 0x083A0100
|?
| [[FS:GetSpecialContentIndex|GetSpecialContentIndex]]
| 0x1005
|-
| 0x083B00C2
|?
| [[FS:GetLegacyRomHeader|GetLegacyRomHeader]]
| 0x1015
|-
| 0x083C00C2
|?
| [[FS:GetLegacyBannerData|GetLegacyBannerData]]
| 0x1015
|-
| 0x083D0100
|?
| [[FS:CheckAuthorityToAccessExtSaveData|CheckAuthorityToAccessExtSaveData]]
| 0x44
|-
| 0x083E00C2
|?
| [[FS:QueryTotalQuotaSize|QueryTotalQuotaSize]]
| None
|-
| 0x083F00C0
|?
| [[FS:Obsoleted_3_0_GetExtDataBlockSize|Obsoleted_3_0_GetExtDataBlockSize]]
| None
|-
| 0x08400040
|?
| [[FS:AbnegateAccessRight|AbnegateAccessRight]]
|?
|-
| 0x08410000
|?
| [[FS:DeleteSdmcRoot|DeleteSdmcRoot]]
| 0x1005
|-
| 0x08420040
|?
| [[FS:DeleteAllExtSaveDataOnNand|DeleteAllExtSaveDataOnNand]]
| 0x1005
|-
| 0x08430000
|?
| [[FS:InitializeCtrFileSystem|InitializeCtrFileSystem]]
| None
|-
| 0x08440000
|?
| [[FS:CreateSeed|CreateSeed]]
| 0x2
|-
| 0x084500C2
|?
| [[FS:GetFormatInfo|GetFormatInfo]]
|?
|-
| 0x08460102
|?
| [[FS:GetLegacyRomHeader2|GetLegacyRomHeader2]]
| 0x1015
|-
| 0x08470180
|?
| [[FS:Obsoleted_2_0_FormatCtrCardUserSaveData|Obsoleted_2_0_FormatCtrCardUserSaveData]]
| 0x6
|-
| 0x08480042
|?
| [[FS:GetSdmcCtrRootPath|GetSdmcCtrRootPath]]
| 0x100D
|-
| 0x08490040
|?
| [[FS:GetArchiveResource|GetArchiveResource]]
|?
|-
| 0x084A0002
|?
| [[FS:ExportIntegrityVerificationSeed|ExportIntegrityVerificationSeed]]
| 0x4000
|-
| 0x084B0002
|?
| [[FS:ImportIntegrityVerificationSeed|ImportIntegrityVerificationSeed]]
| 0x4000
|-
| 0x084C0242
|?
| [[FS:FormatSaveData|FormatSaveData]]
| 0x6, in some cases this write isn't needed however
|-
| 0x084D0102
|?
| [[FS:GetLegacySubBannerData|GetLegacySubBannerData]]
| 0x1015
|-
| 0x084E0342
|?
| [[FS:UpdateSha256Context|UpdateSha256Context]]
| 0x5
|-
| 0x084F0102
|?
| [[FS:ReadSpecialFile|ReadSpecialFile]]
| None
|-
| 0x08500040
|?
| [[FS:GetSpecialFileSize|GetSpecialFileSize]]
| None
|-
| 0x08510242
| [[3.0.0-5]]
| [[FS:CreateExtSaveData|CreateExtSaveData]]
| Shared extdata: 0x101005. Regular extdata in certain cases: 0xC
|-
| 0x08520100
| [[3.0.0-5]]
| [[FS:DeleteExtSaveData|DeleteExtSaveData]]
| Shared extdata: 0x101005. Regular extdata in certain cases: 0x10100D
|-
| 0x08530142
| [[3.0.0-5]]
| [[FS:ReadExtSaveDataIcon|ReadExtSaveDataIcon]]
| 0x10100D (this doesn't apply in certain cases, however)
|-
| 0x085400C0
| [[3.0.0-5]]
| [[FS:GetExtDataBlockSize|GetExtDataBlockSize]]
| 0x10100D (this doesn't apply in certain cases, however)
|-
| 0x08550102
| [[3.0.0-5]]
| [[FS:EnumerateExtSaveData|EnumerateExtSaveData]]
| 0x101005
|-
| 0x08560240
| [[3.0.0-5]]
| [[FS:CreateSystemSaveData|CreateSystemSaveData]]
| 0x4 (this doesn't apply in certain cases, however)
|-
| 0x08570080
| [[3.0.0-5]]
| [[FS:DeleteSystemSaveData|DeleteSystemSaveData]]
| 0x1004 (this doesn't apply in certain cases, however)
|-
| 0x08580000
| [[3.0.0-5]]
| [[FS:StartDeviceMoveAsSource|StartDeviceMoveAsSource]]
| 0x2004
|-
| 0x08590200
| [[3.0.0-5]]
| [[FS:StartDeviceMoveAsDestination|StartDeviceMoveAsDestination]]
| 0x2004
|-
| 0x085A00C0
| [[3.0.0-5]]
| [[FS:SetArchivePriority|SetArchivePriority]]
| None
|-
| 0x085B0080
| [[3.0.0-5]]
| [[FS:GetArchivePriority|GetArchivePriority]]
| None
|-
| 0x085C00C0
| [[3.0.0-5]]
| [[FS:SetCtrCardLatencyParameter|SetCtrCardLatencyParameter]]
| 0xE
|-
| 0x085D01C0
| [[3.0.0-5]]
| [[FS:SetFsCompatibilityInfo|SetFsCompatibilityInfo]]
| 0x100001
|-
| 0x085E0040
| [[3.0.0-5]]
| [[FS:ResetCardCompatibilityParameter|ResetCardCompatibilityParameter]]
| 0xE
|-
| 0x085F0040
| [[3.0.0-5]]
| [[FS:SwitchCleanupInvalidSaveData|SwitchCleanupInvalidSaveData]]
| 0x12004
|-
| 0x08600042
| [[3.0.0-5]]
| [[FS:EnumerateSystemSaveData|EnumerateSystemSaveData]]
| 0x2004
|-
| 0x08610042
| [[3.0.0-5]]
| [[FS:InitializeWithSdkVersion|InitializeWithSdkVersion]]
| None
|-
| 0x08620040
| [[3.0.0-5]]
| [[FS:SetPriority|SetPriority]]
| None
|-
| 0x08630000
| [[3.0.0-5]]
| [[FS:GetPriority|GetPriority]]
| None
|-
| 0x08640000
| [[3.0.0-5]]
| [[FS:Obsoleted_4_0_GetNandInfo|Obsoleted_4_0_GetNandInfo]]
| Stubbed, this returns an error
|-
| 0x08650140
| [[4.0.0-7]]
| [[FS:SetSaveDataSecureValue|SetSaveDataSecureValue]]
| 0x121004 (in certain cases this doesn't apply, however)
|-
| 0x086600C0
| [[4.0.0-7]]
| [[FS:GetSaveDataSecureValue|GetSaveDataSecureValue]]
| 0x121004 (in certain cases this doesn't apply, however)
|-
| 0x086700C4
| [[4.0.0-7]]
| [[FS:ControlSecureSave|ControlSecureSave]]
| 0x121004
|-
| 0x08680000
| [[4.0.0-7]]
| [[FS:GetMediaType|GetMediaType]]
| None
|-
| 0x08690000
| [[4.0.0-7]]
| [[FS:Obsoleted_4_0_GetNandEraseCount|Obsoleted_4_0_GetNandEraseCount]]
| Stubbed, this returns an error.
|-
| 0x086A0082
| [[4.0.0-7]]
| [[FS:ReadNandReport|ReadNandReport]]
| None
|-
| 0x086B00C2
|?
| [[FS:SetOtherSaveDataSecureValue|SetOtherSaveDataSecureValue]]
| 0x121004
|-
| 0x086C00C2
|?
| [[FS:GetOtherSaveDataSecureValue|GetOtherSaveDataSecureValue]]
| 0x121004
|-
| 0x086D0080
|?
| [[FS:BeginSaveDataMove|BeginSaveDataMove]]
| 0x20004
|-
| 0x086E00C0
|?
| [[FS:SetThisSaveDataSecureValue|SetThisSaveDataSecureValue]]
|None
|-
| 0x086F0040
|?
| [[FS:GetThisSaveDataSecureValue|GetThisSaveDataSecureValue]]
| None
|-
| 0x087000C2
|?
| [[FS:CheckArchive|CheckArchive]]
|None
|-
| 0x08710140
| ?
| [[FS:TransferSaveDataCMAC|TransferSaveDataCMAC]]
| 0x20004
|-
| 0x08720200
|?
| [[FS:RegisterTitleContentOverlay|RegisterTitleContentOverlay]]
| 0x80004
|-
| 0x08730100
|?
| [[FS:UnregisterTitleContentOverlay|UnregisterTitleContentOverlay]]
| 0x80004
|-
| 0x08740000
|?
| [[FS:UnregisterAllTitleContentOverlays|UnregisterAllTitleContentOverlays]]
| 0x80004
|-
| 0x08750140
|?
| [[FS:SetSaveArchiveSecureValue|SetSaveArchiveSecureValue]]
|None
|-
| 0x087600C0
|?
| [[FS:GetSaveArchiveSecureValue|GetSaveArchiveSecureValue]]
|None
|-
| 0x08770140
|?
| [[FS:RegisterSpecialTitleContent|RegisterSpecialTitleContent]]
| 0x80004
|-
| 0x08780100
|?
| [[FS:UnregisterSpecialTitleContent|UnregisterSpecialTitleContent]]
| 0x80004
|-
| 0x087900C2
| ?
| Same as [[FS:GetLegacyBannerData|GetLegacyBannerData]], except for the last parameter this internally passes u8 value 0x1 instead of 0x0, for the FSPXI command.
| 0x101015
|-
| 0x087A0180
| [[9.6.0-24|9.6.0-X]]
| [[FS:AddSeed|AddSeed]]
| 0x200000
|-
| 0x087B0080
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetSeed|GetSeed]]
| 0x200000
|-
| 0x087C0080
| [[9.6.0-24|9.6.0-X]]
| [[FS:DeleteSeed|DeleteSeed]]
| 0x200000
|-
| 0x087D0000
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetNumSeeds|GetNumSeeds]]
| 0x200000
|-
| 0x087E0042
| [[9.6.0-24|9.6.0-X]]
| [[FS:ListSeeds|ListSeeds]]
| 0x200000
|-
| 0x087F0100
| [[9.6.0-24|9.6.0-X]]
| [[FS:TitleContentHasSeed|TitleContentHasSeed]]
| 0x200000
|-
| 0x08800880
| [[9.6.0-24|9.6.0-X]]
| [[FS:AddTitleTag|AddTitleTag]]
| 0x200000
|-
| 0x08810080
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetTitleTag|GetTitleTag]]
| 0x200000
|-
| 0x08820080
| [[9.6.0-24|9.6.0-X]]
| [[FS:DeleteTitleTag|DeleteTitleTag]]
| 0x200000
|-
| 0x08830000
| [[9.6.0-24|9.6.0-X]]
| [[FS:GetNumTitleTags|GetNumTitleTags]]
| 0x200000
|-
| 0x08840042
| [[9.6.0-24|9.6.0-X]]
| [[FS:ListTitleTags|ListTitleTags]]
| 0x200000
|-
| 0x088500C0
| [[9.6.0-24|9.6.0-X]]
| [[FS:CheckTitleSeed|CheckTitleSeed]]
| 0x200000
|-
| 0x088600C0
| [[11.1.0-34|11.1.0-X]]
| [[FS:CheckUpdatedDat|CheckUpdatedDat]]
| 0x80000
|}

Note: The question marks from Dummy1 to GetSpecialFileSize on the "available since system version" field are mainly there because I think that most of these are necessary for the main system to function, so theoretically that would mean that since the creation of the 3DS these were available, or since launch if that makes more sense. But because of the peculiar nature of some of the functions, they will remain question marks until they can be confirmed 100%.

When access rights are required for a command, at least one of the bits in the process access info specified in the above table for the command must be set. Error 0xD9004676 is returned when a process attempts to use a command which it doesn't have access rights for the command. The exheader access info field is all zero's for most applications. Note that the permissions listed in the above table is for system-version v2.x, therefore permission bit(s) added with newer FIRM may be missing from this.

Each session for fs:USER has separate permissions, initially these are set to all zero's for new fs:USER sessions. The permissions/etc for fs:USER sessions are initialized via [[FS:Initialize]](loaded from the user process exheader).

{{Anchor|FSLDR}}{{Anchor|fs:LDR}}

== Filesystem service "fs:LDR" ==
This service is identical to fs:USER, except [[FS:OpenArchive]] archive 0x2345678E can only be accessed with fs:LDR.

{{Anchor|FSReg}}{{Anchor|FSREG}}{{Anchor|fs:REG}}
== ProgramRegistry service "fs:REG" ==
{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C6
| [[FSReg:Dummy1|Dummy1]]
|-
| 0x040103C0
| [[FSReg:Register|Register]]
|-
| 0x04020040
| [[FSReg:Unregister|Unregister]]
|-
| 0x040300C0
| [[FSReg:GetProgramInfo|GetProgramInfo]]
|-
| 0x04040100
| [[FSReg:LoadProgram|LoadProgram]]
|-
| 0x04050080
| [[FSReg:UnloadProgram|UnloadProgram]]
|-
| 0x04060080
| [[FSReg:CheckHostLoadId|CheckHostLoadId]]
|}

Only two sessions can be opened for this service at a time, hence no other processes can use this due to [[Process_Manager_Services|pm-module]] and [[Loader_Services|loader]] using this.

=File and directory access=
==Files==
File session handles obtained via [[FS:OpenFile]] and [[FS:OpenFileDirectly]] can be used to access files through a service-like interface, despite not being an actual service registered using [[SRV:RegisterService]]. To use this service-like interface, simply call the SendSyncRequest SVC with a file session handle, using the IPC buffer in thread-local storage for parameters and responses, just like you would with a proper service.

{| class="wikitable" border="1"
|-
! Command Header
! Description
|-
| 0x000100C6
| [[FSFile:Dummy1|Dummy1]]
|-
| 0x040100C4
| [[FSFile:Control|Control]]
|-
| 0x08010100
| [[FSFile:OpenSubFile|OpenSubFile]]
|-
| 0x080200C2
| [[FSFile:Read|Read]]
|-
| 0x08030102
| [[FSFile:Write|Write]]
|-
| 0x08040000
| [[FSFile:GetSize|GetSize]]
|-
| 0x08050080
| [[FSFile:SetSize|SetSize]]
|-
| 0x08060000
| [[FSFile:GetAttributes|GetAttributes]]
|-
| 0x08070040
| [[FSFile:SetAttributes|SetAttributes]]
|-
| 0x08080000
| [[FSFile:Close|Close]]
|-
| 0x08090000
| [[FSFile:Flush|Flush]]
|-
| 0x080A0040
| [[FSFile:SetPriority|SetPriority]]
|-
| 0x080B0000
| [[FSFile:GetPriority|GetPriority]]
|-
| 0x080C0000
| [[FSFile:OpenLinkFile|OpenLinkFile]]
|-
| 0x0C010100
| [[FSFile:GetAvailable|GetAvailable]]
|}

==Directories==
Directory session handles obtained via [[FS:OpenDirectory]] are usable via a service-like interface, following the exact same procedure described above for file sessions.
{| class="wikitable" border="1"
|-
! Command Header
! Available since system version
! Description
|-
| 0x000100C6
| [[1.0.0-0]]
| [[FSDir:Dummy1|Dummy1]]
|-
| 0x040100C4
| [[1.0.0-0]]
| [[FSDir:Control|Control]]
|-
| 0x08010042
| [[1.0.0-0]]
| [[FSDir:Read|Read]]
|-
| 0x08020000
| [[1.0.0-0]]
| [[FSDir:Close|Close]]
|-
| 0x08030040
| ?
| [[FSDir:SetPriority|SetPriority]]
|-
| 0x08040000
| ?
| [[FSDir:GetPriority|GetPriority]]
|}

= Archives =
{| class="wikitable" border="1"
|-
! ArchiveId
! Description
! Accessible via [[Filesystem_services|FS]]
! Accessible via [[Filesystem_services_PXI|FSPXI]]
! Only accessible by Process9 internally
! Requires binary [[FS:OpenFile|Lowpath]]
! Required exheader FS access info bitmask
|-
| 0x00000003
| SelfNCCH (including [[#RomFS|RomFS]])
| Yes
| No
| No
| No
| None
|-
| 0x00000004
| SaveData (the saveID/mediatype for this is loaded from data originally from the user process' exheader)
| Yes
| No
| No
| No
| None
|-
| 0x00000006
| ExtSaveData
| Yes
| No
| No
| Yes
| 0x100D, when the input extdataID isn't listed in the exheader.
|-
| 0x00000007
| Shared ExtSaveData
| Yes
| No
| No
| Yes
| None
|-
| 0x00000008
| SystemSaveData
| Yes
| No
| No
| Yes
| 0x4, when the input saveID doesn't match the exheader system-saveID.
|-
| 0x00000009
| SDMC
| Yes
| Yes
| No
| No
| 0x8E
|-
| 0x0000000A
| SDMC Write-Only
| Yes
| No
| No
| No
| 0x808E
|-
| 0x12345678
| ExtSaveData for BOSS
| Yes
| No
| No
| Yes
| 0x44
|-
| 0x12345679
| CARD SPI FS
| Yes
| Yes
| No
| No
| 0x16
|-
| 0x1234567B
| ExtSaveData, and ExtSaveData for BOSS
| No
| Yes
| No
| Yes
|
|-
| 0x1234567C
| SystemSaveData
| No
| Yes
| No
| Yes
|
|-
| 0x1234567D
| NAND RW
| Yes
| Yes
| No
| No
| 0x800
|-
| 0x1234567E
| NAND RO
| Yes
| Yes
| No
| No
| 0x200
|-
| 0x1234567F
| NAND RO Write FS
| No
| Yes
| No
| No
| ?
|-
| 0x12345680
| Extdata transfer. Used for transferring [[Extdata#NAND_Shared_Extdata|NAND Shared Extdata]] during [[System_Transfer#System_Save_Data_/_Shared_Extdata_Transfer|system tranfers]].
| Yes
| Yes
| No
| Yes
| ?
|-
| 0x12345681
| System Savedata transfer. Used for transferring [[System_SaveData|System Save Data]] during [[System_Transfer#System_Save_Data_/_Shared_Extdata_Transfer|system tranfers]].
| Yes
| Yes
| No
| Yes
| ?
|-
| 0x12345682
| Unknown. There's code for this in spider v9.9, but that code isn't actually used.
| Yes
| No
| No
| Yes
| ?
|-
| 0x2345678A
| Title access. With FS, this allows accessing NCCH/NCSD contents (ExeFS, RomFS, checking if a content uses a seed, checking the validity of the installed seed). FSPXI, additionally, allows opening raw NCCH/NCSD NCCH contents and DSiWare contents for reading, along with encrypted save data.
| Yes
| Yes
| No
| Yes
| 0x1005
|-
| 0x2345678B
| Used internally by Process9 as the lowest level title access archive. Allows for opening various sections of a title (TMD, CMD, raw contents, DLC contents, raw save data (including public/private/banner saves for DSiWare), title and/or content import context files and /data directories for save data.
| No
| No
| Yes
| Yes
|
|-
| 0x2345678C
| Used internally to access [[Title_Database|Title Database (/dbs)]] files. For SD, <code>title.db</code> and <code>import.db</code>. For NAND, <code>title.db</code>, <code>import.db</code>, <code>tmp_t.db</code>, <code>tmp_i.db</code>, and <code>jumpid.db</code>.
| No
| No
| Yes
| Yes
|
|-
| 0x2345678D
| Used internally to access non-title /dbs files on the NAND: <code>certs.db</code> and <code>ticket.db</code>.
| No
| No
| Yes
| No
|
|-
| 0x2345678E
| FSPXI: Program Access (limited subset of merged main title + update/patch title access). For fs:LDR(used by the "loader" FIRM ARM11-process), only <code>exefs:/.code</code>. Not accessible with fs:USER.
| Yes
| Yes
| No
| Yes
| None, see description.
|-
| 0x567890AB
| NAND CTR FS
| No
| Yes
| No
| No
| ?
|-
| 0x567890AC
| TWL PHOTO
| Yes
| Yes
| No
| No
| ?
|-
| 0x567890AD
| TWLS (DSi Sound stores recordings here). This is mapped to the FAT12 image stored in the file at [[Twln/shared2/0000]].
| No
| Yes
| No
| No
| ?
|-
| 0x567890AE
| NAND TWL FS
| Yes
| Yes
| No
| No
| 0x100
|-
| 0x567890AF
| NAND W FS
| Yes
| Yes
| No
| No
| 0x100
|-
| 0x567890B0
| Internally creates the same "ID Storage" wrapper over the NAND that is used for SystemSaveData and Shared ExtData, but all operations are stubbed and return 0xE0C046F8.
| No
| Yes
| No
| No
|
|-
| 0x567890B1
| Gamecard SaveData (for check). This is a wrapper for UserSaveDataForCheck: the OpenArchive code for that is called with archive-lowpath TID=0/mediatype=2(gamecard).
| Yes
| No
| No
| No
| 0x6
|-
| 0x567890B2
| UserSaveData (for check). This is the same as the regular SaveData archive, except with this the savedata ID and mediatype is loaded from the input archive lowpath.
| Yes
| No
| No
| Yes
| 0x6
|-
| 0x567890B3
| [[3DS_Virtual_Console#NAND_Savegame|AGB Save Data]]
| No
| No
| Yes
| No
| -
|-
| 0x567890B4
| Similar to 0x567890B2 but can only access Accessible Save specified in [[NCCH/Extended_Header#Storage_Info|exheader]]?
| Yes
| No
| No
| Yes
| ?
|}

Archives listed as not requiring a binary lowpath, use lowpath type [[FS:OpenFile|empty]].

The above permission bitmasks are from v2.x, see the above Services section for how these are handled.

Archives CTR NAND, NAND RO Write FS, TWL NAND, NAND W FS, and CARD SPI FS require the corresponding process exheader access control mount flag to be set, in the exheader for any of the currently running ARM11 processes, for [[Filesystem_services_PXI|FSPXI]]. The access rights checked by [[Filesystem services|FS]] module for archive mounting with fs:USER, are stored in the process' exheader accessinfo.

The CARDSPI archive allows access to the gamecard CARD1 raw savedata flash(aka "cardspi:/" in [[FIRM|Process9]]), the file lowpath must be WCHAR "/". The "NAND W FS" archive allows access to the raw NAND image(aka "wnand:/" in Process9), the file lowpath must be WCHAR "/".

= Filenames and Paths =
{{Anchor|PathType}} PathType:
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| -1
| Returned internally by Process9, when errors occur it seems(in particular when no nul-terminator was found in the input path). The data ptr is set to NULL.
|-
| 0x0
| INVALID - Specifies an invalid path
|-
| 0x1
| EMPTY - Specifies an empty path
|-
| 0x2
| BINARY - Non-text based path. Meaning is per-archive
|-
| 0x3
| ASCII - Text-based path with 7-bit ASCII characters padded to 8-bits each (signed char)
|-
| 0x4
| UTF16 - Text-based path with UTF-16 characters
|}

In IPC requests, sizes of ASCII and UTF16 paths must include space for the null-terminator.

== Binary LowPath ==
The format of the data that a binary LowPath points to is custom per archive.

=== SystemSaveData / Extdata / Shared Extdata Archive Path Data Format ===

==== DataAccessPath ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8 [[Mediatypes|Mediatype]]
|-
| 0x1 || 0x1 || only for NAND data (System Savedata / Shared Extdata), otherwise left 0:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || Accesses from/to <code>nand:/data/<ID0 of current system></code>
|-
| 1 || Accesses from/to <code>nand:/fixdata</code>
|-
| 2 || Accesses from/to <code>nand:/data/<ID0 from [[Filesystem_services#DeviceMoveContext|Device Move Context]]></code>
|}
|-
| 0x2 || 0x2 || padding
|}

==== SystemSaveData ====

===== FS =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 1
| save ID low (save ID high is 0)
|}

====== File Path ======
The file path is a cleartext ASCII or UTF16 file path (<code><file path></code>).

The file path would access the file at <code><base path>/sysdata/<save ID low>/<save ID high>/<file path></code>.
Note that <code>/<file path></code> refers to the virtual file system inside the </code><save ID high></code> file.

===== FSPXI / FS System Savedata Transfer / FSPXI System Savedata Transfer =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|}

====== File Path ======
{| class="wikitable" border="1"
|-
! Index word !! Description
|-
| 0 || save ID low
|-
| 1 || save ID high
|}

The file path would access the file at <code><base path>/sysdata/<save ID low>/<save ID high></code>.

==== Extdata / Shared Extdata ====

===== FS / FS Extdata Transfer / FSPXI Extdata Transfer =====

====== Archive Path ======
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 1
| ext save ID low
|-
| 2
| ext save ID high
|}

This refers to the extdata filesystem structure's base directory at <code><base path>/extdata/<ext save ID low>/<ext save ID high></code>.

====== File Path ======
The file path is a cleartext ASCII or UTF16 file path (<code><file path></code>).

For FS Extdata, this would acccess <code><base path>/extdata/<save ID low>/<save ID high>/<directory ID>/<file ID>/<file path></code>, and <code>/<file path></code> refers to the virtual file system inside the </code><file ID></code> file.

For FS / FSPXI Extdata Transfer, this accesses <code><base path>/extdata/<save ID low>/<save ID high>/<file path></code>.

=== UserSaveDataForCheck Archive Path Data Format ===
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Mediatypes|Mediatype]] (must be non-zero)
|-
| 1
| Lower word saveid
|-
| 2
| Upper word saveid
|}

The file/directory lowpath for this FS archive is a text path in the [[Savegames|savegame]] filesystem.

=== 0x567890B4 Archive Path Data Format ===
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| [[Mediatypes|Mediatype]]
|-
| 1
| <code><nowiki>Lower_word_saveid >> 8</nowiki></code> ?
|-
| 2
| Unknown. Game calculate this using formula <code><nowiki>0xFFFFFF00 | unknown_b</nowiki></code>
|}

=== Title Access Archive Path Data Format ===
==== Title Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || High-level NCCH content access
|-
| 1 || Save data access (high-level, decrypted)
|-
| 2 || Raw content (low-level NCCH/SRL) access
|-
| 3 || Banner save data access (for DSiWare titles)
|-
| 4 || FS only: Save data transfer (internally uses generated data from [[FS:BeginSaveDataMove]] as the IV for "Save data access (low-level, encrypted)")
|-
| 5 || Save data access (low-level, encrypted)
|}

==== NCCH Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || RomFS
|-
| 1 || <code>exefs:/.code</code>
|-
| 2 || System Menu Data (<code>exefs:/icon</code>, <code>exefs:/banner</code>, <code>exefs:/logo</code>)
|-
| 3 || NCCH Header(s)
|-
| 4 || "is seeded" check
|-
| 5 || Seed verify/validate
|}

==== NCCH Header Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || [[NCCH/Extended_Header|Extheader]] (0x0-0x400)
|-
| 1 || [[NCCH/Extended_Header|Extheader]] AccessDesc (0x400-0x800)
|-
| 2 || Raw [[NCCH#NCCH_Header|NCCH Header]]
|}

==== Archive Path ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || Program ID (Title ID)
|-
| 0xB || 0x1 || [[Mediatypes|Media Type]]
|-
| 0xC || 0x4 || padding
|}

==== File Path ====

{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || [[Filesystem_services#Title_Access_Type|Title Access Type]]
|-
| 0x4 || 0x10 || Dynamic data depending on [[Filesystem_services#Title_Access_Type|Title Access Type]]:

{| class="wikitable" border="1"
|-
! High Level NCCH Access !! Save Data Access (high level) !! Raw Content !! FS only: Save Data Transfer
|-
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Content index from TMD for NAND/SD titles
NCSD partition index for gamecards
|-
| 0x4 || 0x4 || [[Filesystem_services#NCCH_Access_Type|NCCH Access Type]]
|-
| 0x8 || 0x8 || Dynamic data depending on [[Filesystem_services#NCCH_Access_Type|NCCH Access Type]]:
For ExeFS, (System Menu Data / <code>exefs:/.code</code>),

{| class="wikitable" border="1"
| 8-byte ExeFS file name
|}

For Header Access,

{| class="wikitable" border="1"
| [[Filesystem_services#NCCH_Header_Access_Type|u64, NCCH Header Access Type]]
|}

For RomFS,

{| class="wikitable" border="1"
| [[NCCH#Content_Types|u64, Allowed content types flag]]
(<code>(1 << allowed_type_a) |

(1 << allowed_type_b)...</code>)
|}

|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x10 || 16-byte IV for save data crypto
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Content index from TMD for NAND/SD titles
NCSD partition index for gamecards
|-
| 0x4 || 0xC || padding
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Save data transfer key from [[FS:BeginSaveDataMove]]
|-
| 0x4 || 0xC || padding
|}
|}
|-
| 0x14 || 0x10 || 16-byte seed for titles that require one, or for validating a seed against the check value in the [[NCCH#NCCH_Header|NCCH Header]]'s check value.
If the title does not use a seed, this should not be included and size 0x14 should be used instead of 0x24.
|}

For encrypted save data access and banner save data access, the entire 0x10 portion of the dynamic data is left blank.

The "is seeded check" NCCH access type opens a virtual 1-byte file that reads either 0 or 1; this value is generated on-the-fly and will be 1 if ncchflags[7] has bit5 set (content uses seed), and 0 otherwise.

For NCCH sections that require a seed (e.g. <code>.code</code>, RomFS, etc.), the additional seed portion of the low path must be populated with the correct seed.

The "Seed Verify/Validate" NCCH access type also requires the seed portion of the lowpath. The target NCCH content is opened (with the opened file interface being stubbed, meaning no real reads/writes can be performed on it), and the given seed is used to calculate the seed check hash, and part of it is compared to the check value in the NCCH header. If it matches, opening the "file" succeeds, otherwise 0xD900458C is returned. If attempt is made to use the seed validation type on a content that does not use a seed, error 0xC92044E6 is returned.

==== FS Limitations ====

For FS, this archive functions the same, except for the following limitations:

- Only the title access types "High Level NCCH Access" and "High Level Save Data Access", and "Save Data Transfer" are allowed.

- For high level NCCH access, the types "RomFS", "System Menu Data", "Seeded check", and "Seed Check/Verify" are allowed.

- For "Seed Check/Verify", rather than providing the title seed in the file path (as is the case for FSPXI), the seed is retrieved from the seed database (meaning the file lowpath size is always 0x14 for FS).

=== Program Access / SelfNCCH access ===

Provides access to a "merged" archive of a base title and, optionally, a separate update (patch) title.

If no patch title exists, the base title is considered to be the patch title, i.e. turning all "patch" accesses into accesses to the base title.

==== Program Access Type ====
{| class="wikitable" border="1"
|-
! Value !! Description !! Accesses
|-
| 0 || RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default) || Base title
|-
| 1 || <code>exefs:/.code</code> || Patch title
|-
| 2 || System Menu Data (<code>exefs:/icon</code>, <code>exefs:/banner</code>, <code>exefs:/logo</code>) || Base title
|-
| 3 || Save Data (high level, decrypted) || -
|-
| 4 || RomFS (all [[NCCH#Content_Type|content types]]) || Base title
|-
| 5 || RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default) || Patch title
|}

==== Archive Path ====
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || u64, Program Handle from [[PXIPM:RegisterProgram]]
|}

==== File Path ====
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || [[Filesystem_services#Program_Access_Type|Program Access Type]]
|-
| 0x4 || 0x8 || Dynamic data depending on [[Filesystem_services#Program_Access_Type|Program Access Type]]:
{| class="wikitable" border="1"
|-
! ExeFS files (System Menu Data, etc.) !! RomFS of base title (all [[NCCH#Content_Type|content types]])
|-
|
{| class="wikitable" border="1"
| 8-character ExeFS filename
|}
|
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, content index of target content
|-
| 0x4 || 0x4 || padding
|}
|}
|}

==== FS Limitations ====

- FSPXI allows all access types.

- When used through fs:LDR by loader, FS only provides access to <code>exefs:/.code</code>.

- For SelfNCCH access, the only allowed access types are "RomFS ("unspecified" [[NCCH#Content_Type|content type]], the default)" of the Base or Patch title, and "System Menu Data". Attempting to access "Save Data" results in error 0xE0E046BE, "RomFS (all [[NCCH#Content_Type|content types]])" in 0xF9604784, and "<code>exefs:/.code</code>" in 0xD9004676.

=== [[RomFS]] ===

Archives 0x3 and 0x2345678E both allow for accessing the [[RomFS#Level_3_Format|level-3 IVFC images]] for RomFS access. The main CXI RomFS is accessible via an all-zero 0xc-byte binary file-lowpath. The update RomFS can be accessed with the first u32 in the binary file-lowpath being set to 0x5. The user must handle parsing the filesystem used in the exposed image itself.

With FSPXI the returned data for RomFS is the entire RomFS section from the NCCH, starting at the IVFC header.

The 0x3 archive is an interface for the 0x2345678E archive with the current process programID+mediatype. The file lowpath is 3-words. These words are written to 0x2345678E-archive file_lowpath+0, with the rest of that lowpath set to all-zero(lowpath is different from archive 0x2345678A). File lowpath:
{| class="wikitable" border="1"
|-
! Index word
! Description
|-
| 0
| See above. The only values which FS-module doesn't allow to be used here are:
* 0x1: Error 0xE0E046BE.
* 0x3: Error 0xE0E046BE.
* 0x4: FS-module executes svcBreak when using this.
|-
| 1-2
| See above. Not validated by FS-module.
|}

=Anti Savegame Restore=
Anti Savegame Restore, internally referred to as ''Save Data Rollback Prevention'', is a feature originally implemented in the FS module with [[4.0.0-7]], which prevents the user from restoring previous versions of a savegame image. This feature is not used (in practice) for gamecard games. When an old version of the save is detected, the application will display an error regarding old savegame version, then delete and recreate the save data (similar to when it is corrupted).

==Implementation==
When creating the savedata, the application generates a secure value (a 64 bit unsigned integer), then stores it in either the [[DISA_and_DIFF#DISA_header|DISA save image header]] or the [[Filesystem_services#Anti_Savegame_Restore_Save_Data|Anti Savegame Restore Save Data]]. The application then uses the anti-savegame-restore commands ([[FS:SetSaveDataSecureValue]], [[FS:GetSaveDataSecureValue]], [[FS:SetOtherSaveDataSecureValue]], [[FS:GetOtherSaveDataSecureValue]], [[FS:SetThisSaveDataSecureValue]], [[FS:GetThisSaveDataSecureValue]], [[FS:SetSaveArchiveSecureValue]] and [[FS:GetSaveArchiveSecureValue]]) to verify the value known to the game for comparison with the value returned by FS, and to update the value in the corresponding storage location.

Each time the application writes to the savegame, the value should be updated by both the application and through FS. Usually, applications update this value by incrementing it. However, generating a new random-number or other methods of updating it can be used as well.

==Anti Savegame Restore Save Data==
The save data used for this feature is stored in [[System_SaveData|System Save Data]] ID 0x00010011 and contains only one file, named <code>DB</code>:

===SecureValueKey===
Depending on which command is used, secure value keys can be interpreted as:
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x8 || u64, Title ID
|}
or:
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, [[Filesystem_services#SecureValueSlot|Secure Value Slot]]
|-
| 0x4 || 0x4 || u32, Unique ID
|}

===Main Structure===
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1000 || Header
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x1 || u8, version (usually 0)
|-
| 0x1 || 0x3 || padding
|-
| 0x4 || 0x4 || u32, number of secure value entries
|-
| 0x8 || 0xFF8 || completely unused, padding
|}
|-
| 0x1000 || 0x1C000 (8 * 14336) || [[Filesystem_services#SecureValueKey|Secure value keys]]
|-
| 0x1D000 || 0x1C000 (8 * 14336) || u64s, Secure values
|}

==Applications using this feature==
* Animal Crossing: New Leaf
* Pokemon X & Y
* Pokemon Omega Ruby & Alpha Sapphire
* Pokemon Omega Ruby & Alpha Sapphire Demo
* Pokemon Shuffle
* Super Smash Bros
* Pokemon Red,Blue and Yellow (GB(C) VC)
* Rusty's Real Deal Baseball
* Megami Meguri

=SEEDDB=
With [[9.6.0-24|9.6.0-X]] new [[System_SaveData]] with saveID 0001000F was added, this seems to be handled by FS-module itself, probably via the new service-cmds added to fsuser. [[Home Menu]] and [[NIM_Services|NIM]] module have access to those commands.

The SEEDDB savedata contains the title-unique seed-data used for the new [[NCCH]] keyY generation added with FIRM [[9.6.0-24|9.6.0-X]].

= Common Types =
== MediaType ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0
| NAND
|-
| 1
| SD
|-
| 2
| Game Card
|}

== SystemMediaType ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0
| CTR NAND
|-
| 1
| TWL NAND
|-
| 2
| SD
|-
| 3
| TWL Photo
|}

== OpenFlags ==
{| class="wikitable" border="1"
|-
! Bit
! Description
|-
| 0
| Read
|-
| 1
| Write
|-
| 2
| Create
|}

== Attributes ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| Is Directory
|-
| 0x1
| 0x1
| Is Hidden
|-
| 0x2
| 0x1
| Is Archive
|-
| 0x3
| 0x1
| Is Read-Only
|}

== WriteOption ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x1
| Flush
|-
| 0x1
| 0x1
| Update Time Stamp
|-
| 0x2
| 0x1
| Reserved
|-
| 0x3
| 0x1
| Reserved
|}

== DirectoryEntry ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x20C
| UTF-16 Entry Name
|-
| 0x20C
| 0xA
| 8.3 short filename name
|-
| 0x216
| 0x4
| 8.3 short filename extension
|-
| 0x21A
| 0x1
| Always 1
|-
| 0x21B
| 0x1
| Reserved
|-
| 0x21C
| 0x4
| [[Filesystem_services#Attributes|Attributes]]
|-
| 0x220
| 0x8
| Entry Size
|}

== ArchiveResource ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| Sector byte-size
|-
| 0x4
| 0x4
| Cluster byte-size
|-
| 0x8
| 0x4
| Partition capacity in clusters
|-
| 0xC
| 0x4
| Available free space in clusters
|}

== ProgramInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x8
| Program ID
|-
| 0x8
| 0x1
| [[Filesystem_services#MediaType|Media Type]]
|-
| 0x9
| 0x7
| Padding
|}

== ProductInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| Product Code
|-
| 0x10
| 0x2
| Company Code
|-
| 0x12
| 0x2
| Remaster Version
|}

== IntegrityVerificationSeed ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| AES-CBC MAC over a SHA256 hash, which hashes the first 0x110-bytes of the cleartext SEED.
|-
| 0x10
| 0x120
| The [[nand/private/movable.sed]], encrypted with AES-CBC using the above MAC for the counter.
|}

== ExtSaveDataInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 0x4
| 0x8
| Save ID
|-
| 0xC
| 0x4
| Reserved
|}

== SystemSaveDataInfo ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x4
| [[Filesystem_services#DataAccessPath|DataAccessPath]]
|-
| 0x4
| 0x4
| Save ID
|}

== SecureValueSlot ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x1000
| SD Application
|}

== SecureValueEntry ==
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || u32, [[Filesystem_services#SecureValueSlot|Secure Value Slot]]
|-
| 0x4 || 0x1 || When used as an input entry:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || This entry should be removed.
|-
| 1 || This entry should be updated with the given value.
|}
When returned from a command:
{| class="wikitable" border="1"
|-
! Value !! Description
|-
| 0 || No entry with the given slot and title ID was found, or: this entry is unused.
|-
| 1 || The entry with the given slot and title ID was found, or: this entry is used.
|}
|-
| 0x5 || 0x3 || padding
|-
| 0x8 || 0x8 || u64, Secure Value
|}

== TitleTag ==
{| class="wikitable" border="1"
|-
! Offset !! Size !! Description
|-
| 0x0 || 0x4 || Magic, <code>PREP</code> (PREPurchase install)
|-
| 0x4 || 0x4 || s32, Release date year
|-
| 0x8 || 0x1 || u8, Release date month
|-
| 0x9 || 0x1 || u8, Release date day
|-
| 0xA || 0x2 || u16, Country code
|-
| 0xC || 0x4 || u32, Seed status (0: not downloaded yet, 1: last download attempt failed, 2: seed installed successfully)
|-
| 0x10 || 0x4 || Result code from last seed installation attempt
|-
| 0x14 || 0x4 || Support error code from last seed installation attempt
|-
| 0x18 || 0x68 || reserved padding (unused)
|}

== CardSpiBaudRate ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x0
| 512KHz
|-
| 0x1
| 1MHz
|-
| 0x2
| 2MHz
|-
| 0x3
| 4MHz
|-
| 0x4
| 8MHz
|-
| 0x5
| 16MHz
|}

== CardSpiBusMode ==
{| class="wikitable" border="1"
|-
! Value
! Description
|-
| 0x0
| 1-bit
|-
| 0x1
| 4-bit
|}

== SpecialContentType ==
{| class="wikitable" border="1"
|-
! Value
! Description
! Found in
|-
| 0x1
| CTR (Old3DS) Update Partition
| Gamecards
|-
| 0x2
| Manual
| Gamecards, Digital titles
|-
| 0x3
| DLP Child
| Gamecards, Digital titles
|-
| 0x4
| KTR (New3DS) Update Partition
| Gamecards
|-
|}

== DeviceMoveContext ==
{| class="wikitable" border="1"
|-
! Offset
! Size
! Description
|-
| 0x0
| 0x10
| IVs (ID0 of source console)
|-
| 0x10
| 0x10
| Encrypt Parameter (used to calculate the IV for encryption)
|}

=Errors=
See [[Filesystem_services_PXI]].

[[Category:Services]]

System SaveData

2025-07-01T09:41:13Z

TimmSkiller: /* System Module Savegames */

Savegames stored in NAND are located at [[Flash_Filesystem|nand:/data/<ID0>/sysdata/<SaveID-Low>/<SaveID-High>]], where SaveID-High is the filename. SaveID-High is normally 00000000.

Access to system savedata via [[Filesystem_services|fs:USER]] is determined by the [[NCCH#CXI|exheader_storageinfo]] accessinfo and systemsavedataid. Most ARM11 processes using fs:USER only have access to the SaveIDs specified by systemsavedataid, when a certain accessinfo bit is set the process can access all system-savedata however. The 8-byte systemsavedataid is two SaveID-Low words which the process has access to, normally only the first word is used. When the process doesn't have access to any system-savedata via systemsavedataid, systemsavedataid is all-zero.

=NAND Savegames=
The SaveID for system modules is usually 0x00010000 | [[Titles|uniqueID]]. The SaveID for other system processes (like applications) is 0x00020000 | [[Titles|uniqueID]].

==System Module Savegames==
{| class="wikitable" border="1"
|-
! SaveID
! Description
|-
| 0x0001000F
| [[Filesystem_services|FS]] module savedata, used for [[Filesystem_services#SEEDDB|SEEDDB]] and [[Filesystem_services#TITLETAG|TITLETAG]] storage.
|-
| 0x00010011
| [[Filesystem_services|FS]] module savedata, used for [[Filesystem_services#Anti_Savegame_Restore|Anti Savegame Restore]].
|-
| 0x00010015
| [[Application_Manager_Services|AM]] module savedata
|-
| 0x00010017
| [[Config Savegame]]
|-
| 0x00010022
| [[PTM]] [[PTM_Savegame|savegame]]
|-
| 0x00010026
| [[StreetPass|CECD]] savegame
|-
| 0x0001002C
| [[NIM_Services|NIM]] savegame
|-
| 0x00010032
| [[FRD_Savegame|Friends module savegame]]
|-
| 0x00010034
| [[SpotPass|BOSS]] module [[BOSS Savegame|savegame]]
|-
| 0x00010035
| News module savegame
|-
| 0x00010038
| Act module savegame
|-
| 0x00010040
| [[NFC_Services|NFC]] module savegame
|}

==System application and applet savegames==
{| class="wikitable" border="1"
|-
! JPN SaveID
! USA SaveID
! EUR SaveID
! Description
|-
| 0x000200C5
| Same as JPN
| Same as JPN
| "error" applet savegame
|-
| 0x00020082
| 0x0002008F
| 0x00020098
| [[Home Menu]] savegame
|-
| 0x00020086
| 0x00020092
| 0x0002009B
| Instruction Manual applet savegame
|-
| 0x00020087
| 0x00020093
| 0x0002009C
| Game Notes applet savegame
|-
| 0x00020088
| 0x00020094
| 0x0002009D
| Old3DS/New3DS [[Internet Browser]] savegame
|-
| 0x0002008D
| 0x00020096
| 0x0002009F
| Friend List applet savegame
|-
| 0x000200BB
| Same as JPN
| Same as JPN
| Additional savedata for the New3DS [[Internet Browser]]. This only contains "t.bin" with filesize 0xadf80. This contains all browser history: each entry has the URL, UTF-16 title string, and icon gfx. This includes old pages which are not currently open in the browser as tabs?
|-
| 0x000200BC
| 0x000200BD
| 0x000200BE
| olv applet savegame (Miiverse)
|-
| 0x000200C6
| Same as JPN
| Same as JPN
| mint applet savegame
|-
| 0x00020200
| 0x00020210
| 0x00020220
| [[System Settings]] savegame
|-
| 0x00020202
| 0x00020212
| 0x00020222
| [[Activity Log]] application savegame
|-
| 0x00020204
| 0x00020214
| 0x00020224
| [[Nintendo 3DS Camera]] application savegame
|-
| 0x00020205
| 0x00020215
| 0x00020225
| [[Nintendo 3DS Sound]] application savegame
|-
| 0x00020207
| 0x00020217
| 0x00020227
| [[Mii Maker]] application savegame
|-
| 0x00020208
| 0x00020218
| 0x00020228
| [[StreetPass Mii Plaza]] application savegame
|-
| 0x00020209
| 0x00020219
| 0x00020229
| [[eShop]] application savegame
|-
| 0x0002020A
| 0x0002021A
| 0x0002022A
| [[System Transfer]] savegame
|-
| 0x0002020B
| 0x0002021B
| 0x0002022B
| [[Nintendo Zone]] savegame
|-
| 0x0002020D
| 0x0002021D
| 0x0002022D
| [[Face Raiders]] savegame
|-
| 0x0002020E
| 0x0002021E
| 0x0002022E
| [[AR Games]] savegame
|-
| 0x000202BF
| 0x000202C0
| 0x000202C1
| act (NNID settings) application savegame
|-
| 0x00020231
| 0x00020241
| 0x00020251
| [[microSD Management]] application savegame
|}

System SaveData

2025-07-01T09:40:50Z

TimmSkiller: add table entry for 0x0001000F

Savegames stored in NAND are located at [[Flash_Filesystem|nand:/data/<ID0>/sysdata/<SaveID-Low>/<SaveID-High>]], where SaveID-High is the filename. SaveID-High is normally 00000000.

Access to system savedata via [[Filesystem_services|fs:USER]] is determined by the [[NCCH#CXI|exheader_storageinfo]] accessinfo and systemsavedataid. Most ARM11 processes using fs:USER only have access to the SaveIDs specified by systemsavedataid, when a certain accessinfo bit is set the process can access all system-savedata however. The 8-byte systemsavedataid is two SaveID-Low words which the process has access to, normally only the first word is used. When the process doesn't have access to any system-savedata via systemsavedataid, systemsavedataid is all-zero.

=NAND Savegames=
The SaveID for system modules is usually 0x00010000 | [[Titles|uniqueID]]. The SaveID for other system processes (like applications) is 0x00020000 | [[Titles|uniqueID]].

==System Module Savegames==
{| class="wikitable" border="1"
|-
! SaveID
! Description
|-
| 0x0001000F
| [[Filesystem_services|FS]] module savedata, used for [[Filesystem_services#SEEDDB|SEEDDB]] and [[Filesystem_services#TITLETAG|TITLETAG]] storage.
|-
| 0x00010011
| [[Filesystem_services|FS]] module savedata, used for [[Anti Savegame Restore]].
|-
| 0x00010015
| [[Application_Manager_Services|AM]] module savedata
|-
| 0x00010017
| [[Config Savegame]]
|-
| 0x00010022
| [[PTM]] [[PTM_Savegame|savegame]]
|-
| 0x00010026
| [[StreetPass|CECD]] savegame
|-
| 0x0001002C
| [[NIM_Services|NIM]] savegame
|-
| 0x00010032
| [[FRD_Savegame|Friends module savegame]]
|-
| 0x00010034
| [[SpotPass|BOSS]] module [[BOSS Savegame|savegame]]
|-
| 0x00010035
| News module savegame
|-
| 0x00010038
| Act module savegame
|-
| 0x00010040
| [[NFC_Services|NFC]] module savegame
|}

==System application and applet savegames==
{| class="wikitable" border="1"
|-
! JPN SaveID
! USA SaveID
! EUR SaveID
! Description
|-
| 0x000200C5
| Same as JPN
| Same as JPN
| "error" applet savegame
|-
| 0x00020082
| 0x0002008F
| 0x00020098
| [[Home Menu]] savegame
|-
| 0x00020086
| 0x00020092
| 0x0002009B
| Instruction Manual applet savegame
|-
| 0x00020087
| 0x00020093
| 0x0002009C
| Game Notes applet savegame
|-
| 0x00020088
| 0x00020094
| 0x0002009D
| Old3DS/New3DS [[Internet Browser]] savegame
|-
| 0x0002008D
| 0x00020096
| 0x0002009F
| Friend List applet savegame
|-
| 0x000200BB
| Same as JPN
| Same as JPN
| Additional savedata for the New3DS [[Internet Browser]]. This only contains "t.bin" with filesize 0xadf80. This contains all browser history: each entry has the URL, UTF-16 title string, and icon gfx. This includes old pages which are not currently open in the browser as tabs?
|-
| 0x000200BC
| 0x000200BD
| 0x000200BE
| olv applet savegame (Miiverse)
|-
| 0x000200C6
| Same as JPN
| Same as JPN
| mint applet savegame
|-
| 0x00020200
| 0x00020210
| 0x00020220
| [[System Settings]] savegame
|-
| 0x00020202
| 0x00020212
| 0x00020222
| [[Activity Log]] application savegame
|-
| 0x00020204
| 0x00020214
| 0x00020224
| [[Nintendo 3DS Camera]] application savegame
|-
| 0x00020205
| 0x00020215
| 0x00020225
| [[Nintendo 3DS Sound]] application savegame
|-
| 0x00020207
| 0x00020217
| 0x00020227
| [[Mii Maker]] application savegame
|-
| 0x00020208
| 0x00020218
| 0x00020228
| [[StreetPass Mii Plaza]] application savegame
|-
| 0x00020209
| 0x00020219
| 0x00020229
| [[eShop]] application savegame
|-
| 0x0002020A
| 0x0002021A
| 0x0002022A
| [[System Transfer]] savegame
|-
| 0x0002020B
| 0x0002021B
| 0x0002022B
| [[Nintendo Zone]] savegame
|-
| 0x0002020D
| 0x0002021D
| 0x0002022D
| [[Face Raiders]] savegame
|-
| 0x0002020E
| 0x0002021E
| 0x0002022E
| [[AR Games]] savegame
|-
| 0x000202BF
| 0x000202C0
| 0x000202C1
| act (NNID settings) application savegame
|-
| 0x00020231
| 0x00020241
| 0x00020251
| [[microSD Management]] application savegame
|}

FS:GetSaveArchiveSecureValue

2025-07-01T09:28:27Z

TimmSkiller:

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x876|3|0}}
{{IPC/RequestEntryRange|2|u64, Save data [[Filesystem_services#Archives|Archive]] handle}}
{{IPC/RequestEntry|u32, [[Filesystem_services#SecureValueSlot|Secure Value Slot]]}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x876|5|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEntry|bool, secure value found}}
{{IPC/RequestEntry|bool, corresponding save archive is from a gamecart (set regardless of whether or not the secure value was found)}}
{{IPC/RequestEntryRange|2|u64, Secure value}}
{{IPC/RequestEnd}}

=Description=
This command is identical to [[FS:GetOtherSaveDataSecureValue]], but instead of specifying the title ID and mediatype manually, these parameters are retrieved through the given save data archive handle using internal state data.

FS:SetSaveArchiveSecureValue

2025-07-01T09:28:19Z

TimmSkiller:

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x875|5|0}}
{{IPC/RequestEntryRange|2|u64, Save data [[Filesystem_services#Archives|Archive]] handle}}
{{IPC/RequestEntry|u32, [[Filesystem_services#SecureValueSlot|Secure Value Slot]]}}
{{IPC/RequestEntryRange|2|u64, Secure value}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x875|1|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEnd}}

=Description=
This command is identical to [[FS:SetOtherSaveDataSecureValue]], but instead of specifying the title ID and mediatype manually, these parameters are retrieved through the given save data archive handle using internal state data.

FS:GetThisSaveDataSecureValue

2025-07-01T09:16:29Z

TimmSkiller:

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x86F|1|0}}
{{IPC/RequestEntry|u32, [[Filesystem_services#SecureValueSlot|Secure Value Slot]]}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x86F|5|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEntry|bool, whether or not the secure value was found}}
{{IPC/RequestEntry|bool, whether or not the title is from a gamecart (regardless of whether or not the secure value was found)}}
{{IPC/RequestEntryRange|2|u64, Secure value}}

{{IPC/RequestEnd}}

=Description=
Gets the secure value of the title corresponding to the current session.

If the caller process is on a game card, the secure value is read from the [[DISA_and_DIFF#DISA_header|DISA save image]]'s header.
Otherwise, the secure value is read from the [[Filesystem_services#Anti_Savegame_Restore|Anti Savegame Restore]] save data.

FS:SetThisSaveDataSecureValue

2025-07-01T09:16:02Z

TimmSkiller:

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x86E|3|0}}
{{IPC/RequestEntry|u32, [[Filesystem_services#SecureValueSlot|Secure Value Slot]]}}
{{IPC/RequestEntryRange|2|u64, value}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x86E|1|0}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEnd}}

=Description=
Sets the secure value of the title corresponding to the current session.

If the caller process is on a game card, the secure value is written to the [[DISA_and_DIFF#DISA_header|DISA save image]]'s header.
Otherwise, the secure value is written to the [[Filesystem_services#Anti_Savegame_Restore|Anti Savegame Restore]] save data.

FS:GetSaveDataSecureValue

2025-07-01T09:12:53Z

TimmSkiller:

=Request=
{| class="wikitable" border="1"
|-
! Index Word
! Description
|-
| 0
| Header code [0x086600C0]
|-
| 1
| [[Filesystem_services#SecureValueSlot|Secure Value Slot]]
|-
| 2
| Title Unique ID (0 = current)
|-
| 3
| u8, Title Variation (0 = current)
|}

=Response=
{| class="wikitable" border="1"
|-
! Index Word
! Description
|-
| 0
| Header code
|-
| 1
| Result code
|-
| 2
| u8, 0 = doesn't exist, 1 = exists
|-
| 3-4
| u64, Value
|}

=Description=
Gets the secure value for a specific title (or current title) in the specified slot. This command will read from the [[Filesystem_services#Anti_Savegame_Restore|Anti Savegame Restore]] save data.

If appropriate FS permissions are not set in the caller processes' exheader, this command will only run if the save data ID for the specified title is present in the exheader.

FS:SetSaveDataSecureValue

2025-07-01T09:12:45Z

TimmSkiller:

=Request=
{| class="wikitable" border="1"
|-
! Index Word
! Description
|-
| 0
| Header code [0x08650140]
|-
| 1-2
| u64, Value
|-
| 3
| [[Filesystem_services#SecureValueSlot|Secure Value Slot]]
|-
| 4
| Title Unique ID (0 = current)
|-
| 5
| u8, Title Variation (0 = current)
|}

=Response=
{| class="wikitable" border="1"
|-
! Index Word
! Description
|-
| 0
| Header code
|-
| 1
| Result code
|}

=Description=
Sets the secure value for a specified title (or the current title) in the specified slot. This command will write to the [[Filesystem_services#Anti_Savegame_Restore|Anti Savegame Restore]] save data.

If appropriate FS permissions are not set in the caller processes' exheader, this command will only run if the save data ID for the specified title is present in the exheader.

FS:GetOtherSaveDataSecureValue

2025-07-01T09:09:03Z

TimmSkiller:

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x86C|3|2}}
{{IPC/RequestEntry|u8, [[Filesystem_services#MediaType|Media Type]]}}
{{IPC/RequestEntry|u32, Unique ID}}
{{IPC/RequestEntry|u32, Entry count}}
{{IPC/MapPointerW|Output [[Filesystem_services#SecureValueEntry|SecureValueEntry]] buffer pointer}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x086C|2|2}}
{{IPC/RequestEntry|Result code}}
{{IPC/RequestEntry|u32, Number of read entries}}
{{IPC/MapPointerW|Output [[Filesystem_services#SecureValueEntry|SecureValueEntry]] buffer pointer}}
{{IPC/RequestEnd}}

=Description=
Queries the secure value(s) of another title.

This command will, by default, read from the secure value section of the [[DISA_and_DIFF#DISA_Header|DISA save image's header]].

However, it is possible to force this command to read from the [[Filesystem_services#Anti_Savegame_Restore|Anti Savegame Restore]] save data by specifying media type 100 (the meaning of this media type is unknown and is not used elsewhere in FS).

FS:SetOtherSaveDataSecureValue

2025-07-01T08:59:53Z

TimmSkiller:

=Request=
{{IPC/Request}}
{{IPC/RequestHeader|0x086B|3|2}}
{{IPC/RequestEntry|u8, [[Filesystem_services#MediaType|Media Type]]}}
{{IPC/RequestEntry|u32, Unique ID}}
{{IPC/RequestEntry|u32, Entry count}}
{{IPC/MapPointerR|Input [[Filesystem_services#SecureValueEntry|SecureValueEntry]] buffer pointer}}
{{IPC/RequestEnd}}

=Response=
{{IPC/Request}}
{{#vardefine:ipc_offset|0}}
{{IPC/RequestHeader|0x086B|1|2}}
{{IPC/RequestEntry|Result code}}
{{IPC/MapPointerR|Input [[Filesystem_services#SecureValueEntry|SecureValueEntry]] buffer pointer}}
{{IPC/RequestEnd}}

=Description=
Updates or removes the secure value(s) of another title.

This command will, by default, write to the secure value section of the [[DISA_and_DIFF#DISA_Header|DISA save image's header]].

However, it is possible to force this command to write to the [[Filesystem_services#Anti_Savegame_Restore|Anti Savegame Restore]] save data by specifying media type 100 (the meaning of this media type is unknown and is not used elsewhere in FS).

FS:GetSaveDataSecureValue

2025-07-01T08:55:45Z

TimmSkiller:

FS:SetSaveDataSecureValue

2025-07-01T08:54:32Z

TimmSkiller:

DISA and DIFF

2025-06-30T22:01:50Z

TimmSkiller: /* DISA Header structure */

This page describes DISA and DIFF format as the underlying container of [[Savegames]], [[Extdata]] and [[Title Database]]. For further format specification of the inner data, please refer to their own page.

All data in this page is little-endian. All "unused / padding" fields can contain uninitialized data unless otherwise specified.

== Overview ==

DISA and DIFF are two container formats. They are very similar and are used for various purposes in 3DS. Here is a summary table of their usage, the CMAC type and the AES key slot used (the meaning of these is explained in the next section):

{| class="wikitable" border="1"
! Usage
! Media
! Container format
! [[#AES CMAC|CMAC type]]
! CMAC [[AES Registers|Keyslot]]
|-
| [[Savegames]]
| Gamecard
| DISA
| [[#CTR-NOR0|CTR-NOR0]]
| 0x19 / 0x33
|-
| [[Savegames]]
| [[SD Filesystem|SD]]
| DISA
| [[#CTR-SIGN|CTR-SIGN]]
| 0x30
|-
| [[System SaveData]]
| [[Flash Filesystem|NAND]]
| DISA
| [[#CTR-SYS0|CTR-SYS0]]
| 0x30
|-
| [[Extdata|Private Extdata]]
| [[SD Filesystem|SD]]
| DIFF
| [[#CTR-EXT0|CTR-EXT0]]
| 0x30
|-
| [[Extdata|Shared Extdata]]
| [[Flash Filesystem|NAND]]
| DIFF
| [[#CTR-EXT0|CTR-EXT0]]
| 0x30
|-
| [[Title Database]]
| [[SD Filesystem|SD]]
| DIFF
| [[#CTR-9DB0|CTR-9DB0]]
| 0x30
|-
| [[Title Database]]
| [[Flash Filesystem|NAND]]
| DIFF
| [[#CTR-9DB0|CTR-9DB0]]
| 0x0B
|}

== Encryption ==

DISA and DIFF formats don't have their own encryption specification. They follow the encryption method defined by their media:

* Gamecard savegames have special wear leveling + encryption layers. See [[Savegames]] for detail.
* Files on SD follow [[SD Filesystem|the general SD filesystem encryption rule]].
* Files on NAND are in cleartext, after decrypting [[Flash Filesystem|the NAND partition encryption]].

== Format ==

A DISA / DIFF file consists of the following components:

* 0x100-byte AES CMAC
* 0x100-byte Header
* Secondary partition table
** Contains one or two partition descriptors, depending on the number of partitions.
* Primary partition table
** Same layout as the secondary one
* Partition A
* Partition B (optional)
** can only exist for DISA.

== AES CMAC ==

The AES CMAC is located at the beginning of the DISA / DIFF image, and it is 0x10 long. The rest 0xF0 bytes before the header are unused.

The key used for the AES CMAC is generated by the [[AES Registers|hardware key engine]]. See the keyslot it uses in the table above.

The data being authenticated by the AES CMAC is a 0x20-byte SHA-256 hash of a data block. The data block has different content formats among CMAC types. All types of data block contain a copy or a hash of the header, which is the start of the the rest of the verification chain, so the AES CMAC effectively authenticates the whole save image. Each type of data block is explained below.

=== CTR-NOR0 ===

This CMAC type is used for gamecard savegames. It is 0x28-byte long.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-NOR0"
|-
| 0x8
| 0x20
| SHA-256 of the following 0x108-byte block
{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-SAV0"
|-
| 0x08
| 0x100
| Copy of the DISA header
|}
|}

=== CTR-SIGN ===

This CMAC type is used for SD savegames. It is 0x30-byte long.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-SIGN"
|-
| 0x08
| 8
| Title ID
|-
| 0x10
| 0x20
| SHA-256 of the following 0x108-byte block
{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-SAV0"
|-
| 0x08
| 0x100
| Copy of the DISA header
|}
|}

=== CTR-SYS0 ===

This CMAC type is used for NAND system save. It is 0x110-byte long.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-SYS0"
|-
| 0x08
| 8
| Save ID. The higher word is always zero
|-
| 0x10
| 0x100
| Copy of the DISA header
|}

=== CTR-EXT0 ===

This CMAC type is used for extdata. It is 0x11C-byte long.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-EXT0"
|-
| 0x08
| 8
| Extdata ID
|-
| 0x10
| 4
| 0 for Quota.dat, 1 otherwise
|-
| 0x14
| 4
| ID in the device file name. 0 for Quota.dat
|-
| 0x18
| 4
| ID in the device directory name that the file is in. 0 for Quota.dat
|-
| 0x1C
| 0x100
| Copy of the DIFF header
|}

=== CTR-9DB0 ===

This CMAC type is used for title database. It is 0x10C-byte long.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-9DB0"
|-
| 0x08
| 4
| Database ID. Each .db file has its own ID
|-
| 0x0C
| 0x100
| Copy of the DIFF header
|}

== Header ==

The header located at offset 0x100 defines the rest components of the file (partitions and their tables). All offsets in the header are relative to the beginning of the DISA/DIFF file, except for partition descriptor offsets, which are relative to the beginning of the (active) partition table. DISA and DIFF have different header format.

=== DISA header ===

==== SaveDataSecureValue ====
{| class="wikitable" border="1"
|-
! Offset !! Length !! Description
|-
| 0x0 || 0x4 || u32, [[Anti_Savegame_Restore|Secure Value]] slot
|-
| 0x4 || 0x8 || u64, [[Anti_Savegame_Restore|Secure Value]]
|}

==== DISA Header structure ====
{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 4
| Magic "DISA"
|-
| 0x04
| 4
| Magic 0x40000
|-
| 0x08
| 4
| Partition count, 1 or 2
|-
| 0x0C
| 4
| Padding
|-
| 0x10
| 8
| Secondary partition table offset
|-
| 0x18
| 8
| Primary partition table offset
|-
| 0x20
| 8
| Partition table size
|-
| 0x28
| 8
| Partition A descriptor offset in the partition table
|-
| 0x30
| 8
| Partition A descriptor size
|-
| 0x38
| 8
| Partition B descriptor offset in the partition table
|-
| 0x40
| 8
| Partition B descriptor size
|-
| 0x48
| 8
| Partition A offset
|-
| 0x50
| 8
| Partition A size
|-
| 0x58
| 8
| Partition B offset
|-
| 0x60
| 8
| Partition B size
|-
| 0x68
| 1
| Active partition table, 0 = primary, 1 = secondary
|-
| 0x69
| 1
| Number of used [[Anti_Savegame_Restore|Save Data Secure Value]] entries in the DISA header
|-
| 0x6A
| 2
| Padding
|-
| 0x6C
| 0x20
| SHA-256 over the active partition table
|-
| 0x8C
| 0x30 (0xC * 0x4)
| [[DISA_and_DIFF#SaveDataSecureValue|Save Data Secure Value]] entries (4)
|-
| 0xBC
| 0x8
| Unused randomly generated u64 value.
|-
| 0xC4
| 0x3C
| Unused
|}

Note:

* When the partition count is 1, there is no partition B and all of its related fields are zero.

=== DIFF header ===

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 4
| Magic "DIFF"
|-
| 0x04
| 4
| Magic 0x30000
|-
| 0x08
| 8
| Secondary partition table/descriptor offset
|-
| 0x10
| 8
| Primary partition table/descriptor offset
|-
| 0x18
| 8
| Partition table/descriptor size
|-
| 0x20
| 8
| Partition (A) offset
|-
| 0x28
| 8
| Partition (A) size
|-
| 0x30
| 4
| Active partition descriptor, 0 = primary, 1 = secondary
|-
| 0x34
| 0x20
| SHA-256 over the active partition table/descriptor
|-
| 0x54
| 8
| Unique identifier
|-
| 0x5C
| 0xA4
| Unused, might contain leftover data
|}

Note:

* Since DIFF can only contain one partition, a partition table can only have one partition descriptor, so they become the same concept here.
* See [[Extdata]] for its usage of the unique identifier field. For title database files, this field is zero.

== Partition table & partition descriptor ==

There are two partition tables, but only one of them is active. When operating on a DISA / DIFF file, 3DS FS alternately activate one of the two tables, presumably for data backup or atomic file writing. A newly created DISA / DIFF file may have entirely uninitialized data in the inactive partition table.

One partition table contains one or two partition descriptors , each of which describes the layout of one partition. A partition descriptor contains the following components:

* DIFI header
* IVFC descriptor
* DPFS descriptor
* Partition master hash

=== DIFI header ===

The DIFI header locates at the beginning of a partition descriptor. This header defines the rest components of the partition descriptor (IVFC descriptor, DPFS descriptor and partition master hash). All offsets are relative to the beginning of the partition descriptor, except for <code>External IVFC level 4 offset</code>, which is relative to the beginning of the partition.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 4
| Magic "DIFI"
|-
| 0x04
| 4
| Magic 0x10000
|-
| 0x08
| 8
| IVFC descriptor offset
|-
| 0x10
| 8
| IVFC descriptor size
|-
| 0x18
| 8
| DPFS descriptor offset
|-
| 0x20
| 8
| DPFS descriptor size
|-
| 0x28
| 8
| Partition hash offset
|-
| 0x30
| 8
| Partition hash size
|-
| 0x38
| 1
| If none zero, enable external IVFC level 4.
|-
| 0x39
| 1
| DPFS tree level 1 selector
|-
| 0x3A
| 2
| Padding
|-
| 0x3C
| 8
| External IVFC level 4 offset (zero if external IVFC level 4 disabled)
|}

Note:

* The meaning of fields after 0x38 are explained in the section [[#Partition]]

=== IVFC descriptor ===

This header defines each level of IVFC tree (explained in the section [[#Partition]]). All offsets are relative to the beginning of DPFS level 3.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 4
| Magic "IVFC"
|-
| 0x04
| 4
| Magic 0x20000
|-
| 0x08
| 8
| Master hash size = partition master hash size in DIFI header
|-
| 0x10
| 8
| IVFC level 1 offset
|-
| 0x18
| 8
| IVFC level 1 size
|-
| 0x20
| 4
| IVFC level 1 block size in log2
|-
| 0x24
| 4
| Padding
|-
| 0x28
| 8
| IVFC level 2 offset
|-
| 0x30
| 8
| IVFC level 2 size
|-
| 0x38
| 4
| IVFC level 2 block size in log2
|-
| 0x3C
| 4
| Padding
|-
| 0x40
| 8
| IVFC level 3 offset
|-
| 0x48
| 8
| IVFC level 3 size
|-
| 0x50
| 4
| IVFC level 3 block size in log2
|-
| 0x54
| 4
| Padding
|-
| 0x58
| 8
| IVFC level 4 offset (unused if external IVFC level 4 enabled)
|-
| 0x60
| 8
| IVFC level 4 size
|-
| 0x68
| 4
| IVFC level 4 block size in log2
|-
| 0x6C
| 4
| Padding
|-
| 0x70
| 8
| IVFC descriptor size? The value is usually 0x78
|}

=== DPFS descriptor ===

This header defines each level of DPFS tree (explained in the section [[#Partition]]). All offsets are relative to the beginning of the partition.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 4
| Magic "DPFS"
|-
| 0x04
| 4
| Magic 0x10000
|-
| 0x08
| 8
| DPFS level 1 offset
|-
| 0x10
| 8
| DPFS level 1 size
|-
| 0x18
| 4
| DPFS level 1 block size in log2 (unused?)
|-
| 0x1C
| 4
| Padding
|-
| 0x20
| 8
| DPFS level 2 offset
|-
| 0x28
| 8
| DPFS level 2 size
|-
| 0x30
| 4
| DPFS level 2 block size in log2
|-
| 0x34
| 4
| Padding
|-
| 0x38
| 8
| DPFS level 3 offset
|-
| 0x40
| 8
| DPFS level 3 size
|-
| 0x48
| 4
| DPFS level 3 block size in log2
|-
| 0x4C
| 4
| Padding
|}

=== Partition master hash ===

This is a SHA-256 hash list over IVFC level 1. See [[#IVFC tree]] for explanation.

== Partition ==

A partition can have two types of layout. This is determined by the field DIFF + 0x38 (<code>Enable external IVFC level 4</code>).

The layout type 0 (external IVFC level 4 disabled) contains

* DPFS level 1
* DPFS level 2
* DPFS level 3, and inside
** IVFC level 1
** IVFC level 2
** IVFC level 3
** IVFC level 4 (the actual content data)

The layout type 1 (external IVFC level 4 enabled) contains

* DPFS level 1
* DPFS level 2
* DPFS level 3, and inside
** IVFC level 1
** IVFC level 2
** IVFC level 3
* IVFC level 4 (the actual content data, note that this is out side DPFS level 3)

=== DPFS tree ===

Everything inside the DPFS tree comes in pairs, and at one time only one of a pair is active. The tree is probably designed for atomic writing: for a file writing operation, it writes to the inactive part, then commits the data by switching a bit to activate it.

Each level of DPFS tree consists of a pair of chunks. The size of one chunk is defined as it in the DPFS descriptor, so the total size of a level is actually twice as large as the size recorded in the descriptor. For level 1 and 2, each chunk is a bit array, in which each bit corresponds to a block in the next level (the block size of the next level is also defined in the DPFS descriptor). This bit indicates which one of the pair in the next level is active for this block: 0 means the first one and 1 means the second one. The active chunk of level 1 is selected by <code>DPFS tree level 1 selector</code> in the DIFI header. The bit array is encoded in u32 array, with MSB as the first bit of each 32 bits.

To access data in level 3, one needs to check the bits in level 1 and level 2 to know which chunk of level 3 is active for the accessed location. For example, for a following configuration:

* Level 1: size = 4 bytes = 32 bits
* Level 2: size = 0x380 bytes = 0x1C00 bits, block size = 0x80 bytes
* Level 3: size = 0x1B7F000, block size = 0x1000, block size = 0x1000 bytes

if one want to read byte at 0x1234567 of level 3, the following calculation is performed:

* get level 2 bit index <code>0x1234567 / 0x1000 = 0x1234</code>, and its byte location <code>0x1234 / 8 = 0x246</code>
* get level 1 bit index <code>0x246 / 0x80 = 4</code>
* get <code>level1_selector</code> from DIFI header
* read <code>level2_selector = Level1[level1_selector].bits[4]</code>;
* read <code>level3_selector = Level2[level2_selector].bits[0x1234]</code>;
* read <code>data = Level3[level3_selector].bytes[0x1234567]</code> as the final data
* in the code above <code>Levelx[k]</code> means the <code>k</code>-th chunk in level <code>x</code>, where <code>k = 0, 1</code>. <code>.bits[n]</code> is expanded to <code>(.u32_array[n / 32] >> (31 - n % 32)) & 1</code> as the bit array is encoded in u32 array.

Effectively, the active data is scattered among the two level 3 chunk. One can assemble the whole active level 3 image following the same rule.

=== IVFC tree ===

The IVFC tree is used for data verification. It is very similar to the IVFC tree in [[RomFS]], except that it has an additional level here. For level 1, 2 and 3, each level is a list of SHA-256 hash, of which each corresponds to a block of the next level which is zero-padded to align the block size (the block size of the next level is defined in the IVFC descriptor).

The partition master hash in the partition descriptor can be seen as IVFC level 0, which hashes level 1 following the same rule. The master hash is usually 0x20 long, consisting only one hash. This is because most DISA / DIFF files are not large enough to have multiple hashes on the top level, which isn't the case for some title database files.

However, not all data is hashed - only ranges that have been written with valid data are properly hashed.

Level 4 is the actual content of the partition, which is what the container format essentially contains.

== Extracting content from a DISA / DIFF container ==

* Find the active partition table and the partition(s).
* Unwrap DPFS tree of partition(s) by reconstructing active data.
* Unwrap IVFC tree. Either take out level 4 directly, or, better, verify all the hashes and poison the data that is not properly hashed.
* The IVFC level 4 is the inner content of the file. The format of it varies among different usage. Refer their own page for further extraction.

== Chain of trust ==

* AES CMAC verifies the header.
* The header verifies the active partition table via the table hash.
* In the partition table, each descriptor verifies level 1 of its IVFC tree via the master hash.
* Each IVFC level verifies the next level, until the level 4, which is the inner content.

== Summary diagram ==

[[File:Disa-diff.png]]

DISA and DIFF

2025-06-30T20:48:20Z

TimmSkiller: /* DISA Header structure */

This page describes DISA and DIFF format as the underlying container of [[Savegames]], [[Extdata]] and [[Title Database]]. For further format specification of the inner data, please refer to their own page.

All data in this page is little-endian. All "unused / padding" fields can contain uninitialized data unless otherwise specified.

== Overview ==

DISA and DIFF are two container formats. They are very similar and are used for various purposes in 3DS. Here is a summary table of their usage, the CMAC type and the AES key slot used (the meaning of these is explained in the next section):

{| class="wikitable" border="1"
! Usage
! Media
! Container format
! [[#AES CMAC|CMAC type]]
! CMAC [[AES Registers|Keyslot]]
|-
| [[Savegames]]
| Gamecard
| DISA
| [[#CTR-NOR0|CTR-NOR0]]
| 0x19 / 0x33
|-
| [[Savegames]]
| [[SD Filesystem|SD]]
| DISA
| [[#CTR-SIGN|CTR-SIGN]]
| 0x30
|-
| [[System SaveData]]
| [[Flash Filesystem|NAND]]
| DISA
| [[#CTR-SYS0|CTR-SYS0]]
| 0x30
|-
| [[Extdata|Private Extdata]]
| [[SD Filesystem|SD]]
| DIFF
| [[#CTR-EXT0|CTR-EXT0]]
| 0x30
|-
| [[Extdata|Shared Extdata]]
| [[Flash Filesystem|NAND]]
| DIFF
| [[#CTR-EXT0|CTR-EXT0]]
| 0x30
|-
| [[Title Database]]
| [[SD Filesystem|SD]]
| DIFF
| [[#CTR-9DB0|CTR-9DB0]]
| 0x30
|-
| [[Title Database]]
| [[Flash Filesystem|NAND]]
| DIFF
| [[#CTR-9DB0|CTR-9DB0]]
| 0x0B
|}

== Encryption ==

DISA and DIFF formats don't have their own encryption specification. They follow the encryption method defined by their media:

* Gamecard savegames have special wear leveling + encryption layers. See [[Savegames]] for detail.
* Files on SD follow [[SD Filesystem|the general SD filesystem encryption rule]].
* Files on NAND are in cleartext, after decrypting [[Flash Filesystem|the NAND partition encryption]].

== Format ==

A DISA / DIFF file consists of the following components:

* 0x100-byte AES CMAC
* 0x100-byte Header
* Secondary partition table
** Contains one or two partition descriptors, depending on the number of partitions.
* Primary partition table
** Same layout as the secondary one
* Partition A
* Partition B (optional)
** can only exist for DISA.

== AES CMAC ==

The AES CMAC is located at the beginning of the DISA / DIFF image, and it is 0x10 long. The rest 0xF0 bytes before the header are unused.

The key used for the AES CMAC is generated by the [[AES Registers|hardware key engine]]. See the keyslot it uses in the table above.

The data being authenticated by the AES CMAC is a 0x20-byte SHA-256 hash of a data block. The data block has different content formats among CMAC types. All types of data block contain a copy or a hash of the header, which is the start of the the rest of the verification chain, so the AES CMAC effectively authenticates the whole save image. Each type of data block is explained below.

=== CTR-NOR0 ===

This CMAC type is used for gamecard savegames. It is 0x28-byte long.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-NOR0"
|-
| 0x8
| 0x20
| SHA-256 of the following 0x108-byte block
{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-SAV0"
|-
| 0x08
| 0x100
| Copy of the DISA header
|}
|}

=== CTR-SIGN ===

This CMAC type is used for SD savegames. It is 0x30-byte long.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-SIGN"
|-
| 0x08
| 8
| Title ID
|-
| 0x10
| 0x20
| SHA-256 of the following 0x108-byte block
{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-SAV0"
|-
| 0x08
| 0x100
| Copy of the DISA header
|}
|}

=== CTR-SYS0 ===

This CMAC type is used for NAND system save. It is 0x110-byte long.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-SYS0"
|-
| 0x08
| 8
| Save ID. The higher word is always zero
|-
| 0x10
| 0x100
| Copy of the DISA header
|}

=== CTR-EXT0 ===

This CMAC type is used for extdata. It is 0x11C-byte long.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-EXT0"
|-
| 0x08
| 8
| Extdata ID
|-
| 0x10
| 4
| 0 for Quota.dat, 1 otherwise
|-
| 0x14
| 4
| ID in the device file name. 0 for Quota.dat
|-
| 0x18
| 4
| ID in the device directory name that the file is in. 0 for Quota.dat
|-
| 0x1C
| 0x100
| Copy of the DIFF header
|}

=== CTR-9DB0 ===

This CMAC type is used for title database. It is 0x10C-byte long.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-9DB0"
|-
| 0x08
| 4
| Database ID. Each .db file has its own ID
|-
| 0x0C
| 0x100
| Copy of the DIFF header
|}

== Header ==

The header located at offset 0x100 defines the rest components of the file (partitions and their tables). All offsets in the header are relative to the beginning of the DISA/DIFF file, except for partition descriptor offsets, which are relative to the beginning of the (active) partition table. DISA and DIFF have different header format.

=== DISA header ===

==== SaveDataSecureValue ====
{| class="wikitable" border="1"
|-
! Offset !! Length !! Description
|-
| 0x0 || 0x4 || u32, [[Anti_Savegame_Restore|Secure Value]] slot
|-
| 0x4 || 0x8 || u64, [[Anti_Savegame_Restore|Secure Value]]
|}

==== DISA Header structure ====
{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 4
| Magic "DISA"
|-
| 0x04
| 4
| Magic 0x40000
|-
| 0x08
| 4
| Partition count, 1 or 2
|-
| 0x0C
| 4
| Padding
|-
| 0x10
| 8
| Secondary partition table offset
|-
| 0x18
| 8
| Primary partition table offset
|-
| 0x20
| 8
| Partition table size
|-
| 0x28
| 8
| Partition A descriptor offset in the partition table
|-
| 0x30
| 8
| Partition A descriptor size
|-
| 0x38
| 8
| Partition B descriptor offset in the partition table
|-
| 0x40
| 8
| Partition B descriptor size
|-
| 0x48
| 8
| Partition A offset
|-
| 0x50
| 8
| Partition A size
|-
| 0x58
| 8
| Partition B offset
|-
| 0x60
| 8
| Partition B size
|-
| 0x68
| 1
| Active partition table, 0 = primary, 1 = secondary
|-
| 0x69
| 1
| Number of used [[Anti_Savegame_Restore|Save Data Secure Value]] entries in the DISA header (only for gamecard saves)
|-
| 0x6A
| 2
| Padding
|-
| 0x6C
| 0x20
| SHA-256 over the active partition table
|-
| 0x8C
| 0x30 (0xC * 0x4)
| [[DISA_and_DIFF#SaveDataSecureValue|Save Data Secure Value]] entries (4) (only for gamecard saves)
|-
| 0xBC
| 0x8
| Unused randomly generated u64 value. (only for gamecard saves)
|-
| 0xC4
| 0x3C
| Unused
|}

Note:

* When the partition count is 1, there is no partition B and all of its related fields are zero.

=== DIFF header ===

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 4
| Magic "DIFF"
|-
| 0x04
| 4
| Magic 0x30000
|-
| 0x08
| 8
| Secondary partition table/descriptor offset
|-
| 0x10
| 8
| Primary partition table/descriptor offset
|-
| 0x18
| 8
| Partition table/descriptor size
|-
| 0x20
| 8
| Partition (A) offset
|-
| 0x28
| 8
| Partition (A) size
|-
| 0x30
| 4
| Active partition descriptor, 0 = primary, 1 = secondary
|-
| 0x34
| 0x20
| SHA-256 over the active partition table/descriptor
|-
| 0x54
| 8
| Unique identifier
|-
| 0x5C
| 0xA4
| Unused, might contain leftover data
|}

Note:

* Since DIFF can only contain one partition, a partition table can only have one partition descriptor, so they become the same concept here.
* See [[Extdata]] for its usage of the unique identifier field. For title database files, this field is zero.

== Partition table & partition descriptor ==

There are two partition tables, but only one of them is active. When operating on a DISA / DIFF file, 3DS FS alternately activate one of the two tables, presumably for data backup or atomic file writing. A newly created DISA / DIFF file may have entirely uninitialized data in the inactive partition table.

One partition table contains one or two partition descriptors , each of which describes the layout of one partition. A partition descriptor contains the following components:

* DIFI header
* IVFC descriptor
* DPFS descriptor
* Partition master hash

=== DIFI header ===

The DIFI header locates at the beginning of a partition descriptor. This header defines the rest components of the partition descriptor (IVFC descriptor, DPFS descriptor and partition master hash). All offsets are relative to the beginning of the partition descriptor, except for <code>External IVFC level 4 offset</code>, which is relative to the beginning of the partition.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 4
| Magic "DIFI"
|-
| 0x04
| 4
| Magic 0x10000
|-
| 0x08
| 8
| IVFC descriptor offset
|-
| 0x10
| 8
| IVFC descriptor size
|-
| 0x18
| 8
| DPFS descriptor offset
|-
| 0x20
| 8
| DPFS descriptor size
|-
| 0x28
| 8
| Partition hash offset
|-
| 0x30
| 8
| Partition hash size
|-
| 0x38
| 1
| If none zero, enable external IVFC level 4.
|-
| 0x39
| 1
| DPFS tree level 1 selector
|-
| 0x3A
| 2
| Padding
|-
| 0x3C
| 8
| External IVFC level 4 offset (zero if external IVFC level 4 disabled)
|}

Note:

* The meaning of fields after 0x38 are explained in the section [[#Partition]]

=== IVFC descriptor ===

This header defines each level of IVFC tree (explained in the section [[#Partition]]). All offsets are relative to the beginning of DPFS level 3.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 4
| Magic "IVFC"
|-
| 0x04
| 4
| Magic 0x20000
|-
| 0x08
| 8
| Master hash size = partition master hash size in DIFI header
|-
| 0x10
| 8
| IVFC level 1 offset
|-
| 0x18
| 8
| IVFC level 1 size
|-
| 0x20
| 4
| IVFC level 1 block size in log2
|-
| 0x24
| 4
| Padding
|-
| 0x28
| 8
| IVFC level 2 offset
|-
| 0x30
| 8
| IVFC level 2 size
|-
| 0x38
| 4
| IVFC level 2 block size in log2
|-
| 0x3C
| 4
| Padding
|-
| 0x40
| 8
| IVFC level 3 offset
|-
| 0x48
| 8
| IVFC level 3 size
|-
| 0x50
| 4
| IVFC level 3 block size in log2
|-
| 0x54
| 4
| Padding
|-
| 0x58
| 8
| IVFC level 4 offset (unused if external IVFC level 4 enabled)
|-
| 0x60
| 8
| IVFC level 4 size
|-
| 0x68
| 4
| IVFC level 4 block size in log2
|-
| 0x6C
| 4
| Padding
|-
| 0x70
| 8
| IVFC descriptor size? The value is usually 0x78
|}

=== DPFS descriptor ===

This header defines each level of DPFS tree (explained in the section [[#Partition]]). All offsets are relative to the beginning of the partition.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 4
| Magic "DPFS"
|-
| 0x04
| 4
| Magic 0x10000
|-
| 0x08
| 8
| DPFS level 1 offset
|-
| 0x10
| 8
| DPFS level 1 size
|-
| 0x18
| 4
| DPFS level 1 block size in log2 (unused?)
|-
| 0x1C
| 4
| Padding
|-
| 0x20
| 8
| DPFS level 2 offset
|-
| 0x28
| 8
| DPFS level 2 size
|-
| 0x30
| 4
| DPFS level 2 block size in log2
|-
| 0x34
| 4
| Padding
|-
| 0x38
| 8
| DPFS level 3 offset
|-
| 0x40
| 8
| DPFS level 3 size
|-
| 0x48
| 4
| DPFS level 3 block size in log2
|-
| 0x4C
| 4
| Padding
|}

=== Partition master hash ===

This is a SHA-256 hash list over IVFC level 1. See [[#IVFC tree]] for explanation.

== Partition ==

A partition can have two types of layout. This is determined by the field DIFF + 0x38 (<code>Enable external IVFC level 4</code>).

The layout type 0 (external IVFC level 4 disabled) contains

* DPFS level 1
* DPFS level 2
* DPFS level 3, and inside
** IVFC level 1
** IVFC level 2
** IVFC level 3
** IVFC level 4 (the actual content data)

The layout type 1 (external IVFC level 4 enabled) contains

* DPFS level 1
* DPFS level 2
* DPFS level 3, and inside
** IVFC level 1
** IVFC level 2
** IVFC level 3
* IVFC level 4 (the actual content data, note that this is out side DPFS level 3)

=== DPFS tree ===

Everything inside the DPFS tree comes in pairs, and at one time only one of a pair is active. The tree is probably designed for atomic writing: for a file writing operation, it writes to the inactive part, then commits the data by switching a bit to activate it.

Each level of DPFS tree consists of a pair of chunks. The size of one chunk is defined as it in the DPFS descriptor, so the total size of a level is actually twice as large as the size recorded in the descriptor. For level 1 and 2, each chunk is a bit array, in which each bit corresponds to a block in the next level (the block size of the next level is also defined in the DPFS descriptor). This bit indicates which one of the pair in the next level is active for this block: 0 means the first one and 1 means the second one. The active chunk of level 1 is selected by <code>DPFS tree level 1 selector</code> in the DIFI header. The bit array is encoded in u32 array, with MSB as the first bit of each 32 bits.

To access data in level 3, one needs to check the bits in level 1 and level 2 to know which chunk of level 3 is active for the accessed location. For example, for a following configuration:

* Level 1: size = 4 bytes = 32 bits
* Level 2: size = 0x380 bytes = 0x1C00 bits, block size = 0x80 bytes
* Level 3: size = 0x1B7F000, block size = 0x1000, block size = 0x1000 bytes

if one want to read byte at 0x1234567 of level 3, the following calculation is performed:

* get level 2 bit index <code>0x1234567 / 0x1000 = 0x1234</code>, and its byte location <code>0x1234 / 8 = 0x246</code>
* get level 1 bit index <code>0x246 / 0x80 = 4</code>
* get <code>level1_selector</code> from DIFI header
* read <code>level2_selector = Level1[level1_selector].bits[4]</code>;
* read <code>level3_selector = Level2[level2_selector].bits[0x1234]</code>;
* read <code>data = Level3[level3_selector].bytes[0x1234567]</code> as the final data
* in the code above <code>Levelx[k]</code> means the <code>k</code>-th chunk in level <code>x</code>, where <code>k = 0, 1</code>. <code>.bits[n]</code> is expanded to <code>(.u32_array[n / 32] >> (31 - n % 32)) & 1</code> as the bit array is encoded in u32 array.

Effectively, the active data is scattered among the two level 3 chunk. One can assemble the whole active level 3 image following the same rule.

=== IVFC tree ===

The IVFC tree is used for data verification. It is very similar to the IVFC tree in [[RomFS]], except that it has an additional level here. For level 1, 2 and 3, each level is a list of SHA-256 hash, of which each corresponds to a block of the next level which is zero-padded to align the block size (the block size of the next level is defined in the IVFC descriptor).

The partition master hash in the partition descriptor can be seen as IVFC level 0, which hashes level 1 following the same rule. The master hash is usually 0x20 long, consisting only one hash. This is because most DISA / DIFF files are not large enough to have multiple hashes on the top level, which isn't the case for some title database files.

However, not all data is hashed - only ranges that have been written with valid data are properly hashed.

Level 4 is the actual content of the partition, which is what the container format essentially contains.

== Extracting content from a DISA / DIFF container ==

* Find the active partition table and the partition(s).
* Unwrap DPFS tree of partition(s) by reconstructing active data.
* Unwrap IVFC tree. Either take out level 4 directly, or, better, verify all the hashes and poison the data that is not properly hashed.
* The IVFC level 4 is the inner content of the file. The format of it varies among different usage. Refer their own page for further extraction.

== Chain of trust ==

* AES CMAC verifies the header.
* The header verifies the active partition table via the table hash.
* In the partition table, each descriptor verifies level 1 of its IVFC tree via the master hash.
* Each IVFC level verifies the next level, until the level 4, which is the inner content.

== Summary diagram ==

[[File:Disa-diff.png]]

DISA and DIFF

2025-06-30T19:21:16Z

TimmSkiller: Add SaveDataSecureValue struct

This page describes DISA and DIFF format as the underlying container of [[Savegames]], [[Extdata]] and [[Title Database]]. For further format specification of the inner data, please refer to their own page.

All data in this page is little-endian. All "unused / padding" fields can contain uninitialized data unless otherwise specified.

== Overview ==

DISA and DIFF are two container formats. They are very similar and are used for various purposes in 3DS. Here is a summary table of their usage, the CMAC type and the AES key slot used (the meaning of these is explained in the next section):

{| class="wikitable" border="1"
! Usage
! Media
! Container format
! [[#AES CMAC|CMAC type]]
! CMAC [[AES Registers|Keyslot]]
|-
| [[Savegames]]
| Gamecard
| DISA
| [[#CTR-NOR0|CTR-NOR0]]
| 0x19 / 0x33
|-
| [[Savegames]]
| [[SD Filesystem|SD]]
| DISA
| [[#CTR-SIGN|CTR-SIGN]]
| 0x30
|-
| [[System SaveData]]
| [[Flash Filesystem|NAND]]
| DISA
| [[#CTR-SYS0|CTR-SYS0]]
| 0x30
|-
| [[Extdata|Private Extdata]]
| [[SD Filesystem|SD]]
| DIFF
| [[#CTR-EXT0|CTR-EXT0]]
| 0x30
|-
| [[Extdata|Shared Extdata]]
| [[Flash Filesystem|NAND]]
| DIFF
| [[#CTR-EXT0|CTR-EXT0]]
| 0x30
|-
| [[Title Database]]
| [[SD Filesystem|SD]]
| DIFF
| [[#CTR-9DB0|CTR-9DB0]]
| 0x30
|-
| [[Title Database]]
| [[Flash Filesystem|NAND]]
| DIFF
| [[#CTR-9DB0|CTR-9DB0]]
| 0x0B
|}

== Encryption ==

DISA and DIFF formats don't have their own encryption specification. They follow the encryption method defined by their media:

* Gamecard savegames have special wear leveling + encryption layers. See [[Savegames]] for detail.
* Files on SD follow [[SD Filesystem|the general SD filesystem encryption rule]].
* Files on NAND are in cleartext, after decrypting [[Flash Filesystem|the NAND partition encryption]].

== Format ==

A DISA / DIFF file consists of the following components:

* 0x100-byte AES CMAC
* 0x100-byte Header
* Secondary partition table
** Contains one or two partition descriptors, depending on the number of partitions.
* Primary partition table
** Same layout as the secondary one
* Partition A
* Partition B (optional)
** can only exist for DISA.

== AES CMAC ==

The AES CMAC is located at the beginning of the DISA / DIFF image, and it is 0x10 long. The rest 0xF0 bytes before the header are unused.

The key used for the AES CMAC is generated by the [[AES Registers|hardware key engine]]. See the keyslot it uses in the table above.

The data being authenticated by the AES CMAC is a 0x20-byte SHA-256 hash of a data block. The data block has different content formats among CMAC types. All types of data block contain a copy or a hash of the header, which is the start of the the rest of the verification chain, so the AES CMAC effectively authenticates the whole save image. Each type of data block is explained below.

=== CTR-NOR0 ===

This CMAC type is used for gamecard savegames. It is 0x28-byte long.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-NOR0"
|-
| 0x8
| 0x20
| SHA-256 of the following 0x108-byte block
{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-SAV0"
|-
| 0x08
| 0x100
| Copy of the DISA header
|}
|}

=== CTR-SIGN ===

This CMAC type is used for SD savegames. It is 0x30-byte long.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-SIGN"
|-
| 0x08
| 8
| Title ID
|-
| 0x10
| 0x20
| SHA-256 of the following 0x108-byte block
{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-SAV0"
|-
| 0x08
| 0x100
| Copy of the DISA header
|}
|}

=== CTR-SYS0 ===

This CMAC type is used for NAND system save. It is 0x110-byte long.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-SYS0"
|-
| 0x08
| 8
| Save ID. The higher word is always zero
|-
| 0x10
| 0x100
| Copy of the DISA header
|}

=== CTR-EXT0 ===

This CMAC type is used for extdata. It is 0x11C-byte long.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-EXT0"
|-
| 0x08
| 8
| Extdata ID
|-
| 0x10
| 4
| 0 for Quota.dat, 1 otherwise
|-
| 0x14
| 4
| ID in the device file name. 0 for Quota.dat
|-
| 0x18
| 4
| ID in the device directory name that the file is in. 0 for Quota.dat
|-
| 0x1C
| 0x100
| Copy of the DIFF header
|}

=== CTR-9DB0 ===

This CMAC type is used for title database. It is 0x10C-byte long.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 8
| Magic "CTR-9DB0"
|-
| 0x08
| 4
| Database ID. Each .db file has its own ID
|-
| 0x0C
| 0x100
| Copy of the DIFF header
|}

== Header ==

The header located at offset 0x100 defines the rest components of the file (partitions and their tables). All offsets in the header are relative to the beginning of the DISA/DIFF file, except for partition descriptor offsets, which are relative to the beginning of the (active) partition table. DISA and DIFF have different header format.

=== DISA header ===

==== SaveDataSecureValue ====
{| class="wikitable" border="1"
|-
! Offset !! Length !! Description
|-
| 0x0 || 0x4 || u32, [[Anti_Savegame_Restore|Secure Value]] slot
|-
| 0x4 || 0x8 || u64, [[Anti_Savegame_Restore|Secure Value]]
|}

==== DISA Header structure ====
{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 4
| Magic "DISA"
|-
| 0x04
| 4
| Magic 0x40000
|-
| 0x08
| 4
| Partition count, 1 or 2
|-
| 0x0C
| 4
| Padding
|-
| 0x10
| 8
| Secondary partition table offset
|-
| 0x18
| 8
| Primary partition table offset
|-
| 0x20
| 8
| Partition table size
|-
| 0x28
| 8
| Partition A descriptor offset in the partition table
|-
| 0x30
| 8
| Partition A descriptor size
|-
| 0x38
| 8
| Partition B descriptor offset in the partition table
|-
| 0x40
| 8
| Partition B descriptor size
|-
| 0x48
| 8
| Partition A offset
|-
| 0x50
| 8
| Partition A size
|-
| 0x58
| 8
| Partition B offset
|-
| 0x60
| 8
| Partition B size
|-
| 0x68
| 1
| Active partition table, 0 = primary, 1 = secondary
|-
| 0x69
| 1
| Number of used [[Anti_Savegame_Restore|Save Data Secure Value]] entries in the DISA header
|-
| 0x6A
| 2
| Padding
|-
| 0x6C
| 0x20
| SHA-256 over the active partition table
|-
| 0x8C
| 0x30 (0xC * 0x4)
| [[DISA_and_DIFF#SaveDataSecureValue|Save Data Secure Value]] entries (4)
|-
| 0xBC
| 0x44
| Unused
|}

Note:

* When the partition count is 1, there is no partition B and all of its related fields are zero.

=== DIFF header ===

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 4
| Magic "DIFF"
|-
| 0x04
| 4
| Magic 0x30000
|-
| 0x08
| 8
| Secondary partition table/descriptor offset
|-
| 0x10
| 8
| Primary partition table/descriptor offset
|-
| 0x18
| 8
| Partition table/descriptor size
|-
| 0x20
| 8
| Partition (A) offset
|-
| 0x28
| 8
| Partition (A) size
|-
| 0x30
| 4
| Active partition descriptor, 0 = primary, 1 = secondary
|-
| 0x34
| 0x20
| SHA-256 over the active partition table/descriptor
|-
| 0x54
| 8
| Unique identifier
|-
| 0x5C
| 0xA4
| Unused, might contain leftover data
|}

Note:

* Since DIFF can only contain one partition, a partition table can only have one partition descriptor, so they become the same concept here.
* See [[Extdata]] for its usage of the unique identifier field. For title database files, this field is zero.

== Partition table & partition descriptor ==

There are two partition tables, but only one of them is active. When operating on a DISA / DIFF file, 3DS FS alternately activate one of the two tables, presumably for data backup or atomic file writing. A newly created DISA / DIFF file may have entirely uninitialized data in the inactive partition table.

One partition table contains one or two partition descriptors , each of which describes the layout of one partition. A partition descriptor contains the following components:

* DIFI header
* IVFC descriptor
* DPFS descriptor
* Partition master hash

=== DIFI header ===

The DIFI header locates at the beginning of a partition descriptor. This header defines the rest components of the partition descriptor (IVFC descriptor, DPFS descriptor and partition master hash). All offsets are relative to the beginning of the partition descriptor, except for <code>External IVFC level 4 offset</code>, which is relative to the beginning of the partition.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 4
| Magic "DIFI"
|-
| 0x04
| 4
| Magic 0x10000
|-
| 0x08
| 8
| IVFC descriptor offset
|-
| 0x10
| 8
| IVFC descriptor size
|-
| 0x18
| 8
| DPFS descriptor offset
|-
| 0x20
| 8
| DPFS descriptor size
|-
| 0x28
| 8
| Partition hash offset
|-
| 0x30
| 8
| Partition hash size
|-
| 0x38
| 1
| If none zero, enable external IVFC level 4.
|-
| 0x39
| 1
| DPFS tree level 1 selector
|-
| 0x3A
| 2
| Padding
|-
| 0x3C
| 8
| External IVFC level 4 offset (zero if external IVFC level 4 disabled)
|}

Note:

* The meaning of fields after 0x38 are explained in the section [[#Partition]]

=== IVFC descriptor ===

This header defines each level of IVFC tree (explained in the section [[#Partition]]). All offsets are relative to the beginning of DPFS level 3.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 4
| Magic "IVFC"
|-
| 0x04
| 4
| Magic 0x20000
|-
| 0x08
| 8
| Master hash size = partition master hash size in DIFI header
|-
| 0x10
| 8
| IVFC level 1 offset
|-
| 0x18
| 8
| IVFC level 1 size
|-
| 0x20
| 4
| IVFC level 1 block size in log2
|-
| 0x24
| 4
| Padding
|-
| 0x28
| 8
| IVFC level 2 offset
|-
| 0x30
| 8
| IVFC level 2 size
|-
| 0x38
| 4
| IVFC level 2 block size in log2
|-
| 0x3C
| 4
| Padding
|-
| 0x40
| 8
| IVFC level 3 offset
|-
| 0x48
| 8
| IVFC level 3 size
|-
| 0x50
| 4
| IVFC level 3 block size in log2
|-
| 0x54
| 4
| Padding
|-
| 0x58
| 8
| IVFC level 4 offset (unused if external IVFC level 4 enabled)
|-
| 0x60
| 8
| IVFC level 4 size
|-
| 0x68
| 4
| IVFC level 4 block size in log2
|-
| 0x6C
| 4
| Padding
|-
| 0x70
| 8
| IVFC descriptor size? The value is usually 0x78
|}

=== DPFS descriptor ===

This header defines each level of DPFS tree (explained in the section [[#Partition]]). All offsets are relative to the beginning of the partition.

{| class="wikitable" border="1"
! Offset
! Length
! Description
|-
| 0x00
| 4
| Magic "DPFS"
|-
| 0x04
| 4
| Magic 0x10000
|-
| 0x08
| 8
| DPFS level 1 offset
|-
| 0x10
| 8
| DPFS level 1 size
|-
| 0x18
| 4
| DPFS level 1 block size in log2 (unused?)
|-
| 0x1C
| 4
| Padding
|-
| 0x20
| 8
| DPFS level 2 offset
|-
| 0x28
| 8
| DPFS level 2 size
|-
| 0x30
| 4
| DPFS level 2 block size in log2
|-
| 0x34
| 4
| Padding
|-
| 0x38
| 8
| DPFS level 3 offset
|-
| 0x40
| 8
| DPFS level 3 size
|-
| 0x48
| 4
| DPFS level 3 block size in log2
|-
| 0x4C
| 4
| Padding
|}

=== Partition master hash ===

This is a SHA-256 hash list over IVFC level 1. See [[#IVFC tree]] for explanation.

== Partition ==

A partition can have two types of layout. This is determined by the field DIFF + 0x38 (<code>Enable external IVFC level 4</code>).

The layout type 0 (external IVFC level 4 disabled) contains

* DPFS level 1
* DPFS level 2
* DPFS level 3, and inside
** IVFC level 1
** IVFC level 2
** IVFC level 3
** IVFC level 4 (the actual content data)

The layout type 1 (external IVFC level 4 enabled) contains

* DPFS level 1
* DPFS level 2
* DPFS level 3, and inside
** IVFC level 1
** IVFC level 2
** IVFC level 3
* IVFC level 4 (the actual content data, note that this is out side DPFS level 3)

=== DPFS tree ===

Everything inside the DPFS tree comes in pairs, and at one time only one of a pair is active. The tree is probably designed for atomic writing: for a file writing operation, it writes to the inactive part, then commits the data by switching a bit to activate it.

Each level of DPFS tree consists of a pair of chunks. The size of one chunk is defined as it in the DPFS descriptor, so the total size of a level is actually twice as large as the size recorded in the descriptor. For level 1 and 2, each chunk is a bit array, in which each bit corresponds to a block in the next level (the block size of the next level is also defined in the DPFS descriptor). This bit indicates which one of the pair in the next level is active for this block: 0 means the first one and 1 means the second one. The active chunk of level 1 is selected by <code>DPFS tree level 1 selector</code> in the DIFI header. The bit array is encoded in u32 array, with MSB as the first bit of each 32 bits.

To access data in level 3, one needs to check the bits in level 1 and level 2 to know which chunk of level 3 is active for the accessed location. For example, for a following configuration:

* Level 1: size = 4 bytes = 32 bits
* Level 2: size = 0x380 bytes = 0x1C00 bits, block size = 0x80 bytes
* Level 3: size = 0x1B7F000, block size = 0x1000, block size = 0x1000 bytes

if one want to read byte at 0x1234567 of level 3, the following calculation is performed:

* get level 2 bit index <code>0x1234567 / 0x1000 = 0x1234</code>, and its byte location <code>0x1234 / 8 = 0x246</code>
* get level 1 bit index <code>0x246 / 0x80 = 4</code>
* get <code>level1_selector</code> from DIFI header
* read <code>level2_selector = Level1[level1_selector].bits[4]</code>;
* read <code>level3_selector = Level2[level2_selector].bits[0x1234]</code>;
* read <code>data = Level3[level3_selector].bytes[0x1234567]</code> as the final data
* in the code above <code>Levelx[k]</code> means the <code>k</code>-th chunk in level <code>x</code>, where <code>k = 0, 1</code>. <code>.bits[n]</code> is expanded to <code>(.u32_array[n / 32] >> (31 - n % 32)) & 1</code> as the bit array is encoded in u32 array.

Effectively, the active data is scattered among the two level 3 chunk. One can assemble the whole active level 3 image following the same rule.

=== IVFC tree ===

The IVFC tree is used for data verification. It is very similar to the IVFC tree in [[RomFS]], except that it has an additional level here. For level 1, 2 and 3, each level is a list of SHA-256 hash, of which each corresponds to a block of the next level which is zero-padded to align the block size (the block size of the next level is defined in the IVFC descriptor).

The partition master hash in the partition descriptor can be seen as IVFC level 0, which hashes level 1 following the same rule. The master hash is usually 0x20 long, consisting only one hash. This is because most DISA / DIFF files are not large enough to have multiple hashes on the top level, which isn't the case for some title database files.

However, not all data is hashed - only ranges that have been written with valid data are properly hashed.

Level 4 is the actual content of the partition, which is what the container format essentially contains.

== Extracting content from a DISA / DIFF container ==

* Find the active partition table and the partition(s).
* Unwrap DPFS tree of partition(s) by reconstructing active data.
* Unwrap IVFC tree. Either take out level 4 directly, or, better, verify all the hashes and poison the data that is not properly hashed.
* The IVFC level 4 is the inner content of the file. The format of it varies among different usage. Refer their own page for further extraction.

== Chain of trust ==

* AES CMAC verifies the header.
* The header verifies the active partition table via the table hash.
* In the partition table, each descriptor verifies level 1 of its IVFC tree via the master hash.
* Each IVFC level verifies the next level, until the level 4, which is the inner content.

== Summary diagram ==

[[File:Disa-diff.png]]