RGBDS(5) File Formats Manual RGBDS(5) (NAME) rgbds - (DESCRIPTION) RGB rgbasm(1) rgblink(1) . (FILE STRUCTURE) : LONG (little-endian) . BYTE . STRING BYTE 0 . ( LONG[n]) n ( LONG). (padding) -- ! REPT n REPT ENDR n . Symbols . Source file info /bin/zsh . () () -- (ID). (Header) BYTE Magic[4] "RGB9" LONG RevisionNumber . ( .) LONG NumberOfSymbols . LONG NumberOfSections . (Source file info) LONG NumberOfNodes . REPT NumberOfNodes LONG ParentID -1 . : 0 ! LONG ParentLineNo . BYTE Type 0 6 : Value Meaning 0 REPT 1 File 2 Macro 7 "" ( "Excluding locations from backtraces" rgbasm(5) ). IF Type != 0 REPT ... STRING Name : ( `src/includes/defines.asm::error'). ELSE REPT REPT . LONG Depth LONG Iter[Depth] REPT . ENDC ENDR (Symbols) REPT NumberOfSymbols STRING Name . (`Scope.symbol'). BYTE Type Value Meaning 0 Local . 1 Import ( ) . 2 Exported . IF Type != 1 ... LONG NodeID . LONG LineNo . LONG SectionID . ( ) -1 . LONG Value . . ENDC ENDR (Sections) REPT NumberOfSections STRING Name . LONG NodeID . LONG LineNo . LONG Size . BYTE Type 0 2 : Value Meaning 0 WRAM0 1 VRAM 2 ROMX 3 ROM0 4 HRAM 5 WRAMX 6 SRAM 7 OAM 7 "union" ( "Unionized sections" rgbasm(5) ). 6 "fragment" ( "Section fragments" rgbasm(5) ). . LONG Address . Type ( -t - -d - rgblink(1)), -1 ( " "). LONG Bank . Type -1 . BYTE Alignment AlignOfs . LONG AlignOfs . `1 << Alignment' . IF Type = 2 || Type = 3 ROM . BYTE Data[Size] . . LONG NumberOfPatches Data . REPT NumberOfPatches LONG NodeID . LONG LineNo . LONG Offset Data . Size (Type ). LONG PCSectionID (PC) . ( `LOAD' "RAM code" rgbasm(5) .) LONG PCOffset PC PCSectionID . PC ( `jp @' ) (`db', `dw', `dl'). BYTE Type Value Meaning 0 1 2 3 `jr' PC + 2 ( `jr @' `18 FE' ) . LONG RPNSize RPNExpr . BYTE RPNExpr[RPNSize] RPN (RPN expressions ). ENDR ENDC (Assertions) LONG NumberOfAssertions . REPT NumberOfAssertions . LONG NodeID . LONG LineNo . LONG Offset . LONG PCSectionID PC . LONG PCOffset PC PCSectionID. BYTE Type . Value Meaning 0 . 1 . 2 . LONG RPNSize RPNExpr . BYTE RPNExpr[RPNSize] RPN (RPN expressions ). STRING Message . . ENDR RPN (RPN expressions) RPN " " . `2 5 -' "2" "5". `-' ("3") . RPN . RGBDS RPN BYTE . BYTE : Value Meaning /bin/zsh (`+') (`-') (`*') (`/') (`%') (`- ') (`**') OR (`|') AND (`&') XOR (`^') (`~ ') AND (`&&') OR (`||') (`! ') (`==') (`!=') (`>') (`<') (`>=') (`<=') (`<<') / (`>>') / (`>>>') BANK(symbol, ) LONG symbol. BANK(section, ) STRING section. BANK(, , PC) ( `BANK(@)'). SIZEOF(section, ) STRING section. STARTOF(section, ) STRING section. SIZEOF(sectiontype, ) BYTE sectiontype ( Type Sections ). STARTOF(sectiontype, ) BYTE sectiontype ( Type Sections ). `ldh'. `ldh' ("Load Instructions" gbz80(7) ), /bin/zsh . /bin/zshFF AND (`&'). `rst'. `rst' ("RST vec" gbz80(7) ), /bin/zsh . OR (`|'). `bit/res/set' BYTE . ( "BIT u3, r8" gbz80(7) ), 0 7. OR . HIGH. LOW. BITWIDTH. TZCOUNT. LONG. LONG . (SEE ALSO) rgbasm(1), rgbasm(5), rgblink(1), rgblink(5), rgbfix(1), rgbgfx(1), gbz80(7), rgbds(7) (HISTORY) rgbasm(1) rgblink(1) Carsten Sorensen ASMotor RGBDS Justin Lloyd . https://github.com/gbdev/rgbds . Linux 6.12.107+deb13-amd64 August 1, 2026 Linux 6.12.107+deb13-amd64