1RGBASM(1) BSD General Commands Manual RGBASM(1)
2
4 rgbasm — Game Boy assembler
5
7 rgbasm [-Ehvw] [-b chars] [-D name[=value]] [-g chars] [-i path]
8 [-M dependfile] [-o outfile] [-p pad_value] file
9
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
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
57 rgbasm(5), rgbfix(1), rgblink(1), rgbds(5), rgbds(7), gbz80(7)
58
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