Home | History | Annotate | Line # | Download | only in make
make.h revision 1.182
      1 /*	$NetBSD: make.h,v 1.182 2020/11/04 03:37:51 rillig Exp $	*/
      2 
      3 /*
      4  * Copyright (c) 1988, 1989, 1990, 1993
      5  *	The Regents of the University of California.  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  *	from: @(#)make.h	8.3 (Berkeley) 6/13/95
     35  */
     36 
     37 /*
     38  * Copyright (c) 1989 by Berkeley Softworks
     39  * All rights reserved.
     40  *
     41  * This code is derived from software contributed to Berkeley by
     42  * Adam de Boor.
     43  *
     44  * Redistribution and use in source and binary forms, with or without
     45  * modification, are permitted provided that the following conditions
     46  * are met:
     47  * 1. Redistributions of source code must retain the above copyright
     48  *    notice, this list of conditions and the following disclaimer.
     49  * 2. Redistributions in binary form must reproduce the above copyright
     50  *    notice, this list of conditions and the following disclaimer in the
     51  *    documentation and/or other materials provided with the distribution.
     52  * 3. All advertising materials mentioning features or use of this software
     53  *    must display the following acknowledgement:
     54  *	This product includes software developed by the University of
     55  *	California, Berkeley and its contributors.
     56  * 4. Neither the name of the University nor the names of its contributors
     57  *    may be used to endorse or promote products derived from this software
     58  *    without specific prior written permission.
     59  *
     60  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     61  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     62  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     63  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     64  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     65  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     66  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     67  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     68  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     69  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     70  * SUCH DAMAGE.
     71  *
     72  *	from: @(#)make.h	8.3 (Berkeley) 6/13/95
     73  */
     74 
     75 /*-
     76  * make.h --
     77  *	The global definitions for pmake
     78  */
     79 
     80 #ifndef MAKE_MAKE_H
     81 #define MAKE_MAKE_H
     82 
     83 #include <sys/types.h>
     84 #include <sys/param.h>
     85 #include <sys/stat.h>
     86 
     87 #include <assert.h>
     88 #include <ctype.h>
     89 #include <fcntl.h>
     90 #include <stdarg.h>
     91 #include <stdio.h>
     92 #include <stdlib.h>
     93 #include <string.h>
     94 #include <unistd.h>
     95 
     96 #ifdef BSD4_4
     97 # include <sys/cdefs.h>
     98 #endif
     99 
    100 #ifndef FD_CLOEXEC
    101 #define FD_CLOEXEC 1
    102 #endif
    103 
    104 #if defined(__GNUC__)
    105 #define	MAKE_GNUC_PREREQ(x, y)						\
    106 	((__GNUC__ == (x) && __GNUC_MINOR__ >= (y)) ||			\
    107 	 (__GNUC__ > (x)))
    108 #else /* defined(__GNUC__) */
    109 #define	MAKE_GNUC_PREREQ(x, y)	0
    110 #endif /* defined(__GNUC__) */
    111 
    112 #if MAKE_GNUC_PREREQ(2, 7)
    113 #define	MAKE_ATTR_UNUSED	__attribute__((__unused__))
    114 #else
    115 #define	MAKE_ATTR_UNUSED	/* delete */
    116 #endif
    117 
    118 #if MAKE_GNUC_PREREQ(2, 5)
    119 #define	MAKE_ATTR_DEAD		__attribute__((__noreturn__))
    120 #elif defined(__GNUC__)
    121 #define	MAKE_ATTR_DEAD		__volatile
    122 #else
    123 #define	MAKE_ATTR_DEAD		/* delete */
    124 #endif
    125 
    126 #if MAKE_GNUC_PREREQ(2, 7)
    127 #define MAKE_ATTR_PRINTFLIKE(fmtarg, firstvararg)	\
    128 	    __attribute__((__format__ (__printf__, fmtarg, firstvararg)))
    129 #else
    130 #define MAKE_ATTR_PRINTFLIKE(fmtarg, firstvararg)	/* delete */
    131 #endif
    132 
    133 /*
    134  * A boolean type is defined as an integer, not an enum, for historic reasons.
    135  * The only allowed values are the constants TRUE and FALSE (1 and 0).
    136  */
    137 
    138 #ifdef USE_DOUBLE_BOOLEAN
    139 /* During development, to find type mismatches in function declarations. */
    140 typedef double Boolean;
    141 #define TRUE 1.0
    142 #define FALSE 0.0
    143 #elif defined(USE_UCHAR_BOOLEAN)
    144 /* During development, to find code that depends on the exact value of TRUE or
    145  * that stores other values in Boolean variables. */
    146 typedef unsigned char Boolean;
    147 #define TRUE ((unsigned char)0xFF)
    148 #define FALSE ((unsigned char)0x00)
    149 #elif defined(USE_CHAR_BOOLEAN)
    150 /* During development, to find code that uses a boolean as array index, via
    151  * -Wchar-subscripts. */
    152 typedef char Boolean;
    153 #define TRUE ((char)-1)
    154 #define FALSE ((char)0x00)
    155 #elif defined(USE_ENUM_BOOLEAN)
    156 typedef enum Boolean { FALSE, TRUE } Boolean;
    157 #else
    158 typedef int Boolean;
    159 #ifndef TRUE
    160 #define TRUE	1
    161 #endif
    162 #ifndef FALSE
    163 #define FALSE	0
    164 #endif
    165 #endif
    166 
    167 #include "lst.h"
    168 #include "enum.h"
    169 #include "hash.h"
    170 #include "config.h"
    171 #include "buf.h"
    172 #include "make_malloc.h"
    173 
    174 typedef enum GNodeMade {
    175     UNMADE,			/* Not examined yet */
    176     DEFERRED,			/* Examined once (building child) */
    177     REQUESTED,			/* on toBeMade list */
    178     BEINGMADE,			/* Target is already being made.
    179 				 * Indicates a cycle in the graph. */
    180     MADE,			/* Was out-of-date and has been made */
    181     UPTODATE,			/* Was already up-to-date */
    182     ERROR,			/* An error occurred while it was being
    183 				 * made (used only in compat mode) */
    184     ABORTED			/* The target was aborted due to an error
    185 				 * making an inferior (compat). */
    186 } GNodeMade;
    187 
    188 /* The OP_ constants are used when parsing a dependency line as a way of
    189  * communicating to other parts of the program the way in which a target
    190  * should be made.
    191  *
    192  * Some of the OP_ constants can be combined, others cannot. */
    193 typedef enum GNodeType {
    194     /* The dependency operator ':' is the most common one.  The commands of
    195      * this node are executed if any child is out-of-date. */
    196     OP_DEPENDS		= 1 << 0,
    197     /* The dependency operator '!' always executes its commands, even if
    198      * its children are up-to-date. */
    199     OP_FORCE		= 1 << 1,
    200     /* The dependency operator '::' behaves like ':', except that it allows
    201      * multiple dependency groups to be defined.  Each of these groups is
    202      * executed on its own, independently from the others. */
    203     OP_DOUBLEDEP	= 1 << 2,
    204 
    205     /* Matches the dependency operators ':', '!' and '::'. */
    206     OP_OPMASK		= OP_DEPENDS|OP_FORCE|OP_DOUBLEDEP,
    207 
    208     /* Don't care if the target doesn't exist and can't be created */
    209     OP_OPTIONAL		= 1 << 3,
    210     /* Use associated commands for parents */
    211     OP_USE		= 1 << 4,
    212     /* Target is never out of date, but always execute commands anyway.
    213      * Its time doesn't matter, so it has none...sort of */
    214     OP_EXEC		= 1 << 5,
    215     /* Ignore non-zero exit status from shell commands when creating the node */
    216     OP_IGNORE		= 1 << 6,
    217     /* Don't remove the target when interrupted */
    218     OP_PRECIOUS		= 1 << 7,
    219     /* Don't echo commands when executed */
    220     OP_SILENT		= 1 << 8,
    221     /* Target is a recursive make so its commands should always be executed
    222      * when it is out of date, regardless of the state of the -n or -t flags */
    223     OP_MAKE		= 1 << 9,
    224     /* Target is out-of-date only if any of its children was out-of-date */
    225     OP_JOIN		= 1 << 10,
    226     /* Assume the children of the node have been already made */
    227     OP_MADE		= 1 << 11,
    228     /* Special .BEGIN, .END, .INTERRUPT */
    229     OP_SPECIAL		= 1 << 12,
    230     /* Like .USE, only prepend commands */
    231     OP_USEBEFORE	= 1 << 13,
    232     /* The node is invisible to its parents. I.e. it doesn't show up in the
    233      * parents' local variables. */
    234     OP_INVISIBLE	= 1 << 14,
    235     /* The node is exempt from normal 'main target' processing in parse.c */
    236     OP_NOTMAIN		= 1 << 15,
    237     /* Not a file target; run always */
    238     OP_PHONY		= 1 << 16,
    239     /* Don't search for file in the path */
    240     OP_NOPATH		= 1 << 17,
    241     /* .WAIT phony node */
    242     OP_WAIT		= 1 << 18,
    243     /* .NOMETA do not create a .meta file */
    244     OP_NOMETA		= 1 << 19,
    245     /* .META we _do_ want a .meta file */
    246     OP_META		= 1 << 20,
    247     /* Do not compare commands in .meta file */
    248     OP_NOMETA_CMP	= 1 << 21,
    249     /* Possibly a submake node */
    250     OP_SUBMAKE		= 1 << 22,
    251 
    252     /* Attributes applied by PMake */
    253 
    254     /* The node is a transformation rule */
    255     OP_TRANSFORM	= 1 << 31,
    256     /* Target is a member of an archive */
    257     /* XXX: How does this differ from OP_ARCHV? */
    258     OP_MEMBER		= 1 << 30,
    259     /* The node is a library,
    260      * its name has the form "-l<libname>" */
    261     OP_LIB		= 1 << 29,
    262     /* The node is an archive member,
    263      * its name has the form "archive(member)" */
    264     /* XXX: How does this differ from OP_MEMBER? */
    265     OP_ARCHV		= 1 << 28,
    266     /* Target has all the commands it should. Used when parsing to catch
    267      * multiple command groups for a target.  Only applies to the dependency
    268      * operators ':' and '!', but not to '::'. */
    269     OP_HAS_COMMANDS	= 1 << 27,
    270     /* The special command "..." has been seen. All further commands from
    271      * this node will be saved on the .END node instead, to be executed at
    272      * the very end. */
    273     OP_SAVE_CMDS	= 1 << 26,
    274     /* Already processed by Suff_FindDeps */
    275     OP_DEPS_FOUND	= 1 << 25,
    276     /* Node found while expanding .ALLSRC */
    277     OP_MARK		= 1 << 24,
    278 
    279     OP_NOTARGET		= OP_NOTMAIN | OP_USE | OP_EXEC | OP_TRANSFORM
    280 } GNodeType;
    281 
    282 typedef enum GNodeFlags {
    283     REMAKE	= 0x0001,	/* this target needs to be (re)made */
    284     CHILDMADE	= 0x0002,	/* children of this target were made */
    285     FORCE	= 0x0004,	/* children don't exist, and we pretend made */
    286     DONE_WAIT	= 0x0008,	/* Set by Make_ProcessWait() */
    287     DONE_ORDER	= 0x0010,	/* Build requested by .ORDER processing */
    288     FROM_DEPEND	= 0x0020,	/* Node created from .depend */
    289     DONE_ALLSRC	= 0x0040,	/* We do it once only */
    290     CYCLE	= 0x1000,	/* Used by MakePrintStatus */
    291     DONECYCLE	= 0x2000,	/* Used by MakePrintStatus */
    292     INTERNAL	= 0x4000	/* Internal use only */
    293 } GNodeFlags;
    294 
    295 typedef struct List StringList;
    296 typedef struct ListNode StringListNode;
    297 
    298 typedef struct List GNodeList;
    299 typedef struct ListNode GNodeListNode;
    300 
    301 typedef struct List /* of CachedDir */ SearchPath;
    302 
    303 /* A graph node represents a target that can possibly be made, including its
    304  * relation to other targets and a lot of other details. */
    305 typedef struct GNode {
    306     /* The target's name, such as "clean" or "make.c" */
    307     char *name;
    308     /* The unexpanded name of a .USE node */
    309     char *uname;
    310     /* The full pathname of the file belonging to the target.
    311      * XXX: What about .PHONY targets? These don't have an associated path. */
    312     char *path;
    313 
    314     /* The type of operator used to define the sources (see the OP flags below).
    315      * XXX: This looks like a wild mixture of type and flags. */
    316     GNodeType type;
    317     GNodeFlags flags;
    318 
    319     /* The state of processing on this node */
    320     GNodeMade made;
    321     int unmade;			/* The number of unmade children */
    322 
    323     /* The modification time; 0 means the node does not have a corresponding
    324      * file; see Make_OODate. */
    325     time_t mtime;
    326     struct GNode *youngestChild;
    327 
    328     /* The GNodes for which this node is an implied source. May be empty.
    329      * For example, when there is an inference rule for .c.o, the node for
    330      * file.c has the node for file.o in this list. */
    331     GNodeList *implicitParents;
    332 
    333     /* Other nodes of the same name, for the '::' operator. */
    334     GNodeList *cohorts;
    335 
    336     /* The nodes that depend on this one, or in other words, the nodes for
    337      * which this is a source. */
    338     GNodeList *parents;
    339     /* The nodes on which this one depends. */
    340     GNodeList *children;
    341 
    342     /* .ORDER nodes we need made. The nodes that must be made (if they're
    343      * made) before this node can be made, but that do not enter into the
    344      * datedness of this node. */
    345     GNodeList *order_pred;
    346     /* .ORDER nodes who need us. The nodes that must be made (if they're made
    347      * at all) after this node is made, but that do not depend on this node,
    348      * in the normal sense. */
    349     GNodeList *order_succ;
    350 
    351     /* The "#n" suffix for this cohort, or "" for other nodes */
    352     char cohort_num[8];
    353     /* The number of unmade instances on the cohorts list */
    354     int unmade_cohorts;
    355     /* Pointer to the first instance of a '::' node; only set when on a
    356      * cohorts list */
    357     struct GNode *centurion;
    358 
    359     /* Last time (sequence number) we tried to make this node */
    360     unsigned int checked_seqno;
    361 
    362     /* The "local" variables that are specific to this target and this target
    363      * only, such as $@, $<, $?.
    364      *
    365      * Also used for the global variable scopes VAR_GLOBAL, VAR_CMDLINE,
    366      * VAR_INTERNAL, which contain variables with arbitrary names. */
    367     HashTable /* of Var pointer */ context;
    368 
    369     /* The commands to be given to a shell to create this target. */
    370     StringList *commands;
    371 
    372     /* Suffix for the node (determined by Suff_FindDeps and opaque to everyone
    373      * but the Suff module) */
    374     struct Suff *suffix;
    375 
    376     /* filename where the GNode got defined */
    377     const char *fname;
    378     /* line number where the GNode got defined */
    379     int lineno;
    380 } GNode;
    381 
    382 /*
    383  * Error levels for parsing. PARSE_FATAL means the process cannot continue
    384  * once the top-level makefile has been parsed. PARSE_WARNING and PARSE_INFO
    385  * mean it can.
    386  */
    387 typedef enum ParseErrorLevel {
    388     PARSE_FATAL = 1,
    389     PARSE_WARNING,
    390     PARSE_INFO
    391 } ParseErrorLevel;
    392 
    393 /*
    394  * Values returned by Cond_EvalLine and Cond_EvalCondition.
    395  */
    396 typedef enum CondEvalResult {
    397     COND_PARSE,			/* Parse the next lines */
    398     COND_SKIP,			/* Skip the next lines */
    399     COND_INVALID		/* Not a conditional statement */
    400 } CondEvalResult;
    401 
    402 /*
    403  * Definitions for the "local" variables. Used only for clarity.
    404  */
    405 #define TARGET		"@"	/* Target of dependency */
    406 #define OODATE		"?"	/* All out-of-date sources */
    407 #define ALLSRC		">"	/* All sources */
    408 #define IMPSRC		"<"	/* Source implied by transformation */
    409 #define PREFIX		"*"	/* Common prefix */
    410 #define ARCHIVE		"!"	/* Archive in "archive(member)" syntax */
    411 #define MEMBER		"%"	/* Member in "archive(member)" syntax */
    412 
    413 #define FTARGET		"@F"	/* file part of TARGET */
    414 #define DTARGET		"@D"	/* directory part of TARGET */
    415 #define FIMPSRC		"<F"	/* file part of IMPSRC */
    416 #define DIMPSRC		"<D"	/* directory part of IMPSRC */
    417 #define FPREFIX		"*F"	/* file part of PREFIX */
    418 #define DPREFIX		"*D"	/* directory part of PREFIX */
    419 
    420 /*
    421  * Global Variables
    422  */
    423 extern SearchPath *dirSearchPath;
    424 				/* The list of directories to search when
    425 				 * looking for targets */
    426 extern Boolean  allPrecious;	/* True if every target is precious */
    427 extern Boolean  deleteOnError;	/* True if failed targets should be deleted */
    428 extern Boolean	doing_depend;	/* TRUE if processing .depend */
    429 
    430 extern GNode    *DEFAULT;	/* .DEFAULT rule */
    431 
    432 extern GNode	*VAR_INTERNAL;	/* Variables defined internally by make
    433 				 * which should not override those set by
    434 				 * makefiles.
    435 				 */
    436 extern GNode    *VAR_GLOBAL;	/* Variables defined in a global context, e.g
    437 				 * in the Makefile itself */
    438 extern GNode    *VAR_CMDLINE;	/* Variables defined on the command line */
    439 extern char	var_Error[];	/* Value returned by Var_Parse when an error
    440 				 * is encountered. It actually points to
    441 				 * an empty string, so naive callers needn't
    442 				 * worry about it. */
    443 
    444 extern time_t	now;		/* The time at the start of this whole
    445 				 * process */
    446 
    447 /*
    448  * If TRUE (default behavior), undefined subexpressions in a variable
    449  * expression are discarded.  If FALSE (only in variable assignments using the
    450  * ':=' assignment operator), they are preserved and possibly expanded later
    451  * when the variable from the subexpression has been defined.
    452  *
    453  * Example for a ':=' assignment:
    454  *	CFLAGS = $(.INCLUDES)
    455  *	CFLAGS := -I.. $(CFLAGS)
    456  *	# If .INCLUDES (an undocumented special variable, by the way) is
    457  *	# still undefined, the updated CFLAGS becomes "-I.. $(.INCLUDES)".
    458  */
    459 extern Boolean discardUndefined;
    460 
    461 extern SearchPath *sysIncPath;	/* The system include path. */
    462 extern SearchPath *defSysIncPath; /* The default system include path. */
    463 
    464 extern char	curdir[];	/* Startup directory */
    465 extern char	*progname;	/* The program name */
    466 extern char	*makeDependfile; /* .depend */
    467 extern char	**savedEnv;	/* if we replaced environ this will be non-NULL */
    468 
    469 extern int	makelevel;
    470 
    471 /*
    472  * We cannot vfork() in a child of vfork().
    473  * Most systems do not enforce this but some do.
    474  */
    475 #define vFork() ((getpid() == myPid) ? vfork() : fork())
    476 extern pid_t	myPid;
    477 
    478 #define	MAKEFLAGS	".MAKEFLAGS"
    479 #define	MAKEOVERRIDES	".MAKEOVERRIDES"
    480 #define	MAKE_JOB_PREFIX	".MAKE.JOB.PREFIX" /* prefix for job target output */
    481 #define	MAKE_EXPORTED	".MAKE.EXPORTED"   /* variables we export */
    482 #define	MAKE_MAKEFILES	".MAKE.MAKEFILES"  /* all makefiles already loaded */
    483 #define	MAKE_LEVEL	".MAKE.LEVEL"	   /* recursion level */
    484 #define MAKEFILE_PREFERENCE ".MAKE.MAKEFILE_PREFERENCE"
    485 #define MAKE_DEPENDFILE	".MAKE.DEPENDFILE" /* .depend */
    486 #define MAKE_MODE	".MAKE.MODE"
    487 #ifndef MAKE_LEVEL_ENV
    488 # define MAKE_LEVEL_ENV	"MAKELEVEL"
    489 #endif
    490 
    491 typedef enum DebugFlags {
    492     DEBUG_ARCH		= 1 << 0,
    493     DEBUG_COND		= 1 << 1,
    494     DEBUG_DIR		= 1 << 2,
    495     DEBUG_GRAPH1	= 1 << 3,
    496     DEBUG_GRAPH2	= 1 << 4,
    497     DEBUG_JOB		= 1 << 5,
    498     DEBUG_MAKE		= 1 << 6,
    499     DEBUG_SUFF		= 1 << 7,
    500     DEBUG_TARG		= 1 << 8,
    501     DEBUG_VAR		= 1 << 9,
    502     DEBUG_FOR		= 1 << 10,
    503     DEBUG_SHELL		= 1 << 11,
    504     DEBUG_ERROR		= 1 << 12,
    505     DEBUG_LOUD		= 1 << 13,
    506     DEBUG_META		= 1 << 14,
    507     DEBUG_HASH		= 1 << 15,
    508 
    509     DEBUG_GRAPH3	= 1 << 16,
    510     DEBUG_SCRIPT	= 1 << 17,
    511     DEBUG_PARSE		= 1 << 18,
    512     DEBUG_CWD		= 1 << 19,
    513 
    514     DEBUG_LINT		= 1 << 20
    515 } DebugFlags;
    516 
    517 #define CONCAT(a,b)	a##b
    518 
    519 #define	DEBUG(module)	(opts.debug & CONCAT(DEBUG_,module))
    520 
    521 void debug_printf(const char *, ...) MAKE_ATTR_PRINTFLIKE(1, 2);
    522 
    523 #define DEBUG0(module, text) \
    524     if (!DEBUG(module)) (void)0; \
    525     else debug_printf("%s", text)
    526 
    527 #define DEBUG1(module, fmt, arg1) \
    528     if (!DEBUG(module)) (void)0; \
    529     else debug_printf(fmt, arg1)
    530 
    531 #define DEBUG2(module, fmt, arg1, arg2) \
    532     if (!DEBUG(module)) (void)0; \
    533     else debug_printf(fmt, arg1, arg2)
    534 
    535 #define DEBUG3(module, fmt, arg1, arg2, arg3) \
    536     if (!DEBUG(module)) (void)0; \
    537     else debug_printf(fmt, arg1, arg2, arg3)
    538 
    539 #define DEBUG4(module, fmt, arg1, arg2, arg3, arg4) \
    540     if (!DEBUG(module)) (void)0; \
    541     else debug_printf(fmt, arg1, arg2, arg3, arg4)
    542 
    543 #define DEBUG5(module, fmt, arg1, arg2, arg3, arg4, arg5) \
    544     if (!DEBUG(module)) (void)0; \
    545     else debug_printf(fmt, arg1, arg2, arg3, arg4, arg5)
    546 
    547 typedef enum PrintVarsMode {
    548     COMPAT_VARS = 1,
    549     EXPAND_VARS
    550 } PrintVarsMode;
    551 
    552 /* Command line options */
    553 typedef struct CmdOpts {
    554     /* -B: whether we are make compatible */
    555     Boolean compatMake;
    556 
    557     /* -d: debug control: There is one bit per module.  It is up to the
    558      * module what debug information to print. */
    559     DebugFlags debug;
    560 
    561     /* -df: debug output is written here - default stderr */
    562     FILE *debug_file;
    563 
    564     /* -dV: for the -V option, print unexpanded variable values */
    565     Boolean debugVflag;
    566 
    567     /* -e: check environment variables before global variables */
    568     Boolean checkEnvFirst;
    569 
    570     /* -f: the makefiles to read */
    571     StringList *makefiles;
    572 
    573     /* -i: if true, ignore all errors from shell commands */
    574     Boolean ignoreErrors;
    575 
    576     /* -j: the maximum number of jobs that can run in parallel;
    577      * this is coordinated with the submakes */
    578     int maxJobs;
    579 
    580     /* -k: if true, continue on unaffected portions of the graph when an
    581      * error occurs in one portion */
    582     Boolean keepgoing;
    583 
    584     /* -N: execute no commands from the targets */
    585     Boolean noRecursiveExecute;
    586 
    587     /* -n: execute almost no commands from the targets */
    588     Boolean noExecute;
    589 
    590     /* -q: if true, we aren't supposed to really make anything, just see if
    591      * the targets are out-of-date */
    592     Boolean queryFlag;
    593 
    594     /* -r: raw mode, without loading the builtin rules. */
    595     Boolean noBuiltins;
    596 
    597     /* -s: don't echo the shell commands before executing them */
    598     Boolean beSilent;
    599 
    600     /* -t: touch the targets if they are out-of-date, but don't actually
    601      * make them */
    602     Boolean touchFlag;
    603 
    604     /* -[Vv]: print expanded or unexpanded selected variables */
    605     PrintVarsMode printVars;
    606     /* -[Vv]: the variables to print */
    607     StringList *variables;
    608 
    609     /* -W: if true, makefile parsing warnings are treated as errors */
    610     Boolean parseWarnFatal;
    611 
    612     /* -w: print Entering and Leaving for submakes */
    613     Boolean enterFlag;
    614 
    615     /* -X: if true, do not export variables set on the command line to the
    616      * environment. */
    617     Boolean varNoExportEnv;
    618 
    619     /* The target names specified on the command line.
    620      * Used to resolve .if make(...) statements. */
    621     StringList *create;
    622 
    623 } CmdOpts;
    624 
    625 extern CmdOpts opts;
    626 
    627 #include "nonints.h"
    628 
    629 void Make_TimeStamp(GNode *, GNode *);
    630 Boolean Make_OODate(GNode *);
    631 void Make_ExpandUse(GNodeList *);
    632 time_t Make_Recheck(GNode *);
    633 void Make_HandleUse(GNode *, GNode *);
    634 void Make_Update(GNode *);
    635 void Make_DoAllVar(GNode *);
    636 Boolean Make_Run(GNodeList *);
    637 int dieQuietly(GNode *, int);
    638 void PrintOnError(GNode *, const char *);
    639 void Main_ExportMAKEFLAGS(Boolean);
    640 Boolean Main_SetObjdir(const char *, ...) MAKE_ATTR_PRINTFLIKE(1, 2);
    641 int mkTempFile(const char *, char **);
    642 int str2Lst_Append(StringList *, char *, const char *);
    643 void GNode_FprintDetails(FILE *, const char *, const GNode *, const char *);
    644 Boolean GNode_ShouldExecute(GNode *gn);
    645 
    646 /* See if the node was seen on the left-hand side of a dependency operator. */
    647 static MAKE_ATTR_UNUSED Boolean
    648 GNode_IsTarget(const GNode *gn)
    649 {
    650     return (gn->type & OP_OPMASK) != 0;
    651 }
    652 
    653 static MAKE_ATTR_UNUSED const char *
    654 GNode_Path(const GNode *gn)
    655 {
    656     return gn->path != NULL ? gn->path : gn->name;
    657 }
    658 
    659 static MAKE_ATTR_UNUSED const char *
    660 GNode_VarTarget(GNode *gn) { return Var_ValueDirect(TARGET, gn); }
    661 static MAKE_ATTR_UNUSED const char *
    662 GNode_VarOodate(GNode *gn) { return Var_ValueDirect(OODATE, gn); }
    663 static MAKE_ATTR_UNUSED const char *
    664 GNode_VarAllsrc(GNode *gn) { return Var_ValueDirect(ALLSRC, gn); }
    665 static MAKE_ATTR_UNUSED const char *
    666 GNode_VarImpsrc(GNode *gn) { return Var_ValueDirect(IMPSRC, gn); }
    667 static MAKE_ATTR_UNUSED const char *
    668 GNode_VarPrefix(GNode *gn) { return Var_ValueDirect(PREFIX, gn); }
    669 static MAKE_ATTR_UNUSED const char *
    670 GNode_VarArchive(GNode *gn) { return Var_ValueDirect(ARCHIVE, gn); }
    671 static MAKE_ATTR_UNUSED const char *
    672 GNode_VarMember(GNode *gn) { return Var_ValueDirect(MEMBER, gn); }
    673 
    674 #ifdef __GNUC__
    675 #define UNCONST(ptr)	({		\
    676     union __unconst {			\
    677 	const void *__cp;		\
    678 	void *__p;			\
    679     } __d;				\
    680     __d.__cp = ptr, __d.__p; })
    681 #else
    682 #define UNCONST(ptr)	(void *)(ptr)
    683 #endif
    684 
    685 /* At least GNU/Hurd systems lack hardcoded MAXPATHLEN/PATH_MAX */
    686 #include <limits.h>
    687 #ifndef MAXPATHLEN
    688 #define MAXPATHLEN	4096
    689 #endif
    690 #ifndef PATH_MAX
    691 #define PATH_MAX	MAXPATHLEN
    692 #endif
    693 
    694 #if defined(SYSV)
    695 #define KILLPG(pid, sig)	kill(-(pid), (sig))
    696 #else
    697 #define KILLPG(pid, sig)	killpg((pid), (sig))
    698 #endif
    699 
    700 static inline MAKE_ATTR_UNUSED Boolean ch_isalnum(char ch)
    701 { return isalnum((unsigned char)ch) != 0; }
    702 static inline MAKE_ATTR_UNUSED Boolean ch_isalpha(char ch)
    703 { return isalpha((unsigned char)ch) != 0; }
    704 static inline MAKE_ATTR_UNUSED Boolean ch_isdigit(char ch)
    705 { return isdigit((unsigned char)ch) != 0; }
    706 static inline MAKE_ATTR_UNUSED Boolean ch_isspace(char ch)
    707 { return isspace((unsigned char)ch) != 0; }
    708 static inline MAKE_ATTR_UNUSED Boolean ch_isupper(char ch)
    709 { return isupper((unsigned char)ch) != 0; }
    710 static inline MAKE_ATTR_UNUSED char ch_tolower(char ch)
    711 { return (char)tolower((unsigned char)ch); }
    712 static inline MAKE_ATTR_UNUSED char ch_toupper(char ch)
    713 { return (char)toupper((unsigned char)ch); }
    714 
    715 static inline MAKE_ATTR_UNUSED void
    716 cpp_skip_whitespace(const char **pp)
    717 {
    718     while (ch_isspace(**pp))
    719 	(*pp)++;
    720 }
    721 
    722 static inline MAKE_ATTR_UNUSED void
    723 pp_skip_whitespace(char **pp)
    724 {
    725     while (ch_isspace(**pp))
    726 	(*pp)++;
    727 }
    728 
    729 #ifdef MAKE_NATIVE
    730 #  include <sys/cdefs.h>
    731 #  ifndef lint
    732 #    define MAKE_RCSID(id) __RCSID(id)
    733 #  endif
    734 #else
    735 #  define MAKE_RCSID(id) static volatile char rcsid[] = id
    736 #endif
    737 
    738 #endif /* MAKE_MAKE_H */
    739