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/macros.h>
  27 #include <apt-pkg/pkgcache.h>
  28 #include <apt-pkg/install-progress.h>
  29 #include <apt-pkg/init.h>
  30
  31 #include <string>
  32 #include <iostream>
  33 #include <set>
  34
  35 #ifndef APT_8_CLEANER_HEADERS
  36 #include <apt-pkg/depcache.h>
  37 using std::string;
  38 #endif
  39
  40 class pkgAcquire;
  41 class pkgDepCache;
  42 class pkgSourceList;
  43 class pkgOrderList;
  44 class pkgRecords;
  45
  46
  47 class pkgPackageManager : protected pkgCache::Namespace
  48 {
  49    public:
  50
  51    enum OrderResult {Completed,Failed,Incomplete};
  52    static bool SigINTStop;
  53
  54    protected:
  55    std::string *FileNames;
  56    pkgDepCache &Cache;
  57    pkgOrderList *List;
  58    bool Debug;
  59    bool NoImmConfigure;
  60    bool ImmConfigureAll;
  61
  62    /** \brief saves packages dpkg let disappear
  63
  64        This way APT can retreat from trying to configure these
  65        packages later on and a frontend can choose to display a
  66        notice to inform the user about these disappears.
  67    */
  68    std::set<std::string> disappearedPkgs;
  69
  70    void ImmediateAdd(PkgIterator P, bool UseInstallVer, unsigned const int &Depth = 0);
  71    virtual OrderResult OrderInstall();
  72    bool CheckRConflicts(PkgIterator Pkg,DepIterator Dep,const char *Ver);
  73    bool CreateOrderList();
  74
  75    // Analysis helpers
  76    bool DepAlwaysTrue(DepIterator D);
  77
  78    // Install helpers
  79    bool ConfigureAll();
  80    bool SmartConfigure(PkgIterator Pkg, int const Depth);
  81    //FIXME: merge on abi break
  82    bool SmartUnPack(PkgIterator Pkg);
  83    bool SmartUnPack(PkgIterator Pkg, bool const Immediate, int const Depth);
  84    bool SmartRemove(PkgIterator Pkg);
  85    bool EarlyRemove(PkgIterator Pkg);
  86
  87    // The Actual installation implementation
  88    virtual bool Install(PkgIterator /*Pkg*/,std::string /*File*/) {return false;};
  89    virtual bool Configure(PkgIterator /*Pkg*/) {return false;};
  90    virtual bool Remove(PkgIterator /*Pkg*/,bool /*Purge*/=false) {return false;};
  91 #if (APT_PKG_MAJOR >= 4 && APT_PKG_MINOR >= 13)
  92    virtual bool Go(APT::Progress::PackageManager *progress) {return true;};
  93 #else
  94    virtual bool Go(int statusFd=-1) {return true;};
  95 #endif
  96
  97    virtual void Reset() {};
  98
  99    // the result of the operation
 100    OrderResult Res;
 101
 102    public:
 103
 104    // Main action members
 105    bool GetArchives(pkgAcquire *Owner,pkgSourceList *Sources,
 106                     pkgRecords *Recs);
 107
 108    // Do the installation
 109 #if (APT_PKG_MAJOR >= 4 && APT_PKG_MINOR >= 13)
 110    OrderResult DoInstall(APT::Progress::PackageManager *progress);
 111    // compat
 112    __deprecated OrderResult DoInstall(int statusFd=-1);
 113 #else
 114    OrderResult DoInstall(int statusFd=-1);
 115 #endif
 116
 117    // stuff that needs to be done before the fork() of a library that
 118    // uses apt
 119    OrderResult DoInstallPreFork() {
 120       Res = OrderInstall();
 121       return Res;
 122    };
 123 #if (APT_PKG_MAJOR >= 4 && APT_PKG_MINOR >= 13)
 124    // stuff that needs to be done after the fork
 125    OrderResult DoInstallPostFork(APT::Progress::PackageManager *progress);
 126    // compat
 127    __deprecated OrderResult DoInstallPostFork(int statusFd=-1);
 128 #else
 129    OrderResult DoInstallPostFork(int statusFd=-1);
 130 #endif
 131
 132    // ?
 133    bool FixMissing();
 134
 135    /** \brief returns all packages dpkg let disappear */
 136    inline std::set<std::string> GetDisappearedPackages() { return disappearedPkgs; };
 137
 138    pkgPackageManager(pkgDepCache *Cache);
 139    virtual ~pkgPackageManager();
 140 };
 141
 142 #endif