| 1 | /* Definitions for using variables in GNU Make.
|
|---|
| 2 | Copyright (C) 1988, 1989, 1990, 1991, 1992, 2002 Free Software Foundation, Inc.
|
|---|
| 3 | This file is part of GNU Make.
|
|---|
| 4 |
|
|---|
| 5 | GNU Make is free software; you can redistribute it and/or modify
|
|---|
| 6 | it under the terms of the GNU General Public License as published by
|
|---|
| 7 | the Free Software Foundation; either version 2, or (at your option)
|
|---|
| 8 | any later version.
|
|---|
| 9 |
|
|---|
| 10 | GNU Make is distributed in the hope that it will be useful,
|
|---|
| 11 | but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|---|
| 12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|---|
| 13 | GNU General Public License for more details.
|
|---|
| 14 |
|
|---|
| 15 | You should have received a copy of the GNU General Public License
|
|---|
| 16 | along with GNU Make; see the file COPYING. If not, write to
|
|---|
| 17 | the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|---|
| 18 | Boston, MA 02111-1307, USA. */
|
|---|
| 19 |
|
|---|
| 20 | #include "hash.h"
|
|---|
| 21 |
|
|---|
| 22 | /* Codes in a variable definition saying where the definition came from.
|
|---|
| 23 | Increasing numeric values signify less-overridable definitions. */
|
|---|
| 24 | enum variable_origin
|
|---|
| 25 | {
|
|---|
| 26 | o_default, /* Variable from the default set. */
|
|---|
| 27 | o_env, /* Variable from environment. */
|
|---|
| 28 | o_file, /* Variable given in a makefile. */
|
|---|
| 29 | o_env_override, /* Variable from environment, if -e. */
|
|---|
| 30 | o_command, /* Variable given by user. */
|
|---|
| 31 | o_override, /* Variable from an `override' directive. */
|
|---|
| 32 | o_automatic, /* Automatic variable -- cannot be set. */
|
|---|
| 33 | o_invalid /* Core dump time. */
|
|---|
| 34 | };
|
|---|
| 35 |
|
|---|
| 36 | enum variable_flavor
|
|---|
| 37 | {
|
|---|
| 38 | f_bogus, /* Bogus (error) */
|
|---|
| 39 | f_simple, /* Simple definition (:=) */
|
|---|
| 40 | f_recursive, /* Recursive definition (=) */
|
|---|
| 41 | f_append, /* Appending definition (+=) */
|
|---|
| 42 | f_conditional /* Conditional definition (?=) */
|
|---|
| 43 | };
|
|---|
| 44 |
|
|---|
| 45 | /* Structure that represents one variable definition.
|
|---|
| 46 | Each bucket of the hash table is a chain of these,
|
|---|
| 47 | chained through `next'. */
|
|---|
| 48 |
|
|---|
| 49 | #define EXP_COUNT_BITS 15 /* This gets all the bitfields into 32 bits */
|
|---|
| 50 | #define EXP_COUNT_MAX ((1<<EXP_COUNT_BITS)-1)
|
|---|
| 51 |
|
|---|
| 52 | struct variable
|
|---|
| 53 | {
|
|---|
| 54 | char *name; /* Variable name. */
|
|---|
| 55 | int length; /* strlen (name) */
|
|---|
| 56 | char *value; /* Variable value. */
|
|---|
| 57 | struct floc fileinfo; /* Where the variable was defined. */
|
|---|
| 58 | unsigned int recursive:1; /* Gets recursively re-evaluated. */
|
|---|
| 59 | unsigned int append:1; /* Nonzero if an appending target-specific
|
|---|
| 60 | variable. */
|
|---|
| 61 | unsigned int conditional:1; /* Nonzero if set with a ?=. */
|
|---|
| 62 | unsigned int per_target:1; /* Nonzero if a target-specific variable. */
|
|---|
| 63 | unsigned int special:1; /* Nonzero if this is a special variable. */
|
|---|
| 64 | unsigned int exportable:1; /* Nonzero if the variable _could_ be
|
|---|
| 65 | exported. */
|
|---|
| 66 | unsigned int expanding:1; /* Nonzero if currently being expanded. */
|
|---|
| 67 | unsigned int exp_count:EXP_COUNT_BITS;
|
|---|
| 68 | /* If >1, allow this many self-referential
|
|---|
| 69 | expansions. */
|
|---|
| 70 | enum variable_flavor
|
|---|
| 71 | flavor ENUM_BITFIELD (3); /* Variable flavor. */
|
|---|
| 72 | enum variable_origin
|
|---|
| 73 | origin ENUM_BITFIELD (3); /* Variable origin. */
|
|---|
| 74 | enum variable_export
|
|---|
| 75 | {
|
|---|
| 76 | v_export, /* Export this variable. */
|
|---|
| 77 | v_noexport, /* Don't export this variable. */
|
|---|
| 78 | v_ifset, /* Export it if it has a non-default value. */
|
|---|
| 79 | v_default /* Decide in target_environment. */
|
|---|
| 80 | } export ENUM_BITFIELD (2);
|
|---|
| 81 | };
|
|---|
| 82 |
|
|---|
| 83 | /* Structure that represents a variable set. */
|
|---|
| 84 |
|
|---|
| 85 | struct variable_set
|
|---|
| 86 | {
|
|---|
| 87 | struct hash_table table; /* Hash table of variables. */
|
|---|
| 88 | };
|
|---|
| 89 |
|
|---|
| 90 | /* Structure that represents a list of variable sets. */
|
|---|
| 91 |
|
|---|
| 92 | struct variable_set_list
|
|---|
| 93 | {
|
|---|
| 94 | struct variable_set_list *next; /* Link in the chain. */
|
|---|
| 95 | struct variable_set *set; /* Variable set. */
|
|---|
| 96 | };
|
|---|
| 97 |
|
|---|
| 98 | /* Structure used for pattern-specific variables. */
|
|---|
| 99 |
|
|---|
| 100 | struct pattern_var
|
|---|
| 101 | {
|
|---|
| 102 | struct pattern_var *next;
|
|---|
| 103 | char *target;
|
|---|
| 104 | unsigned int len;
|
|---|
| 105 | char *suffix;
|
|---|
| 106 | struct variable variable;
|
|---|
| 107 | };
|
|---|
| 108 |
|
|---|
| 109 | extern char *variable_buffer;
|
|---|
| 110 | extern struct variable_set_list *current_variable_set_list;
|
|---|
| 111 |
|
|---|
| 112 | /* expand.c */
|
|---|
| 113 | extern char *variable_buffer_output PARAMS ((char *ptr, char *string, unsigned int length));
|
|---|
| 114 | extern char *variable_expand PARAMS ((char *line));
|
|---|
| 115 | extern char *variable_expand_for_file PARAMS ((char *line, struct file *file));
|
|---|
| 116 | extern char *allocated_variable_expand_for_file PARAMS ((char *line, struct file *file));
|
|---|
| 117 | #define allocated_variable_expand(line) \
|
|---|
| 118 | allocated_variable_expand_for_file (line, (struct file *) 0)
|
|---|
| 119 | extern char *expand_argument PARAMS ((const char *str, const char *end));
|
|---|
| 120 | extern char *variable_expand_string PARAMS ((char *line, char *string,
|
|---|
| 121 | long length));
|
|---|
| 122 | extern void install_variable_buffer PARAMS ((char **bufp, unsigned int *lenp));
|
|---|
| 123 | extern void restore_variable_buffer PARAMS ((char *buf, unsigned int len));
|
|---|
| 124 |
|
|---|
| 125 | /* function.c */
|
|---|
| 126 | extern int handle_function PARAMS ((char **op, char **stringp));
|
|---|
| 127 | extern int pattern_matches PARAMS ((char *pattern, char *percent, char *str));
|
|---|
| 128 | extern char *subst_expand PARAMS ((char *o, char *text, char *subst, char *replace,
|
|---|
| 129 | unsigned int slen, unsigned int rlen, int by_word));
|
|---|
| 130 | extern char *patsubst_expand PARAMS ((char *o, char *text, char *pattern, char *replace,
|
|---|
| 131 | char *pattern_percent, char *replace_percent));
|
|---|
| 132 |
|
|---|
| 133 | /* expand.c */
|
|---|
| 134 | extern char *recursively_expand_for_file PARAMS ((struct variable *v,
|
|---|
| 135 | struct file *file));
|
|---|
| 136 | #define recursively_expand(v) recursively_expand_for_file (v, NULL)
|
|---|
| 137 |
|
|---|
| 138 | /* variable.c */
|
|---|
| 139 | extern struct variable_set_list *create_new_variable_set PARAMS ((void));
|
|---|
| 140 | extern struct variable_set_list *push_new_variable_scope PARAMS ((void));
|
|---|
| 141 | extern void pop_variable_scope PARAMS ((void));
|
|---|
| 142 | extern void define_automatic_variables PARAMS ((void));
|
|---|
| 143 | extern void initialize_file_variables PARAMS ((struct file *file, int read));
|
|---|
| 144 | extern void print_file_variables PARAMS ((struct file *file));
|
|---|
| 145 | extern void print_variable_set PARAMS ((struct variable_set *set, char *prefix));
|
|---|
| 146 | extern void merge_variable_set_lists PARAMS ((struct variable_set_list **to_list, struct variable_set_list *from_list));
|
|---|
| 147 | extern struct variable *do_variable_definition PARAMS ((const struct floc *flocp, const char *name, char *value, enum variable_origin origin, enum variable_flavor flavor, int target_var));
|
|---|
| 148 | extern struct variable *parse_variable_definition PARAMS ((struct variable *v, char *line));
|
|---|
| 149 | extern struct variable *try_variable_definition PARAMS ((const struct floc *flocp, char *line, enum variable_origin origin, int target_var));
|
|---|
| 150 | extern void init_hash_global_variable_set PARAMS ((void));
|
|---|
| 151 | extern void hash_init_function_table PARAMS ((void));
|
|---|
| 152 | extern struct variable *lookup_variable PARAMS ((const char *name, unsigned int length));
|
|---|
| 153 | extern struct variable *lookup_variable_in_set PARAMS ((const char *name,
|
|---|
| 154 | unsigned int length,
|
|---|
| 155 | const struct variable_set *set));
|
|---|
| 156 |
|
|---|
| 157 | extern struct variable *define_variable_in_set
|
|---|
| 158 | PARAMS ((const char *name, unsigned int length, char *value,
|
|---|
| 159 | enum variable_origin origin, int recursive,
|
|---|
| 160 | struct variable_set *set, const struct floc *flocp));
|
|---|
| 161 |
|
|---|
| 162 | /* Define a variable in the current variable set. */
|
|---|
| 163 |
|
|---|
| 164 | #define define_variable(n,l,v,o,r) \
|
|---|
| 165 | define_variable_in_set((n),(l),(v),(o),(r),\
|
|---|
| 166 | current_variable_set_list->set,NILF)
|
|---|
| 167 |
|
|---|
| 168 | /* Define a variable with a location in the current variable set. */
|
|---|
| 169 |
|
|---|
| 170 | #define define_variable_loc(n,l,v,o,r,f) \
|
|---|
| 171 | define_variable_in_set((n),(l),(v),(o),(r),\
|
|---|
| 172 | current_variable_set_list->set,(f))
|
|---|
| 173 |
|
|---|
| 174 | /* Define a variable with a location in the global variable set. */
|
|---|
| 175 |
|
|---|
| 176 | #define define_variable_global(n,l,v,o,r,f) \
|
|---|
| 177 | define_variable_in_set((n),(l),(v),(o),(r),NULL,(f))
|
|---|
| 178 |
|
|---|
| 179 | /* Define a variable in FILE's variable set. */
|
|---|
| 180 |
|
|---|
| 181 | #define define_variable_for_file(n,l,v,o,r,f) \
|
|---|
| 182 | define_variable_in_set((n),(l),(v),(o),(r),(f)->variables->set,NILF)
|
|---|
| 183 |
|
|---|
| 184 | /* Warn that NAME is an undefined variable. */
|
|---|
| 185 |
|
|---|
| 186 | #define warn_undefined(n,l) do{\
|
|---|
| 187 | if (warn_undefined_variables_flag) \
|
|---|
| 188 | error (reading_file, \
|
|---|
| 189 | _("warning: undefined variable `%.*s'"), \
|
|---|
| 190 | (int)(l), (n)); \
|
|---|
| 191 | }while(0)
|
|---|
| 192 |
|
|---|
| 193 | extern char **target_environment PARAMS ((struct file *file));
|
|---|
| 194 |
|
|---|
| 195 | extern struct pattern_var *create_pattern_var PARAMS ((char *target, char *suffix));
|
|---|
| 196 |
|
|---|
| 197 | extern int export_all_variables;
|
|---|
| 198 |
|
|---|
| 199 | #define MAKELEVEL_NAME "MAKELEVEL"
|
|---|
| 200 | #define MAKELEVEL_LENGTH (sizeof (MAKELEVEL_NAME) - 1)
|
|---|
