Nintendo Switch Brew

Changes

NPDM (view source)

Revision as of 22:16, 23 October 2024

602 bytes added ,  22:16, 23 October 2024
no edit summary
Line 29: Line 29:  
| 0x0
 
| 0x0
 
| 0x4
 
| 0x4
−
| Magicnum "META"
+
| Magic ("META")
 
|-
 
|-
 
| 0x4
 
| 0x4
 
| 0x4
 
| 0x4
−
| [9.0.0+] AcidSignatureKeyGeneration (0 or 1)
+
| [9.0.0+] SignatureKeyGeneration
 
|-
 
|-
 
| 0x8
 
| 0x8
Line 113: Line 113:  
|-
 
|-
 
| 4
 
| 4
−
| OptimizeMemoryAllocation
+
| [7.0.0+] OptimizeMemoryAllocation
 +
|-
 +
| 5
 +
| [11.0.0+] DisableDeviceAddressSpaceMerge
 +
|-
 +
| 6
 +
| [18.0.0+] EnableAliasRegionExtraSize
 +
|-
 +
| 7
 +
| [19.0.0+] PreventCodeReads
 
|}
 
|}
   Line 120: Line 129:     
== SystemResourceSize ==
 
== SystemResourceSize ==
−
This is the size of PersonalMmHeap. Maximum size as of 5.0.0 is 0x1FE00000.
+
When this is non-zero, the kernel reserves this amount of memory and dynamically uses it as needed for page table pages, KMemoryBlocks, and KBlockInfos. When this is zero, the process uses global shared heaps for these.
 +
 
 +
This enables a process to sacrifice some of the memory available to it in order to have higher limits on these resources, thus enabling the use of SvcMapPhysicalMemory.
 +
 
 +
Maximum size as is 0x1FE00000.
 +
 
    
== Version ==
 
== Version ==
Line 130: Line 144:     
== MainThreadStackSize ==
 
== MainThreadStackSize ==
−
Must be aligned to 0x1000.
+
Must be aligned to 0x1000. If zero, kernel will start the process's initial thread with sp=0.
−
 
  −
In non-nspwn scenarios, values of 0 can also rarely break in Horizon. This might be something auto-adapting or a security feature of some sort?
      
= ACID =
 
= ACID =
Line 151: Line 163:  
| 0x200
 
| 0x200
 
| 0x4
 
| 0x4
−
| Magicnum "ACID"
+
| Magic ("ACID")
 
|-
 
|-
 
| 0x204
 
| 0x204
Line 158: Line 170:  
|-
 
|-
 
| 0x208
 
| 0x208
−
| 0x4
+
| 0x1
 +
| [9.0.0+] Version
 +
|-
 +
| 0x209
 +
| 0x1
 +
| [14.0.0+]
 +
|-
 +
| 0x20A
 +
| 0x2
 
| Reserved
 
| Reserved
 
|-
 
|-
Line 175: Line 195:  
| 0x220
 
| 0x220
 
| 0x4
 
| 0x4
−
| [[#FsAccessControl|FsAccessControlOffset]]
+
| [[#FsAccessControl|FacOffset]]
 
|-
 
|-
 
| 0x224
 
| 0x224
 
| 0x4
 
| 0x4
−
| [[#FsAccessControl|FsAccessControlSize]]
+
| [[#FsAccessControl|FacSize]]
 
|-
 
|-
 
| 0x228
 
| 0x228
 
| 0x4
 
| 0x4
−
| [[#SrvAccessControl|SrvAccessControlOffset]]
+
| [[#SrvAccessControl|SacOffset]]
 
|-
 
|-
 
| 0x22C
 
| 0x22C
 
| 0x4
 
| 0x4
−
| [[#SrvAccessControl|SrvAccessControlSize]]
+
| [[#SrvAccessControl|SacSize]]
 
|-
 
|-
 
| 0x230
 
| 0x230
 
| 0x4
 
| 0x4
−
| [[#KernelCapability|KernelCapabilityOffset]]
+
| [[#KernelCapability|KcOffset]]
 
|-
 
|-
 
| 0x234
 
| 0x234
 
| 0x4
 
| 0x4
−
| [[#KernelCapability|KernelCapabilitySize]]
+
| [[#KernelCapability|KcSize]]
 
|-
 
|-
 
| 0x238
 
| 0x238
Line 214: Line 234:  
| UnqualifiedApproval
 
| UnqualifiedApproval
 
|-
 
|-
−
| 2-3
+
| 2-5
−
| [5.0.0+ ] MemoryRegion (0 = Application, 1 = Applet, 2 = SecureSystem, 3 = NonSecureSystem)
+
| [5.0.0+] MemoryRegion (0 = Application, 1 = Applet, 2 = SecureSystem, 3 = NonSecureSystem)
 
|}
 
|}
   Line 229: Line 249:  
| 0x0
 
| 0x0
 
| 0x4
 
| 0x4
−
| Magicnum "ACI0"
+
| Magic ("ACI0")
 
|-
 
|-
 
| 0x4
 
| 0x4
Line 245: Line 265:  
| 0x20
 
| 0x20
 
| 0x4
 
| 0x4
−
| [[#FsAccessControl|FsAccessControlOffset]]
+
| [[#FsAccessControl|FacOffset]]
 
|-
 
|-
 
| 0x24
 
| 0x24
 
| 0x4
 
| 0x4
−
| [[#FsAccessControl|FsAccessControlSize]]
+
| [[#FsAccessControl|FacSize]]
 
|-
 
|-
 
| 0x28
 
| 0x28
 
| 0x4
 
| 0x4
−
| [[#SrvAccessControl|SrvAccessControlOffset]]
+
| [[#SrvAccessControl|SacOffset]]
 
|-
 
|-
 
| 0x2C
 
| 0x2C
 
| 0x4
 
| 0x4
−
| [[#SrvAccessControl|SrvAccessControlSize]]
+
| [[#SrvAccessControl|SacSize]]
 
|-
 
|-
 
| 0x30
 
| 0x30
 
| 0x4
 
| 0x4
−
| [[#KernelCapability|KernelCapabilityOffset]]
+
| [[#KernelCapability|KcOffset]]
 
|-
 
|-
 
| 0x34
 
| 0x34
 
| 0x4
 
| 0x4
−
| [[#KernelCapability|KernelCapabilitySize]]
+
| [[#KernelCapability|KcSize]]
 
|-
 
|-
 
| 0x38
 
| 0x38
Line 286: Line 306:  
| 0x1
 
| 0x1
 
| 0x1
 
| 0x1
−
| ContentOwnerIdCount
+
| [5.0.0+] ContentOwnerIdCount
 
|-
 
|-
 
| 0x2
 
| 0x2
 
| 0x1
 
| 0x1
−
| SaveDataOwnerIdCount
+
| [5.0.0+] SaveDataOwnerIdCount
 
|-
 
|-
 
| 0x3
 
| 0x3
Line 318: Line 338:  
| 0x2C
 
| 0x2C
 
| 0x8 * ContentOwnerIdCount
 
| 0x8 * ContentOwnerIdCount
−
| ContentOwnerIds
+
| [5.0.0+] ContentOwnerIds
 
|-
 
|-
 
| Variable
 
| Variable
 
| 0x8 * SaveDataOwnerIdCount
 
| 0x8 * SaveDataOwnerIdCount
−
| SaveDataOwnerIds
+
| [5.0.0+] SaveDataOwnerIds
 
|}
 
|}
   Line 532: Line 552:  
|  
 
|  
 
|-
 
|-
−
| 36-61
+
| 36
 +
| MoveCacheStorage
 +
|
 +
|-
 +
| 37
 +
| DeviceTreeBlob
 +
|
 +
|-
 +
| 38
 +
| NotifyErrorContextServiceReady
 +
|
 +
|-
 +
| 39-61
 
| Reserved
 
| Reserved
 
|  
 
|  
Line 737: Line 769:  
| RegionIsReadOnly2
 
| RegionIsReadOnly2
 
|}
 
|}
−
  −
MemoryRegionMap is supported by the kernel but not by [[Loader_services|Loader]]. Thus, only initial processes may possess this capability.
      
== EnableInterrupts ==
 
== EnableInterrupts ==
Line 780: Line 810:  
|}
 
|}
   −
This is compared with 0x80000, when less than an error is returned. This is equivalent to comparing the bits starting at bit15 with 0x10. This enforces a minimum required version, not a maximum.
+
This encodes the intended kernel version for the program.
 +
 
 +
The kernel requires that the intended version is >= the minimum supported version (3.0 for all released kernels), and <= the current version.
 +
 
 +
Kernel version is derived from/equivalent to SDK version:
 +
* Kernel Major = SDK Major + 4
 +
* Kernel Minor = SDK Minor
    
=== Versions ===
 
=== Versions ===
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
−
! Firmware || Kernel Version || Minimum Allowed
+
! Firmware || Kernel Version || Corresponding SDK Version
 +
|-
 +
| 1.0.0 || 5.0 || 1.0.0.0
 +
|-
 +
| 2.0.0 || 6.1 || 2.1.0.0
 +
|-
 +
| 3.0.0 || 7.4 || 3.4.0.0
 
|-
 
|-
−
| 1.0.0 || 5.0.0 || 3.0.0
+
| 3.0.2 || 7.4 || 3.4.0.0
 
|-
 
|-
−
| 2.0.0 || 6.1.0 || 3.0.0
+
| 5.0.0 || 9.3 || 5.3.0.0
 
|-
 
|-
−
| 3.0.0 || 7.4.0 || 3.0.0
+
| 10.0.0 || 14.4 || 10.4.0.0
 
|-
 
|-
−
| 3.0.2 || 7.4.0 || 3.0.0
+
| 11.0.0 || 15.4 || 11.4.0.0
 
|-
 
|-
−
| 5.0.0 || 9.3.0 || 3.0.0
+
| 11.0.1 || 15.4 || 11.4.0.0
 
|}
 
|}
   Line 818: Line 860:  
|-
 
|-
 
| 18
 
| 18
−
| ForceDebug
+
| [19.0.0+] ForceDebugProd ([1.0.0-18.1.0] ForceDebug)
 +
|-
 +
| 19
 +
| [19.0.0+] ForceDebug
 
|}
 
|}
Retrieved from "https://switchbrew.org/wiki/Special:MobileDiff/8896...13036"