Global / Singleton Address Index

Binary: extracted/aws-neuronx-runtime-lib_2.31.24.0-0b044f4ce_amd64/opt/aws/neuron/lib/libnrt.so → libnrt.so.1 → libnrt.so.2.31.24.0 · Version 2.31.24.0-0b044f4ce (.nrt_brazil_version @0xad41f0 = "2.31.24.0") · BuildID[sha1] 8bb57aba0fb2e0035f1d88e9fc4fb3e7387c102e · ELF64 LSB DYN x86-64, NOT stripped, DWARF v4.

Part XVI — Appendices / REFERENCE lookup index · every address/size below is the nm -nS --defined-only / readelf -rW value carried by the Globals and Singletons Atlas; this page re-sorts those audited values by address for symbol→addr→page lookup.

Abstract

This is the flat, address-sorted lookup index to libnrt.so's writable global state. The companion Globals and Singletons Atlas is the explanatory map — it groups the same globals by kind (config singletons, per-arch ops vtables, dlopen handle tables, error/status globals, dispatch/jump tables) and carries the full init-by / read-by provenance and the reimplementation rationale. This page does the opposite job: it dumps every significant global into one table sorted by ascending address, so a reader who has an address from a disassembler — or a symbol name and wants its address, size, section, and owning page — gets the answer in a single scan. The atlas explains; this page indexes. The two share one set of nm-verified addresses by construction.

Every address here is read from this exact binary (nm -nS --defined-only for symbol/addr/size/section nibble, readelf -rW for the .data.rel.ro R_X86_64_RELATIVE relocations that wire each pointer slot) and is identical to the value the atlas carries; where the working notes and the atlas disagreed, the atlas's nm-verified value is authoritative and is the one indexed here (see the CORRECTION callout). The single structural fact that governs the table: the .bss symbols are NOBITS — zero on disk. The per-arch vtables (kaena_khal, tdrv_arch_ops, the csr_regions_v*) and the dlsym function-pointer stores have no bytes in the file; their slots exist only as stores emitted inside the lazily-run register_* / *_init / ucode_init_module installers. An address into one of those symbols is reconstructable from the installer's decompiled stores, never from a static hexdump.

Section-band legend

The Kind column classifies each global by the section discipline established in Binary Layout and the atlas. Three bands carry first-party state; read the band to know whether a structure is static-in-file or runtime-filled.

NOTE — this page indexes; the atlas explains. The init-by (which constructor or register_* installer first writes a valid value) and read-by (the principal consumer) of every row below are owned by the Globals and Singletons Atlas, grouped by kind. Do not re-derive that provenance from this table — it carries only the lookup keys (symbol, addr, size, section, kind) plus the owning page. Follow the atlas link for the installer chain and the per-global GOTCHA/QUIRK notes.

Address-sorted master index

One row per significant first-party global, sorted by ascending address. Section is the nm band; Kind is the section-discipline class (RELRO seed / RELRO dlsym dir / const dispatch / mutable singleton / per-arch vtable / dlsym store / per-engine array / lock / handle). Owning page is the exact SUMMARY path that documents the global's semantics or per-slot geometry. Conf mirrors the atlas's confidence.

GOTCHA — ctx_vtpb_core_size (0xcabb40) sorts just below stream_locks (0xcabb60). The vtpb init-guard scalar lives at 0xcabb40, immediately below the ndebug stream_locks array at 0xcabb60 — two unrelated subsystems are adjacent in .bss. Address adjacency in .bss is the linker's bookkeeping, not a semantic grouping; index by symbol, never by neighbour. The owning-page column is the only reliable grouping.

QUIRK — the named dlsym stores are address ranges, not single symbols. The ucode store (0xc96a48–0xc96b30, 30×8) and the libnccom store (0xc967b8–0xc968d8, 37×8) each carry one named .bss symbol per slot (ucode_lib_get_api_level, neuronInitComm, …) rather than one array symbol. They are indexed here as a single row per range; the per-slot name→symbol mapping is in the atlas dlopen-handle-tables section and the ucode facade.

CORRECTION (GLOBALS-INDEX, nccl error block) — the working notes placed libnccl_net_err_msg (0xc96420) as the only nccl error global and described nccl_init_error as an ostringstream. The nm -nS-verified atlas adds libnccl_net_errno @0xc96620, libnccl_net_handle @0xc96628, and the libnccom fn-ptr store @0xc967b8, and corrects nccl_init_error @0xc96640 to a plain 0x178-byte capture object (not an ostringstream). This index uses the atlas's verified addresses and types throughout.

NOTE — vendored third-party statics are out of scope here. The protobuf descriptor_table_* objects, abseil kOperatorList/kBuiltinTypeList, Rust CONTEXTS/MAPPINGS_CACHE, simdjson jump_table, and libarchive fileflags that also occupy .data.rel.ro/.data/.bss are boundary context, indexed by the Vendored-Library SBOM and listed in the atlas vendored-statics section. This index covers first-party runtime globals only.

Cross-References

• Globals and Singletons Atlas — the explanatory map this page indexes; groups these globals by kind and carries the per-global init-by / read-by provenance, the installer chains, and the GOTCHA/QUIRK notes
• Binary Layout — the .data.rel.ro / .data / .bss section geometry, the VMA==file-offset (delta 0) invariant, and the table-location map that places each global class in its band
• Dispatch-Table Taxonomy — the per-arch vtable dispatch shape, the 222 standing data tables, and the .rodata jump-offset spill arrays this index references but does not list
• Subsystem ↔ Binary ↔ Source-TU Matrix — the subsystem-to-source-TU map that names the translation unit (nrt_config.cpp, enc.cc, vtpb.c, async_sr.cc, …) behind each owning page in the index