sbin/rcorder/rcorder.c

   1 /*
   2  * Copyright (c) 1998, 1999 Matthew R. Green
   3  * All rights reserved.
   4  * Copyright (c) 1998
   5  *      Perry E. Metzger.  All rights reserved.
   6  *
   7  * Redistribution and use in source and binary forms, with or without
   8  * modification, are permitted provided that the following conditions
   9  * are met:
  10  * 1. Redistributions of source code must retain the above copyright
  11  *    notice, this list of conditions and the following disclaimer.
  12  * 2. Redistributions in binary form must reproduce the above copyright
  13  *    notice, this list of conditions and the following disclaimer in the
  14  *    documentation and/or other materials provided with the distribution.
  15  * 3. All advertising materials mentioning features or use of this software
  16  *    must display the following acknowledgement:
  17  *      This product includes software developed for the NetBSD Project
  18  *      by Perry E. Metzger.
  19  * 4. The name of the author may not be used to endorse or promote products
  20  *    derived from this software without specific prior written permission.
  21  *
  22  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  23  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  24  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  25  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  26  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  27  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  28  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  29  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  30  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  31  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  32  *
  33  *      $NetBSD: rcorder.c,v 1.7 2000/08/04 07:33:55 enami Exp $
  34  */
  35
  36 #include <sys/types.h>
  37 #include <sys/stat.h>
  38
  39 #include <err.h>
  40 #include <stdio.h>
  41 #include <stdlib.h>
  42 #include <string.h>
  43 #include <unistd.h>
  44 #include <libutil.h>
  45
  46 #include "sprite.h"
  47 #include "hash.h"
  48
  49 #ifdef DEBUG
  50 int debug = 0;
  51 # define        DPRINTF(args) if (debug) { fflush(stdout); fprintf args; }
  52 #else
  53 # define        DPRINTF(args)
  54 #endif
  55
  56 int provide;
  57
  58 #define REQUIRE_STR     "# REQUIRE:"
  59 #define REQUIRE_LEN     (sizeof(REQUIRE_STR) - 1)
  60 #define REQUIRES_STR    "# REQUIRES:"
  61 #define REQUIRES_LEN    (sizeof(REQUIRES_STR) - 1)
  62 #define PROVIDE_STR     "# PROVIDE:"
  63 #define PROVIDE_LEN     (sizeof(PROVIDE_STR) - 1)
  64 #define PROVIDES_STR    "# PROVIDES:"
  65 #define PROVIDES_LEN    (sizeof(PROVIDES_STR) - 1)
  66 #define BEFORE_STR      "# BEFORE:"
  67 #define BEFORE_LEN      (sizeof(BEFORE_STR) - 1)
  68 #define KEYWORD_STR     "# KEYWORD:"
  69 #define KEYWORD_LEN     (sizeof(KEYWORD_STR) - 1)
  70 #define KEYWORDS_STR    "# KEYWORDS:"
  71 #define KEYWORDS_LEN    (sizeof(KEYWORDS_STR) - 1)
  72
  73 int exit_code;
  74 int file_count;
  75 char **file_list;
  76
  77 typedef int bool;
  78 #define TRUE 1
  79 #define FALSE 0
  80 typedef bool flag;
  81 #define SET TRUE
  82 #define RESET FALSE
  83
  84 Hash_Table provide_hash_s, *provide_hash;
  85
  86 typedef struct provnode provnode;
  87 typedef struct filenode filenode;
  88 typedef struct f_provnode f_provnode;
  89 typedef struct f_reqnode f_reqnode;
  90 typedef struct strnodelist strnodelist;
  91
  92 struct provnode {
  93         flag            head;
  94         flag            in_progress;
  95         filenode        *fnode;
  96         provnode        *next, *last;
  97         char            *name;
  98 };
  99
 100 struct f_provnode {
 101         provnode        *pnode;
 102         f_provnode      *next;
 103 };
 104
 105 struct f_reqnode {
 106         Hash_Entry      *entry;
 107         f_reqnode       *next;
 108 };
 109
 110 struct strnodelist {
 111         filenode        *node;
 112         strnodelist     *next;
 113         char            s[1];
 114 };
 115
 116 struct filenode {
 117         char            *filename;
 118         flag            in_progress;
 119         filenode        *next, *last;
 120         f_reqnode       *req_list;
 121         f_provnode      *prov_list;
 122         strnodelist     *keyword_list;
 123 };
 124
 125 filenode fn_head_s, *fn_head;
 126
 127 strnodelist *bl_list;
 128 strnodelist *keep_list;
 129 strnodelist *skip_list;
 130 strnodelist *onetime_list;
 131
 132 void do_file(filenode *fnode);
 133 void strnode_add(strnodelist **, char *, filenode *);
 134 int skip_ok(filenode *fnode);
 135 int keep_ok(filenode *fnode);
 136 void satisfy_req(f_reqnode *rnode, char *filename);
 137 void crunch_file(char *);
 138 void parse_require(filenode *, char *);
 139 void parse_provide(filenode *, char *);
 140 void parse_before(filenode *, char *);
 141 void parse_keywords(filenode *, char *);
 142 filenode *filenode_new(char *);
 143 void add_require(filenode *, char *);
 144 void add_provide(filenode *, char *);
 145 void add_before(filenode *, char *);
 146 void add_keyword(filenode *, char *);
 147 void insert_before(void);
 148 Hash_Entry *make_fake_provision(filenode *);
 149 void crunch_all_files(void);
 150 void initialize(void);
 151 void generate_ordering(void);
 152 int main(int, char *[]);
 153
 154 int
 155 main(int argc, char **argv)
 156 {
 157         int ch;
 158
 159         while ((ch = getopt(argc, argv, "dpk:s:o:")) != -1)
 160                 switch (ch) {
 161                 case 'd':
 162 #ifdef DEBUG
 163                         debug = 1;
 164 #else
 165                         warnx("debugging not compiled in, -d ignored");
 166 #endif
 167                         break;
 168                 case 'k':
 169                         strnode_add(&keep_list, optarg, 0);
 170                         break;
 171                 case 's':
 172                         strnode_add(&skip_list, optarg, 0);
 173                         break;
 174                 case 'o':
 175                         strnode_add(&onetime_list, optarg, 0);
 176                         break;
 177                 case 'p':
 178                         provide = 1;
 179                         break;
 180                 default:
 181                         /* XXX should crunch it? */
 182                         break;
 183                 }
 184         argc -= optind;
 185         argv += optind;
 186
 187         file_count = argc;
 188         file_list = argv;
 189
 190         DPRINTF((stderr, "parse_args\n"));
 191         initialize();
 192         DPRINTF((stderr, "initialize\n"));
 193         crunch_all_files();
 194         DPRINTF((stderr, "crunch_all_files\n"));
 195         generate_ordering();
 196         DPRINTF((stderr, "generate_ordering\n"));
 197
 198         exit(exit_code);
 199 }
 200
 201 /*
 202  * initialise various variables.
 203  */
 204 void
 205 initialize(void)
 206 {
 207
 208         fn_head = &fn_head_s;
 209
 210         provide_hash = &provide_hash_s;
 211         Hash_InitTable(provide_hash, file_count);
 212 }
 213
 214 /* generic function to insert a new strnodelist element */
 215 void
 216 strnode_add(strnodelist **listp, char *s, filenode *fnode)
 217 {
 218         strnodelist *ent;
 219
 220         ent = emalloc(sizeof *ent + strlen(s));
 221         ent->node = fnode;
 222         strcpy(ent->s, s);
 223         ent->next = *listp;
 224         *listp = ent;
 225 }
 226
 227 /*
 228  * below are the functions that deal with creating the lists
 229  * from the filename's given and the dependancies and provisions
 230  * in each of these files.  no ordering or checking is done here.
 231  */
 232
 233 /*
 234  * we have a new filename, create a new filenode structure.
 235  * fill in the bits, and put it in the filenode linked list
 236  */
 237 filenode *
 238 filenode_new(char *filename)
 239 {
 240         filenode *temp;
 241
 242         temp = emalloc(sizeof(*temp));
 243         memset(temp, 0, sizeof(*temp));
 244         temp->filename = estrdup(filename);
 245         temp->req_list = NULL;
 246         temp->prov_list = NULL;
 247         temp->keyword_list = NULL;
 248         temp->in_progress = RESET;
 249         /*
 250          * link the filenode into the list of filenodes.
 251          * note that the double linking means we can delete a
 252          * filenode without searching for where it belongs.
 253          */
 254         temp->next = fn_head->next;
 255         if (temp->next != NULL)
 256                 temp->next->last = temp;
 257         temp->last = fn_head;
 258         fn_head->next = temp;
 259         return (temp);
 260 }
 261
 262 /*
 263  * add a requirement to a filenode.
 264  */
 265 void
 266 add_require(filenode *fnode, char *s)
 267 {
 268         Hash_Entry *entry;
 269         f_reqnode *rnode;
 270         int new;
 271
 272         entry = Hash_CreateEntry(provide_hash, s, &new);
 273         if (new)
 274                 Hash_SetValue(entry, NULL);
 275         rnode = emalloc(sizeof(*rnode));
 276         rnode->entry = entry;
 277         rnode->next = fnode->req_list;
 278         fnode->req_list = rnode;
 279 }
 280
 281 /*
 282  * add a provision to a filenode.  if this provision doesn't
 283  * have a head node, create one here.
 284  */
 285 void
 286 add_provide(filenode *fnode, char *s)
 287 {
 288         Hash_Entry *entry;
 289         f_provnode *f_pnode;
 290         provnode *pnode, *head;
 291         int new;
 292
 293         entry = Hash_CreateEntry(provide_hash, s, &new);
 294         head = Hash_GetValue(entry);
 295
 296         /* create a head node if necessary. */
 297         if (head == NULL) {
 298                 head = emalloc(sizeof(*head));
 299                 head->head = SET;
 300                 head->in_progress = RESET;
 301                 head->fnode = NULL;
 302                 head->last = head->next = NULL;
 303                 Hash_SetValue(entry, head);
 304         }
 305 #if 0
 306         /*
 307          * Don't warn about this.  We want to be able to support
 308          * scripts that do two complex things:
 309          *
 310          *      - Two independent scripts which both provide the
 311          *        same thing.  Both scripts must be executed in
 312          *        any order to meet the barrier.  An example:
 313          *
 314          *              Script 1:
 315          *
 316          *                      PROVIDE: mail
 317          *                      REQUIRE: LOGIN
 318          *
 319          *              Script 2:
 320          *
 321          *                      PROVIDE: mail
 322          *                      REQUIRE: LOGIN
 323          *
 324          *      - Two interdependent scripts which both provide the
 325          *        same thing.  Both scripts must be executed in
 326          *        graph order to meet the barrier.  An example:
 327          *
 328          *              Script 1:
 329          *
 330          *                      PROVIDE: nameservice dnscache
 331          *                      REQUIRE: SERVERS
 332          *
 333          *              Script 2:
 334          *
 335          *                      PROVIDE: nameservice nscd
 336          *                      REQUIRE: dnscache
 337          */
 338         else if (new == 0) {
 339                 warnx("file `%s' provides `%s'.", fnode->filename, s);
 340                 warnx("\tpreviously seen in `%s'.",
 341                     head->next->fnode->filename);
 342         }
 343 #endif
 344
 345         pnode = emalloc(sizeof(*pnode));
 346         pnode->head = RESET;
 347         pnode->in_progress = RESET;
 348         pnode->fnode = fnode;
 349         pnode->next = head->next;
 350         pnode->last = head;
 351         pnode->name = strdup(s);
 352         head->next = pnode;
 353         if (pnode->next != NULL)
 354                 pnode->next->last = pnode;
 355
 356         f_pnode = emalloc(sizeof(*f_pnode));
 357         f_pnode->pnode = pnode;
 358         f_pnode->next = fnode->prov_list;
 359         fnode->prov_list = f_pnode;
 360 }
 361
 362 /*
 363  * put the BEFORE: lines to a list and handle them later.
 364  */
 365 void
 366 add_before(filenode *fnode, char *s)
 367 {
 368         strnodelist *bf_ent;
 369
 370         bf_ent = emalloc(sizeof *bf_ent + strlen(s));
 371         bf_ent->node = fnode;
 372         strcpy(bf_ent->s, s);
 373         bf_ent->next = bl_list;
 374         bl_list = bf_ent;
 375 }
 376
 377 /*
 378  * add a key to a filenode.
 379  */
 380 void
 381 add_keyword(filenode *fnode, char *s)
 382 {
 383
 384         strnode_add(&fnode->keyword_list, s, fnode);
 385 }
 386
 387 /*
 388  * loop over the rest of a REQUIRE line, giving each word to
 389  * add_require() to do the real work.
 390  */
 391 void
 392 parse_require(filenode *node, char *buffer)
 393 {
 394         char *s;
 395
 396         while ((s = strsep(&buffer, " \t\n")) != NULL)
 397                 if (*s != '\0')
 398                         add_require(node, s);
 399 }
 400
 401 /*
 402  * loop over the rest of a PROVIDE line, giving each word to
 403  * add_provide() to do the real work.
 404  */
 405 void
 406 parse_provide(filenode *node, char *buffer)
 407 {
 408         char *s;
 409
 410         while ((s = strsep(&buffer, " \t\n")) != NULL)
 411                 if (*s != '\0')
 412                         add_provide(node, s);
 413 }
 414
 415 /*
 416  * loop over the rest of a BEFORE line, giving each word to
 417  * add_before() to do the real work.
 418  */
 419 void
 420 parse_before(filenode *node, char *buffer)
 421 {
 422         char *s;
 423
 424         while ((s = strsep(&buffer, " \t\n")) != NULL)
 425                 if (*s != '\0')
 426                         add_before(node, s);
 427 }
 428
 429 /*
 430  * loop over the rest of a KEYWORD line, giving each word to
 431  * add_keyword() to do the real work.
 432  */
 433 void
 434 parse_keywords(filenode *node, char *buffer)
 435 {
 436         char *s;
 437
 438         while ((s = strsep(&buffer, " \t\n")) != NULL)
 439                 if (*s != '\0')
 440                         add_keyword(node, s);
 441 }
 442
 443 /*
 444  * given a file name, create a filenode for it, read in lines looking
 445  * for provision and requirement lines, building the graphs as needed.
 446  */
 447 void
 448 crunch_file(char *filename)
 449 {
 450         FILE *fp;
 451         char *buf;
 452         int require_flag, provide_flag, before_flag, keywords_flag;
 453         enum { BEFORE_PARSING, PARSING, PARSING_DONE } state;
 454         filenode *node;
 455         char delims[3] = { '\\', '\\', '\0' };
 456         struct stat st;
 457
 458         if ((fp = fopen(filename, "r")) == NULL) {
 459                 warn("could not open %s", filename);
 460                 return;
 461         }
 462
 463         if (fstat(fileno(fp), &st) == -1) {
 464                 warn("could not stat %s", filename);
 465                 fclose(fp);
 466                 return;
 467         }
 468
 469         if (!S_ISREG(st.st_mode)) {
 470 #if 0
 471                 warnx("%s is not a file", filename);
 472 #endif
 473                 fclose(fp);
 474                 return;
 475         }
 476
 477         node = filenode_new(filename);
 478
 479         /*
 480          * we don't care about length, line number, don't want # for comments,
 481          * and have no flags.
 482          */
 483         for (state = BEFORE_PARSING; state != PARSING_DONE &&
 484             (buf = fparseln(fp, NULL, NULL, delims, 0)) != NULL; free(buf)) {
 485                 require_flag = provide_flag = before_flag = keywords_flag = 0;
 486                 if (strncmp(REQUIRE_STR, buf, REQUIRE_LEN) == 0)
 487                         require_flag = REQUIRE_LEN;
 488                 else if (strncmp(REQUIRES_STR, buf, REQUIRES_LEN) == 0)
 489                         require_flag = REQUIRES_LEN;
 490                 else if (strncmp(PROVIDE_STR, buf, PROVIDE_LEN) == 0)
 491                         provide_flag = PROVIDE_LEN;
 492                 else if (strncmp(PROVIDES_STR, buf, PROVIDES_LEN) == 0)
 493                         provide_flag = PROVIDES_LEN;
 494                 else if (strncmp(BEFORE_STR, buf, BEFORE_LEN) == 0)
 495                         before_flag = BEFORE_LEN;
 496                 else if (strncmp(KEYWORD_STR, buf, KEYWORD_LEN) == 0)
 497                         keywords_flag = KEYWORD_LEN;
 498                 else if (strncmp(KEYWORDS_STR, buf, KEYWORDS_LEN) == 0)
 499                         keywords_flag = KEYWORDS_LEN;
 500                 else {
 501                         if (state == PARSING)
 502                                 state = PARSING_DONE;
 503                         continue;
 504                 }
 505
 506                 state = PARSING;
 507                 if (require_flag)
 508                         parse_require(node, buf + require_flag);
 509                 else if (provide_flag)
 510                         parse_provide(node, buf + provide_flag);
 511                 else if (before_flag)
 512                         parse_before(node, buf + before_flag);
 513                 else if (keywords_flag)
 514                         parse_keywords(node, buf + keywords_flag);
 515         }
 516         fclose(fp);
 517 }
 518
 519 Hash_Entry *
 520 make_fake_provision(filenode *node)
 521 {
 522         Hash_Entry *entry;
 523         f_provnode *f_pnode;
 524         provnode *head, *pnode;
 525         static  int i = 0;
 526         int     new;
 527         char buffer[30];
 528
 529         do {
 530                 snprintf(buffer, sizeof buffer, "fake_prov_%08d", i++);
 531                 entry = Hash_CreateEntry(provide_hash, buffer, &new);
 532         } while (new == 0);
 533         head = emalloc(sizeof(*head));
 534         head->head = SET;
 535         head->in_progress = RESET;
 536         head->fnode = NULL;
 537         head->last = head->next = NULL;
 538         Hash_SetValue(entry, head);
 539
 540         pnode = emalloc(sizeof(*pnode));
 541         pnode->head = RESET;
 542         pnode->in_progress = RESET;
 543         pnode->fnode = node;
 544         pnode->next = head->next;
 545         pnode->last = head;
 546         pnode->name = strdup(buffer);
 547         head->next = pnode;
 548         if (pnode->next != NULL)
 549                 pnode->next->last = pnode;
 550
 551         f_pnode = emalloc(sizeof(*f_pnode));
 552         f_pnode->pnode = pnode;
 553         f_pnode->next = node->prov_list;
 554         node->prov_list = f_pnode;
 555
 556         return (entry);
 557 }
 558
 559 /*
 560  * go through the BEFORE list, inserting requirements into the graph(s)
 561  * as required.  in the before list, for each entry B, we have a file F
 562  * and a string S.  we create a "fake" provision (P) that F provides.
 563  * for each entry in the provision list for S, add a requirement to
 564  * that provisions filenode for P.
 565  */
 566 void
 567 insert_before(void)
 568 {
 569         Hash_Entry *entry, *fake_prov_entry;
 570         provnode *pnode;
 571         f_reqnode *rnode;
 572         strnodelist *bl;
 573         int new;
 574
 575         while (bl_list != NULL) {
 576                 bl = bl_list->next;
 577
 578                 fake_prov_entry = make_fake_provision(bl_list->node);
 579
 580                 entry = Hash_CreateEntry(provide_hash, bl_list->s, &new);
 581                 if (new == 1 && !provide)
 582                         warnx("file `%s' is before unknown provision `%s'", bl_list->node->filename, bl_list->s);
 583
 584                 for (pnode = Hash_GetValue(entry); pnode; pnode = pnode->next) {
 585                         if (pnode->head)
 586                                 continue;
 587
 588                         rnode = emalloc(sizeof(*rnode));
 589                         rnode->entry = fake_prov_entry;
 590                         rnode->next = pnode->fnode->req_list;
 591                         pnode->fnode->req_list = rnode;
 592                 }
 593
 594                 free(bl_list);
 595                 bl_list = bl;
 596         }
 597 }
 598
 599 /*
 600  * loop over all the files calling crunch_file() on them to do the
 601  * real work.  after we have built all the nodes, insert the BEFORE:
 602  * lines into graph(s).
 603  */
 604 void
 605 crunch_all_files(void)
 606 {
 607         int i;
 608
 609         for (i = 0; i < file_count; i++)
 610                 crunch_file(file_list[i]);
 611         insert_before();
 612 }
 613
 614 /*
 615  * below are the functions that traverse the graphs we have built
 616  * finding out the desired ordering, printing each file in turn.
 617  * if missing requirements, or cyclic graphs are detected, a
 618  * warning will be issued, and we will continue on..
 619  */
 620
 621 /*
 622  * given a requirement node (in a filename) we attempt to satisfy it.
 623  * we do some sanity checking first, to ensure that we have providers,
 624  * aren't already satisfied and aren't already being satisfied (ie,
 625  * cyclic).  if we pass all this, we loop over the provision list
 626  * calling do_file() (enter recursion) for each filenode in this
 627  * provision.
 628  */
 629 void
 630 satisfy_req(f_reqnode *rnode, char *filename)
 631 {
 632         Hash_Entry *entry;
 633         provnode *head;
 634
 635         entry = rnode->entry;
 636         head = Hash_GetValue(entry);
 637
 638         if (head == NULL) {
 639                 warnx("requirement `%s' in file `%s' has no providers.",
 640                     Hash_GetKey(entry), filename);
 641                 exit_code = 1;
 642                 return;
 643         }
 644
 645         /* return if the requirement is already satisfied. */
 646         if (head->next == NULL)
 647                 return;
 648
 649         /*
 650          * if list is marked as in progress,
 651          *      print that there is a circular dependency on it and abort
 652          */
 653         if (head->in_progress == SET) {
 654                 warnx("Circular dependency on provision `%s' in file `%s'.",
 655                     Hash_GetKey(entry), filename);
 656                 exit_code = 1;
 657                 return;
 658         }
 659
 660         head->in_progress = SET;
 661
 662         /*
 663          * while provision_list is not empty
 664          *      do_file(first_member_of(provision_list));
 665          */
 666         while (head->next != NULL)
 667                 do_file(head->next->fnode);
 668 }
 669
 670 int
 671 skip_ok(filenode *fnode)
 672 {
 673         strnodelist *s;
 674         strnodelist *k;
 675
 676         for (s = skip_list; s; s = s->next)
 677                 for (k = fnode->keyword_list; k; k = k->next)
 678                         if (strcmp(k->s, s->s) == 0)
 679                                 return (0);
 680
 681         return (1);
 682 }
 683
 684 int
 685 keep_ok(filenode *fnode)
 686 {
 687         strnodelist *s;
 688         strnodelist *k;
 689
 690         for (s = keep_list; s; s = s->next)
 691                 for (k = fnode->keyword_list; k; k = k->next)
 692                         if (strcmp(k->s, s->s) == 0)
 693                                 return (1);
 694
 695         /* an empty keep_list means every one */
 696         return (!keep_list);
 697 }
 698
 699 /*
 700  * given a filenode, we ensure we are not a cyclic graph.  if this
 701  * is ok, we loop over the filenodes requirements, calling satisfy_req()
 702  * for each of them.. once we have done this, remove this filenode
 703  * from each provision table, as we are now done.
 704  *
 705  * NOTE: do_file() is called recursively from several places and cannot
 706  * safely free() anything related to items that may be recursed on.
 707  * Circular dependancies will cause problems if we do.
 708  */
 709 void
 710 do_file(filenode *fnode)
 711 {
 712         f_reqnode *r;
 713         /*f_reqnode *r_tmp;*/
 714         f_provnode *p, *p_tmp;
 715         provnode *pnode;
 716         int was_set;
 717
 718         DPRINTF((stderr, "do_file on %s.\n", fnode->filename));
 719
 720         /*
 721          * if fnode is marked as in progress,
 722          *       print that fnode; is circularly depended upon and abort.
 723          */
 724         if (fnode->in_progress == SET) {
 725                 warnx("Circular dependency on file `%s'.",
 726                         fnode->filename);
 727                 was_set = exit_code = 1;
 728         } else
 729                 was_set = 0;
 730
 731         /* mark fnode */
 732         fnode->in_progress = SET;
 733
 734         /*
 735          * for each requirement of fnode -> r
 736          *      satisfy_req(r, filename)
 737          */
 738         r = fnode->req_list;
 739         while (r != NULL) {
 740                 /*r_tmp = r;*/
 741                 satisfy_req(r, fnode->filename);
 742                 r = r->next;
 743                 /*free(r_tmp);*/
 744         }
 745         fnode->req_list = NULL;
 746
 747         /*
 748          * for each provision of fnode -> p
 749          *      remove fnode from provision list for p in hash table
 750          */
 751         p = fnode->prov_list;
 752         while (p != NULL) {
 753                 p_tmp = p;
 754                 pnode = p->pnode;
 755                 if (pnode->next != NULL) {
 756                         pnode->next->last = pnode->last;
 757                 }
 758                 if (pnode->last != NULL) {
 759                         pnode->last->next = pnode->next;
 760                 }
 761                 free(pnode);
 762                 p = p->next;
 763                 free(p_tmp);
 764         }
 765         fnode->prov_list = NULL;
 766
 767         /* do_it(fnode) */
 768         DPRINTF((stderr, "next do: "));
 769
 770         /* if we were already in progress, don't print again */
 771         if (was_set == 0 && skip_ok(fnode) && keep_ok(fnode))
 772                 printf("%s\n", fnode->filename);
 773
 774         if (fnode->next != NULL) {
 775                 fnode->next->last = fnode->last;
 776         }
 777         if (fnode->last != NULL) {
 778                 fnode->last->next = fnode->next;
 779         }
 780
 781         DPRINTF((stderr, "nuking %s\n", fnode->filename));
 782         /*free(fnode->filename);*/
 783         /*free(fnode);*/
 784 }
 785
 786 void
 787 generate_ordering(void)
 788 {
 789
 790         /*
 791          * while there remain undone files{f},
 792          *      pick an arbitrary f, and do_file(f)
 793          * Note that the first file in the file list is perfectly
 794          * arbitrary, and easy to find, so we use that.
 795          */
 796
 797         /*
 798          * N.B.: the file nodes "self delete" after they execute, so
 799          * after each iteration of the loop, the head will be pointing
 800          * to something totally different. The loop ends up being
 801          * executed only once for every strongly connected set of
 802          * nodes.
 803          */
 804         if (provide) {
 805                 /*
 806                  * List all keywords provided by the listed files
 807                  */
 808                 filenode *file;
 809                 f_provnode *f_prov;
 810
 811                 for (file = fn_head->next; file; file = file->next) {
 812                     for (f_prov = file->prov_list; f_prov; f_prov = f_prov->next) {
 813                         if (strncmp(f_prov->pnode->name, "fake_", 5) != 0)
 814                             printf("%s\n", f_prov->pnode->name);
 815                     }
 816                 }
 817         } else if (onetime_list) {
 818                 /*
 819                  * Only list dependanacies required to start particular
 820                  * keywords.
 821                  */
 822                 strnodelist *scan;
 823                 filenode *file;
 824                 f_provnode *f_prov;
 825
 826                 for (scan = onetime_list; scan; scan = scan->next) {
 827                     for (file = fn_head->next; file; file = file->next) {
 828                         for (f_prov = file->prov_list; f_prov; f_prov = f_prov->next) {
 829                             if (strcmp(scan->s, f_prov->pnode->name) == 0) {
 830                                 do_file(file);
 831                                 break;
 832                             }
 833                         }
 834                         if (f_prov)
 835                             break;
 836                     }
 837                 }
 838         } else {
 839                 while (fn_head->next != NULL) {
 840                         DPRINTF((stderr, "generate on %s\n", fn_head->next->filename));
 841                         do_file(fn_head->next);
 842                 }
 843         }
 844 }