Merge in some changes that Harti made to patch 7.49
[dragonfly.git] / usr.bin / make / suff.c
1 /*-
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
5  * All rights reserved.
6  *
7  * This code is derived from software contributed to Berkeley by
8  * Adam de Boor.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  * 3. 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.
25  *
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
36  * SUCH DAMAGE.
37  *
38  * @(#)suff.c   8.4 (Berkeley) 3/21/94
39  * $FreeBSD: src/usr.bin/make/suff.c,v 1.43 2005/02/04 13:23:39 harti Exp $
40  * $DragonFly: src/usr.bin/make/suff.c,v 1.35 2005/02/28 12:00:10 okumoto Exp $
41  */
42
43 /*-
44  * suff.c --
45  *      Functions to maintain suffix lists and find implicit dependents
46  *      using suffix transformation rules
47  *
48  * Interface:
49  *      Suff_Init               Initialize all things to do with suffixes.
50  *
51  *      Suff_DoPaths            This function is used to make life easier
52  *                              when searching for a file according to its
53  *                              suffix. It takes the global search path,
54  *                              as defined using the .PATH: target, and appends
55  *                              its directories to the path of each of the
56  *                              defined suffixes, as specified using
57  *                              .PATH<suffix>: targets. In addition, all
58  *                              directories given for suffixes labeled as
59  *                              include files or libraries, using the .INCLUDES
60  *                              or .LIBS targets, are played with using
61  *                              Dir_MakeFlags to create the .INCLUDES and
62  *                              .LIBS global variables.
63  *
64  *      Suff_ClearSuffixes      Clear out all the suffixes and defined
65  *                              transformations.
66  *
67  *      Suff_IsTransform        Return TRUE if the passed string is the lhs
68  *                              of a transformation rule.
69  *
70  *      Suff_AddSuffix          Add the passed string as another known suffix.
71  *
72  *      Suff_GetPath            Return the search path for the given suffix.
73  *
74  *      Suff_AddInclude         Mark the given suffix as denoting an include
75  *                              file.
76  *
77  *      Suff_AddLib             Mark the given suffix as denoting a library.
78  *
79  *      Suff_AddTransform       Add another transformation to the suffix
80  *                              graph. Returns  GNode suitable for framing, I
81  *                              mean, tacking commands, attributes, etc. on.
82  *
83  *      Suff_SetNull            Define the suffix to consider the suffix of
84  *                              any file that doesn't have a known one.
85  *
86  *      Suff_FindDeps           Find implicit sources for and the location of
87  *                              a target based on its suffix. Returns the
88  *                              bottom-most node added to the graph or NULL
89  *                              if the target had no implicit sources.
90  */
91
92 #include <string.h>
93 #include <stdlib.h>
94
95 #include "arch.h"
96 #include "buf.h"
97 #include "config.h"
98 #include "dir.h"
99 #include "globals.h"
100 #include "GNode.h"
101 #include "lst.h"
102 #include "make.h"
103 #include "parse.h"
104 #include "str.h"
105 #include "suff.h"
106 #include "targ.h"
107 #include "util.h"
108 #include "var.h"
109
110 /* Lst of suffixes */
111 static Lst sufflist = Lst_Initializer(sufflist);
112
113 /* Lst of suffixes to be cleaned */
114 static Lst suffClean = Lst_Initializer(suffClean);
115
116 /* Lst of sources */
117 static Lst srclist = Lst_Initializer(srclist);
118
119 /* Lst of transformation rules */
120 static Lst transforms = Lst_Initializer(transforms);
121
122 static int        sNum = 0;     /* Counter for assigning suffix numbers */
123
124 /*
125  * Structure describing an individual suffix.
126  */
127 typedef struct _Suff {
128     char         *name;         /* The suffix itself */
129     int          nameLen;       /* Length of the suffix */
130     short        flags;         /* Type of suffix */
131 #define SUFF_INCLUDE      0x01      /* One which is #include'd */
132 #define SUFF_LIBRARY      0x02      /* One which contains a library */
133 #define SUFF_NULL         0x04      /* The empty suffix */
134     Lst          searchPath;    /* The path along which files of this suffix
135                                  * may be found */
136     int          sNum;          /* The suffix number */
137     int          refCount;      /* Reference count of list membership */
138     Lst          parents;       /* Suffixes we have a transformation to */
139     Lst          children;      /* Suffixes we have a transformation from */
140     Lst          ref;           /* List of lists this suffix is referenced */
141 } Suff;
142
143 /*
144  * Structure used in the search for implied sources.
145  */
146 typedef struct _Src {
147     char            *file;      /* The file to look for */
148     char            *pref;      /* Prefix from which file was formed */
149     Suff            *suff;      /* The suffix on the file */
150     struct _Src     *parent;    /* The Src for which this is a source */
151     GNode           *node;      /* The node describing the file */
152     int             children;   /* Count of existing children (so we don't free
153                                  * this thing too early or never nuke it) */
154 #ifdef DEBUG_SRC
155     Lst             cp;         /* Debug; children list */
156 #endif
157 } Src;
158
159 /*
160  * A structure for passing more than one argument to the Lst-library-invoked
161  * function...
162  */
163 typedef struct {
164     Lst            *l;
165     Src            *s;
166 } LstSrc;
167
168 static Suff         *suffNull;  /* The NULL suffix for this run */
169 static Suff         *emptySuff; /* The empty suffix required for POSIX
170                                  * single-suffix transformation rules */
171
172
173 static void SuffInsert(Lst *, Suff *);
174 static void SuffRemove(Lst *, Suff *);
175 static Boolean SuffParseTransform(char *, Suff **, Suff **);
176 static int SuffRebuildGraph(void *, void *);
177 static int SuffAddSrc(void *, void *);
178 static int SuffRemoveSrc(Lst *);
179 static void SuffAddLevel(Lst *, Src *);
180 static Src *SuffFindThem(Lst *, Lst *);
181 static Src *SuffFindCmds(Src *, Lst *);
182 static int SuffExpandChildren(void *, void *);
183 static Boolean SuffApplyTransform(GNode *, GNode *, Suff *, Suff *);
184 static void SuffFindDeps(GNode *, Lst *);
185 static void SuffFindArchiveDeps(GNode *, Lst *);
186 static void SuffFindNormalDeps(GNode *, Lst *);
187 static int SuffPrintName(void *, void *);
188 static int SuffPrintSuff(void *, void *);
189 static int SuffPrintTrans(void *, void *);
190 #ifdef DEBUG_SRC
191 static int PrintAddr(void *, void *);
192 #endif /* DEBUG_SRC */
193
194
195         /*************** Lst Predicates ****************/
196 /*-
197  *-----------------------------------------------------------------------
198  * SuffStrIsPrefix  --
199  *      See if pref is a prefix of str.
200  *
201  * Results:
202  *      NULL if it ain't, pointer to character in str after prefix if so
203  *
204  * Side Effects:
205  *      None
206  *-----------------------------------------------------------------------
207  */
208 static char *
209 SuffStrIsPrefix(const char *pref, char *str)
210 {
211
212     while (*str && *pref == *str) {
213         pref++;
214         str++;
215     }
216
217     return (*pref ? NULL : str);
218 }
219
220 /*-
221  *-----------------------------------------------------------------------
222  * SuffSuffIsSuffix  --
223  *      See if suff is a suffix of str. Str should point to THE END of the
224  *      string to check. (THE END == the null byte)
225  *
226  * Results:
227  *      NULL if it ain't, pointer to character in str before suffix if
228  *      it is.
229  *
230  * Side Effects:
231  *      None
232  *-----------------------------------------------------------------------
233  */
234 static char *
235 SuffSuffIsSuffix(const Suff *s, char *str)
236 {
237     const char     *p1;         /* Pointer into suffix name */
238     char           *p2;         /* Pointer into string being examined */
239
240     p1 = s->name + s->nameLen;
241     p2 = str;
242
243     while (p1 >= s->name && *p1 == *p2) {
244         p1--;
245         p2--;
246     }
247
248     return (p1 == s->name - 1 ? p2 : NULL);
249 }
250
251 /*-
252  *-----------------------------------------------------------------------
253  * SuffSuffIsSuffixP --
254  *      Predicate form of SuffSuffIsSuffix. Passed as the callback function
255  *      to Lst_Find.
256  *
257  * Results:
258  *      0 if the suffix is the one desired, non-zero if not.
259  *
260  * Side Effects:
261  *      None.
262  *
263  * XXX use the function above once constification is complete.
264  *-----------------------------------------------------------------------
265  */
266 static int
267 SuffSuffIsSuffixP(const void *is, const void *str)
268 {
269     const Suff *s = is;
270     const char *p1;             /* Pointer into suffix name */
271     const char *p2 = str;       /* Pointer into string being examined */
272
273     p1 = s->name + s->nameLen;
274
275     while (p1 >= s->name && *p1 == *p2) {
276         p1--;
277         p2--;
278     }
279
280     return (p1 != s->name - 1);
281 }
282
283 /*-
284  *-----------------------------------------------------------------------
285  * SuffSuffHasNameP --
286  *      Callback procedure for finding a suffix based on its name. Used by
287  *      Suff_GetPath.
288  *
289  * Results:
290  *      0 if the suffix is of the given name. non-zero otherwise.
291  *
292  * Side Effects:
293  *      None
294  *-----------------------------------------------------------------------
295  */
296 static int
297 SuffSuffHasNameP(const void *s, const void *sname)
298 {
299
300     return (strcmp(sname, ((const Suff *)s)->name));
301 }
302
303 /*-
304  *-----------------------------------------------------------------------
305  * SuffSuffIsPrefix  --
306  *      See if the suffix described by s is a prefix of the string. Care
307  *      must be taken when using this to search for transformations and
308  *      what-not, since there could well be two suffixes, one of which
309  *      is a prefix of the other...
310  *
311  * Results:
312  *      0 if s is a prefix of str. non-zero otherwise
313  *
314  * Side Effects:
315  *      None
316  *
317  * XXX use the function above once constification is complete.
318  *-----------------------------------------------------------------------
319  */
320 static int
321 SuffSuffIsPrefix(const void *s, const void *istr)
322 {
323         const char *pref = ((const Suff *)s)->name;
324         const char *str = istr;
325
326         while (*str != '\0' && *pref == *str) {
327                 pref++;
328                 str++;
329         }
330
331         return (*pref != '\0');
332 }
333
334 /*-
335  *-----------------------------------------------------------------------
336  * SuffGNHasNameP  --
337  *      See if the graph node has the desired name
338  *
339  * Results:
340  *      0 if it does. non-zero if it doesn't
341  *
342  * Side Effects:
343  *      None
344  *-----------------------------------------------------------------------
345  */
346 static int
347 SuffGNHasNameP(const void *gn, const void *name)
348 {
349
350     return (strcmp(name, ((const GNode *)gn)->name));
351 }
352
353             /*********** Maintenance Functions ************/
354
355 #if 0
356 /*
357  * Keep this function for now until it is clear why a .SUFFIXES: doesn't
358  * actually delete the suffixes but just puts them on the suffClean list.
359  */
360 /*-
361  *-----------------------------------------------------------------------
362  * SuffFree  --
363  *      Free up all memory associated with the given suffix structure.
364  *
365  * Results:
366  *      none
367  *
368  * Side Effects:
369  *      the suffix entry is detroyed
370  *-----------------------------------------------------------------------
371  */
372 static void
373 SuffFree(void *sp)
374 {
375     Suff *s = sp;
376
377     if (s == suffNull)
378         suffNull = NULL;
379
380     if (s == emptySuff)
381         emptySuff = NULL;
382
383     Lst_Destroy(&s->ref, NOFREE);
384     Lst_Destroy(&s->children, NOFREE);
385     Lst_Destroy(&s->parents, NOFREE);
386     Lst_Destroy(&s->searchPath, Dir_Destroy);
387
388     free(s->name);
389     free(s);
390 }
391 #endif
392
393 /*-
394  *-----------------------------------------------------------------------
395  * SuffRemove  --
396  *      Remove the suffix into the list
397  *
398  * Results:
399  *      None
400  *
401  * Side Effects:
402  *      The reference count for the suffix is decremented
403  *-----------------------------------------------------------------------
404  */
405 static void
406 SuffRemove(Lst *l, Suff *s)
407 {
408     LstNode *ln = Lst_Member(l, s);
409
410     if (ln != NULL) {
411         Lst_Remove(l, ln);
412         s->refCount--;
413     }
414 }
415
416 /*-
417  *-----------------------------------------------------------------------
418  * SuffInsert  --
419  *      Insert the suffix into the list keeping the list ordered by suffix
420  *      numbers.
421  *
422  * Results:
423  *      None
424  *
425  * Side Effects:
426  *      The reference count of the suffix is incremented
427  *-----------------------------------------------------------------------
428  */
429 static void
430 SuffInsert(Lst *l, Suff *s)
431 {
432     LstNode *ln;        /* current element in l we're examining */
433     Suff *s2;           /* the suffix descriptor in this element */
434
435     s2 = NULL;
436     for (ln = Lst_First(l); ln != NULL; ln = Lst_Succ(ln)) {
437         s2 = Lst_Datum(ln);
438         if (s2->sNum >= s->sNum)
439             break;
440     }
441     if (s2 == NULL) {
442             DEBUGF(SUFF, ("inserting an empty list?..."));
443     }
444
445     DEBUGF(SUFF, ("inserting %s(%d)...", s->name, s->sNum));
446     if (ln == NULL) {
447         DEBUGF(SUFF, ("at end of list\n"));
448         Lst_AtEnd(l, s);
449         s->refCount++;
450         Lst_AtEnd(&s->ref, l);
451     } else if (s2->sNum != s->sNum) {
452         DEBUGF(SUFF, ("before %s(%d)\n", s2->name, s2->sNum));
453         Lst_Insert(l, ln, s);
454         s->refCount++;
455         Lst_AtEnd(&s->ref, l);
456     } else {
457         DEBUGF(SUFF, ("already there\n"));
458     }
459 }
460
461 /*-
462  *-----------------------------------------------------------------------
463  * Suff_ClearSuffixes --
464  *      This is gross. Nuke the list of suffixes but keep all transformation
465  *      rules around. The transformation graph is destroyed in this process,
466  *      but we leave the list of rules so when a new graph is formed the rules
467  *      will remain.
468  *      This function is called from the parse module when a
469  *      .SUFFIXES:\n line is encountered.
470  *
471  * Results:
472  *      none
473  *
474  * Side Effects:
475  *      the sufflist and its graph nodes are destroyed
476  *-----------------------------------------------------------------------
477  */
478 void
479 Suff_ClearSuffixes(void)
480 {
481
482     Lst_Concat(&suffClean, &sufflist, LST_CONCLINK);
483
484     sNum = 1;
485     suffNull = emptySuff;
486     /*
487      * Clear suffNull's children list (the other suffixes are built new, but
488      * suffNull is used as is).
489      * NOFREE is used because all suffixes are are on the suffClean list.
490      * suffNull should not have parents.
491      */
492     Lst_Destroy(&suffNull->children, NOFREE);
493 }
494
495 /*-
496  *-----------------------------------------------------------------------
497  * SuffParseTransform --
498  *      Parse a transformation string to find its two component suffixes.
499  *
500  * Results:
501  *      TRUE if the string is a valid transformation and FALSE otherwise.
502  *
503  * Side Effects:
504  *      The passed pointers are overwritten.
505  *
506  *-----------------------------------------------------------------------
507  */
508 static Boolean
509 SuffParseTransform(char *str, Suff **srcPtr, Suff **targPtr)
510 {
511     LstNode             *srcLn;     /* element in suffix list of trans source*/
512     Suff                *src;       /* Source of transformation */
513     LstNode             *targLn;    /* element in suffix list of trans target*/
514     char                *str2;      /* Extra pointer (maybe target suffix) */
515     LstNode             *singleLn;  /* element in suffix list of any suffix
516                                      * that exactly matches str */
517     Suff                *single = NULL;/* Source of possible transformation to
518                                      * null suffix */
519
520     srcLn = NULL;
521     singleLn = NULL;
522
523     /*
524      * Loop looking first for a suffix that matches the start of the
525      * string and then for one that exactly matches the rest of it. If
526      * we can find two that meet these criteria, we've successfully
527      * parsed the string.
528      */
529     for (;;) {
530         if (srcLn == NULL) {
531             srcLn = Lst_Find(&sufflist, str, SuffSuffIsPrefix);
532         } else {
533             srcLn = Lst_FindFrom(&sufflist, Lst_Succ(srcLn), str,
534                                   SuffSuffIsPrefix);
535         }
536         if (srcLn == NULL) {
537             /*
538              * Ran out of source suffixes -- no such rule
539              */
540             if (singleLn != NULL) {
541                 /*
542                  * Not so fast Mr. Smith! There was a suffix that encompassed
543                  * the entire string, so we assume it was a transformation
544                  * to the null suffix (thank you POSIX). We still prefer to
545                  * find a double rule over a singleton, hence we leave this
546                  * check until the end.
547                  *
548                  * XXX: Use emptySuff over suffNull?
549                  */
550                 *srcPtr = single;
551                 *targPtr = suffNull;
552                 return (TRUE);
553             }
554             return (FALSE);
555         }
556         src = Lst_Datum(srcLn);
557         str2 = str + src->nameLen;
558         if (*str2 == '\0') {
559             single = src;
560             singleLn = srcLn;
561         } else {
562             targLn = Lst_Find(&sufflist, str2, SuffSuffHasNameP);
563             if (targLn != NULL) {
564                 *srcPtr = src;
565                 *targPtr = Lst_Datum(targLn);
566                 return (TRUE);
567             }
568         }
569     }
570 }
571
572 /*-
573  *-----------------------------------------------------------------------
574  * Suff_IsTransform  --
575  *      Return TRUE if the given string is a transformation rule
576  *
577  *
578  * Results:
579  *      TRUE if the string is a concatenation of two known suffixes.
580  *      FALSE otherwise
581  *
582  * Side Effects:
583  *      None
584  *-----------------------------------------------------------------------
585  */
586 Boolean
587 Suff_IsTransform(char *str)
588 {
589     Suff          *src, *targ;
590
591     return (SuffParseTransform(str, &src, &targ));
592 }
593
594 /*-
595  *-----------------------------------------------------------------------
596  * Suff_AddTransform --
597  *      Add the transformation rule described by the line to the
598  *      list of rules and place the transformation itself in the graph
599  *
600  * Results:
601  *      The node created for the transformation in the transforms list
602  *
603  * Side Effects:
604  *      The node is placed on the end of the transforms Lst and links are
605  *      made between the two suffixes mentioned in the target name
606  *-----------------------------------------------------------------------
607  */
608 GNode *
609 Suff_AddTransform(char *line)
610 {
611     GNode         *gn;          /* GNode of transformation rule */
612     Suff          *s,           /* source suffix */
613                   *t;           /* target suffix */
614     LstNode       *ln;          /* Node for existing transformation */
615
616     ln = Lst_Find(&transforms, line, SuffGNHasNameP);
617     if (ln == NULL) {
618         /*
619          * Make a new graph node for the transformation. It will be filled in
620          * by the Parse module.
621          */
622         gn = Targ_NewGN(line);
623         Lst_AtEnd(&transforms, gn);
624     } else {
625         /*
626          * New specification for transformation rule. Just nuke the old list
627          * of commands so they can be filled in again... We don't actually
628          * free the commands themselves, because a given command can be
629          * attached to several different transformations.
630          */
631         gn = Lst_Datum(ln);
632         Lst_Destroy(&gn->commands, NOFREE);
633         Lst_Destroy(&gn->children, NOFREE);
634     }
635
636     gn->type = OP_TRANSFORM;
637
638     SuffParseTransform(line, &s, &t);
639
640     /*
641      * link the two together in the proper relationship and order
642      */
643     DEBUGF(SUFF, ("defining transformation from `%s' to `%s'\n",
644            s->name, t->name));
645     SuffInsert(&t->children, s);
646     SuffInsert(&s->parents, t);
647
648     return (gn);
649 }
650
651 /*-
652  *-----------------------------------------------------------------------
653  * Suff_EndTransform --
654  *      Handle the finish of a transformation definition, removing the
655  *      transformation from the graph if it has neither commands nor
656  *      sources. This is a callback procedure for the Parse module via
657  *      Lst_ForEach
658  *
659  * Results:
660  *      === 0
661  *
662  * Side Effects:
663  *      If the node has no commands or children, the children and parents
664  *      lists of the affected suffices are altered.
665  *
666  *-----------------------------------------------------------------------
667  */
668 int
669 Suff_EndTransform(void *gnp, void *dummy __unused)
670 {
671     GNode *gn = (GNode *)gnp;
672
673     if ((gn->type & OP_TRANSFORM) && Lst_IsEmpty(&gn->commands) &&
674         Lst_IsEmpty(&gn->children))
675     {
676         Suff    *s, *t;
677
678         /*
679          * SuffParseTransform() may fail for special rules which are not
680          * actual transformation rules (e.g., .DEFAULT).
681          */
682         if (!SuffParseTransform(gn->name, &s, &t))
683             return (0);
684
685         DEBUGF(SUFF, ("deleting transformation from `%s' to `%s'\n",
686                s->name, t->name));
687
688         /*
689          * Remove the source from the target's children list. We check for a
690          * NULL return to handle a beanhead saying something like
691          *  .c.o .c.o:
692          *
693          * We'll be called twice when the next target is seen, but .c and .o
694          * are only linked once...
695          */
696         SuffRemove(&t->children, s);
697
698         /*
699          * Remove the target from the source's parents list
700          */
701         SuffRemove(&s->parents, t);
702     } else if (gn->type & OP_TRANSFORM) {
703         DEBUGF(SUFF, ("transformation %s complete\n", gn->name));
704     }
705
706     return (0);
707 }
708
709 /*-
710  *-----------------------------------------------------------------------
711  * SuffRebuildGraph --
712  *      Called from Suff_AddSuffix via Lst_ForEach to search through the
713  *      list of existing transformation rules and rebuild the transformation
714  *      graph when it has been destroyed by Suff_ClearSuffixes. If the
715  *      given rule is a transformation involving this suffix and another,
716  *      existing suffix, the proper relationship is established between
717  *      the two.
718  *
719  * Results:
720  *      Always 0.
721  *
722  * Side Effects:
723  *      The appropriate links will be made between this suffix and
724  *      others if transformation rules exist for it.
725  *
726  *-----------------------------------------------------------------------
727  */
728 static int
729 SuffRebuildGraph(void *transformp, void *sp)
730 {
731     GNode       *transform = transformp;
732     Suff        *s = sp;
733     char        *cp;
734     LstNode     *ln;
735     Suff        *s2 = NULL;
736
737     /*
738      * First see if it is a transformation from this suffix.
739      */
740     cp = SuffStrIsPrefix(s->name, transform->name);
741     if (cp != (char *)NULL) {
742         if (cp[0] == '\0')  /* null rule */
743             s2 = suffNull;
744         else {
745             ln = Lst_Find(&sufflist, cp, SuffSuffHasNameP);
746             if (ln != NULL)
747                 s2 = Lst_Datum(ln);
748         }
749         if (s2 != NULL) {
750             /*
751              * Found target. Link in and return, since it can't be anything
752              * else.
753              */
754             SuffInsert(&s2->children, s);
755             SuffInsert(&s->parents, s2);
756             return (0);
757         }
758     }
759
760     /*
761      * Not from, maybe to?
762      */
763     cp = SuffSuffIsSuffix(s, transform->name + strlen(transform->name));
764     if (cp != NULL) {
765         /*
766          * Null-terminate the source suffix in order to find it.
767          */
768         cp[1] = '\0';
769         ln = Lst_Find(&sufflist, transform->name, SuffSuffHasNameP);
770         /*
771          * Replace the start of the target suffix
772          */
773         cp[1] = s->name[0];
774         if (ln != NULL) {
775             /*
776              * Found it -- establish the proper relationship
777              */
778             s2 = Lst_Datum(ln);
779             SuffInsert(&s->children, s2);
780             SuffInsert(&s2->parents, s);
781         }
782     }
783     return (0);
784 }
785
786 /*-
787  *-----------------------------------------------------------------------
788  * Suff_AddSuffix --
789  *      Add the suffix in string to the end of the list of known suffixes.
790  *      Should we restructure the suffix graph? Make doesn't...
791  *
792  * Results:
793  *      None
794  *
795  * Side Effects:
796  *      A GNode is created for the suffix and a Suff structure is created and
797  *      added to the suffixes list unless the suffix was already known.
798  *-----------------------------------------------------------------------
799  */
800 void
801 Suff_AddSuffix(char *str)
802 {
803     Suff          *s;       /* new suffix descriptor */
804     LstNode       *ln;
805
806     ln = Lst_Find(&sufflist, str, SuffSuffHasNameP);
807     if (ln == NULL) {
808         s = emalloc(sizeof(Suff));
809
810         s->name = estrdup(str);
811         s->nameLen = strlen(s->name);
812         Lst_Init(&s->searchPath);
813         Lst_Init(&s->children);
814         Lst_Init(&s->parents);
815         Lst_Init(&s->ref);
816         s->sNum = sNum++;
817         s->flags = 0;
818         s->refCount = 0;
819
820         Lst_AtEnd(&sufflist, s);
821
822         /*
823          * Look for any existing transformations from or to this suffix.
824          * XXX: Only do this after a Suff_ClearSuffixes?
825          */
826         Lst_ForEach(&transforms, SuffRebuildGraph, s);
827     }
828 }
829
830 /*-
831  *-----------------------------------------------------------------------
832  * Suff_GetPath --
833  *      Return the search path for the given suffix, if it's defined.
834  *
835  * Results:
836  *      The searchPath for the desired suffix or NULL if the suffix isn't
837  *      defined.
838  *
839  * Side Effects:
840  *      None
841  *-----------------------------------------------------------------------
842  */
843 Lst *
844 Suff_GetPath(char *sname)
845 {
846     LstNode       *ln;
847     Suff          *s;
848
849     ln = Lst_Find(&sufflist, sname, SuffSuffHasNameP);
850     if (ln == NULL) {
851         return (NULL);
852     } else {
853         s = Lst_Datum(ln);
854         return (&s->searchPath);
855     }
856 }
857
858 /*-
859  *-----------------------------------------------------------------------
860  * Suff_DoPaths --
861  *      Extend the search paths for all suffixes to include the default
862  *      search path.
863  *
864  * Results:
865  *      None.
866  *
867  * Side Effects:
868  *      The searchPath field of all the suffixes is extended by the
869  *      directories in dirSearchPath. If paths were specified for the
870  *      ".h" suffix, the directories are stuffed into a global variable
871  *      called ".INCLUDES" with each directory preceded by a -I. The same
872  *      is done for the ".a" suffix, except the variable is called
873  *      ".LIBS" and the flag is -L.
874  *-----------------------------------------------------------------------
875  */
876 void
877 Suff_DoPaths(void)
878 {
879     Suff        *s;
880     LstNode     *ln;
881     char        *ptr;
882     Lst         inIncludes;     /* Cumulative .INCLUDES path */
883     Lst         inLibs;         /* Cumulative .LIBS path */
884
885     Lst_Init(&inIncludes);
886     Lst_Init(&inLibs);
887
888     for (ln = Lst_First(&sufflist); ln != NULL; ln = Lst_Succ(ln)) {
889         s = Lst_Datum(ln);
890         if (!Lst_IsEmpty(&s->searchPath)) {
891 #ifdef INCLUDES
892             if (s->flags & SUFF_INCLUDE) {
893                 Dir_Concat(&inIncludes, &s->searchPath);
894             }
895 #endif /* INCLUDES */
896 #ifdef LIBRARIES
897             if (s->flags & SUFF_LIBRARY) {
898                 Dir_Concat(&inLibs, &s->searchPath);
899             }
900 #endif /* LIBRARIES */
901             Dir_Concat(&s->searchPath, &dirSearchPath);
902         } else {
903             Lst_Destroy(&s->searchPath, Dir_Destroy);
904             Lst_Duplicate(&s->searchPath, &dirSearchPath, Dir_CopyDir);
905         }
906     }
907
908     Var_Set(".INCLUDES", ptr = Dir_MakeFlags("-I", &inIncludes), VAR_GLOBAL);
909     free(ptr);
910     Var_Set(".LIBS", ptr = Dir_MakeFlags("-L", &inLibs), VAR_GLOBAL);
911     free(ptr);
912
913     Lst_Destroy(&inIncludes, Dir_Destroy);
914     Lst_Destroy(&inLibs, Dir_Destroy);
915 }
916
917 /*-
918  *-----------------------------------------------------------------------
919  * Suff_AddInclude --
920  *      Add the given suffix as a type of file which gets included.
921  *      Called from the parse module when a .INCLUDES line is parsed.
922  *      The suffix must have already been defined.
923  *
924  * Results:
925  *      None.
926  *
927  * Side Effects:
928  *      The SUFF_INCLUDE bit is set in the suffix's flags field
929  *
930  *-----------------------------------------------------------------------
931  */
932 void
933 Suff_AddInclude(char *sname)
934 {
935     LstNode       *ln;
936     Suff          *s;
937
938     ln = Lst_Find(&sufflist, sname, SuffSuffHasNameP);
939     if (ln != NULL) {
940         s = Lst_Datum(ln);
941         s->flags |= SUFF_INCLUDE;
942     }
943 }
944
945 /*-
946  *-----------------------------------------------------------------------
947  * Suff_AddLib --
948  *      Add the given suffix as a type of file which is a library.
949  *      Called from the parse module when parsing a .LIBS line. The
950  *      suffix must have been defined via .SUFFIXES before this is
951  *      called.
952  *
953  * Results:
954  *      None.
955  *
956  * Side Effects:
957  *      The SUFF_LIBRARY bit is set in the suffix's flags field
958  *
959  *-----------------------------------------------------------------------
960  */
961 void
962 Suff_AddLib(char *sname)
963 {
964     LstNode       *ln;
965     Suff          *s;
966
967     ln = Lst_Find(&sufflist, sname, SuffSuffHasNameP);
968     if (ln != NULL) {
969         s = Lst_Datum(ln);
970         s->flags |= SUFF_LIBRARY;
971     }
972 }
973
974           /********** Implicit Source Search Functions *********/
975
976 /*-
977  *-----------------------------------------------------------------------
978  * SuffAddSrc  --
979  *      Add a suffix as a Src structure to the given list with its parent
980  *      being the given Src structure. If the suffix is the null suffix,
981  *      the prefix is used unaltered as the file name in the Src structure.
982  *
983  * Results:
984  *      always returns 0
985  *
986  * Side Effects:
987  *      A Src structure is created and tacked onto the end of the list
988  *-----------------------------------------------------------------------
989  */
990 static int
991 SuffAddSrc(void *sp, void *lsp)
992 {
993     Suff        *s = sp;
994     LstSrc      *ls = lsp;
995     Src         *s2;        /* new Src structure */
996     Src         *targ;      /* Target structure */
997
998     targ = ls->s;
999
1000     if ((s->flags & SUFF_NULL) && (*s->name != '\0')) {
1001         /*
1002          * If the suffix has been marked as the NULL suffix, also create a Src
1003          * structure for a file with no suffix attached. Two birds, and all
1004          * that...
1005          */
1006         s2 = emalloc(sizeof(Src));
1007         s2->file = estrdup(targ->pref);
1008         s2->pref = targ->pref;
1009         s2->parent = targ;
1010         s2->node = NULL;
1011         s2->suff = s;
1012         s->refCount++;
1013         s2->children =  0;
1014         targ->children += 1;
1015         Lst_AtEnd(ls->l, s2);
1016 #ifdef DEBUG_SRC
1017         Lst_Init(&s2->cp);
1018         Lst_AtEnd(&targ->cp, s2);
1019         printf("1 add %p %p to %p:", targ, s2, ls->l);
1020         Lst_ForEach(ls->l, PrintAddr, (void *)NULL);
1021         printf("\n");
1022 #endif
1023     }
1024     s2 = emalloc(sizeof(Src));
1025     s2->file = str_concat(targ->pref, s->name, 0);
1026     s2->pref = targ->pref;
1027     s2->parent = targ;
1028     s2->node = NULL;
1029     s2->suff = s;
1030     s->refCount++;
1031     s2->children = 0;
1032     targ->children += 1;
1033     Lst_AtEnd(ls->l, s2);
1034 #ifdef DEBUG_SRC
1035     Lst_Init(&s2->cp);
1036     Lst_AtEnd(&targ->cp, s2);
1037     printf("2 add %p %p to %p:", targ, s2, ls->l);
1038     Lst_ForEach(ls->l, PrintAddr, (void *)NULL);
1039     printf("\n");
1040 #endif
1041
1042     return (0);
1043 }
1044
1045 /*-
1046  *-----------------------------------------------------------------------
1047  * SuffAddLevel  --
1048  *      Add all the children of targ as Src structures to the given list
1049  *
1050  * Results:
1051  *      None
1052  *
1053  * Side Effects:
1054  *      Lots of structures are created and added to the list
1055  *-----------------------------------------------------------------------
1056  */
1057 static void
1058 SuffAddLevel(Lst *l, Src *targ)
1059 {
1060     LstSrc         ls;
1061
1062     ls.s = targ;
1063     ls.l = l;
1064
1065     Lst_ForEach(&targ->suff->children, SuffAddSrc, &ls);
1066 }
1067
1068 /*-
1069  *----------------------------------------------------------------------
1070  * SuffRemoveSrc --
1071  *      Free all src structures in list that don't have a reference count
1072  *      XXX this actually frees only the first of these.
1073  *
1074  * Results:
1075  *      True if a src was removed
1076  *
1077  * Side Effects:
1078  *      The memory is free'd.
1079  *----------------------------------------------------------------------
1080  */
1081 static int
1082 SuffRemoveSrc(Lst *l)
1083 {
1084     LstNode *ln, *ln1;
1085     Src *s;
1086     int t = 0;
1087
1088 #ifdef DEBUG_SRC
1089     printf("cleaning %lx: ", (unsigned long) l);
1090     Lst_ForEach(l, PrintAddr, (void *)NULL);
1091     printf("\n");
1092 #endif
1093
1094     for (ln = Lst_First(l); ln != NULL; ln = ln1) {
1095         ln1 = Lst_Succ(ln);
1096
1097         s = (Src *)Lst_Datum(ln);
1098         if (s->children == 0) {
1099             free(s->file);
1100             if (!s->parent)
1101                 free(s->pref);
1102             else {
1103 #ifdef DEBUG_SRC
1104                 LstNode *ln = Lst_Member(&s->parent->cp, s);
1105                 if (ln != NULL)
1106                     Lst_Remove(&s->parent->cp, ln);
1107 #endif
1108                 --s->parent->children;
1109             }
1110 #ifdef DEBUG_SRC
1111             printf("free: [l=%p] p=%p %d\n", l, s, s->children);
1112             Lst_Destroy(&s->cp, NOFREE);
1113 #endif
1114             Lst_Remove(l, ln);
1115             free(s);
1116             t |= 1;
1117             return (TRUE);
1118         }
1119 #ifdef DEBUG_SRC
1120         else {
1121             printf("keep: [l=%p] p=%p %d: ", l, s, s->children);
1122             Lst_ForEach(&s->cp, PrintAddr, (void *)NULL);
1123             printf("\n");
1124         }
1125 #endif
1126     }
1127
1128     return (t);
1129 }
1130
1131 /*-
1132  *-----------------------------------------------------------------------
1133  * SuffFindThem --
1134  *      Find the first existing file/target in the list srcs
1135  *
1136  * Results:
1137  *      The lowest structure in the chain of transformations
1138  *
1139  * Side Effects:
1140  *      None
1141  *-----------------------------------------------------------------------
1142  */
1143 static Src *
1144 SuffFindThem(Lst *srcs, Lst *slst)
1145 {
1146     Src            *s;          /* current Src */
1147     Src            *rs;         /* returned Src */
1148     char           *ptr;
1149
1150     rs = NULL;
1151
1152     while (!Lst_IsEmpty (srcs)) {
1153         s = Lst_DeQueue(srcs);
1154
1155         DEBUGF(SUFF, ("\ttrying %s...", s->file));
1156
1157         /*
1158          * A file is considered to exist if either a node exists in the
1159          * graph for it or the file actually exists.
1160          */
1161         if (Targ_FindNode(s->file, TARG_NOCREATE) != NULL) {
1162 #ifdef DEBUG_SRC
1163             printf("remove %p from %p\n", s, srcs);
1164 #endif
1165             rs = s;
1166             break;
1167         }
1168
1169         if ((ptr = Dir_FindFile(s->file, &s->suff->searchPath)) != NULL) {
1170             rs = s;
1171 #ifdef DEBUG_SRC
1172             printf("remove %p from %p\n", s, srcs);
1173 #endif
1174             free(ptr);
1175             break;
1176         }
1177
1178         DEBUGF(SUFF, ("not there\n"));
1179
1180         SuffAddLevel(srcs, s);
1181         Lst_AtEnd(slst, s);
1182     }
1183
1184     if (rs) {
1185         DEBUGF(SUFF, ("got it\n"));
1186     }
1187     return (rs);
1188 }
1189
1190 /*-
1191  *-----------------------------------------------------------------------
1192  * SuffFindCmds --
1193  *      See if any of the children of the target in the Src structure is
1194  *      one from which the target can be transformed. If there is one,
1195  *      a Src structure is put together for it and returned.
1196  *
1197  * Results:
1198  *      The Src structure of the "winning" child, or NULL if no such beast.
1199  *
1200  * Side Effects:
1201  *      A Src structure may be allocated.
1202  *
1203  *-----------------------------------------------------------------------
1204  */
1205 static Src *
1206 SuffFindCmds(Src *targ, Lst *slst)
1207 {
1208     LstNode             *ln;    /* General-purpose list node */
1209     GNode               *t,     /* Target GNode */
1210                         *s;     /* Source GNode */
1211     int                 prefLen;/* The length of the defined prefix */
1212     Suff                *suff;  /* Suffix on matching beastie */
1213     Src                 *ret;   /* Return value */
1214     char                *cp;
1215
1216     t = targ->node;
1217     prefLen = strlen(targ->pref);
1218
1219     for (ln = Lst_First(&t->children); ln != NULL; ln = Lst_Succ(ln)) {
1220         s = Lst_Datum(ln);
1221
1222         cp = strrchr(s->name, '/');
1223         if (cp == NULL) {
1224             cp = s->name;
1225         } else {
1226             cp++;
1227         }
1228         if (strncmp(cp, targ->pref, prefLen) == 0) {
1229             /*
1230              * The node matches the prefix ok, see if it has a known
1231              * suffix.
1232              */
1233             ln = Lst_Find(&sufflist, &cp[prefLen], SuffSuffHasNameP);
1234             if (ln != NULL) {
1235                 /*
1236                  * It even has a known suffix, see if there's a transformation
1237                  * defined between the node's suffix and the target's suffix.
1238                  *
1239                  * XXX: Handle multi-stage transformations here, too.
1240                  */
1241                 suff = Lst_Datum(ln);
1242
1243                 if (Lst_Member(&suff->parents, targ->suff) != NULL) {
1244                     /*
1245                      * Hot Damn! Create a new Src structure to describe
1246                      * this transformation (making sure to duplicate the
1247                      * source node's name so Suff_FindDeps can free it
1248                      * again (ick)), and return the new structure.
1249                      */
1250                     ret = emalloc(sizeof(Src));
1251                     ret->file = estrdup(s->name);
1252                     ret->pref = targ->pref;
1253                     ret->suff = suff;
1254                     suff->refCount++;
1255                     ret->parent = targ;
1256                     ret->node = s;
1257                     ret->children = 0;
1258                     targ->children += 1;
1259 #ifdef DEBUG_SRC
1260                     Lst_Init(&ret->cp);
1261                     printf("3 add %p %p\n", &targ, ret);
1262                     Lst_AtEnd(&targ->cp, ret);
1263 #endif
1264                     Lst_AtEnd(slst, ret);
1265                     DEBUGF(SUFF, ("\tusing existing source %s\n", s->name));
1266                     return (ret);
1267                 }
1268             }
1269         }
1270     }
1271     return (NULL);
1272 }
1273
1274 /*-
1275  *-----------------------------------------------------------------------
1276  * SuffExpandChildren --
1277  *      Expand the names of any children of a given node that contain
1278  *      variable invocations or file wildcards into actual targets.
1279  *
1280  * Results:
1281  *      == 0 (continue)
1282  *
1283  * Side Effects:
1284  *      The expanded node is removed from the parent's list of children,
1285  *      and the parent's unmade counter is decremented, but other nodes
1286  *      may be added.
1287  *
1288  *-----------------------------------------------------------------------
1289  */
1290 static int
1291 SuffExpandChildren(void *cgnp, void *pgnp)
1292 {
1293     GNode       *cgn = cgnp;
1294     GNode       *pgn = pgnp;
1295     GNode       *gn;        /* New source 8) */
1296     LstNode     *prevLN;    /* Node after which new source should be put */
1297     LstNode     *ln;        /* List element for old source */
1298     char        *cp;        /* Expanded value */
1299     Buffer      *buf;
1300
1301     /*
1302      * New nodes effectively take the place of the child, so place them
1303      * after the child
1304      */
1305     prevLN = Lst_Member(&pgn->children, cgn);
1306
1307     /*
1308      * First do variable expansion -- this takes precedence over
1309      * wildcard expansion. If the result contains wildcards, they'll be gotten
1310      * to later since the resulting words are tacked on to the end of
1311      * the children list.
1312      */
1313     if (strchr(cgn->name, '$') != NULL) {
1314         DEBUGF(SUFF, ("Expanding \"%s\"...", cgn->name));
1315         buf = Var_Subst(NULL, cgn->name, pgn, TRUE);
1316         cp = Buf_GetAll(buf, NULL);
1317         Buf_Destroy(buf, FALSE);
1318
1319         if (cp != NULL) {
1320             Lst members = Lst_Initializer(members);
1321
1322             if (cgn->type & OP_ARCHV) {
1323                 /*
1324                  * Node was an archive(member) target, so we want to call
1325                  * on the Arch module to find the nodes for us, expanding
1326                  * variables in the parent's context.
1327                  */
1328                 char    *sacrifice = cp;
1329
1330                 Arch_ParseArchive(&sacrifice, &members, pgn);
1331             } else {
1332                 /*
1333                  * Break the result into a vector of strings whose nodes
1334                  * we can find, then add those nodes to the members list.
1335                  * Unfortunately, we can't use brk_string b/c it
1336                  * doesn't understand about variable specifications with
1337                  * spaces in them...
1338                  */
1339                 char        *start;
1340                 char        *initcp = cp;   /* For freeing... */
1341
1342                 for (start = cp; *start == ' ' || *start == '\t'; start++)
1343                     continue;
1344                 for (cp = start; *cp != '\0'; cp++) {
1345                     if (*cp == ' ' || *cp == '\t') {
1346                         /*
1347                          * White-space -- terminate element, find the node,
1348                          * add it, skip any further spaces.
1349                          */
1350                         *cp++ = '\0';
1351                         gn = Targ_FindNode(start, TARG_CREATE);
1352                         Lst_AtEnd(&members, gn);
1353                         while (*cp == ' ' || *cp == '\t') {
1354                             cp++;
1355                         }
1356                         /*
1357                          * Adjust cp for increment at start of loop, but
1358                          * set start to first non-space.
1359                          */
1360                         start = cp--;
1361                     } else if (*cp == '$') {
1362                         /*
1363                          * Start of a variable spec -- contact variable module
1364                          * to find the end so we can skip over it.
1365                          */
1366                         char    *junk;
1367                         size_t  len = 0;
1368                         Boolean doFree;
1369
1370                         junk = Var_Parse(cp, pgn, TRUE, &len, &doFree);
1371                         if (junk != var_Error) {
1372                             cp += len - 1;
1373                         }
1374
1375                         if (doFree) {
1376                             free(junk);
1377                         }
1378                     } else if (*cp == '\\' && *cp != '\0') {
1379                         /*
1380                          * Escaped something -- skip over it
1381                          */
1382                         cp++;
1383                     }
1384                 }
1385
1386                 if (cp != start) {
1387                     /*
1388                      * Stuff left over -- add it to the list too
1389                      */
1390                     gn = Targ_FindNode(start, TARG_CREATE);
1391                     Lst_AtEnd(&members, gn);
1392                 }
1393                 /*
1394                  * Point cp back at the beginning again so the variable value
1395                  * can be freed.
1396                  */
1397                 cp = initcp;
1398             }
1399             /*
1400              * Add all elements of the members list to the parent node.
1401              */
1402             while(!Lst_IsEmpty(&members)) {
1403                 gn = Lst_DeQueue(&members);
1404
1405                 DEBUGF(SUFF, ("%s...", gn->name));
1406                 if (Lst_Member(&pgn->children, gn) == NULL) {
1407                     Lst_Append(&pgn->children, prevLN, gn);
1408                     prevLN = Lst_Succ(prevLN);
1409                     Lst_AtEnd(&gn->parents, pgn);
1410                     pgn->unmade++;
1411                 }
1412             }
1413
1414             /*
1415              * Free the result
1416              */
1417             free(cp);
1418         }
1419         /*
1420          * Now the source is expanded, remove it from the list of children to
1421          * keep it from being processed.
1422          */
1423         ln = Lst_Member(&pgn->children, cgn);
1424         pgn->unmade--;
1425         Lst_Remove(&pgn->children, ln);
1426         DEBUGF(SUFF, ("\n"));
1427     } else if (Dir_HasWildcards(cgn->name)) {
1428         Lst exp;            /* List of expansions */
1429         Lst *path;          /* Search path along which to expand */
1430
1431         /*
1432          * Find a path along which to expand the word.
1433          *
1434          * If the word has a known suffix, use that path.
1435          * If it has no known suffix and we're allowed to use the null
1436          *   suffix, use its path.
1437          * Else use the default system search path.
1438          */
1439         cp = cgn->name + strlen(cgn->name);
1440         ln = Lst_Find(&sufflist, cp, SuffSuffIsSuffixP);
1441
1442         DEBUGF(SUFF, ("Wildcard expanding \"%s\"...", cgn->name));
1443
1444         if (ln != NULL) {
1445             Suff    *s = Lst_Datum(ln);
1446
1447             DEBUGF(SUFF, ("suffix is \"%s\"...", s->name));
1448             path = &s->searchPath;
1449         } else {
1450             /*
1451              * Use default search path
1452              */
1453             path = &dirSearchPath;
1454         }
1455
1456         /*
1457          * Expand the word along the chosen path
1458          */
1459         Lst_Init(&exp);
1460         Dir_Expand(cgn->name, path, &exp);
1461
1462         while (!Lst_IsEmpty(&exp)) {
1463             /*
1464              * Fetch next expansion off the list and find its GNode
1465              */
1466             cp = Lst_DeQueue(&exp);
1467
1468             DEBUGF(SUFF, ("%s...", cp));
1469             gn = Targ_FindNode(cp, TARG_CREATE);
1470
1471             /*
1472              * If gn isn't already a child of the parent, make it so and
1473              * up the parent's count of unmade children.
1474              */
1475             if (Lst_Member(&pgn->children, gn) == NULL) {
1476                 Lst_Append(&pgn->children, prevLN, gn);
1477                 prevLN = Lst_Succ(prevLN);
1478                 Lst_AtEnd(&gn->parents, pgn);
1479                 pgn->unmade++;
1480             }
1481         }
1482
1483         /*
1484          * Now the source is expanded, remove it from the list of children to
1485          * keep it from being processed.
1486          */
1487         ln = Lst_Member(&pgn->children, cgn);
1488         pgn->unmade--;
1489         Lst_Remove(&pgn->children, ln);
1490         DEBUGF(SUFF, ("\n"));
1491     }
1492
1493     return (0);
1494 }
1495
1496 /*-
1497  *-----------------------------------------------------------------------
1498  * SuffApplyTransform --
1499  *      Apply a transformation rule, given the source and target nodes
1500  *      and suffixes.
1501  *
1502  * Results:
1503  *      TRUE if successful, FALSE if not.
1504  *
1505  * Side Effects:
1506  *      The source and target are linked and the commands from the
1507  *      transformation are added to the target node's commands list.
1508  *      All attributes but OP_DEPMASK and OP_TRANSFORM are applied
1509  *      to the target. The target also inherits all the sources for
1510  *      the transformation rule.
1511  *
1512  *-----------------------------------------------------------------------
1513  */
1514 static Boolean
1515 SuffApplyTransform(GNode *tGn, GNode *sGn, Suff *t, Suff *s)
1516 {
1517     LstNode     *ln;        /* General node */
1518     char        *tname;     /* Name of transformation rule */
1519     GNode       *gn;        /* Node for same */
1520
1521     if (Lst_Member(&tGn->children, sGn) == NULL) {
1522         /*
1523          * Not already linked, so form the proper links between the
1524          * target and source.
1525          */
1526         Lst_AtEnd(&tGn->children, sGn);
1527         Lst_AtEnd(&sGn->parents, tGn);
1528         tGn->unmade += 1;
1529     }
1530
1531     if ((sGn->type & OP_OPMASK) == OP_DOUBLEDEP) {
1532         /*
1533          * When a :: node is used as the implied source of a node, we have
1534          * to link all its cohorts in as sources as well. Only the initial
1535          * sGn gets the target in its iParents list, however, as that
1536          * will be sufficient to get the .IMPSRC variable set for tGn
1537          */
1538         for (ln = Lst_First(&sGn->cohorts); ln != NULL; ln = Lst_Succ(ln)) {
1539             gn = Lst_Datum(ln);
1540
1541             if (Lst_Member(&tGn->children, gn) == NULL) {
1542                 /*
1543                  * Not already linked, so form the proper links between the
1544                  * target and source.
1545                  */
1546                 Lst_AtEnd(&tGn->children, gn);
1547                 Lst_AtEnd(&gn->parents, tGn);
1548                 tGn->unmade += 1;
1549             }
1550         }
1551     }
1552     /*
1553      * Locate the transformation rule itself
1554      */
1555     tname = str_concat(s->name, t->name, 0);
1556     ln = Lst_Find(&transforms, tname, SuffGNHasNameP);
1557     free(tname);
1558
1559     if (ln == NULL) {
1560         /*
1561          * Not really such a transformation rule (can happen when we're
1562          * called to link an OP_MEMBER and OP_ARCHV node), so return
1563          * FALSE.
1564          */
1565         return (FALSE);
1566     }
1567
1568     gn = Lst_Datum(ln);
1569
1570     DEBUGF(SUFF, ("\tapplying %s -> %s to \"%s\"\n", s->name, t->name, tGn->name));
1571
1572     /*
1573      * Record last child for expansion purposes
1574      */
1575     ln = Lst_Last(&tGn->children);
1576
1577     /*
1578      * Pass the buck to Make_HandleUse to apply the rule
1579      */
1580     Make_HandleUse(gn, tGn);
1581
1582     /*
1583      * Deal with wildcards and variables in any acquired sources
1584      */
1585     ln = Lst_Succ(ln);
1586     if (ln != NULL) {
1587         Lst_ForEachFrom(&tGn->children, ln, SuffExpandChildren, tGn);
1588     }
1589
1590     /*
1591      * Keep track of another parent to which this beast is transformed so
1592      * the .IMPSRC variable can be set correctly for the parent.
1593      */
1594     Lst_AtEnd(&sGn->iParents, tGn);
1595
1596     return (TRUE);
1597 }
1598
1599
1600 /*-
1601  *-----------------------------------------------------------------------
1602  * SuffFindArchiveDeps --
1603  *      Locate dependencies for an OP_ARCHV node.
1604  *
1605  * Results:
1606  *      None
1607  *
1608  * Side Effects:
1609  *      Same as Suff_FindDeps
1610  *
1611  *-----------------------------------------------------------------------
1612  */
1613 static void
1614 SuffFindArchiveDeps(GNode *gn, Lst *slst)
1615 {
1616     char        *eoarch;    /* End of archive portion */
1617     char        *eoname;    /* End of member portion */
1618     GNode       *mem;       /* Node for member */
1619     /* Variables to be copied from the member node */
1620     static const char   *copy[] = {
1621         TARGET,             /* Must be first */
1622         PREFIX,             /* Must be second */
1623     };
1624     int         i;          /* Index into copy and vals */
1625     Suff        *ms;        /* Suffix descriptor for member */
1626     char        *name;      /* Start of member's name */
1627
1628     /*
1629      * The node is an archive(member) pair. so we must find a
1630      * suffix for both of them.
1631      */
1632     eoarch = strchr(gn->name, '(');
1633     eoname = strchr(eoarch, ')');
1634
1635     *eoname = '\0';       /* Nuke parentheses during suffix search */
1636     *eoarch = '\0';       /* So a suffix can be found */
1637
1638     name = eoarch + 1;
1639
1640     /*
1641      * To simplify things, call Suff_FindDeps recursively on the member now,
1642      * so we can simply compare the member's .PREFIX and .TARGET variables
1643      * to locate its suffix. This allows us to figure out the suffix to
1644      * use for the archive without having to do a quadratic search over the
1645      * suffix list, backtracking for each one...
1646      */
1647     mem = Targ_FindNode(name, TARG_CREATE);
1648     SuffFindDeps(mem, slst);
1649
1650     /*
1651      * Create the link between the two nodes right off
1652      */
1653     if (Lst_Member(&gn->children, mem) == NULL) {
1654         Lst_AtEnd(&gn->children, mem);
1655         Lst_AtEnd(&mem->parents, gn);
1656         gn->unmade += 1;
1657     }
1658
1659     /*
1660      * Copy in the variables from the member node to this one.
1661      */
1662     for (i = (sizeof(copy) / sizeof(copy[0]))-1; i >= 0; i--) {
1663         char *p1;
1664         Var_Set(copy[i], Var_Value(copy[i], mem, &p1), gn);
1665         free(p1);
1666
1667     }
1668
1669     ms = mem->suffix;
1670     if (ms == NULL) {
1671         /*
1672          * Didn't know what it was -- use .NULL suffix if not in make mode
1673          */
1674         DEBUGF(SUFF, ("using null suffix\n"));
1675         ms = suffNull;
1676     }
1677
1678
1679     /*
1680      * Set the other two local variables required for this target.
1681      */
1682     Var_Set(MEMBER, name, gn);
1683     Var_Set(ARCHIVE, gn->name, gn);
1684
1685     if (ms != NULL) {
1686         /*
1687          * Member has a known suffix, so look for a transformation rule from
1688          * it to a possible suffix of the archive. Rather than searching
1689          * through the entire list, we just look at suffixes to which the
1690          * member's suffix may be transformed...
1691          */
1692         LstNode *ln;
1693
1694         /*
1695          * Use first matching suffix...
1696          */
1697         ln = Lst_Find(&ms->parents, eoarch, SuffSuffIsSuffixP);
1698
1699         if (ln != NULL) {
1700             /*
1701              * Got one -- apply it
1702              */
1703             if (!SuffApplyTransform(gn, mem, Lst_Datum(ln), ms)) {
1704                 DEBUGF(SUFF, ("\tNo transformation from %s -> %s\n",
1705                        ms->name, ((Suff *)Lst_Datum(ln))->name));
1706             }
1707         }
1708     }
1709
1710     /*
1711      * Replace the opening and closing parens now we've no need of the separate
1712      * pieces.
1713      */
1714     *eoarch = '('; *eoname = ')';
1715
1716     /*
1717      * Pretend gn appeared to the left of a dependency operator so
1718      * the user needn't provide a transformation from the member to the
1719      * archive.
1720      */
1721     if (OP_NOP(gn->type)) {
1722         gn->type |= OP_DEPENDS;
1723     }
1724
1725     /*
1726      * Flag the member as such so we remember to look in the archive for
1727      * its modification time.
1728      */
1729     mem->type |= OP_MEMBER;
1730 }
1731
1732 /*-
1733  *-----------------------------------------------------------------------
1734  * SuffFindNormalDeps --
1735  *      Locate implicit dependencies for regular targets.
1736  *
1737  * Results:
1738  *      None.
1739  *
1740  * Side Effects:
1741  *      Same as Suff_FindDeps...
1742  *
1743  *-----------------------------------------------------------------------
1744  */
1745 static void
1746 SuffFindNormalDeps(GNode *gn, Lst *slst)
1747 {
1748     char        *eoname;    /* End of name */
1749     char        *sopref;    /* Start of prefix */
1750     LstNode     *ln;        /* Next suffix node to check */
1751     Lst         srcs;       /* List of sources at which to look */
1752     Lst         targs;      /* List of targets to which things can be
1753                              * transformed. They all have the same file,
1754                              * but different suff and pref fields */
1755     Src         *bottom;    /* Start of found transformation path */
1756     Src         *src;       /* General Src pointer */
1757     char        *pref;      /* Prefix to use */
1758     Src         *targ;      /* General Src target pointer */
1759
1760
1761     eoname = gn->name + strlen(gn->name);
1762
1763     sopref = gn->name;
1764
1765     /*
1766      * Begin at the beginning...
1767      */
1768     ln = Lst_First(&sufflist);
1769     Lst_Init(&srcs);
1770     Lst_Init(&targs);
1771
1772     /*
1773      * We're caught in a catch-22 here. On the one hand, we want to use any
1774      * transformation implied by the target's sources, but we can't examine
1775      * the sources until we've expanded any variables/wildcards they may hold,
1776      * and we can't do that until we've set up the target's local variables
1777      * and we can't do that until we know what the proper suffix for the
1778      * target is (in case there are two suffixes one of which is a suffix of
1779      * the other) and we can't know that until we've found its implied
1780      * source, which we may not want to use if there's an existing source
1781      * that implies a different transformation.
1782      *
1783      * In an attempt to get around this, which may not work all the time,
1784      * but should work most of the time, we look for implied sources first,
1785      * checking transformations to all possible suffixes of the target,
1786      * use what we find to set the target's local variables, expand the
1787      * children, then look for any overriding transformations they imply.
1788      * Should we find one, we discard the one we found before.
1789      */
1790
1791     while (ln != NULL) {
1792         /*
1793          * Look for next possible suffix...
1794          */
1795         ln = Lst_FindFrom(&sufflist, ln, eoname, SuffSuffIsSuffixP);
1796
1797         if (ln != NULL) {
1798             int     prefLen;        /* Length of the prefix */
1799             Src     *target;
1800
1801             /*
1802              * Allocate a Src structure to which things can be transformed
1803              */
1804             target = emalloc(sizeof(Src));
1805             target->file = estrdup(gn->name);
1806             target->suff = Lst_Datum(ln);
1807             target->suff->refCount++;
1808             target->node = gn;
1809             target->parent = NULL;
1810             target->children = 0;
1811 #ifdef DEBUG_SRC
1812             Lst_Init(&target->cp);
1813 #endif
1814
1815             /*
1816              * Allocate room for the prefix, whose end is found by subtracting
1817              * the length of the suffix from the end of the name.
1818              */
1819             prefLen = (eoname - target->suff->nameLen) - sopref;
1820             target->pref = emalloc(prefLen + 1);
1821             memcpy(target->pref, sopref, prefLen);
1822             target->pref[prefLen] = '\0';
1823
1824             /*
1825              * Add nodes from which the target can be made
1826              */
1827             SuffAddLevel(&srcs, target);
1828
1829             /*
1830              * Record the target so we can nuke it
1831              */
1832             Lst_AtEnd(&targs, target);
1833
1834             /*
1835              * Search from this suffix's successor...
1836              */
1837             ln = Lst_Succ(ln);
1838         }
1839     }
1840
1841     /*
1842      * Handle target of unknown suffix...
1843      */
1844     if (Lst_IsEmpty(&targs) && suffNull != NULL) {
1845         DEBUGF(SUFF, ("\tNo known suffix on %s. Using .NULL suffix\n", gn->name));
1846
1847         targ = emalloc(sizeof(Src));
1848         targ->file = estrdup(gn->name);
1849         targ->suff = suffNull;
1850         targ->suff->refCount++;
1851         targ->node = gn;
1852         targ->parent = NULL;
1853         targ->children = 0;
1854         targ->pref = estrdup(sopref);
1855 #ifdef DEBUG_SRC
1856         Lst_Init(&targ->cp);
1857 #endif
1858
1859         /*
1860          * Only use the default suffix rules if we don't have commands
1861          * or dependencies defined for this gnode
1862          */
1863         if (Lst_IsEmpty(&gn->commands) && Lst_IsEmpty(&gn->children))
1864             SuffAddLevel(&srcs, targ);
1865         else {
1866             DEBUGF(SUFF, ("not "));
1867         }
1868
1869         DEBUGF(SUFF, ("adding suffix rules\n"));
1870
1871         Lst_AtEnd(&targs, targ);
1872     }
1873
1874     /*
1875      * Using the list of possible sources built up from the target suffix(es),
1876      * try and find an existing file/target that matches.
1877      */
1878     bottom = SuffFindThem(&srcs, slst);
1879
1880     if (bottom == NULL) {
1881         /*
1882          * No known transformations -- use the first suffix found for setting
1883          * the local variables.
1884          */
1885         if (!Lst_IsEmpty(&targs)) {
1886             targ = Lst_Datum(Lst_First(&targs));
1887         } else {
1888             targ = NULL;
1889         }
1890     } else {
1891         /*
1892          * Work up the transformation path to find the suffix of the
1893          * target to which the transformation was made.
1894          */
1895         for (targ = bottom; targ->parent != NULL; targ = targ->parent)
1896             continue;
1897     }
1898
1899     /*
1900      * The .TARGET variable we always set to be the name at this point,
1901      * since it's only set to the path if the thing is only a source and
1902      * if it's only a source, it doesn't matter what we put here as far
1903      * as expanding sources is concerned, since it has none...
1904      */
1905     Var_Set(TARGET, gn->name, gn);
1906
1907     pref = (targ != NULL) ? targ->pref : gn->name;
1908     Var_Set(PREFIX, pref, gn);
1909
1910     /*
1911      * Now we've got the important local variables set, expand any sources
1912      * that still contain variables or wildcards in their names.
1913      */
1914     Lst_ForEach(&gn->children, SuffExpandChildren, (void *)gn);
1915
1916     if (targ == NULL) {
1917         DEBUGF(SUFF, ("\tNo valid suffix on %s\n", gn->name));
1918
1919 sfnd_abort:
1920         /*
1921          * Deal with finding the thing on the default search path if the
1922          * node is only a source (not on the lhs of a dependency operator
1923          * or [XXX] it has neither children or commands).
1924          */
1925         if (OP_NOP(gn->type) ||
1926             (Lst_IsEmpty(&gn->children) && Lst_IsEmpty(&gn->commands)))
1927         {
1928             gn->path = Dir_FindFile(gn->name,
1929                                     (targ == NULL ? &dirSearchPath :
1930                                      &targ->suff->searchPath));
1931             if (gn->path != NULL) {
1932                 char *ptr;
1933                 Var_Set(TARGET, gn->path, gn);
1934
1935                 if (targ != NULL) {
1936                     /*
1937                      * Suffix known for the thing -- trim the suffix off
1938                      * the path to form the proper .PREFIX variable.
1939                      */
1940                     int         savep = strlen(gn->path) - targ->suff->nameLen;
1941                     char        savec;
1942
1943                     if (gn->suffix)
1944                         gn->suffix->refCount--;
1945                     gn->suffix = targ->suff;
1946                     gn->suffix->refCount++;
1947
1948                     savec = gn->path[savep];
1949                     gn->path[savep] = '\0';
1950
1951                     if ((ptr = strrchr(gn->path, '/')) != NULL)
1952                         ptr++;
1953                     else
1954                         ptr = gn->path;
1955
1956                     Var_Set(PREFIX, ptr, gn);
1957
1958                     gn->path[savep] = savec;
1959                 } else {
1960                     /*
1961                      * The .PREFIX gets the full path if the target has
1962                      * no known suffix.
1963                      */
1964                     if (gn->suffix)
1965                         gn->suffix->refCount--;
1966                     gn->suffix = NULL;
1967
1968                     if ((ptr = strrchr(gn->path, '/')) != NULL)
1969                         ptr++;
1970                     else
1971                         ptr = gn->path;
1972
1973                     Var_Set(PREFIX, ptr, gn);
1974                 }
1975             }
1976         } else {
1977             /*
1978              * Not appropriate to search for the thing -- set the
1979              * path to be the name so Dir_MTime won't go grovelling for
1980              * it.
1981              */
1982             if (gn->suffix)
1983                 gn->suffix->refCount--;
1984             gn->suffix = (targ == NULL) ? NULL : targ->suff;
1985             if (gn->suffix)
1986                 gn->suffix->refCount++;
1987             free(gn->path);
1988             gn->path = estrdup(gn->name);
1989         }
1990
1991         goto sfnd_return;
1992     }
1993
1994     /*
1995      * If the suffix indicates that the target is a library, mark that in
1996      * the node's type field.
1997      */
1998     if (targ->suff->flags & SUFF_LIBRARY) {
1999         gn->type |= OP_LIB;
2000     }
2001
2002     /*
2003      * Check for overriding transformation rule implied by sources
2004      */
2005     if (!Lst_IsEmpty(&gn->children)) {
2006         src = SuffFindCmds(targ, slst);
2007
2008         if (src != NULL) {
2009             /*
2010              * Free up all the Src structures in the transformation path
2011              * up to, but not including, the parent node.
2012              */
2013             while (bottom && bottom->parent != NULL) {
2014                 if (Lst_Member(slst, bottom) == NULL) {
2015                     Lst_AtEnd(slst, bottom);
2016                 }
2017                 bottom = bottom->parent;
2018             }
2019             bottom = src;
2020         }
2021     }
2022
2023     if (bottom == NULL) {
2024         /*
2025          * No idea from where it can come -- return now.
2026          */
2027         goto sfnd_abort;
2028     }
2029
2030     /*
2031      * We now have a list of Src structures headed by 'bottom' and linked via
2032      * their 'parent' pointers. What we do next is create links between
2033      * source and target nodes (which may or may not have been created)
2034      * and set the necessary local variables in each target. The
2035      * commands for each target are set from the commands of the
2036      * transformation rule used to get from the src suffix to the targ
2037      * suffix. Note that this causes the commands list of the original
2038      * node, gn, to be replaced by the commands of the final
2039      * transformation rule. Also, the unmade field of gn is incremented.
2040      * Etc.
2041      */
2042     if (bottom->node == NULL) {
2043         bottom->node = Targ_FindNode(bottom->file, TARG_CREATE);
2044     }
2045
2046     for (src = bottom; src->parent != NULL; src = src->parent) {
2047         targ = src->parent;
2048
2049         if (src->node->suffix)
2050             src->node->suffix->refCount--;
2051         src->node->suffix = src->suff;
2052         src->node->suffix->refCount++;
2053
2054         if (targ->node == NULL) {
2055             targ->node = Targ_FindNode(targ->file, TARG_CREATE);
2056         }
2057
2058         SuffApplyTransform(targ->node, src->node,
2059                            targ->suff, src->suff);
2060
2061         if (targ->node != gn) {
2062             /*
2063              * Finish off the dependency-search process for any nodes
2064              * between bottom and gn (no point in questing around the
2065              * filesystem for their implicit source when it's already
2066              * known). Note that the node can't have any sources that
2067              * need expanding, since SuffFindThem will stop on an existing
2068              * node, so all we need to do is set the standard and System V
2069              * variables.
2070              */
2071             targ->node->type |= OP_DEPS_FOUND;
2072
2073             Var_Set(PREFIX, targ->pref, targ->node);
2074
2075             Var_Set(TARGET, targ->node->name, targ->node);
2076         }
2077     }
2078
2079     if (gn->suffix)
2080         gn->suffix->refCount--;
2081     gn->suffix = src->suff;
2082     gn->suffix->refCount++;
2083
2084     /*
2085      * So Dir_MTime doesn't go questing for it...
2086      */
2087     free(gn->path);
2088     gn->path = estrdup(gn->name);
2089
2090     /*
2091      * Nuke the transformation path and the Src structures left over in the
2092      * two lists.
2093      */
2094 sfnd_return:
2095     if (bottom)
2096         if (Lst_Member(slst, bottom) == NULL)
2097             Lst_AtEnd(slst, bottom);
2098
2099     while (SuffRemoveSrc(&srcs) || SuffRemoveSrc(&targs))
2100         continue;
2101
2102     Lst_Concat(slst, &srcs, LST_CONCLINK);
2103     Lst_Concat(slst, &targs, LST_CONCLINK);
2104 }
2105
2106 /*-
2107  *-----------------------------------------------------------------------
2108  * Suff_FindDeps  --
2109  *      Find implicit sources for the target described by the graph node
2110  *      gn
2111  *
2112  * Results:
2113  *      Nothing.
2114  *
2115  * Side Effects:
2116  *      Nodes are added to the graph below the passed-in node. The nodes
2117  *      are marked to have their IMPSRC variable filled in. The
2118  *      PREFIX variable is set for the given node and all its
2119  *      implied children.
2120  *
2121  * Notes:
2122  *      The path found by this target is the shortest path in the
2123  *      transformation graph, which may pass through non-existent targets,
2124  *      to an existing target. The search continues on all paths from the
2125  *      root suffix until a file is found. I.e. if there's a path
2126  *      .o -> .c -> .l -> .l,v from the root and the .l,v file exists but
2127  *      the .c and .l files don't, the search will branch out in
2128  *      all directions from .o and again from all the nodes on the
2129  *      next level until the .l,v node is encountered.
2130  *
2131  *-----------------------------------------------------------------------
2132  */
2133 void
2134 Suff_FindDeps(GNode *gn)
2135 {
2136
2137     SuffFindDeps(gn, &srclist);
2138     while (SuffRemoveSrc(&srclist))
2139         continue;
2140 }
2141
2142
2143 static void
2144 SuffFindDeps(GNode *gn, Lst *slst)
2145 {
2146
2147     if (gn->type & OP_DEPS_FOUND) {
2148         /*
2149          * If dependencies already found, no need to do it again...
2150          */
2151         return;
2152     } else {
2153         gn->type |= OP_DEPS_FOUND;
2154     }
2155
2156     DEBUGF(SUFF, ("SuffFindDeps (%s)\n", gn->name));
2157
2158     if (gn->type & OP_ARCHV) {
2159         SuffFindArchiveDeps(gn, slst);
2160     } else if (gn->type & OP_LIB) {
2161         /*
2162          * If the node is a library, it is the arch module's job to find it
2163          * and set the TARGET variable accordingly. We merely provide the
2164          * search path, assuming all libraries end in ".a" (if the suffix
2165          * hasn't been defined, there's nothing we can do for it, so we just
2166          * set the TARGET variable to the node's name in order to give it a
2167          * value).
2168          */
2169         LstNode *ln;
2170         Suff    *s;
2171
2172         ln = Lst_Find(&sufflist, LIBSUFF, SuffSuffHasNameP);
2173         if (gn->suffix)
2174             gn->suffix->refCount--;
2175         if (ln != NULL) {
2176             gn->suffix = s = Lst_Datum(ln);
2177             gn->suffix->refCount++;
2178             Arch_FindLib(gn, &s->searchPath);
2179         } else {
2180             gn->suffix = NULL;
2181             Var_Set(TARGET, gn->name, gn);
2182         }
2183         /*
2184          * Because a library (-lfoo) target doesn't follow the standard
2185          * filesystem conventions, we don't set the regular variables for
2186          * the thing. .PREFIX is simply made empty...
2187          */
2188         Var_Set(PREFIX, "", gn);
2189     } else {
2190         SuffFindNormalDeps(gn, slst);
2191     }
2192 }
2193
2194 /*-
2195  *-----------------------------------------------------------------------
2196  * Suff_SetNull --
2197  *      Define which suffix is the null suffix.
2198  *
2199  * Results:
2200  *      None.
2201  *
2202  * Side Effects:
2203  *      'suffNull' is altered.
2204  *
2205  * Notes:
2206  *      Need to handle the changing of the null suffix gracefully so the
2207  *      old transformation rules don't just go away.
2208  *
2209  *-----------------------------------------------------------------------
2210  */
2211 void
2212 Suff_SetNull(char *name)
2213 {
2214     Suff    *s;
2215     LstNode *ln;
2216
2217     ln = Lst_Find(&sufflist, name, SuffSuffHasNameP);
2218     if (ln != NULL) {
2219         s = Lst_Datum(ln);
2220         if (suffNull != NULL) {
2221             suffNull->flags &= ~SUFF_NULL;
2222         }
2223         s->flags |= SUFF_NULL;
2224         /*
2225          * XXX: Here's where the transformation mangling would take place
2226          */
2227         suffNull = s;
2228     } else {
2229         Parse_Error(PARSE_WARNING, "Desired null suffix %s not defined.",
2230                      name);
2231     }
2232 }
2233
2234 /*-
2235  *-----------------------------------------------------------------------
2236  * Suff_Init --
2237  *      Initialize suffixes module
2238  *
2239  * Results:
2240  *      None
2241  *
2242  * Side Effects:
2243  *      Many
2244  *-----------------------------------------------------------------------
2245  */
2246 void
2247 Suff_Init(void)
2248 {
2249
2250     sNum = 0;
2251     /*
2252      * Create null suffix for single-suffix rules (POSIX). The thing doesn't
2253      * actually go on the suffix list or everyone will think that's its
2254      * suffix.
2255      */
2256     emptySuff = suffNull = emalloc(sizeof(Suff));
2257
2258     suffNull->name = estrdup("");
2259     suffNull->nameLen = 0;
2260     Lst_Init(&suffNull->searchPath);
2261     Dir_Concat(&suffNull->searchPath, &dirSearchPath);
2262     Lst_Init(&suffNull->children);
2263     Lst_Init(&suffNull->parents);
2264     Lst_Init(&suffNull->ref);
2265     suffNull->sNum = sNum++;
2266     suffNull->flags = SUFF_NULL;
2267     suffNull->refCount = 1;
2268 }
2269
2270 /********************* DEBUGGING FUNCTIONS **********************/
2271
2272 static int
2273 SuffPrintName(void *s, void *dummy __unused)
2274 {
2275
2276     printf("`%s' ", ((Suff *)s)->name);
2277     return (0);
2278 }
2279
2280 static int
2281 SuffPrintSuff(void *sp, void *dummy __unused)
2282 {
2283     Suff    *s = sp;
2284     int     flags;
2285     int     flag;
2286
2287     printf("# `%s' [%d] ", s->name, s->refCount);
2288
2289     flags = s->flags;
2290     if (flags) {
2291         fputs(" (", stdout);
2292         while (flags) {
2293             flag = 1 << (ffs(flags) - 1);
2294             flags &= ~flag;
2295             switch (flag) {
2296                 case SUFF_NULL:
2297                     printf("NULL");
2298                     break;
2299                 case SUFF_INCLUDE:
2300                     printf("INCLUDE");
2301                     break;
2302                 case SUFF_LIBRARY:
2303                     printf("LIBRARY");
2304                     break;
2305                 default:
2306                     break;
2307             }
2308             fputc(flags ? '|' : ')', stdout);
2309         }
2310     }
2311     fputc('\n', stdout);
2312     printf("#\tTo: ");
2313     Lst_ForEach(&s->parents, SuffPrintName, (void *)NULL);
2314     fputc('\n', stdout);
2315     printf("#\tFrom: ");
2316     Lst_ForEach(&s->children, SuffPrintName, (void *)NULL);
2317     fputc('\n', stdout);
2318     printf("#\tSearch Path: ");
2319     Dir_PrintPath(&s->searchPath);
2320     fputc('\n', stdout);
2321     return (0);
2322 }
2323
2324 static int
2325 SuffPrintTrans(void *tp, void *dummy __unused)
2326 {
2327     GNode   *t = tp;
2328
2329     printf("%-16s: ", t->name);
2330     Targ_PrintType(t->type);
2331     fputc('\n', stdout);
2332     Lst_ForEach(&t->commands, Targ_PrintCmd, (void *)NULL);
2333     fputc('\n', stdout);
2334     return (0);
2335 }
2336
2337 void
2338 Suff_PrintAll(void)
2339 {
2340
2341     printf("#*** Suffixes:\n");
2342     Lst_ForEach(&sufflist, SuffPrintSuff, (void *)NULL);
2343
2344     printf("#*** Transformations:\n");
2345     Lst_ForEach(&transforms, SuffPrintTrans, (void *)NULL);
2346 }
2347
2348 #ifdef DEBUG_SRC
2349 /*
2350  * Printaddr --
2351  *      Print the address of a node.
2352  */
2353 static int
2354 PrintAddr(void *a, void *b __unused)
2355 {
2356     printf("%p ", a);
2357     return (0);
2358 }
2359 #endif /* DEBUG_SRC */