apt-pkg/deb/dpkgpm.h

   1 // -*- mode: cpp; mode: fold -*-
   2 // Description                                                          /*{{{*/
   3 // $Id: dpkgpm.h,v 1.8 2001/05/07 05:05:13 jgg Exp $
   4 /* ######################################################################
   5
   6    DPKG Package Manager - Provide an interface to dpkg
   7
   8    ##################################################################### */
   9                                                                         /*}}}*/
  10 #ifndef PKGLIB_DPKGPM_H
  11 #define PKGLIB_DPKGPM_H
  12
  13 #include <apt-pkg/packagemanager.h>
  14 #include <vector>
  15 #include <map>
  16 #include <stdio.h>
  17 #include <apt-pkg/macros.h>
  18 #include <apt-pkg/init.h>
  19
  20 #ifndef APT_8_CLEANER_HEADERS
  21 using std::vector;
  22 using std::map;
  23 #endif
  24
  25 class pkgDPkgPMPrivate;
  26
  27
  28 class pkgDPkgPM : public pkgPackageManager
  29 {
  30    private:
  31    pkgDPkgPMPrivate *d;
  32
  33    /** \brief record the disappear action and handle accordingly
  34
  35       dpkg let packages disappear then they have no files any longer and
  36       nothing depends on them. We need to collect this as dpkg as well as
  37       APT doesn't know beforehand that the package will disappear, so the
  38       only possible option is to tell the user afterwards about it.
  39       To enhance the experience we also try to forward the auto-install
  40       flag so the disappear-causer(s) are not autoremoved next time -
  41       for the transfer to happen the disappeared version needs to depend
  42       on the package the flag should be forwarded to and this package
  43       needs to declare a Replaces on the disappeared package.
  44       \param pkgname Name of the package that disappeared
  45    */
  46    void handleDisappearAction(std::string const &pkgname);
  47
  48    protected:
  49    int pkgFailures;
  50
  51    // progress reporting
  52    struct DpkgState
  53    {
  54       const char *state;     // the dpkg state (e.g. "unpack")
  55       const char *str;       // the human readable translation of the state
  56    };
  57
  58    // the dpkg states that the pkg will run through, the string is
  59    // the package, the vector contains the dpkg states that the package
  60    // will go through
  61    std::map<std::string,std::vector<struct DpkgState> > PackageOps;
  62    // the dpkg states that are already done; the string is the package
  63    // the int is the state that is already done (e.g. a package that is
  64    // going to be install is already in state "half-installed")
  65    std::map<std::string,unsigned int> PackageOpsDone;
  66
  67    // progress reporting
  68    unsigned int PackagesDone;
  69    unsigned int PackagesTotal;
  70
  71    struct Item
  72    {
  73       enum Ops {Install, Configure, Remove, Purge, ConfigurePending, TriggersPending} Op;
  74       std::string File;
  75       PkgIterator Pkg;
  76       Item(Ops Op,PkgIterator Pkg,std::string File = "") : Op(Op),
  77             File(File), Pkg(Pkg) {};
  78       Item() {};
  79
  80    };
  81    std::vector<Item> List;
  82
  83    // Helpers
  84    bool RunScriptsWithPkgs(const char *Cnf);
  85    __deprecated bool SendV2Pkgs(FILE *F);
  86    bool SendPkgsInfo(FILE * const F, unsigned int const &Version);
  87    void WriteHistoryTag(std::string const &tag, std::string value);
  88    std::string ExpandShortPackageName(pkgDepCache &Cache,
  89                                       const std::string &short_pkgname);
  90
  91    // Terminal progress
  92    void SetupTerminalScrollArea(int nr_scrolled_rows);
  93    void SendTerminalProgress(float percentage);
  94
  95    // apport integration
  96    void WriteApportReport(const char *pkgpath, const char *errormsg);
  97
  98    // dpkg log
  99    bool OpenLog();
 100    bool CloseLog();
 101
 102    // helper
 103    void BuildPackagesProgressMap();
 104    void StartPtyMagic();
 105    void StopPtyMagic();
 106
 107    // input processing
 108    void DoStdin(int master);
 109    void DoTerminalPty(int master);
 110    void DoDpkgStatusFd(int statusfd);
 111    void ProcessDpkgStatusLine(char *line);
 112 #if (APT_PKG_MAJOR >= 4 && APT_PKG_MINOR < 13)
 113    void DoDpkgStatusFd(int statusfd, int unused) {
 114       DoDpkgStatusFd(statusfd);
 115    }
 116    void ProcessDpkgStatusLine(int unused, char *line) {
 117       ProcessDpkgStatusLine(line);
 118    }
 119 #endif
 120
 121
 122    // The Actuall installation implementation
 123    virtual bool Install(PkgIterator Pkg,std::string File);
 124    virtual bool Configure(PkgIterator Pkg);
 125    virtual bool Remove(PkgIterator Pkg,bool Purge = false);
 126
 127 #if (APT_PKG_MAJOR >= 4 && APT_PKG_MINOR >= 13)
 128    virtual bool Go(APT::Progress::PackageManager *progress);
 129 #else
 130    virtual bool Go(int StatusFd=-1);
 131    bool GoNoABIBreak(APT::Progress::PackageManager *progress);
 132 #endif
 133
 134    virtual void Reset();
 135
 136    public:
 137
 138    pkgDPkgPM(pkgDepCache *Cache);
 139    virtual ~pkgDPkgPM();
 140 };
 141
 142 void SigINT(int sig);
 143
 144 #endif