-h Help (this text)
-l Create an assembler listing
-m name Create a map file
+ -mm model Set the memory model
-o name Name the output file
-r Enable register variables
-t sys Set the target system
+ -u sym Force an import of symbol `sym'
-v Verbose mode
-vm Verbose map file
- -A Strict ANSI mode
-C name Use linker config file
-Cl Make local variables static
-D sym[=defn] Define a preprocessor symbol
-I dir Set a compiler include directory path
+ -L path Specify a library search path
-Ln name Create a VICE label file
-O Optimize code
-Oi Optimize code, inline functions
-T Include source as comment
-V Print the version number
-W Suppress warnings
+ -Wa options Pass options to the assembler
+ -Wl options Pass options to the linker
Long options:
--add-source Include source as comment
- --ansi Strict ANSI mode
+ --asm-args options Pass options to the assembler
+ --asm-define sym[=v] Define an assembler symbol
--asm-include-dir dir Set an assembler include directory
--bss-label name Define and export a BSS segment label
--bss-name seg Set the name of the BSS segment
+ --cfg-path path Specify a config file search path
--check-stack Generate stack overflow checks
--code-label name Define and export a CODE segment label
--code-name seg Set the name of the CODE segment
--codesize x Accept larger code by factor x
+ --config name Use linker config file
--cpu type Set cpu type
--create-dep Create a make dependency file
--data-label name Define and export a DATA segment label
--debug Debug mode
--debug-info Add debug info
--feature name Set an emulation feature
+ --force-import sym Force an import of symbol `sym'
+ --forget-inc-paths Forget include search paths (compiler)
--help Help (this text)
--include-dir dir Set a compiler include directory path
+ --ld-args options Pass options to the linker
+ --lib file Link this library
+ --lib-path path Specify a library search path
+ --list-targets List all available targets
--listing Create an assembler listing
+ --list-bytes n Number of bytes per assembler listing line
--mapfile name Create a map file
+ --memory-model model Set the memory model
--module Link as a module
--module-id id Specify a module id for the linker
--o65-model model Override the o65 model
+ --obj file Link this object file
+ --obj-path path Specify an object file search path
--register-space b Set space available for register variables
--register-vars Enable register variables
--rodata-name seg Set the name of the RODATA segment
--signed-chars Default characters are signed
+ --standard std Language standard (c89, c99, cc65)
--start-addr addr Set the default start address
--static-locals Make local variables static
--target sys Set the target system
The default for this option is different from the compiler and linker in the
case that the option is missing: While the other tools (compiler, assembler
and linker) will use the "none" system settings by default, cl65 will use
- the C64 as a target system by default. This was choosen since most people
+ the C64 as a target system by default. This was chosen since most people
seem to use cc65 to develop for the C64.
+ <tag><tt>-Wa options, --asm-args options</tt></tag>
+
+ Pass options directly to the assembler. This may be used to pass options
+ that aren't directly supported by cl65. Several options may be separated by
+ commas, the commas are replaced by spaces when passing them to the
+ assembler. Beware: Passing arguments directly to the assembler may interfere
+ with some of the defaults, because cl65 doesn't parse the options passed. So
+ if cl65 supports an option by itself, do not pass this option to the
+ assembler by means of the <tt/-Wa/ switch.
+
+ <tag><tt>-Wl options, --ld-args options</tt></tag>
+
+ Pass options directly to the linker. This may be used to pass options that
+ aren't directly supported by cl65. Several options may be separated by
+ commas, the commas are replaced by spaces when passing them to the linker.
+ Beware: Passing arguments directly to the linker may interfere with some of
+ the defaults, because cl65 doesn't parse the options passed. So if cl65
+ supports an option by itself, do not pass this option to the linker by means
+ of the <tt/-Wl/ switch.
+
</descrip>
extension. So you don't need to name the executable name in most
cases, just give the name of your "main" file as first input file.
</itemize>
-
+
The type of an input file is derived from its extension:
<itemize>
</itemize>
Please note that the program cannot handle input files with unknown file
-extensions.
+extensions.
<sect>Examples<p>
<sect>Copyright<p>
-cl65 (and all cc65 binutils) are (C) Copyright 1998-2000 Ullrich von
+cl65 (and all cc65 binutils) are (C) Copyright 1998-2004 Ullrich von
Bassewitz. For usage of the binaries and/or sources the following
conditions do apply:
projects / cc65 / blobdiff