/* GNU m4 -- A simple macro processor Copyright (C) 1989, 1990, 1991, 1992, 1993, 1994, 2004, 2005, 2006 Free Software Foundation, Inc. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA */ #include "m4.h" #include #include #include static void usage (int); /* Enable sync output for /lib/cpp (-s). */ int sync_output = 0; /* Debug (-d[flags]). */ int debug_level = 0; /* Hash table size (should be a prime) (-Hsize). */ size_t hash_table_size = HASHMAX; /* Disable GNU extensions (-G). */ int no_gnu_extensions = 0; /* Prefix all builtin functions by `m4_'. */ int prefix_all_builtins = 0; /* Max length of arguments in trace output (-lsize). */ int max_debug_argument_length = 0; /* Suppress warnings about missing arguments. */ int suppress_warnings = 0; /* If not zero, then value of exit status for warning diagnostics. */ int warning_status = 0; /* Artificial limit for expansion_level in macro.c. */ int nesting_limit = 1024; #ifdef ENABLE_CHANGEWORD /* User provided regexp for describing m4 words. */ const char *user_word_regexp = ""; #endif /* The name this program was run with. */ const char *program_name; struct macro_definition { struct macro_definition *next; int code; /* D, U, s, t, or '\1' */ const char *arg; }; typedef struct macro_definition macro_definition; /* Error handling functions. */ /*-----------------------. | Wrapper around error. | `-----------------------*/ void m4_error (int status, int errnum, const char *format, ...) { va_list args; va_start (args, format); verror_at_line (status, errnum, current_line ? current_file : NULL, current_line, format, args); } /*-------------------------------. | Wrapper around error_at_line. | `-------------------------------*/ void m4_error_at_line (int status, int errnum, const char *file, int line, const char *format, ...) { va_list args; va_start (args, format); verror_at_line (status, errnum, line ? file : NULL, line, format, args); } #ifdef USE_STACKOVF /*---------------------------------------. | Tell user stack overflowed and abort. | `---------------------------------------*/ static void stackovf_handler (void) { M4ERROR ((EXIT_FAILURE, 0, "ERROR: stack overflow. (Infinite define recursion?)")); } #endif /* USE_STACKOV */ /*---------------------------------------------. | Print a usage message and exit with STATUS. | `---------------------------------------------*/ static void usage (int status) { if (status != EXIT_SUCCESS) fprintf (stderr, "Try `%s --help' for more information.\n", program_name); else { printf ("Usage: %s [OPTION]... [FILE]...\n", program_name); fputs ("\ Process macros in FILEs. If no FILE or if FILE is `-', standard input\n\ is read.\n\ ", stdout); fputs ("\ \n\ Mandatory or optional arguments to long options are mandatory or optional\n\ for short options too.\n\ \n\ Operation modes:\n\ --help display this help and exit\n\ --version output version information and exit\n\ -E, --fatal-warnings stop execution after first warning\n\ -i, --interactive unbuffer output, ignore interrupts\n\ -P, --prefix-builtins force a `m4_' prefix to all builtins\n\ -Q, --quiet, --silent suppress some warnings for builtins\n\ ", stdout); #ifdef ENABLE_CHANGEWORD fputs ("\ -W, --word-regexp=REGEXP use REGEXP for macro name syntax\n\ ", stdout); #endif fputs ("\ \n\ Preprocessor features:\n\ -D, --define=NAME[=VALUE] define NAME as having VALUE, or empty\n\ -I, --include=DIRECTORY append DIRECTORY to include path\n\ -s, --synclines generate `#line NUM \"FILE\"' lines\n\ -U, --undefine=NAME undefine NAME\n\ ", stdout); fputs ("\ \n\ Limits control:\n\ -G, --traditional suppress all GNU extensions\n\ -H, --hashsize=PRIME set symbol lookup hash table size [509]\n\ -L, --nesting-limit=NUMBER change artificial nesting limit [1024]\n\ ", stdout); fputs ("\ \n\ Frozen state files:\n\ -F, --freeze-state=FILE produce a frozen state on FILE at end\n\ -R, --reload-state=FILE reload a frozen state from FILE at start\n\ ", stdout); fputs ("\ \n\ Debugging:\n\ -d, --debug[=FLAGS] set debug level (no FLAGS implies `aeq')\n\ --debugfile=FILE redirect debug and trace output\n\ -l, --arglength=NUM restrict macro tracing size\n\ -t, --trace=NAME trace NAME when it is defined\n\ ", stdout); fputs ("\ \n\ FLAGS is any of:\n\ a show actual arguments\n\ c show before collect, after collect and after call\n\ e show expansion\n\ f say current input file name\n\ i show changes in input files\n\ l say current input line number\n\ p show results of path searches\n\ q quote values as necessary, with a or e flag\n\ t trace for all macro calls, not only traceon'ed\n\ x add a unique macro call id, useful with c flag\n\ V shorthand for all of the above flags\n\ ", stdout); fputs ("\ \n\ If defined, the environment variable `M4PATH' is a colon-separated list\n\ of directories included after any specified by `-I'.\n\ ", stdout); fputs ("\ \n\ Exit status is 0 for success, 1 for failure, 63 for frozen file version\n\ mismatch, or whatever value was passed to the m4exit macro.\n\ ", stdout); printf ("\nReport bugs to <%s>.\n", PACKAGE_BUGREPORT); } exit (status); } /*--------------------------------------. | Decode options and launch execution. | `--------------------------------------*/ /* For long options that have no equivalent short option, use a non-character as a pseudo short option, starting with CHAR_MAX + 1. */ enum { DEBUGFILE_OPTION = CHAR_MAX + 1, /* no short opt */ DIVERSIONS_OPTION, /* not quite -N, because of message */ HELP_OPTION, /* no short opt */ VERSION_OPTION /* no short opt */ }; static const struct option long_options[] = { {"arglength", required_argument, NULL, 'l'}, {"debug", optional_argument, NULL, 'd'}, {"define", required_argument, NULL, 'D'}, {"error-output", required_argument, NULL, 'o'}, /* FIXME: deprecate in 2.0 */ {"fatal-warnings", no_argument, NULL, 'E'}, {"freeze-state", required_argument, NULL, 'F'}, {"hashsize", required_argument, NULL, 'H'}, {"include", required_argument, NULL, 'I'}, {"interactive", no_argument, NULL, 'i'}, {"nesting-limit", required_argument, NULL, 'L'}, {"prefix-builtins", no_argument, NULL, 'P'}, {"quiet", no_argument, NULL, 'Q'}, {"reload-state", required_argument, NULL, 'R'}, {"silent", no_argument, NULL, 'Q'}, {"synclines", no_argument, NULL, 's'}, {"trace", required_argument, NULL, 't'}, {"traditional", no_argument, NULL, 'G'}, {"undefine", required_argument, NULL, 'U'}, {"word-regexp", required_argument, NULL, 'W'}, {"debugfile", required_argument, NULL, DEBUGFILE_OPTION}, {"diversions", required_argument, NULL, DIVERSIONS_OPTION}, {"help", no_argument, NULL, HELP_OPTION}, {"version", no_argument, NULL, VERSION_OPTION}, { NULL, 0, NULL, 0 }, }; /* Global catchall for any errors that should affect final error status, but where we try to continue execution in the meantime. */ int retcode; /* Process a command line file NAME, and return true only if it was stdin. */ static bool process_file (const char *name) { bool result = false; if (strcmp (name, "-") == 0) { /* If stdin is a terminal, we want to allow 'm4 - file -' to read input from stdin twice, like GNU cat. Besides, there is no point closing stdin before wrapped text, to minimize bugs in syscmd called from wrapped text. */ push_file (stdin, "stdin", false); result = true; } else { char *full_name; FILE *fp = m4_path_search (name, &full_name); if (fp == NULL) { error (0, errno, "%s", name); /* Set the status to EXIT_FAILURE, even though we continue to process files after a missing file. */ retcode = EXIT_FAILURE; return false; } push_file (fp, full_name, true); free (full_name); } expand_input (); return result; } /* POSIX requires only -D, -U, and -s; and says that the first two must be recognized when interspersed with file names. Traditional behavior also handles -s between files. Starting OPTSTRING with '-' forces getopt_long to hand back file names as arguments to opt '\1', rather than reordering the command line. */ #ifdef ENABLE_CHANGEWORD #define OPTSTRING "-B:D:EF:GH:I:L:N:PQR:S:T:U:W:d::eil:o:st:" #else #define OPTSTRING "-B:D:EF:GH:I:L:N:PQR:S:T:U:d::eil:o:st:" #endif int main (int argc, char *const *argv, char *const *envp) { macro_definition *head; /* head of deferred argument list */ macro_definition *tail; macro_definition *defn; int optchar; /* option character */ macro_definition *defines; bool read_stdin = false; bool interactive = false; bool seen_file = false; const char *debugfile = NULL; const char *frozen_file_to_read = NULL; const char *frozen_file_to_write = NULL; program_name = argv[0]; retcode = EXIT_SUCCESS; atexit (close_stdout); include_init (); debug_init (); #ifdef USE_STACKOVF setup_stackovf_trap (argv, envp, stackovf_handler); #endif /* First, we decode the arguments, to size up tables and stuff. */ head = tail = NULL; while ((optchar = getopt_long (argc, (char **) argv, OPTSTRING, long_options, NULL)) != -1) switch (optchar) { default: usage (EXIT_FAILURE); case 'B': case 'S': case 'T': /* Compatibility junk: options that other implementations support, but which we ignore as no-ops and don't list in --help. */ error (0, 0, "Warning: `m4 -%c' may be removed in a future release", optchar); break; case 'N': case DIVERSIONS_OPTION: /* -N became an obsolete no-op in 1.4.x. */ error (0, 0, "Warning: `m4 %s' is deprecated", optchar == 'N' ? "-N" : "--diversions"); case 'D': case 'U': case 's': case 't': case '\1': /* Arguments that cannot be handled until later are accumulated. */ defn = (macro_definition *) xmalloc (sizeof (macro_definition)); defn->code = optchar; defn->arg = optarg; defn->next = NULL; if (head == NULL) head = defn; else tail->next = defn; tail = defn; break; case 'E': warning_status = EXIT_FAILURE; break; case 'F': frozen_file_to_write = optarg; break; case 'G': no_gnu_extensions = 1; break; case 'H': hash_table_size = atol (optarg); if (hash_table_size == 0) hash_table_size = HASHMAX; break; case 'I': add_include_directory (optarg); break; case 'L': nesting_limit = atoi (optarg); break; case 'P': prefix_all_builtins = 1; break; case 'Q': suppress_warnings = 1; break; case 'R': frozen_file_to_read = optarg; break; #ifdef ENABLE_CHANGEWORD case 'W': user_word_regexp = optarg; break; #endif case 'd': debug_level = debug_decode (optarg); if (debug_level < 0) { error (0, 0, "bad debug flags: `%s'", optarg); debug_level = 0; } break; case 'e': error (0, 0, "Warning: `m4 -e' is deprecated, use `-i' instead"); /* fall through */ case 'i': interactive = true; break; case 'l': max_debug_argument_length = atoi (optarg); if (max_debug_argument_length <= 0) max_debug_argument_length = 0; break; case 'o': /* -o/--error-output are deprecated synonyms of --debugfile, but don't issue a deprecation warning until autoconf 2.61 or later is more widely established, as such a warning would interfere with all earlier versions of autoconf. */ case DEBUGFILE_OPTION: /* Don't call debug_set_output here, as it has side effects. */ debugfile = optarg; break; case VERSION_OPTION: printf ("%s\n", PACKAGE_STRING); fputs ("\ Copyright (C) 2006 Free Software Foundation, Inc.\n\ This is free software; see the source for copying conditions. There is NO\n\ warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\n\ \n\ Written by Rene' Seindal.\n\ ", stdout); exit (EXIT_SUCCESS); break; case HELP_OPTION: usage (EXIT_SUCCESS); break; } defines = head; /* Do the basic initializations. */ if (debugfile && !debug_set_output (debugfile)) M4ERROR ((0, errno, "cannot set debug file `%s'", debugfile)); input_init (); output_init (); symtab_init (); include_env_init (); if (frozen_file_to_read) reload_frozen_state (frozen_file_to_read); else builtin_init (); /* Interactive mode means unbuffered output, and interrupts ignored. */ if (interactive) { signal (SIGINT, SIG_IGN); setbuf (stdout, (char *) NULL); } /* Handle deferred command line macro definitions. Must come after initialization of the symbol table. */ while (defines != NULL) { macro_definition *next; symbol *sym; switch (defines->code) { case 'D': { /* defines->arg is read-only, so we need a copy. */ char *macro_name = xstrdup (defines->arg); char *macro_value = strchr (macro_name, '='); if (macro_value) *macro_value++ = '\0'; define_user_macro (macro_name, macro_value, SYMBOL_INSERT); free (macro_name); } break; case 'U': lookup_symbol (defines->arg, SYMBOL_DELETE); break; case 't': sym = lookup_symbol (defines->arg, SYMBOL_INSERT); SYMBOL_TRACED (sym) = true; break; case 's': sync_output = 1; break; case '\1': seen_file = true; if (process_file (defines->arg)) read_stdin = true; break; default: M4ERROR ((warning_status, 0, "INTERNAL ERROR: bad code in deferred arguments")); abort (); } next = defines->next; free (defines); defines = next; } /* Handle remaining input files. Each file is pushed on the input, and the input read. Wrapup text is handled separately later. */ if (optind == argc && !seen_file) read_stdin = process_file ("-"); else for (; optind < argc; optind++) if (process_file (defines->arg)) read_stdin = true; /* Now handle wrapup text. */ while (pop_wrapup ()) expand_input (); /* Change debug stream back to stderr, to force flushing the debug stream and detect any errors it might have encountered. Close stdin if we read from it, to detect any errors. */ debug_set_output (NULL); if (read_stdin && fclose (stdin) == EOF) { M4ERROR ((warning_status, errno, "error reading file")); retcode = EXIT_FAILURE; } if (frozen_file_to_write) produce_frozen_state (frozen_file_to_write); else { make_diversion (0); undivert_all (); } output_exit (); exit (retcode); }