1 /* $NetBSD: targ.c,v 1.177 2022/04/15 12:19:28 rillig 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 * Maintaining the targets and sources, which are both implemented as GNode.
75 * Targ_Init Initialize the module.
77 * Targ_End Clean up the module.
79 * Targ_List Return the list of all targets so far.
81 * GNode_New Create a new GNode with the given name, don't add it
84 * Targ_FindNode Find the node, or return NULL.
86 * Targ_GetNode Find the node, or create it.
88 * Targ_NewInternalNode
89 * Create an internal node.
91 * Targ_FindList Given a list of names, find nodes for all
92 * of them, creating them as necessary.
94 * Targ_Propagate Propagate information between related nodes.
95 * Should be called after the makefiles are parsed
96 * but before any action is taken.
100 * Print out the entire graph, all variables and
101 * statistics for the directory cache.
109 /* "@(#)targ.c 8.2 (Berkeley) 3/19/94" */
110 MAKE_RCSID("$NetBSD: targ.c,v 1.177 2022/04/15 12:19:28 rillig Exp $");
113 * All target nodes that appeared on the left-hand side of one of the
114 * dependency operators ':', '::', '!'.
116 static GNodeList allTargets = LST_INIT;
117 static HashTable allTargetsByName;
120 static GNodeList allNodes = LST_INIT;
122 static void GNode_Free(void *);
128 HashTable_Init(&allTargetsByName);
136 Lst_Done(&allTargets);
137 HashTable_Done(&allTargetsByName);
138 Lst_DoneCall(&allNodes, GNode_Free);
145 HashTable_DebugStats(&allTargetsByName, "targets");
149 * Return the list of all targets, which are all nodes that appear on the
150 * left-hand side of a dependency declaration such as "target: source".
151 * The returned list does not contain pure sources.
160 * Create a new graph node, but don't register it anywhere.
162 * Graph nodes that appear on the left-hand side of a dependency line such
163 * as "target: source" are called targets. XXX: In some cases (like the
164 * .ALLTARGETS variable), all nodes are called targets as well, even if they
165 * never appear on the left-hand side. This is a mistake.
167 * Typical names for graph nodes are:
168 * "src.c" (an ordinary file)
169 * "clean" (a .PHONY target)
170 * ".END" (a special hook target)
172 * "libc.a(isspace.o)" (an archive member)
175 GNode_New(const char *name)
179 gn = bmake_malloc(sizeof *gn);
180 gn->name = bmake_strdup(name);
183 gn->type = name[0] == '-' && name[1] == 'l' ? OP_LIB : OP_NONE;
184 memset(&gn->flags, 0, sizeof(gn->flags));
188 gn->youngestChild = NULL;
189 Lst_Init(&gn->implicitParents);
190 Lst_Init(&gn->parents);
191 Lst_Init(&gn->children);
192 Lst_Init(&gn->order_pred);
193 Lst_Init(&gn->order_succ);
194 Lst_Init(&gn->cohorts);
195 gn->cohort_num[0] = '\0';
196 gn->unmade_cohorts = 0;
197 gn->centurion = NULL;
198 gn->checked_seqno = 0;
199 HashTable_Init(&gn->vars);
200 Lst_Init(&gn->commands);
206 Lst_Append(&allNodes, gn);
214 GNode_Free(void *gnp)
222 /* Don't free gn->youngestChild since it is not owned by this node. */
225 * In the following lists, only free the list nodes, but not the
226 * GNodes in them since these are not owned by this node.
228 Lst_Done(&gn->implicitParents);
229 Lst_Done(&gn->parents);
230 Lst_Done(&gn->children);
231 Lst_Done(&gn->order_pred);
232 Lst_Done(&gn->order_succ);
233 Lst_Done(&gn->cohorts);
236 * Do not free the variables themselves, even though they are owned
239 * XXX: For the nodes that represent targets or sources (and not
240 * SCOPE_GLOBAL), it should be safe to free the variables as well,
241 * since each node manages the memory for all its variables itself.
243 * XXX: The GNodes that are only used as variable scopes (SCOPE_CMD,
244 * SCOPE_GLOBAL, SCOPE_INTERNAL) are not freed at all (see Var_End,
245 * where they are not mentioned). These might be freed at all, if
246 * their variable values are indeed not used anywhere else (see
247 * Trace_Init for the only suspicious use).
249 HashTable_Done(&gn->vars);
252 * Do not free the commands themselves, as they may be shared with
255 Lst_Done(&gn->commands);
258 * gn->suffix is not owned by this node.
260 * XXX: gn->suffix should be unreferenced here. This requires a
261 * thorough check that the reference counting is done correctly in
262 * all places, otherwise a suffix might be freed too early.
269 /* Get the existing global node, or return NULL. */
271 Targ_FindNode(const char *name)
273 return HashTable_FindValue(&allTargetsByName, name);
276 /* Get the existing global node, or create it. */
278 Targ_GetNode(const char *name)
281 HashEntry *he = HashTable_CreateEntry(&allTargetsByName, name, &isNew);
283 return HashEntry_Get(he);
286 GNode *gn = Targ_NewInternalNode(name);
287 HashEntry_Set(he, gn);
293 * Create a node, register it in .ALLTARGETS but don't store it in the
294 * table of global nodes. This means it cannot be found by name.
296 * This is used for internal nodes, such as cohorts or .WAIT nodes.
299 Targ_NewInternalNode(const char *name)
301 GNode *gn = GNode_New(name);
302 Global_Append(".ALLTARGETS", name);
303 Lst_Append(&allTargets, gn);
304 DEBUG1(TARG, "Adding \"%s\" to all targets.\n", gn->name);
306 gn->flags.fromDepend = true;
311 * Return the .END node, which contains the commands to be run when
312 * everything else has been made.
315 Targ_GetEndNode(void)
318 * Save the node locally to avoid having to search for it all
321 static GNode *endNode = NULL;
323 if (endNode == NULL) {
324 endNode = Targ_GetNode(".END");
325 endNode->type = OP_SPECIAL;
330 /* Add the named nodes to the list, creating them as necessary. */
332 Targ_FindList(GNodeList *gns, StringList *names)
336 for (ln = names->first; ln != NULL; ln = ln->next) {
337 const char *name = ln->datum;
338 GNode *gn = Targ_GetNode(name);
344 PrintNodeNames(GNodeList *gnodes)
348 for (ln = gnodes->first; ln != NULL; ln = ln->next) {
349 GNode *gn = ln->datum;
350 debug_printf(" %s%s", gn->name, gn->cohort_num);
355 PrintNodeNamesLine(const char *label, GNodeList *gnodes)
357 if (Lst_IsEmpty(gnodes))
359 debug_printf("# %s:", label);
360 PrintNodeNames(gnodes);
365 Targ_PrintCmds(GNode *gn)
369 for (ln = gn->commands.first; ln != NULL; ln = ln->next) {
370 const char *cmd = ln->datum;
371 debug_printf("\t%s\n", cmd);
376 * Format a modification time in some reasonable way and return it.
377 * The formatted time is placed in a static area, so it is overwritten
381 Targ_FmtTime(time_t tm)
383 static char buf[128];
385 struct tm *parts = localtime(&tm);
386 (void)strftime(buf, sizeof buf, "%H:%M:%S %b %d, %Y", parts);
390 /* Print out a type field giving only those attributes the user can set. */
392 Targ_PrintType(GNodeType type)
394 static const struct {
399 { OP_MEMBER, true, "MEMBER" },
400 { OP_LIB, true, "LIB" },
401 { OP_ARCHV, true, "ARCHV" },
402 { OP_PHONY, true, "PHONY" },
403 { OP_NOTMAIN, false, "NOTMAIN" },
404 { OP_INVISIBLE, false, "INVISIBLE" },
405 { OP_MADE, true, "MADE" },
406 { OP_JOIN, false, "JOIN" },
407 { OP_MAKE, false, "MAKE" },
408 { OP_SILENT, false, "SILENT" },
409 { OP_PRECIOUS, false, "PRECIOUS" },
410 { OP_IGNORE, false, "IGNORE" },
411 { OP_EXEC, false, "EXEC" },
412 { OP_USE, false, "USE" },
413 { OP_USEBEFORE, false, "USEBEFORE" },
414 { OP_OPTIONAL, false, "OPTIONAL" },
418 for (i = 0; i < sizeof(names) / sizeof(names[0]); i++) {
419 if (type & names[i].bit) {
420 if (names[i].internal)
421 DEBUG1(TARG, " .%s", names[i].name);
423 debug_printf(" .%s", names[i].name);
429 GNodeMade_Name(GNodeMade made)
432 case UNMADE: return "unmade";
433 case DEFERRED: return "deferred";
434 case REQUESTED: return "requested";
435 case BEINGMADE: return "being made";
436 case MADE: return "made";
437 case UPTODATE: return "up-to-date";
438 case ERROR: return "error when made";
439 case ABORTED: return "aborted";
440 default: return "unknown enum_made value";
445 GNode_OpName(const GNode *gn)
447 switch (gn->type & OP_OPMASK) {
459 GNodeFlags_IsNone(GNodeFlags flags)
472 /* Print the contents of a node. */
474 Targ_PrintNode(GNode *gn, int pass)
476 debug_printf("# %s%s", gn->name, gn->cohort_num);
477 GNode_FprintDetails(opts.debug_file, ", ", gn, "\n");
478 if (GNodeFlags_IsNone(gn->flags))
481 if (!GNode_IsTarget(gn))
486 debug_printf("# *** MAIN TARGET ***\n");
490 debug_printf("# %d unmade children\n", gn->unmade);
492 debug_printf("# No unmade children\n");
493 if (!(gn->type & (OP_JOIN | OP_USE | OP_USEBEFORE | OP_EXEC))) {
494 if (gn->mtime != 0) {
495 debug_printf("# last modified %s: %s\n",
496 Targ_FmtTime(gn->mtime),
497 GNodeMade_Name(gn->made));
498 } else if (gn->made != UNMADE) {
499 debug_printf("# nonexistent (maybe): %s\n",
500 GNodeMade_Name(gn->made));
502 debug_printf("# unmade\n");
504 PrintNodeNamesLine("implicit parents", &gn->implicitParents);
507 debug_printf("# %d unmade children\n", gn->unmade);
510 PrintNodeNamesLine("parents", &gn->parents);
511 PrintNodeNamesLine("order_pred", &gn->order_pred);
512 PrintNodeNamesLine("order_succ", &gn->order_succ);
514 debug_printf("%-16s%s", gn->name, GNode_OpName(gn));
515 Targ_PrintType(gn->type);
516 PrintNodeNames(&gn->children);
519 debug_printf("\n\n");
520 if (gn->type & OP_DOUBLEDEP)
521 Targ_PrintNodes(&gn->cohorts, pass);
525 Targ_PrintNodes(GNodeList *gnodes, int pass)
529 for (ln = gnodes->first; ln != NULL; ln = ln->next)
530 Targ_PrintNode(ln->datum, pass);
534 PrintOnlySources(void)
538 for (ln = allTargets.first; ln != NULL; ln = ln->next) {
539 GNode *gn = ln->datum;
540 if (GNode_IsTarget(gn))
543 debug_printf("#\t%s [%s]", gn->name, GNode_Path(gn));
544 Targ_PrintType(gn->type);
551 * pass 1 => before processing
552 * 2 => after processing
553 * 3 => after processing, an error occurred
556 Targ_PrintGraph(int pass)
558 debug_printf("#*** Input graph:\n");
559 Targ_PrintNodes(&allTargets, pass);
564 debug_printf("# Files that are only sources:\n");
567 debug_printf("#*** Global Variables:\n");
568 Var_Dump(SCOPE_GLOBAL);
570 debug_printf("#*** Command-line Variables:\n");
571 Var_Dump(SCOPE_CMDLINE);
574 Dir_PrintDirectories();
581 * Propagate some type information to cohort nodes (those from the '::'
582 * dependency operator).
584 * Should be called after the makefiles are parsed but before any action is
590 GNodeListNode *ln, *cln;
592 for (ln = allTargets.first; ln != NULL; ln = ln->next) {
593 GNode *gn = ln->datum;
594 GNodeType type = gn->type;
596 if (!(type & OP_DOUBLEDEP))
599 for (cln = gn->cohorts.first; cln != NULL; cln = cln->next) {
600 GNode *cohort = cln->datum;
602 cohort->type |= type & ~OP_OPMASK;