1 /*****************************************************************************/
5 /* Main module for the cl65 compile-and-link utility */
9 /* (C) 1999-2013, Ullrich von Bassewitz */
10 /* Roemerstrasse 52 */
11 /* D-70794 Filderstadt */
12 /* EMail: uz@cc65.org */
15 /* This software is provided 'as-is', without any expressed or implied */
16 /* warranty. In no event will the authors be held liable for any damages */
17 /* arising from the use of this software. */
19 /* Permission is granted to anyone to use this software for any purpose, */
20 /* including commercial applications, and to alter it and redistribute it */
21 /* freely, subject to the following restrictions: */
23 /* 1. The origin of this software must not be misrepresented; you must not */
24 /* claim that you wrote the original software. If you use this software */
25 /* in a product, an acknowledgment in the product documentation would be */
26 /* appreciated but is not required. */
27 /* 2. Altered source versions must be plainly marked as such, and must not */
28 /* be misrepresented as being the original software. */
29 /* 3. This notice may not be removed or altered from any source */
32 /*****************************************************************************/
36 /* Check out if we have a spawn() function on the system, or if we must use
45 /* GCC strictly follows http://c-faq.com/ansi/constmismatch.html and issues an
46 ** 'incompatible pointer type' warning - that can't be suppressed via #pragma.
47 ** The spawnvp() prototype of MinGW (http://www.mingw.org/) differs from the
48 ** one of MinGW-w64 (http://mingw-w64.sourceforge.net/) regarding constness.
49 ** So there's no alternative to actually distinguish these environments :-(
51 #define SPAWN_ARGV_CONST_CAST
52 #if defined(__MINGW32__)
54 # if !defined(__MINGW64_VERSION_MAJOR)
55 # undef SPAWN_ARGV_CONST_CAST
56 # define SPAWN_ARGV_CONST_CAST (const char* const *)
66 #if defined(HAVE_SPAWN)
76 #include "searchpath.h"
88 /*****************************************************************************/
90 /*****************************************************************************/
94 /* Struct that describes a command */
95 typedef struct CmdDesc CmdDesc;
97 char* Name; /* The command name */
99 unsigned ArgCount; /* Count of arguments */
100 unsigned ArgMax; /* Maximum count of arguments */
101 char** Args; /* The arguments */
103 unsigned FileCount; /* Count of files to translate */
104 unsigned FileMax; /* Maximum count of files */
105 char** Files; /* The files */
108 /* Command descriptors for the different programs */
109 static CmdDesc CC65 = { 0, 0, 0, 0, 0, 0, 0 };
110 static CmdDesc CA65 = { 0, 0, 0, 0, 0, 0, 0 };
111 static CmdDesc CO65 = { 0, 0, 0, 0, 0, 0, 0 };
112 static CmdDesc LD65 = { 0, 0, 0, 0, 0, 0, 0 };
113 static CmdDesc GRC = { 0, 0, 0, 0, 0, 0, 0 };
115 /* Variables controlling the steps we're doing */
116 static int DoLink = 1;
117 static int DoAssemble = 1;
119 /* The name of the output file, NULL if none given */
120 static const char* OutputName = 0;
122 /* The name of the linker configuration file if given */
123 static const char* LinkerConfig = 0;
125 /* The name of the first input file. This will be used to construct the
126 ** executable file name if no explicit name is given.
128 static const char* FirstInput = 0;
130 /* The names of the files for dependency generation */
131 static const char* DepName = 0;
132 static const char* FullDepName = 0;
134 /* Remember if we should link a module */
135 static int Module = 0;
137 /* Extension used for a module */
138 #define MODULE_EXT ".o65"
140 /* Name of the target specific runtime library */
141 static char* TargetLib = 0;
142 static int NoRTL = 0;
146 /*****************************************************************************/
147 /* Include the system specific spawn function */
148 /*****************************************************************************/
152 #if defined(NEED_SPAWN)
154 # include "spawn-amiga.inc"
156 # include "spawn-unix.inc"
162 /*****************************************************************************/
163 /* Credential functions */
164 /*****************************************************************************/
168 static void DisableAssembling (void)
175 static void DisableLinking (void)
182 static void DisableAssemblingAndLinking (void)
184 DisableAssembling ();
190 /*****************************************************************************/
191 /* Command structure handling */
192 /*****************************************************************************/
196 static char* CmdAllocArg (const char* Arg, unsigned Len)
197 /* Alloc (potentially quoted) argument */
201 /* The Microsoft docs say on spawnvp():
202 ** Spaces embedded in strings may cause unexpected behavior; for example,
203 ** passing _spawn the string "hi there" will result in the new process getting
204 ** two arguments, "hi" and "there". If the intent was to have the new process
205 ** open a file named "hi there", the process would fail. You can avoid this by
206 ** quoting the string: "\"hi there\"".
209 /* Quote argument if it contains space(s) */
210 if (memchr (Arg, ' ', Len)) {
211 Alloc = xmalloc (Len + 3);
213 memcpy (Alloc + 1, Arg, Len);
214 Alloc[Len + 1] = '"';
215 Alloc[Len + 2] = '\0';
219 Alloc = xmalloc (Len + 1);
220 memcpy (Alloc, Arg, Len);
228 static void CmdExpand (CmdDesc* Cmd)
229 /* Expand the argument vector */
231 unsigned NewMax = Cmd->ArgMax + 10;
232 char** NewArgs = xmalloc (NewMax * sizeof (char*));
233 memcpy (NewArgs, Cmd->Args, Cmd->ArgMax * sizeof (char*));
236 Cmd->ArgMax = NewMax;
241 static void CmdAddArg (CmdDesc* Cmd, const char* Arg)
242 /* Add a new argument to the command */
244 /* Expand the argument vector if needed */
245 if (Cmd->ArgCount >= Cmd->ArgMax) {
249 /* Add a copy of the new argument, allow a NULL pointer */
251 Cmd->Args[Cmd->ArgCount++] = CmdAllocArg (Arg, strlen (Arg));
253 Cmd->Args[Cmd->ArgCount++] = 0;
259 static void CmdAddArg2 (CmdDesc* Cmd, const char* Arg1, const char* Arg2)
260 /* Add a new argument pair to the command */
262 CmdAddArg (Cmd, Arg1);
263 CmdAddArg (Cmd, Arg2);
268 static void CmdAddArgList (CmdDesc* Cmd, const char* ArgList)
269 /* Add a list of arguments separated by commas */
271 const char* Arg = ArgList;
275 if (*P == '\0' || *P == ',') {
277 /* End of argument, add it */
278 unsigned Len = P - Arg;
280 /* Expand the argument vector if needed */
281 if (Cmd->ArgCount >= Cmd->ArgMax) {
285 /* Add the new argument */
286 Cmd->Args[Cmd->ArgCount++] = CmdAllocArg (Arg, Len);
288 /* If the argument was terminated by a comma, skip it, otherwise
292 /* Start over at next char */
298 /* Skip other chars */
307 static void CmdDelArgs (CmdDesc* Cmd, unsigned LastValid)
308 /* Remove all arguments with an index greater than LastValid */
310 while (Cmd->ArgCount > LastValid) {
312 xfree (Cmd->Args [Cmd->ArgCount]);
313 Cmd->Args [Cmd->ArgCount] = 0;
319 static void CmdAddFile (CmdDesc* Cmd, const char* File)
320 /* Add a new file to the command */
322 /* Expand the file vector if needed */
323 if (Cmd->FileCount == Cmd->FileMax) {
324 unsigned NewMax = Cmd->FileMax + 10;
325 char** NewFiles = xmalloc (NewMax * sizeof (char*));
326 memcpy (NewFiles, Cmd->Files, Cmd->FileMax * sizeof (char*));
328 Cmd->Files = NewFiles;
329 Cmd->FileMax = NewMax;
332 /* If the file name is not NULL (which is legal and is used to terminate
333 ** the file list), check if the file name does already exist in the file
334 ** list and print a warning if so. Regardless of the search result, add
339 for (I = 0; I < Cmd->FileCount; ++I) {
340 if (strcmp (Cmd->Files[I], File) == 0) {
342 Warning ("Duplicate file in argument list: `%s'", File);
343 /* No need to search further */
349 Cmd->Files [Cmd->FileCount++] = xstrdup (File);
351 /* Add a NULL pointer */
352 Cmd->Files [Cmd->FileCount++] = 0;
358 static void CmdInit (CmdDesc* Cmd, const char* Path, const char* Name)
359 /* Initialize the command using the given path and name of the executable */
363 FullName = (char*) xmalloc (strlen (Path) + strlen (Name) + 1);
364 strcpy (FullName, Path);
365 strcat (FullName, Name);
367 /* Remember the command */
368 Cmd->Name = xstrdup (FullName);
370 /* Use the command name as first argument */
371 CmdAddArg (Cmd, FullName);
378 static void CmdSetOutput (CmdDesc* Cmd, const char* File)
379 /* Set the output file in a command desc */
381 CmdAddArg2 (Cmd, "-o", File);
386 static void CmdSetTarget (CmdDesc* Cmd, target_t Target)
387 /* Set the output file in a command desc */
389 CmdAddArg2 (Cmd, "-t", GetTargetName (Target));
394 static void CmdPrint (CmdDesc* Cmd, FILE* F)
395 /* Output the command line encoded in the command desc */
398 for (I = 0; I < Cmd->ArgCount && Cmd->Args[I] != 0; ++I) {
399 fprintf (F, "%s ", Cmd->Args[I]);
405 /*****************************************************************************/
406 /* Target handling */
407 /*****************************************************************************/
411 static void SetTargetFiles (void)
412 /* Set the target system files */
414 /* Get a pointer to the system name and its length */
415 const char* TargetName = GetTargetName (Target);
416 unsigned TargetNameLen = strlen (TargetName);
420 /* Default RunTime Library is disabled */
424 /* Set the library file */
425 TargetLib = xmalloc (TargetNameLen + 4 + 1);
426 memcpy (TargetLib, TargetName, TargetNameLen);
427 strcpy (TargetLib + TargetNameLen, ".lib");
432 /*****************************************************************************/
434 /*****************************************************************************/
438 static void ExecProgram (CmdDesc* Cmd)
439 /* Execute a subprocess with the given name/parameters. Exit on errors. */
443 /* If in debug mode, output the command line we will execute */
445 printf ("Executing: ");
446 CmdPrint (Cmd, stdout);
450 /* Call the program */
451 Status = spawnvp (P_WAIT, Cmd->Name, SPAWN_ARGV_CONST_CAST Cmd->Args);
453 /* Check the result code */
455 /* Error executing the program */
456 Error ("Cannot execute `%s': %s", Cmd->Name, strerror (errno));
457 } else if (Status != 0) {
458 /* Called program had an error */
465 static void Link (void)
466 /* Link the resulting executable */
470 /* Since linking is always the final step, if we have an output file name
471 ** given, set it here. If we don't have an explicit output name given,
472 ** try to build one from the name of the first input file.
476 CmdSetOutput (&LD65, OutputName);
478 } else if (FirstInput && FindExt (FirstInput)) { /* Only if ext present! */
480 const char* Extension = Module? MODULE_EXT : "";
481 char* Output = MakeFilename (FirstInput, Extension);
482 CmdSetOutput (&LD65, Output);
487 /* If we have a linker config file given, add it to the command line.
488 ** Otherwise pass the target to the linker if we have one.
492 Error ("Cannot use -C and --module together");
494 CmdAddArg2 (&LD65, "-C", LinkerConfig);
496 CmdSetTarget (&LD65, TGT_MODULE);
498 CmdSetTarget (&LD65, Target);
501 /* Determine which target libraries are needed */
504 /* Add all object files as parameters */
505 for (I = 0; I < LD65.FileCount; ++I) {
506 CmdAddArg (&LD65, LD65.Files [I]);
509 /* Add the system runtime library */
511 CmdAddArg (&LD65, TargetLib);
514 /* Terminate the argument list with a NULL pointer */
515 CmdAddArg (&LD65, 0);
517 /* Call the linker */
523 static void AssembleFile (const char* File, unsigned ArgCount)
524 /* Common routine to assemble a file. Will be called by Assemble() and
525 ** AssembleIntermediate(). Adds options common for both routines and
526 ** assembles the file. Will remove excess arguments after assembly.
529 /* Set the target system */
530 CmdSetTarget (&CA65, Target);
532 /* Check if this is the last processing step */
534 /* We're linking later. Add the output file of the assembly
535 ** the the file list of the linker. The name of the output
536 ** file is that of the input file with ".s" replaced by ".o".
538 char* ObjName = MakeFilename (File, ".o");
539 CmdAddFile (&LD65, ObjName);
542 /* This is the final step. If an output name is given, set it */
544 CmdSetOutput (&CA65, OutputName);
548 /* Add the file as argument for the assembler */
549 CmdAddArg (&CA65, File);
551 /* Add a NULL pointer to terminate the argument list */
552 CmdAddArg (&CA65, 0);
554 /* Run the assembler */
557 /* Remove the excess arguments */
558 CmdDelArgs (&CA65, ArgCount);
563 static void AssembleIntermediate (const char* SourceFile)
564 /* Assemble an intermediate file which was generated by a previous processing
565 ** step with SourceFile as input. The -dep options won't be added and
566 ** the intermediate assembler file is removed after assembly.
569 /* Generate the name of the assembler output file from the source file
570 ** name. It's the same name with the extension replaced by ".s"
572 char* AsmName = MakeFilename (SourceFile, ".s");
574 /* Assemble the intermediate assembler file */
575 AssembleFile (AsmName, CA65.ArgCount);
577 /* Remove the input file */
578 if (remove (AsmName) < 0) {
579 Warning ("Cannot remove temporary file `%s': %s",
580 AsmName, strerror (errno));
583 /* Free the assembler file name which was allocated from the heap */
589 static void Assemble (const char* File)
590 /* Assemble the given file */
592 /* Remember the current assembler argument count */
593 unsigned ArgCount = CA65.ArgCount;
595 /* We aren't assembling an intermediate file, but one requested by the
596 ** user. So add a few options here if they were given on the command
599 if (DepName && *DepName) {
600 CmdAddArg2 (&CA65, "--create-dep", DepName);
602 if (FullDepName && *FullDepName) {
603 CmdAddArg2 (&CA65, "--create-full-dep", FullDepName);
606 /* Use the common routine */
607 AssembleFile (File, ArgCount);
612 static void Compile (const char* File)
613 /* Compile the given file */
615 /* Remember the current compiler argument count */
616 unsigned ArgCount = CC65.ArgCount;
618 /* Set the target system */
619 CmdSetTarget (&CC65, Target);
621 /* Check if this is the final step */
623 /* We will assemble this file later. If a dependency file is to be
624 ** generated, set the dependency target to be the final object file,
625 ** not the intermediate assembler file. But beware: There may be an
626 ** output name specified for the assembler.
628 if (DepName || FullDepName) {
629 /* Was an output name for the assembler specified? */
630 if (!DoLink && OutputName) {
631 /* Use this name as the dependency target */
632 CmdAddArg2 (&CC65, "--dep-target", OutputName);
634 /* Use the object file name as the dependency target */
635 char* ObjName = MakeFilename (File, ".o");
636 CmdAddArg2 (&CC65, "--dep-target", ObjName);
641 /* If we won't assemble, this is the final step. In this case, set
642 ** the output name if it was given.
645 CmdSetOutput (&CC65, OutputName);
649 /* Add the file as argument for the compiler */
650 CmdAddArg (&CC65, File);
652 /* Add a NULL pointer to terminate the argument list */
653 CmdAddArg (&CC65, 0);
655 /* Run the compiler */
658 /* Remove the excess arguments */
659 CmdDelArgs (&CC65, ArgCount);
661 /* If this is not the final step, assemble the generated file, then
665 /* Assemble the intermediate file and remove it */
666 AssembleIntermediate (File);
672 static void CompileRes (const char* File)
673 /* Compile the given geos resource file */
675 /* Remember the current assembler argument count */
676 unsigned ArgCount = GRC.ArgCount;
678 /* Resource files need an geos-apple or geos-cbm target but this
679 ** is checked within grc65.
681 CmdSetTarget (&GRC, Target);
683 /* Add the file as argument for the resource compiler */
684 CmdAddArg (&GRC, File);
686 /* Add a NULL pointer to terminate the argument list */
689 /* Run the compiler */
692 /* Remove the excess arguments */
693 CmdDelArgs (&GRC, ArgCount);
695 /* If this is not the final step, assemble the generated file, then
699 /* Assemble the intermediate file and remove it */
700 AssembleIntermediate (File);
706 static void ConvertO65 (const char* File)
707 /* Convert an o65 object file into an assembler file */
709 /* Remember the current converter argument count */
710 unsigned ArgCount = CO65.ArgCount;
712 /* If we won't assemble, this is the final step. In this case, set the
715 if (!DoAssemble && OutputName) {
716 CmdSetOutput (&CO65, OutputName);
719 /* Add the file as argument for the object file converter */
720 CmdAddArg (&CO65, File);
722 /* Add a NULL pointer to terminate the argument list */
723 CmdAddArg (&CO65, 0);
725 /* Run the converter */
728 /* Remove the excess arguments */
729 CmdDelArgs (&CO65, ArgCount);
731 /* If this is not the final step, assemble the generated file, then
735 /* Assemble the intermediate file and remove it */
736 AssembleIntermediate (File);
742 /*****************************************************************************/
744 /*****************************************************************************/
748 static void Usage (void)
749 /* Print usage information and exit */
751 printf ("Usage: %s [options] file [...]\n"
753 " -c\t\t\t\tCompile and assemble, but don't link\n"
754 " -d\t\t\t\tDebug mode\n"
755 " -g\t\t\t\tAdd debug info\n"
756 " -h\t\t\t\tHelp (this text)\n"
757 " -l name\t\t\tCreate an assembler listing file\n"
758 " -m name\t\t\tCreate a map file\n"
759 " -mm model\t\t\tSet the memory model\n"
760 " -o name\t\t\tName the output file\n"
761 " -r\t\t\t\tEnable register variables\n"
762 " -t sys\t\t\tSet the target system\n"
763 " -u sym\t\t\tForce an import of symbol `sym'\n"
764 " -v\t\t\t\tVerbose mode\n"
765 " -vm\t\t\t\tVerbose map file\n"
766 " -C name\t\t\tUse linker config file\n"
767 " -Cl\t\t\t\tMake local variables static\n"
768 " -D sym[=defn]\t\t\tDefine a preprocessor symbol\n"
769 " -E\t\t\t\tStop after the preprocessing stage\n"
770 " -I dir\t\t\tSet a compiler include directory path\n"
771 " -L path\t\t\tSpecify a library search path\n"
772 " -Ln name\t\t\tCreate a VICE label file\n"
773 " -O\t\t\t\tOptimize code\n"
774 " -Oi\t\t\t\tOptimize code, inline runtime functions\n"
775 " -Or\t\t\t\tOptimize code, honour the register keyword\n"
776 " -Os\t\t\t\tOptimize code, inline known C functions\n"
777 " -S\t\t\t\tCompile, but don't assemble and link\n"
778 " -T\t\t\t\tInclude source as comment\n"
779 " -V\t\t\t\tPrint the version number\n"
780 " -W name[,...]\t\t\tSuppress compiler warnings\n"
781 " -Wa options\t\t\tPass options to the assembler\n"
782 " -Wc options\t\t\tPass options to the compiler\n"
783 " -Wl options\t\t\tPass options to the linker\n"
786 " --add-source\t\t\tInclude source as comment\n"
787 " --all-cdecl\t\t\tMake functions default to __cdecl__\n"
788 " --asm-args options\t\tPass options to the assembler\n"
789 " --asm-define sym[=v]\t\tDefine an assembler symbol\n"
790 " --asm-include-dir dir\t\tSet an assembler include directory\n"
791 " --bin-include-dir dir\t\tSet an assembler binary include directory\n"
792 " --bss-label name\t\tDefine and export a BSS segment label\n"
793 " --bss-name seg\t\tSet the name of the BSS segment\n"
794 " --cc-args options\t\tPass options to the compiler\n"
795 " --cfg-path path\t\tSpecify a config file search path\n"
796 " --check-stack\t\t\tGenerate stack overflow checks\n"
797 " --code-label name\t\tDefine and export a CODE segment label\n"
798 " --code-name seg\t\tSet the name of the CODE segment\n"
799 " --codesize x\t\t\tAccept larger code by factor x\n"
800 " --config name\t\t\tUse linker config file\n"
801 " --cpu type\t\t\tSet CPU type\n"
802 " --create-dep name\t\tCreate a make dependency file\n"
803 " --create-full-dep name\tCreate a full make dependency file\n"
804 " --data-label name\t\tDefine and export a DATA segment label\n"
805 " --data-name seg\t\tSet the name of the DATA segment\n"
806 " --debug\t\t\tDebug mode\n"
807 " --debug-info\t\t\tAdd debug info\n"
808 " --feature name\t\tSet an emulation feature\n"
809 " --force-import sym\t\tForce an import of symbol `sym'\n"
810 " --help\t\t\tHelp (this text)\n"
811 " --include-dir dir\t\tSet a compiler include directory path\n"
812 " --ld-args options\t\tPass options to the linker\n"
813 " --lib file\t\t\tLink this library\n"
814 " --lib-path path\t\tSpecify a library search path\n"
815 " --list-targets\t\tList all available targets\n"
816 " --listing name\t\tCreate an assembler listing file\n"
817 " --list-bytes n\t\tNumber of bytes per assembler listing line\n"
818 " --mapfile name\t\tCreate a map file\n"
819 " --memory-model model\t\tSet the memory model\n"
820 " --module\t\t\tLink as a module\n"
821 " --module-id id\t\tSpecify a module ID for the linker\n"
822 " --no-rtl\t\t\tDon't link default runtime library\n"
823 " --o65-model model\t\tOverride the o65 model\n"
824 " --obj file\t\t\tLink this object file\n"
825 " --obj-path path\t\tSpecify an object file search path\n"
826 " --print-target-path\t\tPrint the target file path\n"
827 " --register-space b\t\tSet space available for register variables\n"
828 " --register-vars\t\tEnable register variables\n"
829 " --rodata-name seg\t\tSet the name of the RODATA segment\n"
830 " --signed-chars\t\tDefault characters are signed\n"
831 " --standard std\t\tLanguage standard (c89, c99, cc65)\n"
832 " --start-addr addr\t\tSet the default start address\n"
833 " --static-locals\t\tMake local variables static\n"
834 " --target sys\t\t\tSet the target system\n"
835 " --version\t\t\tPrint the version number\n"
836 " --verbose\t\t\tVerbose mode\n"
837 " --zeropage-label name\t\tDefine and export a ZEROPAGE segment label\n"
838 " --zeropage-name seg\t\tSet the name of the ZEROPAGE segment\n",
844 static void OptAddSource (const char* Opt attribute ((unused)),
845 const char* Arg attribute ((unused)))
846 /* Strict source code as comments to the generated asm code */
848 CmdAddArg (&CC65, "-T");
852 static void OptAllCDecl (const char* Opt attribute ((unused)),
853 const char* Arg attribute ((unused)))
854 /* Make functions default to __cdecl__ */
856 CmdAddArg (&CC65, "--all-cdecl");
861 static void OptAsmArgs (const char* Opt attribute ((unused)), const char* Arg)
862 /* Pass arguments to the assembler */
864 CmdAddArgList (&CA65, Arg);
869 static void OptAsmDefine (const char* Opt attribute ((unused)), const char* Arg)
870 /* Define an assembler symbol (assembler) */
872 CmdAddArg2 (&CA65, "-D", Arg);
877 static void OptAsmIncludeDir (const char* Opt attribute ((unused)), const char* Arg)
878 /* Include directory (assembler) */
880 CmdAddArg2 (&CA65, "-I", Arg);
885 static void OptBinIncludeDir (const char* Opt attribute ((unused)), const char* Arg)
886 /* Binary include directory (assembler) */
888 CmdAddArg2 (&CA65, "--bin-include-dir", Arg);
893 static void OptBssLabel (const char* Opt attribute ((unused)), const char* Arg)
894 /* Handle the --bss-label option */
896 CmdAddArg2 (&CO65, "--bss-label", Arg);
901 static void OptBssName (const char* Opt attribute ((unused)), const char* Arg)
902 /* Handle the --bss-name option */
904 CmdAddArg2 (&CC65, "--bss-name", Arg);
905 CmdAddArg2 (&CO65, "--bss-name", Arg);
910 static void OptCCArgs (const char* Opt attribute ((unused)), const char* Arg)
911 /* Pass arguments to the compiler */
913 CmdAddArgList (&CC65, Arg);
918 static void OptCfgPath (const char* Opt attribute ((unused)), const char* Arg)
919 /* Config file search path (linker) */
921 CmdAddArg2 (&LD65, "--cfg-path", Arg);
926 static void OptCheckStack (const char* Opt attribute ((unused)),
927 const char* Arg attribute ((unused)))
928 /* Handle the --check-stack option */
930 CmdAddArg (&CC65, "--check-stack");
935 static void OptCodeLabel (const char* Opt attribute ((unused)), const char* Arg)
936 /* Handle the --code-label option */
938 CmdAddArg2 (&CO65, "--code-label", Arg);
943 static void OptCodeName (const char* Opt attribute ((unused)), const char* Arg)
944 /* Handle the --code-name option */
946 CmdAddArg2 (&CC65, "--code-name", Arg);
947 CmdAddArg2 (&CO65, "--code-name", Arg);
952 static void OptCodeSize (const char* Opt attribute ((unused)), const char* Arg)
953 /* Handle the --codesize option */
955 CmdAddArg2 (&CC65, "--codesize", Arg);
960 static void OptConfig (const char* Opt attribute ((unused)), const char* Arg)
961 /* Config file (linker) */
964 Error ("Cannot specify -C/--config twice");
971 static void OptCPU (const char* Opt attribute ((unused)), const char* Arg)
972 /* Handle the --cpu option */
974 /* Add the cpu type to the assembler and compiler */
975 CmdAddArg2 (&CA65, "--cpu", Arg);
976 CmdAddArg2 (&CC65, "--cpu", Arg);
981 static void OptCreateDep (const char* Opt attribute ((unused)), const char* Arg)
982 /* Handle the --create-dep option */
984 /* Add the file name to the compiler */
985 CmdAddArg2 (&CC65, "--create-dep", Arg);
987 /* Remember the file name for the assembler */
993 static void OptCreateFullDep (const char* Opt attribute ((unused)), const char* Arg)
994 /* Handle the --create-full-dep option */
996 /* Add the file name to the compiler */
997 CmdAddArg2 (&CC65, "--create-full-dep", Arg);
999 /* Remember the file name for the assembler */
1005 static void OptDataLabel (const char* Opt attribute ((unused)), const char* Arg)
1006 /* Handle the --data-label option */
1008 CmdAddArg2 (&CO65, "--data-label", Arg);
1013 static void OptDataName (const char* Opt attribute ((unused)), const char* Arg)
1014 /* Handle the --data-name option */
1016 CmdAddArg2 (&CC65, "--data-name", Arg);
1017 CmdAddArg2 (&CO65, "--data-name", Arg);
1022 static void OptDebug (const char* Opt attribute ((unused)),
1023 const char* Arg attribute ((unused)))
1024 /* Debug mode (compiler and cl65 utility) */
1026 CmdAddArg (&CC65, "-d");
1027 CmdAddArg (&CO65, "-d");
1033 static void OptDebugInfo (const char* Opt attribute ((unused)),
1034 const char* Arg attribute ((unused)))
1035 /* Debug Info - add to compiler and assembler */
1037 CmdAddArg (&CC65, "-g");
1038 CmdAddArg (&CA65, "-g");
1039 CmdAddArg (&CO65, "-g");
1044 static void OptFeature (const char* Opt attribute ((unused)), const char* Arg)
1045 /* Emulation features for the assembler */
1047 CmdAddArg2 (&CA65, "--feature", Arg);
1052 static void OptForceImport (const char* Opt attribute ((unused)), const char* Arg)
1053 /* Emulation features for the assembler */
1055 CmdAddArg2 (&LD65, "-u", Arg);
1060 static void OptHelp (const char* Opt attribute ((unused)),
1061 const char* Arg attribute ((unused)))
1062 /* Print help - cl65 */
1065 exit (EXIT_SUCCESS);
1070 static void OptIncludeDir (const char* Opt attribute ((unused)), const char* Arg)
1071 /* Include directory (compiler) */
1073 CmdAddArg2 (&CC65, "-I", Arg);
1078 static void OptLdArgs (const char* Opt attribute ((unused)), const char* Arg)
1079 /* Pass arguments to the linker */
1081 CmdAddArgList (&LD65, Arg);
1086 static void OptLib (const char* Opt attribute ((unused)), const char* Arg)
1087 /* Library file follows (linker) */
1089 CmdAddArg2 (&LD65, "--lib", Arg);
1094 static void OptLibPath (const char* Opt attribute ((unused)), const char* Arg)
1095 /* Library search path (linker) */
1097 CmdAddArg2 (&LD65, "--lib-path", Arg);
1102 static void OptListBytes (const char* Opt attribute ((unused)), const char* Arg)
1103 /* Set the maximum number of bytes per asm listing line */
1105 CmdAddArg2 (&CA65, "--list-bytes", Arg);
1110 static void OptListing (const char* Opt attribute ((unused)), const char* Arg)
1111 /* Create an assembler listing */
1113 CmdAddArg2 (&CA65, "-l", Arg);
1118 static void OptListTargets (const char* Opt attribute ((unused)),
1119 const char* Arg attribute ((unused)))
1120 /* List all targets */
1124 /* List the targets */
1125 for (T = TGT_NONE; T < TGT_COUNT; ++T) {
1126 printf ("%s\n", GetTargetName (T));
1130 exit (EXIT_SUCCESS);
1135 static void OptMapFile (const char* Opt attribute ((unused)), const char* Arg)
1136 /* Create a map file */
1138 /* Create a map file (linker) */
1139 CmdAddArg2 (&LD65, "-m", Arg);
1144 static void OptMemoryModel (const char* Opt attribute ((unused)), const char* Arg)
1145 /* Set the memory model */
1147 mmodel_t MemoryModel = FindMemoryModel (Arg);
1148 if (MemoryModel == MMODEL_UNKNOWN) {
1149 Error ("Unknown memory model: %s", Arg);
1150 } else if (MemoryModel == MMODEL_HUGE) {
1151 Error ("Unsupported memory model: %s", Arg);
1153 CmdAddArg2 (&CA65, "-mm", Arg);
1154 CmdAddArg2 (&CC65, "-mm", Arg);
1160 static void OptModule (const char* Opt attribute ((unused)),
1161 const char* Arg attribute ((unused)))
1162 /* Link as a module */
1169 static void OptModuleId (const char* Opt attribute ((unused)), const char* Arg)
1170 /* Specify a module if for the linker */
1172 /* Pass it straight to the linker */
1173 CmdAddArg2 (&LD65, "--module-id", Arg);
1178 static void OptNoRTL (const char* Opt attribute ((unused)),
1179 const char* Arg attribute ((unused)))
1180 /* Disable default runtime library */
1187 static void OptO65Model (const char* Opt attribute ((unused)), const char* Arg)
1188 /* Handle the --o65-model option */
1190 CmdAddArg2 (&CO65, "-m", Arg);
1195 static void OptObj (const char* Opt attribute ((unused)), const char* Arg)
1196 /* Object file follows (linker) */
1198 CmdAddArg2 (&LD65, "--obj", Arg);
1203 static void OptObjPath (const char* Opt attribute ((unused)), const char* Arg)
1204 /* Object file search path (linker) */
1206 CmdAddArg2 (&LD65, "--obj-path", Arg);
1211 static void OptPrintTargetPath (const char* Opt attribute ((unused)),
1212 const char* Arg attribute ((unused)))
1213 /* Print the target file path */
1217 SearchPaths* TargetPaths = NewSearchPath ();
1218 AddSubSearchPathFromEnv (TargetPaths, "CC65_HOME", "target");
1219 #if defined(CL65_TGT) && !defined(_WIN32)
1220 AddSearchPath (TargetPaths, STRINGIZE (CL65_TGT));
1222 AddSubSearchPathFromWinBin (TargetPaths, "target");
1224 TargetPath = GetSearchPath (TargetPaths, 0);
1225 while (*TargetPath) {
1226 if (*TargetPath == ' ') {
1230 putchar (*TargetPath++);
1233 exit (EXIT_SUCCESS);
1238 static void OptRegisterSpace (const char* Opt attribute ((unused)), const char* Arg)
1239 /* Handle the --register-space option */
1241 CmdAddArg2 (&CC65, "--register-space", Arg);
1246 static void OptRegisterVars (const char* Opt attribute ((unused)),
1247 const char* Arg attribute ((unused)))
1248 /* Handle the --register-vars option */
1250 CmdAddArg (&CC65, "-r");
1255 static void OptRodataName (const char* Opt attribute ((unused)), const char* Arg)
1256 /* Handle the --rodata-name option */
1258 CmdAddArg2 (&CC65, "--rodata-name", Arg);
1263 static void OptSignedChars (const char* Opt attribute ((unused)),
1264 const char* Arg attribute ((unused)))
1265 /* Make default characters signed */
1267 CmdAddArg (&CC65, "-j");
1272 static void OptStandard (const char* Opt attribute ((unused)), const char* Arg)
1273 /* Set the language standard */
1275 CmdAddArg2 (&CC65, "--standard", Arg);
1280 static void OptStartAddr (const char* Opt attribute ((unused)), const char* Arg)
1281 /* Set the default start address */
1283 CmdAddArg2 (&LD65, "-S", Arg);
1288 static void OptStaticLocals (const char* Opt attribute ((unused)),
1289 const char* Arg attribute ((unused)))
1290 /* Place local variables in static storage */
1292 CmdAddArg (&CC65, "-Cl");
1297 static void OptTarget (const char* Opt attribute ((unused)), const char* Arg)
1298 /* Set the target system */
1300 Target = FindTarget (Arg);
1301 if (Target == TGT_UNKNOWN) {
1302 Error ("No such target system: `%s'", Arg);
1303 } else if (Target == TGT_MODULE) {
1304 Error ("Cannot use `module' as target, use --module instead");
1310 static void OptVerbose (const char* Opt attribute ((unused)),
1311 const char* Arg attribute ((unused)))
1312 /* Verbose mode (compiler, assembler, linker) */
1314 CmdAddArg (&CC65, "-v");
1315 CmdAddArg (&CA65, "-v");
1316 CmdAddArg (&CO65, "-v");
1317 CmdAddArg (&LD65, "-v");
1322 static void OptVersion (const char* Opt attribute ((unused)),
1323 const char* Arg attribute ((unused)))
1324 /* Print version number */
1326 fprintf (stderr, "%s V%s\n", ProgName, GetVersionAsString ());
1332 static void OptZeropageLabel (const char* Opt attribute ((unused)), const char* Arg)
1333 /* Handle the --zeropage-label option */
1335 CmdAddArg2 (&CO65, "--zeropage-label", Arg);
1340 static void OptZeropageName (const char* Opt attribute ((unused)), const char* Arg)
1341 /* Handle the --zeropage-name option */
1343 CmdAddArg2 (&CO65, "--zeropage-name", Arg);
1348 int main (int argc, char* argv [])
1349 /* Utility main program */
1351 /* Program long options */
1352 static const LongOpt OptTab[] = {
1353 { "--add-source", 0, OptAddSource },
1354 { "--all-cdecl", 0, OptAllCDecl },
1355 { "--asm-args", 1, OptAsmArgs },
1356 { "--asm-define", 1, OptAsmDefine },
1357 { "--asm-include-dir", 1, OptAsmIncludeDir },
1358 { "--bin-include-dir", 1, OptBinIncludeDir },
1359 { "--bss-label", 1, OptBssLabel },
1360 { "--bss-name", 1, OptBssName },
1361 { "--cc-args", 1, OptCCArgs },
1362 { "--cfg-path", 1, OptCfgPath },
1363 { "--check-stack", 0, OptCheckStack },
1364 { "--code-label", 1, OptCodeLabel },
1365 { "--code-name", 1, OptCodeName },
1366 { "--codesize", 1, OptCodeSize },
1367 { "--config", 1, OptConfig },
1368 { "--cpu", 1, OptCPU },
1369 { "--create-dep", 1, OptCreateDep },
1370 { "--create-full-dep", 1, OptCreateFullDep },
1371 { "--data-label", 1, OptDataLabel },
1372 { "--data-name", 1, OptDataName },
1373 { "--debug", 0, OptDebug },
1374 { "--debug-info", 0, OptDebugInfo },
1375 { "--feature", 1, OptFeature },
1376 { "--force-import", 1, OptForceImport },
1377 { "--help", 0, OptHelp },
1378 { "--include-dir", 1, OptIncludeDir },
1379 { "--ld-args", 1, OptLdArgs },
1380 { "--lib", 1, OptLib },
1381 { "--lib-path", 1, OptLibPath },
1382 { "--list-targets", 0, OptListTargets },
1383 { "--listing", 1, OptListing },
1384 { "--list-bytes", 1, OptListBytes },
1385 { "--mapfile", 1, OptMapFile },
1386 { "--memory-model", 1, OptMemoryModel },
1387 { "--module", 0, OptModule },
1388 { "--module-id", 1, OptModuleId },
1389 { "--no-rtl", 0, OptNoRTL },
1390 { "--o65-model", 1, OptO65Model },
1391 { "--obj", 1, OptObj },
1392 { "--obj-path", 1, OptObjPath },
1393 { "--print-target-path", 0, OptPrintTargetPath},
1394 { "--register-space", 1, OptRegisterSpace },
1395 { "--register-vars", 0, OptRegisterVars },
1396 { "--rodata-name", 1, OptRodataName },
1397 { "--signed-chars", 0, OptSignedChars },
1398 { "--standard", 1, OptStandard },
1399 { "--start-addr", 1, OptStartAddr },
1400 { "--static-locals", 0, OptStaticLocals },
1401 { "--target", 1, OptTarget },
1402 { "--verbose", 0, OptVerbose },
1403 { "--version", 0, OptVersion },
1404 { "--zeropage-label", 1, OptZeropageLabel },
1405 { "--zeropage-name", 1, OptZeropageName },
1411 /* Initialize the cmdline module */
1412 InitCmdLine (&argc, &argv, "cl65");
1414 /* Initialize the command descriptors */
1416 CmdPath = xstrdup ("");
1419 CmdPath = xstrdup (argv[0]);
1420 Ptr = strrchr (CmdPath, '/');
1422 Ptr = strrchr (CmdPath, '\\');
1430 CmdInit (&CC65, CmdPath, "cc65");
1431 CmdInit (&CA65, CmdPath, "ca65");
1432 CmdInit (&CO65, CmdPath, "co65");
1433 CmdInit (&LD65, CmdPath, "ld65");
1434 CmdInit (&GRC, CmdPath, "grc65");
1437 /* Our default target is the C64 instead of "none" */
1440 /* Check the parameters */
1442 while (I < ArgCount) {
1444 /* Get the argument */
1445 const char* Arg = ArgVec[I];
1447 /* Check for an option */
1448 if (Arg [0] == '-') {
1453 LongOption (&I, OptTab, sizeof(OptTab)/sizeof(OptTab[0]));
1457 if (Arg[2] == 'l' && Arg[3] == '\0') {
1458 /* Make local variables static */
1459 OptStaticLocals (Arg, 0);
1461 /* Specify linker config file */
1462 OptConfig (Arg, GetArg (&I, 2));
1467 /* Define a preprocessor symbol (compiler) */
1468 CmdAddArg2 (&CC65, "-D", GetArg (&I, 2));
1472 /* Include directory (compiler) */
1473 OptIncludeDir (Arg, GetArg (&I, 2));
1477 if (Arg[2] == 'n' && Arg[3] == '\0') {
1478 /* VICE label file (linker) */
1479 CmdAddArg2 (&LD65, "-Ln", GetArg (&I, 3));
1481 /* Library search path (linker) */
1482 OptLibPath (Arg, GetArg (&I, 2));
1487 /* Optimize code (compiler, also covers -Oi and others) */
1488 CmdAddArg (&CC65, Arg);
1492 /* Dont assemble and link the created files */
1493 DisableAssemblingAndLinking ();
1497 /* Include source as comment (compiler) */
1498 OptAddSource (Arg, 0);
1502 /* Print version number */
1503 OptVersion (Arg, 0);
1507 /* Forward -E to compiler */
1508 CmdAddArg (&CC65, Arg);
1509 DisableAssemblingAndLinking ();
1513 if (Arg[2] == 'a' && Arg[3] == '\0') {
1514 /* -Wa: Pass options to assembler */
1515 OptAsmArgs (Arg, GetArg (&I, 3));
1516 } else if (Arg[2] == 'c' && Arg[3] == '\0') {
1517 /* -Wc: Pass options to compiler */
1518 /* Remember -Wc sub arguments in cc65 arg struct */
1519 OptCCArgs (Arg, GetArg (&I, 3));
1520 } else if (Arg[2] == 'l' && Arg[3] == '\0') {
1521 /* -Wl: Pass options to linker */
1522 OptLdArgs (Arg, GetArg (&I, 3));
1524 /* Anything else: Suppress warnings (compiler) */
1525 CmdAddArg2 (&CC65, "-W", GetArg (&I, 2));
1530 /* Don't link the resulting files */
1535 /* Debug mode (compiler) */
1540 /* Debugging - add to compiler and assembler */
1541 OptDebugInfo (Arg, 0);
1546 /* Print help - cl65 */
1551 /* Default characters are signed */
1552 OptSignedChars (Arg, 0);
1556 /* Create an assembler listing */
1557 OptListing (Arg, GetArg (&I, 2));
1561 /* Create a map file (linker) */
1562 OptMapFile (Arg, GetArg (&I, 2));
1566 /* Name the output file */
1567 OutputName = GetArg (&I, 2);
1571 /* Enable register variables */
1572 OptRegisterVars (Arg, 0);
1576 /* Set target system - compiler, assembler and linker */
1577 OptTarget (Arg, GetArg (&I, 2));
1581 /* Force an import (linker) */
1582 OptForceImport (Arg, GetArg (&I, 2));
1586 if (Arg [2] == 'm') {
1587 /* Verbose map file (linker) */
1588 CmdAddArg (&LD65, "-vm");
1590 /* Verbose mode (compiler, assembler, linker) */
1591 OptVerbose (Arg, 0);
1596 UnknownOption (Arg);
1600 /* Remember the first file name */
1601 if (FirstInput == 0) {
1605 /* Determine the file type by the extension */
1606 switch (GetFileType (Arg)) {
1609 /* Compile the file */
1614 /* Assemble the file */
1622 /* Add to the linker files */
1623 CmdAddFile (&LD65, Arg);
1627 /* Add to the resource compiler files */
1632 /* Add the the object file converter files */
1637 Error ("Don't know what to do with `%s'", Arg);
1647 /* Check if we had any input files */
1648 if (FirstInput == 0) {
1649 Warning ("No input files");
1652 /* Link the given files if requested and if we have any */
1653 if (DoLink && LD65.FileCount > 0) {
1657 /* Return an apropriate exit code */
1658 return EXIT_SUCCESS;