1RGBASM(1)                 BSD General Commands Manual                RGBASM(1)
2

NAME

4     rgbasm — Game Boy assembler
5

SYNOPSIS

7     rgbasm [-Ehvw] [-b chars] [-D name[=value]] [-g chars] [-i path]
8            [-M dependfile] [-o outfile] [-p pad_value] file
9

DESCRIPTION

11     The rgbasm program creates an object file from an assembly source file.
12     Its arguments are as follows:
13
14     -b chars
15             Change the two characters used for binary constants.  The
16             defaults are 01.
17
18     -D name[=value]
19             Add string symbol to the compiled source code. This is equivalent
20             to name EQUS "value" in code. If a value is not specified, a
21             value of 1 is given.
22
23     -E      Export all labels, including unreferenced and local labels.
24
25     -g chars
26             Change the four characters used for binary constants.  The
27             defaults are 0123.
28
29     -h      By default, rgbasm inserts a ‘nop’ instruction immediately after
30             any ‘halt’ instruction.  The -h option disables this behavior.
31
32     -i path
33             Add an include path.
34
35     -M dependfile
36             Print make(1) dependencies to dependfile.
37
38     -o outfile
39             Write an object file to the given filename.
40
41     -p pad_value
42             When padding an image, pad with this value.  The default is 0x00.
43
44     -v      Be verbose.
45
46     -w      Disable warning output.
47

EXAMPLES

49     Assembling a basic source file is simple:
50
51           $ rgbasm -o bar.o foo.asm
52
53     The resulting object file is not yet a usable ROM image — it must first
54     be run through rgblink(1) and rgbfix(1).
55

SEE ALSO

57     rgbasm(5), rgbfix(1), rgblink(1), rgbds(5), rgbds(7), gbz80(7)
58

HISTORY

60     rgbasm was originally written by Carsten Sørensen as part of the ASMotor
61     package, and was later packaged in RGBDS by Justin Lloyd. It is now main‐
62     tained by a number of contributors at .:
63           https://github.com/rednex/rgbds
64
65RGBDS Manual                    April 17, 2017                    RGBDS Manual
Impressum