1 /*****************************************************************************/
5 /* Main module for the cl65 compile and link utility */
9 /* (C) 1999-2000 Ullrich von Bassewitz */
11 /* D-70597 Stuttgart */
12 /* EMail: uz@musoftware.de */
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 /*****************************************************************************/
41 #if defined(__WATCOMC__) || defined(_MSC_VER)
42 # include <process.h> /* DOS, OS/2 and Windows */
44 # include "spawn.h" /* All others */
60 /*****************************************************************************/
62 /*****************************************************************************/
66 /* Struct that describes a command */
67 typedef struct CmdDesc_ CmdDesc;
69 char* Name; /* The command name */
71 unsigned ArgCount; /* Count of arguments */
72 unsigned ArgMax; /* Maximum count of arguments */
73 char** Args; /* The arguments */
75 unsigned FileCount; /* Count of files to translate */
76 unsigned FileMax; /* Maximum count of files */
77 char** Files; /* The files */
80 /* Command descriptors for the different programs */
81 static CmdDesc CC65 = { 0, 0, 0, 0, 0, 0, 0 };
82 static CmdDesc CA65 = { 0, 0, 0, 0, 0, 0, 0 };
83 static CmdDesc LD65 = { 0, 0, 0, 0, 0, 0, 0 };
84 static CmdDesc GRC = { 0, 0, 0, 0, 0, 0, 0 };
93 FILETYPE_GR /* GEOS resource file */
96 /* Default file type, used if type unknown */
97 static unsigned DefaultFileType = FILETYPE_UNKNOWN;
99 /* Variables controlling the steps we're doing */
100 static int DontLink = 0;
101 static int DontAssemble = 0;
103 /* The name of the output file, NULL if none given */
104 static const char* OutputName = 0;
106 /* The name of the linker configuration file if given */
107 static const char* LinkerConfig = 0;
109 /* The name of the first input file. This will be used to construct the
110 * executable file name if no explicit name is given.
112 static const char* FirstInput = 0;
114 /* Name of the crt0 object file and the runtime library */
115 static char* TargetCRT0 = 0;
116 static char* TargetLib = 0;
120 /*****************************************************************************/
121 /* Determine a file type */
122 /*****************************************************************************/
126 static unsigned GetFileType (const char* File)
127 /* Determine the type of the given file */
129 /* Table mapping extensions to file types */
130 static const struct {
134 { ".c", FILETYPE_C },
135 { ".s", FILETYPE_ASM },
136 { ".asm", FILETYPE_ASM },
137 { ".a65", FILETYPE_ASM },
138 { ".o", FILETYPE_OBJ },
139 { ".obj", FILETYPE_OBJ },
140 { ".a", FILETYPE_LIB },
141 { ".lib", FILETYPE_LIB },
142 { ".grc", FILETYPE_GR },
147 /* Determine the file type by the extension */
148 const char* Ext = FindExt (File);
150 /* Do we have an extension? */
152 return DefaultFileType;
155 /* Check for known extensions */
156 for (I = 0; I < sizeof (FileTypes) / sizeof (FileTypes [0]); ++I) {
157 if (strcmp (FileTypes [I].Ext, Ext) == 0) {
159 return FileTypes [I].Type;
163 /* Not found, return the default */
164 return DefaultFileType;
169 /*****************************************************************************/
170 /* Command structure handling */
171 /*****************************************************************************/
175 static void CmdAddArg (CmdDesc* Cmd, const char* Arg)
176 /* Add a new argument to the command */
178 /* Expand the argument vector if needed */
179 if (Cmd->ArgCount == Cmd->ArgMax) {
180 unsigned NewMax = Cmd->ArgMax + 10;
181 char** NewArgs = xmalloc (NewMax * sizeof (char*));
182 memcpy (NewArgs, Cmd->Args, Cmd->ArgMax * sizeof (char*));
185 Cmd->ArgMax = NewMax;
188 /* Add a copy of the new argument, allow a NULL pointer */
190 Cmd->Args [Cmd->ArgCount++] = xstrdup (Arg);
192 Cmd->Args [Cmd->ArgCount++] = 0;
198 static void CmdDelArgs (CmdDesc* Cmd, unsigned LastValid)
199 /* Remove all arguments with an index greater than LastValid */
201 while (Cmd->ArgCount > LastValid) {
203 xfree (Cmd->Args [Cmd->ArgCount]);
204 Cmd->Args [Cmd->ArgCount] = 0;
210 static void CmdAddFile (CmdDesc* Cmd, const char* File)
211 /* Add a new file to the command */
213 /* Expand the file vector if needed */
214 if (Cmd->FileCount == Cmd->FileMax) {
215 unsigned NewMax = Cmd->FileMax + 10;
216 char** NewFiles = xmalloc (NewMax * sizeof (char*));
217 memcpy (NewFiles, Cmd->Files, Cmd->FileMax * sizeof (char*));
219 Cmd->Files = NewFiles;
220 Cmd->FileMax = NewMax;
223 /* If the file name is not NULL (which is legal and is used to terminate
224 * the file list), check if the file name does already exist in the file
225 * list and print a warning if so. Regardless of the search result, add
230 for (I = 0; I < Cmd->FileCount; ++I) {
231 if (strcmp (Cmd->Files[I], File) == 0) {
233 Warning ("Duplicate file in argument list: `%s'", File);
234 /* No need to search further */
240 Cmd->Files [Cmd->FileCount++] = xstrdup (File);
242 /* Add a NULL pointer */
243 Cmd->Files [Cmd->FileCount++] = 0;
249 static void CmdInit (CmdDesc* Cmd, const char* Path)
250 /* Initialize the command using the given path to the executable */
252 /* Remember the command */
253 Cmd->Name = xstrdup (Path);
255 /* Use the command name as first argument */
256 CmdAddArg (Cmd, Path);
261 static void CmdSetOutput (CmdDesc* Cmd, const char* File)
262 /* Set the output file in a command desc */
264 CmdAddArg (Cmd, "-o");
265 CmdAddArg (Cmd, File);
270 static void CmdSetTarget (CmdDesc* Cmd, target_t Target)
271 /* Set the output file in a command desc */
273 CmdAddArg (Cmd, "-t");
274 CmdAddArg (Cmd, TargetNames[Target]);
279 /*****************************************************************************/
280 /* Target handling */
281 /*****************************************************************************/
285 static void SetTargetFiles (void)
286 /* Set the target system files */
288 /* Determine the names of the default startup and library file */
289 if (Target != TGT_NONE) {
291 /* Get a pointer to the system name and its length */
292 const char* TargetName = TargetNames [Target];
293 unsigned TargetNameLen = strlen (TargetName);
295 /* Set the startup file */
296 TargetCRT0 = xmalloc (TargetNameLen + 2 + 1);
297 strcpy (TargetCRT0, TargetName);
298 strcat (TargetCRT0, ".o");
300 /* Set the library file */
301 TargetLib = xmalloc (TargetNameLen + 4 + 1);
302 strcpy (TargetLib, TargetName);
303 strcat (TargetLib, ".lib");
310 /*****************************************************************************/
312 /*****************************************************************************/
316 static void ExecProgram (CmdDesc* Cmd)
317 /* Execute a subprocess with the given name/parameters. Exit on errors. */
319 /* Call the program */
320 int Status = spawnvp (P_WAIT, Cmd->Name, Cmd->Args);
322 /* Check the result code */
324 /* Error executing the program */
325 Error ("Cannot execute `%s': %s", Cmd->Name, strerror (errno));
326 } else if (Status != 0) {
327 /* Called program had an error */
334 static void Link (void)
335 /* Link the resulting executable */
339 /* If we have a linker config file given, set the linker config file.
340 * Otherwise set the target system.
343 CmdAddArg (&LD65, "-C");
344 CmdAddArg (&LD65, LinkerConfig);
346 CmdSetTarget (&LD65, Target);
350 /* Since linking is always the final step, if we have an output file name
351 * given, set it here. If we don't have an explicit output name given,
352 * try to build one from the name of the first input file.
356 CmdAddArg (&LD65, "-o");
357 CmdAddArg (&LD65, OutputName);
359 } else if (FirstInput && FindExt (FirstInput)) { /* Only if ext present! */
361 char* Output = MakeFilename (FirstInput, "");
362 CmdAddArg (&LD65, "-o");
363 CmdAddArg (&LD65, Output);
368 /* If we have a startup file, add its name as a parameter */
370 CmdAddArg (&LD65, TargetCRT0);
373 /* Add all object files as parameters */
374 for (I = 0; I < LD65.FileCount; ++I) {
375 CmdAddArg (&LD65, LD65.Files [I]);
378 /* Add the system runtime library */
380 CmdAddArg (&LD65, TargetLib);
383 /* Terminate the argument list with a NULL pointer */
384 CmdAddArg (&LD65, 0);
386 /* Call the linker */
392 static void Assemble (const char* File)
393 /* Assemble the given file */
395 /* Remember the current assembler argument count */
396 unsigned ArgCount = CA65.ArgCount;
398 /* Set the target system */
399 CmdSetTarget (&CA65, Target);
401 /* If we won't link, this is the final step. In this case, set the
404 if (DontLink && OutputName) {
405 CmdSetOutput (&CA65, OutputName);
407 /* The object file name will be the name of the source file
408 * with .s replaced by ".o". Add this file to the list of
411 char* ObjName = MakeFilename (File, ".o");
412 CmdAddFile (&LD65, ObjName);
416 /* Add the file as argument for the assembler */
417 CmdAddArg (&CA65, File);
419 /* Add a NULL pointer to terminate the argument list */
420 CmdAddArg (&CA65, 0);
422 /* Run the assembler */
425 /* Remove the excess arguments */
426 CmdDelArgs (&CA65, ArgCount);
431 static void Compile (const char* File)
432 /* Compile the given file */
436 /* Remember the current assembler argument count */
437 unsigned ArgCount = CC65.ArgCount;
439 /* Set the target system */
440 CmdSetTarget (&CC65, Target);
442 /* If we won't link, this is the final step. In this case, set the
445 if (DontAssemble && OutputName) {
446 CmdSetOutput (&CC65, OutputName);
448 /* The assembler file name will be the name of the source file
449 * with .c replaced by ".s".
451 AsmName = MakeFilename (File, ".s");
454 /* Add the file as argument for the compiler */
455 CmdAddArg (&CC65, File);
457 /* Add a NULL pointer to terminate the argument list */
458 CmdAddArg (&CC65, 0);
460 /* Run the compiler */
463 /* Remove the excess arguments */
464 CmdDelArgs (&CC65, ArgCount);
466 /* If this is not the final step, assemble the generated file, then
471 if (remove (AsmName) < 0) {
472 Warning ("Cannot remove temporary file `%s': %s",
473 AsmName, strerror (errno));
481 static void CompileRes (const char* File)
482 /* Compile the given geos resource file */
486 /* Remember the current assembler argument count */
487 unsigned ArgCount = GRC.ArgCount;
489 /* The assembler file name will be the name of the source file
490 * with .grc replaced by ".s".
492 AsmName = MakeFilename (File, ".s");
494 /* Add the file as argument for the resource compiler */
495 CmdAddArg (&GRC, File);
497 /* Add a NULL pointer to terminate the argument list */
500 /* Run the compiler */
503 /* Remove the excess arguments */
504 CmdDelArgs (&GRC, ArgCount);
506 /* If this is not the final step, assemble the generated file, then
511 if (remove (AsmName) < 0) {
512 Warning ("Cannot remove temporary file `%s': %s",
513 AsmName, strerror (errno));
517 /* Free the assembler file name which was allocated from the heap */
523 /*****************************************************************************/
525 /*****************************************************************************/
529 static void Usage (void)
530 /* Print usage information and exit */
533 "Usage: %s [options] file\n"
535 " -A\t\t\tStrict ANSI mode\n"
536 " -C name\t\tUse linker config file\n"
537 " -Cl\t\t\tMake local variables static\n"
538 " -D sym[=defn]\t\tDefine a preprocessor symbol\n"
539 " -I dir\t\tSet a compiler include directory path\n"
540 " -Ln name\t\tCreate a VICE label file\n"
541 " -O\t\t\tOptimize code\n"
542 " -Oi\t\t\tOptimize code, inline functions\n"
543 " -Or\t\t\tOptimize code, honour the register keyword\n"
544 " -Os\t\t\tOptimize code, inline known C funtions\n"
545 " -S\t\t\tCompile but don't assemble and link\n"
546 " -V\t\t\tPrint the version number\n"
547 " -W\t\t\tSuppress warnings\n"
548 " -c\t\t\tCompiler and assemble but don't link\n"
549 " -d\t\t\tDebug mode\n"
550 " -g\t\t\tAdd debug info\n"
551 " -h\t\t\tHelp (this text)\n"
552 " -m name\t\tCreate a map file\n"
553 " -o name\t\tName the output file\n"
554 " -t sys\t\tSet the target system\n"
555 " -v\t\t\tVerbose mode\n"
556 " -vm\t\t\tVerbose map file\n"
559 " --ansi\t\tStrict ANSI mode\n"
560 " --asm-include-dir dir\tSet an assembler include directory\n"
561 " --debug\t\tDebug mode\n"
562 " --debug-info\t\tAdd debug info\n"
563 " --feature name\tSet an emulation feature\n"
564 " --help\t\tHelp (this text)\n"
565 " --include-dir dir\tSet a compiler include directory path\n"
566 " --mapfile name\tCreate a map file\n"
567 " --start-addr addr\tSet the default start address\n"
568 " --target sys\t\tSet the target system\n"
569 " --version\t\tPrint the version number\n"
570 " --verbose\t\tVerbose mode\n",
576 static void OptAnsi (const char* Opt, const char* Arg)
577 /* Strict ANSI mode (compiler) */
579 CmdAddArg (&CC65, "-A");
584 static void OptAsmIncludeDir (const char* Opt, const char* Arg)
585 /* Include directory (assembler) */
587 CmdAddArg (&CA65, "-I");
588 CmdAddArg (&CA65, Arg);
593 static void OptDebug (const char* Opt, const char* Arg)
594 /* Debug mode (compiler) */
596 CmdAddArg (&CC65, "-d");
601 static void OptDebugInfo (const char* Opt, const char* Arg)
602 /* Debug Info - add to compiler and assembler */
604 CmdAddArg (&CC65, "-g");
605 CmdAddArg (&CA65, "-g");
610 static void OptFeature (const char* Opt, const char* Arg)
611 /* Emulation features for the assembler */
613 CmdAddArg (&CA65, "--feature");
614 CmdAddArg (&CA65, Arg);
619 static void OptHelp (const char* Opt, const char* Arg)
620 /* Print help - cl65 */
628 static void OptIncludeDir (const char* Opt, const char* Arg)
629 /* Include directory (compiler) */
631 CmdAddArg (&CC65, "-I");
632 CmdAddArg (&CC65, Arg);
637 static void OptMapFile (const char* Opt, const char* Arg)
638 /* Create a map file */
640 /* Create a map file (linker) */
641 CmdAddArg (&LD65, "-m");
642 CmdAddArg (&LD65, Arg);
647 static void OptStartAddr (const char* Opt, const char* Arg)
648 /* Set the default start address */
650 CmdAddArg (&LD65, "-S");
651 CmdAddArg (&LD65, Arg);
656 static void OptTarget (const char* Opt, const char* Arg)
657 /* Set the target system */
659 Target = FindTarget (Arg);
660 if (Target == TGT_UNKNOWN) {
661 Error ("No such target system: `%s'", Arg);
667 static void OptVerbose (const char* Opt, const char* Arg)
668 /* Verbose mode (compiler, assembler, linker) */
670 CmdAddArg (&CC65, "-v");
671 CmdAddArg (&CA65, "-v");
672 CmdAddArg (&LD65, "-v");
677 static void OptVersion (const char* Opt, const char* Arg)
678 /* Print version number */
681 "cl65 V%u.%u.%u - (C) Copyright 1998-2000 Ullrich von Bassewitz\n",
682 VER_MAJOR, VER_MINOR, VER_PATCH);
687 int main (int argc, char* argv [])
688 /* Utility main program */
690 /* Program long options */
691 static const LongOpt OptTab[] = {
692 { "--ansi", 0, OptAnsi },
693 { "--asm-include-dir", 1, OptAsmIncludeDir },
694 { "--debug", 0, OptDebug },
695 { "--debug-info", 0, OptDebugInfo },
696 { "--feature", 1, OptFeature },
697 { "--help", 0, OptHelp },
698 { "--include-dir", 1, OptIncludeDir },
699 { "--mapfile", 1, OptMapFile },
700 { "--start-addr", 1, OptStartAddr },
701 { "--target", 1, OptTarget },
702 { "--verbose", 0, OptVerbose },
703 { "--version", 0, OptVersion },
708 /* Initialize the cmdline module */
709 InitCmdLine (argc, argv, "cl65");
711 /* Initialize the command descriptors */
712 CmdInit (&CC65, "cc65");
713 CmdInit (&CA65, "ca65");
714 CmdInit (&LD65, "ld65");
715 CmdInit (&GRC, "grc");
717 /* Our default target is the C64 instead of "none" */
720 /* Check the parameters */
724 /* Get the argument */
725 const char* Arg = argv [I];
727 /* Check for an option */
728 if (Arg [0] == '-') {
733 LongOption (&I, OptTab, sizeof(OptTab)/sizeof(OptTab[0]));
737 /* Strict ANSI mode (compiler) */
742 if (Arg[2] == 'l' && Arg[3] == '\0') {
743 /* Make local variables static */
744 CmdAddArg (&CC65, "-Cl");
746 /* Specify linker config file */
747 LinkerConfig = GetArg (&I, 2);
752 /* Define a preprocessor symbol (compiler) */
753 CmdAddArg (&CC65, "-D");
754 CmdAddArg (&CC65, GetArg (&I, 2));
758 /* Include directory (compiler) */
759 OptIncludeDir (Arg, GetArg (&I, 2));
764 /* VICE label file (linker) */
765 CmdAddArg (&LD65, "-Ln");
766 CmdAddArg (&LD65, GetArg (&I, 3));
773 /* Optimize code (compiler, also covers -Oi and others) */
774 CmdAddArg (&CC65, Arg);
778 /* Dont assemble and link the created files */
779 DontLink = DontAssemble = 1;
783 /* Include source as comment (compiler) */
784 CmdAddArg (&CC65, "-T");
788 /* Print version number */
793 /* Suppress warnings - compiler and assembler */
794 CmdAddArg (&CC65, "-W");
795 CmdAddArg (&CA65, "-W");
796 CmdAddArg (&CA65, "0");
800 /* Don't link the resulting files */
805 /* Debug mode (compiler) */
810 /* Debugging - add to compiler and assembler */
811 OptDebugInfo (Arg, 0);
816 /* Print help - cl65 */
821 /* Create a map file (linker) */
822 OptMapFile (Arg, GetArg (&I, 2));
826 /* Name the output file */
827 OutputName = GetArg (&I, 2);
831 /* Set target system - compiler, assembler and linker */
832 OptTarget (Arg, GetArg (&I, 2));
836 if (Arg [2] == 'm') {
837 /* Verbose map file (linker) */
838 CmdAddArg (&LD65, "-vm");
840 /* Verbose mode (compiler, assembler, linker) */
850 /* Remember the first file name */
851 if (FirstInput == 0) {
855 /* Determine the file type by the extension */
856 switch (GetFileType (Arg)) {
859 /* Compile the file */
864 /* Assemble the file */
872 /* Add to the linker files */
873 CmdAddFile (&LD65, Arg);
877 /* Add to the resource compiler files */
882 Error ("Don't know what to do with `%s'", Arg);
892 /* Check if we had any input files */
893 if (FirstInput == 0) {
894 Warning ("No input files");
897 /* Link the given files if requested and if we have any */
898 if (DontLink == 0 && LD65.FileCount > 0) {
902 /* Return an apropriate exit code */