lib/fsm.c

   1 /** \ingroup payload
   2  * \file lib/fsm.c
   3  * File state machine to handle a payload from a package.
   4  */
   5
   6 #include "system.h"
   7
   8 #include <utime.h>
   9 #include <errno.h>
  10 #if defined(HAVE_MMAP)
  11 #include <sys/mman.h>
  12 #endif
  13 #if WITH_CAP
  14 #include <sys/capability.h>
  15 #endif
  16
  17 #include <rpm/rpmte.h>
  18 #include <rpm/rpmts.h>
  19 #include <rpm/rpmsq.h>
  20 #include <rpm/rpmlog.h>
  21
  22 #include "rpmio/rpmio_internal.h"       /* fdInit/FiniDigest */
  23 #include "lib/cpio.h"
  24 #include "lib/fsm.h"
  25 #define fsmUNSAFE       fsmStage
  26 #include "lib/rpmfi_internal.h" /* XXX fi->apath, ... */
  27 #include "lib/rpmte_internal.h" /* XXX rpmfs */
  28 #include "lib/misc.h"           /* XXX unameToUid() and gnameToGid() */
  29
  30 #include "debug.h"
  31
  32 #define _FSM_DEBUG      0
  33 int _fsm_debug = _FSM_DEBUG;
  34
  35 /* XXX Failure to remove is not (yet) cause for failure. */
  36 static int strict_erasures = 0;
  37
  38 /** \ingroup payload
  39  * Keeps track of the set of all hard links to a file in an archive.
  40  */
  41 struct hardLink_s {
  42     hardLink_t next;
  43     const char ** nsuffix;
  44     int * filex;
  45     struct stat sb;
  46     nlink_t nlink;
  47     nlink_t linksLeft;
  48     int linkIndex;
  49     int createdPath;
  50 };
  51
  52 /** \ingroup payload
  53  * Iterator across package file info, forward on install, backward on erase.
  54  */
  55 struct fsmIterator_s {
  56     rpmts ts;                   /*!< transaction set. */
  57     rpmte te;                   /*!< transaction element. */
  58     rpmfi fi;                   /*!< transaction element file info. */
  59     int reverse;                /*!< reversed traversal? */
  60     int isave;                  /*!< last returned iterator index. */
  61     int i;                      /*!< iterator index. */
  62 };
  63
  64 /**
  65  * Retrieve transaction set from file state machine iterator.
  66  * @param fsm           file state machine
  67  * @return              transaction set
  68  */
  69 static rpmts fsmGetTs(const FSM_t fsm) {
  70     const FSMI_t iter = fsm->iter;
  71     return (iter ? iter->ts : NULL);
  72 }
  73
  74 /**
  75  * Retrieve transaction element file info from file state machine iterator.
  76  * @param fsm           file state machine
  77  * @return              transaction element file info
  78  */
  79 static rpmfi fsmGetFi(const FSM_t fsm)
  80 {
  81     const FSMI_t iter = fsm->iter;
  82     return (iter ? iter->fi : NULL);
  83 }
  84
  85 static rpmte fsmGetTe(const FSM_t fsm)
  86 {
  87     const FSMI_t iter = fsm->iter;
  88     return (iter ? iter->te : NULL);
  89 }
  90
  91 #define SUFFIX_RPMORIG  ".rpmorig"
  92 #define SUFFIX_RPMSAVE  ".rpmsave"
  93 #define SUFFIX_RPMNEW   ".rpmnew"
  94
  95 /* Default directory and file permissions if not mapped */
  96 #define _dirPerms 0755
  97 #define _filePerms 0644
  98
  99 /*
 100  * XXX Forward declarations for previously exported functions to avoid moving
 101  * things around needlessly
 102  */
 103 static const char * fileStageString(fileStage a);
 104 static const char * fileActionString(rpmFileAction a);
 105 static int fsmStage(FSM_t fsm, fileStage stage);
 106
 107 /** \ingroup payload
 108  * Build path to file from file info, ornamented with subdir and suffix.
 109  * @param fsm           file state machine data
 110  * @param st            file stat info
 111  * @param subdir        subdir to use (NULL disables)
 112  * @param suffix        suffix to use (NULL disables)
 113  * @retval              path to file (malloced)
 114  */
 115 static char * fsmFsPath(const FSM_t fsm,
 116                 const struct stat * st,
 117                 const char * subdir,
 118                 const char * suffix)
 119 {
 120     char * s = NULL;
 121
 122     if (fsm) {
 123         int isDir = (st && S_ISDIR(st->st_mode));
 124         s = rstrscat(NULL, fsm->dirName,
 125                            (!isDir && subdir) ? subdir : "",
 126                            fsm->baseName,
 127                            (!isDir && suffix) ? suffix : "",
 128                            NULL);
 129     }
 130     return s;
 131 }
 132
 133 /** \ingroup payload
 134  * Destroy file info iterator.
 135  * @param p             file info iterator
 136  * @retval              NULL always
 137  */
 138 static void * mapFreeIterator(void * p)
 139 {
 140     FSMI_t iter = p;
 141     if (iter) {
 142 /* XXX rpmswExit() */
 143         iter->ts = rpmtsFree(iter->ts);
 144         iter->te = NULL; /* XXX rpmte is not refcounted yet */
 145         iter->fi = rpmfiUnlink(iter->fi);
 146     }
 147     return _free(p);
 148 }
 149
 150 /** \ingroup payload
 151  * Create file info iterator.
 152  * @param ts            transaction set
 153  * @param fi            transaction element file info
 154  * @return              file info iterator
 155  */
 156 static void *
 157 mapInitIterator(rpmts ts, rpmte te, rpmfi fi)
 158 {
 159     FSMI_t iter = NULL;
 160
 161     iter = xcalloc(1, sizeof(*iter));
 162     iter->ts = rpmtsLink(ts);
 163     iter->te = te; /* XXX rpmte is not refcounted yet */
 164     iter->fi = rpmfiLink(fi);
 165     iter->reverse = (rpmteType(te) == TR_REMOVED);
 166     iter->i = (iter->reverse ? (rpmfiFC(fi) - 1) : 0);
 167     iter->isave = iter->i;
 168     return iter;
 169 }
 170
 171 /** \ingroup payload
 172  * Return next index into file info.
 173  * @param a             file info iterator
 174  * @return              next index, -1 on termination
 175  */
 176 static int mapNextIterator(void * a)
 177 {
 178     FSMI_t iter = a;
 179     int i = -1;
 180
 181     if (iter) {
 182         const rpmfi fi = iter->fi;
 183         if (iter->reverse) {
 184             if (iter->i >= 0)   i = iter->i--;
 185         } else {
 186             if (iter->i < rpmfiFC(fi))  i = iter->i++;
 187         }
 188         iter->isave = i;
 189     }
 190     return i;
 191 }
 192
 193 /** \ingroup payload
 194  */
 195 static int cpioStrCmp(const void * a, const void * b)
 196 {
 197     const char * afn = *(const char **)a;
 198     const char * bfn = *(const char **)b;
 199
 200     /* Match rpm-4.0 payloads with ./ prefixes. */
 201     if (afn[0] == '.' && afn[1] == '/') afn += 2;
 202     if (bfn[0] == '.' && bfn[1] == '/') bfn += 2;
 203
 204     /* If either path is absolute, make it relative. */
 205     if (afn[0] == '/')  afn += 1;
 206     if (bfn[0] == '/')  bfn += 1;
 207
 208     return strcmp(afn, bfn);
 209 }
 210
 211 /** \ingroup payload
 212  * Locate archive path in file info.
 213  * @param iter          file info iterator
 214  * @param fsmPath       archive path
 215  * @return              index into file info, -1 if archive path was not found
 216  */
 217 static int mapFind(FSMI_t iter, const char * fsmPath)
 218 {
 219     int ix = -1;
 220
 221     if (iter) {
 222         const rpmfi fi = iter->fi;
 223         int fc = rpmfiFC(fi);
 224         if (fi && fc > 0 && fi->apath && fsmPath && *fsmPath) {
 225             char ** p = NULL;
 226
 227             if (fi->apath != NULL)
 228                 p = bsearch(&fsmPath, fi->apath, fc, sizeof(fsmPath),
 229                         cpioStrCmp);
 230             if (p) {
 231                 iter->i = p - fi->apath;
 232                 ix = mapNextIterator(iter);
 233             }
 234         }
 235     }
 236     return ix;
 237 }
 238
 239 /** \ingroup payload
 240  * Directory name iterator.
 241  */
 242 typedef struct dnli_s {
 243     rpmfi fi;
 244     char * active;
 245     int reverse;
 246     int isave;
 247     int i;
 248 } * DNLI_t;
 249
 250 /** \ingroup payload
 251  * Destroy directory name iterator.
 252  * @param a             directory name iterator
 253  * @retval              NULL always
 254  */
 255 static void * dnlFreeIterator(void * a)
 256 {
 257     if (a) {
 258         DNLI_t dnli = (void *)a;
 259         if (dnli->active) free(dnli->active);
 260     }
 261     return _free(a);
 262 }
 263
 264 /** \ingroup payload
 265  */
 266 static inline int dnlCount(const DNLI_t dnli)
 267 {
 268     return (dnli ? rpmfiDC(dnli->fi) : 0);
 269 }
 270
 271 /** \ingroup payload
 272  */
 273 static inline int dnlIndex(const DNLI_t dnli)
 274 {
 275     return (dnli ? dnli->isave : -1);
 276 }
 277
 278 /** \ingroup payload
 279  * Create directory name iterator.
 280  * @param fsm           file state machine data
 281  * @param reverse       traverse directory names in reverse order?
 282  * @return              directory name iterator
 283  */
 284 static
 285 void * dnlInitIterator(const FSM_t fsm,
 286                 int reverse)
 287
 288 {
 289     rpmfi fi = fsmGetFi(fsm);
 290     rpmfs fs = rpmteGetFileStates(fsmGetTe(fsm));
 291     DNLI_t dnli;
 292     int i, j;
 293     int dc;
 294
 295     if (fi == NULL)
 296         return NULL;
 297     dc = rpmfiDC(fi);
 298     dnli = xcalloc(1, sizeof(*dnli));
 299     dnli->fi = fi;
 300     dnli->reverse = reverse;
 301     dnli->i = (reverse ? dc : 0);
 302
 303     if (dc) {
 304         dnli->active = xcalloc(dc, sizeof(*dnli->active));
 305         int fc = rpmfiFC(fi);
 306
 307         /* Identify parent directories not skipped. */
 308         for (i = 0; i < fc; i++)
 309             if (!XFA_SKIPPING(rpmfsGetAction(fs, i)))
 310                 dnli->active[rpmfiDIIndex(fi, i)] = 1;
 311
 312         /* Exclude parent directories that are explicitly included. */
 313         for (i = 0; i < fc; i++) {
 314             int dil;
 315             size_t dnlen, bnlen;
 316
 317             if (!S_ISDIR(rpmfiFModeIndex(fi, i)))
 318                 continue;
 319
 320             dil = rpmfiDIIndex(fi, i);
 321             dnlen = strlen(rpmfiDNIndex(fi, dil));
 322             bnlen = strlen(rpmfiBNIndex(fi, i));
 323
 324             for (j = 0; j < dc; j++) {
 325                 const char * dnl;
 326                 size_t jlen;
 327
 328                 if (!dnli->active[j] || j == dil)
 329                     continue;
 330                 dnl = rpmfiDNIndex(fi, j);
 331                 jlen = strlen(dnl);
 332                 if (jlen != (dnlen+bnlen+1))
 333                     continue;
 334                 if (!rstreqn(dnl, rpmfiDNIndex(fi, dil), dnlen))
 335                     continue;
 336                 if (!rstreqn(dnl+dnlen, rpmfiBNIndex(fi, i), bnlen))
 337                     continue;
 338                 if (dnl[dnlen+bnlen] != '/' || dnl[dnlen+bnlen+1] != '\0')
 339                     continue;
 340                 /* This directory is included in the package. */
 341                 dnli->active[j] = 0;
 342                 break;
 343             }
 344         }
 345
 346         /* Print only once per package. */
 347         if (!reverse) {
 348             j = 0;
 349             for (i = 0; i < dc; i++) {
 350                 if (!dnli->active[i]) continue;
 351                 if (j == 0) {
 352                     j = 1;
 353                     rpmlog(RPMLOG_DEBUG,
 354         "========== Directories not explicitly included in package:\n");
 355                 }
 356                 rpmlog(RPMLOG_DEBUG, "%10d %s\n", i, rpmfiDNIndex(fi, i));
 357             }
 358             if (j)
 359                 rpmlog(RPMLOG_DEBUG, "==========\n");
 360         }
 361     }
 362     return dnli;
 363 }
 364
 365 /** \ingroup payload
 366  * Return next directory name (from file info).
 367  * @param dnli          directory name iterator
 368  * @return              next directory name
 369  */
 370 static
 371 const char * dnlNextIterator(DNLI_t dnli)
 372 {
 373     const char * dn = NULL;
 374
 375     if (dnli) {
 376         rpmfi fi = dnli->fi;
 377         int dc = rpmfiDC(fi);
 378         int i = -1;
 379
 380         if (dnli->active)
 381         do {
 382             i = (!dnli->reverse ? dnli->i++ : --dnli->i);
 383         } while (i >= 0 && i < dc && !dnli->active[i]);
 384
 385         if (i >= 0 && i < dc)
 386             dn = rpmfiDNIndex(fi, i);
 387         else
 388             i = -1;
 389         dnli->isave = i;
 390     }
 391     return dn;
 392 }
 393
 394 int fsmNext(FSM_t fsm, fileStage nstage)
 395 {
 396     fsm->nstage = nstage;
 397     return fsmStage(fsm, fsm->nstage);
 398 }
 399
 400 /**
 401  * Map next file path and action.
 402  * @param fsm           file state machine
 403  */
 404 static int fsmMapPath(FSM_t fsm)
 405 {
 406     rpmfi fi = fsmGetFi(fsm);   /* XXX const except for fstates */
 407     int rc = 0;
 408     int i;
 409
 410     fsm->osuffix = NULL;
 411     fsm->nsuffix = NULL;
 412     fsm->action = FA_UNKNOWN;
 413
 414     i = fsm->ix;
 415     if (fi && i >= 0 && i < rpmfiFC(fi)) {
 416         rpmte te = fsmGetTe(fsm);
 417         rpmfs fs = rpmteGetFileStates(te);
 418         /* XXX these should use rpmfiFFlags() etc */
 419         fsm->action = rpmfsGetAction(fs, i);
 420         fsm->fflags = rpmfiFFlagsIndex(fi, i);
 421
 422         /* src rpms have simple base name in payload. */
 423         fsm->dirName = rpmfiDNIndex(fi, rpmfiDIIndex(fi, i));
 424         fsm->baseName = rpmfiBNIndex(fi, i);
 425
 426         switch (fsm->action) {
 427         case FA_SKIP:
 428             break;
 429         case FA_UNKNOWN:
 430             break;
 431
 432         case FA_COPYOUT:
 433             break;
 434         case FA_COPYIN:
 435         case FA_CREATE:
 436             break;
 437
 438         case FA_SKIPNSTATE:
 439             if (rpmteType(te) == TR_ADDED)
 440                 rpmfsSetState(fs, i, RPMFILE_STATE_NOTINSTALLED);
 441             break;
 442
 443         case FA_SKIPNETSHARED:
 444             if (rpmteType(te) == TR_ADDED)
 445                 rpmfsSetState(fs, i, RPMFILE_STATE_NETSHARED);
 446             break;
 447
 448         case FA_SKIPCOLOR:
 449             if (rpmteType(te) == TR_ADDED)
 450                 rpmfsSetState(fs, i, RPMFILE_STATE_WRONGCOLOR);
 451             break;
 452
 453         case FA_BACKUP:
 454             if (!(fsm->fflags & RPMFILE_GHOST)) /* XXX Don't if %ghost file. */
 455             switch (rpmteType(te)) {
 456             case TR_ADDED:
 457                 fsm->osuffix = SUFFIX_RPMORIG;
 458                 break;
 459             case TR_REMOVED:
 460                 fsm->osuffix = SUFFIX_RPMSAVE;
 461                 break;
 462             }
 463             break;
 464
 465         case FA_ALTNAME:
 466             assert(rpmteType(te) == TR_ADDED);
 467             if (!(fsm->fflags & RPMFILE_GHOST)) /* XXX Don't if %ghost file. */
 468                 fsm->nsuffix = SUFFIX_RPMNEW;
 469             break;
 470
 471         case FA_SAVE:
 472             assert(rpmteType(te) == TR_ADDED);
 473             if (!(fsm->fflags & RPMFILE_GHOST)) /* XXX Don't if %ghost file. */
 474                 fsm->osuffix = SUFFIX_RPMSAVE;
 475             break;
 476         case FA_ERASE:
 477 #if 0   /* XXX is this a genhdlist fix? */
 478             assert(rpmteType(>te) == TR_REMOVED);
 479 #endif
 480             /*
 481              * XXX TODO: %ghost probably shouldn't be removed, but that changes
 482              * legacy rpm behavior.
 483              */
 484             break;
 485         default:
 486             break;
 487         }
 488
 489         if ((fsm->mapFlags & CPIO_MAP_PATH) || fsm->nsuffix) {
 490             const struct stat * st = &fsm->sb;
 491             fsm->path = _free(fsm->path);
 492             fsm->path = fsmFsPath(fsm, st, fsm->subdir,
 493                 (fsm->suffix ? fsm->suffix : fsm->nsuffix));
 494         }
 495     }
 496     return rc;
 497 }
 498
 499 /** \ingroup payload
 500  * Save hard link in chain.
 501  * @param fsm           file state machine data
 502  * @return              Is chain only partially filled?
 503  */
 504 static int saveHardLink(FSM_t fsm)
 505 {
 506     struct stat * st = &fsm->sb;
 507     int rc = 0;
 508     int ix = -1;
 509     int j;
 510
 511     /* Find hard link set. */
 512     for (fsm->li = fsm->links; fsm->li; fsm->li = fsm->li->next) {
 513         if (fsm->li->sb.st_ino == st->st_ino && fsm->li->sb.st_dev == st->st_dev)
 514             break;
 515     }
 516
 517     /* New hard link encountered, add new link to set. */
 518     if (fsm->li == NULL) {
 519         fsm->li = xcalloc(1, sizeof(*fsm->li));
 520         fsm->li->next = NULL;
 521         fsm->li->sb = *st;      /* structure assignment */
 522         fsm->li->nlink = st->st_nlink;
 523         fsm->li->linkIndex = fsm->ix;
 524         fsm->li->createdPath = -1;
 525
 526         fsm->li->filex = xcalloc(st->st_nlink, sizeof(fsm->li->filex[0]));
 527         memset(fsm->li->filex, -1, (st->st_nlink * sizeof(fsm->li->filex[0])));
 528         fsm->li->nsuffix = xcalloc(st->st_nlink, sizeof(*fsm->li->nsuffix));
 529
 530         if (fsm->goal == FSM_PKGBUILD)
 531             fsm->li->linksLeft = st->st_nlink;
 532         if (fsm->goal == FSM_PKGINSTALL)
 533             fsm->li->linksLeft = 0;
 534
 535         fsm->li->next = fsm->links;
 536         fsm->links = fsm->li;
 537     }
 538
 539     if (fsm->goal == FSM_PKGBUILD) --fsm->li->linksLeft;
 540     fsm->li->filex[fsm->li->linksLeft] = fsm->ix;
 541     fsm->li->nsuffix[fsm->li->linksLeft] = fsm->nsuffix;
 542     if (fsm->goal == FSM_PKGINSTALL) fsm->li->linksLeft++;
 543
 544     if (fsm->goal == FSM_PKGBUILD)
 545         return (fsm->li->linksLeft > 0);
 546
 547     if (fsm->goal != FSM_PKGINSTALL)
 548         return 0;
 549
 550     if (!(st->st_size || fsm->li->linksLeft == st->st_nlink))
 551         return 1;
 552
 553     /* Here come the bits, time to choose a non-skipped file name. */
 554     {   rpmfs fs = rpmteGetFileStates(fsmGetTe(fsm));
 555
 556         for (j = fsm->li->linksLeft - 1; j >= 0; j--) {
 557             ix = fsm->li->filex[j];
 558             if (ix < 0 || XFA_SKIPPING(rpmfsGetAction(fs, ix)))
 559                 continue;
 560             break;
 561         }
 562     }
 563
 564     /* Are all links skipped or not encountered yet? */
 565     if (ix < 0 || j < 0)
 566         return 1;       /* XXX W2DO? */
 567
 568     /* Save the non-skipped file name and map index. */
 569     fsm->li->linkIndex = j;
 570     fsm->path = _free(fsm->path);
 571     fsm->ix = ix;
 572     rc = fsmMapPath(fsm);
 573     return rc;
 574 }
 575
 576 /** \ingroup payload
 577  * Destroy set of hard links.
 578  * @param li            set of hard links
 579  * @return              NULL always
 580  */
 581 static void * freeHardLink(hardLink_t li)
 582 {
 583     if (li) {
 584         li->nsuffix = _free(li->nsuffix);       /* XXX elements are shared */
 585         li->filex = _free(li->filex);
 586     }
 587     return _free(li);
 588 }
 589
 590 FSM_t newFSM(cpioMapFlags mapflags)
 591 {
 592     FSM_t fsm = xcalloc(1, sizeof(*fsm));
 593     fsm->mapFlags = mapflags;
 594     return fsm;
 595 }
 596
 597 FSM_t freeFSM(FSM_t fsm)
 598 {
 599     if (fsm) {
 600         fsm->path = _free(fsm->path);
 601         while ((fsm->li = fsm->links) != NULL) {
 602             fsm->links = fsm->li->next;
 603             fsm->li->next = NULL;
 604             fsm->li = freeHardLink(fsm->li);
 605         }
 606         fsm->dnlx = _free(fsm->dnlx);
 607         fsm->ldn = _free(fsm->ldn);
 608         fsm->iter = mapFreeIterator(fsm->iter);
 609     }
 610     return _free(fsm);
 611 }
 612
 613 int fsmSetup(FSM_t fsm, fileStage goal,
 614                 rpmts ts, rpmte te, rpmfi fi, FD_t cfd,
 615                 rpm_loff_t * archiveSize, char ** failedFile)
 616 {
 617     int rc, ec = 0;
 618
 619     fsm->goal = goal;
 620     if (cfd != NULL) {
 621         fsm->cfd = fdLink(cfd);
 622     }
 623     fsm->cpioPos = 0;
 624     fsm->iter = mapInitIterator(ts, te, fi);
 625     fsm->digestalgo = rpmfiDigestAlgo(fi);
 626
 627     if (fsm->goal == FSM_PKGINSTALL || fsm->goal == FSM_PKGBUILD) {
 628         void * ptr;
 629         fsm->archivePos = 0;
 630         ptr = rpmtsNotify(ts, te,
 631                 RPMCALLBACK_INST_START, fsm->archivePos, fi->archiveSize);
 632     }
 633
 634     fsm->archiveSize = archiveSize;
 635     if (fsm->archiveSize)
 636         *fsm->archiveSize = 0;
 637     fsm->failedFile = failedFile;
 638     if (fsm->failedFile)
 639         *fsm->failedFile = NULL;
 640
 641     memset(fsm->sufbuf, 0, sizeof(fsm->sufbuf));
 642     if (fsm->goal == FSM_PKGINSTALL) {
 643         if (ts && rpmtsGetTid(ts) != (rpm_tid_t)-1)
 644             sprintf(fsm->sufbuf, ";%08x", (unsigned)rpmtsGetTid(ts));
 645     }
 646
 647     ec = fsm->rc = 0;
 648     rc = fsmUNSAFE(fsm, FSM_CREATE);
 649     if (rc && !ec) ec = rc;
 650
 651     rc = fsmUNSAFE(fsm, fsm->goal);
 652     if (rc && !ec) ec = rc;
 653
 654     if (fsm->archiveSize && ec == 0)
 655         *fsm->archiveSize = fsm->cpioPos;
 656
 657 /* FIX: *fsm->failedFile may be NULL */
 658    return ec;
 659 }
 660
 661 int fsmTeardown(FSM_t fsm)
 662 {
 663     int rc = fsm->rc;
 664
 665     if (!rc)
 666         rc = fsmUNSAFE(fsm, FSM_DESTROY);
 667
 668     fsm->iter = mapFreeIterator(fsm->iter);
 669     if (fsm->cfd != NULL) {
 670         fsm->cfd = fdFree(fsm->cfd);
 671         fsm->cfd = NULL;
 672     }
 673     fsm->failedFile = NULL;
 674     return rc;
 675 }
 676
 677 static int fsmMapFContext(FSM_t fsm)
 678 {
 679     rpmts ts = fsmGetTs(fsm);
 680     struct stat * st;
 681     st = &fsm->sb;
 682
 683     /*
 684      * Find file security context (if not disabled).
 685      */
 686     fsm->fcontext = NULL;
 687     if (ts != NULL && !(rpmtsFlags(ts) & RPMTRANS_FLAG_NOCONTEXTS)) {
 688         security_context_t scon = NULL;
 689
 690         if (matchpathcon(fsm->path, st->st_mode, &scon) == 0 && scon != NULL) {
 691             fsm->fcontext = scon;
 692         }
 693     }
 694     return 0;
 695 }
 696
 697 #if WITH_CAP
 698 static int fsmMapFCaps(FSM_t fsm)
 699 {
 700     rpmfi fi = fsmGetFi(fsm);
 701     const char *captxt = rpmfiFCapsIndex(fi, fsm->ix);
 702     fsm->fcaps = NULL;
 703     if (captxt && *captxt != '\0') {
 704         cap_t fcaps = cap_from_text(captxt);
 705         if (fcaps) {
 706            fsm->fcaps = fcaps;
 707         }
 708     }
 709     return 0;
 710 }
 711 #endif
 712
 713 /**
 714  * Map file stat(2) info.
 715  * @param fsm           file state machine
 716  */
 717 static int fsmMapAttrs(FSM_t fsm)
 718 {
 719     struct stat * st = &fsm->sb;
 720     rpmfi fi = fsmGetFi(fsm);
 721     int i = fsm->ix;
 722
 723     /* this check is pretty moot,  rpmfi accessors check array bounds etc */
 724     if (fi && i >= 0 && i < rpmfiFC(fi)) {
 725         mode_t finalMode = rpmfiFModeIndex(fi, i);
 726         dev_t finalRdev = rpmfiFRdevIndex(fi, i);
 727         time_t finalMtime = rpmfiFMtimeIndex(fi, i);
 728         const char *user = rpmfiFUserIndex(fi, i);
 729         const char *group = rpmfiFGroupIndex(fi, i);
 730         uid_t uid = 0;
 731         gid_t gid = 0;
 732
 733         if (user && unameToUid(user, &uid)) {
 734             if (fsm->goal == FSM_PKGINSTALL)
 735                 rpmlog(RPMLOG_WARNING,
 736                     _("user %s does not exist - using root\n"), user);
 737             finalMode &= ~S_ISUID;      /* turn off suid bit */
 738         }
 739
 740         if (group && gnameToGid(group, &gid)) {
 741             if (fsm->goal == FSM_PKGINSTALL)
 742                 rpmlog(RPMLOG_WARNING,
 743                     _("group %s does not exist - using root\n"), group);
 744             finalMode &= ~S_ISGID;      /* turn off sgid bit */
 745         }
 746
 747         if (fsm->mapFlags & CPIO_MAP_MODE)
 748             st->st_mode = (st->st_mode & S_IFMT) | (finalMode & ~S_IFMT);
 749         if (fsm->mapFlags & CPIO_MAP_TYPE) {
 750             st->st_mode = (st->st_mode & ~S_IFMT) | (finalMode & S_IFMT);
 751             if ((S_ISCHR(st->st_mode) || S_ISBLK(st->st_mode))
 752             && st->st_nlink == 0)
 753                 st->st_nlink = 1;
 754             st->st_rdev = finalRdev;
 755             st->st_mtime = finalMtime;
 756         }
 757         if (fsm->mapFlags & CPIO_MAP_UID)
 758             st->st_uid = uid;
 759         if (fsm->mapFlags & CPIO_MAP_GID)
 760             st->st_gid = gid;
 761
 762         {   rpmts ts = fsmGetTs(fsm);
 763
 764             /*
 765              * Set file digest (if not disabled).
 766              */
 767             if (ts != NULL && !(rpmtsFlags(ts) & RPMTRANS_FLAG_NOFILEDIGEST)) {
 768                 fsm->digest = rpmfiFDigestIndex(fi, i, NULL, NULL);
 769             } else {
 770                 fsm->digest = NULL;
 771             }
 772         }
 773     }
 774     return 0;
 775 }
 776
 777 /** \ingroup payload
 778  * Create file from payload stream.
 779  * @param fsm           file state machine data
 780  * @return              0 on success
 781  */
 782 static int expandRegular(FSM_t fsm)
 783 {
 784     const struct stat * st = &fsm->sb;
 785     rpm_loff_t left = st->st_size;
 786     int rc = 0;
 787
 788     rc = fsmNext(fsm, FSM_WOPEN);
 789     if (rc)
 790         goto exit;
 791
 792     if (st->st_size > 0 && fsm->digest != NULL)
 793         fdInitDigest(fsm->wfd, fsm->digestalgo, 0);
 794
 795     while (left) {
 796
 797         fsm->wrlen = (left > fsm->wrsize ? fsm->wrsize : left);
 798         rc = fsmNext(fsm, FSM_DREAD);
 799         if (rc)
 800             goto exit;
 801
 802         rc = fsmNext(fsm, FSM_WRITE);
 803         if (rc)
 804             goto exit;
 805
 806         left -= fsm->wrnb;
 807
 808         /* don't call this with fileSize == fileComplete */
 809         if (!rc && left)
 810             (void) fsmNext(fsm, FSM_NOTIFY);
 811     }
 812
 813     if (st->st_size > 0 && fsm->digest) {
 814         void * digest = NULL;
 815         int asAscii = (fsm->digest == NULL ? 1 : 0);
 816
 817         (void) Fflush(fsm->wfd);
 818         fdFiniDigest(fsm->wfd, fsm->digestalgo, &digest, NULL, asAscii);
 819
 820         if (digest == NULL) {
 821             rc = CPIOERR_DIGEST_MISMATCH;
 822             goto exit;
 823         }
 824
 825         if (fsm->digest != NULL) {
 826             size_t diglen = rpmDigestLength(fsm->digestalgo);
 827             if (memcmp(digest, fsm->digest, diglen))
 828                 rc = CPIOERR_DIGEST_MISMATCH;
 829         } else {
 830             rc = CPIOERR_DIGEST_MISMATCH;
 831         }
 832         digest = _free(digest);
 833     }
 834
 835 exit:
 836     (void) fsmNext(fsm, FSM_WCLOSE);
 837     return rc;
 838 }
 839
 840 /** \ingroup payload
 841  * Write next item to payload stream.
 842  * @param fsm           file state machine data
 843  * @param writeData     should data be written?
 844  * @return              0 on success
 845  */
 846 static int writeFile(FSM_t fsm, int writeData)
 847 {
 848     char * path = fsm->path;
 849     char * opath = fsm->opath;
 850     struct stat * st = &fsm->sb;
 851     struct stat * ost = &fsm->osb;
 852     char * symbuf = NULL;
 853     rpm_loff_t left;
 854     int rc;
 855
 856     st->st_size = (writeData ? ost->st_size : 0);
 857
 858     if (S_ISDIR(st->st_mode)) {
 859         st->st_size = 0;
 860     } else if (S_ISLNK(st->st_mode)) {
 861         /*
 862          * While linux puts the size of a symlink in the st_size field,
 863          * I don't think that's a specified standard.
 864          */
 865         /* XXX NUL terminated result in fsm->rdbuf, len in fsm->rdnb. */
 866         rc = fsmUNSAFE(fsm, FSM_READLINK);
 867         if (rc) goto exit;
 868         st->st_size = fsm->rdnb;
 869         rstrcat(&symbuf, fsm->rdbuf);   /* XXX save readlink return. */
 870     }
 871
 872     if (fsm->mapFlags & CPIO_MAP_ABSOLUTE) {
 873         fsm->path = rstrscat(NULL, (fsm->mapFlags & CPIO_MAP_ADDDOT) ? "." : "",
 874                                    fsm->dirName, fsm->baseName, NULL);
 875     } else if (fsm->mapFlags & CPIO_MAP_PATH) {
 876         rpmfi fi = fsmGetFi(fsm);
 877         fsm->path = xstrdup((fi->apath ? fi->apath[fsm->ix] :
 878                                          rpmfiBNIndex(fi, fsm->ix)));
 879     }
 880
 881     rc = fsmNext(fsm, FSM_HWRITE);
 882     _free(fsm->path);
 883     fsm->path = path;
 884     if (rc) goto exit;
 885
 886     if (writeData && S_ISREG(st->st_mode)) {
 887 #ifdef HAVE_MMAP
 888         char * rdbuf = NULL;
 889         void * mapped = MAP_FAILED;
 890         size_t nmapped;
 891         int xx;
 892 #endif
 893
 894         rc = fsmNext(fsm, FSM_ROPEN);
 895         if (rc) goto exit;
 896
 897         /* XXX unbuffered mmap generates *lots* of fdio debugging */
 898 #ifdef HAVE_MMAP
 899         nmapped = 0;
 900         mapped = mmap(NULL, st->st_size, PROT_READ, MAP_SHARED, Fileno(fsm->rfd), 0);
 901         if (mapped != MAP_FAILED) {
 902             rdbuf = fsm->rdbuf;
 903             fsm->rdbuf = (char *) mapped;
 904             fsm->rdlen = nmapped = st->st_size;
 905 #if defined(MADV_DONTNEED)
 906             xx = madvise(mapped, nmapped, MADV_DONTNEED);
 907 #endif
 908         }
 909 #endif
 910
 911         left = st->st_size;
 912
 913         while (left) {
 914 #ifdef HAVE_MMAP
 915           if (mapped != MAP_FAILED) {
 916             fsm->rdnb = nmapped;
 917           } else
 918 #endif
 919           {
 920             fsm->rdlen = (left > fsm->rdsize ? fsm->rdsize : left),
 921             rc = fsmNext(fsm, FSM_READ);
 922             if (rc) goto exit;
 923           }
 924
 925             /* XXX DWRITE uses rdnb for I/O length. */
 926             rc = fsmNext(fsm, FSM_DWRITE);
 927             if (rc) goto exit;
 928
 929             left -= fsm->wrnb;
 930         }
 931
 932 #ifdef HAVE_MMAP
 933         if (mapped != MAP_FAILED) {
 934             xx = msync(mapped, nmapped, MS_ASYNC);
 935 #if defined(MADV_DONTNEED)
 936             xx = madvise(mapped, nmapped, MADV_DONTNEED);
 937 #endif
 938             xx = munmap(mapped, nmapped);
 939             fsm->rdbuf = rdbuf;
 940         }
 941 #endif
 942
 943     } else if (writeData && S_ISLNK(st->st_mode)) {
 944         /* XXX DWRITE uses rdnb for I/O length. */
 945         strcpy(fsm->rdbuf, symbuf);     /* XXX restore readlink buffer. */
 946         fsm->rdnb = strlen(symbuf);
 947         rc = fsmNext(fsm, FSM_DWRITE);
 948         if (rc) goto exit;
 949     }
 950
 951     rc = fsmNext(fsm, FSM_PAD);
 952     if (rc) goto exit;
 953
 954     rc = 0;
 955
 956 exit:
 957     if (fsm->rfd != NULL)
 958         (void) fsmNext(fsm, FSM_RCLOSE);
 959     fsm->opath = opath;
 960     fsm->path = path;
 961     free(symbuf);
 962     return rc;
 963 }
 964
 965 /** \ingroup payload
 966  * Write set of linked files to payload stream.
 967  * @param fsm           file state machine data
 968  * @return              0 on success
 969  */
 970 static int writeLinkedFile(FSM_t fsm)
 971 {
 972     char * path = fsm->path;
 973     const char * nsuffix = fsm->nsuffix;
 974     int iterIndex = fsm->ix;
 975     int ec = 0;
 976     int rc;
 977     int i;
 978
 979     fsm->path = NULL;
 980     fsm->nsuffix = NULL;
 981     fsm->ix = -1;
 982
 983     for (i = fsm->li->nlink - 1; i >= 0; i--) {
 984
 985         if (fsm->li->filex[i] < 0) continue;
 986
 987         fsm->ix = fsm->li->filex[i];
 988         rc = fsmMapPath(fsm);
 989
 990         /* Write data after last link. */
 991         rc = writeFile(fsm, (i == 0));
 992         if (fsm->failedFile && rc != 0 && *fsm->failedFile == NULL) {
 993             ec = rc;
 994             *fsm->failedFile = xstrdup(fsm->path);
 995         }
 996
 997         fsm->path = _free(fsm->path);
 998         fsm->li->filex[i] = -1;
 999     }
1000
1001     fsm->ix = iterIndex;
1002     fsm->nsuffix = nsuffix;
1003     fsm->path = path;
1004     return ec;
1005 }
1006
1007 /** \ingroup payload
1008  * Create pending hard links to existing file.
1009  * @param fsm           file state machine data
1010  * @return              0 on success
1011  */
1012 static int fsmMakeLinks(FSM_t fsm)
1013 {
1014     char * path = fsm->path;
1015     char * opath = fsm->opath;
1016     const char * nsuffix = fsm->nsuffix;
1017     int iterIndex = fsm->ix;
1018     int ec = 0;
1019     int rc;
1020     int i;
1021
1022     fsm->path = NULL;
1023     fsm->opath = NULL;
1024     fsm->nsuffix = NULL;
1025     fsm->ix = -1;
1026
1027     fsm->ix = fsm->li->filex[fsm->li->createdPath];
1028     rc = fsmMapPath(fsm);
1029     fsm->opath = fsm->path;
1030     fsm->path = NULL;
1031     for (i = 0; i < fsm->li->nlink; i++) {
1032         if (fsm->li->filex[i] < 0) continue;
1033         if (fsm->li->createdPath == i) continue;
1034
1035         fsm->ix = fsm->li->filex[i];
1036         fsm->path = _free(fsm->path);
1037         rc = fsmMapPath(fsm);
1038         if (XFA_SKIPPING(fsm->action)) continue;
1039
1040         rc = fsmUNSAFE(fsm, FSM_VERIFY);
1041         if (!rc) continue;
1042         if (!(rc == CPIOERR_ENOENT)) break;
1043
1044         /* XXX link(fsm->opath, fsm->path) */
1045         rc = fsmNext(fsm, FSM_LINK);
1046         if (fsm->failedFile && rc != 0 && *fsm->failedFile == NULL) {
1047             ec = rc;
1048             *fsm->failedFile = xstrdup(fsm->path);
1049         }
1050
1051         fsm->li->linksLeft--;
1052     }
1053     fsm->path = _free(fsm->path);
1054     fsm->opath = _free(fsm->opath);
1055
1056     fsm->ix = iterIndex;
1057     fsm->nsuffix = nsuffix;
1058     fsm->path = path;
1059     fsm->opath = opath;
1060     return ec;
1061 }
1062
1063 /** \ingroup payload
1064  * Commit hard linked file set atomically.
1065  * @param fsm           file state machine data
1066  * @return              0 on success
1067  */
1068 static int fsmCommitLinks(FSM_t fsm)
1069 {
1070     char * path = fsm->path;
1071     const char * nsuffix = fsm->nsuffix;
1072     int iterIndex = fsm->ix;
1073     struct stat * st = &fsm->sb;
1074     int rc = 0;
1075     nlink_t i;
1076
1077     fsm->path = NULL;
1078     fsm->nsuffix = NULL;
1079     fsm->ix = -1;
1080
1081     for (fsm->li = fsm->links; fsm->li; fsm->li = fsm->li->next) {
1082         if (fsm->li->sb.st_ino == st->st_ino && fsm->li->sb.st_dev == st->st_dev)
1083             break;
1084     }
1085
1086     for (i = 0; i < fsm->li->nlink; i++) {
1087         if (fsm->li->filex[i] < 0) continue;
1088         fsm->ix = fsm->li->filex[i];
1089         rc = fsmMapPath(fsm);
1090         if (!XFA_SKIPPING(fsm->action))
1091             rc = fsmNext(fsm, FSM_COMMIT);
1092         fsm->path = _free(fsm->path);
1093         fsm->li->filex[i] = -1;
1094     }
1095
1096     fsm->ix = iterIndex;
1097     fsm->nsuffix = nsuffix;
1098     fsm->path = path;
1099     return rc;
1100 }
1101
1102 static int fsmRmdir(FSM_t fsm)
1103 {
1104     int rc = rmdir(fsm->path);
1105     if (_fsm_debug && (FSM_RMDIR & FSM_SYSCALL))
1106         rpmlog(RPMLOG_DEBUG, " %8s (%s) %s\n", fileStageString(FSM_RMDIR),
1107                fsm->path, (rc < 0 ? strerror(errno) : ""));
1108     if (rc < 0)
1109         switch (errno) {
1110         case ENOENT:        rc = CPIOERR_ENOENT;    break;
1111         case ENOTEMPTY:     rc = CPIOERR_ENOTEMPTY; break;
1112         default:            rc = CPIOERR_RMDIR_FAILED; break;
1113         }
1114     return rc;
1115 }
1116
1117 /**
1118  * Remove (if created) directories not explicitly included in package.
1119  * @param fsm           file state machine data
1120  * @return              0 on success
1121  */
1122 static int fsmRmdirs(FSM_t fsm)
1123 {
1124     char * path = fsm->path;
1125     const char * dpath;
1126     void * dnli = dnlInitIterator(fsm, 1);
1127     int dc = dnlCount(dnli);
1128     int rc = 0;
1129
1130     if (fsm->ldn != NULL && fsm->dnlx != NULL)
1131     while ((dpath = dnlNextIterator(dnli)) != NULL) {
1132         size_t dnlen = strlen(dpath);
1133         char *te, dn[dnlen+1];
1134
1135         dc = dnlIndex(dnli);
1136         if (fsm->dnlx[dc] < 1 || fsm->dnlx[dc] >= dnlen)
1137             continue;
1138
1139         /* Copy as we need to modify the string */
1140         te = stpcpy(dn, dpath) - 1;
1141         fsm->path = dn;
1142
1143         /* Remove generated directories. */
1144         do {
1145             if (*te == '/') {
1146                 *te = '\0';
1147                 rc = fsmRmdir(fsm);
1148                 *te = '/';
1149             }
1150             if (rc)
1151                 break;
1152             te--;
1153         } while ((te - fsm->path) > fsm->dnlx[dc]);
1154     }
1155     dnli = dnlFreeIterator(dnli);
1156
1157     fsm->path = path;
1158     return rc;
1159 }
1160
1161 static int fsmMkdir(FSM_t fsm)
1162 {
1163     int rc = mkdir(fsm->path, (fsm->sb.st_mode & 07777));
1164     if (_fsm_debug && (FSM_MKDIR & FSM_SYSCALL))
1165         rpmlog(RPMLOG_DEBUG, " %8s (%s, 0%04o) %s\n", fileStageString(FSM_MKDIR),
1166                fsm->path, (unsigned)(fsm->sb.st_mode & 07777),
1167                (rc < 0 ? strerror(errno) : ""));
1168     if (rc < 0) rc = CPIOERR_MKDIR_FAILED;
1169     return rc;
1170 }
1171
1172 /**
1173  * Create (if necessary) directories not explicitly included in package.
1174  * @param fsm           file state machine data
1175  * @return              0 on success
1176  */
1177 static int fsmMkdirs(FSM_t fsm)
1178 {
1179     struct stat * st = &fsm->sb;
1180     struct stat * ost = &fsm->osb;
1181     char * path = fsm->path;
1182     const char *dpath;
1183     mode_t st_mode = st->st_mode;
1184     void * dnli = dnlInitIterator(fsm, 0);
1185     int dc = dnlCount(dnli);
1186     int rc = 0;
1187     int i;
1188     rpmts ts = fsmGetTs(fsm);
1189     security_context_t scon = NULL;
1190
1191     fsm->dnlx = (dc ? xcalloc(dc, sizeof(*fsm->dnlx)) : NULL);
1192     if (fsm->dnlx != NULL)
1193     while ((dpath = dnlNextIterator(dnli)) != NULL) {
1194         size_t dnlen = strlen(dpath);
1195         char * te, dn[dnlen+1];
1196
1197         dc = dnlIndex(dnli);
1198         if (dc < 0) continue;
1199         fsm->dnlx[dc] = dnlen;
1200         if (dnlen <= 1)
1201             continue;
1202
1203         if (dnlen <= fsm->ldnlen && rstreq(dpath, fsm->ldn))
1204             continue;
1205
1206         /* Copy as we need to modify the string */
1207         (void) stpcpy(dn, dpath);
1208         fsm->path = dn;
1209
1210         /* Assume '/' directory exists, "mkdir -p" for others if non-existent */
1211         for (i = 1, te = dn + 1; *te != '\0'; te++, i++) {
1212             if (*te != '/')
1213                 continue;
1214
1215             *te = '\0';
1216
1217             /* Already validated? */
1218             if (i < fsm->ldnlen &&
1219                 (fsm->ldn[i] == '/' || fsm->ldn[i] == '\0') &&
1220                 rstreqn(fsm->path, fsm->ldn, i))
1221             {
1222                 *te = '/';
1223                 /* Move pre-existing path marker forward. */
1224                 fsm->dnlx[dc] = (te - dn);
1225                 continue;
1226             }
1227
1228             /* Validate next component of path. */
1229             rc = fsmUNSAFE(fsm, FSM_LSTAT);
1230             *te = '/';
1231
1232             /* Directory already exists? */
1233             if (rc == 0 && S_ISDIR(ost->st_mode)) {
1234                 /* Move pre-existing path marker forward. */
1235                 fsm->dnlx[dc] = (te - dn);
1236             } else if (rc == CPIOERR_ENOENT) {
1237                 *te = '\0';
1238                 st->st_mode = S_IFDIR | (_dirPerms & 07777);
1239                 rc = fsmMkdir(fsm);
1240                 if (!rc) {
1241                     /* XXX FIXME? only new dir will have context set. */
1242                     /* Get file security context from patterns. */
1243                     if (!(rpmtsFlags(ts) & RPMTRANS_FLAG_NOCONTEXTS)) {
1244                         if (matchpathcon(fsm->path, st->st_mode, &scon) == 0 &&
1245                             scon != NULL) {
1246                             fsm->fcontext = scon;
1247                             rc = fsmNext(fsm, FSM_LSETFCON);
1248                         }
1249                     }
1250
1251                     if (fsm->fcontext == NULL)
1252                         rpmlog(RPMLOG_DEBUG,
1253                             "%s directory created with perms %04o, no context.\n",
1254                             fsm->path, (unsigned)(st->st_mode & 07777));
1255                     else {
1256                         rpmlog(RPMLOG_DEBUG,
1257                             "%s directory created with perms %04o, context %s.\n",
1258                             fsm->path, (unsigned)(st->st_mode & 07777),
1259                             fsm->fcontext);
1260                         freecon(fsm->fcontext);
1261                     }
1262                     fsm->fcontext = NULL;
1263                 }
1264                 *te = '/';
1265             }
1266             if (rc)
1267                 break;
1268         }
1269         if (rc) break;
1270
1271         /* Save last validated path. */
1272 /* FIX: ldn/path annotations ? */
1273         if (fsm->ldnalloc < (dnlen + 1)) {
1274             fsm->ldnalloc = dnlen + 100;
1275             fsm->ldn = xrealloc(fsm->ldn, fsm->ldnalloc);
1276         }
1277         if (fsm->ldn != NULL) { /* XXX can't happen */
1278             strcpy(fsm->ldn, fsm->path);
1279             fsm->ldnlen = dnlen;
1280         }
1281     }
1282     dnli = dnlFreeIterator(dnli);
1283
1284     fsm->path = path;
1285     st->st_mode = st_mode;              /* XXX restore st->st_mode */
1286 /* FIX: ldn/path annotations ? */
1287     return rc;
1288 }
1289
1290 static void removeSBITS(const char *path)
1291 {
1292     struct stat stb;
1293     if (lstat(path, &stb) == 0 && S_ISREG(stb.st_mode)) {
1294         if ((stb.st_mode & 06000) != 0) {
1295             (void) chmod(path, stb.st_mode & 0777);
1296         }
1297 #if WITH_CAP
1298         if (stb.st_mode & (S_IXUSR|S_IXGRP|S_IXOTH)) {
1299             (void) cap_set_file(path, NULL);
1300         }
1301 #endif
1302     }
1303 }
1304
1305 /********************************************************************/
1306
1307 static int fsmInit(FSM_t fsm)
1308 {
1309     int rc = 0;
1310
1311     fsm->path = _free(fsm->path);
1312     fsm->postpone = 0;
1313     fsm->diskchecked = fsm->exists = 0;
1314     fsm->subdir = NULL;
1315     fsm->suffix = (fsm->sufbuf[0] != '\0' ? fsm->sufbuf : NULL);
1316     fsm->action = FA_UNKNOWN;
1317     fsm->osuffix = NULL;
1318     fsm->nsuffix = NULL;
1319
1320     if (fsm->goal == FSM_PKGINSTALL) {
1321         /* Read next header from payload, checking for end-of-payload. */
1322         rc = fsmUNSAFE(fsm, FSM_NEXT);
1323     }
1324     if (rc) return rc;
1325
1326     /* Identify mapping index. */
1327     fsm->ix = ((fsm->goal == FSM_PKGINSTALL)
1328                ? mapFind(fsm->iter, fsm->path) : mapNextIterator(fsm->iter));
1329
1330     /* Detect end-of-loop and/or mapping error. */
1331     if (fsm->ix < 0) {
1332         if (fsm->goal == FSM_PKGINSTALL) {
1333 #if 0
1334             rpmlog(RPMLOG_WARNING,
1335                    _("archive file %s was not found in header file list\n"),
1336                    fsm->path);
1337 #endif
1338             if (fsm->failedFile && *fsm->failedFile == NULL)
1339                 *fsm->failedFile = xstrdup(fsm->path);
1340             rc = CPIOERR_UNMAPPED_FILE;
1341         } else {
1342             rc = CPIOERR_HDR_TRAILER;
1343         }
1344         return rc;
1345     }
1346
1347     /* On non-install, mode must be known so that dirs don't get suffix. */
1348     if (fsm->goal != FSM_PKGINSTALL) {
1349         rpmfi fi = fsmGetFi(fsm);
1350         fsm->sb.st_mode = rpmfiFModeIndex(fi, fsm->ix);
1351     }
1352
1353     /* Generate file path. */
1354     rc = fsmMapPath(fsm);
1355     if (rc) return rc;
1356
1357     /* Perform lstat/stat for disk file. */
1358     if (fsm->path != NULL &&
1359         !(fsm->goal == FSM_PKGINSTALL && S_ISREG(fsm->sb.st_mode)))
1360     {
1361         rc = fsmUNSAFE(fsm, (!(fsm->mapFlags & CPIO_FOLLOW_SYMLINKS)
1362                              ? FSM_LSTAT : FSM_STAT));
1363         if (rc == CPIOERR_ENOENT) {
1364             // errno = saveerrno; XXX temporary commented out
1365             rc = 0;
1366             fsm->exists = 0;
1367         } else if (rc == 0) {
1368             fsm->exists = 1;
1369         }
1370     } else {
1371         /* Skip %ghost files on build. */
1372         fsm->exists = 0;
1373     }
1374     fsm->diskchecked = 1;
1375     if (rc) return rc;
1376
1377     /* On non-install, the disk file stat is what's remapped. */
1378     if (fsm->goal != FSM_PKGINSTALL)
1379         fsm->sb = fsm->osb;                     /* structure assignment */
1380
1381     /* Remap file perms, owner, and group. */
1382     rc = fsmMapAttrs(fsm);
1383     if (rc) return rc;
1384
1385     fsm->postpone = XFA_SKIPPING(fsm->action);
1386     if (fsm->goal == FSM_PKGINSTALL || fsm->goal == FSM_PKGBUILD) {
1387         /* FIX: saveHardLink can modify fsm */
1388         if (S_ISREG(fsm->sb.st_mode) && fsm->sb.st_nlink > 1)
1389             fsm->postpone = saveHardLink(fsm);
1390     }
1391     return rc;
1392
1393 }
1394
1395 static int fsmUnlink(FSM_t fsm)
1396 {
1397     int rc = 0;
1398     if (fsm->mapFlags & CPIO_SBIT_CHECK)
1399         removeSBITS(fsm->path);
1400     rc = unlink(fsm->path);
1401     if (_fsm_debug && (FSM_UNLINK & FSM_SYSCALL))
1402         rpmlog(RPMLOG_DEBUG, " %8s (%s) %s\n", fileStageString(FSM_UNLINK),
1403                fsm->path, (rc < 0 ? strerror(errno) : ""));
1404     if (rc < 0)
1405         rc = (errno == ENOENT ? CPIOERR_ENOENT : CPIOERR_UNLINK_FAILED);
1406     return rc;
1407 }
1408
1409 static int fsmRename(FSM_t fsm)
1410 {
1411     if (fsm->mapFlags & CPIO_SBIT_CHECK)
1412         removeSBITS(fsm->path);
1413     int rc = rename(fsm->opath, fsm->path);
1414 #if defined(ETXTBSY) && defined(__HPUX__)
1415     if (rc && errno == ETXTBSY) {
1416         char *path = NULL;
1417         rstrscat(&path, fsm->path, "-RPMDELETE", NULL);
1418         /*
1419          * XXX HP-UX (and other os'es) don't permit rename to busy
1420          * XXX files.
1421          */
1422         rc = rename(fsm->path, path);
1423         if (!rc) rc = rename(fsm->opath, fsm->path);
1424         free(path);
1425     }
1426 #endif
1427     if (_fsm_debug && (FSM_RENAME & FSM_SYSCALL))
1428         rpmlog(RPMLOG_DEBUG, " %8s (%s, %s) %s\n", fileStageString(FSM_RENAME),
1429                fsm->opath, fsm->path, (rc < 0 ? strerror(errno) : ""));
1430     if (rc < 0) rc = CPIOERR_RENAME_FAILED;
1431     return rc;
1432 }
1433
1434 /********************************************************************/
1435
1436 #define IS_DEV_LOG(_x)  \
1437         ((_x) != NULL && strlen(_x) >= (sizeof("/dev/log")-1) && \
1438         rstreqn((_x), "/dev/log", sizeof("/dev/log")-1) && \
1439         ((_x)[sizeof("/dev/log")-1] == '\0' || \
1440          (_x)[sizeof("/dev/log")-1] == ';'))
1441
1442 /**
1443  * File state machine driver.
1444  * @param fsm           file state machine
1445  * @param stage         next stage
1446  * @return              0 on success
1447  */
1448 static int fsmStage(FSM_t fsm, fileStage stage)
1449 {
1450 #ifdef  UNUSED
1451     fileStage prevStage = fsm->stage;
1452     const char * const prev = fileStageString(prevStage);
1453 #endif
1454     static int modulo = 4;
1455     const char * const cur = fileStageString(stage);
1456     struct stat * st = &fsm->sb;
1457     struct stat * ost = &fsm->osb;
1458     int saveerrno = errno;
1459     int rc = fsm->rc;
1460     rpm_loff_t left;
1461
1462 #define _fafilter(_a)   \
1463     (!((_a) == FA_CREATE || (_a) == FA_ERASE || (_a) == FA_COPYIN || (_a) == FA_COPYOUT) \
1464         ? fileActionString(_a) : "")
1465
1466     if (stage & FSM_DEAD) {
1467         /* do nothing */
1468     } else if (stage & FSM_INTERNAL) {
1469         if (_fsm_debug && !(stage & FSM_SYSCALL))
1470             rpmlog(RPMLOG_DEBUG, " %8s %06o%3d (%4d,%4d)%10d %s %s\n",
1471                 cur,
1472                 (unsigned)st->st_mode, (int)st->st_nlink,
1473                 (int)st->st_uid, (int)st->st_gid, (int)st->st_size,
1474                 (fsm->path ? fsm->path : ""),
1475                 _fafilter(fsm->action));
1476     } else {
1477         fsm->stage = stage;
1478         if (_fsm_debug || !(stage & FSM_VERBOSE))
1479             rpmlog(RPMLOG_DEBUG, "%-8s  %06o%3d (%4d,%4d)%10d %s %s\n",
1480                 cur,
1481                 (unsigned)st->st_mode, (int)st->st_nlink,
1482                 (int)st->st_uid, (int)st->st_gid, (int)st->st_size,
1483                 (fsm->path ? fsm->path : ""),
1484                 _fafilter(fsm->action));
1485     }
1486 #undef  _fafilter
1487
1488     switch (stage) {
1489     case FSM_UNKNOWN:
1490         break;
1491     case FSM_PKGINSTALL:
1492         while (1) {
1493             /* Clean fsm, free'ing memory. Read next archive header. */
1494             rc = fsmInit(fsm);
1495
1496             /* Exit on end-of-payload. */
1497             if (rc == CPIOERR_HDR_TRAILER) {
1498                 rc = 0;
1499                 break;
1500             }
1501
1502             /* Exit on error. */
1503             if (rc) {
1504                 fsm->postpone = 1;
1505                 (void) fsmNext(fsm, FSM_UNDO);
1506                 break;
1507             }
1508
1509             /* Extract file from archive. */
1510             rc = fsmNext(fsm, FSM_PROCESS);
1511             if (rc) {
1512                 (void) fsmNext(fsm, FSM_UNDO);
1513                 break;
1514             }
1515
1516             /* Notify on success. */
1517             (void) fsmNext(fsm, FSM_NOTIFY);
1518
1519             rc = fsmNext(fsm, FSM_FINI);
1520             if (rc) {
1521                 break;
1522             }
1523         }
1524         break;
1525     case FSM_PKGERASE:
1526     case FSM_PKGCOMMIT:
1527         while (1) {
1528             /* Clean fsm, free'ing memory. */
1529             rc = fsmInit(fsm);
1530
1531             /* Exit on end-of-payload. */
1532             if (rc == CPIOERR_HDR_TRAILER) {
1533                 rc = 0;
1534                 break;
1535             }
1536
1537             /* Rename/erase next item. */
1538             if (fsmNext(fsm, FSM_FINI))
1539                 break;
1540         }
1541         break;
1542     case FSM_PKGBUILD:
1543         while (1) {
1544
1545             rc = fsmInit(fsm);
1546
1547             /* Exit on end-of-payload. */
1548             if (rc == CPIOERR_HDR_TRAILER) {
1549                 rc = 0;
1550                 break;
1551             }
1552
1553             /* Exit on error. */
1554             if (rc) {
1555                 fsm->postpone = 1;
1556                 (void) fsmNext(fsm, FSM_UNDO);
1557                 break;
1558             }
1559
1560             /* Copy file into archive. */
1561             rc = fsmNext(fsm, FSM_PROCESS);
1562             if (rc) {
1563                 (void) fsmNext(fsm, FSM_UNDO);
1564                 break;
1565             }
1566
1567             /* Notify on success. */
1568             (void) fsmNext(fsm, FSM_NOTIFY);
1569
1570             if (fsmNext(fsm, FSM_FINI))
1571                 break;
1572         }
1573
1574         /* Flush partial sets of hard linked files. */
1575         if (!(fsm->mapFlags & CPIO_ALL_HARDLINKS)) {
1576             nlink_t i, nlink;
1577             int j;
1578             while ((fsm->li = fsm->links) != NULL) {
1579                 fsm->links = fsm->li->next;
1580                 fsm->li->next = NULL;
1581
1582                 /* Re-calculate link count for archive header. */
1583                 for (j = -1, nlink = 0, i = 0; i < fsm->li->nlink; i++) {
1584                     if (fsm->li->filex[i] < 0)
1585                         continue;
1586                     nlink++;
1587                     if (j == -1) j = i;
1588                 }
1589                 /* XXX force the contents out as well. */
1590                 if (j != 0) {
1591                     fsm->li->filex[0] = fsm->li->filex[j];
1592                     fsm->li->filex[j] = -1;
1593                 }
1594                 fsm->li->sb.st_nlink = nlink;
1595
1596                 fsm->sb = fsm->li->sb;  /* structure assignment */
1597                 fsm->osb = fsm->sb;     /* structure assignment */
1598
1599                 if (!rc) rc = writeLinkedFile(fsm);
1600
1601                 fsm->li = freeHardLink(fsm->li);
1602             }
1603         }
1604
1605         if (!rc)
1606             rc = fsmNext(fsm, FSM_TRAILER);
1607
1608         break;
1609     case FSM_CREATE:
1610         {   rpmts ts = fsmGetTs(fsm);
1611 #define _tsmask (RPMTRANS_FLAG_PKGCOMMIT | RPMTRANS_FLAG_COMMIT)
1612             fsm->commit = ((ts && (rpmtsFlags(ts) & _tsmask) &&
1613                         fsm->goal != FSM_PKGCOMMIT) ? 0 : 1);
1614 #undef _tsmask
1615         }
1616         fsm->path = _free(fsm->path);
1617         fsm->opath = _free(fsm->opath);
1618         fsm->dnlx = _free(fsm->dnlx);
1619
1620         fsm->ldn = _free(fsm->ldn);
1621         fsm->ldnalloc = fsm->ldnlen = 0;
1622
1623         fsm->rdsize = fsm->wrsize = 0;
1624         fsm->rdbuf = fsm->rdb = _free(fsm->rdb);
1625         fsm->wrbuf = fsm->wrb = _free(fsm->wrb);
1626         if (fsm->goal == FSM_PKGINSTALL || fsm->goal == FSM_PKGBUILD) {
1627             fsm->rdsize = 8 * BUFSIZ;
1628             fsm->rdbuf = fsm->rdb = xmalloc(fsm->rdsize);
1629             fsm->wrsize = 8 * BUFSIZ;
1630             fsm->wrbuf = fsm->wrb = xmalloc(fsm->wrsize);
1631         }
1632
1633         fsm->mkdirsdone = 0;
1634         fsm->ix = -1;
1635         fsm->links = NULL;
1636         fsm->li = NULL;
1637         errno = 0;      /* XXX get rid of EBADF */
1638
1639         /* Detect and create directories not explicitly in package. */
1640         if (fsm->goal == FSM_PKGINSTALL) {
1641             rc = fsmMkdirs(fsm);
1642             if (!rc) fsm->mkdirsdone = 1;
1643         }
1644
1645         break;
1646     case FSM_PROCESS:
1647         if (fsm->postpone) {
1648             if (fsm->goal == FSM_PKGINSTALL)
1649                 rc = fsmNext(fsm, FSM_EAT);
1650             break;
1651         }
1652
1653         if (fsm->goal == FSM_PKGBUILD) {
1654             if (fsm->fflags & RPMFILE_GHOST) /* XXX Don't if %ghost file. */
1655                 break;
1656             if (S_ISREG(st->st_mode) && st->st_nlink > 1) {
1657                 hardLink_t li, prev;
1658
1659 if (!(fsm->mapFlags & CPIO_ALL_HARDLINKS)) break;
1660                 rc = writeLinkedFile(fsm);
1661                 if (rc) break;  /* W2DO? */
1662
1663                 for (li = fsm->links, prev = NULL; li; prev = li, li = li->next)
1664                      if (li == fsm->li)
1665                         break;
1666
1667                 if (prev == NULL)
1668                     fsm->links = fsm->li->next;
1669                 else
1670                     prev->next = fsm->li->next;
1671                 fsm->li->next = NULL;
1672                 fsm->li = freeHardLink(fsm->li);
1673             } else {
1674                 rc = writeFile(fsm, 1);
1675             }
1676             break;
1677         }
1678
1679         if (fsm->goal != FSM_PKGINSTALL)
1680             break;
1681
1682         if (S_ISREG(st->st_mode)) {
1683             char * path = fsm->path;
1684             if (fsm->osuffix)
1685                 fsm->path = fsmFsPath(fsm, st, NULL, NULL);
1686             rc = fsmUNSAFE(fsm, FSM_VERIFY);
1687
1688             if (rc == 0 && fsm->osuffix) {
1689                 char * opath = fsm->opath;
1690                 fsm->opath = fsm->path;
1691                 fsm->path = fsmFsPath(fsm, st, NULL, fsm->osuffix);
1692                 rc = fsmRename(fsm);
1693                 if (!rc)
1694                     rpmlog(RPMLOG_WARNING,
1695                         _("%s saved as %s\n"),
1696                                 (fsm->opath ? fsm->opath : ""),
1697                                 (fsm->path ? fsm->path : ""));
1698                 fsm->path = _free(fsm->path);
1699                 fsm->opath = opath;
1700             }
1701
1702             fsm->path = path;
1703             if (!(rc == CPIOERR_ENOENT)) return rc;
1704             rc = expandRegular(fsm);
1705         } else if (S_ISDIR(st->st_mode)) {
1706             mode_t st_mode = st->st_mode;
1707             rc = fsmUNSAFE(fsm, FSM_VERIFY);
1708             if (rc == CPIOERR_ENOENT) {
1709                 st->st_mode &= ~07777;          /* XXX abuse st->st_mode */
1710                 st->st_mode |=  00700;
1711                 rc = fsmMkdir(fsm);
1712                 st->st_mode = st_mode;          /* XXX restore st->st_mode */
1713             }
1714         } else if (S_ISLNK(st->st_mode)) {
1715             char * opath = fsm->opath;
1716
1717             if ((st->st_size + 1) > fsm->rdsize) {
1718                 rc = CPIOERR_HDR_SIZE;
1719                 break;
1720             }
1721
1722             fsm->wrlen = st->st_size;
1723             rc = fsmNext(fsm, FSM_DREAD);
1724             if (!rc && fsm->rdnb != fsm->wrlen)
1725                 rc = CPIOERR_READ_FAILED;
1726             if (rc) break;
1727
1728             fsm->wrbuf[st->st_size] = '\0';
1729             /* XXX symlink(fsm->opath, fsm->path) */
1730             fsm->opath = fsm->wrbuf;
1731             rc = fsmUNSAFE(fsm, FSM_VERIFY);
1732             if (rc == CPIOERR_ENOENT)
1733                 rc = fsmNext(fsm, FSM_SYMLINK);
1734             fsm->opath = opath;         /* XXX restore fsm->path */
1735         } else if (S_ISFIFO(st->st_mode)) {
1736             mode_t st_mode = st->st_mode;
1737             /* This mimics cpio S_ISSOCK() behavior but probably isnt' right */
1738             rc = fsmUNSAFE(fsm, FSM_VERIFY);
1739             if (rc == CPIOERR_ENOENT) {
1740                 st->st_mode = 0000;             /* XXX abuse st->st_mode */
1741                 rc = fsmNext(fsm, FSM_MKFIFO);
1742                 st->st_mode = st_mode;  /* XXX restore st->st_mode */
1743             }
1744         } else if (S_ISCHR(st->st_mode) ||
1745                    S_ISBLK(st->st_mode) ||
1746     S_ISSOCK(st->st_mode))
1747         {
1748             rc = fsmUNSAFE(fsm, FSM_VERIFY);
1749             if (rc == CPIOERR_ENOENT)
1750                 rc = fsmNext(fsm, FSM_MKNOD);
1751         } else {
1752             /* XXX Special case /dev/log, which shouldn't be packaged anyways */
1753             if (!IS_DEV_LOG(fsm->path))
1754                 rc = CPIOERR_UNKNOWN_FILETYPE;
1755         }
1756         if (S_ISREG(st->st_mode) && st->st_nlink > 1) {
1757             fsm->li->createdPath = fsm->li->linkIndex;
1758             rc = fsmMakeLinks(fsm);
1759         }
1760         break;
1761     case FSM_POST:
1762         break;
1763     case FSM_MKLINKS:
1764         rc = fsmMakeLinks(fsm);
1765         break;
1766     case FSM_NOTIFY:            /* XXX move from fsm to psm -> tsm */
1767         if (fsm->goal == FSM_PKGINSTALL || fsm->goal == FSM_PKGBUILD) {
1768             rpmts ts = fsmGetTs(fsm);
1769             rpmte te = fsmGetTe(fsm);
1770             rpmfi fi = fsmGetFi(fsm);
1771             void * ptr;
1772             if (fsm->cpioPos > fsm->archivePos) {
1773                 fsm->archivePos = fsm->cpioPos;
1774                 ptr = rpmtsNotify(ts, te, RPMCALLBACK_INST_PROGRESS,
1775                         fsm->archivePos, fi->archiveSize);
1776             }
1777         }
1778         break;
1779     case FSM_UNDO:
1780         if (fsm->postpone)
1781             break;
1782         if (fsm->goal == FSM_PKGINSTALL) {
1783             /* XXX only erase if temp fn w suffix is in use */
1784             if (fsm->sufbuf[0] != '\0')
1785                 if (S_ISDIR(st->st_mode)) {
1786                     (void) fsmRmdir(fsm);
1787                 } else {
1788                     fsmUnlink(fsm);
1789                 }
1790
1791 #ifdef  NOTYET  /* XXX remove only dirs just created, not all. */
1792             if (fsm->dnlx)
1793                 (void) fsmRmdirs(fsm);
1794 #endif
1795             errno = saveerrno;
1796         }
1797         if (fsm->failedFile && *fsm->failedFile == NULL)
1798             *fsm->failedFile = xstrdup(fsm->path);
1799         break;
1800     case FSM_FINI:
1801         if (!fsm->postpone && fsm->commit) {
1802             if (fsm->goal == FSM_PKGINSTALL)
1803                 rc = ((S_ISREG(st->st_mode) && st->st_nlink > 1)
1804                         ? fsmCommitLinks(fsm) : fsmNext(fsm, FSM_COMMIT));
1805             if (fsm->goal == FSM_PKGCOMMIT)
1806                 rc = fsmNext(fsm, FSM_COMMIT);
1807             if (fsm->goal == FSM_PKGERASE)
1808                 rc = fsmNext(fsm, FSM_COMMIT);
1809         }
1810         fsm->path = _free(fsm->path);
1811         fsm->opath = _free(fsm->opath);
1812         memset(st, 0, sizeof(*st));
1813         memset(ost, 0, sizeof(*ost));
1814         break;
1815     case FSM_COMMIT:
1816         /* Rename pre-existing modified or unmanaged file. */
1817         if (fsm->osuffix && fsm->diskchecked &&
1818           (fsm->exists || (fsm->goal == FSM_PKGINSTALL && S_ISREG(st->st_mode))))
1819         {
1820             char * opath = fsm->opath;
1821             char * path = fsm->path;
1822             fsm->opath = fsmFsPath(fsm, st, NULL, NULL);
1823             fsm->path = fsmFsPath(fsm, st, NULL, fsm->osuffix);
1824             rc = fsmRename(fsm);
1825             if (!rc) {
1826                 rpmlog(RPMLOG_WARNING, _("%s saved as %s\n"),
1827                                 (fsm->opath ? fsm->opath : ""),
1828                                 (fsm->path ? fsm->path : ""));
1829             }
1830             fsm->path = _free(fsm->path);
1831             fsm->path = path;
1832             fsm->opath = _free(fsm->opath);
1833             fsm->opath = opath;
1834         }
1835
1836         /* Remove erased files. */
1837         if (fsm->goal == FSM_PKGERASE) {
1838             if (fsm->action == FA_ERASE) {
1839                 rpmte te = fsmGetTe(fsm);
1840                 if (S_ISDIR(st->st_mode)) {
1841                     rc = fsmRmdir(fsm);
1842                     if (!rc) break;
1843                     switch (rc) {
1844                     case CPIOERR_ENOENT: /* XXX rmdir("/") linux 2.2.x kernel hack */
1845                     case CPIOERR_ENOTEMPTY:
1846         /* XXX make sure that build side permits %missingok on directories. */
1847                         if (fsm->fflags & RPMFILE_MISSINGOK)
1848                             break;
1849
1850                         /* XXX common error message. */
1851                         rpmlog(
1852                             (strict_erasures ? RPMLOG_ERR : RPMLOG_DEBUG),
1853                             _("%s rmdir of %s failed: Directory not empty\n"),
1854                                 rpmteTypeString(te), fsm->path);
1855                         break;
1856                     default:
1857                         rpmlog(
1858                             (strict_erasures ? RPMLOG_ERR : RPMLOG_DEBUG),
1859                                 _("%s rmdir of %s failed: %s\n"),
1860                                 rpmteTypeString(te), fsm->path, strerror(errno));
1861                         break;
1862                     }
1863                 } else {
1864                     rc = fsmUnlink(fsm);
1865                     if (!rc) break;
1866                     switch (rc) {
1867                     case CPIOERR_ENOENT:
1868                         if (fsm->fflags & RPMFILE_MISSINGOK)
1869                             break;
1870                     default:
1871                         rpmlog(
1872                             (strict_erasures ? RPMLOG_ERR : RPMLOG_DEBUG),
1873                                 _("%s unlink of %s failed: %s\n"),
1874                                 rpmteTypeString(te), fsm->path, strerror(errno));
1875                         break;
1876                     }
1877                 }
1878             }
1879             /* XXX Failure to remove is not (yet) cause for failure. */
1880             if (!strict_erasures) rc = 0;
1881             break;
1882         }
1883
1884         /* XXX Special case /dev/log, which shouldn't be packaged anyways */
1885         if (!S_ISSOCK(st->st_mode) && !IS_DEV_LOG(fsm->path)) {
1886             /* Rename temporary to final file name. */
1887             if (!S_ISDIR(st->st_mode) &&
1888                 (fsm->subdir || fsm->suffix || fsm->nsuffix))
1889             {
1890                 fsm->opath = fsm->path;
1891                 fsm->path = fsmFsPath(fsm, st, NULL, fsm->nsuffix);
1892                 rc = fsmRename(fsm);
1893                 if (!rc && fsm->nsuffix) {
1894                     char * opath = fsmFsPath(fsm, st, NULL, NULL);
1895                     rpmlog(RPMLOG_WARNING, _("%s created as %s\n"),
1896                                 (opath ? opath : ""),
1897                                 (fsm->path ? fsm->path : ""));
1898                     opath = _free(opath);
1899                 }
1900                 fsm->opath = _free(fsm->opath);
1901             }
1902             /*
1903              * Set file security context (if not disabled).
1904              */
1905             if (!rc && !getuid()) {
1906                 rc = fsmMapFContext(fsm);
1907                 if (!rc) {
1908                     rc = fsmNext(fsm, FSM_LSETFCON);
1909                     freecon(fsm->fcontext);
1910                 }
1911                 fsm->fcontext = NULL;
1912             }
1913             if (S_ISLNK(st->st_mode)) {
1914                 if (!rc && !getuid())
1915                     rc = fsmNext(fsm, FSM_LCHOWN);
1916             } else {
1917                 if (!rc && !getuid())
1918                     rc = fsmNext(fsm, FSM_CHOWN);
1919                 if (!rc)
1920                     rc = fsmNext(fsm, FSM_CHMOD);
1921                 if (!rc) {
1922                     time_t mtime = st->st_mtime;
1923                     rpmfi fi = fsmGetFi(fsm);
1924                     st->st_mtime = rpmfiFMtimeIndex(fi, fsm->ix);
1925                     rc = fsmNext(fsm, FSM_UTIME);
1926                     st->st_mtime = mtime;
1927                 }
1928 #if WITH_CAP
1929                 if (!rc && !S_ISDIR(st->st_mode) && !getuid()) {
1930                     rc = fsmMapFCaps(fsm);
1931                     if (!rc && fsm->fcaps) {
1932                         rc = fsmNext(fsm, FSM_SETCAP);
1933                         cap_free(fsm->fcaps);
1934                     }
1935                     fsm->fcaps = NULL;
1936                 }
1937 #endif /* WITH_CAP */
1938             }
1939         }
1940
1941         /* Notify on success. */
1942         if (!rc)                rc = fsmNext(fsm, FSM_NOTIFY);
1943         else if (fsm->failedFile && *fsm->failedFile == NULL) {
1944             *fsm->failedFile = fsm->path;
1945             fsm->path = NULL;
1946         }
1947         break;
1948     case FSM_DESTROY:
1949         fsm->path = _free(fsm->path);
1950
1951         /* Check for hard links missing from payload. */
1952         while ((fsm->li = fsm->links) != NULL) {
1953             fsm->links = fsm->li->next;
1954             fsm->li->next = NULL;
1955             if (fsm->goal == FSM_PKGINSTALL &&
1956                         fsm->commit && fsm->li->linksLeft)
1957             {
1958                 for (nlink_t i = 0 ; i < fsm->li->linksLeft; i++) {
1959                     if (fsm->li->filex[i] < 0)
1960                         continue;
1961                     rc = CPIOERR_MISSING_HARDLINK;
1962                     if (fsm->failedFile && *fsm->failedFile == NULL) {
1963                         fsm->ix = fsm->li->filex[i];
1964                         if (!fsmMapPath(fsm)) {
1965                             /* Out-of-sync hardlinks handled as sub-state */
1966                             *fsm->failedFile = fsm->path;
1967                             fsm->path = NULL;
1968                         }
1969                     }
1970                     break;
1971                 }
1972             }
1973             if (fsm->goal == FSM_PKGBUILD &&
1974                 (fsm->mapFlags & CPIO_ALL_HARDLINKS))
1975             {
1976                 rc = CPIOERR_MISSING_HARDLINK;
1977             }
1978             fsm->li = freeHardLink(fsm->li);
1979         }
1980         fsm->ldn = _free(fsm->ldn);
1981         fsm->ldnalloc = fsm->ldnlen = 0;
1982         fsm->rdbuf = fsm->rdb = _free(fsm->rdb);
1983         fsm->wrbuf = fsm->wrb = _free(fsm->wrb);
1984         break;
1985     case FSM_VERIFY:
1986         if (fsm->diskchecked && !fsm->exists) {
1987             rc = CPIOERR_ENOENT;
1988             break;
1989         }
1990         if (S_ISREG(st->st_mode)) {
1991             /*
1992              * XXX HP-UX (and other os'es) don't permit unlink on busy
1993              * XXX files.
1994              */
1995             fsm->opath = fsm->path;
1996             fsm->path = rstrscat(NULL, fsm->path, "-RPMDELETE", NULL);
1997             rc = fsmRename(fsm);
1998             if (!rc)
1999                     (void) fsmUnlink(fsm);
2000             else
2001                     rc = CPIOERR_UNLINK_FAILED;
2002             _free(fsm->path);
2003             fsm->path = fsm->opath;
2004             fsm->opath = NULL;
2005             return (rc ? rc : CPIOERR_ENOENT);  /* XXX HACK */
2006             break;
2007         } else if (S_ISDIR(st->st_mode)) {
2008             if (S_ISDIR(ost->st_mode))          return 0;
2009             if (S_ISLNK(ost->st_mode)) {
2010                 rc = fsmUNSAFE(fsm, FSM_STAT);
2011                 if (rc == CPIOERR_ENOENT) rc = 0;
2012                 if (rc) break;
2013                 errno = saveerrno;
2014                 if (S_ISDIR(ost->st_mode))      return 0;
2015             }
2016         } else if (S_ISLNK(st->st_mode)) {
2017             if (S_ISLNK(ost->st_mode)) {
2018         /* XXX NUL terminated result in fsm->rdbuf, len in fsm->rdnb. */
2019                 rc = fsmUNSAFE(fsm, FSM_READLINK);
2020                 errno = saveerrno;
2021                 if (rc) break;
2022                 if (rstreq(fsm->opath, fsm->rdbuf))     return 0;
2023             }
2024         } else if (S_ISFIFO(st->st_mode)) {
2025             if (S_ISFIFO(ost->st_mode))         return 0;
2026         } else if (S_ISCHR(st->st_mode) || S_ISBLK(st->st_mode)) {
2027             if ((S_ISCHR(ost->st_mode) || S_ISBLK(ost->st_mode)) &&
2028                 (ost->st_rdev == st->st_rdev))  return 0;
2029         } else if (S_ISSOCK(st->st_mode)) {
2030             if (S_ISSOCK(ost->st_mode))         return 0;
2031         }
2032             /* XXX shouldn't do this with commit/undo. */
2033         rc = 0;
2034         if (fsm->stage == FSM_PROCESS) rc = fsmUnlink(fsm);
2035         if (rc == 0)    rc = CPIOERR_ENOENT;
2036         return (rc ? rc : CPIOERR_ENOENT);      /* XXX HACK */
2037         break;
2038     case FSM_LSETFCON:
2039         if (fsm->fcontext == NULL || *fsm->fcontext == '\0'
2040          || rstreq(fsm->fcontext, "<<none>>"))
2041             break;
2042         rc = lsetfilecon(fsm->path, (security_context_t)fsm->fcontext);
2043         if (_fsm_debug && (stage & FSM_SYSCALL))
2044             rpmlog(RPMLOG_DEBUG, " %8s (%s, %s) %s\n", cur,
2045                 fsm->path, fsm->fcontext,
2046                 (rc < 0 ? strerror(errno) : ""));
2047         if (rc < 0) rc = (errno == EOPNOTSUPP ? 0 : CPIOERR_LSETFCON_FAILED);
2048         break;
2049     case FSM_CHOWN:
2050         rc = chown(fsm->path, st->st_uid, st->st_gid);
2051         if (_fsm_debug && (stage & FSM_SYSCALL))
2052             rpmlog(RPMLOG_DEBUG, " %8s (%s, %d, %d) %s\n", cur,
2053                 fsm->path, (int)st->st_uid, (int)st->st_gid,
2054                 (rc < 0 ? strerror(errno) : ""));
2055         if (rc < 0)     rc = CPIOERR_CHOWN_FAILED;
2056         break;
2057     case FSM_LCHOWN:
2058         rc = lchown(fsm->path, st->st_uid, st->st_gid);
2059         if (_fsm_debug && (stage & FSM_SYSCALL))
2060             rpmlog(RPMLOG_DEBUG, " %8s (%s, %d, %d) %s\n", cur,
2061                 fsm->path, (int)st->st_uid, (int)st->st_gid,
2062                 (rc < 0 ? strerror(errno) : ""));
2063         if (rc < 0)     rc = CPIOERR_CHOWN_FAILED;
2064         break;
2065     case FSM_CHMOD:
2066         rc = chmod(fsm->path, (st->st_mode & 07777));
2067         if (_fsm_debug && (stage & FSM_SYSCALL))
2068             rpmlog(RPMLOG_DEBUG, " %8s (%s, 0%04o) %s\n", cur,
2069                 fsm->path, (unsigned)(st->st_mode & 07777),
2070                 (rc < 0 ? strerror(errno) : ""));
2071         if (rc < 0)     rc = CPIOERR_CHMOD_FAILED;
2072         break;
2073     case FSM_UTIME:
2074         {   struct utimbuf stamp;
2075             stamp.actime = st->st_mtime;
2076             stamp.modtime = st->st_mtime;
2077             rc = utime(fsm->path, &stamp);
2078             if (_fsm_debug && (stage & FSM_SYSCALL))
2079                 rpmlog(RPMLOG_DEBUG, " %8s (%s, 0x%x) %s\n", cur,
2080                         fsm->path, (unsigned)st->st_mtime,
2081                         (rc < 0 ? strerror(errno) : ""));
2082             if (rc < 0) rc = CPIOERR_UTIME_FAILED;
2083         }
2084         break;
2085 #if WITH_CAP
2086     case FSM_SETCAP:
2087         rc = cap_set_file(fsm->path, fsm->fcaps);
2088         if (rc < 0) {
2089             rc = CPIOERR_SETCAP_FAILED;
2090         }
2091         break;
2092 #endif /* WITH_CAP */
2093     case FSM_SYMLINK:
2094         rc = symlink(fsm->opath, fsm->path);
2095         if (_fsm_debug && (stage & FSM_SYSCALL))
2096             rpmlog(RPMLOG_DEBUG, " %8s (%s, %s) %s\n", cur,
2097                 fsm->opath, fsm->path, (rc < 0 ? strerror(errno) : ""));
2098         if (rc < 0)     rc = CPIOERR_SYMLINK_FAILED;
2099         break;
2100     case FSM_LINK:
2101         rc = link(fsm->opath, fsm->path);
2102         if (_fsm_debug && (stage & FSM_SYSCALL))
2103             rpmlog(RPMLOG_DEBUG, " %8s (%s, %s) %s\n", cur,
2104                 fsm->opath, fsm->path, (rc < 0 ? strerror(errno) : ""));
2105         if (rc < 0)     rc = CPIOERR_LINK_FAILED;
2106         break;
2107     case FSM_MKFIFO:
2108         rc = mkfifo(fsm->path, (st->st_mode & 07777));
2109         if (_fsm_debug && (stage & FSM_SYSCALL))
2110             rpmlog(RPMLOG_DEBUG, " %8s (%s, 0%04o) %s\n", cur,
2111                 fsm->path, (unsigned)(st->st_mode & 07777),
2112                 (rc < 0 ? strerror(errno) : ""));
2113         if (rc < 0)     rc = CPIOERR_MKFIFO_FAILED;
2114         break;
2115     case FSM_MKNOD:
2116         /* FIX: check S_IFIFO or dev != 0 */
2117         rc = mknod(fsm->path, (st->st_mode & ~07777), st->st_rdev);
2118         if (_fsm_debug && (stage & FSM_SYSCALL))
2119             rpmlog(RPMLOG_DEBUG, " %8s (%s, 0%o, 0x%x) %s\n", cur,
2120                 fsm->path, (unsigned)(st->st_mode & ~07777),
2121                 (unsigned)st->st_rdev,
2122                 (rc < 0 ? strerror(errno) : ""));
2123         if (rc < 0)     rc = CPIOERR_MKNOD_FAILED;
2124         break;
2125     case FSM_LSTAT:
2126         rc = lstat(fsm->path, ost);
2127         if (_fsm_debug && (stage & FSM_SYSCALL) && rc && errno != ENOENT)
2128             rpmlog(RPMLOG_DEBUG, " %8s (%s, ost) %s\n", cur,
2129                 fsm->path, (rc < 0 ? strerror(errno) : ""));
2130         if (rc < 0) {
2131             rc = (errno == ENOENT ? CPIOERR_ENOENT : CPIOERR_LSTAT_FAILED);
2132             memset(ost, 0, sizeof(*ost));       /* XXX s390x hackery */
2133         }
2134         break;
2135     case FSM_STAT:
2136         rc = stat(fsm->path, ost);
2137         if (_fsm_debug && (stage & FSM_SYSCALL) && rc && errno != ENOENT)
2138             rpmlog(RPMLOG_DEBUG, " %8s (%s, ost) %s\n", cur,
2139                 fsm->path, (rc < 0 ? strerror(errno) : ""));
2140         if (rc < 0) {
2141             rc = (errno == ENOENT ? CPIOERR_ENOENT : CPIOERR_STAT_FAILED);
2142             memset(ost, 0, sizeof(*ost));       /* XXX s390x hackery */
2143         }
2144         break;
2145     case FSM_READLINK:
2146         /* XXX NUL terminated result in fsm->rdbuf, len in fsm->rdnb. */
2147         rc = readlink(fsm->path, fsm->rdbuf, fsm->rdsize - 1);
2148         if (_fsm_debug && (stage & FSM_SYSCALL))
2149             rpmlog(RPMLOG_DEBUG, " %8s (%s, rdbuf, %d) %s\n", cur,
2150                 fsm->path, (int)(fsm->rdsize -1), (rc < 0 ? strerror(errno) : ""));
2151         if (rc < 0)     rc = CPIOERR_READLINK_FAILED;
2152         else {
2153             fsm->rdnb = rc;
2154             fsm->rdbuf[fsm->rdnb] = '\0';
2155             rc = 0;
2156         }
2157         break;
2158     case FSM_NEXT:
2159         rc = fsmUNSAFE(fsm, FSM_HREAD);
2160         if (rc) break;
2161         if (rstreq(fsm->path, CPIO_TRAILER)) { /* Detect end-of-payload. */
2162             fsm->path = _free(fsm->path);
2163             rc = CPIOERR_HDR_TRAILER;
2164         }
2165         if (!rc)
2166             rc = fsmNext(fsm, FSM_POS);
2167         break;
2168     case FSM_EAT:
2169         for (left = st->st_size; left > 0; left -= fsm->rdnb) {
2170             fsm->wrlen = (left > fsm->wrsize ? fsm->wrsize : left);
2171             rc = fsmNext(fsm, FSM_DREAD);
2172             if (rc)
2173                 break;
2174         }
2175         break;
2176     case FSM_POS:
2177         left = (modulo - (fsm->cpioPos % modulo)) % modulo;
2178         if (left) {
2179             fsm->wrlen = left;
2180             (void) fsmNext(fsm, FSM_DREAD);
2181         }
2182         break;
2183     case FSM_PAD:
2184         left = (modulo - (fsm->cpioPos % modulo)) % modulo;
2185         if (left) {
2186             memset(fsm->rdbuf, 0, left);
2187             /* XXX DWRITE uses rdnb for I/O length. */
2188             fsm->rdnb = left;
2189             (void) fsmNext(fsm, FSM_DWRITE);
2190         }
2191         break;
2192     case FSM_TRAILER:
2193         rc = cpioTrailerWrite(fsm);
2194         break;
2195     case FSM_HREAD:
2196         rc = fsmNext(fsm, FSM_POS);
2197         if (!rc)
2198             rc = cpioHeaderRead(fsm, st);       /* Read next payload header. */
2199         break;
2200     case FSM_HWRITE:
2201         rc = cpioHeaderWrite(fsm, st);          /* Write next payload header. */
2202         break;
2203     case FSM_DREAD:
2204         fsm->rdnb = Fread(fsm->wrbuf, sizeof(*fsm->wrbuf), fsm->wrlen, fsm->cfd);
2205         if (_fsm_debug && (stage & FSM_SYSCALL))
2206             rpmlog(RPMLOG_DEBUG, " %8s (%s, %d, cfd)\trdnb %d\n",
2207                 cur, (fsm->wrbuf == fsm->wrb ? "wrbuf" : "mmap"),
2208                 (int)fsm->wrlen, (int)fsm->rdnb);
2209         if (fsm->rdnb != fsm->wrlen || Ferror(fsm->cfd))
2210             rc = CPIOERR_READ_FAILED;
2211         if (fsm->rdnb > 0)
2212             fsm->cpioPos += fsm->rdnb;
2213         break;
2214     case FSM_DWRITE:
2215         fsm->wrnb = Fwrite(fsm->rdbuf, sizeof(*fsm->rdbuf), fsm->rdnb, fsm->cfd);
2216         if (_fsm_debug && (stage & FSM_SYSCALL))
2217             rpmlog(RPMLOG_DEBUG, " %8s (%s, %d, cfd)\twrnb %d\n",
2218                 cur, (fsm->rdbuf == fsm->rdb ? "rdbuf" : "mmap"),
2219                 (int)fsm->rdnb, (int)fsm->wrnb);
2220         if (fsm->rdnb != fsm->wrnb || Ferror(fsm->cfd))
2221             rc = CPIOERR_WRITE_FAILED;
2222         if (fsm->wrnb > 0)
2223             fsm->cpioPos += fsm->wrnb;
2224         break;
2225
2226     case FSM_ROPEN:
2227         fsm->rfd = Fopen(fsm->path, "r.ufdio");
2228         if (fsm->rfd == NULL || Ferror(fsm->rfd)) {
2229             if (fsm->rfd != NULL)       (void) fsmNext(fsm, FSM_RCLOSE);
2230             fsm->rfd = NULL;
2231             rc = CPIOERR_OPEN_FAILED;
2232             break;
2233         }
2234         if (_fsm_debug && (stage & FSM_SYSCALL))
2235             rpmlog(RPMLOG_DEBUG, " %8s (%s, \"r\") rfd %p rdbuf %p\n", cur,
2236                 fsm->path, fsm->rfd, fsm->rdbuf);
2237         break;
2238     case FSM_READ:
2239         fsm->rdnb = Fread(fsm->rdbuf, sizeof(*fsm->rdbuf), fsm->rdlen, fsm->rfd);
2240         if (_fsm_debug && (stage & FSM_SYSCALL))
2241             rpmlog(RPMLOG_DEBUG, " %8s (rdbuf, %d, rfd)\trdnb %d\n",
2242                 cur, (int)fsm->rdlen, (int)fsm->rdnb);
2243         if (fsm->rdnb != fsm->rdlen || Ferror(fsm->rfd))
2244             rc = CPIOERR_READ_FAILED;
2245         break;
2246     case FSM_RCLOSE:
2247         if (fsm->rfd != NULL) {
2248             if (_fsm_debug && (stage & FSM_SYSCALL))
2249                 rpmlog(RPMLOG_DEBUG, " %8s (%p)\n", cur, fsm->rfd);
2250             (void) rpmswAdd(rpmtsOp(fsmGetTs(fsm), RPMTS_OP_DIGEST),
2251                         fdOp(fsm->rfd, FDSTAT_DIGEST));
2252             (void) Fclose(fsm->rfd);
2253             errno = saveerrno;
2254         }
2255         fsm->rfd = NULL;
2256         break;
2257     case FSM_WOPEN:
2258         fsm->wfd = Fopen(fsm->path, "w.ufdio");
2259         if (fsm->wfd == NULL || Ferror(fsm->wfd)) {
2260             if (fsm->wfd != NULL)       (void) fsmNext(fsm, FSM_WCLOSE);
2261             fsm->wfd = NULL;
2262             rc = CPIOERR_OPEN_FAILED;
2263         }
2264         if (_fsm_debug && (stage & FSM_SYSCALL))
2265             rpmlog(RPMLOG_DEBUG, " %8s (%s, \"w\") wfd %p wrbuf %p\n", cur,
2266                 fsm->path, fsm->wfd, fsm->wrbuf);
2267         break;
2268     case FSM_WRITE:
2269         fsm->wrnb = Fwrite(fsm->wrbuf, sizeof(*fsm->wrbuf), fsm->rdnb, fsm->wfd);
2270         if (_fsm_debug && (stage & FSM_SYSCALL))
2271             rpmlog(RPMLOG_DEBUG, " %8s (wrbuf, %d, wfd)\twrnb %d\n",
2272                 cur, (int)fsm->rdnb, (int)fsm->wrnb);
2273         if (fsm->rdnb != fsm->wrnb || Ferror(fsm->wfd))
2274             rc = CPIOERR_WRITE_FAILED;
2275         break;
2276     case FSM_WCLOSE:
2277         if (fsm->wfd != NULL) {
2278             if (_fsm_debug && (stage & FSM_SYSCALL))
2279                 rpmlog(RPMLOG_DEBUG, " %8s (%p)\n", cur, fsm->wfd);
2280             (void) rpmswAdd(rpmtsOp(fsmGetTs(fsm), RPMTS_OP_DIGEST),
2281                         fdOp(fsm->wfd, FDSTAT_DIGEST));
2282             (void) Fclose(fsm->wfd);
2283             errno = saveerrno;
2284         }
2285         fsm->wfd = NULL;
2286         break;
2287
2288     default:
2289         break;
2290     }
2291
2292     if (!(stage & FSM_INTERNAL)) {
2293         fsm->rc = (rc == CPIOERR_HDR_TRAILER ? 0 : rc);
2294     }
2295     return rc;
2296 }
2297
2298 /**
2299  * Return formatted string representation of file disposition.
2300  * @param a             file dispostion
2301  * @return              formatted string
2302  */
2303 static const char * fileActionString(rpmFileAction a)
2304 {
2305     switch (a) {
2306     case FA_UNKNOWN:    return "unknown";
2307     case FA_CREATE:     return "create";
2308     case FA_COPYOUT:    return "copyout";
2309     case FA_COPYIN:     return "copyin";
2310     case FA_BACKUP:     return "backup";
2311     case FA_SAVE:       return "save";
2312     case FA_SKIP:       return "skip";
2313     case FA_ALTNAME:    return "altname";
2314     case FA_ERASE:      return "erase";
2315     case FA_SKIPNSTATE: return "skipnstate";
2316     case FA_SKIPNETSHARED: return "skipnetshared";
2317     case FA_SKIPCOLOR:  return "skipcolor";
2318     default:            return "???";
2319     }
2320 }
2321
2322 /**
2323  * Return formatted string representation of file stages.
2324  * @param a             file stage
2325  * @return              formatted string
2326  */
2327 static const char * fileStageString(fileStage a) {
2328     switch(a) {
2329     case FSM_UNKNOWN:   return "unknown";
2330
2331     case FSM_PKGINSTALL:return "INSTALL";
2332     case FSM_PKGERASE:  return "ERASE";
2333     case FSM_PKGBUILD:  return "BUILD";
2334     case FSM_PKGCOMMIT: return "COMMIT";
2335     case FSM_PKGUNDO:   return "UNDO";
2336
2337     case FSM_CREATE:    return "create";
2338     case FSM_INIT:      return "init";
2339     case FSM_MAP:       return "map";
2340     case FSM_MKDIRS:    return "mkdirs";
2341     case FSM_RMDIRS:    return "rmdirs";
2342     case FSM_PRE:       return "pre";
2343     case FSM_PROCESS:   return "process";
2344     case FSM_POST:      return "post";
2345     case FSM_MKLINKS:   return "mklinks";
2346     case FSM_NOTIFY:    return "notify";
2347     case FSM_UNDO:      return "undo";
2348     case FSM_FINI:      return "fini";
2349     case FSM_COMMIT:    return "commit";
2350     case FSM_DESTROY:   return "destroy";
2351     case FSM_VERIFY:    return "verify";
2352
2353     case FSM_UNLINK:    return "unlink";
2354     case FSM_RENAME:    return "rename";
2355     case FSM_MKDIR:     return "mkdir";
2356     case FSM_RMDIR:     return "rmdir";
2357     case FSM_LSETFCON:  return "lsetfcon";
2358     case FSM_CHOWN:     return "chown";
2359     case FSM_LCHOWN:    return "lchown";
2360     case FSM_CHMOD:     return "chmod";
2361     case FSM_UTIME:     return "utime";
2362     case FSM_SYMLINK:   return "symlink";
2363     case FSM_LINK:      return "link";
2364     case FSM_MKFIFO:    return "mkfifo";
2365     case FSM_MKNOD:     return "mknod";
2366     case FSM_LSTAT:     return "lstat";
2367     case FSM_STAT:      return "stat";
2368     case FSM_READLINK:  return "readlink";
2369     case FSM_SETCAP:    return "setcap";
2370
2371     case FSM_NEXT:      return "next";
2372     case FSM_EAT:       return "eat";
2373     case FSM_POS:       return "pos";
2374     case FSM_PAD:       return "pad";
2375     case FSM_TRAILER:   return "trailer";
2376     case FSM_HREAD:     return "hread";
2377     case FSM_HWRITE:    return "hwrite";
2378     case FSM_DREAD:     return "Fread";
2379     case FSM_DWRITE:    return "Fwrite";
2380
2381     case FSM_ROPEN:     return "Fopen";
2382     case FSM_READ:      return "Fread";
2383     case FSM_RCLOSE:    return "Fclose";
2384     case FSM_WOPEN:     return "Fopen";
2385     case FSM_WRITE:     return "Fwrite";
2386     case FSM_WCLOSE:    return "Fclose";
2387
2388     default:            return "???";
2389     }
2390 }