apt-pkg/algorithms.h

   1 // -*- mode: cpp; mode: fold -*-
   2 // Description                                                          /*{{{*/
   3 // $Id: algorithms.h,v 1.10 2001/05/22 04:17:41 jgg Exp $
   4 /* ######################################################################
   5
   6    Algorithms - A set of misc algorithms
   7
   8    This simulate class displays what the ordering code has done and
   9    analyses it with a fresh new dependency cache. In this way we can
  10    see all of the effects of an upgrade run.
  11
  12    pkgDistUpgrade computes an upgrade that causes as many packages as
  13    possible to move to the newest verison.
  14
  15    pkgApplyStatus sets the target state based on the content of the status
  16    field in the status file. It is important to get proper crash recovery.
  17
  18    pkgFixBroken corrects a broken system so that it is in a sane state.
  19
  20    pkgAllUpgrade attempts to upgade as many packages as possible but
  21    without installing new packages.
  22
  23    The problem resolver class contains a number of complex algorithms
  24    to try to best-guess an upgrade state. It solves the problem of
  25    maximizing the number of install state packages while having no broken
  26    packages.
  27
  28    ##################################################################### */
  29                                                                         /*}}}*/
  30 #ifndef PKGLIB_ALGORITHMS_H
  31 #define PKGLIB_ALGORITHMS_H
  32
  33
  34 #include <apt-pkg/packagemanager.h>
  35 #include <apt-pkg/depcache.h>
  36
  37 #include <iostream>
  38
  39 #include <apt-pkg/macros.h>
  40
  41 #ifndef APT_8_CLEANER_HEADERS
  42 #include <apt-pkg/acquire.h>
  43 using std::ostream;
  44 #endif
  45
  46 class pkgAcquireStatus;
  47
  48 namespace APT {
  49    namespace Upgrade {
  50       // FIXME: make this "enum class UpgradeMode {" once we enable c++11
  51       enum UpgradeMode {
  52          FORBID_REMOVE_PACKAGES = 1,
  53          FORBID_NEW_INSTALL_PACKAGES = 2,
  54       };
  55       bool Upgrade(pkgDepCache &Cache, int UpgradeMode);
  56    }
  57 }
  58
  59 class pkgSimulate : public pkgPackageManager                            /*{{{*/
  60 {
  61    protected:
  62
  63    class Policy : public pkgDepCache::Policy
  64    {
  65       pkgDepCache *Cache;
  66       public:
  67
  68       virtual VerIterator GetCandidateVer(PkgIterator const &Pkg)
  69       {
  70          return (*Cache)[Pkg].CandidateVerIter(*Cache);
  71       }
  72
  73       Policy(pkgDepCache *Cache) : Cache(Cache) {};
  74    };
  75
  76    unsigned char *Flags;
  77
  78    Policy iPolicy;
  79    pkgDepCache Sim;
  80    pkgDepCache::ActionGroup group;
  81
  82    // The Actuall installation implementation
  83    virtual bool Install(PkgIterator Pkg,std::string File);
  84    virtual bool Configure(PkgIterator Pkg);
  85    virtual bool Remove(PkgIterator Pkg,bool Purge);
  86
  87 private:
  88    void ShortBreaks();
  89    void Describe(PkgIterator iPkg,std::ostream &out,bool Current,bool Candidate);
  90
  91    public:
  92
  93    pkgSimulate(pkgDepCache *Cache);
  94    ~pkgSimulate();
  95 };
  96                                                                         /*}}}*/
  97 class pkgProblemResolver                                                /*{{{*/
  98 {
  99  private:
 100    /** \brief dpointer placeholder (for later in case we need it) */
 101    void *d;
 102
 103    pkgDepCache &Cache;
 104    typedef pkgCache::PkgIterator PkgIterator;
 105    typedef pkgCache::VerIterator VerIterator;
 106    typedef pkgCache::DepIterator DepIterator;
 107    typedef pkgCache::PrvIterator PrvIterator;
 108    typedef pkgCache::Version Version;
 109    typedef pkgCache::Package Package;
 110
 111    enum Flags {Protected = (1 << 0), PreInstalled = (1 << 1),
 112                Upgradable = (1 << 2), ReInstateTried = (1 << 3),
 113                ToRemove = (1 << 4)};
 114    int *Scores;
 115    unsigned char *Flags;
 116    bool Debug;
 117
 118    // Sort stuff
 119    static pkgProblemResolver *This;
 120    static int ScoreSort(const void *a,const void *b);
 121
 122    struct PackageKill
 123    {
 124       PkgIterator Pkg;
 125       DepIterator Dep;
 126    };
 127
 128    void MakeScores();
 129    bool DoUpgrade(pkgCache::PkgIterator Pkg);
 130
 131    bool ResolveInternal(bool const BrokenFix = false);
 132    bool ResolveByKeepInternal();
 133
 134    protected:
 135    bool InstOrNewPolicyBroken(pkgCache::PkgIterator Pkg);
 136
 137    public:
 138
 139    inline void Protect(pkgCache::PkgIterator Pkg) {Flags[Pkg->ID] |= Protected; Cache.MarkProtected(Pkg);};
 140    inline void Remove(pkgCache::PkgIterator Pkg) {Flags[Pkg->ID] |= ToRemove;};
 141    inline void Clear(pkgCache::PkgIterator Pkg) {Flags[Pkg->ID] &= ~(Protected | ToRemove);};
 142
 143    // Try to intelligently resolve problems by installing and removing packages
 144    bool Resolve(bool BrokenFix = false);
 145
 146    // Try to resolve problems only by using keep
 147    bool ResolveByKeep();
 148
 149    __deprecated void InstallProtect();
 150
 151    pkgProblemResolver(pkgDepCache *Cache);
 152    ~pkgProblemResolver();
 153 };
 154                                                                         /*}}}*/
 155 bool pkgDistUpgrade(pkgDepCache &Cache);
 156 bool pkgApplyStatus(pkgDepCache &Cache);
 157 bool pkgFixBroken(pkgDepCache &Cache);
 158
 159 bool pkgAllUpgrade(pkgDepCache &Cache);
 160
 161 bool pkgMinimizeUpgrade(pkgDepCache &Cache);
 162
 163 void pkgPrioSortList(pkgCache &Cache,pkgCache::Version **List);
 164
 165 bool ListUpdate(pkgAcquireStatus &progress, pkgSourceList &List, int PulseInterval=0);
 166 bool AcquireUpdate(pkgAcquire &Fetcher, int const PulseInterval = 0,
 167                    bool const RunUpdateScripts = true, bool const ListCleanup = true);
 168
 169 #endif