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