Nintendo Switch Brew

NRO: Difference between revisions

← Older edit
No edit summary
No edit summary
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Category:File formats]]
NRO is the executable format for non-[[ExeFS]] binaries.
NRO is the executable format for non-[[ExeFS]] binaries.


It starts with the NRO-start structure then the "NRO" header and mainly describes .text, .rodata, and .data segments (like a short-form of ELF program headers):
It starts with the NRO-start structure then the "NRO" header and mainly describes .text, .rodata, and .data segments (like a short-form of ELF program headers).
 
= NroHeader =
This is "nn::ro::detail::NroHeader".


= NRO Start =
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 12: Line 13:
|-
|-
| 0x0
| 0x0
| 0x10
| [[#RocrtHeader|Rocrt]]
|-
| 0x10
| 0x4
| Signature ("NRO0")
|-
| 0x14
| 0x4
| Version
|-
| 0x18
| 0x4
| 0x4
| Unused
| Size (total NRO file size)
|-
|-
| 0x1C
| 0x4
| 0x4
| Flags
|-
| 0x20
| 0x4
| 0x4
| [[NSO|MOD0]] offset
| TextMemoryOffset
|-
|-
| 0x8
| 0x24
| 0x8
| 0x4
| Padding
| TextSize
|}
|-
 
| 0x28
= NRO Header =
| 0x4
{| class="wikitable" border="1"
| RoMemoryOffset
|-
| 0x2C
| 0x4
| RoSize
|-
|-
! Offset
| 0x30
! Size
| 0x4
! Description
| DataMemoryOffset
|-
|-
| 0x0
| 0x34
| 0x4
| 0x4
| Magic "NRO0"
| DataSize
|-
|-
| 0x38
| 0x4
| 0x4
| BssSize
|-
| 0x3C
| 0x4
| 0x4
| ?
| Reserved
|-
| 0x40
| 0x20
| [[#ModuleId|ModuleId]]
|-
|-
| 0x8
| 0x60
| 4
| 0x4
| size (Total NRO filesize)
| DsoHandleOffset
|-
|-
| 0xC
| 0x64
| 0x4
| 0x4
| ?
| Reserved
|-
|-
| 0x10
| 0x68
| 0x8 * 3
| 0x4
| SegmentHeader[3]
| EmbeddedOffset
|-
|-
| 0x28
| 0x6C
| 0x4
| 0x4
| bssSize
| EmbeddedSize
|-
|-
| 0x2C
| 0x70
| 0x4
| 0x4
| ?
| DynStrOffset
|-
|-
| 0x30
| 0x74
| 0x20
| 0x4
| Value of "build id" from ELF's GNU .note section. Contains variable sized digest, up to 32bytes.
| DynStrSize
|-
|-
| 0x50
| 0x78
| 0x10
| 0x4
| Padding
| DynSymOffset
|-
|-
| 0x60
| 0x7C
| 0x10
| 0x4
| ?
| DynSymSize
|}
|}


== SegmentHeader ==
== RocrtHeader ==
This is "nn::ro::detail::RocrtHeader".
 
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 80: Line 111:
|-
|-
| 0x0
| 0x0
| 0x4
| [17.0.0+] 0xC ([1.0.0-16.1.0] 0x8)
| FileOffset
| [[MOD#ModuleHeaderLocation|ModuleHeaderLocation]]
|-
|-
| 0xC
| 0x4
| 0x4
| 0x4
| Reserved
| Size
|}
|}


=Assets=
== ModuleId ==
This is "nn::ro::detail::ModuleId".
 
Value of "build id" from ELF's GNU .note section. Contains variable sized digest, up to 32bytes.
 
= Homebrew =
== Assets ==
This is an optional custom assets section for homebrew, this is located at file offset {NroHeader.size}. See also [https://github.com/switchbrew/switch-tools switch-tools] for implementation.
This is an optional custom assets section for homebrew, this is located at file offset {NroHeader.size}. See also [https://github.com/switchbrew/switch-tools switch-tools] for implementation.


The below offsets are relative to the beginning of the assets section (AssetHeader).
The below offsets are relative to the beginning of the assets section (AssetHeader).


== AssetHeader ==
=== AssetHeader ===
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 109: Line 146:
|-
|-
| 0x8
| 0x8
| 0x8
| 0x10
| AssetSection icon. Used by the Homebrew Launcher. Like official icons, this is a 256x256 JPEG.
| AssetSection icon. Used by the Homebrew Launcher. Like official icons, this is a 256x256 JPEG.
|-
|-
| 0x18
| 0x10
| 0x10
| 0x8
| AssetSection [[NACP_Format|NACP]]. Used by the Homebrew Launcher.
| AssetSection [[Control.nacp|nacp]]. Used by the Homebrew Launcher.
|-
|-
| 0x18
| 0x28
| 0x8
| 0x10
| AssetSection romfs. Can be used by the application.
| AssetSection romfs. Can be used by the application.
|-
|}
|}


== AssetSection ==
=== AssetSection ===
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 130: Line 166:
|-
|-
| 0x0
| 0x0
| 0x4
| 0x8
| Offset
| Offset
|-
|-
| 0x4
| 0x8
| 0x4
| 0x8
| Size
| Size, 0 indicates this section is empty.
|}
|}
Retrieved from "https://switchbrew.org/wiki/NRO"