Wiki: Create Spoke Page for Build - BootImageBuilder-Internals

[LSantha]

Goal

Document the BootImageBuilder (The JNode Linker).

Instructions

1. Use the Skill: Apply update-wiki.
2. Note: Already on the index. UPDATE the row.
3. Research: Analyze org.jnode.build.x86.BootImageBuilder.
4. Content: Describe the binary layout of the boot image, how classes are pre-resolved, and how the native kernel is entry-pointed.

[LSantha]

/oc Please proceed with this task.

[LSantha]

/oc Please proceed with this task.

[LSantha]

/oc Please proceed with this task.

[opencode-agent]

Task complete. The Build---BootImageBuilder-Internals.md page has been updated with:

• Binary layout: Complete memory diagram with exact offset formulas (JUMP_MAIN_OFFSET32/64), Multiboot header structure, boot heap placement
• Class pre-resolution pipeline: VmType.initializeForBootImage(), multi-pass compileClasses() loop, prepareAfterBootstrap(), loadFromBootClassArray() with code snippets
• Native kernel entry-pointing: Full sequence from GRUB → kernel.asm → _$$introCode → initVm() → initMain() → initVmThread() → Main.vmMain(), including STATICS register setup
• Jump table initialization: 32/64-bit architecture differences
• Gotchas: 6 non-obvious behaviors documented

Wiki page: https://github.com/LSantha/jnode_ai/wiki/Build---BootImageBuilder-Internals

opencode session  |  github run