2 * Copyright (c) 1988, 1989, 1990, 1993
3 * The Regents of the University of California. All rights reserved.
4 * Copyright (c) 1989 by Berkeley Softworks
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. All advertising materials mentioning features or use of this software
19 * must display the following acknowledgement:
20 * This product includes software developed by the University of
21 * California, Berkeley and its contributors.
22 * 4. Neither the name of the University nor the names of its contributors
23 * may be used to endorse or promote products derived from this software
24 * without specific prior written permission.
26 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
27 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
28 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
29 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
30 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
31 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
32 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
33 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
34 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
35 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38 * @(#)suff.c 8.4 (Berkeley) 3/21/94
41 #include <sys/cdefs.h>
42 __FBSDID("$FreeBSD$");
46 * Functions to maintain suffix lists and find implicit dependents
47 * using suffix transformation rules
50 * Suff_Init Initialize all things to do with suffixes.
52 * Suff_DoPaths This function is used to make life easier
53 * when searching for a file according to its
54 * suffix. It takes the global search path,
55 * as defined using the .PATH: target, and appends
56 * its directories to the path of each of the
57 * defined suffixes, as specified using
58 * .PATH<suffix>: targets. In addition, all
59 * directories given for suffixes labeled as
60 * include files or libraries, using the .INCLUDES
61 * or .LIBS targets, are played with using
62 * Dir_MakeFlags to create the .INCLUDES and
63 * .LIBS global variables.
65 * Suff_ClearSuffixes Clear out all the suffixes and defined
68 * Suff_IsTransform Return TRUE if the passed string is the lhs
69 * of a transformation rule.
71 * Suff_AddSuffix Add the passed string as another known suffix.
73 * Suff_GetPath Return the search path for the given suffix.
75 * Suff_AddInclude Mark the given suffix as denoting an include
78 * Suff_AddLib Mark the given suffix as denoting a library.
80 * Suff_AddTransform Add another transformation to the suffix
81 * graph. Returns GNode suitable for framing, I
82 * mean, tacking commands, attributes, etc. on.
84 * Suff_SetNull Define the suffix to consider the suffix of
85 * any file that doesn't have a known one.
87 * Suff_FindDeps Find implicit sources for and the location of
88 * a target based on its suffix. Returns the
89 * bottom-most node added to the graph or NULL
90 * if the target had no implicit sources.
93 #include <sys/queue.h>
113 /* Lst of suffixes */
114 static Lst sufflist = Lst_Initializer(sufflist);
116 /* Lst of suffixes to be cleaned */
117 static Lst suffClean = Lst_Initializer(suffClean);
120 static Lst srclist = Lst_Initializer(srclist);
122 /* Lst of transformation rules */
123 static Lst transforms = Lst_Initializer(transforms);
125 /* Counter for assigning suffix numbers */
129 * Structure describing an individual suffix.
131 typedef struct Suff {
132 char *name; /* The suffix itself */
133 int nameLen; /* Length of the suffix */
134 short flags; /* Type of suffix */
135 #define SUFF_INCLUDE 0x01 /* One which is #include'd */
136 #define SUFF_LIBRARY 0x02 /* One which contains a library */
137 #define SUFF_NULL 0x04 /* The empty suffix */
138 struct Path searchPath; /* Path for files with this suffix */
139 int sNum; /* The suffix number */
140 int refCount; /* Reference count of list membership */
141 Lst parents; /* Suffixes we have a transformation to */
142 Lst children; /* Suffixes we have a transformation from */
143 Lst ref; /* List of lists this suffix is referenced */
147 * Structure used in the search for implied sources.
150 char *file; /* The file to look for */
151 char *pref; /* Prefix from which file was formed */
152 Suff *suff; /* The suffix on the file */
153 struct Src *parent; /* The Src for which this is a source */
154 GNode *node; /* The node describing the file */
155 int children; /* Count of existing children (so we don't free
156 * this thing too early or never nuke it) */
158 Lst cp; /* Debug; children list */
162 /* The NULL suffix for this run */
163 static Suff *suffNull;
165 /* The empty suffix required for POSIX single-suffix transformation rules */
166 static Suff *emptySuff;
168 static void SuffFindDeps(GNode *, Lst *);
172 *-----------------------------------------------------------------------
173 * SuffSuffIsSuffix --
174 * See if suff is a suffix of str.
177 * NULL if it ain't, pointer to character in str before suffix if
182 *-----------------------------------------------------------------------
185 SuffSuffIsSuffix(const Suff *s, char *str)
187 const char *p1; /* Pointer into suffix name */
188 char *p2; /* Pointer into string being examined */
192 p1 = s->name + s->nameLen;
195 while (p1 >= s->name && len > 0 && *p1 == *p2) {
201 return (p1 == s->name - 1 ? p2 : NULL);
205 *-----------------------------------------------------------------------
207 * Find a suffix given its name.
210 * The suffix or NULL.
214 *-----------------------------------------------------------------------
217 SuffSuffFind(const char *s)
221 LST_FOREACH(ln, &sufflist) {
222 if (strcmp(s, ((const Suff *)Lst_Datum(ln))->name) == 0)
223 return (Lst_Datum(ln));
229 *-----------------------------------------------------------------------
238 *-----------------------------------------------------------------------
241 SuffTransFind(const char *name)
245 LST_FOREACH(ln, &transforms) {
246 if (strcmp(name, ((const GNode *)Lst_Datum(ln))->name) == 0)
247 return (Lst_Datum(ln));
252 /*********** Maintenance Functions ************/
256 * Keep this function for now until it is clear why a .SUFFIXES: doesn't
257 * actually delete the suffixes but just puts them on the suffClean list.
260 *-----------------------------------------------------------------------
262 * Free up all memory associated with the given suffix structure.
268 * the suffix entry is detroyed
269 *-----------------------------------------------------------------------
282 Lst_Destroy(&s->ref, NOFREE);
283 Lst_Destroy(&s->children, NOFREE);
284 Lst_Destroy(&s->parents, NOFREE);
285 Lst_Destroy(&s->searchPath, Dir_Destroy);
293 *-----------------------------------------------------------------------
295 * Remove the suffix into the list
301 * The reference count for the suffix is decremented
302 *-----------------------------------------------------------------------
305 SuffRemove(Lst *l, Suff *s)
307 LstNode *ln = Lst_Member(l, s);
316 *-----------------------------------------------------------------------
318 * Insert the suffix into the list keeping the list ordered by suffix
325 * The reference count of the suffix is incremented
326 *-----------------------------------------------------------------------
329 SuffInsert(Lst *l, Suff *s)
331 LstNode *ln; /* current element in l we're examining */
332 Suff *s2; /* the suffix descriptor in this element */
335 for (ln = Lst_First(l); ln != NULL; ln = Lst_Succ(ln)) {
337 if (s2->sNum >= s->sNum)
341 DEBUGF(SUFF, ("inserting an empty list?..."));
344 DEBUGF(SUFF, ("inserting %s(%d)...", s->name, s->sNum));
346 DEBUGF(SUFF, ("at end of list\n"));
349 Lst_AtEnd(&s->ref, l);
350 } else if (s2->sNum != s->sNum) {
351 DEBUGF(SUFF, ("before %s(%d)\n", s2->name, s2->sNum));
352 Lst_Insert(l, ln, s);
354 Lst_AtEnd(&s->ref, l);
356 DEBUGF(SUFF, ("already there\n"));
361 *-----------------------------------------------------------------------
362 * Suff_ClearSuffixes --
363 * This is gross. Nuke the list of suffixes but keep all transformation
364 * rules around. The transformation graph is destroyed in this process,
365 * but we leave the list of rules so when a new graph is formed the rules
367 * This function is called from the parse module when a
368 * .SUFFIXES:\n line is encountered.
374 * the sufflist and its graph nodes are destroyed
375 *-----------------------------------------------------------------------
378 Suff_ClearSuffixes(void)
381 Lst_Concat(&suffClean, &sufflist, LST_CONCLINK);
384 suffNull = emptySuff;
386 * Clear suffNull's children list (the other suffixes are built new, but
387 * suffNull is used as is).
388 * NOFREE is used because all suffixes are are on the suffClean list.
389 * suffNull should not have parents.
391 Lst_Destroy(&suffNull->children, NOFREE);
395 *-----------------------------------------------------------------------
396 * SuffParseTransform --
397 * Parse a transformation string to find its two component suffixes.
400 * TRUE if the string is a valid transformation and FALSE otherwise.
403 * The passed pointers are overwritten.
405 *-----------------------------------------------------------------------
408 SuffParseTransform(char *str, Suff **srcPtr, Suff **targPtr)
410 LstNode *srcLn; /* element in suffix list of trans source*/
411 Suff *src; /* Source of transformation */
412 char *str2; /* Extra pointer (maybe target suffix) */
413 LstNode *singleLn; /* element in suffix list of any suffix
414 * that exactly matches str */
415 Suff *single = NULL; /* Source of possible transformation to
421 * Loop looking first for a suffix that matches the start of the
422 * string and then for one that exactly matches the rest of it. If
423 * we can find two that meet these criteria, we've successfully
426 srcLn = Lst_First(&sufflist);
428 /* advance to next possible suffix */
429 while (srcLn != NULL) {
430 src = Lst_Datum(srcLn);
431 if (strncmp(str, src->name, strlen(src->name)) == 0)
433 srcLn = LST_NEXT(srcLn);
438 * Ran out of source suffixes -- no such rule
440 if (singleLn != NULL) {
442 * Not so fast Mr. Smith! There was a suffix
443 * that encompassed the entire string, so we
444 * assume it was a transformation to the null
445 * suffix (thank you POSIX). We still prefer to
446 * find a double rule over a singleton, hence we
447 * leave this check until the end.
449 * XXX: Use emptySuff over suffNull?
457 str2 = str + src->nameLen;
463 *targPtr = SuffSuffFind(str2);
464 if (*targPtr != NULL) {
470 srcLn = LST_NEXT(srcLn);
475 *-----------------------------------------------------------------------
476 * Suff_IsTransform --
477 * Return TRUE if the given string is a transformation rule
481 * TRUE if the string is a concatenation of two known suffixes.
486 *-----------------------------------------------------------------------
489 Suff_IsTransform(char *str)
493 return (SuffParseTransform(str, &src, &targ));
497 *-----------------------------------------------------------------------
498 * Suff_AddTransform --
499 * Add the transformation rule described by the line to the
500 * list of rules and place the transformation itself in the graph
503 * The node created for the transformation in the transforms list
506 * The node is placed on the end of the transforms Lst and links are
507 * made between the two suffixes mentioned in the target name
508 *-----------------------------------------------------------------------
511 Suff_AddTransform(char *line)
513 GNode *gn; /* GNode of transformation rule */
514 Suff *s; /* source suffix */
515 Suff *t; /* target suffix */
517 s = t = NULL; /* silence gcc */
518 gn = SuffTransFind(line);
521 * Make a new graph node for the transformation.
522 * It will be filled in by the Parse module.
524 gn = Targ_NewGN(line);
525 Lst_AtEnd(&transforms, gn);
528 * New specification for transformation rule. Just nuke the
529 * old list of commands so they can be filled in again...
530 * We don't actually free the commands themselves, because a
531 * given command can be attached to several different
534 Lst_Destroy(&gn->commands, NOFREE);
535 Lst_Destroy(&gn->children, NOFREE);
538 gn->type = OP_TRANSFORM;
540 SuffParseTransform(line, &s, &t);
543 * link the two together in the proper relationship and order
545 DEBUGF(SUFF, ("defining transformation from `%s' to `%s'\n",
547 SuffInsert(&t->children, s);
548 SuffInsert(&s->parents, t);
554 *-----------------------------------------------------------------------
555 * Suff_EndTransform --
556 * Handle the finish of a transformation definition, removing the
557 * transformation from the graph if it has neither commands nor
558 * sources. This is called from the Parse module at the end of
559 * a dependency block.
562 * If the node has no commands or children, the children and parents
563 * lists of the affected suffices are altered.
565 *-----------------------------------------------------------------------
568 Suff_EndTransform(const GNode *gn)
572 if (!Lst_IsEmpty(&gn->commands) || !Lst_IsEmpty(&gn->children)) {
573 DEBUGF(SUFF, ("transformation %s complete\n", gn->name));
578 * SuffParseTransform() may fail for special rules which are not
579 * actual transformation rules (e.g., .DEFAULT).
581 if (!SuffParseTransform(gn->name, &s, &t))
584 DEBUGF(SUFF, ("deleting transformation from `%s' to `%s'\n",
588 * Remove the source from the target's children list. We check
589 * for a NULL return to handle a beanhead saying something like
592 * We'll be called twice when the next target is seen, but .c
593 * and .o are only linked once...
595 SuffRemove(&t->children, s);
598 * Remove the target from the source's parents list
600 SuffRemove(&s->parents, t);
604 *-----------------------------------------------------------------------
605 * SuffRebuildGraph --
606 * Called from Suff_AddSuffix via LST_FOREACH to search through the
607 * list of existing transformation rules and rebuild the transformation
608 * graph when it has been destroyed by Suff_ClearSuffixes. If the
609 * given rule is a transformation involving this suffix and another,
610 * existing suffix, the proper relationship is established between
614 * The appropriate links will be made between this suffix and
615 * others if transformation rules exist for it.
617 *-----------------------------------------------------------------------
620 SuffRebuildGraph(const GNode *transform, Suff *s)
626 * First see if it is a transformation from this suffix.
628 if (strncmp(transform->name, s->name, strlen(s->name)) == 0) {
629 cp = transform->name + strlen(s->name);
631 if (cp[0] == '\0') /* null rule */
634 s2 = SuffSuffFind(cp);
637 * Found target. Link in and return, since it can't be
640 SuffInsert(&s2->children, s);
641 SuffInsert(&s->parents, s2);
647 * Not from, maybe to?
649 cp = SuffSuffIsSuffix(s, transform->name);
652 * Null-terminate the source suffix in order to find it.
655 s2 = SuffSuffFind(transform->name);
658 * Replace the start of the target suffix
663 * Found it -- establish the proper relationship
665 SuffInsert(&s->children, s2);
666 SuffInsert(&s2->parents, s);
672 *-----------------------------------------------------------------------
674 * Add the suffix in string to the end of the list of known suffixes.
675 * Should we restructure the suffix graph? Make doesn't...
681 * A GNode is created for the suffix and a Suff structure is created and
682 * added to the suffixes list unless the suffix was already known.
683 *-----------------------------------------------------------------------
686 Suff_AddSuffix(char *str)
688 Suff *s; /* new suffix descriptor */
691 if (SuffSuffFind(str) != NULL)
697 s = emalloc(sizeof(Suff));
699 s->name = estrdup(str);
700 s->nameLen = strlen(s->name);
701 TAILQ_INIT(&s->searchPath);
702 Lst_Init(&s->children);
703 Lst_Init(&s->parents);
709 Lst_AtEnd(&sufflist, s);
712 * Look for any existing transformations from or to this suffix.
713 * XXX: Only do this after a Suff_ClearSuffixes?
715 LST_FOREACH(ln, &transforms)
716 SuffRebuildGraph(Lst_Datum(ln), s);
720 *-----------------------------------------------------------------------
722 * Return the search path for the given suffix, if it's defined.
725 * The searchPath for the desired suffix or NULL if the suffix isn't
730 *-----------------------------------------------------------------------
733 Suff_GetPath(char *sname)
737 s = SuffSuffFind(sname);
740 return (&s->searchPath);
744 *-----------------------------------------------------------------------
746 * Extend the search paths for all suffixes to include the default
753 * The searchPath field of all the suffixes is extended by the
754 * directories in dirSearchPath. If paths were specified for the
755 * ".h" suffix, the directories are stuffed into a global variable
756 * called ".INCLUDES" with each directory preceded by a -I. The same
757 * is done for the ".a" suffix, except the variable is called
758 * ".LIBS" and the flag is -L.
759 *-----------------------------------------------------------------------
767 struct Path inIncludes; /* Cumulative .INCLUDES path */
768 struct Path inLibs; /* Cumulative .LIBS path */
770 TAILQ_INIT(&inIncludes);
773 for (ln = Lst_First(&sufflist); ln != NULL; ln = Lst_Succ(ln)) {
776 if (s->flags & SUFF_INCLUDE) {
777 Path_Concat(&inIncludes, &s->searchPath);
779 #endif /* INCLUDES */
781 if (s->flags & SUFF_LIBRARY) {
782 Path_Concat(&inLibs, &s->searchPath);
784 #endif /* LIBRARIES */
785 Path_Concat(&s->searchPath, &dirSearchPath);
788 ptr = Path_MakeFlags("-I", &inIncludes);
789 Var_SetGlobal(".INCLUDES", ptr);
792 ptr = Path_MakeFlags("-L", &inLibs);
793 Var_SetGlobal(".LIBS", ptr);
796 Path_Clear(&inIncludes);
801 *-----------------------------------------------------------------------
803 * Add the given suffix as a type of file which gets included.
804 * Called from the parse module when a .INCLUDES line is parsed.
805 * The suffix must have already been defined.
811 * The SUFF_INCLUDE bit is set in the suffix's flags field
813 *-----------------------------------------------------------------------
816 Suff_AddInclude(char *sname)
820 if ((s = SuffSuffFind(sname)) != NULL)
821 s->flags |= SUFF_INCLUDE;
825 *-----------------------------------------------------------------------
827 * Add the given suffix as a type of file which is a library.
828 * Called from the parse module when parsing a .LIBS line. The
829 * suffix must have been defined via .SUFFIXES before this is
836 * The SUFF_LIBRARY bit is set in the suffix's flags field
838 *-----------------------------------------------------------------------
841 Suff_AddLib(char *sname)
845 if ((s = SuffSuffFind(sname)) != NULL)
846 s->flags |= SUFF_LIBRARY;
850 * Create a new Src structure
853 SuffSrcCreate(char *file, char *prefix, Suff *suff, Src *parent, GNode *node)
857 s = emalloc(sizeof(*s));
872 /********** Implicit Source Search Functions *********/
875 *-----------------------------------------------------------------------
877 * Add all the children of targ as Src structures to the given list:
878 * Add a suffix as a Src structure to the given list with its parent
879 * being the given Src structure. If the suffix is the null suffix,
880 * the prefix is used unaltered as the file name in the Src structure.
886 * Lots of structures are created and added to the list
887 *-----------------------------------------------------------------------
890 SuffAddLevel(Lst *l, Src *targ)
899 LST_FOREACH(ln, &targ->suff->children) {
900 suff = Lst_Datum(ln);
902 if ((suff->flags & SUFF_NULL) && *suff->name != '\0') {
904 * If the suffix has been marked as the NULL suffix,
905 * also create a Src structure for a file with no suffix
906 * attached. Two birds, and all that...
908 s2 = SuffSrcCreate(estrdup(targ->pref), targ->pref,
914 Lst_AtEnd(&targ->cp, s2);
915 printf("1 add %p %p to %p:", targ, s2, l);
917 printf("%p ", (const void *)Lst_Datum(ln1));
921 s2 = SuffSrcCreate(str_concat(targ->pref, suff->name, 0),
922 targ->pref, suff, targ, NULL);
927 Lst_AtEnd(&targ->cp, s2);
928 printf("2 add %p %p to %p:", targ, s2, l);
930 printf("%p ", (const void *)Lst_Datum(ln1));
937 *----------------------------------------------------------------------
939 * Free all src structures in list that don't have a reference count
940 * XXX this actually frees only the first of these.
943 * True if a src was removed
946 * The memory is free'd.
947 *----------------------------------------------------------------------
950 SuffRemoveSrc(Lst *l)
957 printf("cleaning %lx: ", (unsigned long) l);
959 printf("%p ", (const void *)Lst_Datum(ln));
963 for (ln = Lst_First(l); ln != NULL; ln = ln1) {
966 s = (Src *)Lst_Datum(ln);
967 if (s->children == 0) {
973 LstNode *ln = Lst_Member(&s->parent->cp, s);
975 Lst_Remove(&s->parent->cp, ln);
977 --s->parent->children;
980 printf("free: [l=%p] p=%p %d\n", l, s, s->children);
981 Lst_Destroy(&s->cp, NOFREE);
992 printf("keep: [l=%p] p=%p %d: ", l, s, s->children);
993 LST_FOREACH(tln, &s->cp)
994 printf("%p ", (const void *)Lst_Datum(tln));
1004 *-----------------------------------------------------------------------
1006 * Find the first existing file/target in the list srcs
1009 * The lowest structure in the chain of transformations
1013 *-----------------------------------------------------------------------
1016 SuffFindThem(Lst *srcs, Lst *slst)
1018 Src *s; /* current Src */
1019 Src *rs; /* returned Src */
1024 while (!Lst_IsEmpty (srcs)) {
1025 s = Lst_DeQueue(srcs);
1027 DEBUGF(SUFF, ("\ttrying %s...", s->file));
1030 * A file is considered to exist if either a node exists in the
1031 * graph for it or the file actually exists.
1033 if (Targ_FindNode(s->file, TARG_NOCREATE) != NULL) {
1035 printf("remove %p from %p\n", s, srcs);
1041 if ((ptr = Path_FindFile(s->file,
1042 &s->suff->searchPath)) != NULL) {
1045 printf("remove %p from %p\n", s, srcs);
1051 DEBUGF(SUFF, ("not there\n"));
1053 SuffAddLevel(srcs, s);
1058 DEBUGF(SUFF, ("got it\n"));
1064 *-----------------------------------------------------------------------
1066 * See if any of the children of the target in the Src structure is
1067 * one from which the target can be transformed. If there is one,
1068 * a Src structure is put together for it and returned.
1071 * The Src structure of the "winning" child, or NULL if no such beast.
1074 * A Src structure may be allocated.
1076 *-----------------------------------------------------------------------
1079 SuffFindCmds(Src *targ, Lst *slst)
1081 LstNode *ln; /* General-purpose list node */
1082 GNode *t; /* Target GNode */
1083 GNode *s; /* Source GNode */
1084 int prefLen;/* The length of the defined prefix */
1085 Suff *suff; /* Suffix on matching beastie */
1086 Src *ret; /* Return value */
1090 prefLen = strlen(targ->pref);
1092 for (ln = Lst_First(&t->children); ln != NULL; ln = Lst_Succ(ln)) {
1095 cp = strrchr(s->name, '/');
1101 if (strncmp(cp, targ->pref, prefLen) == 0) {
1103 * The node matches the prefix ok, see if it has
1106 suff = SuffSuffFind(&cp[prefLen]);
1109 * It even has a known suffix, see if there's
1110 * a transformation defined between the node's
1111 * suffix and the target's suffix.
1113 * XXX: Handle multi-stage transformations
1116 if (Lst_Member(&suff->parents,
1117 targ->suff) != NULL) {
1119 * Hot Damn! Create a new Src structure
1120 * to describe this transformation
1121 * (making sure to duplicate the
1122 * source node's name so Suff_FindDeps
1123 * can free it again (ick)), and return
1124 * the new structure.
1126 ret = SuffSrcCreate(estrdup(s->name),
1127 targ->pref, suff, targ, s);
1129 targ->children += 1;
1131 printf("3 add %p %p\n", &targ, ret);
1132 Lst_AtEnd(&targ->cp, ret);
1134 Lst_AtEnd(slst, ret);
1135 DEBUGF(SUFF, ("\tusing existing source "
1146 * The child node contains variable references. Expand them and return
1147 * a list of expansions.
1150 SuffExpandVariables(GNode *parent, GNode *child, Lst *members)
1158 DEBUGF(SUFF, ("Expanding \"%s\"...", child->name));
1159 buf = Var_Subst(child->name, parent, TRUE);
1162 if (child->type & OP_ARCHV) {
1164 * Node was an archive(member) target, so we
1165 * want to call on the Arch module to find the
1166 * nodes for us, expanding variables in the
1169 Arch_ParseArchive(&cp, members, parent);
1170 Buf_Destroy(buf, TRUE);
1174 * Break the result into a vector of strings whose nodes we can find,
1175 * then add those nodes to the members list. Unfortunately, we can't use
1176 * brk_string b/c it doesn't understand about variable specifications
1177 * with spaces in them... XXX
1179 for (start = cp; *start == ' ' || *start == '\t'; start++)
1182 for (cp = start; *cp != '\0'; cp++) {
1183 if (*cp == ' ' || *cp == '\t') {
1185 * White-space -- terminate element, find the node,
1186 * add it, skip any further spaces.
1189 Lst_AtEnd(members, Targ_FindNode(start, TARG_CREATE));
1191 while (*cp == ' ' || *cp == '\t') {
1195 * Adjust cp for increment at
1196 * start of loop, but set start
1197 * to first non-space.
1201 } else if (*cp == '$') {
1203 * Start of a variable spec -- contact variable module
1204 * to find the end so we can skip over it.
1210 junk = Var_Parse(cp, parent, TRUE, &len, &doFree);
1211 if (junk != var_Error) {
1218 } else if (*cp == '\\' && *cp != '\0') {
1220 * Escaped something -- skip over it
1228 * Stuff left over -- add it to the
1231 Lst_AtEnd(members, Targ_FindNode(start, TARG_CREATE));
1234 Buf_Destroy(buf, TRUE);
1238 * The child node contains wildcards. Expand them and return a list of
1242 SuffExpandWildcards(GNode *child, Lst *members)
1245 Lst exp; /* List of expansions */
1247 struct Path *path; /* Search path along which to expand */
1252 * Find a path along which to expand the word.
1254 * If the word has a known suffix, use that path.
1255 * If it has no known suffix and we're allowed to use the null
1256 * suffix, use its path.
1257 * Else use the default system search path.
1259 LST_FOREACH(ln, &sufflist) {
1260 if (SuffSuffIsSuffix(Lst_Datum(ln), child->name) != NULL)
1264 DEBUGF(SUFF, ("Wildcard expanding \"%s\"...", child->name));
1267 Suff *s = Lst_Datum(ln);
1269 DEBUGF(SUFF, ("suffix is \"%s\"...", s->name));
1270 path = &s->searchPath;
1273 * Use default search path
1275 path = &dirSearchPath;
1279 * Expand the word along the chosen path
1282 Path_Expand(child->name, path, &exp);
1284 while (!Lst_IsEmpty(&exp)) {
1286 * Fetch next expansion off the list and find its GNode
1288 cp = Lst_DeQueue(&exp);
1290 DEBUGF(SUFF, ("%s...", cp));
1291 Lst_AtEnd(members, Targ_FindNode(cp, TARG_CREATE));
1296 *-----------------------------------------------------------------------
1297 * SuffExpandChildren --
1298 * Expand the names of any children of a given node that contain
1299 * variable invocations or file wildcards into actual targets.
1305 * The expanded node is removed from the parent's list of children,
1306 * and the parent's unmade counter is decremented, but other nodes
1309 *-----------------------------------------------------------------------
1312 SuffExpandChildren(GNode *parent, LstNode *current)
1314 GNode *cchild; /* current child */
1316 LstNode *prev; /* node after which to append new source */
1317 Lst members; /* expanded nodes */
1319 if (current == NULL) {
1320 /* start from begin of parent's children list */
1321 current = Lst_First(&parent->children);
1324 while (current != NULL) {
1325 cchild = Lst_Datum(current);
1328 * First do variable expansion -- this takes precedence over
1329 * wildcard expansion. If the result contains wildcards, they'll
1330 * be gotten to later since the resulting words are tacked
1331 * instead of the current child onto the children list.
1333 * XXXHB what if cchild contains lib.a(t1.o t2.o t3.o) but
1336 if (strchr(cchild->name, '$') != NULL) {
1337 SuffExpandVariables(parent, cchild, &members);
1339 } else if (Dir_HasWildcards(cchild->name)) {
1340 SuffExpandWildcards(cchild, &members);
1343 /* nothing special just advance to next child */
1344 current = LST_NEXT(current);
1349 * New nodes effectively take the place of the child,
1350 * so place them after the child
1355 * Add all new elements to the parent node if they aren't
1356 * already children of it.
1358 while(!Lst_IsEmpty(&members)) {
1359 gn = Lst_DeQueue(&members);
1361 DEBUGF(SUFF, ("%s...", gn->name));
1362 if (Lst_Member(&parent->children, gn) == NULL) {
1363 Lst_Append(&parent->children, prev, gn);
1364 prev = Lst_Succ(prev);
1365 Lst_AtEnd(&gn->parents, parent);
1371 * Now the source is expanded, remove it from the list
1372 * of children to keep it from being processed.
1373 * Advance to the next child.
1376 current = LST_NEXT(current);
1379 Lst_Remove(&parent->children, prev);
1380 DEBUGF(SUFF, ("\n"));
1385 *-----------------------------------------------------------------------
1386 * SuffApplyTransform --
1387 * Apply a transformation rule, given the source and target nodes
1391 * TRUE if successful, FALSE if not.
1394 * The source and target are linked and the commands from the
1395 * transformation are added to the target node's commands list.
1396 * All attributes but OP_DEPMASK and OP_TRANSFORM are applied
1397 * to the target. The target also inherits all the sources for
1398 * the transformation rule.
1400 *-----------------------------------------------------------------------
1403 SuffApplyTransform(GNode *tGn, GNode *sGn, Suff *t, Suff *s)
1405 LstNode *ln; /* General node */
1406 char *tname; /* Name of transformation rule */
1407 GNode *gn; /* Node for same */
1409 if (Lst_Member(&tGn->children, sGn) == NULL) {
1411 * Not already linked, so form the proper links between the
1412 * target and source.
1414 Lst_AtEnd(&tGn->children, sGn);
1415 Lst_AtEnd(&sGn->parents, tGn);
1419 if ((sGn->type & OP_OPMASK) == OP_DOUBLEDEP) {
1421 * When a :: node is used as the implied source of a node,
1422 * we have to link all its cohorts in as sources as well. Only
1423 * the initial sGn gets the target in its iParents list, however
1424 * as that will be sufficient to get the .IMPSRC variable set
1427 for (ln = Lst_First(&sGn->cohorts); ln != NULL;
1428 ln = Lst_Succ(ln)) {
1431 if (Lst_Member(&tGn->children, gn) == NULL) {
1433 * Not already linked, so form the proper
1434 * links between the target and source.
1436 Lst_AtEnd(&tGn->children, gn);
1437 Lst_AtEnd(&gn->parents, tGn);
1443 * Locate the transformation rule itself
1445 tname = str_concat(s->name, t->name, 0);
1446 gn = SuffTransFind(tname);
1451 * Not really such a transformation rule (can happen when we're
1452 * called to link an OP_MEMBER and OP_ARCHV node), so return
1458 DEBUGF(SUFF, ("\tapplying %s -> %s to \"%s\"\n",
1459 s->name, t->name, tGn->name));
1462 * Record last child for expansion purposes
1464 ln = Lst_Last(&tGn->children);
1467 * Pass the buck to Make_HandleUse to apply the rule
1469 Make_HandleUse(gn, tGn);
1472 * Deal with wildcards and variables in any acquired sources
1476 SuffExpandChildren(tGn, ln);
1480 * Keep track of another parent to which this beast is transformed so
1481 * the .IMPSRC variable can be set correctly for the parent.
1483 Lst_AtEnd(&sGn->iParents, tGn);
1490 *-----------------------------------------------------------------------
1491 * SuffFindArchiveDeps --
1492 * Locate dependencies for an OP_ARCHV node.
1498 * Same as Suff_FindDeps
1500 *-----------------------------------------------------------------------
1503 SuffFindArchiveDeps(GNode *gn, Lst *slst)
1505 char *eoarch; /* End of archive portion */
1506 char *eoname; /* End of member portion */
1507 char *name; /* Start of member's name */
1508 GNode *mem; /* Node for member */
1509 Suff *ms; /* Suffix descriptor for member */
1511 static const char *copy[] = {
1512 TARGET, /* Must be first */
1513 PREFIX, /* Must be second */
1517 * The node is an archive(member) pair. so we must find a
1518 * suffix for both of them.
1520 eoarch = strchr(gn->name, '(');
1521 eoname = strchr(eoarch, ')');
1523 *eoname = '\0'; /* Nuke parentheses during suffix search */
1524 *eoarch = '\0'; /* So a suffix can be found */
1529 * To simplify things, call Suff_FindDeps recursively on the member now,
1530 * so we can simply compare the member's .PREFIX and .TARGET variables
1531 * to locate its suffix. This allows us to figure out the suffix to
1532 * use for the archive without having to do a quadratic search over the
1533 * suffix list, backtracking for each one...
1535 mem = Targ_FindNode(name, TARG_CREATE);
1536 SuffFindDeps(mem, slst);
1539 * Create the link between the two nodes right off
1541 if (Lst_Member(&gn->children, mem) == NULL) {
1542 Lst_AtEnd(&gn->children, mem);
1543 Lst_AtEnd(&mem->parents, gn);
1548 * Copy in the variables from the member node to this one.
1550 Var_Set(copy[1], Var_Value(copy[1], mem), gn);
1551 Var_Set(copy[0], Var_Value(copy[0], mem), gn);
1556 * Didn't know what it was -- use .NULL suffix if not in
1559 DEBUGF(SUFF, ("using null suffix\n"));
1564 * Set the other two local variables required for this target.
1566 Var_Set(MEMBER, name, gn);
1567 Var_Set(ARCHIVE, gn->name, gn);
1571 * Member has a known suffix, so look for a transformation rule
1572 * from it to a possible suffix of the archive. Rather than
1573 * searching through the entire list, we just look at suffixes
1574 * to which the member's suffix may be transformed...
1579 * Use first matching suffix...
1581 LST_FOREACH(ln, &ms->parents) {
1582 if (SuffSuffIsSuffix(Lst_Datum(ln), gn->name) != NULL)
1588 * Got one -- apply it
1590 if (!SuffApplyTransform(gn, mem, Lst_Datum(ln), ms)) {
1591 DEBUGF(SUFF, ("\tNo transformation from "
1592 "%s -> %s\n", ms->name,
1593 ((Suff *)Lst_Datum(ln))->name));
1599 * Replace the opening and closing parens now we've no need
1600 * of the separate pieces.
1606 * Pretend gn appeared to the left of a dependency operator so
1607 * the user needn't provide a transformation from the member to the
1610 if (OP_NOP(gn->type)) {
1611 gn->type |= OP_DEPENDS;
1615 * Flag the member as such so we remember to look in the archive for
1616 * its modification time.
1618 mem->type |= OP_MEMBER;
1622 *-----------------------------------------------------------------------
1623 * SuffFindNormalDeps --
1624 * Locate implicit dependencies for regular targets.
1630 * Same as Suff_FindDeps...
1632 *-----------------------------------------------------------------------
1635 SuffFindNormalDeps(GNode *gn, Lst *slst)
1637 char *eoname; /* End of name */
1638 char *sopref; /* Start of prefix */
1639 LstNode *ln; /* Next suffix node to check */
1640 Lst srcs; /* List of sources at which to look */
1641 Lst targs; /* List of targets to which things can be
1642 * transformed. They all have the same file,
1643 * but different suff and pref fields */
1644 Src *bottom; /* Start of found transformation path */
1645 Src *src; /* General Src pointer */
1646 char *pref; /* Prefix to use */
1647 Src *targ; /* General Src target pointer */
1649 eoname = gn->name + strlen(gn->name);
1653 * Begin at the beginning...
1655 ln = Lst_First(&sufflist);
1660 * We're caught in a catch-22 here. On the one hand, we want to use any
1661 * transformation implied by the target's sources, but we can't examine
1662 * the sources until we've expanded any variables/wildcards they may
1663 * hold, and we can't do that until we've set up the target's local
1664 * variables and we can't do that until we know what the proper suffix
1665 * for the target is (in case there are two suffixes one of which is a
1666 * suffix of the other) and we can't know that until we've found its
1667 * implied source, which we may not want to use if there's an existing
1668 * source that implies a different transformation.
1670 * In an attempt to get around this, which may not work all the time,
1671 * but should work most of the time, we look for implied sources first,
1672 * checking transformations to all possible suffixes of the target,
1673 * use what we find to set the target's local variables, expand the
1674 * children, then look for any overriding transformations they imply.
1675 * Should we find one, we discard the one we found before.
1678 while (ln != NULL) {
1680 * Look for next possible suffix...
1682 while (ln != NULL) {
1683 if (SuffSuffIsSuffix(Lst_Datum(ln), gn->name) != NULL)
1689 int prefLen; /* Length of the prefix */
1693 * Allocate a Src structure to which things can be
1696 target = SuffSrcCreate(estrdup(gn->name), NULL,
1697 Lst_Datum(ln), NULL, gn);
1698 target->suff->refCount++;
1701 * Allocate room for the prefix, whose end is found
1702 * by subtracting the length of the suffix from
1703 * the end of the name.
1705 prefLen = (eoname - target->suff->nameLen) - sopref;
1706 assert(prefLen >= 0);
1707 target->pref = emalloc(prefLen + 1);
1708 memcpy(target->pref, sopref, prefLen);
1709 target->pref[prefLen] = '\0';
1712 * Add nodes from which the target can be made
1714 SuffAddLevel(&srcs, target);
1717 * Record the target so we can nuke it
1719 Lst_AtEnd(&targs, target);
1722 * Search from this suffix's successor...
1729 * Handle target of unknown suffix...
1731 if (Lst_IsEmpty(&targs) && suffNull != NULL) {
1732 DEBUGF(SUFF, ("\tNo known suffix on %s. Using .NULL suffix\n",
1735 targ = SuffSrcCreate(estrdup(gn->name), estrdup(sopref),
1736 suffNull, NULL, gn);
1737 targ->suff->refCount++;
1740 * Only use the default suffix rules if we don't have commands
1741 * or dependencies defined for this gnode
1743 if (Lst_IsEmpty(&gn->commands) && Lst_IsEmpty(&gn->children))
1744 SuffAddLevel(&srcs, targ);
1746 DEBUGF(SUFF, ("not "));
1749 DEBUGF(SUFF, ("adding suffix rules\n"));
1751 Lst_AtEnd(&targs, targ);
1755 * Using the list of possible sources built up from the target
1756 * suffix(es), try and find an existing file/target that matches.
1758 bottom = SuffFindThem(&srcs, slst);
1760 if (bottom == NULL) {
1762 * No known transformations -- use the first suffix found for
1763 * setting the local variables.
1765 if (!Lst_IsEmpty(&targs)) {
1766 targ = Lst_Datum(Lst_First(&targs));
1772 * Work up the transformation path to find the suffix of the
1773 * target to which the transformation was made.
1775 for (targ = bottom; targ->parent != NULL; targ = targ->parent)
1780 * The .TARGET variable we always set to be the name at this point,
1781 * since it's only set to the path if the thing is only a source and
1782 * if it's only a source, it doesn't matter what we put here as far
1783 * as expanding sources is concerned, since it has none...
1785 Var_Set(TARGET, gn->name, gn);
1787 pref = (targ != NULL) ? targ->pref : gn->name;
1788 Var_Set(PREFIX, pref, gn);
1791 * Now we've got the important local variables set, expand any sources
1792 * that still contain variables or wildcards in their names.
1794 SuffExpandChildren(gn, NULL);
1797 DEBUGF(SUFF, ("\tNo valid suffix on %s\n", gn->name));
1801 * Deal with finding the thing on the default search path if the
1802 * node is only a source (not on the lhs of a dependency
1803 * operator or [XXX] it has neither children or commands).
1805 if (OP_NOP(gn->type) || (Lst_IsEmpty(&gn->children) &&
1806 Lst_IsEmpty(&gn->commands))) {
1807 gn->path = Path_FindFile(gn->name,
1808 (targ == NULL ? &dirSearchPath :
1809 &targ->suff->searchPath));
1810 if (gn->path != NULL) {
1812 Var_Set(TARGET, gn->path, gn);
1816 * Suffix known for the thing -- trim
1817 * the suffix off the path to form the
1818 * proper .PREFIX variable.
1820 int savep = strlen(gn->path) -
1821 targ->suff->nameLen;
1825 gn->suffix->refCount--;
1826 gn->suffix = targ->suff;
1827 gn->suffix->refCount++;
1829 savec = gn->path[savep];
1830 gn->path[savep] = '\0';
1832 if ((ptr = strrchr(gn->path, '/')) != NULL)
1837 Var_Set(PREFIX, ptr, gn);
1839 gn->path[savep] = savec;
1842 * The .PREFIX gets the full path if
1843 * the target has no known suffix.
1846 gn->suffix->refCount--;
1849 if ((ptr = strrchr(gn->path, '/')) != NULL)
1854 Var_Set(PREFIX, ptr, gn);
1859 * Not appropriate to search for the thing -- set the
1860 * path to be the name so Dir_MTime won't go
1861 * grovelling for it.
1864 gn->suffix->refCount--;
1865 gn->suffix = (targ == NULL) ? NULL : targ->suff;
1867 gn->suffix->refCount++;
1869 gn->path = estrdup(gn->name);
1876 * If the suffix indicates that the target is a library, mark that in
1877 * the node's type field.
1879 if (targ->suff->flags & SUFF_LIBRARY) {
1884 * Check for overriding transformation rule implied by sources
1886 if (!Lst_IsEmpty(&gn->children)) {
1887 src = SuffFindCmds(targ, slst);
1891 * Free up all the Src structures in the
1892 * transformation path up to, but not including,
1895 while (bottom && bottom->parent != NULL) {
1896 if (Lst_Member(slst, bottom) == NULL) {
1897 Lst_AtEnd(slst, bottom);
1899 bottom = bottom->parent;
1905 if (bottom == NULL) {
1907 * No idea from where it can come -- return now.
1913 * We now have a list of Src structures headed by 'bottom' and linked
1914 * via their 'parent' pointers. What we do next is create links between
1915 * source and target nodes (which may or may not have been created)
1916 * and set the necessary local variables in each target. The
1917 * commands for each target are set from the commands of the
1918 * transformation rule used to get from the src suffix to the targ
1919 * suffix. Note that this causes the commands list of the original
1920 * node, gn, to be replaced by the commands of the final
1921 * transformation rule. Also, the unmade field of gn is incremented.
1924 if (bottom->node == NULL) {
1925 bottom->node = Targ_FindNode(bottom->file, TARG_CREATE);
1928 for (src = bottom; src->parent != NULL; src = src->parent) {
1931 if (src->node->suffix)
1932 src->node->suffix->refCount--;
1933 src->node->suffix = src->suff;
1934 src->node->suffix->refCount++;
1936 if (targ->node == NULL) {
1937 targ->node = Targ_FindNode(targ->file, TARG_CREATE);
1940 SuffApplyTransform(targ->node, src->node,
1941 targ->suff, src->suff);
1943 if (targ->node != gn) {
1945 * Finish off the dependency-search process for any
1946 * nodes between bottom and gn (no point in questing
1947 * around the filesystem for their implicit source
1948 * when it's already known). Note that the node can't
1949 * have any sources that need expanding, since
1950 * SuffFindThem will stop on an existing
1951 * node, so all we need to do is set the standard and
1952 * System V variables.
1954 targ->node->type |= OP_DEPS_FOUND;
1956 Var_Set(PREFIX, targ->pref, targ->node);
1957 Var_Set(TARGET, targ->node->name, targ->node);
1962 gn->suffix->refCount--;
1963 gn->suffix = src->suff;
1964 gn->suffix->refCount++;
1967 * So Dir_MTime doesn't go questing for it...
1970 gn->path = estrdup(gn->name);
1973 * Nuke the transformation path and the Src structures left over in the
1978 if (Lst_Member(slst, bottom) == NULL)
1979 Lst_AtEnd(slst, bottom);
1981 while (SuffRemoveSrc(&srcs) || SuffRemoveSrc(&targs))
1984 Lst_Concat(slst, &srcs, LST_CONCLINK);
1985 Lst_Concat(slst, &targs, LST_CONCLINK);
1989 *-----------------------------------------------------------------------
1991 * Find implicit sources for the target described by the graph node
1998 * Nodes are added to the graph below the passed-in node. The nodes
1999 * are marked to have their IMPSRC variable filled in. The
2000 * PREFIX variable is set for the given node and all its
2004 * The path found by this target is the shortest path in the
2005 * transformation graph, which may pass through non-existent targets,
2006 * to an existing target. The search continues on all paths from the
2007 * root suffix until a file is found. I.e. if there's a path
2008 * .o -> .c -> .l -> .l,v from the root and the .l,v file exists but
2009 * the .c and .l files don't, the search will branch out in
2010 * all directions from .o and again from all the nodes on the
2011 * next level until the .l,v node is encountered.
2013 *-----------------------------------------------------------------------
2016 Suff_FindDeps(GNode *gn)
2019 SuffFindDeps(gn, &srclist);
2020 while (SuffRemoveSrc(&srclist))
2026 SuffFindDeps(GNode *gn, Lst *slst)
2029 if (gn->type & OP_DEPS_FOUND) {
2031 * If dependencies already found, no need to do it again...
2035 gn->type |= OP_DEPS_FOUND;
2038 DEBUGF(SUFF, ("SuffFindDeps (%s)\n", gn->name));
2040 if (gn->type & OP_ARCHV) {
2041 SuffFindArchiveDeps(gn, slst);
2043 } else if (gn->type & OP_LIB) {
2045 * If the node is a library, it is the arch module's job to find
2046 * it and set the TARGET variable accordingly. We merely provide
2047 * the search path, assuming all libraries end in ".a" (if the
2048 * suffix hasn't been defined, there's nothing we can do for it,
2049 * so we just set the TARGET variable to the node's name in order
2050 * to give it a value).
2054 s = SuffSuffFind(LIBSUFF);
2056 gn->suffix->refCount--;
2059 gn->suffix->refCount++;
2060 Arch_FindLib(gn, &s->searchPath);
2063 Var_Set(TARGET, gn->name, gn);
2067 * Because a library (-lfoo) target doesn't follow the standard
2068 * filesystem conventions, we don't set the regular variables for
2069 * the thing. .PREFIX is simply made empty...
2071 Var_Set(PREFIX, "", gn);
2074 SuffFindNormalDeps(gn, slst);
2079 *-----------------------------------------------------------------------
2081 * Define which suffix is the null suffix.
2087 * 'suffNull' is altered.
2090 * Need to handle the changing of the null suffix gracefully so the
2091 * old transformation rules don't just go away.
2093 *-----------------------------------------------------------------------
2096 Suff_SetNull(char *name)
2100 if ((s = SuffSuffFind(name)) == NULL) {
2101 Parse_Error(PARSE_WARNING, "Desired null suffix %s "
2102 "not defined.", name);
2106 if (suffNull != NULL) {
2107 suffNull->flags &= ~SUFF_NULL;
2109 s->flags |= SUFF_NULL;
2112 * XXX: Here's where the transformation mangling
2119 *-----------------------------------------------------------------------
2121 * Initialize suffixes module
2128 *-----------------------------------------------------------------------
2136 * Create null suffix for single-suffix rules (POSIX). The thing doesn't
2137 * actually go on the suffix list or everyone will think that's its
2140 emptySuff = suffNull = emalloc(sizeof(Suff));
2142 suffNull->name = estrdup("");
2143 suffNull->nameLen = 0;
2144 TAILQ_INIT(&suffNull->searchPath);
2145 Path_Concat(&suffNull->searchPath, &dirSearchPath);
2146 Lst_Init(&suffNull->children);
2147 Lst_Init(&suffNull->parents);
2148 Lst_Init(&suffNull->ref);
2149 suffNull->sNum = sNum++;
2150 suffNull->flags = SUFF_NULL;
2151 suffNull->refCount = 1;
2154 /********************* DEBUGGING FUNCTIONS **********************/
2164 static const struct flag2str suff_flags[] = {
2165 { SUFF_INCLUDE, "INCLUDE" },
2166 { SUFF_LIBRARY, "LIBRARY" },
2167 { SUFF_NULL, "NULL" },
2171 printf("#*** Suffixes:\n");
2172 LST_FOREACH(ln, &sufflist) {
2174 printf("# `%s' [%d] ", s->name, s->refCount);
2176 if (s->flags != 0) {
2178 print_flags(stdout, suff_flags, s->flags, 1);
2181 printf("\n#\tTo: ");
2182 LST_FOREACH(tln, &s->parents)
2183 printf("`%s' ", ((const Suff *)Lst_Datum(tln))->name);
2185 printf("\n#\tFrom: ");
2186 LST_FOREACH(tln, &s->children)
2187 printf("`%s' ", ((const Suff *)Lst_Datum(tln))->name);
2189 printf("\n#\tSearch Path: ");
2190 Path_Print(&s->searchPath);
2195 printf("#*** Transformations:\n");
2196 LST_FOREACH(ln, &transforms) {
2198 printf("%-16s: ", gn->name);
2199 Targ_PrintType(gn->type);
2201 LST_FOREACH(tln, &gn->commands)
2202 printf("\t%s\n", (const char *)Lst_Datum(tln));