Add macro %isu_package to generate ISU Package
[platform/upstream/rpm.git] / lib / rpmds.h
index 6829be7..bceed00 100644 (file)
@@ -6,8 +6,10 @@
  * Structure(s) used for dependency tag sets.
  */
 
-#include <rpmlib.h>    /* for rpmds */
-#include <rpmps.h>
+#include <time.h>
+
+#include <rpm/rpmtypes.h>
+#include <rpm/rpmps.h>
 
 #ifdef __cplusplus
 extern "C" {
@@ -15,38 +17,81 @@ extern "C" {
 
 /**
  */
-extern int _rpmds_debug;
-
-/**
- */
 extern int _rpmds_nopromote;
 
 /** \ingroup rpmds
- * Unreference a dependency set instance.
- * @param ds           dependency set
- * @param msg
- * @return             NULL always
- */
-rpmds rpmdsUnlink (rpmds ds,
-               const char * msg);
-
-/** @todo Remove debugging entry from the ABI. */
-rpmds XrpmdsUnlink (rpmds ds,
-               const char * msg, const char * fn, unsigned ln);
-#define        rpmdsUnlink(_ds, _msg)  XrpmdsUnlink(_ds, _msg, __FILE__, __LINE__)
+ * Dependency Attributes.
+ */
+enum rpmsenseFlags_e {
+    RPMSENSE_ANY       = 0,
+    RPMSENSE_LESS      = (1 << 1),
+    RPMSENSE_GREATER   = (1 << 2),
+    RPMSENSE_EQUAL     = (1 << 3),
+    /* bit 4 unused */
+    RPMSENSE_POSTTRANS = (1 << 5),     /*!< %posttrans dependency */
+    RPMSENSE_PREREQ    = (1 << 6),     /* legacy prereq dependency */
+    RPMSENSE_PRETRANS  = (1 << 7),     /*!< Pre-transaction dependency. */
+    RPMSENSE_INTERP    = (1 << 8),     /*!< Interpreter used by scriptlet. */
+    RPMSENSE_SCRIPT_PRE        = (1 << 9),     /*!< %pre dependency. */
+    RPMSENSE_SCRIPT_POST = (1 << 10),  /*!< %post dependency. */
+    RPMSENSE_SCRIPT_PREUN = (1 << 11), /*!< %preun dependency. */
+    RPMSENSE_SCRIPT_POSTUN = (1 << 12), /*!< %postun dependency. */
+    RPMSENSE_SCRIPT_VERIFY = (1 << 13),        /*!< %verify dependency. */
+    RPMSENSE_FIND_REQUIRES = (1 << 14), /*!< find-requires generated dependency. */
+    RPMSENSE_FIND_PROVIDES = (1 << 15), /*!< find-provides generated dependency. */
+
+    RPMSENSE_TRIGGERIN = (1 << 16),    /*!< %triggerin dependency. */
+    RPMSENSE_TRIGGERUN = (1 << 17),    /*!< %triggerun dependency. */
+    RPMSENSE_TRIGGERPOSTUN = (1 << 18),        /*!< %triggerpostun dependency. */
+    RPMSENSE_MISSINGOK = (1 << 19),    /*!< suggests/enhances hint. */
+    /* bits 20-23 unused */
+    RPMSENSE_RPMLIB = (1 << 24),       /*!< rpmlib(feature) dependency. */
+    RPMSENSE_TRIGGERPREIN = (1 << 25), /*!< %triggerprein dependency. */
+    RPMSENSE_KEYRING   = (1 << 26),
+    RPMSENSE_STRONG     = (1 << 27),
+    RPMSENSE_CONFIG    = (1 << 28)
+};
+
+typedef rpmFlags rpmsenseFlags;
+
+#define        RPMSENSE_SENSEMASK      15       /* Mask to get senses, ie serial, */
+                                         /* less, greater, equal.          */
+
+#define        RPMSENSE_TRIGGER        \
+       (RPMSENSE_TRIGGERPREIN | RPMSENSE_TRIGGERIN | RPMSENSE_TRIGGERUN | RPMSENSE_TRIGGERPOSTUN)
+
+#define        _ALL_REQUIRES_MASK      (\
+    RPMSENSE_INTERP | \
+    RPMSENSE_SCRIPT_PRE | \
+    RPMSENSE_SCRIPT_POST | \
+    RPMSENSE_SCRIPT_PREUN | \
+    RPMSENSE_SCRIPT_POSTUN | \
+    RPMSENSE_SCRIPT_VERIFY | \
+    RPMSENSE_FIND_REQUIRES | \
+    RPMSENSE_RPMLIB | \
+    RPMSENSE_KEYRING | \
+    RPMSENSE_PRETRANS | \
+    RPMSENSE_POSTTRANS | \
+    RPMSENSE_PREREQ | \
+    RPMSENSE_MISSINGOK | \
+    RPMSENSE_STRONG)
+
+#define        _notpre(_x)             ((_x) & ~RPMSENSE_PREREQ)
+#define        _INSTALL_ONLY_MASK \
+    _notpre(RPMSENSE_SCRIPT_PRE|RPMSENSE_SCRIPT_POST|RPMSENSE_RPMLIB|RPMSENSE_KEYRING|RPMSENSE_PRETRANS|RPMSENSE_POSTTRANS)
+#define        _ERASE_ONLY_MASK  \
+    _notpre(RPMSENSE_SCRIPT_PREUN|RPMSENSE_SCRIPT_POSTUN)
+
+#define        isLegacyPreReq(_x)  (((_x) & _ALL_REQUIRES_MASK) == RPMSENSE_PREREQ)
+#define        isInstallPreReq(_x)     ((_x) & _INSTALL_ONLY_MASK)
+#define        isErasePreReq(_x)       ((_x) & _ERASE_ONLY_MASK)
 
 /** \ingroup rpmds
  * Reference a dependency set instance.
  * @param ds           dependency set
- * @param msg
  * @return             new dependency set reference
  */
-rpmds rpmdsLink (rpmds ds, const char * msg);
-
-/** @todo Remove debugging entry from the ABI. */
-rpmds XrpmdsLink (rpmds ds, const char * msg,
-               const char * fn, unsigned ln);
-#define        rpmdsLink(_ds, _msg)    XrpmdsLink(_ds, _msg, __FILE__, __LINE__)
+rpmds rpmdsLink(rpmds ds);
 
 /** \ingroup rpmds
  * Destroy a dependency set.
@@ -54,15 +99,15 @@ rpmds XrpmdsLink (rpmds ds, const char * msg,
  * @return             NULL always
  */
 rpmds rpmdsFree(rpmds ds);
+
 /** \ingroup rpmds
  * Create and load a dependency set.
- * @deprecated Only scareMem = 0 will be permitted.
  * @param h            header
  * @param tagN         type of dependency
- * @param flags                scareMem(0x1)
+ * @param flags                unused
  * @return             new dependency set
  */
-rpmds rpmdsNew(Header h, rpmTag tagN, int flags);
+rpmds rpmdsNew(Header h, rpmTagVal tagN, int flags);
 
 /** \ingroup rpmds
  * Return new formatted dependency string.
@@ -79,7 +124,7 @@ char * rpmdsNewDNEVR(const char * dspfx, const rpmds ds);
  * @param Flags                comparison flags
  * @return             new dependency set
  */
-rpmds rpmdsThis(Header h, rpmTag tagN, int32_t Flags);
+rpmds rpmdsThis(Header h, rpmTagVal tagN, rpmsenseFlags Flags);
 
 /** \ingroup rpmds
  * Create, load and initialize a dependency set of size 1.
@@ -89,7 +134,14 @@ rpmds rpmdsThis(Header h, rpmTag tagN, int32_t Flags);
  * @param Flags                comparison flags
  * @return             new dependency set
  */
-rpmds rpmdsSingle(rpmTag tagN, const char * N, const char * EVR, int32_t Flags);
+rpmds rpmdsSingle(rpmTagVal tagN, const char * N, const char * EVR, rpmsenseFlags Flags);
+
+/** \ingroup rpmds
+ * Return a new dependency set of size 1 from the current iteration index
+ * @param ds           dependency set
+ * @return             new dependency set
+ */
+rpmds rpmdsCurrent(rpmds ds);
 
 /** \ingroup rpmds
  * Return dependency set count.
@@ -118,50 +170,43 @@ int rpmdsSetIx(rpmds ds, int ix);
  * @param ds           dependency set
  * @return             current dependency DNEVR, NULL on invalid
  */
-extern const char * rpmdsDNEVR(const rpmds ds);
+const char * rpmdsDNEVR(const rpmds ds);
 
 /** \ingroup rpmds
  * Return current dependency name.
  * @param ds           dependency set
  * @return             current dependency name, NULL on invalid
  */
-extern const char * rpmdsN(const rpmds ds);
+const char * rpmdsN(const rpmds ds);
 
 /** \ingroup rpmds
  * Return current dependency epoch-version-release.
  * @param ds           dependency set
  * @return             current dependency EVR, NULL on invalid
  */
-extern const char * rpmdsEVR(const rpmds ds);
+const char * rpmdsEVR(const rpmds ds);
 
 /** \ingroup rpmds
  * Return current dependency flags.
  * @param ds           dependency set
  * @return             current dependency flags, 0 on invalid
  */
-int32_t rpmdsFlags(const rpmds ds);
+rpmsenseFlags rpmdsFlags(const rpmds ds);
 
 /** \ingroup rpmds
  * Return current dependency type.
  * @param ds           dependency set
  * @return             current dependency type, 0 on invalid
  */
-rpmTag rpmdsTagN(const rpmds ds);
-
-/** \ingroup rpmds
- * Return dependency build time.
- * @param ds           dependency set
- * @return             dependency build time, 0 on invalid
- */
-time_t rpmdsBT(const rpmds ds);
+rpmTagVal rpmdsTagN(const rpmds ds);
 
 /** \ingroup rpmds
- * Set dependency build time.
+ * Return dependency header instance, ie whether the dependency comes from 
+ * an installed header or not.
  * @param ds           dependency set
- * @param BT           build time
- * @return             dependency build time, 0 on invalid
+ * @return             header instance of dependency (0 for not installed)
  */
-time_t rpmdsSetBT(const rpmds ds, time_t BT);
+unsigned int rpmdsInstance(rpmds ds);
 
 /** \ingroup rpmds
  * Return current "Don't promote Epoch:" flag.
@@ -191,7 +236,7 @@ int rpmdsSetNoPromote(rpmds ds, int nopromote);
  * @param ds           dependency set
  * @return             current dependency color
  */
-uint32_t rpmdsColor(const rpmds ds);
+rpm_color_t rpmdsColor(const rpmds ds);
 
 /** \ingroup rpmds
  * Return current dependency color.
@@ -199,22 +244,7 @@ uint32_t rpmdsColor(const rpmds ds);
  * @param color                new dependency color
  * @return             previous dependency color
  */
-uint32_t rpmdsSetColor(const rpmds ds, uint32_t color);
-
-/** \ingroup rpmds
- * Return current dependency file refs.
- * @param ds           dependency set
- * @return             current dependency file refs, -1 on global
- */
-int32_t rpmdsRefs(const rpmds ds);
-
-/** \ingroup rpmds
- * Return current dependency color.
- * @param ds           dependency set
- * @param refs         new dependency refs
- * @return             previous dependency refs
- */
-int32_t rpmdsSetRefs(const rpmds ds, int32_t refs);
+rpm_color_t rpmdsSetColor(const rpmds ds, rpm_color_t color);
 
 /** \ingroup rpmds
  * Notify of results of dependency match.
@@ -256,6 +286,16 @@ int rpmdsFind(rpmds ds, const rpmds ods);
 int rpmdsMerge(rpmds * dsp, rpmds ods);
 
 /** \ingroup rpmds
+ * Search a sorted dependency set for an element that overlaps.
+ * A boolean result is saved (if allocated) and accessible through
+ * rpmdsResult(ods) afterwards.
+ * @param ds            dependency set to search
+ * @param ods           dependency set element to find.
+ * @return              dependency index (or -1 if not found)
+ **/
+int rpmdsSearch(rpmds ds, rpmds ods);
+
+/** \ingroup rpmds
  * Compare two versioned dependency ranges, looking for overlap.
  * @param A            1st dependency
  * @param B            2nd dependency
@@ -264,25 +304,23 @@ int rpmdsMerge(rpmds * dsp, rpmds ods);
 int rpmdsCompare(const rpmds A, const rpmds B);
 
 /** \ingroup rpmds
- * Report a Requires: or Conflicts: dependency problem.
- * @param ps           transaction set problems
- * @param pkgNEVR      package name/epoch/version/release
- * @param ds           dependency set
- * @param suggestedKeys        filename or python object address
- * @param adding       dependency problem is from added package set?
+ * Compare package provides dependencies from header with a single dependency.
+ * @param h            header
+ * @param req          dependency set
+ * @param nopromote    Don't promote Epoch: in comparison?
+ * @return             1 if any dependency overlaps, 0 otherwise
  */
-void rpmdsProblem(rpmps ps, const char * pkgNEVR, const rpmds ds,
-               const fnpyKey * suggestedKeys,
-               int adding);
+int rpmdsAnyMatchesDep (const Header h, const rpmds req, int nopromote);
 
 /** \ingroup rpmds
  * Compare package provides dependencies from header with a single dependency.
  * @param h            header
+ * @param ix            index in header provides
  * @param req          dependency set
  * @param nopromote    Don't promote Epoch: in comparison?
  * @return             1 if any dependency overlaps, 0 otherwise
  */
-int rpmdsAnyMatchesDep (const Header h, const rpmds req, int nopromote);
+int rpmdsMatchesDep (const Header h, int ix, const rpmds req, int nopromote);
 
 /** \ingroup rpmds
  * Compare package name-version-release from header with a single dependency.
@@ -293,6 +331,14 @@ int rpmdsAnyMatchesDep (const Header h, const rpmds req, int nopromote);
  */
 int rpmdsNVRMatchesDep(const Header h, const rpmds req, int nopromote);
 
+/**
+ * Load rpmlib provides into a dependency set.
+ * @retval *dsp                (loaded) depedency set
+ * @param tblp         rpmlib provides table (NULL uses internal table)
+ * @return             0 on success
+ */
+int rpmdsRpmlib(rpmds * dsp, const void * tblp);
+
 #ifdef __cplusplus
 }
 #endif