1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
|
#ifndef H_RPMDS
#define H_RPMDS
/** \ingroup rpmdep rpmtrans
* \file lib/rpmds.h
* Structure(s) used for dependency tag sets.
*/
#include <rpm/rpmlib.h> /* for rpmds */
#include <rpm/rpmps.h>
#ifdef __cplusplus
extern "C" {
#endif
/**
*/
extern int _rpmds_debug;
/**
*/
extern int _rpmds_nopromote;
/** \ingroup rpmds
* Dependency Attributes.
*/
typedef enum rpmsenseFlags_e {
RPMSENSE_ANY = 0,
RPMSENSE_SERIAL = (1 << 0), /*!< @todo Legacy. */
RPMSENSE_LESS = (1 << 1),
RPMSENSE_GREATER = (1 << 2),
RPMSENSE_EQUAL = (1 << 3),
RPMSENSE_PROVIDES = (1 << 4), /* only used internally by builds */
RPMSENSE_CONFLICTS = (1 << 5), /* only used internally by builds */
/* bit 6 used to be RPMSENSE_PREREQ */
#define RPMSENSE_PREREQ RPMSENSE_ANY
RPMSENSE_OBSOLETES = (1 << 7), /* only used internally by builds */
RPMSENSE_INTERP = (1 << 8), /*!< Interpreter used by scriptlet. */
RPMSENSE_SCRIPT_PRE = ((1 << 9)|RPMSENSE_PREREQ), /*!< %pre dependency. */
RPMSENSE_SCRIPT_POST = ((1 << 10)|RPMSENSE_PREREQ), /*!< %post dependency. */
RPMSENSE_SCRIPT_PREUN = ((1 << 11)|RPMSENSE_PREREQ), /*!< %preun dependency. */
RPMSENSE_SCRIPT_POSTUN = ((1 << 12)|RPMSENSE_PREREQ), /*!< %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. */
RPMSENSE_SCRIPT_PREP = (1 << 20), /*!< %prep build dependency. */
RPMSENSE_SCRIPT_BUILD = (1 << 21), /*!< %build build dependency. */
RPMSENSE_SCRIPT_INSTALL = (1 << 22),/*!< %install build dependency. */
RPMSENSE_SCRIPT_CLEAN = (1 << 23), /*!< %clean build dependency. */
RPMSENSE_RPMLIB = ((1 << 24) | RPMSENSE_PREREQ), /*!< rpmlib(feature) dependency. */
RPMSENSE_TRIGGERPREIN = (1 << 25), /*!< @todo Implement %triggerprein. */
RPMSENSE_KEYRING = (1 << 26),
RPMSENSE_PATCHES = (1 << 27),
RPMSENSE_CONFIG = (1 << 28)
} rpmsenseFlags;
#define RPMSENSE_SENSEMASK 15 /* Mask to get senses, ie serial, */
/* less, greater, equal. */
#define RPMSENSE_TRIGGER \
(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_SCRIPT_PREP | \
RPMSENSE_SCRIPT_BUILD | \
RPMSENSE_SCRIPT_INSTALL | \
RPMSENSE_SCRIPT_CLEAN | \
RPMSENSE_RPMLIB | \
RPMSENSE_KEYRING )
#define _notpre(_x) ((_x) & ~RPMSENSE_PREREQ)
#define _INSTALL_ONLY_MASK \
_notpre(RPMSENSE_SCRIPT_PRE|RPMSENSE_SCRIPT_POST|RPMSENSE_RPMLIB|RPMSENSE_KEYRING)
#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
* Unreference a dependency set instance.
* @param ds dependency set
* @param msg
* @return NULL always
*/
rpmds rpmdsUnlink (rpmds ds, const char * msg);
/** \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);
/** \ingroup rpmds
* Destroy a dependency set.
* @param ds dependency set
* @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)
* @return new dependency set
*/
rpmds rpmdsNew(Header h, rpm_tag_t tagN, int flags);
/** \ingroup rpmds
* Return new formatted dependency string.
* @param dspfx formatted dependency string prefix
* @param ds dependency set
* @return new formatted dependency (malloc'ed)
*/
char * rpmdsNewDNEVR(const char * dspfx, const rpmds ds);
/** \ingroup rpmds
* Create, load and initialize a dependency for this header.
* @param h header
* @param tagN type of dependency
* @param Flags comparison flags
* @return new dependency set
*/
rpmds rpmdsThis(Header h, rpm_tag_t tagN, int32_t Flags);
/** \ingroup rpmds
* Create, load and initialize a dependency set of size 1.
* @param tagN type of dependency
* @param N name
* @param EVR epoch:version-release
* @param Flags comparison flags
* @return new dependency set
*/
rpmds rpmdsSingle(rpm_tag_t tagN, const char * N, const char * EVR, int32_t Flags);
/** \ingroup rpmds
* Return dependency set count.
* @param ds dependency set
* @return current count
*/
int rpmdsCount(const rpmds ds);
/** \ingroup rpmds
* Return dependency set index.
* @param ds dependency set
* @return current index
*/
int rpmdsIx(const rpmds ds);
/** \ingroup rpmds
* Set dependency set index.
* @param ds dependency set
* @param ix new index
* @return current index
*/
int rpmdsSetIx(rpmds ds, int ix);
/** \ingroup rpmds
* Return current formatted dependency string.
* @param ds dependency set
* @return current dependency DNEVR, NULL on invalid
*/
extern 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);
/** \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);
/** \ingroup rpmds
* Return current dependency flags.
* @param ds dependency set
* @return current dependency flags, 0 on invalid
*/
int32_t rpmdsFlags(const rpmds ds);
/** \ingroup rpmds
* Return current dependency type.
* @param ds dependency set
* @return current dependency type, 0 on invalid
*/
rpm_tag_t 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);
/** \ingroup rpmds
* Set dependency build time.
* @param ds dependency set
* @param BT build time
* @return dependency build time, 0 on invalid
*/
time_t rpmdsSetBT(const rpmds ds, time_t BT);
/** \ingroup rpmds
* Return current "Don't promote Epoch:" flag.
*
* This flag controls for Epoch: promotion when a dependency set is
* compared. If the flag is set (for already installed packages), then
* an unspecified value will be treated as Epoch: 0. Otherwise (for added
* packages), the Epoch: portion of the comparison is skipped if the value
* is not specified, i.e. an unspecified Epoch: is assumed to be equal
* in dependency comparisons.
*
* @param ds dependency set
* @return current "Don't promote Epoch:" flag
*/
int rpmdsNoPromote(const rpmds ds);
/** \ingroup rpmds
* Set "Don't promote Epoch:" flag.
* @param ds dependency set
* @param nopromote Should an unspecified Epoch: be treated as Epoch: 0?
* @return previous "Don't promote Epoch:" flag
*/
int rpmdsSetNoPromote(rpmds ds, int nopromote);
/** \ingroup rpmds
* Return current dependency color.
* @param ds dependency set
* @return current dependency color
*/
uint32_t rpmdsColor(const rpmds ds);
/** \ingroup rpmds
* Return current dependency color.
* @param ds dependency set
* @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);
/** \ingroup rpmds
* Notify of results of dependency match.
* @param ds dependency set
* @param where where dependency was resolved (or NULL)
* @param rc 0 == YES, otherwise NO
*/
/* FIX: rpmMessage annotation is a lie */
void rpmdsNotify(rpmds ds, const char * where, int rc);
/** \ingroup rpmds
* Return next dependency set iterator index.
* @param ds dependency set
* @return dependency set iterator index, -1 on termination
*/
int rpmdsNext(rpmds ds);
/** \ingroup rpmds
* Initialize dependency set iterator.
* @param ds dependency set
* @return dependency set
*/
rpmds rpmdsInit(rpmds ds);
/** \ingroup rpmds
* Find a dependency set element using binary search.
* @param ds dependency set to search
* @param ods dependency set element to find.
* @return dependency index (or -1 if not found)
*/
int rpmdsFind(rpmds ds, const rpmds ods);
/** \ingroup rpmds
* Merge a dependency set maintaining (N,EVR,Flags) sorted order.
* @retval *dsp (merged) dependency set
* @param ods dependency set to merge
* @return (merged) dependency index
*/
int rpmdsMerge(rpmds * dsp, rpmds ods);
/** \ingroup rpmds
* Compare two versioned dependency ranges, looking for overlap.
* @param A 1st dependency
* @param B 2nd dependency
* @return 1 if dependencies overlap, 0 otherwise
*/
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?
*/
void rpmdsProblem(rpmps ps, const char * pkgNEVR, const rpmds ds,
const fnpyKey * suggestedKeys,
int adding);
/** \ingroup rpmds
* 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
*/
int rpmdsAnyMatchesDep (const Header h, const rpmds req, int nopromote);
/** \ingroup rpmds
* Compare package name-version-release from header with a single dependency.
* @param h header
* @param req dependency set
* @param nopromote Don't promote Epoch: in comparison?
* @return 1 if dependency overlaps, 0 otherwise
*/
int rpmdsNVRMatchesDep(const Header h, const rpmds req, int nopromote);
#ifdef __cplusplus
}
#endif
#endif /* H_RPMDS */
|