| 1 | /* Definitions for using variables in GNU Make.
|
|---|
| 2 | Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997,
|
|---|
| 3 | 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006 Free Software
|
|---|
| 4 | Foundation, Inc.
|
|---|
| 5 | This file is part of GNU Make.
|
|---|
| 6 |
|
|---|
| 7 | GNU Make is free software; you can redistribute it and/or modify it under the
|
|---|
| 8 | terms of the GNU General Public License as published by the Free Software
|
|---|
| 9 | Foundation; either version 2, or (at your option) any later version.
|
|---|
| 10 |
|
|---|
| 11 | GNU Make is distributed in the hope that it will be useful, but WITHOUT ANY
|
|---|
| 12 | WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
|
|---|
| 13 | A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|---|
| 14 |
|
|---|
| 15 | You should have received a copy of the GNU General Public License along with
|
|---|
| 16 | GNU Make; see the file COPYING. If not, write to the Free Software
|
|---|
| 17 | Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. */
|
|---|
| 18 |
|
|---|
| 19 | #include "hash.h"
|
|---|
| 20 |
|
|---|
| 21 | /* Codes in a variable definition saying where the definition came from.
|
|---|
| 22 | Increasing numeric values signify less-overridable definitions. */
|
|---|
| 23 | enum variable_origin
|
|---|
| 24 | {
|
|---|
| 25 | o_default, /* Variable from the default set. */
|
|---|
| 26 | o_env, /* Variable from environment. */
|
|---|
| 27 | o_file, /* Variable given in a makefile. */
|
|---|
| 28 | o_env_override, /* Variable from environment, if -e. */
|
|---|
| 29 | o_command, /* Variable given by user. */
|
|---|
| 30 | o_override, /* Variable from an `override' directive. */
|
|---|
| 31 | #ifdef CONFIG_WITH_LOCAL_VARIABLES
|
|---|
| 32 | o_local, /* Variable from an 'local' directive. */
|
|---|
| 33 | #endif
|
|---|
| 34 | o_automatic, /* Automatic variable -- cannot be set. */
|
|---|
| 35 | o_invalid /* Core dump time. */
|
|---|
| 36 | };
|
|---|
| 37 |
|
|---|
| 38 | enum variable_flavor
|
|---|
| 39 | {
|
|---|
| 40 | f_bogus, /* Bogus (error) */
|
|---|
| 41 | f_simple, /* Simple definition (:=) */
|
|---|
| 42 | f_recursive, /* Recursive definition (=) */
|
|---|
| 43 | f_append, /* Appending definition (+=) */
|
|---|
| 44 | #ifdef CONFIG_WITH_PREPEND_ASSIGNMENT
|
|---|
| 45 | f_prepend, /* Prepending definition (>=) */
|
|---|
| 46 | #endif
|
|---|
| 47 | f_conditional /* Conditional definition (?=) */
|
|---|
| 48 | };
|
|---|
| 49 |
|
|---|
| 50 | /* Structure that represents one variable definition.
|
|---|
| 51 | Each bucket of the hash table is a chain of these,
|
|---|
| 52 | chained through `next'. */
|
|---|
| 53 |
|
|---|
| 54 | #define EXP_COUNT_BITS 15 /* This gets all the bitfields into 32 bits */
|
|---|
| 55 | #define EXP_COUNT_MAX ((1<<EXP_COUNT_BITS)-1)
|
|---|
| 56 |
|
|---|
| 57 | struct variable
|
|---|
| 58 | {
|
|---|
| 59 | char *name; /* Variable name. */
|
|---|
| 60 | int length; /* strlen (name) */
|
|---|
| 61 | #ifdef VARIABLE_HASH /* bird */
|
|---|
| 62 | int hash1; /* the primary hash */
|
|---|
| 63 | int hash2; /* the secondary hash */
|
|---|
| 64 | #endif
|
|---|
| 65 | #ifdef CONFIG_WITH_VALUE_LENGTH
|
|---|
| 66 | int value_length; /* The length of the value, usually unused. */
|
|---|
| 67 | int value_alloc_len; /* The amount of memory we've actually allocated. */
|
|---|
| 68 | /* FIXME: make lengths unsigned! */
|
|---|
| 69 | #endif
|
|---|
| 70 | char *value; /* Variable value. */
|
|---|
| 71 | struct floc fileinfo; /* Where the variable was defined. */
|
|---|
| 72 | unsigned int recursive:1; /* Gets recursively re-evaluated. */
|
|---|
| 73 | unsigned int append:1; /* Nonzero if an appending target-specific
|
|---|
| 74 | variable. */
|
|---|
| 75 | unsigned int conditional:1; /* Nonzero if set with a ?=. */
|
|---|
| 76 | unsigned int per_target:1; /* Nonzero if a target-specific variable. */
|
|---|
| 77 | unsigned int special:1; /* Nonzero if this is a special variable. */
|
|---|
| 78 | unsigned int exportable:1; /* Nonzero if the variable _could_ be
|
|---|
| 79 | exported. */
|
|---|
| 80 | unsigned int expanding:1; /* Nonzero if currently being expanded. */
|
|---|
| 81 | unsigned int exp_count:EXP_COUNT_BITS;
|
|---|
| 82 | /* If >1, allow this many self-referential
|
|---|
| 83 | expansions. */
|
|---|
| 84 | enum variable_flavor
|
|---|
| 85 | flavor ENUM_BITFIELD (3); /* Variable flavor. */
|
|---|
| 86 | enum variable_origin
|
|---|
| 87 | #ifdef CONFIG_WITH_LOCAL_VARIABLES
|
|---|
| 88 | origin ENUM_BITFIELD (4); /* Variable origin. */
|
|---|
| 89 | #else
|
|---|
| 90 | origin ENUM_BITFIELD (3); /* Variable origin. */
|
|---|
| 91 | #endif
|
|---|
| 92 | enum variable_export
|
|---|
| 93 | {
|
|---|
| 94 | v_export, /* Export this variable. */
|
|---|
| 95 | v_noexport, /* Don't export this variable. */
|
|---|
| 96 | v_ifset, /* Export it if it has a non-default value. */
|
|---|
| 97 | v_default /* Decide in target_environment. */
|
|---|
| 98 | } export ENUM_BITFIELD (2);
|
|---|
| 99 | };
|
|---|
| 100 |
|
|---|
| 101 | /* Structure that represents a variable set. */
|
|---|
| 102 |
|
|---|
| 103 | struct variable_set
|
|---|
| 104 | {
|
|---|
| 105 | struct hash_table table; /* Hash table of variables. */
|
|---|
| 106 | };
|
|---|
| 107 |
|
|---|
| 108 | /* Structure that represents a list of variable sets. */
|
|---|
| 109 |
|
|---|
| 110 | struct variable_set_list
|
|---|
| 111 | {
|
|---|
| 112 | struct variable_set_list *next; /* Link in the chain. */
|
|---|
| 113 | struct variable_set *set; /* Variable set. */
|
|---|
| 114 | };
|
|---|
| 115 |
|
|---|
| 116 | /* Structure used for pattern-specific variables. */
|
|---|
| 117 |
|
|---|
| 118 | struct pattern_var
|
|---|
| 119 | {
|
|---|
| 120 | struct pattern_var *next;
|
|---|
| 121 | const char *suffix;
|
|---|
| 122 | const char *target;
|
|---|
| 123 | unsigned int len;
|
|---|
| 124 | struct variable variable;
|
|---|
| 125 | };
|
|---|
| 126 |
|
|---|
| 127 | extern char *variable_buffer;
|
|---|
| 128 | extern struct variable_set_list *current_variable_set_list;
|
|---|
| 129 | #ifdef KMK
|
|---|
| 130 | extern unsigned int variable_buffer_length;
|
|---|
| 131 | #define VARIABLE_BUFFER_ZONE 5
|
|---|
| 132 | #endif
|
|---|
| 133 |
|
|---|
| 134 | /* expand.c */
|
|---|
| 135 | #ifndef KMK
|
|---|
| 136 | char *variable_buffer_output (char *ptr, const char *string, unsigned int length);
|
|---|
| 137 | #else /* KMK */
|
|---|
| 138 | /* Subroutine of variable_expand and friends:
|
|---|
| 139 | The text to add is LENGTH chars starting at STRING to the variable_buffer.
|
|---|
| 140 | The text is added to the buffer at PTR, and the updated pointer into
|
|---|
| 141 | the buffer is returned as the value. Thus, the value returned by
|
|---|
| 142 | each call to variable_buffer_output should be the first argument to
|
|---|
| 143 | the following call. */
|
|---|
| 144 |
|
|---|
| 145 | __inline static char *
|
|---|
| 146 | variable_buffer_output (char *ptr, const char *string, unsigned int length)
|
|---|
| 147 | {
|
|---|
| 148 | register unsigned int newlen = length + (ptr - variable_buffer);
|
|---|
| 149 |
|
|---|
| 150 | if ((newlen + VARIABLE_BUFFER_ZONE) > variable_buffer_length)
|
|---|
| 151 | {
|
|---|
| 152 | unsigned int offset = ptr - variable_buffer;
|
|---|
| 153 | variable_buffer_length = variable_buffer_length <= 1024
|
|---|
| 154 | ? 2048 : variable_buffer_length * 4;
|
|---|
| 155 | if (variable_buffer_length < newlen + 100)
|
|---|
| 156 | variable_buffer_length = (newlen + 100 + 1023) & ~1023U;
|
|---|
| 157 | variable_buffer = xrealloc (variable_buffer, variable_buffer_length);
|
|---|
| 158 | ptr = variable_buffer + offset;
|
|---|
| 159 | }
|
|---|
| 160 |
|
|---|
| 161 | # ifndef _MSC_VER
|
|---|
| 162 | switch (length)
|
|---|
| 163 | {
|
|---|
| 164 | case 4: ptr[3] = string[3];
|
|---|
| 165 | case 3: ptr[2] = string[2];
|
|---|
| 166 | case 2: ptr[1] = string[1];
|
|---|
| 167 | case 1: ptr[0] = string[0];
|
|---|
| 168 | case 0:
|
|---|
| 169 | break;
|
|---|
| 170 | default:
|
|---|
| 171 | memcpy (ptr, string, length);
|
|---|
| 172 | break;
|
|---|
| 173 | }
|
|---|
| 174 | # else
|
|---|
| 175 | memcpy (ptr, string, length);
|
|---|
| 176 | # endif
|
|---|
| 177 | return ptr + length;
|
|---|
| 178 | }
|
|---|
| 179 |
|
|---|
| 180 | #endif /* KMK */
|
|---|
| 181 | char *variable_expand (const char *line);
|
|---|
| 182 | char *variable_expand_for_file (const char *line, struct file *file);
|
|---|
| 183 | #ifdef CONFIG_WITH_COMMANDS_FUNC
|
|---|
| 184 | char *variable_expand_for_file_2 (char *o, const char *line, struct file *file);
|
|---|
| 185 | #endif
|
|---|
| 186 | char *allocated_variable_expand_for_file (const char *line, struct file *file);
|
|---|
| 187 | #ifndef CONFIG_WITH_VALUE_LENGTH
|
|---|
| 188 | #define allocated_variable_expand(line) \
|
|---|
| 189 | allocated_variable_expand_for_file (line, (struct file *) 0)
|
|---|
| 190 | #else /* CONFIG_WITH_VALUE_LENGTH */
|
|---|
| 191 | # define allocated_variable_expand(line) \
|
|---|
| 192 | allocated_variable_expand_2 (line, -1, NULL)
|
|---|
| 193 | char *allocated_variable_expand_2(const char *line, unsigned int length, unsigned int *value_lenp);
|
|---|
| 194 | #endif /* CONFIG_WITH_VALUE_LENGTH */
|
|---|
| 195 | char *expand_argument (const char *str, const char *end);
|
|---|
| 196 | #ifndef CONFIG_WITH_VALUE_LENGTH
|
|---|
| 197 | char *variable_expand_string (char *line, const char *string, long length);
|
|---|
| 198 | #else /* CONFIG_WITH_VALUE_LENGTH */
|
|---|
| 199 | char *variable_expand_string_2 (char *line, const char *string, long length, char **eol);
|
|---|
| 200 | __inline static char *
|
|---|
| 201 | variable_expand_string (char *line, const char *string, long length)
|
|---|
| 202 | {
|
|---|
| 203 | char *ignored;
|
|---|
| 204 | return variable_expand_string_2 (line, string, length, &ignored);
|
|---|
| 205 | }
|
|---|
| 206 | #endif /* CONFIG_WITH_VALUE_LENGTH */
|
|---|
| 207 | void install_variable_buffer (char **bufp, unsigned int *lenp);
|
|---|
| 208 | void restore_variable_buffer (char *buf, unsigned int len);
|
|---|
| 209 | #ifdef CONFIG_WITH_VALUE_LENGTH
|
|---|
| 210 | void append_expanded_string_to_variable (struct variable *v, const char *value,
|
|---|
| 211 | unsigned int value_len, int append);
|
|---|
| 212 | #endif
|
|---|
| 213 |
|
|---|
| 214 | /* function.c */
|
|---|
| 215 | #ifndef CONFIG_WITH_VALUE_LENGTH
|
|---|
| 216 | int handle_function (char **op, const char **stringp);
|
|---|
| 217 | #else
|
|---|
| 218 | int handle_function (char **op, const char **stringp, const char *eol);
|
|---|
| 219 | #endif
|
|---|
| 220 | int pattern_matches (const char *pattern, const char *percent, const char *str);
|
|---|
| 221 | char *subst_expand (char *o, const char *text, const char *subst,
|
|---|
| 222 | const char *replace, unsigned int slen, unsigned int rlen,
|
|---|
| 223 | int by_word);
|
|---|
| 224 | char *patsubst_expand_pat (char *o, const char *text, const char *pattern,
|
|---|
| 225 | const char *replace, const char *pattern_percent,
|
|---|
| 226 | const char *replace_percent);
|
|---|
| 227 | char *patsubst_expand (char *o, const char *text, char *pattern, char *replace);
|
|---|
| 228 | #ifdef CONFIG_WITH_COMMANDS_FUNC
|
|---|
| 229 | char *func_commands (char *o, char **argv, const char *funcname);
|
|---|
| 230 | #endif
|
|---|
| 231 |
|
|---|
| 232 | /* expand.c */
|
|---|
| 233 | #ifndef CONFIG_WITH_VALUE_LENGTH
|
|---|
| 234 | char *recursively_expand_for_file (struct variable *v, struct file *file);
|
|---|
| 235 | #define recursively_expand(v) recursively_expand_for_file (v, NULL)
|
|---|
| 236 | #else
|
|---|
| 237 | char *recursively_expand_for_file (struct variable *v, struct file *file,
|
|---|
| 238 | unsigned int *value_lenp);
|
|---|
| 239 | #define recursively_expand(v) recursively_expand_for_file (v, NULL, NULL)
|
|---|
| 240 | #endif
|
|---|
| 241 |
|
|---|
| 242 | /* variable.c */
|
|---|
| 243 | struct variable_set_list *create_new_variable_set (void);
|
|---|
| 244 | void free_variable_set (struct variable_set_list *);
|
|---|
| 245 | struct variable_set_list *push_new_variable_scope (void);
|
|---|
| 246 | void pop_variable_scope (void);
|
|---|
| 247 | void define_automatic_variables (void);
|
|---|
| 248 | void initialize_file_variables (struct file *file, int reading);
|
|---|
| 249 | void print_file_variables (const struct file *file);
|
|---|
| 250 | void print_variable_set (struct variable_set *set, char *prefix);
|
|---|
| 251 | void merge_variable_set_lists (struct variable_set_list **to_list,
|
|---|
| 252 | struct variable_set_list *from_list);
|
|---|
| 253 | #ifndef CONFIG_WITH_VALUE_LENGTH
|
|---|
| 254 | struct variable *do_variable_definition (const struct floc *flocp,
|
|---|
| 255 | const char *name, const char *value,
|
|---|
| 256 | enum variable_origin origin,
|
|---|
| 257 | enum variable_flavor flavor,
|
|---|
| 258 | int target_var);
|
|---|
| 259 | struct variable *parse_variable_definition (struct variable *v, char *line);
|
|---|
| 260 | struct variable *try_variable_definition (const struct floc *flocp, char *line,
|
|---|
| 261 | enum variable_origin origin,
|
|---|
| 262 | int target_var);
|
|---|
| 263 | #else /* CONFIG_WITH_VALUE_LENGTH */
|
|---|
| 264 | # define do_variable_definition(flocp, varname, value, origin, flavor, target_var) \
|
|---|
| 265 | do_variable_definition_2 ((flocp), (varname), (value), ~0U, 0, NULL, \
|
|---|
| 266 | (origin), (flavor), (target_var))
|
|---|
| 267 |
|
|---|
| 268 | struct variable *do_variable_definition_2 (const struct floc *flocp,
|
|---|
| 269 | const char *varname,
|
|---|
| 270 | const char *value,
|
|---|
| 271 | unsigned int value_len,
|
|---|
| 272 | int simple_value, char *free_value,
|
|---|
| 273 | enum variable_origin origin,
|
|---|
| 274 | enum variable_flavor flavor,
|
|---|
| 275 | int target_var);
|
|---|
| 276 | struct variable *parse_variable_definition (struct variable *v, char *line,
|
|---|
| 277 | char *eos);
|
|---|
| 278 | struct variable *try_variable_definition (const struct floc *flocp, char *line,
|
|---|
| 279 | char *eos,
|
|---|
| 280 | enum variable_origin origin,
|
|---|
| 281 | int target_var);
|
|---|
| 282 | #endif /* CONFIG_WITH_VALUE_LENGTH */
|
|---|
| 283 | void init_hash_global_variable_set (void);
|
|---|
| 284 | void hash_init_function_table (void);
|
|---|
| 285 | struct variable *lookup_variable (const char *name, unsigned int length);
|
|---|
| 286 | struct variable *lookup_variable_in_set (const char *name, unsigned int length,
|
|---|
| 287 | const struct variable_set *set);
|
|---|
| 288 |
|
|---|
| 289 | #ifdef CONFIG_WITH_VALUE_LENGTH
|
|---|
| 290 | void append_string_to_variable (struct variable *v, const char *value,
|
|---|
| 291 | unsigned int value_len, int append);
|
|---|
| 292 |
|
|---|
| 293 | struct variable *define_variable_in_set (const char *name, unsigned int length,
|
|---|
| 294 | const char *value,
|
|---|
| 295 | unsigned int value_length,
|
|---|
| 296 | int duplicate_value,
|
|---|
| 297 | enum variable_origin origin,
|
|---|
| 298 | int recursive,
|
|---|
| 299 | struct variable_set *set,
|
|---|
| 300 | const struct floc *flocp);
|
|---|
| 301 |
|
|---|
| 302 | /* Define a variable in the current variable set. */
|
|---|
| 303 |
|
|---|
| 304 | #define define_variable(n,l,v,o,r) \
|
|---|
| 305 | define_variable_in_set((n),(l),(v),~0U,1,(o),(r),\
|
|---|
| 306 | current_variable_set_list->set,NILF)
|
|---|
| 307 |
|
|---|
| 308 | #define define_variable_vl(n,l,v,vl,dv,o,r) \
|
|---|
| 309 | define_variable_in_set((n),(l),(v),(vl),(dv),(o),(r),\
|
|---|
| 310 | current_variable_set_list->set,NILF)
|
|---|
| 311 |
|
|---|
| 312 | /* Define a variable with a location in the current variable set. */
|
|---|
| 313 |
|
|---|
| 314 | #define define_variable_loc(n,l,v,o,r,f) \
|
|---|
| 315 | define_variable_in_set((n),(l),(v),~0U,1,(o),(r),\
|
|---|
| 316 | current_variable_set_list->set,(f))
|
|---|
| 317 |
|
|---|
| 318 | /* Define a variable with a location in the global variable set. */
|
|---|
| 319 |
|
|---|
| 320 | #define define_variable_global(n,l,v,o,r,f) \
|
|---|
| 321 | define_variable_in_set((n),(l),(v),~0U,1,(o),(r),NULL,(f))
|
|---|
| 322 |
|
|---|
| 323 | #define define_variable_vl_global(n,l,v,vl,dv,o,r,f) \
|
|---|
| 324 | define_variable_in_set((n),(l),(v),(vl),(dv),(o),(r),NULL,(f))
|
|---|
| 325 |
|
|---|
| 326 | /* Define a variable in FILE's variable set. */
|
|---|
| 327 |
|
|---|
| 328 | #define define_variable_for_file(n,l,v,o,r,f) \
|
|---|
| 329 | define_variable_in_set((n),(l),(v),~0U,1,(o),(r),(f)->variables->set,NILF)
|
|---|
| 330 |
|
|---|
| 331 | #else /* !CONFIG_WITH_VALUE_LENGTH */
|
|---|
| 332 |
|
|---|
| 333 | struct variable *define_variable_in_set (const char *name, unsigned int length,
|
|---|
| 334 | const char *value,
|
|---|
| 335 | enum variable_origin origin,
|
|---|
| 336 | int recursive,
|
|---|
| 337 | struct variable_set *set,
|
|---|
| 338 | const struct floc *flocp);
|
|---|
| 339 |
|
|---|
| 340 | /* Define a variable in the current variable set. */
|
|---|
| 341 |
|
|---|
| 342 | #define define_variable(n,l,v,o,r) \
|
|---|
| 343 | define_variable_in_set((n),(l),(v),(o),(r),\
|
|---|
| 344 | current_variable_set_list->set,NILF) /* force merge conflict */
|
|---|
| 345 |
|
|---|
| 346 | /* Define a variable with a location in the current variable set. */
|
|---|
| 347 |
|
|---|
| 348 | #define define_variable_loc(n,l,v,o,r,f) \
|
|---|
| 349 | define_variable_in_set((n),(l),(v),(o),(r),\
|
|---|
| 350 | current_variable_set_list->set,(f)) /* force merge conflict */
|
|---|
| 351 |
|
|---|
| 352 | /* Define a variable with a location in the global variable set. */
|
|---|
| 353 |
|
|---|
| 354 | #define define_variable_global(n,l,v,o,r,f) \
|
|---|
| 355 | define_variable_in_set((n),(l),(v),(o),(r),NULL,(f)) /* force merge conflict */
|
|---|
| 356 |
|
|---|
| 357 | /* Define a variable in FILE's variable set. */
|
|---|
| 358 |
|
|---|
| 359 | #define define_variable_for_file(n,l,v,o,r,f) \
|
|---|
| 360 | define_variable_in_set((n),(l),(v),(o),(r),(f)->variables->set,NILF) /* force merge conflict */
|
|---|
| 361 |
|
|---|
| 362 | #endif /* !CONFIG_WITH_VALUE_LENGTH */
|
|---|
| 363 |
|
|---|
| 364 | /* Warn that NAME is an undefined variable. */
|
|---|
| 365 |
|
|---|
| 366 | #define warn_undefined(n,l) do{\
|
|---|
| 367 | if (warn_undefined_variables_flag) \
|
|---|
| 368 | error (reading_file, \
|
|---|
| 369 | _("warning: undefined variable `%.*s'"), \
|
|---|
| 370 | (int)(l), (n)); \
|
|---|
| 371 | }while(0)
|
|---|
| 372 |
|
|---|
| 373 | char **target_environment (struct file *file);
|
|---|
| 374 |
|
|---|
| 375 | struct pattern_var *create_pattern_var (const char *target,
|
|---|
| 376 | const char *suffix);
|
|---|
| 377 |
|
|---|
| 378 | extern int export_all_variables;
|
|---|
| 379 |
|
|---|
| 380 | #ifdef KMK
|
|---|
| 381 | # define MAKELEVEL_NAME "KMK_LEVEL"
|
|---|
| 382 | #else
|
|---|
| 383 | #define MAKELEVEL_NAME "MAKELEVEL"
|
|---|
| 384 | #endif
|
|---|
| 385 | #define MAKELEVEL_LENGTH (sizeof (MAKELEVEL_NAME) - 1)
|
|---|
