1 /* $NetBSD: var.c,v 1.215 2017/04/16 21:39:49 riastradh Exp $ */
4 * Copyright (c) 1988, 1989, 1990, 1993
5 * The Regents of the University of California. All rights reserved.
7 * This code is derived from software contributed to Berkeley by
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 * 3. Neither the name of the University nor the names of its contributors
19 * may be used to endorse or promote products derived from this software
20 * without specific prior written permission.
22 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36 * Copyright (c) 1989 by Berkeley Softworks
37 * All rights reserved.
39 * This code is derived from software contributed to Berkeley by
42 * Redistribution and use in source and binary forms, with or without
43 * modification, are permitted provided that the following conditions
45 * 1. Redistributions of source code must retain the above copyright
46 * notice, this list of conditions and the following disclaimer.
47 * 2. Redistributions in binary form must reproduce the above copyright
48 * notice, this list of conditions and the following disclaimer in the
49 * documentation and/or other materials provided with the distribution.
50 * 3. All advertising materials mentioning features or use of this software
51 * must display the following acknowledgement:
52 * This product includes software developed by the University of
53 * California, Berkeley and its contributors.
54 * 4. Neither the name of the University nor the names of its contributors
55 * may be used to endorse or promote products derived from this software
56 * without specific prior written permission.
58 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
59 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
60 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
61 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
62 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
63 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
64 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
65 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
66 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
67 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
72 static char rcsid[] = "$NetBSD: var.c,v 1.215 2017/04/16 21:39:49 riastradh Exp $";
74 #include <sys/cdefs.h>
77 static char sccsid[] = "@(#)var.c 8.3 (Berkeley) 3/19/94";
79 __RCSID("$NetBSD: var.c,v 1.215 2017/04/16 21:39:49 riastradh Exp $");
86 * Variable-handling functions
89 * Var_Set Set the value of a variable in the given
90 * context. The variable is created if it doesn't
91 * yet exist. The value and variable name need not
94 * Var_Append Append more characters to an existing variable
95 * in the given context. The variable needn't
96 * exist already -- it will be created if it doesn't.
97 * A space is placed between the old value and the
100 * Var_Exists See if a variable exists.
102 * Var_Value Return the value of a variable in a context or
103 * NULL if the variable is undefined.
105 * Var_Subst Substitute named variable, or all variables if
106 * NULL in a string using
107 * the given context as the top-most one. If the
108 * third argument is non-zero, Parse_Error is
109 * called if any variables are undefined.
111 * Var_Parse Parse a variable expansion from a string and
112 * return the result and the number of characters
115 * Var_Delete Delete a variable in a context.
117 * Var_Init Initialize this module.
120 * Var_Dump Print out all variables defined in the given
123 * XXX: There's a lot of duplication in these functions.
126 #include <sys/stat.h>
128 #include <sys/types.h>
140 #include "metachar.h"
142 extern int makelevel;
144 * This lets us tell if we have replaced the original environ
145 * (which we cannot free).
147 char **savedEnv = NULL;
150 * This is a harmless return value for Var_Parse that can be used by Var_Subst
151 * to determine if there was an error in parsing -- easier than returning
152 * a flag, as things outside this module don't give a hoot.
154 char var_Error[] = "";
157 * Similar to var_Error, but returned when the 'VARF_UNDEFERR' flag for
158 * Var_Parse is not set. Why not just use a constant? Well, gcc likes
159 * to condense identical string instances...
161 static char varNoError[] = "";
164 * Traditionally we consume $$ during := like any other expansion.
165 * Other make's do not.
166 * This knob allows controlling the behavior.
167 * FALSE for old behavior.
168 * TRUE for new compatible.
170 #define SAVE_DOLLARS ".MAKE.SAVE_DOLLARS"
171 static Boolean save_dollars = FALSE;
174 * Internally, variables are contained in four different contexts.
175 * 1) the environment. They may not be changed. If an environment
176 * variable is appended-to, the result is placed in the global
178 * 2) the global context. Variables set in the Makefile are located in
179 * the global context. It is the penultimate context searched when
181 * 3) the command-line context. All variables set on the command line
182 * are placed in this context. They are UNALTERABLE once placed here.
183 * 4) the local context. Each target has associated with it a context
184 * list. On this list are located the structures describing such
185 * local variables as $(@) and $(*)
186 * The four contexts are searched in the reverse order from which they are
189 GNode *VAR_INTERNAL; /* variables from make itself */
190 GNode *VAR_GLOBAL; /* variables from the makefile */
191 GNode *VAR_CMD; /* variables defined on the command-line */
193 #define FIND_CMD 0x1 /* look in VAR_CMD when searching */
194 #define FIND_GLOBAL 0x2 /* look in VAR_GLOBAL as well */
195 #define FIND_ENV 0x4 /* look in the environment also */
198 char *name; /* the variable's name */
199 Buffer val; /* its value */
200 int flags; /* miscellaneous status flags */
201 #define VAR_IN_USE 1 /* Variable's value currently being used.
202 * Used to avoid recursion */
203 #define VAR_FROM_ENV 2 /* Variable comes from the environment */
204 #define VAR_JUNK 4 /* Variable is a junk variable that
205 * should be destroyed when done with
206 * it. Used by Var_Parse for undefined,
207 * modified variables */
208 #define VAR_KEEP 8 /* Variable is VAR_JUNK, but we found
209 * a use for it in some modifier and
210 * the value is therefore valid */
211 #define VAR_EXPORTED 16 /* Variable is exported */
212 #define VAR_REEXPORT 32 /* Indicate if var needs re-export.
213 * This would be true if it contains $'s
215 #define VAR_FROM_CMD 64 /* Variable came from command line */
219 * Exporting vars is expensive so skip it if we can
221 #define VAR_EXPORTED_NONE 0
222 #define VAR_EXPORTED_YES 1
223 #define VAR_EXPORTED_ALL 2
224 static int var_exportedVars = VAR_EXPORTED_NONE;
226 * We pass this to Var_Export when doing the initial export
227 * or after updating an exported var.
229 #define VAR_EXPORT_PARENT 1
231 * We pass this to Var_Export1 to tell it to leave the value alone.
233 #define VAR_EXPORT_LITERAL 2
235 /* Var*Pattern flags */
236 #define VAR_SUB_GLOBAL 0x01 /* Apply substitution globally */
237 #define VAR_SUB_ONE 0x02 /* Apply substitution to one word */
238 #define VAR_SUB_MATCHED 0x04 /* There was a match */
239 #define VAR_MATCH_START 0x08 /* Match at start of word */
240 #define VAR_MATCH_END 0x10 /* Match at end of word */
241 #define VAR_NOSUBST 0x20 /* don't expand vars in VarGetPattern */
244 #define VAR_NO_EXPORT 0x01 /* do not export */
248 * The following fields are set by Var_Parse() when it
249 * encounters modifiers that need to keep state for use by
250 * subsequent modifiers within the same variable expansion.
252 Byte varSpace; /* Word separator in expansions */
253 Boolean oneBigWord; /* TRUE if we will treat the variable as a
254 * single big word, even if it contains
255 * embedded spaces (as opposed to the
256 * usual behaviour of treating it as
257 * several space-separated words). */
260 /* struct passed as 'void *' to VarSubstitute() for ":S/lhs/rhs/",
261 * to VarSYSVMatch() for ":lhs=rhs". */
263 const char *lhs; /* String to match */
264 int leftLen; /* Length of string */
265 const char *rhs; /* Replacement string (w/ &'s removed) */
266 int rightLen; /* Length of replacement */
270 /* struct passed as 'void *' to VarLoopExpand() for ":@tvar@str@" */
272 GNode *ctxt; /* variable context */
273 char *tvar; /* name of temp var */
275 char *str; /* string to expand */
277 int errnum; /* errnum for not defined */
281 /* struct passed as 'void *' to VarRESubstitute() for ":C///" */
291 /* struct passed to VarSelectWords() for ":[start..end]" */
293 int start; /* first word to select */
294 int end; /* last word to select */
297 static Var *VarFind(const char *, GNode *, int);
298 static void VarAdd(const char *, const char *, GNode *);
299 static Boolean VarHead(GNode *, Var_Parse_State *,
300 char *, Boolean, Buffer *, void *);
301 static Boolean VarTail(GNode *, Var_Parse_State *,
302 char *, Boolean, Buffer *, void *);
303 static Boolean VarSuffix(GNode *, Var_Parse_State *,
304 char *, Boolean, Buffer *, void *);
305 static Boolean VarRoot(GNode *, Var_Parse_State *,
306 char *, Boolean, Buffer *, void *);
307 static Boolean VarMatch(GNode *, Var_Parse_State *,
308 char *, Boolean, Buffer *, void *);
310 static Boolean VarSYSVMatch(GNode *, Var_Parse_State *,
311 char *, Boolean, Buffer *, void *);
313 static Boolean VarNoMatch(GNode *, Var_Parse_State *,
314 char *, Boolean, Buffer *, void *);
316 static void VarREError(int, regex_t *, const char *);
317 static Boolean VarRESubstitute(GNode *, Var_Parse_State *,
318 char *, Boolean, Buffer *, void *);
320 static Boolean VarSubstitute(GNode *, Var_Parse_State *,
321 char *, Boolean, Buffer *, void *);
322 static Boolean VarLoopExpand(GNode *, Var_Parse_State *,
323 char *, Boolean, Buffer *, void *);
324 static char *VarGetPattern(GNode *, Var_Parse_State *,
325 int, const char **, int, int *, int *,
327 static char *VarQuote(char *);
328 static char *VarHash(char *);
329 static char *VarModify(GNode *, Var_Parse_State *,
331 Boolean (*)(GNode *, Var_Parse_State *, char *, Boolean, Buffer *, void *),
333 static char *VarOrder(const char *, const char);
334 static char *VarUniq(const char *);
335 static int VarWordCompare(const void *, const void *);
336 static void VarPrintVar(void *);
344 *-----------------------------------------------------------------------
346 * Find the given variable in the given context and any other contexts
351 * ctxt context in which to find it
352 * flags FIND_GLOBAL set means to look in the
353 * VAR_GLOBAL context as well. FIND_CMD set means
354 * to look in the VAR_CMD context also. FIND_ENV
355 * set means to look in the environment
358 * A pointer to the structure describing the desired variable or
359 * NULL if the variable does not exist.
363 *-----------------------------------------------------------------------
366 VarFind(const char *name, GNode *ctxt, int flags)
372 * If the variable name begins with a '.', it could very well be one of
373 * the local ones. We check the name against all the local variables
374 * and substitute the short version in for 'name' if it matches one of
377 if (*name == '.' && isupper((unsigned char) name[1]))
380 if (!strcmp(name, ".ALLSRC"))
382 if (!strcmp(name, ".ARCHIVE"))
386 if (!strcmp(name, ".IMPSRC"))
390 if (!strcmp(name, ".MEMBER"))
394 if (!strcmp(name, ".OODATE"))
398 if (!strcmp(name, ".PREFIX"))
402 if (!strcmp(name, ".TARGET"))
407 /* for compatibility with gmake */
408 if (name[0] == '^' && name[1] == '\0')
413 * First look for the variable in the given context. If it's not there,
414 * look for it in VAR_CMD, VAR_GLOBAL and the environment, in that order,
415 * depending on the FIND_* flags in 'flags'
417 var = Hash_FindEntry(&ctxt->context, name);
419 if ((var == NULL) && (flags & FIND_CMD) && (ctxt != VAR_CMD)) {
420 var = Hash_FindEntry(&VAR_CMD->context, name);
422 if (!checkEnvFirst && (var == NULL) && (flags & FIND_GLOBAL) &&
423 (ctxt != VAR_GLOBAL))
425 var = Hash_FindEntry(&VAR_GLOBAL->context, name);
426 if ((var == NULL) && (ctxt != VAR_INTERNAL)) {
427 /* VAR_INTERNAL is subordinate to VAR_GLOBAL */
428 var = Hash_FindEntry(&VAR_INTERNAL->context, name);
431 if ((var == NULL) && (flags & FIND_ENV)) {
434 if ((env = getenv(name)) != NULL) {
437 v = bmake_malloc(sizeof(Var));
438 v->name = bmake_strdup(name);
442 Buf_Init(&v->val, len + 1);
443 Buf_AddBytes(&v->val, len, env);
445 v->flags = VAR_FROM_ENV;
447 } else if (checkEnvFirst && (flags & FIND_GLOBAL) &&
448 (ctxt != VAR_GLOBAL))
450 var = Hash_FindEntry(&VAR_GLOBAL->context, name);
451 if ((var == NULL) && (ctxt != VAR_INTERNAL)) {
452 var = Hash_FindEntry(&VAR_INTERNAL->context, name);
457 return ((Var *)Hash_GetValue(var));
462 } else if (var == NULL) {
465 return ((Var *)Hash_GetValue(var));
470 *-----------------------------------------------------------------------
472 * If the variable is an environment variable, free it
476 * destroy true if the value buffer should be destroyed.
479 * 1 if it is an environment variable 0 ow.
482 * The variable is free'ed if it is an environent variable.
483 *-----------------------------------------------------------------------
486 VarFreeEnv(Var *v, Boolean destroy)
488 if ((v->flags & VAR_FROM_ENV) == 0)
491 Buf_Destroy(&v->val, destroy);
497 *-----------------------------------------------------------------------
499 * Add a new variable of name name and value val to the given context
502 * name name of variable to add
503 * val value to set it to
504 * ctxt context in which to set it
510 * The new variable is placed at the front of the given context
511 * The name and val arguments are duplicated so they may
513 *-----------------------------------------------------------------------
516 VarAdd(const char *name, const char *val, GNode *ctxt)
522 v = bmake_malloc(sizeof(Var));
524 len = val ? strlen(val) : 0;
525 Buf_Init(&v->val, len+1);
526 Buf_AddBytes(&v->val, len, val);
530 h = Hash_CreateEntry(&ctxt->context, name, NULL);
533 if (DEBUG(VAR) && (ctxt->flags & INTERNAL) == 0) {
534 fprintf(debug_file, "%s:%s = %s\n", ctxt->name, name, val);
539 *-----------------------------------------------------------------------
541 * Remove a variable from a context.
547 * The Var structure is removed and freed.
549 *-----------------------------------------------------------------------
552 Var_Delete(const char *name, GNode *ctxt)
557 if (strchr(name, '$')) {
558 cp = Var_Subst(NULL, name, VAR_GLOBAL, VARF_WANTRES);
562 ln = Hash_FindEntry(&ctxt->context, cp);
564 fprintf(debug_file, "%s:delete %s%s\n",
565 ctxt->name, cp, ln ? "" : " (not found)");
573 v = (Var *)Hash_GetValue(ln);
574 if ((v->flags & VAR_EXPORTED)) {
577 if (strcmp(MAKE_EXPORTED, v->name) == 0) {
578 var_exportedVars = VAR_EXPORTED_NONE;
580 if (v->name != ln->name)
582 Hash_DeleteEntry(&ctxt->context, ln);
583 Buf_Destroy(&v->val, TRUE);
591 * We ignore make internal variables (those which start with '.')
592 * Also we jump through some hoops to avoid calling setenv
593 * more than necessary since it can leak.
594 * We only manipulate flags of vars if 'parent' is set.
597 Var_Export1(const char *name, int flags)
603 int parent = (flags & VAR_EXPORT_PARENT);
606 return 0; /* skip internals */
610 * If it is one of the vars that should only appear in
611 * local context, skip it, else we can get Var_Subst
622 v = VarFind(name, VAR_GLOBAL, 0);
627 (v->flags & (VAR_EXPORTED|VAR_REEXPORT)) == VAR_EXPORTED) {
628 return 0; /* nothing to do */
630 val = Buf_GetAll(&v->val, NULL);
631 if ((flags & VAR_EXPORT_LITERAL) == 0 && strchr(val, '$')) {
634 * Flag this as something we need to re-export.
635 * No point actually exporting it now though,
636 * the child can do it at the last minute.
638 v->flags |= (VAR_EXPORTED|VAR_REEXPORT);
641 if (v->flags & VAR_IN_USE) {
643 * We recursed while exporting in a child.
644 * This isn't going to end well, just skip it.
648 n = snprintf(tmp, sizeof(tmp), "${%s}", name);
649 if (n < (int)sizeof(tmp)) {
650 val = Var_Subst(NULL, tmp, VAR_GLOBAL, VARF_WANTRES);
651 setenv(name, val, 1);
656 v->flags &= ~VAR_REEXPORT; /* once will do */
658 if (parent || !(v->flags & VAR_EXPORTED)) {
659 setenv(name, val, 1);
663 * This is so Var_Set knows to call Var_Export again...
666 v->flags |= VAR_EXPORTED;
672 * This gets called from our children.
685 * Several make's support this sort of mechanism for tracking
686 * recursion - but each uses a different name.
687 * We allow the makefiles to update MAKELEVEL and ensure
688 * children see a correctly incremented value.
690 snprintf(tmp, sizeof(tmp), "%d", makelevel + 1);
691 setenv(MAKE_LEVEL_ENV, tmp, 1);
693 if (VAR_EXPORTED_NONE == var_exportedVars)
696 if (VAR_EXPORTED_ALL == var_exportedVars) {
698 * Ouch! This is crazy...
700 for (var = Hash_EnumFirst(&VAR_GLOBAL->context, &state);
702 var = Hash_EnumNext(&state)) {
703 v = (Var *)Hash_GetValue(var);
704 Var_Export1(v->name, 0);
709 * We have a number of exported vars,
711 n = snprintf(tmp, sizeof(tmp), "${" MAKE_EXPORTED ":O:u}");
712 if (n < (int)sizeof(tmp)) {
718 val = Var_Subst(NULL, tmp, VAR_GLOBAL, VARF_WANTRES);
720 av = brk_string(val, &ac, FALSE, &as);
721 for (i = 0; i < ac; i++) {
722 Var_Export1(av[i], 0);
732 * This is called when .export is seen or
733 * .MAKE.EXPORTED is modified.
734 * It is also called when any exported var is modified.
737 Var_Export(char *str, int isExport)
747 if (isExport && (!str || !str[0])) {
748 var_exportedVars = VAR_EXPORTED_ALL; /* use with caution! */
753 if (strncmp(str, "-env", 4) == 0) {
755 } else if (strncmp(str, "-literal", 8) == 0) {
757 flags |= VAR_EXPORT_LITERAL;
759 flags |= VAR_EXPORT_PARENT;
761 val = Var_Subst(NULL, str, VAR_GLOBAL, VARF_WANTRES);
763 av = brk_string(val, &ac, FALSE, &as);
764 for (i = 0; i < ac; i++) {
769 * If it is one of the vars that should only appear in
770 * local context, skip it, else we can get Var_Subst
781 if (Var_Export1(name, flags)) {
782 if (VAR_EXPORTED_ALL != var_exportedVars)
783 var_exportedVars = VAR_EXPORTED_YES;
784 if (isExport && (flags & VAR_EXPORT_PARENT)) {
785 Var_Append(MAKE_EXPORTED, name, VAR_GLOBAL);
797 * This is called when .unexport[-env] is seen.
799 extern char **environ;
802 Var_UnExport(char *str)
807 Boolean unexport_env;
810 if (!str || !str[0]) {
811 return; /* assert? */
817 unexport_env = (strncmp(str, "-env", 4) == 0);
821 cp = getenv(MAKE_LEVEL_ENV); /* we should preserve this */
822 if (environ == savedEnv) {
823 /* we have been here before! */
824 newenv = bmake_realloc(environ, 2 * sizeof(char *));
830 newenv = bmake_malloc(2 * sizeof(char *));
834 /* Note: we cannot safely free() the original environ. */
835 environ = savedEnv = newenv;
838 setenv(MAKE_LEVEL_ENV, cp, 1);
840 for (; *str != '\n' && isspace((unsigned char) *str); str++)
842 if (str[0] && str[0] != '\n') {
848 /* Using .MAKE.EXPORTED */
849 n = snprintf(tmp, sizeof(tmp), "${" MAKE_EXPORTED ":O:u}");
850 if (n < (int)sizeof(tmp)) {
851 vlist = Var_Subst(NULL, tmp, VAR_GLOBAL, VARF_WANTRES);
861 av = brk_string(vlist, &ac, FALSE, &as);
862 for (i = 0; i < ac; i++) {
863 v = VarFind(av[i], VAR_GLOBAL, 0);
867 (v->flags & (VAR_EXPORTED|VAR_REEXPORT)) == VAR_EXPORTED) {
870 v->flags &= ~(VAR_EXPORTED|VAR_REEXPORT);
872 * If we are unexporting a list,
873 * remove each one from .MAKE.EXPORTED.
874 * If we are removing them all,
875 * just delete .MAKE.EXPORTED below.
878 n = snprintf(tmp, sizeof(tmp),
879 "${" MAKE_EXPORTED ":N%s}", v->name);
880 if (n < (int)sizeof(tmp)) {
881 cp = Var_Subst(NULL, tmp, VAR_GLOBAL, VARF_WANTRES);
882 Var_Set(MAKE_EXPORTED, cp, VAR_GLOBAL, 0);
890 Var_Delete(MAKE_EXPORTED, VAR_GLOBAL);
897 *-----------------------------------------------------------------------
899 * Set the variable name to the value val in the given context.
902 * name name of variable to set
903 * val value to give to the variable
904 * ctxt context in which to set it
910 * If the variable doesn't yet exist, a new record is created for it.
911 * Else the old value is freed and the new one stuck in its place
914 * The variable is searched for only in its context before being
915 * created in that context. I.e. if the context is VAR_GLOBAL,
916 * only VAR_GLOBAL->context is searched. Likewise if it is VAR_CMD, only
917 * VAR_CMD->context is searched. This is done to avoid the literally
918 * thousands of unnecessary strcmp's that used to be done to
919 * set, say, $(@) or $(<).
920 * If the context is VAR_GLOBAL though, we check if the variable
921 * was set in VAR_CMD from the command line and skip it if so.
922 *-----------------------------------------------------------------------
925 Var_Set(const char *name, const char *val, GNode *ctxt, int flags)
928 char *expanded_name = NULL;
931 * We only look for a variable in the given context since anything set
932 * here will override anything in a lower context, so there's not much
933 * point in searching them all just to save a bit of memory...
935 if (strchr(name, '$') != NULL) {
936 expanded_name = Var_Subst(NULL, name, ctxt, VARF_WANTRES);
937 if (expanded_name[0] == 0) {
939 fprintf(debug_file, "Var_Set(\"%s\", \"%s\", ...) "
940 "name expands to empty string - ignored\n",
946 name = expanded_name;
948 if (ctxt == VAR_GLOBAL) {
949 v = VarFind(name, VAR_CMD, 0);
951 if ((v->flags & VAR_FROM_CMD)) {
953 fprintf(debug_file, "%s:%s = %s ignored!\n", ctxt->name, name, val);
960 v = VarFind(name, ctxt, 0);
962 if (ctxt == VAR_CMD && (flags & VAR_NO_EXPORT) == 0) {
964 * This var would normally prevent the same name being added
965 * to VAR_GLOBAL, so delete it from there if needed.
966 * Otherwise -V name may show the wrong value.
968 Var_Delete(name, VAR_GLOBAL);
970 VarAdd(name, val, ctxt);
973 Buf_AddBytes(&v->val, strlen(val), val);
976 fprintf(debug_file, "%s:%s = %s\n", ctxt->name, name, val);
978 if ((v->flags & VAR_EXPORTED)) {
979 Var_Export1(name, VAR_EXPORT_PARENT);
983 * Any variables given on the command line are automatically exported
984 * to the environment (as per POSIX standard)
986 if (ctxt == VAR_CMD && (flags & VAR_NO_EXPORT) == 0) {
988 /* we just added it */
989 v = VarFind(name, ctxt, 0);
992 v->flags |= VAR_FROM_CMD;
994 * If requested, don't export these in the environment
995 * individually. We still put them in MAKEOVERRIDES so
996 * that the command-line settings continue to override
999 if (varNoExportEnv != TRUE)
1000 setenv(name, val, 1);
1002 Var_Append(MAKEOVERRIDES, name, VAR_GLOBAL);
1005 if (strcmp(name, SAVE_DOLLARS) == 0)
1006 save_dollars = s2Boolean(val, save_dollars);
1010 free(expanded_name);
1012 VarFreeEnv(v, TRUE);
1016 *-----------------------------------------------------------------------
1018 * The variable of the given name has the given value appended to it in
1019 * the given context.
1022 * name name of variable to modify
1023 * val String to append to it
1024 * ctxt Context in which this should occur
1030 * If the variable doesn't exist, it is created. Else the strings
1031 * are concatenated (with a space in between).
1034 * Only if the variable is being sought in the global context is the
1035 * environment searched.
1036 * XXX: Knows its calling circumstances in that if called with ctxt
1037 * an actual target, it will only search that context since only
1038 * a local variable could be being appended to. This is actually
1039 * a big win and must be tolerated.
1040 *-----------------------------------------------------------------------
1043 Var_Append(const char *name, const char *val, GNode *ctxt)
1047 char *expanded_name = NULL;
1049 if (strchr(name, '$') != NULL) {
1050 expanded_name = Var_Subst(NULL, name, ctxt, VARF_WANTRES);
1051 if (expanded_name[0] == 0) {
1053 fprintf(debug_file, "Var_Append(\"%s\", \"%s\", ...) "
1054 "name expands to empty string - ignored\n",
1057 free(expanded_name);
1060 name = expanded_name;
1063 v = VarFind(name, ctxt, (ctxt == VAR_GLOBAL) ? FIND_ENV : 0);
1066 VarAdd(name, val, ctxt);
1068 Buf_AddByte(&v->val, ' ');
1069 Buf_AddBytes(&v->val, strlen(val), val);
1072 fprintf(debug_file, "%s:%s = %s\n", ctxt->name, name,
1073 Buf_GetAll(&v->val, NULL));
1076 if (v->flags & VAR_FROM_ENV) {
1078 * If the original variable came from the environment, we
1079 * have to install it in the global context (we could place
1080 * it in the environment, but then we should provide a way to
1081 * export other variables...)
1083 v->flags &= ~VAR_FROM_ENV;
1084 h = Hash_CreateEntry(&ctxt->context, name, NULL);
1085 Hash_SetValue(h, v);
1088 free(expanded_name);
1092 *-----------------------------------------------------------------------
1094 * See if the given variable exists.
1097 * name Variable to find
1098 * ctxt Context in which to start search
1101 * TRUE if it does, FALSE if it doesn't
1106 *-----------------------------------------------------------------------
1109 Var_Exists(const char *name, GNode *ctxt)
1114 if ((cp = strchr(name, '$')) != NULL) {
1115 cp = Var_Subst(NULL, name, ctxt, VARF_WANTRES);
1117 v = VarFind(cp ? cp : name, ctxt, FIND_CMD|FIND_GLOBAL|FIND_ENV);
1122 (void)VarFreeEnv(v, TRUE);
1128 *-----------------------------------------------------------------------
1130 * Return the value of the named variable in the given context
1134 * ctxt context in which to search for it
1137 * The value if the variable exists, NULL if it doesn't
1141 *-----------------------------------------------------------------------
1144 Var_Value(const char *name, GNode *ctxt, char **frp)
1148 v = VarFind(name, ctxt, FIND_ENV | FIND_GLOBAL | FIND_CMD);
1151 char *p = (Buf_GetAll(&v->val, NULL));
1152 if (VarFreeEnv(v, FALSE))
1161 *-----------------------------------------------------------------------
1163 * Remove the tail of the given word and place the result in the given
1168 * addSpace True if need to add a space to the buffer
1169 * before sticking in the head
1170 * buf Buffer in which to store it
1173 * TRUE if characters were added to the buffer (a space needs to be
1174 * added to the buffer before the next word).
1177 * The trimmed word is added to the buffer.
1179 *-----------------------------------------------------------------------
1182 VarHead(GNode *ctx MAKE_ATTR_UNUSED, Var_Parse_State *vpstate,
1183 char *word, Boolean addSpace, Buffer *buf,
1184 void *dummy MAKE_ATTR_UNUSED)
1188 slash = strrchr(word, '/');
1189 if (slash != NULL) {
1190 if (addSpace && vpstate->varSpace) {
1191 Buf_AddByte(buf, vpstate->varSpace);
1194 Buf_AddBytes(buf, strlen(word), word);
1199 * If no directory part, give . (q.v. the POSIX standard)
1201 if (addSpace && vpstate->varSpace)
1202 Buf_AddByte(buf, vpstate->varSpace);
1203 Buf_AddByte(buf, '.');
1209 *-----------------------------------------------------------------------
1211 * Remove the head of the given word and place the result in the given
1216 * addSpace True if need to add a space to the buffer
1217 * before adding the tail
1218 * buf Buffer in which to store it
1221 * TRUE if characters were added to the buffer (a space needs to be
1222 * added to the buffer before the next word).
1225 * The trimmed word is added to the buffer.
1227 *-----------------------------------------------------------------------
1230 VarTail(GNode *ctx MAKE_ATTR_UNUSED, Var_Parse_State *vpstate,
1231 char *word, Boolean addSpace, Buffer *buf,
1232 void *dummy MAKE_ATTR_UNUSED)
1236 if (addSpace && vpstate->varSpace) {
1237 Buf_AddByte(buf, vpstate->varSpace);
1240 slash = strrchr(word, '/');
1241 if (slash != NULL) {
1243 Buf_AddBytes(buf, strlen(slash), slash);
1246 Buf_AddBytes(buf, strlen(word), word);
1252 *-----------------------------------------------------------------------
1254 * Place the suffix of the given word in the given buffer.
1258 * addSpace TRUE if need to add a space before placing the
1259 * suffix in the buffer
1260 * buf Buffer in which to store it
1263 * TRUE if characters were added to the buffer (a space needs to be
1264 * added to the buffer before the next word).
1267 * The suffix from the word is placed in the buffer.
1269 *-----------------------------------------------------------------------
1272 VarSuffix(GNode *ctx MAKE_ATTR_UNUSED, Var_Parse_State *vpstate,
1273 char *word, Boolean addSpace, Buffer *buf,
1274 void *dummy MAKE_ATTR_UNUSED)
1278 dot = strrchr(word, '.');
1280 if (addSpace && vpstate->varSpace) {
1281 Buf_AddByte(buf, vpstate->varSpace);
1284 Buf_AddBytes(buf, strlen(dot), dot);
1292 *-----------------------------------------------------------------------
1294 * Remove the suffix of the given word and place the result in the
1299 * addSpace TRUE if need to add a space to the buffer
1300 * before placing the root in it
1301 * buf Buffer in which to store it
1304 * TRUE if characters were added to the buffer (a space needs to be
1305 * added to the buffer before the next word).
1308 * The trimmed word is added to the buffer.
1310 *-----------------------------------------------------------------------
1313 VarRoot(GNode *ctx MAKE_ATTR_UNUSED, Var_Parse_State *vpstate,
1314 char *word, Boolean addSpace, Buffer *buf,
1315 void *dummy MAKE_ATTR_UNUSED)
1319 if (addSpace && vpstate->varSpace) {
1320 Buf_AddByte(buf, vpstate->varSpace);
1323 dot = strrchr(word, '.');
1326 Buf_AddBytes(buf, strlen(word), word);
1329 Buf_AddBytes(buf, strlen(word), word);
1335 *-----------------------------------------------------------------------
1337 * Place the word in the buffer if it matches the given pattern.
1338 * Callback function for VarModify to implement the :M modifier.
1341 * word Word to examine
1342 * addSpace TRUE if need to add a space to the buffer
1343 * before adding the word, if it matches
1344 * buf Buffer in which to store it
1345 * pattern Pattern the word must match
1348 * TRUE if a space should be placed in the buffer before the next
1352 * The word may be copied to the buffer.
1354 *-----------------------------------------------------------------------
1357 VarMatch(GNode *ctx MAKE_ATTR_UNUSED, Var_Parse_State *vpstate,
1358 char *word, Boolean addSpace, Buffer *buf,
1362 fprintf(debug_file, "VarMatch [%s] [%s]\n", word, (char *)pattern);
1363 if (Str_Match(word, (char *)pattern)) {
1364 if (addSpace && vpstate->varSpace) {
1365 Buf_AddByte(buf, vpstate->varSpace);
1368 Buf_AddBytes(buf, strlen(word), word);
1375 *-----------------------------------------------------------------------
1377 * Place the word in the buffer if it matches the given pattern.
1378 * Callback function for VarModify to implement the System V %
1382 * word Word to examine
1383 * addSpace TRUE if need to add a space to the buffer
1384 * before adding the word, if it matches
1385 * buf Buffer in which to store it
1386 * patp Pattern the word must match
1389 * TRUE if a space should be placed in the buffer before the next
1393 * The word may be copied to the buffer.
1395 *-----------------------------------------------------------------------
1398 VarSYSVMatch(GNode *ctx, Var_Parse_State *vpstate,
1399 char *word, Boolean addSpace, Buffer *buf,
1404 VarPattern *pat = (VarPattern *)patp;
1407 if (addSpace && vpstate->varSpace)
1408 Buf_AddByte(buf, vpstate->varSpace);
1412 if ((ptr = Str_SYSVMatch(word, pat->lhs, &len)) != NULL) {
1413 varexp = Var_Subst(NULL, pat->rhs, ctx, VARF_WANTRES);
1414 Str_SYSVSubst(buf, varexp, ptr, len);
1417 Buf_AddBytes(buf, strlen(word), word);
1426 *-----------------------------------------------------------------------
1428 * Place the word in the buffer if it doesn't match the given pattern.
1429 * Callback function for VarModify to implement the :N modifier.
1432 * word Word to examine
1433 * addSpace TRUE if need to add a space to the buffer
1434 * before adding the word, if it matches
1435 * buf Buffer in which to store it
1436 * pattern Pattern the word must match
1439 * TRUE if a space should be placed in the buffer before the next
1443 * The word may be copied to the buffer.
1445 *-----------------------------------------------------------------------
1448 VarNoMatch(GNode *ctx MAKE_ATTR_UNUSED, Var_Parse_State *vpstate,
1449 char *word, Boolean addSpace, Buffer *buf,
1452 if (!Str_Match(word, (char *)pattern)) {
1453 if (addSpace && vpstate->varSpace) {
1454 Buf_AddByte(buf, vpstate->varSpace);
1457 Buf_AddBytes(buf, strlen(word), word);
1464 *-----------------------------------------------------------------------
1466 * Perform a string-substitution on the given word, placing the
1467 * result in the passed buffer.
1470 * word Word to modify
1471 * addSpace True if space should be added before
1473 * buf Buffer for result
1474 * patternp Pattern for substitution
1477 * TRUE if a space is needed before more characters are added.
1482 *-----------------------------------------------------------------------
1485 VarSubstitute(GNode *ctx MAKE_ATTR_UNUSED, Var_Parse_State *vpstate,
1486 char *word, Boolean addSpace, Buffer *buf,
1489 int wordLen; /* Length of word */
1490 char *cp; /* General pointer */
1491 VarPattern *pattern = (VarPattern *)patternp;
1493 wordLen = strlen(word);
1494 if ((pattern->flags & (VAR_SUB_ONE|VAR_SUB_MATCHED)) !=
1495 (VAR_SUB_ONE|VAR_SUB_MATCHED)) {
1497 * Still substituting -- break it down into simple anchored cases
1498 * and if none of them fits, perform the general substitution case.
1500 if ((pattern->flags & VAR_MATCH_START) &&
1501 (strncmp(word, pattern->lhs, pattern->leftLen) == 0)) {
1503 * Anchored at start and beginning of word matches pattern
1505 if ((pattern->flags & VAR_MATCH_END) &&
1506 (wordLen == pattern->leftLen)) {
1508 * Also anchored at end and matches to the end (word
1509 * is same length as pattern) add space and rhs only
1510 * if rhs is non-null.
1512 if (pattern->rightLen != 0) {
1513 if (addSpace && vpstate->varSpace) {
1514 Buf_AddByte(buf, vpstate->varSpace);
1517 Buf_AddBytes(buf, pattern->rightLen, pattern->rhs);
1519 pattern->flags |= VAR_SUB_MATCHED;
1520 } else if (pattern->flags & VAR_MATCH_END) {
1522 * Doesn't match to end -- copy word wholesale
1527 * Matches at start but need to copy in trailing characters
1529 if ((pattern->rightLen + wordLen - pattern->leftLen) != 0){
1530 if (addSpace && vpstate->varSpace) {
1531 Buf_AddByte(buf, vpstate->varSpace);
1535 Buf_AddBytes(buf, pattern->rightLen, pattern->rhs);
1536 Buf_AddBytes(buf, wordLen - pattern->leftLen,
1537 (word + pattern->leftLen));
1538 pattern->flags |= VAR_SUB_MATCHED;
1540 } else if (pattern->flags & VAR_MATCH_START) {
1542 * Had to match at start of word and didn't -- copy whole word.
1545 } else if (pattern->flags & VAR_MATCH_END) {
1547 * Anchored at end, Find only place match could occur (leftLen
1548 * characters from the end of the word) and see if it does. Note
1549 * that because the $ will be left at the end of the lhs, we have
1552 cp = word + (wordLen - pattern->leftLen);
1554 (strncmp(cp, pattern->lhs, pattern->leftLen) == 0)) {
1556 * Match found. If we will place characters in the buffer,
1557 * add a space before hand as indicated by addSpace, then
1558 * stuff in the initial, unmatched part of the word followed
1559 * by the right-hand-side.
1561 if (((cp - word) + pattern->rightLen) != 0) {
1562 if (addSpace && vpstate->varSpace) {
1563 Buf_AddByte(buf, vpstate->varSpace);
1567 Buf_AddBytes(buf, cp - word, word);
1568 Buf_AddBytes(buf, pattern->rightLen, pattern->rhs);
1569 pattern->flags |= VAR_SUB_MATCHED;
1572 * Had to match at end and didn't. Copy entire word.
1578 * Pattern is unanchored: search for the pattern in the word using
1579 * String_FindSubstring, copying unmatched portions and the
1580 * right-hand-side for each match found, handling non-global
1581 * substitutions correctly, etc. When the loop is done, any
1582 * remaining part of the word (word and wordLen are adjusted
1583 * accordingly through the loop) is copied straight into the
1585 * addSpace is set FALSE as soon as a space is added to the
1592 origSize = Buf_Size(buf);
1594 cp = Str_FindSubstring(word, pattern->lhs);
1596 if (addSpace && (((cp - word) + pattern->rightLen) != 0)){
1597 Buf_AddByte(buf, vpstate->varSpace);
1600 Buf_AddBytes(buf, cp-word, word);
1601 Buf_AddBytes(buf, pattern->rightLen, pattern->rhs);
1602 wordLen -= (cp - word) + pattern->leftLen;
1603 word = cp + pattern->leftLen;
1607 if ((pattern->flags & VAR_SUB_GLOBAL) == 0) {
1610 pattern->flags |= VAR_SUB_MATCHED;
1616 if (addSpace && vpstate->varSpace) {
1617 Buf_AddByte(buf, vpstate->varSpace);
1619 Buf_AddBytes(buf, wordLen, word);
1622 * If added characters to the buffer, need to add a space
1623 * before we add any more. If we didn't add any, just return
1624 * the previous value of addSpace.
1626 return ((Buf_Size(buf) != origSize) || addSpace);
1631 if (addSpace && vpstate->varSpace) {
1632 Buf_AddByte(buf, vpstate->varSpace);
1634 Buf_AddBytes(buf, wordLen, word);
1640 *-----------------------------------------------------------------------
1642 * Print the error caused by a regcomp or regexec call.
1648 * An error gets printed.
1650 *-----------------------------------------------------------------------
1653 VarREError(int reerr, regex_t *pat, const char *str)
1658 errlen = regerror(reerr, pat, 0, 0);
1659 errbuf = bmake_malloc(errlen);
1660 regerror(reerr, pat, errbuf, errlen);
1661 Error("%s: %s", str, errbuf);
1667 *-----------------------------------------------------------------------
1668 * VarRESubstitute --
1669 * Perform a regex substitution on the given word, placing the
1670 * result in the passed buffer.
1673 * TRUE if a space is needed before more characters are added.
1678 *-----------------------------------------------------------------------
1681 VarRESubstitute(GNode *ctx MAKE_ATTR_UNUSED,
1682 Var_Parse_State *vpstate MAKE_ATTR_UNUSED,
1683 char *word, Boolean addSpace, Buffer *buf,
1693 #define MAYBE_ADD_SPACE() \
1694 if (addSpace && !added) \
1695 Buf_AddByte(buf, ' '); \
1702 if ((pat->flags & (VAR_SUB_ONE|VAR_SUB_MATCHED)) ==
1703 (VAR_SUB_ONE|VAR_SUB_MATCHED))
1707 xrv = regexec(&pat->re, wp, pat->nsub, pat->matches, flags);
1712 pat->flags |= VAR_SUB_MATCHED;
1713 if (pat->matches[0].rm_so > 0) {
1715 Buf_AddBytes(buf, pat->matches[0].rm_so, wp);
1718 for (rp = pat->replace; *rp; rp++) {
1719 if ((*rp == '\\') && ((rp[1] == '&') || (rp[1] == '\\'))) {
1721 Buf_AddByte(buf,rp[1]);
1724 else if ((*rp == '&') ||
1725 ((*rp == '\\') && isdigit((unsigned char)rp[1]))) {
1743 if (n > pat->nsub) {
1744 Error("No subexpression %s", &errstr[0]);
1747 } else if ((pat->matches[n].rm_so == -1) &&
1748 (pat->matches[n].rm_eo == -1)) {
1749 Error("No match for subexpression %s", &errstr[0]);
1753 subbuf = wp + pat->matches[n].rm_so;
1754 sublen = pat->matches[n].rm_eo - pat->matches[n].rm_so;
1759 Buf_AddBytes(buf, sublen, subbuf);
1763 Buf_AddByte(buf, *rp);
1766 wp += pat->matches[0].rm_eo;
1767 if (pat->flags & VAR_SUB_GLOBAL) {
1768 flags |= REG_NOTBOL;
1769 if (pat->matches[0].rm_so == 0 && pat->matches[0].rm_eo == 0) {
1771 Buf_AddByte(buf, *wp);
1780 Buf_AddBytes(buf, strlen(wp), wp);
1784 VarREError(xrv, &pat->re, "Unexpected regex error");
1789 Buf_AddBytes(buf,strlen(wp),wp);
1793 return(addSpace||added);
1800 *-----------------------------------------------------------------------
1802 * Implements the :@<temp>@<string>@ modifier of ODE make.
1803 * We set the temp variable named in pattern.lhs to word and expand
1804 * pattern.rhs storing the result in the passed buffer.
1807 * word Word to modify
1808 * addSpace True if space should be added before
1810 * buf Buffer for result
1811 * pattern Datafor substitution
1814 * TRUE if a space is needed before more characters are added.
1819 *-----------------------------------------------------------------------
1822 VarLoopExpand(GNode *ctx MAKE_ATTR_UNUSED,
1823 Var_Parse_State *vpstate MAKE_ATTR_UNUSED,
1824 char *word, Boolean addSpace, Buffer *buf,
1827 VarLoop_t *loop = (VarLoop_t *)loopp;
1831 if (word && *word) {
1832 Var_Set(loop->tvar, word, loop->ctxt, VAR_NO_EXPORT);
1833 s = Var_Subst(NULL, loop->str, loop->ctxt, loop->errnum | VARF_WANTRES);
1834 if (s != NULL && *s != '\0') {
1835 if (addSpace && *s != '\n')
1836 Buf_AddByte(buf, ' ');
1837 Buf_AddBytes(buf, (slen = strlen(s)), s);
1838 addSpace = (slen > 0 && s[slen - 1] != '\n');
1847 *-----------------------------------------------------------------------
1849 * Implements the :[start..end] modifier.
1850 * This is a special case of VarModify since we want to be able
1851 * to scan the list backwards if start > end.
1854 * str String whose words should be trimmed
1855 * seldata words to select
1858 * A string of all the words selected.
1863 *-----------------------------------------------------------------------
1866 VarSelectWords(GNode *ctx MAKE_ATTR_UNUSED, Var_Parse_State *vpstate,
1867 const char *str, VarSelectWords_t *seldata)
1869 Buffer buf; /* Buffer for the new string */
1870 Boolean addSpace; /* TRUE if need to add a space to the
1871 * buffer before adding the trimmed
1873 char **av; /* word list */
1874 char *as; /* word list memory */
1876 int start, end, step;
1881 if (vpstate->oneBigWord) {
1882 /* fake what brk_string() would do if there were only one word */
1884 av = bmake_malloc((ac + 1) * sizeof(char *));
1885 as = bmake_strdup(str);
1889 av = brk_string(str, &ac, FALSE, &as);
1893 * Now sanitize seldata.
1894 * If seldata->start or seldata->end are negative, convert them to
1895 * the positive equivalents (-1 gets converted to argc, -2 gets
1896 * converted to (argc-1), etc.).
1898 if (seldata->start < 0)
1899 seldata->start = ac + seldata->start + 1;
1900 if (seldata->end < 0)
1901 seldata->end = ac + seldata->end + 1;
1904 * We avoid scanning more of the list than we need to.
1906 if (seldata->start > seldata->end) {
1907 start = MIN(ac, seldata->start) - 1;
1908 end = MAX(0, seldata->end - 1);
1911 start = MAX(0, seldata->start - 1);
1912 end = MIN(ac, seldata->end);
1917 (step < 0 && i >= end) || (step > 0 && i < end);
1919 if (av[i] && *av[i]) {
1920 if (addSpace && vpstate->varSpace) {
1921 Buf_AddByte(&buf, vpstate->varSpace);
1923 Buf_AddBytes(&buf, strlen(av[i]), av[i]);
1931 return Buf_Destroy(&buf, FALSE);
1937 * Replace each word with the result of realpath()
1941 VarRealpath(GNode *ctx MAKE_ATTR_UNUSED, Var_Parse_State *vpstate,
1942 char *word, Boolean addSpace, Buffer *buf,
1943 void *patternp MAKE_ATTR_UNUSED)
1946 char rbuf[MAXPATHLEN];
1949 if (addSpace && vpstate->varSpace) {
1950 Buf_AddByte(buf, vpstate->varSpace);
1953 rp = cached_realpath(word, rbuf);
1954 if (rp && *rp == '/' && stat(rp, &st) == 0)
1957 Buf_AddBytes(buf, strlen(word), word);
1962 *-----------------------------------------------------------------------
1964 * Modify each of the words of the passed string using the given
1965 * function. Used to implement all modifiers.
1968 * str String whose words should be trimmed
1969 * modProc Function to use to modify them
1970 * datum Datum to pass it
1973 * A string of all the words modified appropriately.
1978 *-----------------------------------------------------------------------
1981 VarModify(GNode *ctx, Var_Parse_State *vpstate,
1983 Boolean (*modProc)(GNode *, Var_Parse_State *, char *,
1984 Boolean, Buffer *, void *),
1987 Buffer buf; /* Buffer for the new string */
1988 Boolean addSpace; /* TRUE if need to add a space to the
1989 * buffer before adding the trimmed
1991 char **av; /* word list */
1992 char *as; /* word list memory */
1998 if (vpstate->oneBigWord) {
1999 /* fake what brk_string() would do if there were only one word */
2001 av = bmake_malloc((ac + 1) * sizeof(char *));
2002 as = bmake_strdup(str);
2006 av = brk_string(str, &ac, FALSE, &as);
2009 for (i = 0; i < ac; i++) {
2010 addSpace = (*modProc)(ctx, vpstate, av[i], addSpace, &buf, datum);
2016 return Buf_Destroy(&buf, FALSE);
2021 VarWordCompare(const void *a, const void *b)
2023 int r = strcmp(*(const char * const *)a, *(const char * const *)b);
2028 *-----------------------------------------------------------------------
2030 * Order the words in the string.
2033 * str String whose words should be sorted.
2034 * otype How to order: s - sort, x - random.
2037 * A string containing the words ordered.
2042 *-----------------------------------------------------------------------
2045 VarOrder(const char *str, const char otype)
2047 Buffer buf; /* Buffer for the new string */
2048 char **av; /* word list [first word does not count] */
2049 char *as; /* word list memory */
2054 av = brk_string(str, &ac, FALSE, &as);
2058 case 's': /* sort alphabetically */
2059 qsort(av, ac, sizeof(char *), VarWordCompare);
2061 case 'x': /* randomize */
2067 * We will use [ac..2] range for mod factors. This will produce
2068 * random numbers in [(ac-1)..0] interval, and minimal
2069 * reasonable value for mod factor is 2 (the mod 1 will produce
2070 * 0 with probability 1).
2072 for (i = ac-1; i > 0; i--) {
2073 rndidx = random() % (i + 1);
2081 } /* end of switch */
2083 for (i = 0; i < ac; i++) {
2084 Buf_AddBytes(&buf, strlen(av[i]), av[i]);
2086 Buf_AddByte(&buf, ' ');
2092 return Buf_Destroy(&buf, FALSE);
2097 *-----------------------------------------------------------------------
2099 * Remove adjacent duplicate words.
2102 * str String whose words should be sorted
2105 * A string containing the resulting words.
2110 *-----------------------------------------------------------------------
2113 VarUniq(const char *str)
2115 Buffer buf; /* Buffer for new string */
2116 char **av; /* List of words to affect */
2117 char *as; /* Word list memory */
2121 av = brk_string(str, &ac, FALSE, &as);
2124 for (j = 0, i = 1; i < ac; i++)
2125 if (strcmp(av[i], av[j]) != 0 && (++j != i))
2130 for (i = 0; i < ac; i++) {
2131 Buf_AddBytes(&buf, strlen(av[i]), av[i]);
2133 Buf_AddByte(&buf, ' ');
2139 return Buf_Destroy(&buf, FALSE);
2143 *-----------------------------------------------------------------------
2145 * Return an integer sequence
2148 * str String whose words provide default range
2149 * ac range length, if 0 use str words
2154 *-----------------------------------------------------------------------
2157 VarRange(const char *str, int ac)
2159 Buffer buf; /* Buffer for new string */
2160 char tmp[32]; /* each element */
2161 char **av; /* List of words to affect */
2162 char *as; /* Word list memory */
2170 av = brk_string(str, &ac, FALSE, &as);
2172 for (i = 0; i < ac; i++) {
2173 n = snprintf(tmp, sizeof(tmp), "%d", 1 + i);
2174 if (n >= (int)sizeof(tmp))
2176 Buf_AddBytes(&buf, n, tmp);
2178 Buf_AddByte(&buf, ' ');
2184 return Buf_Destroy(&buf, FALSE);
2189 *-----------------------------------------------------------------------
2191 * Pass through the tstr looking for 1) escaped delimiters,
2192 * '$'s and backslashes (place the escaped character in
2193 * uninterpreted) and 2) unescaped $'s that aren't before
2194 * the delimiter (expand the variable substitution unless flags
2195 * has VAR_NOSUBST set).
2196 * Return the expanded string or NULL if the delimiter was missing
2197 * If pattern is specified, handle escaped ampersands, and replace
2198 * unescaped ampersands with the lhs of the pattern.
2201 * A string of all the words modified appropriately.
2202 * If length is specified, return the string length of the buffer
2203 * If flags is specified and the last character of the pattern is a
2204 * $ set the VAR_MATCH_END bit of flags.
2208 *-----------------------------------------------------------------------
2211 VarGetPattern(GNode *ctxt, Var_Parse_State *vpstate MAKE_ATTR_UNUSED,
2212 int flags, const char **tstr, int delim, int *vflags,
2213 int *length, VarPattern *pattern)
2219 int errnum = flags & VARF_UNDEFERR;
2225 #define IS_A_MATCH(cp, delim) \
2226 ((cp[0] == '\\') && ((cp[1] == delim) || \
2227 (cp[1] == '\\') || (cp[1] == '$') || (pattern && (cp[1] == '&'))))
2230 * Skim through until the matching delimiter is found;
2231 * pick up variable substitutions on the way. Also allow
2232 * backslashes to quote the delimiter, $, and \, but don't
2233 * touch other backslashes.
2235 for (cp = *tstr; *cp && (*cp != delim); cp++) {
2236 if (IS_A_MATCH(cp, delim)) {
2237 Buf_AddByte(&buf, cp[1]);
2239 } else if (*cp == '$') {
2240 if (cp[1] == delim) {
2242 Buf_AddByte(&buf, *cp);
2245 * Unescaped $ at end of pattern => anchor
2248 *vflags |= VAR_MATCH_END;
2250 if (vflags == NULL || (*vflags & VAR_NOSUBST) == 0) {
2256 * If unescaped dollar sign not before the
2257 * delimiter, assume it's a variable
2258 * substitution and recurse.
2260 cp2 = Var_Parse(cp, ctxt, errnum | VARF_WANTRES, &len,
2262 Buf_AddBytes(&buf, strlen(cp2), cp2);
2266 const char *cp2 = &cp[1];
2268 if (*cp2 == PROPEN || *cp2 == BROPEN) {
2270 * Find the end of this variable reference
2271 * and suck it in without further ado.
2272 * It will be interperated later.
2275 int want = (*cp2 == PROPEN) ? PRCLOSE : BRCLOSE;
2278 for (++cp2; *cp2 != '\0' && depth > 0; ++cp2) {
2279 if (cp2[-1] != '\\') {
2286 Buf_AddBytes(&buf, cp2 - cp, cp);
2289 Buf_AddByte(&buf, *cp);
2293 else if (pattern && *cp == '&')
2294 Buf_AddBytes(&buf, pattern->leftLen, pattern->lhs);
2296 Buf_AddByte(&buf, *cp);
2306 *length = Buf_Size(&buf);
2307 rstr = Buf_Destroy(&buf, FALSE);
2309 fprintf(debug_file, "Modifier pattern: \"%s\"\n", rstr);
2314 *-----------------------------------------------------------------------
2316 * Quote shell meta-characters and space characters in the string
2324 *-----------------------------------------------------------------------
2331 const char *newline;
2334 if ((newline = Shell_GetNewline()) == NULL)
2336 nlen = strlen(newline);
2340 for (; *str != '\0'; str++) {
2342 Buf_AddBytes(&buf, nlen, newline);
2345 if (isspace((unsigned char)*str) || ismeta((unsigned char)*str))
2346 Buf_AddByte(&buf, '\\');
2347 Buf_AddByte(&buf, *str);
2350 str = Buf_Destroy(&buf, FALSE);
2352 fprintf(debug_file, "QuoteMeta: [%s]\n", str);
2357 *-----------------------------------------------------------------------
2359 * Hash the string using the MurmurHash3 algorithm.
2360 * Output is computed using 32bit Little Endian arithmetic.
2363 * str String to modify
2366 * Hash value of str, encoded as 8 hex digits.
2371 *-----------------------------------------------------------------------
2376 static const char hexdigits[16] = "0123456789abcdef";
2379 unsigned char *ustr = (unsigned char *)str;
2380 unsigned int h, k, c1, c2;
2387 for (len = len2; len; ) {
2391 k = (ustr[3] << 24) | (ustr[2] << 16) | (ustr[1] << 8) | ustr[0];
2396 k |= (ustr[2] << 16);
2398 k |= (ustr[1] << 8);
2403 c1 = c1 * 5 + 0x7b7d159cU;
2404 c2 = c2 * 5 + 0x6bce6396U;
2406 k = (k << 11) ^ (k >> 21);
2408 h = (h << 13) ^ (h >> 19);
2409 h = h * 5 + 0x52dce729U;
2419 for (len = 0; len < 8; ++len) {
2420 Buf_AddByte(&buf, hexdigits[h & 15]);
2424 return Buf_Destroy(&buf, FALSE);
2428 VarStrftime(const char *fmt, int zulu, time_t utc)
2436 strftime(buf, sizeof(buf), fmt, zulu ? gmtime(&utc) : localtime(&utc));
2438 buf[sizeof(buf) - 1] = '\0';
2439 return bmake_strdup(buf);
2443 * Now we need to apply any modifiers the user wants applied.
2445 * :M<pattern> words which match the given <pattern>.
2446 * <pattern> is of the standard file
2448 * :N<pattern> words which do not match the given <pattern>.
2449 * :S<d><pat1><d><pat2><d>[1gW]
2450 * Substitute <pat2> for <pat1> in the value
2451 * :C<d><pat1><d><pat2><d>[1gW]
2452 * Substitute <pat2> for regex <pat1> in the value
2453 * :H Substitute the head of each word
2454 * :T Substitute the tail of each word
2455 * :E Substitute the extension (minus '.') of
2457 * :R Substitute the root of each word
2458 * (pathname minus the suffix).
2459 * :O ("Order") Alphabeticaly sort words in variable.
2460 * :Ox ("intermiX") Randomize words in variable.
2461 * :u ("uniq") Remove adjacent duplicate words.
2462 * :tu Converts the variable contents to uppercase.
2463 * :tl Converts the variable contents to lowercase.
2464 * :ts[c] Sets varSpace - the char used to
2465 * separate words to 'c'. If 'c' is
2466 * omitted then no separation is used.
2467 * :tW Treat the variable contents as a single
2468 * word, even if it contains spaces.
2469 * (Mnemonic: one big 'W'ord.)
2470 * :tw Treat the variable contents as multiple
2471 * space-separated words.
2472 * (Mnemonic: many small 'w'ords.)
2473 * :[index] Select a single word from the value.
2474 * :[start..end] Select multiple words from the value.
2475 * :[*] or :[0] Select the entire value, as a single
2476 * word. Equivalent to :tW.
2477 * :[@] Select the entire value, as multiple
2478 * words. Undoes the effect of :[*].
2479 * Equivalent to :tw.
2480 * :[#] Returns the number of words in the value.
2482 * :?<true-value>:<false-value>
2483 * If the variable evaluates to true, return
2484 * true value, else return the second value.
2485 * :lhs=rhs Like :S, but the rhs goes to the end of
2487 * :sh Treat the current value as a command
2488 * to be run, new value is its output.
2489 * The following added so we can handle ODE makefiles.
2490 * :@<tmpvar>@<newval>@
2491 * Assign a temporary local variable <tmpvar>
2492 * to the current value of each word in turn
2493 * and replace each word with the result of
2494 * evaluating <newval>
2495 * :D<newval> Use <newval> as value if variable defined
2496 * :U<newval> Use <newval> as value if variable undefined
2497 * :L Use the name of the variable as the value.
2498 * :P Use the path of the node that has the same
2499 * name as the variable as the value. This
2500 * basically includes an implied :L so that
2501 * the common method of refering to the path
2502 * of your dependent 'x' in a rule is to use
2503 * the form '${x:P}'.
2504 * :!<cmd>! Run cmd much the same as :sh run's the
2505 * current value of the variable.
2506 * The ::= modifiers, actually assign a value to the variable.
2507 * Their main purpose is in supporting modifiers of .for loop
2508 * iterators and other obscure uses. They always expand to
2509 * nothing. In a target rule that would otherwise expand to an
2510 * empty line they can be preceded with @: to keep make happy.
2514 * .for i in ${.TARGET} ${.TARGET:R}.gz
2519 * ::=<str> Assigns <str> as the new value of variable.
2520 * ::?=<str> Assigns <str> as value of variable if
2521 * it was not already set.
2522 * ::+=<str> Appends <str> to variable.
2523 * ::!=<cmd> Assigns output of <cmd> as the new value of
2527 /* we now have some modifiers with long names */
2528 #define STRMOD_MATCH(s, want, n) \
2529 (strncmp(s, want, n) == 0 && (s[n] == endc || s[n] == ':'))
2530 #define STRMOD_MATCHX(s, want, n) \
2531 (strncmp(s, want, n) == 0 && (s[n] == endc || s[n] == ':' || s[n] == '='))
2532 #define CHARMOD_MATCH(c) (c == endc || c == ':')
2535 ApplyModifiers(char *nstr, const char *tstr,
2536 int startc, int endc,
2537 Var *v, GNode *ctxt, int flags,
2538 int *lengthPtr, void **freePtr)
2541 const char *cp; /* Secondary pointer into str (place marker
2543 char *newStr; /* New value to return */
2545 char termc; /* Character which terminated scan */
2546 int cnt; /* Used to count brace pairs when variable in
2547 * in parens or braces */
2549 int modifier; /* that we are processing */
2550 Var_Parse_State parsestate; /* Flags passed to helper functions */
2551 time_t utc; /* for VarStrftime */
2554 parsestate.oneBigWord = FALSE;
2555 parsestate.varSpace = ' '; /* word separator */
2559 while (*tstr && *tstr != endc) {
2563 * We may have some complex modifiers in a variable.
2570 rval = Var_Parse(tstr, ctxt, flags, &rlen, &freeIt);
2573 * If we have not parsed up to endc or ':',
2574 * we are not interested.
2576 if (rval != NULL && *rval &&
2577 (c = tstr[rlen]) != '\0' &&
2585 fprintf(debug_file, "Got '%s' from '%.*s'%.*s\n",
2586 rval, rlen, tstr, rlen, tstr + rlen);
2591 if (rval != NULL && *rval) {
2594 nstr = ApplyModifiers(nstr, rval,
2595 0, 0, v, ctxt, flags, &used, freePtr);
2596 if (nstr == var_Error
2597 || (nstr == varNoError && (flags & VARF_UNDEFERR) == 0)
2598 || strlen(rval) != (size_t) used) {
2600 goto out; /* error already reported */
2606 else if (!*tstr && endc) {
2607 Error("Unclosed variable specification after complex modifier (expecting '%c') for %s", endc, v->name);
2614 fprintf(debug_file, "Applying[%s] :%c to \"%s\"\n", v->name,
2618 switch ((modifier = *tstr)) {
2621 if (tstr[1] == '=' ||
2623 (tstr[1] == '!' || tstr[1] == '+' || tstr[1] == '?'))) {
2625 * "::=", "::!=", "::+=", or "::?="
2627 GNode *v_ctxt; /* context where v belongs */
2634 if (v->name[0] == 0)
2640 if (v->flags & VAR_JUNK) {
2642 * We need to bmake_strdup() it incase
2643 * VarGetPattern() recurses.
2646 v->name = bmake_strdup(v->name);
2647 } else if (ctxt != VAR_GLOBAL) {
2648 Var *gv = VarFind(v->name, ctxt, 0);
2650 v_ctxt = VAR_GLOBAL;
2652 VarFreeEnv(gv, TRUE);
2655 switch ((how = *tstr)) {
2665 delim = startc == PROPEN ? PRCLOSE : BRCLOSE;
2668 vflags = (flags & VARF_WANTRES) ? 0 : VAR_NOSUBST;
2669 pattern.rhs = VarGetPattern(ctxt, &parsestate, flags,
2670 &cp, delim, &vflags,
2673 if (v->flags & VAR_JUNK) {
2674 /* restore original name */
2678 if (pattern.rhs == NULL)
2684 if (flags & VARF_WANTRES) {
2687 Var_Append(v->name, pattern.rhs, v_ctxt);
2690 newStr = Cmd_Exec(pattern.rhs, &emsg);
2694 Var_Set(v->name, newStr, v_ctxt, 0);
2698 if ((v->flags & VAR_JUNK) == 0)
2702 Var_Set(v->name, pattern.rhs, v_ctxt, 0);
2706 free(UNCONST(pattern.rhs));
2707 newStr = varNoError;
2710 goto default_case; /* "::<unrecognised>" */
2715 int vflags = VAR_NOSUBST;
2719 if ((loop.tvar = VarGetPattern(ctxt, &parsestate, flags,
2721 &vflags, &loop.tvarLen,
2725 if ((loop.str = VarGetPattern(ctxt, &parsestate, flags,
2727 &vflags, &loop.strLen,
2734 loop.errnum = flags & VARF_UNDEFERR;
2736 newStr = VarModify(ctxt, &parsestate, nstr, VarLoopExpand,
2738 Var_Delete(loop.tvar, ctxt);
2743 case '_': /* remember current value */
2744 cp = tstr + 1; /* make sure it is set */
2745 if (STRMOD_MATCHX(tstr, "_", 1)) {
2746 if (tstr[1] == '=') {
2751 n = strcspn(cp, ":)}");
2752 np = bmake_strndup(cp, n+1);
2755 Var_Set(np, nstr, ctxt, 0);
2758 Var_Set("_", nstr, ctxt, 0);
2768 Buffer buf; /* Buffer for patterns */
2771 if (flags & VARF_WANTRES) {
2774 wantres = ((v->flags & VAR_JUNK) != 0);
2776 wantres = ((v->flags & VAR_JUNK) == 0);
2777 nflags = flags & ~VARF_WANTRES;
2779 nflags |= VARF_WANTRES;
2783 * Pass through tstr looking for 1) escaped delimiters,
2784 * '$'s and backslashes (place the escaped character in
2785 * uninterpreted) and 2) unescaped $'s that aren't before
2786 * the delimiter (expand the variable substitution).
2787 * The result is left in the Buffer buf.
2791 *cp != endc && *cp != ':' && *cp != '\0';
2793 if ((*cp == '\\') &&
2799 Buf_AddByte(&buf, cp[1]);
2801 } else if (*cp == '$') {
2803 * If unescaped dollar sign, assume it's a
2804 * variable substitution and recurse.
2810 cp2 = Var_Parse(cp, ctxt, nflags, &len, &freeIt);
2811 Buf_AddBytes(&buf, strlen(cp2), cp2);
2815 Buf_AddByte(&buf, *cp);
2821 if ((v->flags & VAR_JUNK) != 0)
2822 v->flags |= VAR_KEEP;
2823 if (nflags & VARF_WANTRES) {
2824 newStr = Buf_Destroy(&buf, FALSE);
2827 Buf_Destroy(&buf, TRUE);
2833 if ((v->flags & VAR_JUNK) != 0)
2834 v->flags |= VAR_KEEP;
2835 newStr = bmake_strdup(v->name);
2844 if ((v->flags & VAR_JUNK) != 0)
2845 v->flags |= VAR_KEEP;
2846 gn = Targ_FindNode(v->name, TARG_NOCREATE);
2847 if (gn == NULL || gn->type & OP_NOPATH) {
2849 } else if (gn->path) {
2850 newStr = bmake_strdup(gn->path);
2852 newStr = Dir_FindFile(v->name, Suff_FindPath(gn));
2855 newStr = bmake_strdup(v->name);
2870 if ((pattern.rhs = VarGetPattern(ctxt, &parsestate, flags,
2872 NULL, &pattern.rightLen,
2875 if (flags & VARF_WANTRES)
2876 newStr = Cmd_Exec(pattern.rhs, &emsg);
2878 newStr = varNoError;
2879 free(UNCONST(pattern.rhs));
2884 if (v->flags & VAR_JUNK) {
2885 v->flags |= VAR_KEEP;
2892 * Look for the closing ']', recursively
2893 * expanding any embedded variables.
2895 * estr is a pointer to the expanded result,
2896 * which we must free().
2900 cp = tstr+1; /* point to char after '[' */
2901 delim = ']'; /* look for closing ']' */
2902 estr = VarGetPattern(ctxt, &parsestate,
2906 goto cleanup; /* report missing ']' */
2907 /* now cp points just after the closing ']' */
2909 if (cp[0] != ':' && cp[0] != endc) {
2910 /* Found junk after ']' */
2914 if (estr[0] == '\0') {
2915 /* Found empty square brackets in ":[]". */
2918 } else if (estr[0] == '#' && estr[1] == '\0') {
2922 * We will need enough space for the decimal
2923 * representation of an int. We calculate the
2924 * space needed for the octal representation,
2925 * and add enough slop to cope with a '-' sign
2926 * (which should never be needed) and a '\0'
2927 * string terminator.
2930 (sizeof(int) * CHAR_BIT + 2) / 3 + 2;
2932 newStr = bmake_malloc(newStrSize);
2933 if (parsestate.oneBigWord) {
2934 strncpy(newStr, "1", newStrSize);
2936 /* XXX: brk_string() is a rather expensive
2937 * way of counting words. */
2942 av = brk_string(nstr, &ac, FALSE, &as);
2943 snprintf(newStr, newStrSize, "%d", ac);
2950 } else if (estr[0] == '*' && estr[1] == '\0') {
2952 parsestate.oneBigWord = TRUE;
2957 } else if (estr[0] == '@' && estr[1] == '\0') {
2959 parsestate.oneBigWord = FALSE;
2966 * We expect estr to contain a single
2967 * integer for :[N], or two integers
2968 * separated by ".." for :[start..end].
2970 VarSelectWords_t seldata = { 0, 0 };
2972 seldata.start = strtol(estr, &ep, 0);
2974 /* Found junk instead of a number */
2977 } else if (ep[0] == '\0') {
2978 /* Found only one integer in :[N] */
2979 seldata.end = seldata.start;
2980 } else if (ep[0] == '.' && ep[1] == '.' &&
2982 /* Expecting another integer after ".." */
2984 seldata.end = strtol(ep, &ep, 0);
2985 if (ep[0] != '\0') {
2986 /* Found junk after ".." */
2991 /* Found junk instead of ".." */
2996 * Now seldata is properly filled in,
2997 * but we still have to check for 0 as
3000 if (seldata.start == 0 && seldata.end == 0) {
3001 /* ":[0]" or perhaps ":[0..0]" */
3002 parsestate.oneBigWord = TRUE;
3007 } else if (seldata.start == 0 ||
3009 /* ":[0..N]" or ":[N..0]" */
3014 * Normal case: select the words
3015 * described by seldata.
3017 newStr = VarSelectWords(ctxt, &parsestate,
3027 cp = tstr + 1; /* make sure it is set */
3028 if (STRMOD_MATCHX(tstr, "gmtime", 6)) {
3029 if (tstr[6] == '=') {
3030 utc = strtoul(&tstr[7], &ep, 10);
3036 newStr = VarStrftime(nstr, 1, utc);
3043 cp = tstr + 1; /* make sure it is set */
3044 if (STRMOD_MATCH(tstr, "hash", 4)) {
3045 newStr = VarHash(nstr);
3053 cp = tstr + 1; /* make sure it is set */
3054 if (STRMOD_MATCHX(tstr, "localtime", 9)) {
3055 if (tstr[9] == '=') {
3056 utc = strtoul(&tstr[10], &ep, 10);
3062 newStr = VarStrftime(nstr, 0, utc);
3070 cp = tstr + 1; /* make sure it is set */
3071 if (tstr[1] != endc && tstr[1] != ':') {
3072 if (tstr[1] == 's') {
3074 * Use the char (if any) at tstr[2]
3075 * as the word separator.
3079 if (tstr[2] != endc &&
3080 (tstr[3] == endc || tstr[3] == ':')) {
3081 /* ":ts<unrecognised><endc>" or
3082 * ":ts<unrecognised>:" */
3083 parsestate.varSpace = tstr[2];
3085 } else if (tstr[2] == endc || tstr[2] == ':') {
3086 /* ":ts<endc>" or ":ts:" */
3087 parsestate.varSpace = 0; /* no separator */
3089 } else if (tstr[2] == '\\') {
3090 const char *xp = &tstr[3];
3091 int base = 8; /* assume octal */
3095 parsestate.varSpace = '\n';
3099 parsestate.varSpace = '\t';
3110 if (isdigit((unsigned char)tstr[3])) {
3113 parsestate.varSpace =
3114 strtoul(xp, &ep, base);
3115 if (*ep != ':' && *ep != endc)
3120 * ":ts<backslash><unrecognised>".
3128 * Found ":ts<unrecognised><unrecognised>".
3136 * We cannot be certain that VarModify
3137 * will be used - even if there is a
3138 * subsequent modifier, so do a no-op
3139 * VarSubstitute now to for str to be
3140 * re-expanded without the spaces.
3142 pattern.flags = VAR_SUB_ONE;
3143 pattern.lhs = pattern.rhs = "\032";
3144 pattern.leftLen = pattern.rightLen = 1;
3146 newStr = VarModify(ctxt, &parsestate, nstr,
3149 } else if (tstr[2] == endc || tstr[2] == ':') {
3151 * Check for two-character options:
3154 if (tstr[1] == 'A') { /* absolute path */
3155 newStr = VarModify(ctxt, &parsestate, nstr,
3159 } else if (tstr[1] == 'u') {
3160 char *dp = bmake_strdup(nstr);
3161 for (newStr = dp; *dp; dp++)
3162 *dp = toupper((unsigned char)*dp);
3165 } else if (tstr[1] == 'l') {
3166 char *dp = bmake_strdup(nstr);
3167 for (newStr = dp; *dp; dp++)
3168 *dp = tolower((unsigned char)*dp);
3171 } else if (tstr[1] == 'W' || tstr[1] == 'w') {
3172 parsestate.oneBigWord = (tstr[1] == 'W');
3177 /* Found ":t<unrecognised>:" or
3178 * ":t<unrecognised><endc>". */
3183 * Found ":t<unrecognised><unrecognised>".
3189 * Found ":t<endc>" or ":t:".
3199 const char *endpat; /* points just after end of pattern */
3201 Boolean copy; /* pattern should be, or has been, copied */
3209 * In the loop below, ignore ':' unless we are at
3210 * (or back to) the original brace level.
3211 * XXX This will likely not work right if $() and ${}
3215 *cp != '\0' && !(*cp == ':' && nest == 1);
3220 cp[1] == endc || cp[1] == startc)) {
3230 if (*cp == '(' || *cp == '{')
3232 if (*cp == ')' || *cp == '}') {
3242 * Need to compress the \:'s out of the pattern, so
3243 * allocate enough room to hold the uncompressed
3244 * pattern (note that cp started at tstr+1, so
3245 * cp - tstr takes the null byte into account) and
3246 * compress the pattern into the space.
3248 pattern = bmake_malloc(cp - tstr);
3249 for (cp2 = pattern, cp = tstr + 1;
3253 if ((*cp == '\\') && (cp+1 < endpat) &&
3254 (cp[1] == ':' || cp[1] == endc)) {
3263 * Either Var_Subst or VarModify will need a
3264 * nul-terminated string soon, so construct one now.
3266 pattern = bmake_strndup(tstr+1, endpat - (tstr + 1));
3270 * pattern contains embedded '$', so use Var_Subst to
3274 pattern = Var_Subst(NULL, cp2, ctxt, flags | VARF_WANTRES);
3278 fprintf(debug_file, "Pattern[%s] for [%s] is [%s]\n",
3279 v->name, nstr, pattern);
3281 newStr = VarModify(ctxt, &parsestate, nstr, VarMatch,
3284 newStr = VarModify(ctxt, &parsestate, nstr, VarNoMatch,
3293 Var_Parse_State tmpparsestate;
3296 tmpparsestate = parsestate;
3301 * If pattern begins with '^', it is anchored to the
3302 * start of the word -- skip over it and flag pattern.
3305 pattern.flags |= VAR_MATCH_START;
3310 if ((pattern.lhs = VarGetPattern(ctxt, &parsestate, flags,
3317 if ((pattern.rhs = VarGetPattern(ctxt, &parsestate, flags,
3324 * Check for global substitution. If 'g' after the final
3325 * delimiter, substitution is global and is marked that
3331 pattern.flags |= VAR_SUB_GLOBAL;
3334 pattern.flags |= VAR_SUB_ONE;
3337 tmpparsestate.oneBigWord = TRUE;
3344 newStr = VarModify(ctxt, &tmpparsestate, nstr,
3349 * Free the two strings.
3351 free(UNCONST(pattern.lhs));
3352 free(UNCONST(pattern.rhs));
3361 int lhs_flags, rhs_flags;
3363 /* find ':', and then substitute accordingly */
3364 if (flags & VARF_WANTRES) {
3365 cond_rc = Cond_EvalExpression(NULL, v->name, &value, 0, FALSE);
3366 if (cond_rc == COND_INVALID) {
3367 lhs_flags = rhs_flags = VAR_NOSUBST;
3370 rhs_flags = VAR_NOSUBST;
3372 lhs_flags = VAR_NOSUBST;
3376 /* we are just consuming and discarding */
3377 cond_rc = value = 0;
3378 lhs_flags = rhs_flags = VAR_NOSUBST;
3384 if ((pattern.lhs = VarGetPattern(ctxt, &parsestate, flags,
3385 &cp, delim, &lhs_flags,
3390 /* BROPEN or PROPEN */
3392 if ((pattern.rhs = VarGetPattern(ctxt, &parsestate, flags,
3393 &cp, delim, &rhs_flags,
3400 if (cond_rc == COND_INVALID) {
3401 Error("Bad conditional expression `%s' in %s?%s:%s",
3402 v->name, v->name, pattern.lhs, pattern.rhs);
3407 newStr = UNCONST(pattern.lhs);
3408 free(UNCONST(pattern.rhs));
3410 newStr = UNCONST(pattern.rhs);
3411 free(UNCONST(pattern.lhs));
3413 if (v->flags & VAR_JUNK) {
3414 v->flags |= VAR_KEEP;
3421 VarREPattern pattern;
3424 Var_Parse_State tmpparsestate;
3427 tmpparsestate = parsestate;
3433 if ((re = VarGetPattern(ctxt, &parsestate, flags, &cp, delim,
3434 NULL, NULL, NULL)) == NULL)
3437 if ((pattern.replace = VarGetPattern(ctxt, &parsestate,
3438 flags, &cp, delim, NULL,
3439 NULL, NULL)) == NULL){
3447 pattern.flags |= VAR_SUB_GLOBAL;
3450 pattern.flags |= VAR_SUB_ONE;
3453 tmpparsestate.oneBigWord = TRUE;
3461 error = regcomp(&pattern.re, re, REG_EXTENDED);
3464 *lengthPtr = cp - start + 1;
3465 VarREError(error, &pattern.re, "RE substitution error");
3466 free(pattern.replace);
3470 pattern.nsub = pattern.re.re_nsub + 1;
3471 if (pattern.nsub < 1)
3473 if (pattern.nsub > 10)
3475 pattern.matches = bmake_malloc(pattern.nsub *
3476 sizeof(regmatch_t));
3477 newStr = VarModify(ctxt, &tmpparsestate, nstr,
3480 regfree(&pattern.re);
3481 free(pattern.replace);
3482 free(pattern.matches);
3488 if (tstr[1] == endc || tstr[1] == ':') {
3489 newStr = VarQuote(nstr);
3496 if (tstr[1] == endc || tstr[1] == ':') {
3497 newStr = VarModify(ctxt, &parsestate, nstr, VarTail,
3505 if (tstr[1] == endc || tstr[1] == ':') {
3506 newStr = VarModify(ctxt, &parsestate, nstr, VarHead,
3514 if (tstr[1] == endc || tstr[1] == ':') {
3515 newStr = VarModify(ctxt, &parsestate, nstr, VarSuffix,
3523 if (tstr[1] == endc || tstr[1] == ':') {
3524 newStr = VarModify(ctxt, &parsestate, nstr, VarRoot,
3532 cp = tstr + 1; /* make sure it is set */
3533 if (STRMOD_MATCHX(tstr, "range", 5)) {
3536 if (tstr[5] == '=') {
3537 n = strtoul(&tstr[6], &ep, 10);
3543 newStr = VarRange(nstr, n);
3552 cp = tstr + 1; /* skip to the rest in any case */
3553 if (tstr[1] == endc || tstr[1] == ':') {
3556 } else if ( (tstr[1] == 'x') &&
3557 (tstr[2] == endc || tstr[2] == ':') ) {
3564 newStr = VarOrder(nstr, otype);
3568 if (tstr[1] == endc || tstr[1] == ':') {
3569 newStr = VarUniq(nstr);
3577 if (tstr[1] == 'h' && (tstr[2] == endc || tstr[2] == ':')) {
3579 if (flags & VARF_WANTRES) {
3580 newStr = Cmd_Exec(nstr, &emsg);
3584 newStr = varNoError;
3596 * This can either be a bogus modifier or a System-V
3597 * substitution command.
3605 * First we make a pass through the string trying
3606 * to verify it is a SYSV-make-style translation:
3607 * it must be: <string1>=<string2>)
3611 while (*cp != '\0' && cnt) {
3614 /* continue looking for endc */
3616 else if (*cp == endc)
3618 else if (*cp == startc)
3623 if (*cp == endc && eqFound) {
3626 * Now we break this sucker into the lhs and
3627 * rhs. We must null terminate them of course.
3631 if ((pattern.lhs = VarGetPattern(ctxt, &parsestate,
3632 flags, &cp, delim, &pattern.flags,
3633 &pattern.leftLen, NULL)) == NULL)
3636 if ((pattern.rhs = VarGetPattern(ctxt, &parsestate,
3637 flags, &cp, delim, NULL, &pattern.rightLen,
3642 * SYSV modifications happen through the whole
3643 * string. Note the pattern is anchored at the end.
3647 if (pattern.leftLen == 0 && *nstr == '\0') {
3648 newStr = nstr; /* special case */
3650 newStr = VarModify(ctxt, &parsestate, nstr,
3654 free(UNCONST(pattern.lhs));
3655 free(UNCONST(pattern.rhs));
3659 Error("Unknown modifier '%c'", *tstr);
3661 *cp != ':' && *cp != endc && *cp != '\0';
3670 fprintf(debug_file, "Result[%s] of :%c is \"%s\"\n",
3671 v->name, modifier, newStr);
3674 if (newStr != nstr) {
3680 if (nstr != var_Error && nstr != varNoError) {
3684 if (termc == '\0' && endc != '\0') {
3685 Error("Unclosed variable specification (expecting '%c') for \"%s\" (value \"%s\") modifier %c", endc, v->name, nstr, modifier);
3686 } else if (termc == ':') {
3692 *lengthPtr = tstr - start;
3697 Error("Bad modifier `:%.*s' for %s", (int)strcspn(tstr, ":)}"), tstr,
3701 *lengthPtr = cp - start;
3703 Error("Unclosed substitution for %s (%c missing)",
3711 *-----------------------------------------------------------------------
3713 * Given the start of a variable invocation, extract the variable
3714 * name and find its value, then modify it according to the
3718 * str The string to parse
3719 * ctxt The context for the variable
3720 * flags VARF_UNDEFERR if undefineds are an error
3721 * VARF_WANTRES if we actually want the result
3722 * VARF_ASSIGN if we are in a := assignment
3723 * lengthPtr OUT: The length of the specification
3724 * freePtr OUT: Non-NULL if caller should free *freePtr
3727 * The (possibly-modified) value of the variable or var_Error if the
3728 * specification is invalid. The length of the specification is
3729 * placed in *lengthPtr (for invalid specifications, this is just
3731 * If *freePtr is non-NULL then it's a pointer that the caller
3732 * should pass to free() to free memory used by the result.
3737 *-----------------------------------------------------------------------
3739 /* coverity[+alloc : arg-*4] */
3741 Var_Parse(const char *str, GNode *ctxt, int flags,
3742 int *lengthPtr, void **freePtr)
3744 const char *tstr; /* Pointer into str */
3745 Var *v; /* Variable in invocation */
3746 Boolean haveModifier;/* TRUE if have modifiers for the variable */
3747 char endc; /* Ending character when variable in parens
3749 char startc; /* Starting character when variable in parens
3751 int vlen; /* Length of variable name */
3752 const char *start; /* Points to original start of str */
3753 char *nstr; /* New string, used during expansion */
3754 Boolean dynamic; /* TRUE if the variable is local and we're
3755 * expanding it in a non-local context. This
3756 * is done to support dynamic sources. The
3757 * result is just the invocation, unaltered */
3758 const char *extramodifiers; /* extra modifiers to apply first */
3762 extramodifiers = NULL;
3767 if (startc != PROPEN && startc != BROPEN) {
3769 * If it's not bounded by braces of some sort, life is much simpler.
3770 * We just need to check for the first character and return the
3771 * value if it exists.
3774 /* Error out some really stupid names */
3775 if (startc == '\0' || strchr(")}:$", startc)) {
3782 v = VarFind(name, ctxt, FIND_ENV | FIND_GLOBAL | FIND_CMD);
3786 if ((ctxt == VAR_CMD) || (ctxt == VAR_GLOBAL)) {
3788 * If substituting a local variable in a non-local context,
3789 * assume it's for dynamic source stuff. We have to handle
3790 * this specially and return the longhand for the variable
3791 * with the dollar sign escaped so it makes it back to the
3792 * caller. Only four of the local variables are treated
3793 * specially as they are the only four that will be set
3794 * when dynamic sources are expanded.
3798 return UNCONST("$(.TARGET)");
3800 return UNCONST("$(.MEMBER)");
3802 return UNCONST("$(.PREFIX)");
3804 return UNCONST("$(.ARCHIVE)");
3810 return (flags & VARF_UNDEFERR) ? var_Error : varNoError;
3812 haveModifier = FALSE;
3817 Buffer buf; /* Holds the variable name */
3820 endc = startc == PROPEN ? PRCLOSE : BRCLOSE;
3824 * Skip to the end character or a colon, whichever comes first.
3826 for (tstr = str + 2; *tstr != '\0'; tstr++)
3829 * Track depth so we can spot parse errors.
3831 if (*tstr == startc) {
3834 if (*tstr == endc) {
3838 if (depth == 1 && *tstr == ':') {
3842 * A variable inside a variable, expand
3847 char *rval = Var_Parse(tstr, ctxt, flags, &rlen, &freeIt);
3849 Buf_AddBytes(&buf, strlen(rval), rval);
3855 Buf_AddByte(&buf, *tstr);
3858 haveModifier = TRUE;
3859 } else if (*tstr == endc) {
3860 haveModifier = FALSE;
3863 * If we never did find the end character, return NULL
3864 * right now, setting the length to be the distance to
3865 * the end of the string, since that's what make does.
3867 *lengthPtr = tstr - str;
3868 Buf_Destroy(&buf, TRUE);
3871 str = Buf_GetAll(&buf, &vlen);
3874 * At this point, str points into newly allocated memory from
3875 * buf, containing only the name of the variable.
3877 * start and tstr point into the const string that was pointed
3878 * to by the original value of the str parameter. start points
3879 * to the '$' at the beginning of the string, while tstr points
3880 * to the char just after the end of the variable name -- this
3881 * will be '\0', ':', PRCLOSE, or BRCLOSE.
3884 v = VarFind(str, ctxt, FIND_ENV | FIND_GLOBAL | FIND_CMD);
3886 * Check also for bogus D and F forms of local variables since we're
3887 * in a local context and the name is the right length.
3889 if ((v == NULL) && (ctxt != VAR_CMD) && (ctxt != VAR_GLOBAL) &&
3890 (vlen == 2) && (str[1] == 'F' || str[1] == 'D') &&
3891 strchr("@%?*!<>", str[0]) != NULL) {
3893 * Well, it's local -- go look for it.
3897 v = VarFind(name, ctxt, 0);
3900 if (str[1] == 'D') {
3901 extramodifiers = "H:";
3904 extramodifiers = "T:";
3911 (((vlen == 2) && (str[1] == 'F' || str[1] == 'D')))) &&
3912 ((ctxt == VAR_CMD) || (ctxt == VAR_GLOBAL)))
3915 * If substituting a local variable in a non-local context,
3916 * assume it's for dynamic source stuff. We have to handle
3917 * this specially and return the longhand for the variable
3918 * with the dollar sign escaped so it makes it back to the
3919 * caller. Only four of the local variables are treated
3920 * specially as they are the only four that will be set
3921 * when dynamic sources are expanded.
3931 } else if ((vlen > 2) && (*str == '.') &&
3932 isupper((unsigned char) str[1]) &&
3933 ((ctxt == VAR_CMD) || (ctxt == VAR_GLOBAL)))
3938 if ((strncmp(str, ".TARGET", len) == 0) ||
3939 (strncmp(str, ".ARCHIVE", len) == 0) ||
3940 (strncmp(str, ".PREFIX", len) == 0) ||
3941 (strncmp(str, ".MEMBER", len) == 0))
3947 if (!haveModifier) {
3949 * No modifiers -- have specification length so we can return
3952 *lengthPtr = tstr - start + 1;
3954 char *pstr = bmake_strndup(start, *lengthPtr);
3956 Buf_Destroy(&buf, TRUE);
3959 Buf_Destroy(&buf, TRUE);
3960 return (flags & VARF_UNDEFERR) ? var_Error : varNoError;
3964 * Still need to get to the end of the variable specification,
3965 * so kludge up a Var structure for the modifications
3967 v = bmake_malloc(sizeof(Var));
3968 v->name = UNCONST(str);
3969 Buf_Init(&v->val, 1);
3970 v->flags = VAR_JUNK;
3971 Buf_Destroy(&buf, FALSE);
3974 Buf_Destroy(&buf, TRUE);
3977 if (v->flags & VAR_IN_USE) {
3978 Fatal("Variable %s is recursive.", v->name);
3981 v->flags |= VAR_IN_USE;
3984 * Before doing any modification, we have to make sure the value
3985 * has been fully expanded. If it looks like recursion might be
3986 * necessary (there's a dollar sign somewhere in the variable's value)
3987 * we just call Var_Subst to do any other substitutions that are
3988 * necessary. Note that the value returned by Var_Subst will have
3989 * been dynamically-allocated, so it will need freeing when we
3992 nstr = Buf_GetAll(&v->val, NULL);
3993 if (strchr(nstr, '$') != NULL) {
3994 nstr = Var_Subst(NULL, nstr, ctxt, flags);
3998 v->flags &= ~VAR_IN_USE;
4000 if ((nstr != NULL) && (haveModifier || extramodifiers != NULL)) {
4005 if (extramodifiers != NULL) {
4006 nstr = ApplyModifiers(nstr, extramodifiers, '(', ')',
4007 v, ctxt, flags, &used, &extraFree);
4011 /* Skip initial colon. */
4014 nstr = ApplyModifiers(nstr, tstr, startc, endc,
4015 v, ctxt, flags, &used, freePtr);
4019 *freePtr = extraFree;
4023 *lengthPtr = tstr - start + 1;
4025 *lengthPtr = tstr - start;
4028 if (v->flags & VAR_FROM_ENV) {
4029 Boolean destroy = FALSE;
4031 if (nstr != Buf_GetAll(&v->val, NULL)) {
4035 * Returning the value unmodified, so tell the caller to free
4040 VarFreeEnv(v, destroy);
4041 } else if (v->flags & VAR_JUNK) {
4043 * Perform any free'ing needed and set *freePtr to NULL so the caller
4044 * doesn't try to free a static pointer.
4045 * If VAR_KEEP is also set then we want to keep str as is.
4047 if (!(v->flags & VAR_KEEP)) {
4053 nstr = bmake_strndup(start, *lengthPtr);
4056 nstr = (flags & VARF_UNDEFERR) ? var_Error : varNoError;
4059 if (nstr != Buf_GetAll(&v->val, NULL))
4060 Buf_Destroy(&v->val, TRUE);
4068 *-----------------------------------------------------------------------
4070 * Substitute for all variables in the given string in the given context
4071 * If flags & VARF_UNDEFERR, Parse_Error will be called when an undefined
4072 * variable is encountered.
4075 * var Named variable || NULL for all
4076 * str the string which to substitute
4077 * ctxt the context wherein to find variables
4078 * flags VARF_UNDEFERR if undefineds are an error
4079 * VARF_WANTRES if we actually want the result
4080 * VARF_ASSIGN if we are in a := assignment
4083 * The resulting string.
4086 * None. The old string must be freed by the caller
4087 *-----------------------------------------------------------------------
4090 Var_Subst(const char *var, const char *str, GNode *ctxt, int flags)
4092 Buffer buf; /* Buffer for forming things */
4093 char *val; /* Value to substitute for a variable */
4094 int length; /* Length of the variable invocation */
4095 Boolean trailingBslash; /* variable ends in \ */
4096 void *freeIt = NULL; /* Set if it should be freed */
4097 static Boolean errorReported; /* Set true if an error has already
4098 * been reported to prevent a plethora
4099 * of messages when recursing */
4102 errorReported = FALSE;
4103 trailingBslash = FALSE;
4106 if (*str == '\n' && trailingBslash)
4107 Buf_AddByte(&buf, ' ');
4108 if (var == NULL && (*str == '$') && (str[1] == '$')) {
4110 * A dollar sign may be escaped either with another dollar sign.
4111 * In such a case, we skip over the escape character and store the
4112 * dollar sign into the buffer directly.
4114 if (save_dollars && (flags & VARF_ASSIGN))
4115 Buf_AddByte(&buf, *str);
4117 Buf_AddByte(&buf, *str);
4119 } else if (*str != '$') {
4121 * Skip as many characters as possible -- either to the end of
4122 * the string or to the next dollar sign (variable invocation).
4126 for (cp = str++; *str != '$' && *str != '\0'; str++)
4128 Buf_AddBytes(&buf, str - cp, cp);
4133 if (str[1] == '\0') {
4134 /* A trailing $ is kind of a special case */
4135 Buf_AddByte(&buf, str[0]);
4138 } else if (str[1] != PROPEN && str[1] != BROPEN) {
4139 if (str[1] != *var || strlen(var) > 1) {
4140 Buf_AddBytes(&buf, 2, str);
4152 * Scan up to the end of the variable name.
4154 for (p = &str[2]; *p &&
4155 *p != ':' && *p != PRCLOSE && *p != BRCLOSE; p++)
4159 * A variable inside the variable. We cannot expand
4160 * the external variable yet, so we try again with
4164 Buf_AddBytes(&buf, p - str, str);
4169 if (strncmp(var, str + 2, p - str - 2) != 0 ||
4170 var[p - str - 2] != '\0') {
4172 * Not the variable we want to expand, scan
4173 * until the next variable
4175 for (;*p != '$' && *p != '\0'; p++)
4177 Buf_AddBytes(&buf, p - str, str);
4190 val = Var_Parse(str, ctxt, flags, &length, &freeIt);
4193 * When we come down here, val should either point to the
4194 * value of this variable, suitably modified, or be NULL.
4195 * Length should be the total length of the potential
4196 * variable invocation (from $ to end character...)
4198 if (val == var_Error || val == varNoError) {
4200 * If performing old-time variable substitution, skip over
4201 * the variable and continue with the substitution. Otherwise,
4202 * store the dollar sign and advance str so we continue with
4207 } else if ((flags & VARF_UNDEFERR) || val == var_Error) {
4209 * If variable is undefined, complain and skip the
4210 * variable. The complaint will stop us from doing anything
4211 * when the file is parsed.
4213 if (!errorReported) {
4214 Parse_Error(PARSE_FATAL,
4215 "Undefined variable \"%.*s\"",length,str);
4218 errorReported = TRUE;
4220 Buf_AddByte(&buf, *str);
4225 * We've now got a variable structure to store in. But first,
4226 * advance the string pointer.
4231 * Copy all the characters from the variable value straight
4232 * into the new string.
4234 length = strlen(val);
4235 Buf_AddBytes(&buf, length, val);
4236 trailingBslash = length > 0 && val[length - 1] == '\\';
4243 return Buf_DestroyCompact(&buf);
4247 *-----------------------------------------------------------------------
4249 * Return the tail from each of a list of words. Used to set the
4250 * System V local variables.
4253 * file Filename to modify
4256 * The resulting string.
4261 *-----------------------------------------------------------------------
4265 Var_GetTail(char *file)
4267 return(VarModify(file, VarTail, NULL));
4271 *-----------------------------------------------------------------------
4273 * Find the leading components of a (list of) filename(s).
4274 * XXX: VarHead does not replace foo by ., as (sun) System V make
4278 * file Filename to manipulate
4281 * The leading components.
4286 *-----------------------------------------------------------------------
4289 Var_GetHead(char *file)
4291 return(VarModify(file, VarHead, NULL));
4296 *-----------------------------------------------------------------------
4298 * Initialize the module
4304 * The VAR_CMD and VAR_GLOBAL contexts are created
4305 *-----------------------------------------------------------------------
4310 VAR_INTERNAL = Targ_NewGN("Internal");
4311 VAR_GLOBAL = Targ_NewGN("Global");
4312 VAR_CMD = Targ_NewGN("Command");
4323 /****************** PRINT DEBUGGING INFO *****************/
4325 VarPrintVar(void *vp)
4328 fprintf(debug_file, "%-16s = %s\n", v->name, Buf_GetAll(&v->val, NULL));
4332 *-----------------------------------------------------------------------
4334 * print all variables in a context
4335 *-----------------------------------------------------------------------
4338 Var_Dump(GNode *ctxt)
4343 for (h = Hash_EnumFirst(&ctxt->context, &search);
4345 h = Hash_EnumNext(&search)) {
4346 VarPrintVar(Hash_GetValue(h));