RGBLINK(1) General Commands Manual RGBLINK(1) (NAME) rgblink - Game Boy (SYNOPSIS) rgblink [-dhMtVvwx] [-B param] [--color when] [-l linker_script] [-m map_file] [-n sym_file] [-O overlay_file] [-o out_file] [-p pad_value] [-S spec] [-W warning] file ... (DESCRIPTION) rgblink RGB rgbasm(1) ROM Game Boy . rgbds(5) . ROM0 ROM ROMX "" . ROM -t . WRAM0 WRAM (" ") WRAMX . ROM WRAM -w . ROM Game Boy -d -w VRAM . (ARGUMENTS) rgblink -V --version . . : --verb --verbose --ver --version . `-' ( ) rgblink ( ) ( ) . `-' `./-' . . rgblink . `$' `0x' `&' `0o' `%' `0b' . ( `$' `&' .) ( ) . : `42', `042', `0x2A', `0X2A', `0x2a', `&52', `0o52', `0O052', `0b00101010', `0B101010'. : -B param, --backtrace param . . param . : 0 . all <<>> ( "Excluding locations from backtraces" rgbasm(5) ). no-all << >> . collapse . no-collapse . --color when : `always', `never', `auto'. `auto' `NO_COLOR: https://no-color.org' `FORCE_COLOR: https://force-color.org' TTY . -d, --dmg DMG. DMG VRAM . -w . -h, --help . ( COLUMNS TTY .) -l linker_script, --linkerscript linker_script ROM . . rgblink(5) . -M, --no-sym-in-map . -m map_file, --map map_file . -n sym_file, --sym sym_file . : https://rgbds.gbdev.io/sym . ROM. -O overlay_file, --overlay overlay_file << >> ROM overlay_file : overlay_file . ROM . ( ) ! -o out_file, --output out_file ROM . -p pad_value, --pad pad_value . 0 . -S spec, --scramble spec "" . spec . -t, --tiny ROM0 ROM . ROMX ROMX ROM0 . ROM . -V, --version . -v, --verbose . : 1. rgblink . 2. . 3. . 4. . 5. . . RGBDS . -W warning, --warning warning warning. warning . (DIAGNOSTICS) . -w, --wramx WRAM0 WRAM . WRAMX WRAMX WRAM0 . -x, --nopad . -t . ROM . ROM -p rgbfix(1) ! @at_file . . (`#') . . . `--' at-file . `--' at-file at-file . . ( NP- << >> rgblink << >> .) . "" . ( ). . . . : region[=size] region size . region ( ) size . . romx 65535 sram 255 wramx 7 size . `romx=64,wramx,sram=4' ROMX ROM WRAMX RAM SRAM SRAM . `romx=42, Romx=0' romx . wramx -w ( -d ) WRAMX WRAM0 . (DIAGNOSTICS) . . -Werror . -Wno-error . -Werror= - . (: -Werror=obsolete -) . -Wno-error= -Werror . - ("meta") . . . -Wall . -Weverything . . ( -Wobsolete -Wno-obsolete -Wall -Wno-all ). . "no-" . -Wno-assert WARN . ( ASSERT "Aborting the assembly process" rgbasm(5) ). -Wdiv (-2**31) -1 . -Wall . -Wno-large-constant . -Wno-obsolete . -Wshift . 2**N . -Wall . -Wshift-amount . -Wall . -Wtruncation= ( db ) . -Wtruncation=0 -Wno-truncation . -Wtruncation=1 -Wtruncation N 2**N -2**N . -Wtruncation=2 N -2**(N-1) . (EXAMPLES) ROM ROM : $ rgblink -o bar.gb foo.o bar.gb ( ). rgbfix(1) Game Boy : $ rgbfix -v bar.gb : $ rgblink -o bin/game.gb -n bin/game.sym -p 0xFF obj/title.o obj/engine.o (BUGS) GitHub: https://github.com/gbdev/rgbds/issues . (SEE ALSO) rgbasm(1), rgblink(5), rgbfix(1), rgbgfx(1), gbz80(7), rgbds(5), rgbds(7) (HISTORY) rgblink Carsten Sorensen ASMotor Justin Lloyd RGBDS . https://github.com/gbdev/rgbds . Linux 6.12.107+deb13-amd64 August 1, 2026 Linux 6.12.107+deb13-amd64