zypp/solver/detail/Resolver.h

   1 /* -*- Mode: C++; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 4 -*- */
   2 /* Resolver.h
   3  *
   4  * Copyright (C) 2000-2002 Ximian, Inc.
   5  * Copyright (C) 2005 SUSE Linux Products GmbH
   6  *
   7  * This program is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU General Public License,
   9  * version 2, as published by the Free Software Foundation.
  10  *
  11  * This program is distributed in the hope that it will be useful, but
  12  * WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program; if not, write to the Free Software
  18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  19  * 02111-1307, USA.
  20  */
  21
  22 #ifndef ZYPP_SOLVER_DETAIL_RESOLVER_H
  23 #define ZYPP_SOLVER_DETAIL_RESOLVER_H
  24
  25 #include <iosfwd>
  26 #include <list>
  27 #include <map>
  28 #include <string>
  29
  30 #include "zypp/base/ReferenceCounted.h"
  31 #include "zypp/base/PtrTypes.h"
  32
  33 #include "zypp/ResPool.h"
  34 #include "zypp/TriBool.h"
  35 #include "zypp/base/SerialNumber.h"
  36
  37 #include "zypp/solver/detail/Types.h"
  38 #include "zypp/solver/detail/SolverQueueItem.h"
  39
  40 #include "zypp/ProblemTypes.h"
  41 #include "zypp/ResolverProblem.h"
  42 #include "zypp/ProblemSolution.h"
  43 #include "zypp/UpgradeStatistics.h"
  44 #include "zypp/Capabilities.h"
  45 #include "zypp/Capability.h"
  46
  47
  48 /////////////////////////////////////////////////////////////////////////
  49 namespace zypp
  50 { ///////////////////////////////////////////////////////////////////////
  51   ///////////////////////////////////////////////////////////////////////
  52   namespace solver
  53   { /////////////////////////////////////////////////////////////////////
  54     /////////////////////////////////////////////////////////////////////
  55     namespace detail
  56     { ///////////////////////////////////////////////////////////////////
  57
  58     class SATResolver;
  59
  60
  61     ///////////////////////////////////////////////////////////////////
  62     //
  63     //  CLASS NAME : ItemCapKind
  64     //
  65     /** */
  66     struct ItemCapKind
  67     {
  68         public:
  69         Capability cap; //Capability which has triggerd this selection
  70         Dep capKind; //Kind of that capability
  71         PoolItem item; //Item which has triggered this selection
  72         bool initialInstallation; //This item has triggered the installation
  73                                   //Not already fullfilled requierement only.
  74
  75     ItemCapKind() : capKind(Dep::PROVIDES) {}
  76             ItemCapKind( PoolItem i, Capability c, Dep k, bool initial)
  77                 : cap( c )
  78                 , capKind( k )
  79                 , item( i )
  80                 , initialInstallation( initial )
  81             { }
  82     };
  83     typedef std::multimap<PoolItem,ItemCapKind> ItemCapKindMap;
  84     typedef std::list<ItemCapKind> ItemCapKindList;
  85
  86
  87 ///////////////////////////////////////////////////////////////////
  88 //
  89 //      CLASS NAME : Resolver
  90
  91 class Resolver : public base::ReferenceCounted, private base::NonCopyable {
  92
  93   private:
  94     ResPool _pool;
  95     SATResolver *_satResolver;
  96     SerialNumberWatcher _poolchanged;
  97     bool _testing;
  98
  99     CapabilitySet _extra_requires;
 100     CapabilitySet _extra_conflicts;
 101
 102     // Regard dependencies of the item weak onl
 103     PoolItemList _addWeak;
 104
 105     bool _forceResolve;           // remove items which are conflicts with others or
 106                                   // have unfulfilled requirements.
 107                                   // This behaviour is favourited by ZMD
 108     bool _upgradeMode;            // Resolver has been called with doUpgrade
 109     bool _updateMode;            // Resolver has been called with doUpdate
 110     bool _verifying;              // The system will be checked
 111     TriBool _onlyRequires;        // do install required resolvables only
 112                                   // no recommended resolvables, language
 113                                   // packages, hardware packages (modalias)
 114
 115     bool _ignorealreadyrecommended;   //ignore recommended packages that have already been recommended by the installed packages
 116
 117     // Additional QueueItems which has to be regarded by the solver
 118     // This will be used e.g. by solution actions
 119     solver::detail::SolverQueueItemList _removed_queue_items;
 120     solver::detail::SolverQueueItemList _added_queue_items;
 121
 122     // Additional information about the solverrun
 123     ItemCapKindMap _isInstalledBy;
 124     ItemCapKindMap _installs;
 125     ItemCapKindMap _satifiedByInstalled;
 126     ItemCapKindMap _installedSatisfied;
 127
 128     // helpers
 129     void collectResolverInfo (void);
 130
 131     // Unmaintained packages which does not fit to the updated system
 132     // (broken dependencies) will be deleted.
 133     // returns true if solving was successful
 134     bool checkUnmaintainedItems ();
 135
 136     void solverInit();
 137
 138   public:
 139
 140     Resolver (const ResPool & pool);
 141     virtual ~Resolver();
 142
 143     // ---------------------------------- I/O
 144
 145     virtual std::ostream & dumpOn( std::ostream & str ) const;
 146     friend std::ostream& operator<<(std::ostream& str, const Resolver & obj)
 147     { return obj.dumpOn (str); }
 148
 149     // ---------------------------------- methods
 150
 151     ResPool pool (void) const;
 152     void setPool (const ResPool & pool) { _pool = pool; }
 153
 154     void addExtraRequire (const Capability & capability);
 155     void removeExtraRequire (const Capability & capability);
 156     void addExtraConflict (const Capability & capability);
 157     void removeExtraConflict (const Capability & capability);
 158
 159     void removeQueueItem (const SolverQueueItem_Ptr item);
 160     void addQueueItem (const SolverQueueItem_Ptr item);
 161
 162     const CapabilitySet extraRequires () { return _extra_requires; }
 163     const CapabilitySet extraConflicts () { return _extra_conflicts; }
 164
 165     void addWeak (const PoolItem item);
 166
 167     void setForceResolve (const bool force) { _forceResolve = force; }
 168     bool forceResolve() { return _forceResolve; }
 169
 170     void setIgnorealreadyrecommended (const bool ignorealreadyrecommended)
 171         { _ignorealreadyrecommended = ignorealreadyrecommended; }
 172     bool ignorealreadyrecommended() { return _ignorealreadyrecommended; }
 173
 174     void setOnlyRequires (const TriBool state)
 175         { _onlyRequires = state; }
 176     TriBool onlyRequires () { return _onlyRequires; }
 177
 178     bool verifySystem ();
 179     bool resolvePool();
 180     bool resolveQueue(solver::detail::SolverQueueItemList & queue);
 181     void doUpdate();
 182
 183     bool doUpgrade( zypp::UpgradeStatistics & opt_stats_r );
 184     PoolItemList problematicUpdateItems( void ) const;
 185
 186     bool isUpgradeMode(){ return _upgradeMode;};    // Resolver has been called with doUpgrade
 187     bool isUpdateMode(){ return _updateMode;};      // Resolver has been called with doUpdate
 188     bool isVerifyingMode(){ return _verifying;};    // The system will be checked
 189
 190     ResolverProblemList problems () const;
 191     void applySolutions (const ProblemSolutionList &solutions);
 192
 193     // reset all SOLVER transaction in pool
 194     void undo(void);
 195
 196     void reset (bool keepExtras = false );
 197
 198     bool testing(void) const { return _testing; }
 199     void setTesting( bool testing ) { _testing = testing; }
 200
 201     // Get more information about the solverrun
 202     // Which item will be installed by another item or triggers an item for
 203     // installation
 204     const ItemCapKindList isInstalledBy (const PoolItem item);
 205     const ItemCapKindList installs (const PoolItem item);
 206     const ItemCapKindList satifiedByInstalled (const PoolItem item);
 207     const ItemCapKindList installedSatisfied (const PoolItem item);
 208
 209 };
 210
 211 ///////////////////////////////////////////////////////////////////
 212     };// namespace detail
 213     /////////////////////////////////////////////////////////////////////
 214     /////////////////////////////////////////////////////////////////////
 215   };// namespace solver
 216   ///////////////////////////////////////////////////////////////////////
 217   ///////////////////////////////////////////////////////////////////////
 218 };// namespace zypp
 219 /////////////////////////////////////////////////////////////////////////
 220
 221 #endif // ZYPP_SOLVER_DETAIL_RESOLVER_H