apt-pkg/packagemanager.h

   1 // -*- mode: cpp; mode: fold -*-
   2 // Description                                                          /*{{{*/
   3 // $Id: packagemanager.h,v 1.14 2001/05/07 04:24:08 jgg Exp $
   4 /* ######################################################################
   5
   6    Package Manager - Abstacts the package manager
   7
   8    Three steps are
   9      - Aquiration of archives (stores the list of final file names)
  10      - Sorting of operations
  11      - Invokation of package manager
  12
  13    This is the final stage when the package cache entities get converted
  14    into file names and the state stored in a DepCache is transformed
  15    into a series of operations.
  16
  17    In the final scheme of things this may serve as a director class to
  18    access the actual install methods based on the file type being
  19    installed.
  20
  21    ##################################################################### */
  22                                                                         /*}}}*/
  23 #ifndef PKGLIB_PACKAGEMANAGER_H
  24 #define PKGLIB_PACKAGEMANAGER_H
  25
  26 #include <apt-pkg/pkgcache.h>
  27 #include <apt-pkg/init.h>
  28 #include <apt-pkg/macros.h>
  29
  30 #include <string>
  31 #include <set>
  32
  33 #ifndef APT_10_CLEANER_HEADERS
  34 #include <apt-pkg/install-progress.h>
  35 #include <iostream>
  36 #endif
  37 #ifndef APT_8_CLEANER_HEADERS
  38 #include <apt-pkg/depcache.h>
  39 using std::string;
  40 #endif
  41
  42 class pkgAcquire;
  43 class pkgDepCache;
  44 class pkgSourceList;
  45 class pkgOrderList;
  46 class pkgRecords;
  47 namespace APT {
  48    namespace Progress {
  49       class PackageManager;
  50    };
  51 };
  52
  53
  54 class pkgPackageManager : protected pkgCache::Namespace
  55 {
  56    public:
  57
  58    enum OrderResult {Completed,Failed,Incomplete};
  59    static bool SigINTStop;
  60
  61    protected:
  62    std::string *FileNames;
  63    pkgDepCache &Cache;
  64    pkgOrderList *List;
  65    bool Debug;
  66    bool NoImmConfigure;
  67    bool ImmConfigureAll;
  68
  69    /** \brief saves packages dpkg let disappear
  70
  71        This way APT can retreat from trying to configure these
  72        packages later on and a frontend can choose to display a
  73        notice to inform the user about these disappears.
  74    */
  75    std::set<std::string> disappearedPkgs;
  76
  77    void ImmediateAdd(PkgIterator P, bool UseInstallVer, unsigned const int &Depth = 0);
  78    virtual OrderResult OrderInstall();
  79    bool CheckRConflicts(PkgIterator Pkg,DepIterator Dep,const char *Ver);
  80    bool CreateOrderList();
  81
  82    // Analysis helpers
  83    bool DepAlwaysTrue(DepIterator D) APT_PURE;
  84
  85    // Install helpers
  86    bool ConfigureAll();
  87    bool SmartConfigure(PkgIterator Pkg, int const Depth) APT_MUSTCHECK;
  88    //FIXME: merge on abi break
  89    bool SmartUnPack(PkgIterator Pkg) APT_MUSTCHECK;
  90    bool SmartUnPack(PkgIterator Pkg, bool const Immediate, int const Depth) APT_MUSTCHECK;
  91    bool SmartRemove(PkgIterator Pkg) APT_MUSTCHECK;
  92    bool EarlyRemove(PkgIterator Pkg, DepIterator const * const Dep) APT_MUSTCHECK;
  93    APT_DEPRECATED bool EarlyRemove(PkgIterator Pkg) APT_MUSTCHECK;
  94
  95    // The Actual installation implementation
  96    virtual bool Install(PkgIterator /*Pkg*/,std::string /*File*/) {return false;};
  97    virtual bool Configure(PkgIterator /*Pkg*/) {return false;};
  98    virtual bool Remove(PkgIterator /*Pkg*/,bool /*Purge*/=false) {return false;};
  99 #if (APT_PKG_MAJOR >= 4 && APT_PKG_MINOR >= 13)
 100    virtual bool Go(APT::Progress::PackageManager * /*progress*/) {return true;};
 101    virtual bool Go(int /*statusFd*/=-1) {return true;};
 102 #else
 103    virtual bool Go(int /*statusFd*/=-1) {return true;};
 104 #endif
 105
 106    virtual void Reset() {};
 107
 108    // the result of the operation
 109    OrderResult Res;
 110
 111    public:
 112
 113    // Main action members
 114    bool GetArchives(pkgAcquire *Owner,pkgSourceList *Sources,
 115                     pkgRecords *Recs);
 116
 117    // Do the installation
 118 #if (APT_PKG_MAJOR >= 4 && APT_PKG_MINOR >= 13)
 119    OrderResult DoInstall(APT::Progress::PackageManager *progress);
 120    // compat
 121    APT_DEPRECATED OrderResult DoInstall(int statusFd=-1);
 122 #else
 123    OrderResult DoInstall(int statusFd=-1);
 124 #endif
 125
 126    // stuff that needs to be done before the fork() of a library that
 127    // uses apt
 128    OrderResult DoInstallPreFork() {
 129       Res = OrderInstall();
 130       return Res;
 131    };
 132 #if (APT_PKG_MAJOR >= 4 && APT_PKG_MINOR >= 13)
 133    // stuff that needs to be done after the fork
 134    OrderResult DoInstallPostFork(APT::Progress::PackageManager *progress);
 135    // compat
 136    APT_DEPRECATED OrderResult DoInstallPostFork(int statusFd=-1);
 137 #else
 138    OrderResult DoInstallPostFork(int statusFd=-1);
 139 #endif
 140
 141    // ?
 142    bool FixMissing();
 143
 144    /** \brief returns all packages dpkg let disappear */
 145    inline std::set<std::string> GetDisappearedPackages() { return disappearedPkgs; };
 146
 147    pkgPackageManager(pkgDepCache *Cache);
 148    virtual ~pkgPackageManager();
 149
 150    private:
 151    enum APT_HIDDEN SmartAction { UNPACK_IMMEDIATE, UNPACK, CONFIGURE };
 152    APT_HIDDEN bool NonLoopingSmart(SmartAction const action, pkgCache::PkgIterator &Pkg,
 153       pkgCache::PkgIterator DepPkg, int const Depth, bool const PkgLoop,
 154       bool * const Bad, bool * const Changed) APT_MUSTCHECK;
 155 };
 156
 157 #endif