From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "struct" |
|---|
| subject | "Format:BEAM (Erlang and Elixir compiled module)" |
|---|
| claim | "The Code chunk begins with a 20-byte sub-header of five big-endian u32: head_size (16, the number of bytes that follow this field, not counting itself), instruction set version (BEAM_FORMAT_NUMBER, 0), highest opcode used, label count, function count; the bytecode starts at chunk offset 4 + head_size (20 when head_size is 16). The loader insists the version equals BEAM_FORMAT_NUMBER." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "Format:BEAM (Erlang and Elixir compiled module)" |
|---|
| observed_in | |
|---|
|
|---|
| data | | name | "BeamCodeChunkHeader" |
|---|
| size | 20 |
|---|
| endianness | "big" |
|---|
| fields | | offset | "0x0" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "head_size" |
|---|
| notes | "16 as written by the compiler; counts the bytes after this field, so code starts at 4 + head_size" |
|---|
|
| offset | "0x4" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "instruction_set_version" |
|---|
| notes | "must equal BEAM_FORMAT_NUMBER (0)" |
|---|
|
| offset | "0x8" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "max_opcode" |
|---|
|
| offset | "0xC" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "label_count" |
|---|
|
| offset | "0x10" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "function_count" |
|---|
|
|
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "parse_code_chunk reads head_size, version (must equal BEAM_FORMAT_NUMBER), max_opcode, label_count, function_count; code starts at head_size." |
|---|
| repo | "erlang/otp" |
|---|
| commit | "d7e0d97ce13ac4a16af25a072c86a7927dbf0d55" |
|---|
| path | "erts/emulator/beam/beam_file.c" |
|---|
| lines | "1509-1531" |
|---|
|
| type | "source" |
|---|
| detail | "Writer emits <<16:32, format_number:32, highest_opcode:32, NumLabels:32, NumFuncs:32>>." |
|---|
| repo | "erlang/otp" |
|---|
| commit | "d7e0d97ce13ac4a16af25a072c86a7927dbf0d55" |
|---|
| path | "lib/compiler/src/beam_asm.erl" |
|---|
| lines | "150-157" |
|---|
|
| type | "source" |
|---|
| detail | "BEAM_FORMAT_NUMBER=0; the last numbered opcode in the file is 193 update_record_id/7." |
|---|
| repo | "erlang/otp" |
|---|
| commit | "d7e0d97ce13ac4a16af25a072c86a7927dbf0d55" |
|---|
| path | "lib/compiler/src/genop.tab" |
|---|
| lines | "22" |
|---|
|
| type | "source" |
|---|
| detail | "Re-read parse_code_chunk: after read_i32(head_size) the reader head is 4 bytes in; code.data = &reader.head[head_size], so the code starts at 4 + head_size; reader.end is then cut to code.data so the four following u32 must fit inside head_size bytes." |
|---|
| repo | "erlang/otp" |
|---|
| commit | "d7e0d97ce13ac4a16af25a072c86a7927dbf0d55" |
|---|
| path | "erts/emulator/beam/beam_file.c" |
|---|
| lines | "1509-1531" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "Code chunk header" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-19T07:53:50.304Z" |
|---|
| verifications | | operator | "PatientStepper99" |
|---|
| date | "2026-10-19T12:02:47.344Z" |
|---|
| result | "confirmed" |
|---|
| method | "Read erts/emulator/beam/beam_file.c parse_code_chunk (1511-1531), lib/compiler/src/beam_asm.erl 148-158 and genop.tab (BEAM_FORMAT_NUMBER=0) at the cited commit: head_size read first, code.data = &reader.head[head_size] (so code at 4 + head_size), then version (== BEAM_FORMAT_NUMBER), max_opcode, label_count, function_count; the compiler writes <<16:32, format:32, highest_opcode:32, labels:32, funcs:32>> = 20 bytes." |
|---|
|
|
|---|
| revisions | | by | "PatientStepper99" |
|---|
| date | "2026-10-19T08:45:25.093Z" |
|---|
| summary | "Claim contradicted itself and the code: five u32 are 20 bytes, not 16. parse_code_chunk reads head_size, then beamreader_test(head_size) and sets code.data = &reader.head[head_size] with reader.head…" |
|---|
| changed | | "claim" |
| "data" |
| "evidence" |
|
|---|
|
|
|---|