apt-pkg/policy.h

   1 // -*- mode: cpp; mode: fold -*-
   2 // Description                                                          /*{{{*/
   3 // $Id: policy.h,v 1.4 2001/05/07 04:24:08 jgg Exp $
   4 /* ######################################################################
   5
   6    Package Version Policy implementation
   7
   8    This implements the more advanced 'Version 4' APT policy engine. The
   9    standard 'Version 0' engine is included inside the DepCache which is
  10    it's historical location.
  11
  12    The V4 engine allows the user to completly control all aspects of
  13    version selection. There are three primary means to choose a version
  14     * Selection by version match
  15     * Selection by Release file match
  16     * Selection by origin server
  17
  18    Each package may be 'pinned' with a single criteria, which will ultimately
  19    result in the selection of a single version, or no version, for each
  20    package.
  21
  22    Furthermore, the default selection can be influenced by specifying
  23    the ordering of package files. The order is derived by reading the
  24    package file preferences and assigning a priority to each package
  25    file.
  26
  27    A special flag may be set to indicate if no version should be returned
  28    if no matching versions are found, otherwise the default matching
  29    rules are used to locate a hit.
  30
  31    ##################################################################### */
  32                                                                         /*}}}*/
  33 #ifndef PKGLIB_POLICY_H
  34 #define PKGLIB_POLICY_H
  35
  36 #include <apt-pkg/depcache.h>
  37 #include <apt-pkg/pkgcache.h>
  38 #include <apt-pkg/cacheiterators.h>
  39 #include <apt-pkg/versionmatch.h>
  40
  41 #include <vector>
  42 #include <string>
  43
  44 #ifndef APT_8_CLEANER_HEADERS
  45 using std::vector;
  46 #endif
  47
  48 class pkgPolicy : public pkgDepCache::Policy
  49 {
  50    protected:
  51
  52    struct Pin
  53    {
  54       pkgVersionMatch::MatchType Type;
  55       std::string Data;
  56       signed short Priority;
  57       Pin() : Type(pkgVersionMatch::None), Priority(0) {};
  58    };
  59
  60    struct PkgPin : Pin
  61    {
  62       std::string Pkg;
  63       PkgPin(std::string const &Pkg) : Pin(), Pkg(Pkg) {};
  64    };
  65
  66    Pin *Pins;
  67    signed short *PFPriority;
  68    std::vector<Pin> Defaults;
  69    std::vector<PkgPin> Unmatched;
  70    pkgCache *Cache;
  71    bool StatusOverride;
  72
  73    public:
  74
  75    // Things for manipulating pins
  76    void CreatePin(pkgVersionMatch::MatchType Type,std::string Pkg,
  77                   std::string Data,signed short Priority);
  78    pkgCache::VerIterator GetMatch(pkgCache::PkgIterator const &Pkg);
  79
  80    // Things for the cache interface.
  81    virtual pkgCache::VerIterator GetCandidateVer(pkgCache::PkgIterator const &Pkg);
  82    virtual signed short GetPriority(pkgCache::PkgIterator const &Pkg);
  83    virtual signed short GetPriority(pkgCache::PkgFileIterator const &File);
  84
  85    bool InitDefaults();
  86
  87    pkgPolicy(pkgCache *Owner);
  88    virtual ~pkgPolicy() {delete [] PFPriority; delete [] Pins;};
  89 };
  90
  91 bool ReadPinFile(pkgPolicy &Plcy, std::string File = "");
  92 bool ReadPinDir(pkgPolicy &Plcy, std::string Dir = "");
  93
  94 #endif