cond.c revision 1.306 1 /* $NetBSD: cond.c,v 1.306 2021/12/15 12:58:01 rillig Exp $ */
2
3 /*
4 * Copyright (c) 1988, 1989, 1990 The Regents of the University of California.
5 * All rights reserved.
6 *
7 * This code is derived from software contributed to Berkeley by
8 * Adam de Boor.
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
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.
21 *
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
32 * SUCH DAMAGE.
33 */
34
35 /*
36 * Copyright (c) 1988, 1989 by Adam de Boor
37 * Copyright (c) 1989 by Berkeley Softworks
38 * All rights reserved.
39 *
40 * This code is derived from software contributed to Berkeley by
41 * Adam de Boor.
42 *
43 * Redistribution and use in source and binary forms, with or without
44 * modification, are permitted provided that the following conditions
45 * are met:
46 * 1. Redistributions of source code must retain the above copyright
47 * notice, this list of conditions and the following disclaimer.
48 * 2. Redistributions in binary form must reproduce the above copyright
49 * notice, this list of conditions and the following disclaimer in the
50 * documentation and/or other materials provided with the distribution.
51 * 3. All advertising materials mentioning features or use of this software
52 * must display the following acknowledgement:
53 * This product includes software developed by the University of
54 * California, Berkeley and its contributors.
55 * 4. Neither the name of the University nor the names of its contributors
56 * may be used to endorse or promote products derived from this software
57 * without specific prior written permission.
58 *
59 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
60 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
61 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
62 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
63 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
64 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
65 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
66 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
67 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
68 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
69 * SUCH DAMAGE.
70 */
71
72 /*
73 * Handling of conditionals in a makefile.
74 *
75 * Interface:
76 * Cond_EvalLine Evaluate the conditional directive, such as
77 * '.if <cond>', '.elifnmake <cond>', '.else', '.endif'.
78 *
79 * Cond_EvalCondition
80 * Evaluate the conditional, which is either the argument
81 * of one of the .if directives or the condition in a
82 * ':?then:else' variable modifier.
83 *
84 * Cond_save_depth
85 * Cond_restore_depth
86 * Save and restore the nesting of the conditions, at
87 * the start and end of including another makefile, to
88 * ensure that in each makefile the conditional
89 * directives are well-balanced.
90 */
91
92 #include <errno.h>
93
94 #include "make.h"
95 #include "dir.h"
96
97 /* "@(#)cond.c 8.2 (Berkeley) 1/2/94" */
98 MAKE_RCSID("$NetBSD: cond.c,v 1.306 2021/12/15 12:58:01 rillig Exp $");
99
100 /*
101 * The parsing of conditional expressions is based on this grammar:
102 * Or -> And ('||' And)*
103 * And -> Term ('&&' Term)*
104 * Term -> Function '(' Argument ')'
105 * Term -> Leaf Operator Leaf
106 * Term -> Leaf
107 * Term -> '(' Or ')'
108 * Term -> '!' Term
109 * Leaf -> "string"
110 * Leaf -> Number
111 * Leaf -> VariableExpression
112 * Leaf -> Symbol
113 * Operator -> '==' | '!=' | '>' | '<' | '>=' | '<='
114 *
115 * 'Symbol' is an unquoted string literal to which the default function is
116 * applied.
117 *
118 * The tokens are scanned by CondToken, which returns:
119 * TOK_AND for '&&'
120 * TOK_OR for '||'
121 * TOK_NOT for '!'
122 * TOK_LPAREN for '('
123 * TOK_RPAREN for ')'
124 *
125 * Other terminal symbols are evaluated using either the default function or
126 * the function given in the terminal, they return either TOK_TRUE or
127 * TOK_FALSE.
128 */
129 typedef enum Token {
130 TOK_FALSE, TOK_TRUE, TOK_AND, TOK_OR, TOK_NOT,
131 TOK_LPAREN, TOK_RPAREN, TOK_EOF, TOK_NONE, TOK_ERROR
132 } Token;
133
134 typedef enum CondResult {
135 CR_FALSE, CR_TRUE, CR_ERROR
136 } CondResult;
137
138 typedef enum ComparisonOp {
139 LT, LE, GT, GE, EQ, NE
140 } ComparisonOp;
141
142 typedef struct CondParser {
143
144 /*
145 * The plain '.if ${VAR}' evaluates to true if the value of the
146 * expression has length > 0. The other '.if' variants delegate
147 * to evalBare instead.
148 */
149 bool plain;
150
151 /* The function to apply on unquoted bare words. */
152 bool (*evalBare)(const char *);
153 bool negateEvalBare;
154
155 /*
156 * Whether the left-hand side of a comparison may be an unquoted
157 * string. This is allowed for expressions of the form
158 * ${condition:?:}, see ApplyModifier_IfElse. Such a condition is
159 * expanded before it is evaluated, due to ease of implementation.
160 * This means that at the point where the condition is evaluated,
161 * make cannot know anymore whether the left-hand side had originally
162 * been a variable expression or a plain word.
163 *
164 * In all other contexts, the left-hand side must either be a
165 * variable expression, a quoted string or a number.
166 */
167 bool leftUnquotedOK;
168
169 const char *p; /* The remaining condition to parse */
170 Token curr; /* Single push-back token used in parsing */
171
172 /*
173 * Whether an error message has already been printed for this
174 * condition. The first available error message is usually the most
175 * specific one, therefore it makes sense to suppress the standard
176 * "Malformed conditional" message.
177 */
178 bool printedError;
179 } CondParser;
180
181 static CondResult CondParser_Or(CondParser *par, bool);
182
183 static unsigned int cond_depth = 0; /* current .if nesting level */
184 static unsigned int cond_min_depth = 0; /* depth at makefile open */
185
186 /* Names for ComparisonOp. */
187 static const char opname[][3] = { "<", "<=", ">", ">=", "==", "!=" };
188
189 static bool
190 is_token(const char *str, const char *tok, unsigned char len)
191 {
192 return strncmp(str, tok, (size_t)len) == 0 && !ch_isalpha(str[len]);
193 }
194
195 static Token
196 ToToken(bool cond)
197 {
198 return cond ? TOK_TRUE : TOK_FALSE;
199 }
200
201 static void
202 CondParser_SkipWhitespace(CondParser *par)
203 {
204 cpp_skip_whitespace(&par->p);
205 }
206
207 /*
208 * Parse a single word, taking into account balanced parentheses as well as
209 * embedded expressions. Used for the argument of a built-in function as
210 * well as for bare words, which are then passed to the default function.
211 *
212 * Arguments:
213 * *pp initially points at the '(',
214 * upon successful return it points right after the ')'.
215 *
216 * *out_arg receives the argument as string.
217 *
218 * func says whether the argument belongs to an actual function, or
219 * NULL when parsing a bare word.
220 *
221 * Return the length of the argument, or an ambiguous 0 on error.
222 */
223 static size_t
224 ParseWord(CondParser *par, const char **pp, bool doEval, const char *func,
225 char **out_arg)
226 {
227 const char *p = *pp;
228 Buffer argBuf;
229 int paren_depth;
230 size_t argLen;
231
232 if (func != NULL)
233 p++; /* Skip opening '(' - verified by caller */
234
235 cpp_skip_hspace(&p);
236
237 Buf_InitSize(&argBuf, 16);
238
239 paren_depth = 0;
240 for (;;) {
241 char ch = *p;
242 if (ch == '\0' || ch == ' ' || ch == '\t')
243 break;
244 if ((ch == '&' || ch == '|') && paren_depth == 0)
245 break;
246 if (*p == '$') {
247 /*
248 * Parse the variable expression and install it as
249 * part of the argument if it's valid. We tell
250 * Var_Parse to complain on an undefined variable,
251 * (XXX: but Var_Parse ignores that request)
252 * so we don't need to do it. Nor do we return an
253 * error, though perhaps we should.
254 */
255 VarEvalMode emode = doEval
256 ? VARE_UNDEFERR
257 : VARE_PARSE_ONLY;
258 FStr nestedVal;
259 (void)Var_Parse(&p, SCOPE_CMDLINE, emode, &nestedVal);
260 /* TODO: handle errors */
261 Buf_AddStr(&argBuf, nestedVal.str);
262 FStr_Done(&nestedVal);
263 continue;
264 }
265 if (ch == '(')
266 paren_depth++;
267 else if (ch == ')' && --paren_depth < 0)
268 break;
269 Buf_AddByte(&argBuf, *p);
270 p++;
271 }
272
273 argLen = argBuf.len;
274 *out_arg = Buf_DoneData(&argBuf);
275
276 cpp_skip_hspace(&p);
277
278 if (func != NULL && *p++ != ')') {
279 Parse_Error(PARSE_FATAL,
280 "Missing closing parenthesis for %s()", func);
281 par->printedError = true;
282 return 0;
283 }
284
285 *pp = p;
286 return argLen;
287 }
288
289 /* Test whether the given variable is defined. */
290 static bool
291 FuncDefined(const char *arg)
292 {
293 FStr value = Var_Value(SCOPE_CMDLINE, arg);
294 bool result = value.str != NULL;
295 FStr_Done(&value);
296 return result;
297 }
298
299 /* See if the given target is requested to be made. */
300 static bool
301 FuncMake(const char *arg)
302 {
303 StringListNode *ln;
304
305 for (ln = opts.create.first; ln != NULL; ln = ln->next)
306 if (Str_Match(ln->datum, arg))
307 return true;
308 return false;
309 }
310
311 /* See if the given file exists. */
312 static bool
313 FuncExists(const char *arg)
314 {
315 bool result;
316 char *path;
317
318 path = Dir_FindFile(arg, &dirSearchPath);
319 DEBUG2(COND, "exists(%s) result is \"%s\"\n",
320 arg, path != NULL ? path : "");
321 result = path != NULL;
322 free(path);
323 return result;
324 }
325
326 /* See if the given node exists and is an actual target. */
327 static bool
328 FuncTarget(const char *arg)
329 {
330 GNode *gn = Targ_FindNode(arg);
331 return gn != NULL && GNode_IsTarget(gn);
332 }
333
334 /*
335 * See if the given node exists and is an actual target with commands
336 * associated with it.
337 */
338 static bool
339 FuncCommands(const char *arg)
340 {
341 GNode *gn = Targ_FindNode(arg);
342 return gn != NULL && GNode_IsTarget(gn) && !Lst_IsEmpty(&gn->commands);
343 }
344
345 /*
346 * Convert the given number into a double.
347 * We try a base 10 or 16 integer conversion first, if that fails
348 * then we try a floating point conversion instead.
349 *
350 * Results:
351 * Returns true if the conversion succeeded.
352 * Sets 'out_value' to the converted number.
353 */
354 static bool
355 TryParseNumber(const char *str, double *out_value)
356 {
357 char *end;
358 unsigned long ul_val;
359 double dbl_val;
360
361 if (str[0] == '\0') { /* XXX: why is an empty string a number? */
362 *out_value = 0.0;
363 return true;
364 }
365
366 errno = 0;
367 ul_val = strtoul(str, &end, str[1] == 'x' ? 16 : 10);
368 if (*end == '\0' && errno != ERANGE) {
369 *out_value = str[0] == '-' ? -(double)-ul_val : (double)ul_val;
370 return true;
371 }
372
373 if (*end != '\0' && *end != '.' && *end != 'e' && *end != 'E')
374 return false; /* skip the expensive strtod call */
375 dbl_val = strtod(str, &end);
376 if (*end != '\0')
377 return false;
378
379 *out_value = dbl_val;
380 return true;
381 }
382
383 static bool
384 is_separator(char ch)
385 {
386 return ch == '\0' || ch_isspace(ch) || ch == '!' || ch == '=' ||
387 ch == '>' || ch == '<' || ch == ')' /* but not '(' */;
388 }
389
390 /*
391 * In a quoted or unquoted string literal or a number, parse a variable
392 * expression.
393 *
394 * Example: .if x${CENTER}y == "${PREFIX}${SUFFIX}" || 0x${HEX}
395 */
396 static bool
397 CondParser_StringExpr(CondParser *par, const char *start,
398 bool doEval, bool quoted,
399 Buffer *buf, FStr *inout_str)
400 {
401 VarEvalMode emode;
402 const char *nested_p;
403 bool atStart;
404 VarParseResult parseResult;
405
406 emode = doEval && quoted ? VARE_WANTRES
407 : doEval ? VARE_UNDEFERR
408 : VARE_PARSE_ONLY;
409
410 nested_p = par->p;
411 atStart = nested_p == start;
412 parseResult = Var_Parse(&nested_p, SCOPE_CMDLINE, emode, inout_str);
413 /* TODO: handle errors */
414 if (inout_str->str == var_Error) {
415 if (parseResult == VPR_ERR) {
416 /*
417 * FIXME: Even if an error occurs, there is no
418 * guarantee that it is reported.
419 *
420 * See cond-token-plain.mk $$$$$$$$.
421 */
422 par->printedError = true;
423 }
424 /*
425 * XXX: Can there be any situation in which a returned
426 * var_Error needs to be freed?
427 */
428 FStr_Done(inout_str);
429 /*
430 * Even if !doEval, we still report syntax errors, which is
431 * what getting var_Error back with !doEval means.
432 */
433 *inout_str = FStr_InitRefer(NULL);
434 return false;
435 }
436 par->p = nested_p;
437
438 /*
439 * If the '$' started the string literal (which means no quotes), and
440 * the variable expression is followed by a space, looks like a
441 * comparison operator or is the end of the expression, we are done.
442 */
443 if (atStart && is_separator(par->p[0]))
444 return false;
445
446 Buf_AddStr(buf, inout_str->str);
447 FStr_Done(inout_str);
448 *inout_str = FStr_InitRefer(NULL); /* not finished yet */
449 return true;
450 }
451
452 /*
453 * Parse a string from a variable expression or an optionally quoted
454 * string. This is called for the left-hand and right-hand sides of
455 * comparisons.
456 *
457 * Results:
458 * Returns the string, absent any quotes, or NULL on error.
459 * Sets out_quoted if the leaf was a quoted string literal.
460 */
461 static void
462 CondParser_Leaf(CondParser *par, bool doEval, bool unquotedOK,
463 FStr *out_str, bool *out_quoted)
464 {
465 Buffer buf;
466 FStr str;
467 bool quoted;
468 const char *start;
469
470 Buf_Init(&buf);
471 str = FStr_InitRefer(NULL);
472 *out_quoted = quoted = par->p[0] == '"';
473 start = par->p;
474 if (quoted)
475 par->p++;
476
477 while (par->p[0] != '\0' && str.str == NULL) {
478 switch (par->p[0]) {
479 case '\\':
480 par->p++;
481 if (par->p[0] != '\0') {
482 Buf_AddByte(&buf, par->p[0]);
483 par->p++;
484 }
485 continue;
486 case '"':
487 par->p++;
488 if (quoted)
489 goto got_str; /* skip the closing quote */
490 Buf_AddByte(&buf, '"');
491 continue;
492 case ')': /* see is_separator */
493 case '!':
494 case '=':
495 case '>':
496 case '<':
497 case ' ':
498 case '\t':
499 if (!quoted)
500 goto got_str;
501 Buf_AddByte(&buf, par->p[0]);
502 par->p++;
503 continue;
504 case '$':
505 if (!CondParser_StringExpr(par,
506 start, doEval, quoted, &buf, &str))
507 goto cleanup;
508 continue;
509 default:
510 if (!unquotedOK && !quoted && *start != '$' &&
511 !ch_isdigit(*start)) {
512 /*
513 * The left-hand side must be quoted,
514 * a variable expression or a number.
515 */
516 str = FStr_InitRefer(NULL);
517 goto cleanup;
518 }
519 Buf_AddByte(&buf, par->p[0]);
520 par->p++;
521 continue;
522 }
523 }
524 got_str:
525 str = FStr_InitOwn(buf.data);
526 buf.data = NULL;
527 cleanup:
528 Buf_Done(&buf);
529 *out_str = str;
530 }
531
532 static bool
533 EvalBare(const CondParser *par, const char *arg)
534 {
535 bool res = par->evalBare(arg);
536 return par->negateEvalBare ? !res : res;
537 }
538
539 /*
540 * Evaluate a "comparison without operator", such as in ".if ${VAR}" or
541 * ".if 0".
542 */
543 static bool
544 EvalNotEmpty(CondParser *par, const char *value, bool quoted)
545 {
546 double num;
547
548 /* For .ifxxx "...", check for non-empty string. */
549 if (quoted)
550 return value[0] != '\0';
551
552 /* For .ifxxx <number>, compare against zero */
553 if (TryParseNumber(value, &num))
554 return num != 0.0;
555
556 /*
557 * For .if ${...}, check for non-empty string. This is different
558 * from the evaluation function from that .if variant, which would
559 * test whether a variable of the given name were defined.
560 */
561 /*
562 * XXX: Whitespace should count as empty, just as in
563 * CondParser_FuncCallEmpty.
564 */
565 if (par->plain)
566 return value[0] != '\0';
567
568 return EvalBare(par, value);
569 }
570
571 /* Evaluate a numerical comparison, such as in ".if ${VAR} >= 9". */
572 static bool
573 EvalCompareNum(double lhs, ComparisonOp op, double rhs)
574 {
575 DEBUG3(COND, "lhs = %f, rhs = %f, op = %.2s\n", lhs, rhs, opname[op]);
576
577 switch (op) {
578 case LT:
579 return lhs < rhs;
580 case LE:
581 return lhs <= rhs;
582 case GT:
583 return lhs > rhs;
584 case GE:
585 return lhs >= rhs;
586 case NE:
587 return lhs != rhs;
588 default:
589 return lhs == rhs;
590 }
591 }
592
593 static Token
594 EvalCompareStr(CondParser *par, const char *lhs,
595 ComparisonOp op, const char *rhs)
596 {
597 if (op != EQ && op != NE) {
598 Parse_Error(PARSE_FATAL,
599 "String comparison operator must be either == or !=");
600 par->printedError = true;
601 return TOK_ERROR;
602 }
603
604 DEBUG3(COND, "lhs = \"%s\", rhs = \"%s\", op = %.2s\n",
605 lhs, rhs, opname[op]);
606 return ToToken((op == EQ) == (strcmp(lhs, rhs) == 0));
607 }
608
609 /* Evaluate a comparison, such as "${VAR} == 12345". */
610 static Token
611 EvalCompare(CondParser *par, const char *lhs, bool lhsQuoted,
612 ComparisonOp op, const char *rhs, bool rhsQuoted)
613 {
614 double left, right;
615
616 if (!rhsQuoted && !lhsQuoted)
617 if (TryParseNumber(lhs, &left) && TryParseNumber(rhs, &right))
618 return ToToken(EvalCompareNum(left, op, right));
619
620 return EvalCompareStr(par, lhs, op, rhs);
621 }
622
623 static bool
624 CondParser_ComparisonOp(CondParser *par, ComparisonOp *out_op)
625 {
626 const char *p = par->p;
627
628 if (p[0] == '<' && p[1] == '=')
629 return par->p += 2, *out_op = LE, true;
630 if (p[0] == '<')
631 return par->p += 1, *out_op = LT, true;
632 if (p[0] == '>' && p[1] == '=')
633 return par->p += 2, *out_op = GE, true;
634 if (p[0] == '>')
635 return par->p += 1, *out_op = GT, true;
636 if (p[0] == '=' && p[1] == '=')
637 return par->p += 2, *out_op = EQ, true;
638 if (p[0] == '!' && p[1] == '=')
639 return par->p += 2, *out_op = NE, true;
640 return false;
641 }
642
643 /*
644 * Parse a comparison condition such as:
645 *
646 * 0
647 * ${VAR:Mpattern}
648 * ${VAR} == value
649 * ${VAR:U0} < 12345
650 */
651 static Token
652 CondParser_Comparison(CondParser *par, bool doEval)
653 {
654 Token t = TOK_ERROR;
655 FStr lhs, rhs;
656 ComparisonOp op;
657 bool lhsQuoted, rhsQuoted;
658
659 CondParser_Leaf(par, doEval, par->leftUnquotedOK, &lhs, &lhsQuoted);
660 if (lhs.str == NULL)
661 goto done_lhs;
662
663 CondParser_SkipWhitespace(par);
664
665 if (!CondParser_ComparisonOp(par, &op)) {
666 /* Unknown operator, compare against an empty string or 0. */
667 t = ToToken(doEval && EvalNotEmpty(par, lhs.str, lhsQuoted));
668 goto done_lhs;
669 }
670
671 CondParser_SkipWhitespace(par);
672
673 if (par->p[0] == '\0') {
674 Parse_Error(PARSE_FATAL,
675 "Missing right-hand side of operator '%s'", opname[op]);
676 par->printedError = true;
677 goto done_lhs;
678 }
679
680 CondParser_Leaf(par, doEval, true, &rhs, &rhsQuoted);
681 if (rhs.str == NULL)
682 goto done_rhs;
683
684 if (!doEval) {
685 t = TOK_FALSE;
686 goto done_rhs;
687 }
688
689 t = EvalCompare(par, lhs.str, lhsQuoted, op, rhs.str, rhsQuoted);
690
691 done_rhs:
692 FStr_Done(&rhs);
693 done_lhs:
694 FStr_Done(&lhs);
695 return t;
696 }
697
698 /*
699 * The argument to empty() is a variable name, optionally followed by
700 * variable modifiers.
701 */
702 static bool
703 CondParser_FuncCallEmpty(CondParser *par, bool doEval, Token *out_token)
704 {
705 const char *cp = par->p;
706 Token tok;
707 FStr val;
708
709 if (!is_token(cp, "empty", 5))
710 return false;
711 cp += 5;
712
713 cpp_skip_whitespace(&cp);
714 if (*cp != '(')
715 return false;
716
717 cp--; /* Make cp[1] point to the '('. */
718 (void)Var_Parse(&cp, SCOPE_CMDLINE,
719 doEval ? VARE_WANTRES : VARE_PARSE_ONLY, &val);
720 /* TODO: handle errors */
721
722 if (val.str == var_Error)
723 tok = TOK_ERROR;
724 else {
725 cpp_skip_whitespace(&val.str);
726 tok = val.str[0] != '\0' && doEval ? TOK_FALSE : TOK_TRUE;
727 }
728
729 FStr_Done(&val);
730 *out_token = tok;
731 par->p = cp;
732 return true;
733 }
734
735 /* Parse a function call expression, such as 'defined(${file})'. */
736 static bool
737 CondParser_FuncCall(CondParser *par, bool doEval, Token *out_token)
738 {
739 static const struct fn_def {
740 const char fn_name[9];
741 unsigned char fn_name_len;
742 bool (*fn_eval)(const char *);
743 } fns[] = {
744 { "defined", 7, FuncDefined },
745 { "make", 4, FuncMake },
746 { "exists", 6, FuncExists },
747 { "target", 6, FuncTarget },
748 { "commands", 8, FuncCommands }
749 };
750 const struct fn_def *fn;
751 char *arg = NULL;
752 size_t arglen;
753 const char *cp = par->p;
754 const struct fn_def *last_fn = fns + sizeof fns / sizeof fns[0] - 1;
755
756 for (fn = fns; !is_token(cp, fn->fn_name, fn->fn_name_len); fn++)
757 if (fn == last_fn)
758 return false;
759
760 cp += fn->fn_name_len;
761 cpp_skip_whitespace(&cp);
762 if (*cp != '(')
763 return false;
764
765 arglen = ParseWord(par, &cp, doEval, fn->fn_name, &arg);
766 *out_token = ToToken(arglen != 0 && (!doEval || fn->fn_eval(arg)));
767
768 free(arg);
769 par->p = cp;
770 return true;
771 }
772
773 /*
774 * Parse a comparison that neither starts with '"' nor '$', such as the
775 * unusual 'bare == right' or '3 == ${VAR}', or a simple leaf without
776 * operator, which is a number, a variable expression or a string literal.
777 *
778 * TODO: Can this be merged into CondParser_Comparison?
779 */
780 static Token
781 CondParser_ComparisonOrLeaf(CondParser *par, bool doEval)
782 {
783 Token t;
784 char *arg = NULL;
785 const char *cp;
786 const char *cp1;
787
788 /* Push anything numeric through the compare expression */
789 cp = par->p;
790 if (ch_isdigit(cp[0]) || cp[0] == '-' || cp[0] == '+')
791 return CondParser_Comparison(par, doEval);
792
793 /*
794 * Most likely we have a naked token to apply the default function to.
795 * However ".if a == b" gets here when the "a" is unquoted and doesn't
796 * start with a '$'. This surprises people.
797 * If what follows the function argument is a '=' or '!' then the
798 * syntax would be invalid if we did "defined(a)" - so instead treat
799 * as an expression.
800 */
801 /*
802 * XXX: Is it possible to have a variable expression evaluated twice
803 * at this point?
804 */
805 (void)ParseWord(par, &cp, doEval, NULL, &arg);
806 cp1 = cp;
807 cpp_skip_whitespace(&cp1);
808 if (*cp1 == '=' || *cp1 == '!' || *cp1 == '<' || *cp1 == '>')
809 return CondParser_Comparison(par, doEval);
810 par->p = cp;
811
812 /*
813 * Evaluate the argument using the default function.
814 * This path always treats .if as .ifdef. To get here, the character
815 * after .if must have been taken literally, so the argument cannot
816 * be empty - even if it contained a variable expansion.
817 */
818 t = ToToken(!doEval || EvalBare(par, arg));
819 free(arg);
820 return t;
821 }
822
823 /* Return the next token or comparison result from the parser. */
824 static Token
825 CondParser_Token(CondParser *par, bool doEval)
826 {
827 Token t;
828
829 t = par->curr;
830 if (t != TOK_NONE) {
831 par->curr = TOK_NONE;
832 return t;
833 }
834
835 cpp_skip_hspace(&par->p);
836
837 switch (par->p[0]) {
838
839 case '(':
840 par->p++;
841 return TOK_LPAREN;
842
843 case ')':
844 par->p++;
845 return TOK_RPAREN;
846
847 case '|':
848 par->p++;
849 if (par->p[0] == '|')
850 par->p++;
851 else if (opts.strict) {
852 Parse_Error(PARSE_FATAL, "Unknown operator '|'");
853 par->printedError = true;
854 return TOK_ERROR;
855 }
856 return TOK_OR;
857
858 case '&':
859 par->p++;
860 if (par->p[0] == '&')
861 par->p++;
862 else if (opts.strict) {
863 Parse_Error(PARSE_FATAL, "Unknown operator '&'");
864 par->printedError = true;
865 return TOK_ERROR;
866 }
867 return TOK_AND;
868
869 case '!':
870 par->p++;
871 return TOK_NOT;
872
873 case '#': /* XXX: see unit-tests/cond-token-plain.mk */
874 case '\n': /* XXX: why should this end the condition? */
875 /* Probably obsolete now, from 1993-03-21. */
876 case '\0':
877 return TOK_EOF;
878
879 case '"':
880 case '$':
881 return CondParser_Comparison(par, doEval);
882
883 default:
884 if (CondParser_FuncCallEmpty(par, doEval, &t))
885 return t;
886 if (CondParser_FuncCall(par, doEval, &t))
887 return t;
888 return CondParser_ComparisonOrLeaf(par, doEval);
889 }
890 }
891
892 /* Skip the next token if it equals t. */
893 static bool
894 CondParser_Skip(CondParser *par, Token t)
895 {
896 Token actual;
897
898 actual = CondParser_Token(par, false);
899 if (actual == t)
900 return true;
901
902 assert(par->curr == TOK_NONE);
903 assert(actual != TOK_NONE);
904 par->curr = actual;
905 return false;
906 }
907
908 /*
909 * Term -> '(' Or ')'
910 * Term -> '!' Term
911 * Term -> Leaf Operator Leaf
912 * Term -> Leaf
913 */
914 static CondResult
915 CondParser_Term(CondParser *par, bool doEval)
916 {
917 CondResult res;
918 Token t;
919
920 t = CondParser_Token(par, doEval);
921 if (t == TOK_TRUE)
922 return CR_TRUE;
923 if (t == TOK_FALSE)
924 return CR_FALSE;
925
926 if (t == TOK_LPAREN) {
927 res = CondParser_Or(par, doEval);
928 if (res == CR_ERROR)
929 return CR_ERROR;
930 if (CondParser_Token(par, doEval) != TOK_RPAREN)
931 return CR_ERROR;
932 return res;
933 }
934
935 if (t == TOK_NOT) {
936 res = CondParser_Term(par, doEval);
937 if (res == CR_TRUE)
938 res = CR_FALSE;
939 else if (res == CR_FALSE)
940 res = CR_TRUE;
941 return res;
942 }
943
944 return CR_ERROR;
945 }
946
947 /*
948 * And -> Term ('&&' Term)*
949 */
950 static CondResult
951 CondParser_And(CondParser *par, bool doEval)
952 {
953 CondResult res, rhs;
954
955 res = CR_TRUE;
956 do {
957 if ((rhs = CondParser_Term(par, doEval)) == CR_ERROR)
958 return CR_ERROR;
959 if (rhs == CR_FALSE) {
960 res = CR_FALSE;
961 doEval = false;
962 }
963 } while (CondParser_Skip(par, TOK_AND));
964
965 return res;
966 }
967
968 /*
969 * Or -> And ('||' And)*
970 */
971 static CondResult
972 CondParser_Or(CondParser *par, bool doEval)
973 {
974 CondResult res, rhs;
975
976 res = CR_FALSE;
977 do {
978 if ((rhs = CondParser_And(par, doEval)) == CR_ERROR)
979 return CR_ERROR;
980 if (rhs == CR_TRUE) {
981 res = CR_TRUE;
982 doEval = false;
983 }
984 } while (CondParser_Skip(par, TOK_OR));
985
986 return res;
987 }
988
989 static CondEvalResult
990 CondParser_Eval(CondParser *par, bool *out_value)
991 {
992 CondResult res;
993
994 DEBUG1(COND, "CondParser_Eval: %s\n", par->p);
995
996 res = CondParser_Or(par, true);
997 if (res == CR_ERROR)
998 return COND_INVALID;
999
1000 if (CondParser_Token(par, false) != TOK_EOF)
1001 return COND_INVALID;
1002
1003 *out_value = res == CR_TRUE;
1004 return COND_PARSE;
1005 }
1006
1007 /*
1008 * Evaluate the condition, including any side effects from the variable
1009 * expressions in the condition. The condition consists of &&, ||, !,
1010 * function(arg), comparisons and parenthetical groupings thereof.
1011 *
1012 * Results:
1013 * COND_PARSE if the condition was valid grammatically
1014 * COND_INVALID if not a valid conditional.
1015 *
1016 * *out_value is set to the boolean value of the condition
1017 */
1018 static CondEvalResult
1019 CondEvalExpression(const char *cond, bool *out_value, bool plain,
1020 bool (*evalBare)(const char *), bool negate,
1021 bool eprint, bool leftUnquotedOK)
1022 {
1023 CondParser par;
1024 CondEvalResult rval;
1025
1026 cpp_skip_hspace(&cond);
1027
1028 par.plain = plain;
1029 par.evalBare = evalBare;
1030 par.negateEvalBare = negate;
1031 par.leftUnquotedOK = leftUnquotedOK;
1032 par.p = cond;
1033 par.curr = TOK_NONE;
1034 par.printedError = false;
1035
1036 rval = CondParser_Eval(&par, out_value);
1037
1038 if (rval == COND_INVALID && eprint && !par.printedError)
1039 Parse_Error(PARSE_FATAL, "Malformed conditional (%s)", cond);
1040
1041 return rval;
1042 }
1043
1044 /*
1045 * Evaluate a condition in a :? modifier, such as
1046 * ${"${VAR}" == value:?yes:no}.
1047 */
1048 CondEvalResult
1049 Cond_EvalCondition(const char *cond, bool *out_value)
1050 {
1051 return CondEvalExpression(cond, out_value, true,
1052 FuncDefined, false, false, true);
1053 }
1054
1055 static bool
1056 IsEndif(const char *p)
1057 {
1058 return p[0] == 'e' && p[1] == 'n' && p[2] == 'd' &&
1059 p[3] == 'i' && p[4] == 'f' && !ch_isalpha(p[5]);
1060 }
1061
1062 static bool
1063 DetermineKindOfConditional(const char **pp, bool *out_plain,
1064 bool (**out_evalBare)(const char *),
1065 bool *out_negate)
1066 {
1067 const char *p = *pp;
1068
1069 p += 2;
1070 *out_plain = false;
1071 *out_evalBare = FuncDefined;
1072 *out_negate = false;
1073 if (*p == 'n') {
1074 p++;
1075 *out_negate = true;
1076 }
1077 if (is_token(p, "def", 3)) { /* .ifdef and .ifndef */
1078 p += 3;
1079 } else if (is_token(p, "make", 4)) { /* .ifmake and .ifnmake */
1080 p += 4;
1081 *out_evalBare = FuncMake;
1082 } else if (is_token(p, "", 0) && !*out_negate) { /* plain .if */
1083 *out_plain = true;
1084 } else {
1085 /*
1086 * TODO: Add error message about unknown directive,
1087 * since there is no other known directive that starts
1088 * with 'el' or 'if'.
1089 *
1090 * Example: .elifx 123
1091 */
1092 return false;
1093 }
1094
1095 *pp = p;
1096 return true;
1097 }
1098
1099 /*
1100 * Evaluate the conditional directive in the line, which is one of:
1101 *
1102 * .if <cond>
1103 * .ifmake <cond>
1104 * .ifnmake <cond>
1105 * .ifdef <cond>
1106 * .ifndef <cond>
1107 * .elif <cond>
1108 * .elifmake <cond>
1109 * .elifnmake <cond>
1110 * .elifdef <cond>
1111 * .elifndef <cond>
1112 * .else
1113 * .endif
1114 *
1115 * In these directives, <cond> consists of &&, ||, !, function(arg),
1116 * comparisons, expressions, bare words, numbers and strings, and
1117 * parenthetical groupings thereof.
1118 *
1119 * Results:
1120 * COND_PARSE to continue parsing the lines that follow the
1121 * conditional (when <cond> evaluates to true)
1122 * COND_SKIP to skip the lines after the conditional
1123 * (when <cond> evaluates to false, or when a previous
1124 * branch has already been taken)
1125 * COND_INVALID if the conditional was not valid, either because of
1126 * a syntax error or because some variable was undefined
1127 * or because the condition could not be evaluated
1128 */
1129 CondEvalResult
1130 Cond_EvalLine(const char *line)
1131 {
1132 typedef enum IfState {
1133
1134 /* None of the previous <cond> evaluated to true. */
1135 IFS_INITIAL = 0,
1136
1137 /*
1138 * The previous <cond> evaluated to true. The lines following
1139 * this condition are interpreted.
1140 */
1141 IFS_ACTIVE = 1 << 0,
1142
1143 /* The previous directive was an '.else'. */
1144 IFS_SEEN_ELSE = 1 << 1,
1145
1146 /* One of the previous <cond> evaluated to true. */
1147 IFS_WAS_ACTIVE = 1 << 2
1148
1149 } IfState;
1150
1151 static enum IfState *cond_states = NULL;
1152 static unsigned int cond_states_cap = 128;
1153
1154 bool plain;
1155 bool (*evalBare)(const char *);
1156 bool negate;
1157 bool isElif;
1158 bool value;
1159 IfState state;
1160 const char *p = line;
1161
1162 if (cond_states == NULL) {
1163 cond_states = bmake_malloc(
1164 cond_states_cap * sizeof *cond_states);
1165 cond_states[0] = IFS_ACTIVE;
1166 }
1167
1168 p++; /* skip the leading '.' */
1169 cpp_skip_hspace(&p);
1170
1171 if (IsEndif(p)) { /* It is an '.endif'. */
1172 if (p[5] != '\0') {
1173 Parse_Error(PARSE_FATAL,
1174 "The .endif directive does not take arguments");
1175 }
1176
1177 if (cond_depth == cond_min_depth) {
1178 Parse_Error(PARSE_FATAL, "if-less endif");
1179 return COND_PARSE;
1180 }
1181
1182 /* Return state for previous conditional */
1183 cond_depth--;
1184 return cond_states[cond_depth] & IFS_ACTIVE
1185 ? COND_PARSE : COND_SKIP;
1186 }
1187
1188 /* Parse the name of the directive, such as 'if', 'elif', 'endif'. */
1189 if (p[0] == 'e') {
1190 if (p[1] != 'l') {
1191 /*
1192 * Unknown directive. It might still be a
1193 * transformation rule like '.err.txt',
1194 * therefore no error message here.
1195 */
1196 return COND_INVALID;
1197 }
1198
1199 /* Quite likely this is 'else' or 'elif' */
1200 p += 2;
1201 if (is_token(p, "se", 2)) { /* It is an 'else'. */
1202
1203 if (p[2] != '\0')
1204 Parse_Error(PARSE_FATAL,
1205 "The .else directive "
1206 "does not take arguments");
1207
1208 if (cond_depth == cond_min_depth) {
1209 Parse_Error(PARSE_FATAL, "if-less else");
1210 return COND_PARSE;
1211 }
1212
1213 state = cond_states[cond_depth];
1214 if (state == IFS_INITIAL) {
1215 state = IFS_ACTIVE | IFS_SEEN_ELSE;
1216 } else {
1217 if (state & IFS_SEEN_ELSE)
1218 Parse_Error(PARSE_WARNING,
1219 "extra else");
1220 state = IFS_WAS_ACTIVE | IFS_SEEN_ELSE;
1221 }
1222 cond_states[cond_depth] = state;
1223
1224 return state & IFS_ACTIVE ? COND_PARSE : COND_SKIP;
1225 }
1226 /* Assume for now it is an elif */
1227 isElif = true;
1228 } else
1229 isElif = false;
1230
1231 if (p[0] != 'i' || p[1] != 'f') {
1232 /*
1233 * Unknown directive. It might still be a transformation rule
1234 * like '.elisp.scm', therefore no error message here.
1235 */
1236 return COND_INVALID; /* Not an ifxxx or elifxxx line */
1237 }
1238
1239 if (!DetermineKindOfConditional(&p, &plain, &evalBare, &negate))
1240 return COND_INVALID;
1241
1242 if (isElif) {
1243 if (cond_depth == cond_min_depth) {
1244 Parse_Error(PARSE_FATAL, "if-less elif");
1245 return COND_PARSE;
1246 }
1247 state = cond_states[cond_depth];
1248 if (state & IFS_SEEN_ELSE) {
1249 Parse_Error(PARSE_WARNING, "extra elif");
1250 cond_states[cond_depth] =
1251 IFS_WAS_ACTIVE | IFS_SEEN_ELSE;
1252 return COND_SKIP;
1253 }
1254 if (state != IFS_INITIAL) {
1255 cond_states[cond_depth] = IFS_WAS_ACTIVE;
1256 return COND_SKIP;
1257 }
1258 } else {
1259 /* Normal .if */
1260 if (cond_depth + 1 >= cond_states_cap) {
1261 /*
1262 * This is rare, but not impossible.
1263 * In meta mode, dirdeps.mk (only runs at level 0)
1264 * can need more than the default.
1265 */
1266 cond_states_cap += 32;
1267 cond_states = bmake_realloc(cond_states,
1268 cond_states_cap * sizeof *cond_states);
1269 }
1270 state = cond_states[cond_depth];
1271 cond_depth++;
1272 if (!(state & IFS_ACTIVE)) {
1273 /*
1274 * If we aren't parsing the data,
1275 * treat as always false.
1276 */
1277 cond_states[cond_depth] = IFS_WAS_ACTIVE;
1278 return COND_SKIP;
1279 }
1280 }
1281
1282 /* And evaluate the conditional expression */
1283 if (CondEvalExpression(p, &value, plain, evalBare, negate,
1284 true, false) == COND_INVALID) {
1285 /*
1286 * Syntax error in conditional, error message already output.
1287 */
1288 /* Skip everything to matching .endif */
1289 /* XXX: An extra '.else' is not detected in this case. */
1290 cond_states[cond_depth] = IFS_WAS_ACTIVE;
1291 return COND_SKIP;
1292 }
1293
1294 if (!value) {
1295 cond_states[cond_depth] = IFS_INITIAL;
1296 return COND_SKIP;
1297 }
1298 cond_states[cond_depth] = IFS_ACTIVE;
1299 return COND_PARSE;
1300 }
1301
1302 void
1303 Cond_restore_depth(unsigned int saved_depth)
1304 {
1305 unsigned int open_conds = cond_depth - cond_min_depth;
1306
1307 if (open_conds != 0 || saved_depth > cond_depth) {
1308 Parse_Error(PARSE_FATAL, "%u open conditional%s",
1309 open_conds, open_conds == 1 ? "" : "s");
1310 cond_depth = cond_min_depth;
1311 }
1312
1313 cond_min_depth = saved_depth;
1314 }
1315
1316 unsigned int
1317 Cond_save_depth(void)
1318 {
1319 unsigned int depth = cond_min_depth;
1320
1321 cond_min_depth = cond_depth;
1322 return depth;
1323 }
1324