Difference between revisions of "NRO"

From Nintendo Switch Brew
Jump to navigation Jump to search
(Finalized NRO format. (Except the NRO start, can't seem to find where this is touched at all. Hope this helps!))
 
(4 intermediate revisions by 2 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
 
| 0x4
−
| Unused
+
| Signature ("NRO0")
 
|-
 
|-
 +
| 0x14
 
| 0x4
 
| 0x4
 +
| Version
 +
|-
 +
| 0x18
 
| 0x4
 
| 0x4
−
| [[NSO|MOD0]] offset
+
| Size (total NRO file size)
 
|-
 
|-
−
| 0x8
+
| 0x1C
−
| 0x8
+
| 0x4
−
| Padding
+
| Flags
−
|}
+
|-
−
 
+
| 0x20
−
= NRO Header =
+
| 0x4
−
{| class="wikitable" border="1"
+
| TextMemoryOffset
 +
|-
 +
| 0x24
 +
| 0x4
 +
| TextSize
 +
|-
 +
| 0x28
 +
| 0x4
 +
| RoMemoryOffset
 +
|-
 +
| 0x2C
 +
| 0x4
 +
| RoSize
 
|-
 
|-
−
! Offset
+
| 0x30
−
! Size
+
| 0x4
−
! Description
+
| DataMemoryOffset
 
|-
 
|-
−
| 0x0
+
| 0x34
 
| 0x4
 
| 0x4
−
| Magic "NRO0"
+
| DataSize
 
|-
 
|-
 +
| 0x38
 
| 0x4
 
| 0x4
 +
| BssSize
 +
|-
 +
| 0x3C
 
| 0x4
 
| 0x4
−
| NRO Format Version (Always 0)
+
| Reserved
 
|-
 
|-
−
| 0x8
+
| 0x40
−
| 4
+
| 0x20
−
| size (Total NRO filesize)
+
| [[#ModuleId|ModuleId]]
 
|-
 
|-
−
| 0xC
+
| 0x60
 
| 0x4
 
| 0x4
−
| Flags (Unused)
+
| DsoHandleOffset
 
|-
 
|-
−
| 0x10
+
| 0x64
−
| 0x8 * 3
+
| 0x4
−
| SegmentHeader[3] {.text, .ro, .data}
+
| Reserved
 
|-
 
|-
−
| 0x28
+
| 0x68
 
| 0x4
 
| 0x4
−
| bssSize
+
| EmbeddedOffset
 
|-
 
|-
−
| 0x2C
+
| 0x6C
 
| 0x4
 
| 0x4
−
| Reserved (Unused)
+
| EmbeddedSize
 
|-
 
|-
−
| 0x30
+
| 0x70
−
| 0x20
+
| 0x4
−
| Value of "build id" from ELF's GNU .note section. Contains variable sized digest, up to 32bytes.
+
| DynStrOffset
 
|-
 
|-
−
| 0x50
+
| 0x74
−
| 0x08
+
| 0x4
−
| Reserved (Unused)
+
| DynStrSize
 
|-
 
|-
−
| 0x58
+
| 0x78
−
| 0x8 * 3
+
| 0x4
−
| SegmentHeader[3] {.apiInfo, .dynstr, .dynsym}
+
| DynSymOffset
 
|-
 
|-
 +
| 0x7C
 +
| 0x4
 +
| DynSymSize
 
|}
 
|}
  
−
== SegmentHeader ==
+
== RocrtHeader ==
 +
This is "nn::ro::detail::RocrtHeader".
 +
 
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 81: 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 115: Line 151:
 
| 0x18
 
| 0x18
 
| 0x10
 
| 0x10
−
| AssetSection [[Control.nacp|nacp]]. Used by the Homebrew Launcher.
+
| AssetSection [[NACP_Format|NACP]]. Used by the Homebrew Launcher.
 
|-
 
|-
 
| 0x28
 
| 0x28
 
| 0x10
 
| 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"
 
|-
 
|-

Latest revision as of 21:32, 25 September 2024

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).

NroHeader

This is "nn::ro::detail::NroHeader".

Offset Size Description
0x0 0x10 Rocrt
0x10 0x4 Signature ("NRO0")
0x14 0x4 Version
0x18 0x4 Size (total NRO file size)
0x1C 0x4 Flags
0x20 0x4 TextMemoryOffset
0x24 0x4 TextSize
0x28 0x4 RoMemoryOffset
0x2C 0x4 RoSize
0x30 0x4 DataMemoryOffset
0x34 0x4 DataSize
0x38 0x4 BssSize
0x3C 0x4 Reserved
0x40 0x20 ModuleId
0x60 0x4 DsoHandleOffset
0x64 0x4 Reserved
0x68 0x4 EmbeddedOffset
0x6C 0x4 EmbeddedSize
0x70 0x4 DynStrOffset
0x74 0x4 DynStrSize
0x78 0x4 DynSymOffset
0x7C 0x4 DynSymSize

RocrtHeader

This is "nn::ro::detail::RocrtHeader".

Offset Size Description
0x0 [17.0.0+] 0xC ([1.0.0-16.1.0] 0x8) ModuleHeaderLocation
0xC 0x4 Reserved

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 switch-tools for implementation.

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

AssetHeader

Offset Size Description
0x0 0x4 Magic "ASET"
0x4 0x4 Format version, currently 0.
0x8 0x10 AssetSection icon. Used by the Homebrew Launcher. Like official icons, this is a 256x256 JPEG.
0x18 0x10 AssetSection NACP. Used by the Homebrew Launcher.
0x28 0x10 AssetSection romfs. Can be used by the application.

AssetSection

Offset Size Description
0x0 0x8 Offset
0x8 0x8 Size, 0 indicates this section is empty.
Retrieved from "https://switchbrew.org/w/index.php?title=NRO&oldid=12899"