rumpk/core/loader/elf.nim

85 lines
2.0 KiB
Nim

# SPDX-License-Identifier: LSL-1.0
# Copyright (c) 2026 Markus Maiwald
# Stewardship: Self Sovereign Society Foundation
#
# This file is part of the Nexus Sovereign Core.
# See legal/LICENSE_SOVEREIGN.md for license terms.
## Rumpk Layer 1: ELF Binary Parser
# MARKUS MAIWALD (ARCHITECT) | VOXIS FORGE (AI)
# ELF64 Header Definitions for Rumpk Summoning
type
Elf64_Ehdr* {.packed.} = object
e_ident*: array[16, uint8]
e_type*: uint16
e_machine*: uint16
e_version*: uint32
e_entry*: uint64
e_phoff*: uint64
e_shoff*: uint64
e_flags*: uint32
e_ehsize*: uint16
e_phentsize*: uint16
e_phnum*: uint16
e_shentsize*: uint16
e_shnum*: uint16
e_shstrndx*: uint16
Elf64_Phdr* {.packed.} = object
p_type*: uint32
p_flags*: uint32
p_offset*: uint64
p_vaddr*: uint64
p_paddr*: uint64
p_filesz*: uint64
p_memsz*: uint64
p_align*: uint64
Elf64_Shdr* {.packed.} = object
sh_name*: uint32
sh_type*: uint32
sh_flags*: uint64
sh_addr*: uint64
sh_offset*: uint64
sh_size*: uint64
sh_link*: uint32
sh_info*: uint32
sh_addralign*: uint64
sh_entsize*: uint64
const
PT_LOAD* = 1
PT_NOTE* = 4
PF_X* = 1
PF_W* = 2
PF_R* = 4
# SPEC-071: BKDL (Binary Manifest) types
const
BKDL_MAGIC* = 0x4E585553'u32 # "NXUS" (little-endian)
BKDL_VERSION* = 1'u16
type
BkdlHeader* {.packed.} = object
magic*: uint32
version*: uint16
flags*: uint16
signature*: array[64, uint8] # Ed25519 (unchecked in dev mode)
pubkey_hash*: array[32, uint8] # SHA-256 of signing key
cap_count*: uint16
blob_size*: uint32
entry_point*: uint64 # 0 = use ELF e_entry
CapDescriptor* {.packed.} = object
cap_type*: uint8 # CapType enum value
perms*: uint8 # Permission bitmask
reserved*: uint16 # Alignment padding
resource_id*: uint64 # SipHash of resource name
ManifestResult* = object
header*: ptr BkdlHeader
caps*: ptr UncheckedArray[CapDescriptor]
count*: int