apt-pkg/depcache.cc

   1 // -*- mode: cpp; mode: fold -*-
   2 // Description                                                          /*{{{*/
   3 // $Id: depcache.cc,v 1.25 2001/05/27 05:36:04 jgg Exp $
   4 /* ######################################################################
   5
   6    Dependency Cache - Caches Dependency information.
   7
   8    ##################################################################### */
   9                                                                         /*}}}*/
  10 // Include Files                                                        /*{{{*/
  11 #include <apt-pkg/depcache.h>
  12 #include <apt-pkg/version.h>
  13 #include <apt-pkg/versionmatch.h>
  14 #include <apt-pkg/error.h>
  15 #include <apt-pkg/sptr.h>
  16 #include <apt-pkg/algorithms.h>
  17
  18 #include <apt-pkg/fileutl.h>
  19 #include <apt-pkg/strutl.h>
  20 #include <apt-pkg/configuration.h>
  21 #include <apt-pkg/aptconfiguration.h>
  22 #include <apt-pkg/pkgsystem.h>
  23 #include <apt-pkg/tagfile.h>
  24
  25 #include <iostream>
  26 #include <sstream>
  27 #include <set>
  28
  29 #include <sys/stat.h>
  30
  31 #include <apti18n.h>
  32                                                                         /*}}}*/
  33 // helper for Install-Recommends-Sections and Never-MarkAuto-Sections   /*{{{*/
  34 static bool
  35 ConfigValueInSubTree(const char* SubTree, const char *needle)
  36 {
  37    Configuration::Item const *Opts;
  38    Opts = _config->Tree(SubTree);
  39    if (Opts != 0 && Opts->Child != 0)
  40    {
  41       Opts = Opts->Child;
  42       for (; Opts != 0; Opts = Opts->Next)
  43       {
  44          if (Opts->Value.empty() == true)
  45             continue;
  46          if (strcmp(needle, Opts->Value.c_str()) == 0)
  47             return true;
  48       }
  49    }
  50    return false;
  51 }
  52                                                                         /*}}}*/
  53 pkgDepCache::ActionGroup::ActionGroup(pkgDepCache &cache) :             /*{{{*/
  54   cache(cache), released(false)
  55 {
  56   ++cache.group_level;
  57 }
  58
  59 void pkgDepCache::ActionGroup::release()
  60 {
  61   if(!released)
  62     {
  63       if(cache.group_level == 0)
  64         std::cerr << "W: Unbalanced action groups, expect badness" << std::endl;
  65       else
  66         {
  67           --cache.group_level;
  68
  69           if(cache.group_level == 0)
  70             cache.MarkAndSweep();
  71         }
  72
  73       released = true;
  74     }
  75 }
  76
  77 pkgDepCache::ActionGroup::~ActionGroup()
  78 {
  79   release();
  80 }
  81                                                                         /*}}}*/
  82 // DepCache::pkgDepCache - Constructors                                 /*{{{*/
  83 // ---------------------------------------------------------------------
  84 /* */
  85 pkgDepCache::pkgDepCache(pkgCache *pCache,Policy *Plcy) :
  86   group_level(0), Cache(pCache), PkgState(0), DepState(0)
  87 {
  88    DebugMarker = _config->FindB("Debug::pkgDepCache::Marker", false);
  89    DebugAutoInstall = _config->FindB("Debug::pkgDepCache::AutoInstall", false);
  90    delLocalPolicy = 0;
  91    LocalPolicy = Plcy;
  92    if (LocalPolicy == 0)
  93       delLocalPolicy = LocalPolicy = new Policy;
  94 }
  95                                                                         /*}}}*/
  96 // DepCache::~pkgDepCache - Destructor                                  /*{{{*/
  97 // ---------------------------------------------------------------------
  98 /* */
  99 pkgDepCache::~pkgDepCache()
 100 {
 101    delete [] PkgState;
 102    delete [] DepState;
 103    delete delLocalPolicy;
 104 }
 105                                                                         /*}}}*/
 106 // DepCache::Init - Generate the initial extra structures.              /*{{{*/
 107 // ---------------------------------------------------------------------
 108 /* This allocats the extension buffers and initializes them. */
 109 bool pkgDepCache::Init(OpProgress *Prog)
 110 {
 111    // Suppress mark updates during this operation (just in case) and
 112    // run a mark operation when Init terminates.
 113    ActionGroup actions(*this);
 114
 115    delete [] PkgState;
 116    delete [] DepState;
 117    PkgState = new StateCache[Head().PackageCount];
 118    DepState = new unsigned char[Head().DependsCount];
 119    memset(PkgState,0,sizeof(*PkgState)*Head().PackageCount);
 120    memset(DepState,0,sizeof(*DepState)*Head().DependsCount);
 121
 122    if (Prog != 0)
 123    {
 124       Prog->OverallProgress(0,2*Head().PackageCount,Head().PackageCount,
 125                             _("Building dependency tree"));
 126       Prog->SubProgress(Head().PackageCount,_("Candidate versions"));
 127    }
 128
 129    /* Set the current state of everything. In this state all of the
 130       packages are kept exactly as is. See AllUpgrade */
 131    int Done = 0;
 132    for (PkgIterator I = PkgBegin(); I.end() != true; I++,Done++)
 133    {
 134       if (Prog != 0 && Done%20 == 0)
 135          Prog->Progress(Done);
 136
 137       // Find the proper cache slot
 138       StateCache &State = PkgState[I->ID];
 139       State.iFlags = 0;
 140
 141       // Figure out the install version
 142       State.CandidateVer = GetCandidateVer(I);
 143       State.InstallVer = I.CurrentVer();
 144       State.Mode = ModeKeep;
 145
 146       State.Update(I,*this);
 147    }
 148
 149    if (Prog != 0)
 150    {
 151
 152       Prog->OverallProgress(Head().PackageCount,2*Head().PackageCount,
 153                             Head().PackageCount,
 154                             _("Building dependency tree"));
 155       Prog->SubProgress(Head().PackageCount,_("Dependency generation"));
 156    }
 157
 158    Update(Prog);
 159
 160    if(Prog != 0)
 161       Prog->Done();
 162
 163    return true;
 164 }
 165                                                                         /*}}}*/
 166 bool pkgDepCache::readStateFile(OpProgress *Prog)                       /*{{{*/
 167 {
 168    FileFd state_file;
 169    string const state = _config->FindFile("Dir::State::extended_states");
 170    if(RealFileExists(state)) {
 171       state_file.Open(state, FileFd::ReadOnly);
 172       int const file_size = state_file.Size();
 173       if(Prog != NULL)
 174          Prog->OverallProgress(0, file_size, 1,
 175                                _("Reading state information"));
 176
 177       pkgTagFile tagfile(&state_file);
 178       pkgTagSection section;
 179       int amt = 0;
 180       bool const debug_autoremove = _config->FindB("Debug::pkgAutoRemove",false);
 181       while(tagfile.Step(section)) {
 182          string const pkgname = section.FindS("Package");
 183          string pkgarch = section.FindS("Architecture");
 184          if (pkgarch.empty() == true)
 185             pkgarch = "any";
 186          pkgCache::PkgIterator pkg = Cache->FindPkg(pkgname, pkgarch);
 187          // Silently ignore unknown packages and packages with no actual version.
 188          if(pkg.end() == true || pkg->VersionList == 0)
 189             continue;
 190
 191          short const reason = section.FindI("Auto-Installed", 0);
 192          if(reason > 0)
 193          {
 194             PkgState[pkg->ID].Flags |= Flag::Auto;
 195             if (unlikely(debug_autoremove))
 196                std::clog << "Auto-Installed : " << pkg.FullName() << std::endl;
 197             if (pkgarch == "any")
 198             {
 199                pkgCache::GrpIterator G = pkg.Group();
 200                for (pkg = G.NextPkg(pkg); pkg.end() != true; pkg = G.NextPkg(pkg))
 201                   if (pkg->VersionList != 0)
 202                      PkgState[pkg->ID].Flags |= Flag::Auto;
 203             }
 204          }
 205          amt += section.size();
 206          if(Prog != NULL)
 207             Prog->OverallProgress(amt, file_size, 1,
 208                                   _("Reading state information"));
 209       }
 210       if(Prog != NULL)
 211          Prog->OverallProgress(file_size, file_size, 1,
 212                                _("Reading state information"));
 213    }
 214
 215    return true;
 216 }
 217                                                                         /*}}}*/
 218 bool pkgDepCache::writeStateFile(OpProgress *prog, bool InstalledOnly)  /*{{{*/
 219 {
 220    bool const debug_autoremove = _config->FindB("Debug::pkgAutoRemove",false);
 221
 222    if(debug_autoremove)
 223       std::clog << "pkgDepCache::writeStateFile()" << std::endl;
 224
 225    FileFd StateFile;
 226    string const state = _config->FindFile("Dir::State::extended_states");
 227
 228    // if it does not exist, create a empty one
 229    if(!RealFileExists(state))
 230    {
 231       StateFile.Open(state, FileFd::WriteAtomic);
 232       StateFile.Close();
 233    }
 234
 235    // open it
 236    if(!StateFile.Open(state, FileFd::ReadOnly))
 237       return _error->Error(_("Failed to open StateFile %s"),
 238                            state.c_str());
 239
 240    FILE *OutFile;
 241    string const outfile = state + ".tmp";
 242    if((OutFile = fopen(outfile.c_str(),"w")) == NULL)
 243       return _error->Error(_("Failed to write temporary StateFile %s"),
 244                            outfile.c_str());
 245
 246    // first merge with the existing sections
 247    pkgTagFile tagfile(&StateFile);
 248    pkgTagSection section;
 249    std::set<string> pkgs_seen;
 250    const char *nullreorderlist[] = {0};
 251    while(tagfile.Step(section)) {
 252          string const pkgname = section.FindS("Package");
 253          string pkgarch = section.FindS("Architecture");
 254          if (pkgarch.empty() == true)
 255             pkgarch = "native";
 256          // Silently ignore unknown packages and packages with no actual
 257          // version.
 258          pkgCache::PkgIterator pkg = Cache->FindPkg(pkgname, pkgarch);
 259          if(pkg.end() || pkg.VersionList().end())
 260             continue;
 261          StateCache const &P = PkgState[pkg->ID];
 262          bool newAuto = (P.Flags & Flag::Auto);
 263          // skip not installed or now-removed ones if requested
 264          if (InstalledOnly && (
 265              (pkg->CurrentVer == 0 && P.Mode != ModeInstall) ||
 266              (pkg->CurrentVer != 0 && P.Mode == ModeDelete)))
 267          {
 268             // The section is obsolete if it contains no other tag
 269             unsigned int const count = section.Count();
 270             if (count < 2 ||
 271                 (count == 2 && section.Exists("Auto-Installed")) ||
 272                 (count == 3 && section.Exists("Auto-Installed") && section.Exists("Architecture")))
 273                continue;
 274             else
 275                newAuto = false;
 276          }
 277          if(_config->FindB("Debug::pkgAutoRemove",false))
 278             std::clog << "Update existing AutoInstall info: "
 279                       << pkg.FullName() << std::endl;
 280          TFRewriteData rewrite[3];
 281          rewrite[0].Tag = "Architecture";
 282          rewrite[0].Rewrite = pkg.Arch();
 283          rewrite[0].NewTag = 0;
 284          rewrite[1].Tag = "Auto-Installed";
 285          rewrite[1].Rewrite = newAuto ? "1" : "0";
 286          rewrite[1].NewTag = 0;
 287          rewrite[2].Tag = 0;
 288          TFRewrite(OutFile, section, nullreorderlist, rewrite);
 289          fprintf(OutFile,"\n");
 290          pkgs_seen.insert(pkg.FullName());
 291    }
 292
 293    // then write the ones we have not seen yet
 294    std::ostringstream ostr;
 295    for(pkgCache::PkgIterator pkg=Cache->PkgBegin(); !pkg.end(); pkg++) {
 296       StateCache const &P = PkgState[pkg->ID];
 297       if(P.Flags & Flag::Auto) {
 298          if (pkgs_seen.find(pkg.FullName()) != pkgs_seen.end()) {
 299             if(debug_autoremove)
 300                std::clog << "Skipping already written " << pkg.FullName() << std::endl;
 301             continue;
 302          }
 303          // skip not installed ones if requested
 304          if (InstalledOnly && (
 305              (pkg->CurrentVer == 0 && P.Mode != ModeInstall) ||
 306              (pkg->CurrentVer != 0 && P.Mode == ModeDelete)))
 307             continue;
 308          const char* const pkgarch = pkg.Arch();
 309          if (strcmp(pkgarch, "all") == 0)
 310             continue;
 311          if(debug_autoremove)
 312             std::clog << "Writing new AutoInstall: " << pkg.FullName() << std::endl;
 313          ostr.str(string(""));
 314          ostr << "Package: " << pkg.Name()
 315               << "\nArchitecture: " << pkgarch
 316               << "\nAuto-Installed: 1\n\n";
 317          fprintf(OutFile,"%s",ostr.str().c_str());
 318       }
 319    }
 320    fclose(OutFile);
 321
 322    // move the outfile over the real file and set permissions
 323    rename(outfile.c_str(), state.c_str());
 324    chmod(state.c_str(), 0644);
 325
 326    return true;
 327 }
 328                                                                         /*}}}*/
 329 // DepCache::CheckDep - Checks a single dependency                      /*{{{*/
 330 // ---------------------------------------------------------------------
 331 /* This first checks the dependency against the main target package and
 332    then walks along the package provides list and checks if each provides
 333    will be installed then checks the provides against the dep. Res will be
 334    set to the package which was used to satisfy the dep. */
 335 bool pkgDepCache::CheckDep(DepIterator Dep,int Type,PkgIterator &Res)
 336 {
 337    Res = Dep.TargetPkg();
 338
 339    /* Check simple depends. A depends -should- never self match but
 340       we allow it anyhow because dpkg does. Technically it is a packaging
 341       bug. Conflicts may never self match */
 342    if (Dep.TargetPkg() != Dep.ParentPkg() ||
 343        (Dep->Type != Dep::Conflicts && Dep->Type != Dep::DpkgBreaks && Dep->Type != Dep::Obsoletes))
 344    {
 345       PkgIterator Pkg = Dep.TargetPkg();
 346       // Check the base package
 347       if (Type == NowVersion && Pkg->CurrentVer != 0)
 348          if (VS().CheckDep(Pkg.CurrentVer().VerStr(),Dep->CompareOp,
 349                                  Dep.TargetVer()) == true)
 350             return true;
 351
 352       if (Type == InstallVersion && PkgState[Pkg->ID].InstallVer != 0)
 353          if (VS().CheckDep(PkgState[Pkg->ID].InstVerIter(*this).VerStr(),
 354                                  Dep->CompareOp,Dep.TargetVer()) == true)
 355             return true;
 356
 357       if (Type == CandidateVersion && PkgState[Pkg->ID].CandidateVer != 0)
 358          if (VS().CheckDep(PkgState[Pkg->ID].CandidateVerIter(*this).VerStr(),
 359                                  Dep->CompareOp,Dep.TargetVer()) == true)
 360             return true;
 361    }
 362
 363    if (Dep->Type == Dep::Obsoletes)
 364       return false;
 365
 366    // Check the providing packages
 367    PrvIterator P = Dep.TargetPkg().ProvidesList();
 368    PkgIterator Pkg = Dep.ParentPkg();
 369    for (; P.end() != true; P++)
 370    {
 371       /* Provides may never be applied against the same package (or group)
 372          if it is a conflicts. See the comment above. */
 373       if (P.OwnerPkg()->Group == Pkg->Group &&
 374           (Dep->Type == Dep::Conflicts || Dep->Type == Dep::DpkgBreaks))
 375          continue;
 376
 377       // Check if the provides is a hit
 378       if (Type == NowVersion)
 379       {
 380          if (P.OwnerPkg().CurrentVer() != P.OwnerVer())
 381             continue;
 382       }
 383
 384       if (Type == InstallVersion)
 385       {
 386          StateCache &State = PkgState[P.OwnerPkg()->ID];
 387          if (State.InstallVer != (Version *)P.OwnerVer())
 388             continue;
 389       }
 390
 391       if (Type == CandidateVersion)
 392       {
 393          StateCache &State = PkgState[P.OwnerPkg()->ID];
 394          if (State.CandidateVer != (Version *)P.OwnerVer())
 395             continue;
 396       }
 397
 398       // Compare the versions.
 399       if (VS().CheckDep(P.ProvideVersion(),Dep->CompareOp,Dep.TargetVer()) == true)
 400       {
 401          Res = P.OwnerPkg();
 402          return true;
 403       }
 404    }
 405
 406    return false;
 407 }
 408                                                                         /*}}}*/
 409 // DepCache::AddSizes - Add the packages sizes to the counters          /*{{{*/
 410 // ---------------------------------------------------------------------
 411 /* Call with Mult = -1 to preform the inverse opration
 412    The Mult increases the complexity of the calulations here and is unused -
 413    or do we really have a usecase for removing the size of a package two
 414    times? So let us replace it with a simple bool and be done with it… */
 415 __deprecated void pkgDepCache::AddSizes(const PkgIterator &Pkg,signed long Mult)
 416 {
 417    StateCache &P = PkgState[Pkg->ID];
 418
 419    if (Pkg->VersionList == 0)
 420       return;
 421
 422    if (Pkg.State() == pkgCache::PkgIterator::NeedsConfigure &&
 423        P.Keep() == true)
 424       return;
 425
 426    // Compute the size data
 427    if (P.NewInstall() == true)
 428    {
 429       iUsrSize += (signed long long)(Mult*P.InstVerIter(*this)->InstalledSize);
 430       iDownloadSize += (signed long long)(Mult*P.InstVerIter(*this)->Size);
 431       return;
 432    }
 433
 434    // Upgrading
 435    if (Pkg->CurrentVer != 0 &&
 436        (P.InstallVer != (Version *)Pkg.CurrentVer() ||
 437         (P.iFlags & ReInstall) == ReInstall) && P.InstallVer != 0)
 438    {
 439       iUsrSize += (signed long long)(Mult*((signed long long)P.InstVerIter(*this)->InstalledSize -
 440                         (signed long long)Pkg.CurrentVer()->InstalledSize));
 441       iDownloadSize += (signed long long)(Mult*P.InstVerIter(*this)->Size);
 442       return;
 443    }
 444
 445    // Reinstall
 446    if (Pkg.State() == pkgCache::PkgIterator::NeedsUnpack &&
 447        P.Delete() == false)
 448    {
 449       iDownloadSize += (signed long long)(Mult*P.InstVerIter(*this)->Size);
 450       return;
 451    }
 452
 453    // Removing
 454    if (Pkg->CurrentVer != 0 && P.InstallVer == 0)
 455    {
 456       iUsrSize -= (signed long long)(Mult*Pkg.CurrentVer()->InstalledSize);
 457       return;
 458    }
 459 }
 460                                                                         /*}}}*/
 461 // DepCache::AddSizes - Add the packages sizes to the counters          /*{{{*/
 462 // ---------------------------------------------------------------------
 463 /* Call with Inverse = true to preform the inverse opration */
 464 void pkgDepCache::AddSizes(const PkgIterator &Pkg, bool const &Inverse)
 465 {
 466    StateCache &P = PkgState[Pkg->ID];
 467
 468    if (Pkg->VersionList == 0)
 469       return;
 470
 471    if (Pkg.State() == pkgCache::PkgIterator::NeedsConfigure &&
 472        P.Keep() == true)
 473       return;
 474
 475    // Compute the size data
 476    if (P.NewInstall() == true)
 477    {
 478       if (Inverse == false) {
 479          iUsrSize += P.InstVerIter(*this)->InstalledSize;
 480          iDownloadSize += P.InstVerIter(*this)->Size;
 481       } else {
 482          iUsrSize -= P.InstVerIter(*this)->InstalledSize;
 483          iDownloadSize -= P.InstVerIter(*this)->Size;
 484       }
 485       return;
 486    }
 487
 488    // Upgrading
 489    if (Pkg->CurrentVer != 0 &&
 490        (P.InstallVer != (Version *)Pkg.CurrentVer() ||
 491         (P.iFlags & ReInstall) == ReInstall) && P.InstallVer != 0)
 492    {
 493       if (Inverse == false) {
 494          iUsrSize -= Pkg.CurrentVer()->InstalledSize;
 495          iUsrSize += P.InstVerIter(*this)->InstalledSize;
 496          iDownloadSize += P.InstVerIter(*this)->Size;
 497       } else {
 498          iUsrSize -= P.InstVerIter(*this)->InstalledSize;
 499          iUsrSize += Pkg.CurrentVer()->InstalledSize;
 500          iDownloadSize -= P.InstVerIter(*this)->Size;
 501       }
 502       return;
 503    }
 504
 505    // Reinstall
 506    if (Pkg.State() == pkgCache::PkgIterator::NeedsUnpack &&
 507        P.Delete() == false)
 508    {
 509       if (Inverse == false)
 510          iDownloadSize += P.InstVerIter(*this)->Size;
 511       else
 512          iDownloadSize -= P.InstVerIter(*this)->Size;
 513       return;
 514    }
 515
 516    // Removing
 517    if (Pkg->CurrentVer != 0 && P.InstallVer == 0)
 518    {
 519       if (Inverse == false)
 520          iUsrSize -= Pkg.CurrentVer()->InstalledSize;
 521       else
 522          iUsrSize += Pkg.CurrentVer()->InstalledSize;
 523       return;
 524    }
 525 }
 526                                                                         /*}}}*/
 527 // DepCache::AddStates - Add the package to the state counter           /*{{{*/
 528 // ---------------------------------------------------------------------
 529 /* This routine is tricky to use, you must make sure that it is never
 530    called twice for the same package. This means the Remove/Add section
 531    should be as short as possible and not encompass any code that will
 532    calld Remove/Add itself. Remember, dependencies can be circular so
 533    while processing a dep for Pkg it is possible that Add/Remove
 534    will be called on Pkg */
 535 void pkgDepCache::AddStates(const PkgIterator &Pkg,int Add)
 536 {
 537    StateCache &State = PkgState[Pkg->ID];
 538
 539    // The Package is broken (either minimal dep or policy dep)
 540    if ((State.DepState & DepInstMin) != DepInstMin)
 541       iBrokenCount += Add;
 542    if ((State.DepState & DepInstPolicy) != DepInstPolicy)
 543       iPolicyBrokenCount += Add;
 544
 545    // Bad state
 546    if (Pkg.State() != PkgIterator::NeedsNothing)
 547       iBadCount += Add;
 548
 549    // Not installed
 550    if (Pkg->CurrentVer == 0)
 551    {
 552       if (State.Mode == ModeDelete &&
 553           (State.iFlags & Purge) == Purge && Pkg.Purge() == false)
 554          iDelCount += Add;
 555
 556       if (State.Mode == ModeInstall)
 557          iInstCount += Add;
 558       return;
 559    }
 560
 561    // Installed, no upgrade
 562    if (State.Status == 0)
 563    {
 564       if (State.Mode == ModeDelete)
 565          iDelCount += Add;
 566       else
 567          if ((State.iFlags & ReInstall) == ReInstall)
 568             iInstCount += Add;
 569
 570       return;
 571    }
 572
 573    // Alll 3 are possible
 574    if (State.Mode == ModeDelete)
 575       iDelCount += Add;
 576    if (State.Mode == ModeKeep)
 577       iKeepCount += Add;
 578    if (State.Mode == ModeInstall)
 579       iInstCount += Add;
 580 }
 581                                                                         /*}}}*/
 582 // DepCache::BuildGroupOrs - Generate the Or group dep data             /*{{{*/
 583 // ---------------------------------------------------------------------
 584 /* The or group results are stored in the last item of the or group. This
 585    allows easy detection of the state of a whole or'd group. */
 586 void pkgDepCache::BuildGroupOrs(VerIterator const &V)
 587 {
 588    unsigned char Group = 0;
 589
 590    for (DepIterator D = V.DependsList(); D.end() != true; D++)
 591    {
 592       // Build the dependency state.
 593       unsigned char &State = DepState[D->ID];
 594
 595       /* Invert for Conflicts. We have to do this twice to get the
 596          right sense for a conflicts group */
 597       if (D->Type == Dep::Conflicts ||
 598           D->Type == Dep::DpkgBreaks ||
 599           D->Type == Dep::Obsoletes)
 600          State = ~State;
 601
 602       // Add to the group if we are within an or..
 603       State &= 0x7;
 604       Group |= State;
 605       State |= Group << 3;
 606       if ((D->CompareOp & Dep::Or) != Dep::Or)
 607          Group = 0;
 608
 609       // Invert for Conflicts
 610       if (D->Type == Dep::Conflicts ||
 611           D->Type == Dep::DpkgBreaks ||
 612           D->Type == Dep::Obsoletes)
 613          State = ~State;
 614    }
 615 }
 616                                                                         /*}}}*/
 617 // DepCache::VersionState - Perform a pass over a dependency list       /*{{{*/
 618 // ---------------------------------------------------------------------
 619 /* This is used to run over a dependency list and determine the dep
 620    state of the list, filtering it through both a Min check and a Policy
 621    check. The return result will have SetMin/SetPolicy low if a check
 622    fails. It uses the DepState cache for it's computations. */
 623 unsigned char pkgDepCache::VersionState(DepIterator D,unsigned char Check,
 624                                        unsigned char SetMin,
 625                                        unsigned char SetPolicy)
 626 {
 627    unsigned char Dep = 0xFF;
 628
 629    while (D.end() != true)
 630    {
 631       // Compute a single dependency element (glob or)
 632       DepIterator Start = D;
 633       unsigned char State = 0;
 634       for (bool LastOR = true; D.end() == false && LastOR == true; D++)
 635       {
 636          State |= DepState[D->ID];
 637          LastOR = (D->CompareOp & Dep::Or) == Dep::Or;
 638       }
 639
 640       // Minimum deps that must be satisfied to have a working package
 641       if (Start.IsCritical() == true)
 642          if ((State & Check) != Check)
 643             Dep &= ~SetMin;
 644
 645       // Policy deps that must be satisfied to install the package
 646       if (IsImportantDep(Start) == true &&
 647           (State & Check) != Check)
 648          Dep &= ~SetPolicy;
 649    }
 650
 651    return Dep;
 652 }
 653                                                                         /*}}}*/
 654 // DepCache::DependencyState - Compute the 3 results for a dep          /*{{{*/
 655 // ---------------------------------------------------------------------
 656 /* This is the main dependency computation bit. It computes the 3 main
 657    results for a dependencys, Now, Install and Candidate. Callers must
 658    invert the result if dealing with conflicts. */
 659 unsigned char pkgDepCache::DependencyState(DepIterator &D)
 660 {
 661    unsigned char State = 0;
 662
 663    if (CheckDep(D,NowVersion) == true)
 664       State |= DepNow;
 665    if (CheckDep(D,InstallVersion) == true)
 666       State |= DepInstall;
 667    if (CheckDep(D,CandidateVersion) == true)
 668       State |= DepCVer;
 669
 670    return State;
 671 }
 672                                                                         /*}}}*/
 673 // DepCache::UpdateVerState - Compute the Dep member of the state       /*{{{*/
 674 // ---------------------------------------------------------------------
 675 /* This determines the combined dependency representation of a package
 676    for its two states now and install. This is done by using the pre-generated
 677    dependency information. */
 678 void pkgDepCache::UpdateVerState(PkgIterator Pkg)
 679 {
 680    // Empty deps are always true
 681    StateCache &State = PkgState[Pkg->ID];
 682    State.DepState = 0xFF;
 683
 684    // Check the Current state
 685    if (Pkg->CurrentVer != 0)
 686    {
 687       DepIterator D = Pkg.CurrentVer().DependsList();
 688       State.DepState &= VersionState(D,DepNow,DepNowMin,DepNowPolicy);
 689    }
 690
 691    /* Check the candidate state. We do not compare against the whole as
 692       a candidate state but check the candidate version against the
 693       install states */
 694    if (State.CandidateVer != 0)
 695    {
 696       DepIterator D = State.CandidateVerIter(*this).DependsList();
 697       State.DepState &= VersionState(D,DepInstall,DepCandMin,DepCandPolicy);
 698    }
 699
 700    // Check target state which can only be current or installed
 701    if (State.InstallVer != 0)
 702    {
 703       DepIterator D = State.InstVerIter(*this).DependsList();
 704       State.DepState &= VersionState(D,DepInstall,DepInstMin,DepInstPolicy);
 705    }
 706 }
 707                                                                         /*}}}*/
 708 // DepCache::Update - Figure out all the state information              /*{{{*/
 709 // ---------------------------------------------------------------------
 710 /* This will figure out the state of all the packages and all the
 711    dependencies based on the current policy. */
 712 void pkgDepCache::Update(OpProgress *Prog)
 713 {
 714    iUsrSize = 0;
 715    iDownloadSize = 0;
 716    iDelCount = 0;
 717    iInstCount = 0;
 718    iKeepCount = 0;
 719    iBrokenCount = 0;
 720    iBadCount = 0;
 721
 722    // Perform the depends pass
 723    int Done = 0;
 724    for (PkgIterator I = PkgBegin(); I.end() != true; I++,Done++)
 725    {
 726       if (Prog != 0 && Done%20 == 0)
 727          Prog->Progress(Done);
 728       for (VerIterator V = I.VersionList(); V.end() != true; V++)
 729       {
 730          unsigned char Group = 0;
 731
 732          for (DepIterator D = V.DependsList(); D.end() != true; D++)
 733          {
 734             // Build the dependency state.
 735             unsigned char &State = DepState[D->ID];
 736             State = DependencyState(D);
 737
 738             // Add to the group if we are within an or..
 739             Group |= State;
 740             State |= Group << 3;
 741             if ((D->CompareOp & Dep::Or) != Dep::Or)
 742                Group = 0;
 743
 744             // Invert for Conflicts
 745             if (D->Type == Dep::Conflicts ||
 746                 D->Type == Dep::DpkgBreaks ||
 747                 D->Type == Dep::Obsoletes)
 748                State = ~State;
 749          }
 750       }
 751
 752       // Compute the package dependency state and size additions
 753       AddSizes(I);
 754       UpdateVerState(I);
 755       AddStates(I);
 756    }
 757
 758    if (Prog != 0)
 759       Prog->Progress(Done);
 760
 761    readStateFile(Prog);
 762 }
 763                                                                         /*}}}*/
 764 // DepCache::Update - Update the deps list of a package                 /*{{{*/
 765 // ---------------------------------------------------------------------
 766 /* This is a helper for update that only does the dep portion of the scan.
 767    It is mainly meant to scan reverse dependencies. */
 768 void pkgDepCache::Update(DepIterator D)
 769 {
 770    // Update the reverse deps
 771    for (;D.end() != true; D++)
 772    {
 773       unsigned char &State = DepState[D->ID];
 774       State = DependencyState(D);
 775
 776       // Invert for Conflicts
 777       if (D->Type == Dep::Conflicts ||
 778           D->Type == Dep::DpkgBreaks ||
 779           D->Type == Dep::Obsoletes)
 780          State = ~State;
 781
 782       RemoveStates(D.ParentPkg());
 783       BuildGroupOrs(D.ParentVer());
 784       UpdateVerState(D.ParentPkg());
 785       AddStates(D.ParentPkg());
 786    }
 787 }
 788                                                                         /*}}}*/
 789 // DepCache::Update - Update the related deps of a package              /*{{{*/
 790 // ---------------------------------------------------------------------
 791 /* This is called whenever the state of a package changes. It updates
 792    all cached dependencies related to this package. */
 793 void pkgDepCache::Update(PkgIterator const &Pkg)
 794 {
 795    // Recompute the dep of the package
 796    RemoveStates(Pkg);
 797    UpdateVerState(Pkg);
 798    AddStates(Pkg);
 799
 800    // Update the reverse deps
 801    Update(Pkg.RevDependsList());
 802
 803    // Update the provides map for the current ver
 804    if (Pkg->CurrentVer != 0)
 805       for (PrvIterator P = Pkg.CurrentVer().ProvidesList();
 806            P.end() != true; P++)
 807          Update(P.ParentPkg().RevDependsList());
 808
 809    // Update the provides map for the candidate ver
 810    if (PkgState[Pkg->ID].CandidateVer != 0)
 811       for (PrvIterator P = PkgState[Pkg->ID].CandidateVerIter(*this).ProvidesList();
 812            P.end() != true; P++)
 813          Update(P.ParentPkg().RevDependsList());
 814 }
 815                                                                         /*}}}*/
 816 // DepCache::MarkKeep - Put the package in the keep state               /*{{{*/
 817 // ---------------------------------------------------------------------
 818 /* */
 819 void pkgDepCache::MarkKeep(PkgIterator const &Pkg, bool Soft, bool FromUser,
 820                            unsigned long Depth)
 821 {
 822    if (IsModeChangeOk(ModeKeep, Pkg, Depth, FromUser) == false)
 823       return;
 824
 825    /* Reject an attempt to keep a non-source broken installed package, those
 826       must be upgraded */
 827    if (Pkg.State() == PkgIterator::NeedsUnpack &&
 828        Pkg.CurrentVer().Downloadable() == false)
 829       return;
 830
 831    /* We changed the soft state all the time so the UI is a bit nicer
 832       to use */
 833    StateCache &P = PkgState[Pkg->ID];
 834
 835    // Check that it is not already kept
 836    if (P.Mode == ModeKeep)
 837       return;
 838
 839    if (Soft == true)
 840       P.iFlags |= AutoKept;
 841    else
 842       P.iFlags &= ~AutoKept;
 843
 844    ActionGroup group(*this);
 845
 846 #if 0 // reseting the autoflag here means we lose the
 847       // auto-mark information if a user selects a package for removal
 848       // but changes  his mind then and sets it for keep again
 849       // - this makes sense as default when all Garbage dependencies
 850       //   are automatically marked for removal (as aptitude does).
 851       //   setting a package for keep then makes it no longer autoinstalled
 852       //   for all other use-case this action is rather suprising
 853    if(FromUser && !P.Marked)
 854      P.Flags &= ~Flag::Auto;
 855 #endif
 856
 857    if (DebugMarker == true)
 858       std::clog << OutputInDepth(Depth) << "MarkKeep " << Pkg << " FU=" << FromUser << std::endl;
 859
 860    RemoveSizes(Pkg);
 861    RemoveStates(Pkg);
 862
 863    P.Mode = ModeKeep;
 864    if (Pkg->CurrentVer == 0)
 865       P.InstallVer = 0;
 866    else
 867       P.InstallVer = Pkg.CurrentVer();
 868
 869    AddStates(Pkg);
 870
 871    Update(Pkg);
 872
 873    AddSizes(Pkg);
 874 }
 875                                                                         /*}}}*/
 876 // DepCache::MarkDelete - Put the package in the delete state           /*{{{*/
 877 // ---------------------------------------------------------------------
 878 /* */
 879 void pkgDepCache::MarkDelete(PkgIterator const &Pkg, bool rPurge,
 880                              unsigned long Depth, bool FromUser)
 881 {
 882    if (IsModeChangeOk(ModeDelete, Pkg, Depth, FromUser) == false)
 883       return;
 884
 885    StateCache &P = PkgState[Pkg->ID];
 886
 887    // Check that it is not already marked for delete
 888    if ((P.Mode == ModeDelete || P.InstallVer == 0) &&
 889        (Pkg.Purge() == true || rPurge == false))
 890       return;
 891
 892    // check if we are allowed to remove the package
 893    if (IsDeleteOk(Pkg,rPurge,Depth,FromUser) == false)
 894       return;
 895
 896    P.iFlags &= ~(AutoKept | Purge);
 897    if (rPurge == true)
 898       P.iFlags |= Purge;
 899
 900    ActionGroup group(*this);
 901
 902    if (DebugMarker == true)
 903       std::clog << OutputInDepth(Depth) << (rPurge ? "MarkPurge " : "MarkDelete ") << Pkg << " FU=" << FromUser << std::endl;
 904
 905    RemoveSizes(Pkg);
 906    RemoveStates(Pkg);
 907
 908    if (Pkg->CurrentVer == 0 && (Pkg.Purge() == true || rPurge == false))
 909       P.Mode = ModeKeep;
 910    else
 911       P.Mode = ModeDelete;
 912    P.InstallVer = 0;
 913
 914    AddStates(Pkg);
 915    Update(Pkg);
 916    AddSizes(Pkg);
 917
 918 }
 919                                                                         /*}}}*/
 920 // DepCache::IsDeleteOk - check if it is ok to remove this package      /*{{{*/
 921 // ---------------------------------------------------------------------
 922 /* The default implementation tries to prevent deletion of install requests.
 923    dpkg holds are enforced by the private IsModeChangeOk */
 924 bool pkgDepCache::IsDeleteOk(PkgIterator const &Pkg,bool rPurge,
 925                               unsigned long Depth, bool FromUser)
 926 {
 927    if (FromUser == false && Pkg->CurrentVer == 0)
 928    {
 929       StateCache &P = PkgState[Pkg->ID];
 930       // Status == 2 means this applies for new installs only
 931       if (P.InstallVer != 0 && P.Status == 2 && (P.Flags & Flag::Auto) != Flag::Auto)
 932       {
 933          if (DebugMarker == true)
 934             std::clog << OutputInDepth(Depth) << "Manual install request prevents MarkDelete of " << Pkg << std::endl;
 935          return false;
 936       }
 937    }
 938    return true;
 939 }
 940                                                                         /*}}}*/
 941 // DepCache::IsModeChangeOk - check if it is ok to change the mode      /*{{{*/
 942 // ---------------------------------------------------------------------
 943 /* this is used by all Mark methods on the very first line to check sanity
 944    and prevents mode changes for packages on hold for example.
 945    If you want to check Mode specific stuff you can use the virtual public
 946    Is<Mode>Ok methods instead */
 947 char const* PrintMode(char const mode)
 948 {
 949          switch (mode)
 950          {
 951          case pkgDepCache::ModeInstall: return "Install";
 952          case pkgDepCache::ModeKeep: return "Keep";
 953          case pkgDepCache::ModeDelete: return "Delete";
 954          default: return "UNKNOWN";
 955          }
 956 }
 957 bool pkgDepCache::IsModeChangeOk(ModeList const mode, PkgIterator const &Pkg,
 958                                  unsigned long const Depth, bool const FromUser)
 959 {
 960    // we are not trying to hard…
 961    if (unlikely(Depth > 100))
 962       return false;
 963
 964    // general sanity
 965    if (unlikely(Pkg.end() == true || Pkg->VersionList == 0))
 966       return false;
 967
 968    // the user is always right
 969    if (FromUser == true)
 970       return true;
 971
 972    StateCache &P = PkgState[Pkg->ID];
 973
 974    // if previous state was set by user only user can reset it
 975    if ((P.iFlags & Protected) == Protected)
 976    {
 977       if (unlikely(DebugMarker == true) && P.Mode != mode)
 978          std::clog << OutputInDepth(Depth) << "Ignore Mark" << PrintMode(mode)
 979                    << " of " << Pkg << " as its mode (" << PrintMode(P.Mode)
 980                    << ") is protected" << std::endl;
 981       return false;
 982    }
 983    // enforce dpkg holds
 984    else if (mode != ModeKeep && Pkg->SelectedState == pkgCache::State::Hold &&
 985             _config->FindB("APT::Ignore-Hold",false) == false)
 986    {
 987       if (unlikely(DebugMarker == true) && P.Mode != mode)
 988          std::clog << OutputInDepth(Depth) << "Hold prevents Mark" << PrintMode(mode)
 989                    << " of " << Pkg << std::endl;
 990       return false;
 991    }
 992
 993    return true;
 994 }
 995                                                                         /*}}}*/
 996 // DepCache::MarkInstall - Put the package in the install state         /*{{{*/
 997 // ---------------------------------------------------------------------
 998 /* */
 999 void pkgDepCache::MarkInstall(PkgIterator const &Pkg,bool AutoInst,
1000                               unsigned long Depth, bool FromUser,
1001                               bool ForceImportantDeps)
1002 {
1003    if (IsModeChangeOk(ModeInstall, Pkg, Depth, FromUser) == false)
1004       return;
1005
1006    StateCache &P = PkgState[Pkg->ID];
1007
1008    // See if there is even any possible instalation candidate
1009    if (P.CandidateVer == 0)
1010       return;
1011
1012    /* Check that it is not already marked for install and that it can be
1013       installed */
1014    if ((P.InstPolicyBroken() == false && P.InstBroken() == false) &&
1015        (P.Mode == ModeInstall ||
1016         P.CandidateVer == (Version *)Pkg.CurrentVer()))
1017    {
1018       if (P.CandidateVer == (Version *)Pkg.CurrentVer() && P.InstallVer == 0)
1019          MarkKeep(Pkg, false, FromUser, Depth+1);
1020       return;
1021    }
1022
1023    // check if we are allowed to install the package
1024    if (IsInstallOk(Pkg,AutoInst,Depth,FromUser) == false)
1025       return;
1026
1027    ActionGroup group(*this);
1028    P.iFlags &= ~AutoKept;
1029
1030    /* Target the candidate version and remove the autoflag. We reset the
1031       autoflag below if this was called recursively. Otherwise the user
1032       should have the ability to de-auto a package by changing its state */
1033    RemoveSizes(Pkg);
1034    RemoveStates(Pkg);
1035
1036    P.Mode = ModeInstall;
1037    P.InstallVer = P.CandidateVer;
1038
1039    if(FromUser)
1040      {
1041        // Set it to manual if it's a new install or already installed,
1042        // but only if its not marked by the autoremover (aptitude depend on this behavior)
1043        // or if we do automatic installation (aptitude never does it)
1044        if(P.Status == 2 || (Pkg->CurrentVer != 0 && (AutoInst == true || P.Marked == false)))
1045          P.Flags &= ~Flag::Auto;
1046      }
1047    else
1048      {
1049        // Set it to auto if this is a new install.
1050        if(P.Status == 2)
1051          P.Flags |= Flag::Auto;
1052      }
1053    if (P.CandidateVer == (Version *)Pkg.CurrentVer())
1054       P.Mode = ModeKeep;
1055
1056    AddStates(Pkg);
1057    Update(Pkg);
1058    AddSizes(Pkg);
1059
1060    if (AutoInst == false)
1061       return;
1062
1063    if (DebugMarker == true)
1064       std::clog << OutputInDepth(Depth) << "MarkInstall " << Pkg << " FU=" << FromUser << std::endl;
1065
1066    DepIterator Dep = P.InstVerIter(*this).DependsList();
1067    for (; Dep.end() != true;)
1068    {
1069       // Grok or groups
1070       DepIterator Start = Dep;
1071       bool Result = true;
1072       unsigned Ors = 0;
1073       for (bool LastOR = true; Dep.end() == false && LastOR == true; Dep++,Ors++)
1074       {
1075          LastOR = (Dep->CompareOp & Dep::Or) == Dep::Or;
1076
1077          if ((DepState[Dep->ID] & DepInstall) == DepInstall)
1078             Result = false;
1079       }
1080
1081       // Dep is satisfied okay.
1082       if (Result == false)
1083          continue;
1084
1085       /* Check if this dep should be consider for install. If it is a user
1086          defined important dep and we are installed a new package then
1087          it will be installed. Otherwise we only check for important
1088          deps that have changed from the installed version
1089       */
1090       if (IsImportantDep(Start) == false)
1091          continue;
1092
1093       /* Check if any ImportantDep() (but not Critical) were added
1094        * since we installed the package.  Also check for deps that
1095        * were satisfied in the past: for instance, if a version
1096        * restriction in a Recommends was tightened, upgrading the
1097        * package should follow that Recommends rather than causing the
1098        * dependency to be removed. (bug #470115)
1099        */
1100       bool isNewImportantDep = false;
1101       bool isPreviouslySatisfiedImportantDep = false;
1102       if(!ForceImportantDeps && !Start.IsCritical())
1103       {
1104          bool found=false;
1105          VerIterator instVer = Pkg.CurrentVer();
1106          if(!instVer.end())
1107          {
1108            for (DepIterator D = instVer.DependsList(); D.end() != true; D++)
1109              {
1110                //FIXME: deal better with or-groups(?)
1111                if(IsImportantDep(D) && !D.IsCritical() &&
1112                   Start.TargetPkg() == D.TargetPkg())
1113                  {
1114                    if(!isPreviouslySatisfiedImportantDep)
1115                      {
1116                        DepIterator D2 = D;
1117                        while((D2->CompareOp & Dep::Or) != 0)
1118                          ++D2;
1119
1120                        isPreviouslySatisfiedImportantDep =
1121                          (((*this)[D2] & DepGNow) != 0);
1122                      }
1123
1124                    found=true;
1125                  }
1126              }
1127             // this is a new dep if it was not found to be already
1128             // a important dep of the installed pacakge
1129             isNewImportantDep = !found;
1130          }
1131       }
1132       if(isNewImportantDep)
1133          if(DebugAutoInstall == true)
1134             std::clog << OutputInDepth(Depth) << "new important dependency: "
1135                       << Start.TargetPkg().Name() << std::endl;
1136       if(isPreviouslySatisfiedImportantDep)
1137         if(DebugAutoInstall == true)
1138           std::clog << OutputInDepth(Depth) << "previously satisfied important dependency on "
1139                     << Start.TargetPkg().Name() << std::endl;
1140
1141       // skip important deps if the package is already installed
1142       if (Pkg->CurrentVer != 0 && Start.IsCritical() == false
1143           && !isNewImportantDep && !isPreviouslySatisfiedImportantDep
1144           && !ForceImportantDeps)
1145          continue;
1146
1147       /* If we are in an or group locate the first or that can
1148          succeed. We have already cached this.. */
1149       for (; Ors > 1 && (DepState[Start->ID] & DepCVer) != DepCVer; Ors--)
1150          Start++;
1151
1152       /* This bit is for processing the possibilty of an install/upgrade
1153          fixing the problem */
1154       SPtrArray<Version *> List = Start.AllTargets();
1155       if (Start->Type != Dep::DpkgBreaks &&
1156           (DepState[Start->ID] & DepCVer) == DepCVer)
1157       {
1158          // Right, find the best version to install..
1159          Version **Cur = List;
1160          PkgIterator P = Start.TargetPkg();
1161          PkgIterator InstPkg(*Cache,0);
1162
1163          // See if there are direct matches (at the start of the list)
1164          for (; *Cur != 0 && (*Cur)->ParentPkg == P.Index(); Cur++)
1165          {
1166             PkgIterator Pkg(*Cache,Cache->PkgP + (*Cur)->ParentPkg);
1167             if (PkgState[Pkg->ID].CandidateVer != *Cur)
1168                continue;
1169             InstPkg = Pkg;
1170             break;
1171          }
1172
1173          // Select the highest priority providing package
1174          if (InstPkg.end() == true)
1175          {
1176             pkgPrioSortList(*Cache,Cur);
1177             for (; *Cur != 0; Cur++)
1178             {
1179                PkgIterator Pkg(*Cache,Cache->PkgP + (*Cur)->ParentPkg);
1180                if (PkgState[Pkg->ID].CandidateVer != *Cur)
1181                   continue;
1182                InstPkg = Pkg;
1183                break;
1184             }
1185          }
1186
1187          if (InstPkg.end() == false)
1188          {
1189             if(DebugAutoInstall == true)
1190                std::clog << OutputInDepth(Depth) << "Installing " << InstPkg.Name()
1191                          << " as " << Start.DepType() << " of " << Pkg.Name()
1192                          << std::endl;
1193             // now check if we should consider it a automatic dependency or not
1194             if(Pkg.Section() && ConfigValueInSubTree("APT::Never-MarkAuto-Sections", Pkg.Section()))
1195             {
1196                if(DebugAutoInstall == true)
1197                   std::clog << OutputInDepth(Depth) << "Setting NOT as auto-installed (direct "
1198                             << Start.DepType() << " of pkg in APT::Never-MarkAuto-Sections)" << std::endl;
1199                MarkInstall(InstPkg,true,Depth + 1, true);
1200             }
1201             else
1202             {
1203                // mark automatic dependency
1204                MarkInstall(InstPkg,true,Depth + 1, false, ForceImportantDeps);
1205                // Set the autoflag, after MarkInstall because MarkInstall unsets it
1206                if (P->CurrentVer == 0)
1207                   PkgState[InstPkg->ID].Flags |= Flag::Auto;
1208             }
1209          }
1210          continue;
1211       }
1212
1213       /* For conflicts we just de-install the package and mark as auto,
1214          Conflicts may not have or groups.  For dpkg's Breaks we try to
1215          upgrade the package. */
1216       if (Start->Type == Dep::Conflicts || Start->Type == Dep::Obsoletes ||
1217           Start->Type == Dep::DpkgBreaks)
1218       {
1219          for (Version **I = List; *I != 0; I++)
1220          {
1221             VerIterator Ver(*this,*I);
1222             PkgIterator Pkg = Ver.ParentPkg();
1223
1224             /* The List includes all packages providing this dependency,
1225                even providers which are not installed, so skip them. */
1226             if (PkgState[Pkg->ID].InstallVer == 0)
1227                continue;
1228
1229             if (PkgState[Pkg->ID].CandidateVer != *I &&
1230                 Start->Type == Dep::DpkgBreaks)
1231                MarkInstall(Pkg,true,Depth + 1, false, ForceImportantDeps);
1232             else
1233                MarkDelete(Pkg,false,Depth + 1, false);
1234          }
1235          continue;
1236       }
1237    }
1238 }
1239                                                                         /*}}}*/
1240 // DepCache::IsInstallOk - check if it is ok to install this package    /*{{{*/
1241 // ---------------------------------------------------------------------
1242 /* The default implementation does nothing.
1243    dpkg holds are enforced by the private IsModeChangeOk */
1244 bool pkgDepCache::IsInstallOk(PkgIterator const &Pkg,bool AutoInst,
1245                               unsigned long Depth, bool FromUser)
1246 {
1247    return true;
1248 }
1249                                                                         /*}}}*/
1250 // DepCache::SetReInstall - Set the reinstallation flag                 /*{{{*/
1251 // ---------------------------------------------------------------------
1252 /* */
1253 void pkgDepCache::SetReInstall(PkgIterator const &Pkg,bool To)
1254 {
1255    if (unlikely(Pkg.end() == true))
1256       return;
1257
1258    ActionGroup group(*this);
1259
1260    RemoveSizes(Pkg);
1261    RemoveStates(Pkg);
1262
1263    StateCache &P = PkgState[Pkg->ID];
1264    if (To == true)
1265       P.iFlags |= ReInstall;
1266    else
1267       P.iFlags &= ~ReInstall;
1268
1269    AddStates(Pkg);
1270    AddSizes(Pkg);
1271 }
1272                                                                         /*}}}*/
1273 // DepCache::SetCandidateVersion - Change the candidate version         /*{{{*/
1274 // ---------------------------------------------------------------------
1275 /* */
1276 void pkgDepCache::SetCandidateVersion(VerIterator TargetVer, bool const &Pseudo)
1277 {
1278    pkgCache::PkgIterator Pkg = TargetVer.ParentPkg();
1279    StateCache &P = PkgState[Pkg->ID];
1280
1281    if (P.CandidateVer == TargetVer)
1282       return;
1283
1284    ActionGroup group(*this);
1285
1286    RemoveSizes(Pkg);
1287    RemoveStates(Pkg);
1288
1289    if (P.CandidateVer == P.InstallVer && P.Install() == true)
1290       P.InstallVer = (Version *)TargetVer;
1291    P.CandidateVer = (Version *)TargetVer;
1292    P.Update(Pkg,*this);
1293
1294    AddStates(Pkg);
1295    Update(Pkg);
1296    AddSizes(Pkg);
1297
1298 }
1299                                                                         /*}}}*/
1300 // DepCache::SetCandidateRelease - Change the candidate version         /*{{{*/
1301 // ---------------------------------------------------------------------
1302 /* changes the candidate of a package and walks over all its dependencies
1303    to check if it needs to change the candidate of the dependency, too,
1304    to reach a installable versionstate */
1305 bool pkgDepCache::SetCandidateRelease(pkgCache::VerIterator TargetVer,
1306                                         std::string const &TargetRel)
1307 {
1308    std::list<std::pair<pkgCache::VerIterator, pkgCache::VerIterator> > Changed;
1309    return SetCandidateRelease(TargetVer, TargetRel, Changed);
1310 }
1311 bool pkgDepCache::SetCandidateRelease(pkgCache::VerIterator TargetVer,
1312                                         std::string const &TargetRel,
1313                                         std::list<std::pair<pkgCache::VerIterator, pkgCache::VerIterator> > &Changed)
1314 {
1315    ActionGroup group(*this);
1316    SetCandidateVersion(TargetVer);
1317
1318    if (TargetRel == "installed" || TargetRel == "candidate") // both doesn't make sense in this context
1319       return true;
1320
1321    pkgVersionMatch Match(TargetRel, pkgVersionMatch::Release);
1322    // save the position of the last element we will not undo - if we have to
1323    std::list<std::pair<pkgCache::VerIterator, pkgCache::VerIterator> >::iterator newChanged = --(Changed.end());
1324
1325    for (pkgCache::DepIterator D = TargetVer.DependsList(); D.end() == false; ++D)
1326    {
1327       if (D->Type != pkgCache::Dep::PreDepends && D->Type != pkgCache::Dep::Depends &&
1328           ((D->Type != pkgCache::Dep::Recommends && D->Type != pkgCache::Dep::Suggests) ||
1329            IsImportantDep(D) == false))
1330          continue;
1331
1332       // walk over an or-group and check if we need to do anything
1333       // for simpilicity no or-group is handled as a or-group including one dependency
1334       pkgCache::DepIterator Start = D;
1335       bool itsFine = false;
1336       for (bool stillOr = true; stillOr == true; ++Start)
1337       {
1338          stillOr = (Start->CompareOp & Dep::Or) == Dep::Or;
1339          pkgCache::PkgIterator const P = Start.TargetPkg();
1340          // virtual packages can't be a solution
1341          if (P.end() == true || (P->ProvidesList == 0 && P->VersionList == 0))
1342             continue;
1343          pkgCache::VerIterator const Cand = PkgState[P->ID].CandidateVerIter(*this);
1344          // no versioned dependency - but is it installable?
1345          if (Start.TargetVer() == 0 || Start.TargetVer()[0] == '\0')
1346          {
1347             // Check if one of the providers is installable
1348             if (P->ProvidesList != 0)
1349             {
1350                pkgCache::PrvIterator Prv = P.ProvidesList();
1351                for (; Prv.end() == false; ++Prv)
1352                {
1353                   pkgCache::VerIterator const C = PkgState[Prv.OwnerPkg()->ID].CandidateVerIter(*this);
1354                   if (C.end() == true || C != Prv.OwnerVer() ||
1355                       (VersionState(C.DependsList(), DepInstall, DepCandMin, DepCandPolicy) & DepCandMin) != DepCandMin)
1356                      continue;
1357                   break;
1358                }
1359                if (Prv.end() == true)
1360                   continue;
1361             }
1362             // no providers, so check if we have an installable candidate version
1363             else if (Cand.end() == true ||
1364                 (VersionState(Cand.DependsList(), DepInstall, DepCandMin, DepCandPolicy) & DepCandMin) != DepCandMin)
1365                continue;
1366             itsFine = true;
1367             break;
1368          }
1369          if (Cand.end() == true)
1370             continue;
1371          // check if the current candidate is enough for the versioned dependency - and installable?
1372          if (VS().CheckDep(P.CandVersion(), Start->CompareOp, Start.TargetVer()) == true &&
1373              (VersionState(Cand.DependsList(), DepInstall, DepCandMin, DepCandPolicy) & DepCandMin) == DepCandMin)
1374          {
1375             itsFine = true;
1376             break;
1377          }
1378       }
1379
1380       if (itsFine == true) {
1381          // something in the or-group was fine, skip all other members
1382          for (; (D->CompareOp & Dep::Or) == Dep::Or; ++D);
1383          continue;
1384       }
1385
1386       // walk again over the or-group and check each if a candidate switch would help
1387       itsFine = false;
1388       for (bool stillOr = true; stillOr == true; ++D)
1389       {
1390          stillOr = (D->CompareOp & Dep::Or) == Dep::Or;
1391          // changing candidate will not help if the dependency is not versioned
1392          if (D.TargetVer() == 0 || D.TargetVer()[0] == '\0')
1393          {
1394             if (stillOr == true)
1395                continue;
1396             break;
1397          }
1398
1399          pkgCache::VerIterator V;
1400          if (TargetRel == "newest")
1401             V = D.TargetPkg().VersionList();
1402          else
1403             V = Match.Find(D.TargetPkg());
1404
1405          // check if the version from this release could satisfy the dependency
1406          if (V.end() == true || VS().CheckDep(V.VerStr(), D->CompareOp, D.TargetVer()) == false)
1407          {
1408             if (stillOr == true)
1409                continue;
1410             break;
1411          }
1412
1413          pkgCache::VerIterator oldCand = PkgState[D.TargetPkg()->ID].CandidateVerIter(*this);
1414          if (V == oldCand)
1415          {
1416             // Do we already touched this Version? If so, their versioned dependencies are okay, no need to check again
1417             for (std::list<std::pair<pkgCache::VerIterator, pkgCache::VerIterator> >::const_iterator c = Changed.begin();
1418                  c != Changed.end(); ++c)
1419             {
1420                if (c->first->ParentPkg != V->ParentPkg)
1421                   continue;
1422                itsFine = true;
1423                break;
1424             }
1425          }
1426
1427          if (itsFine == false)
1428          {
1429             // change the candidate
1430             Changed.push_back(make_pair(oldCand, TargetVer));
1431             if (SetCandidateRelease(V, TargetRel, Changed) == false)
1432             {
1433                if (stillOr == false)
1434                   break;
1435                // undo the candidate changing
1436                SetCandidateVersion(oldCand);
1437                Changed.pop_back();
1438                continue;
1439             }
1440             itsFine = true;
1441          }
1442
1443          // something in the or-group was fine, skip all other members
1444          for (; (D->CompareOp & Dep::Or) == Dep::Or; ++D);
1445          break;
1446       }
1447
1448       if (itsFine == false && (D->Type == pkgCache::Dep::PreDepends || D->Type == pkgCache::Dep::Depends))
1449       {
1450          // undo all changes which aren't lead to a solution
1451          for (std::list<std::pair<pkgCache::VerIterator, pkgCache::VerIterator> >::const_iterator c = ++newChanged;
1452               c != Changed.end(); ++c)
1453             SetCandidateVersion(c->first);
1454          Changed.erase(newChanged, Changed.end());
1455          return false;
1456       }
1457    }
1458    return true;
1459 }
1460                                                                         /*}}}*/
1461 // DepCache::MarkAuto - set the Auto flag for a package                 /*{{{*/
1462 // ---------------------------------------------------------------------
1463 /* */
1464 void pkgDepCache::MarkAuto(const PkgIterator &Pkg, bool Auto)
1465 {
1466   StateCache &state = PkgState[Pkg->ID];
1467
1468   ActionGroup group(*this);
1469
1470   if(Auto)
1471     state.Flags |= Flag::Auto;
1472   else
1473     state.Flags &= ~Flag::Auto;
1474 }
1475                                                                         /*}}}*/
1476 // StateCache::Update - Compute the various static display things       /*{{{*/
1477 // ---------------------------------------------------------------------
1478 /* This is called whenever the Candidate version changes. */
1479 void pkgDepCache::StateCache::Update(PkgIterator Pkg,pkgCache &Cache)
1480 {
1481    // Some info
1482    VerIterator Ver = CandidateVerIter(Cache);
1483
1484    // Use a null string or the version string
1485    if (Ver.end() == true)
1486       CandVersion = "";
1487    else
1488       CandVersion = Ver.VerStr();
1489
1490    // Find the current version
1491    CurVersion = "";
1492    if (Pkg->CurrentVer != 0)
1493       CurVersion = Pkg.CurrentVer().VerStr();
1494
1495    // Strip off the epochs for display
1496    CurVersion = StripEpoch(CurVersion);
1497    CandVersion = StripEpoch(CandVersion);
1498
1499    // Figure out if its up or down or equal
1500    Status = Ver.CompareVer(Pkg.CurrentVer());
1501    if (Pkg->CurrentVer == 0 || Pkg->VersionList == 0 || CandidateVer == 0)
1502      Status = 2;
1503 }
1504                                                                         /*}}}*/
1505 // StateCache::StripEpoch - Remove the epoch specifier from the version /*{{{*/
1506 // ---------------------------------------------------------------------
1507 /* */
1508 const char *pkgDepCache::StateCache::StripEpoch(const char *Ver)
1509 {
1510    if (Ver == 0)
1511       return 0;
1512
1513    // Strip any epoch
1514    for (const char *I = Ver; *I != 0; I++)
1515       if (*I == ':')
1516          return I + 1;
1517    return Ver;
1518 }
1519                                                                         /*}}}*/
1520 // Policy::GetCandidateVer - Returns the Candidate install version      /*{{{*/
1521 // ---------------------------------------------------------------------
1522 /* The default just returns the highest available version that is not
1523    a source and automatic. */
1524 pkgCache::VerIterator pkgDepCache::Policy::GetCandidateVer(PkgIterator const &Pkg)
1525 {
1526    /* Not source/not automatic versions cannot be a candidate version
1527       unless they are already installed */
1528    VerIterator Last(*(pkgCache *)this,0);
1529
1530    for (VerIterator I = Pkg.VersionList(); I.end() == false; I++)
1531    {
1532       if (Pkg.CurrentVer() == I)
1533          return I;
1534
1535       for (VerFileIterator J = I.FileList(); J.end() == false; J++)
1536       {
1537          if ((J.File()->Flags & Flag::NotSource) != 0)
1538             continue;
1539
1540          /* Stash the highest version of a not-automatic source, we use it
1541             if there is nothing better */
1542          if ((J.File()->Flags & Flag::NotAutomatic) != 0 ||
1543              (J.File()->Flags & Flag::ButAutomaticUpgrades) != 0)
1544          {
1545             if (Last.end() == true)
1546                Last = I;
1547             continue;
1548          }
1549
1550          return I;
1551       }
1552    }
1553
1554    return Last;
1555 }
1556                                                                         /*}}}*/
1557 // Policy::IsImportantDep - True if the dependency is important         /*{{{*/
1558 // ---------------------------------------------------------------------
1559 /* */
1560 bool pkgDepCache::Policy::IsImportantDep(DepIterator const &Dep)
1561 {
1562    if(Dep.IsCritical())
1563       return true;
1564    else if(Dep->Type == pkgCache::Dep::Recommends)
1565    {
1566       if ( _config->FindB("APT::Install-Recommends", false))
1567          return true;
1568       // we suport a special mode to only install-recommends for certain
1569       // sections
1570       // FIXME: this is a meant as a temporarly solution until the
1571       //        recommends are cleaned up
1572       const char *sec = Dep.ParentVer().Section();
1573       if (sec && ConfigValueInSubTree("APT::Install-Recommends-Sections", sec))
1574          return true;
1575    }
1576    else if(Dep->Type == pkgCache::Dep::Suggests)
1577      return _config->FindB("APT::Install-Suggests", false);
1578
1579    return false;
1580 }
1581                                                                         /*}}}*/
1582 pkgDepCache::InRootSetFunc *pkgDepCache::GetRootSetFunc()               /*{{{*/
1583 {
1584   DefaultRootSetFunc *f = new DefaultRootSetFunc;
1585   if(f->wasConstructedSuccessfully())
1586     return f;
1587   else
1588     {
1589       delete f;
1590       return NULL;
1591     }
1592 }
1593                                                                         /*}}}*/
1594 bool pkgDepCache::MarkFollowsRecommends()
1595 {
1596   return _config->FindB("APT::AutoRemove::RecommendsImportant", true);
1597 }
1598
1599 bool pkgDepCache::MarkFollowsSuggests()
1600 {
1601   return _config->FindB("APT::AutoRemove::SuggestsImportant", false);
1602 }
1603
1604 // pkgDepCache::MarkRequired - the main mark algorithm                  /*{{{*/
1605 bool pkgDepCache::MarkRequired(InRootSetFunc &userFunc)
1606 {
1607    bool follow_recommends;
1608    bool follow_suggests;
1609    bool debug_autoremove = _config->FindB("Debug::pkgAutoRemove",false);
1610
1611    // init the states
1612    for(PkgIterator p = PkgBegin(); !p.end(); ++p)
1613    {
1614       PkgState[p->ID].Marked  = false;
1615       PkgState[p->ID].Garbage = false;
1616
1617       // debug output
1618       if(debug_autoremove && PkgState[p->ID].Flags & Flag::Auto)
1619          std::clog << "AutoDep: " << p.FullName() << std::endl;
1620    }
1621
1622    // init vars
1623    follow_recommends = MarkFollowsRecommends();
1624    follow_suggests   = MarkFollowsSuggests();
1625
1626
1627
1628    // do the mark part, this is the core bit of the algorithm
1629    for(PkgIterator p = PkgBegin(); !p.end(); ++p)
1630    {
1631       if(!(PkgState[p->ID].Flags & Flag::Auto) ||
1632           (p->Flags & Flag::Essential) ||
1633           userFunc.InRootSet(p) ||
1634           // be nice even then a required package violates the policy (#583517)
1635           // and do the full mark process also for required packages
1636           (p.CurrentVer().end() != true &&
1637            p.CurrentVer()->Priority == pkgCache::State::Required))
1638       {
1639          // the package is installed (and set to keep)
1640          if(PkgState[p->ID].Keep() && !p.CurrentVer().end())
1641             MarkPackage(p, p.CurrentVer(),
1642                         follow_recommends, follow_suggests);
1643          // the package is to be installed
1644          else if(PkgState[p->ID].Install())
1645             MarkPackage(p, PkgState[p->ID].InstVerIter(*this),
1646                         follow_recommends, follow_suggests);
1647       }
1648    }
1649
1650    return true;
1651 }
1652                                                                         /*}}}*/
1653 // MarkPackage - mark a single package in Mark-and-Sweep                /*{{{*/
1654 void pkgDepCache::MarkPackage(const pkgCache::PkgIterator &pkg,
1655                               const pkgCache::VerIterator &ver,
1656                               bool const &follow_recommends,
1657                               bool const &follow_suggests)
1658 {
1659    pkgDepCache::StateCache &state = PkgState[pkg->ID];
1660
1661    // if we are marked already we are done
1662    if(state.Marked)
1663       return;
1664
1665    VerIterator const currver = pkg.CurrentVer();
1666    VerIterator const instver = state.InstVerIter(*this);
1667
1668 #if 0
1669    VerIterator const candver = state.CandidateVerIter(*this);
1670
1671    // If a package was garbage-collected but is now being marked, we
1672    // should re-select it
1673    // For cases when a pkg is set to upgrade and this trigger the
1674    // removal of a no-longer used dependency.  if the pkg is set to
1675    // keep again later it will result in broken deps
1676    if(state.Delete() && state.RemoveReason = Unused)
1677    {
1678       if(ver==candver)
1679          mark_install(pkg, false, false, NULL);
1680       else if(ver==pkg.CurrentVer())
1681          MarkKeep(pkg, false, false);
1682
1683       instver=state.InstVerIter(*this);
1684    }
1685 #endif
1686
1687    // For packages that are not going to be removed, ignore versions
1688    // other than the InstVer.  For packages that are going to be
1689    // removed, ignore versions other than the current version.
1690    if(!(ver == instver && !instver.end()) &&
1691       !(ver == currver && instver.end() && !ver.end()))
1692       return;
1693
1694    bool const debug_autoremove = _config->FindB("Debug::pkgAutoRemove", false);
1695
1696    if(debug_autoremove)
1697      {
1698        std::clog << "Marking: " << pkg.FullName();
1699        if(!ver.end())
1700          std::clog << " " << ver.VerStr();
1701        if(!currver.end())
1702          std::clog << ", Curr=" << currver.VerStr();
1703        if(!instver.end())
1704          std::clog << ", Inst=" << instver.VerStr();
1705        std::clog << std::endl;
1706      }
1707
1708    state.Marked=true;
1709
1710    if(ver.end() == true)
1711       return;
1712
1713      for(DepIterator d = ver.DependsList(); !d.end(); ++d)
1714      {
1715         if(d->Type == Dep::Depends ||
1716            d->Type == Dep::PreDepends ||
1717            (follow_recommends &&
1718             d->Type == Dep::Recommends) ||
1719            (follow_suggests &&
1720             d->Type == Dep::Suggests))
1721         {
1722            // Try all versions of this package.
1723            for(VerIterator V = d.TargetPkg().VersionList();
1724                !V.end(); ++V)
1725            {
1726               if(_system->VS->CheckDep(V.VerStr(), d->CompareOp, d.TargetVer()))
1727               {
1728                 if(debug_autoremove)
1729                   {
1730                     std::clog << "Following dep: " << d.ParentPkg().FullName()
1731                               << " " << d.ParentVer().VerStr() << " "
1732                               << d.DepType() << " " << d.TargetPkg().FullName();
1733                     if((d->CompareOp & ~pkgCache::Dep::Or) != pkgCache::Dep::NoOp)
1734                       {
1735                         std::clog << " (" << d.CompType() << " "
1736                                   << d.TargetVer() << ")";
1737                       }
1738                     std::clog << std::endl;
1739                   }
1740                  MarkPackage(V.ParentPkg(), V,
1741                              follow_recommends, follow_suggests);
1742               }
1743            }
1744            // Now try virtual packages
1745            for(PrvIterator prv=d.TargetPkg().ProvidesList();
1746                !prv.end(); ++prv)
1747            {
1748               if(_system->VS->CheckDep(prv.ProvideVersion(), d->CompareOp,
1749                                        d.TargetVer()))
1750               {
1751                 if(debug_autoremove)
1752                   {
1753                     std::clog << "Following dep: " << d.ParentPkg().FullName() << " "
1754                               << d.ParentVer().VerStr() << " "
1755                               << d.DepType() << " " << d.TargetPkg().FullName() << " ";
1756                     if((d->CompareOp & ~pkgCache::Dep::Or) != pkgCache::Dep::NoOp)
1757                       {
1758                         std::clog << " (" << d.CompType() << " "
1759                                   << d.TargetVer() << ")";
1760                       }
1761                     std::clog << ", provided by "
1762                               << prv.OwnerPkg().FullName() << " "
1763                               << prv.OwnerVer().VerStr()
1764                               << std::endl;
1765                   }
1766
1767                  MarkPackage(prv.OwnerPkg(), prv.OwnerVer(),
1768                              follow_recommends, follow_suggests);
1769               }
1770            }
1771         }
1772      }
1773 }
1774                                                                         /*}}}*/
1775 bool pkgDepCache::Sweep()                                               /*{{{*/
1776 {
1777    bool debug_autoremove = _config->FindB("Debug::pkgAutoRemove",false);
1778
1779    // do the sweep
1780    for(PkgIterator p=PkgBegin(); !p.end(); ++p)
1781    {
1782      StateCache &state=PkgState[p->ID];
1783
1784      // skip required packages
1785      if (!p.CurrentVer().end() &&
1786          (p.CurrentVer()->Priority == pkgCache::State::Required))
1787         continue;
1788
1789      // if it is not marked and it is installed, it's garbage
1790      if(!state.Marked && (!p.CurrentVer().end() || state.Install()))
1791      {
1792         state.Garbage=true;
1793         if(debug_autoremove)
1794            std::clog << "Garbage: " << p.FullName() << std::endl;
1795      }
1796   }
1797
1798    return true;
1799 }
1800                                                                         /*}}}*/