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
|
#ifndef H_RPMDS
#define H_RPMDS
/** \ingroup rpmdep rpmtrans
* \file lib/rpmds.h
* Structure used for handling a dependency set.
*/
/**
*/
typedef /*@abstract@*/ struct problemsSet_s * problemsSet;
/**
* Problems encountered while checking dependencies.
*/
struct problemsSet_s {
rpmDependencyConflict problems; /*!< Problems encountered. */
int num; /*!< No. of problems found. */
int alloced; /*!< No. of problems allocated. */
} ;
/**
* A package dependency set.
*/
struct rpmDepSet_s {
int i; /*!< Element index. */
/*@observer@*/
const char * Type; /*!< Tag name. */
/*@only@*/ /*@null@*/
const char * DNEVR; /*!< Formatted dependency string. */
rpmTag tagN; /*!< Header tag. */
/*@refcounted@*/ /*@null@*/
Header h; /*!< Header for dependency set (or NULL) */
/*@only@*/
const char ** N; /*!< Name. */
/*@only@*/
const char ** EVR; /*!< Epoch-Version-Release. */
/*@only@*/
const int_32 * Flags; /*!< Flags identifying context/comparison. */
rpmTagType Nt, EVRt, Ft; /*!< Tag data types. */
int Count; /*!< No. of elements */
};
#ifdef __cplusplus
extern "C" {
#endif
/**
* Destroy a new dependency set.
* @param ds dependency set
* @return NULL always
*/
/*@only@*/ /*@null@*/
rpmDepSet dsFree(/*@only@*/ /*@null@*/ rpmDepSet ds)
/*@modifies ds@*/;
/**
* Create and load a dependency set.
* @param h header
* @param tagN type of dependency
* @param scareMem Use pointers to refcounted header memory?
* @return new dependency set
*/
/*@only@*/ /*@null@*/
rpmDepSet dsNew(Header h, rpmTag tagN, int scareMem)
/*@modifies h @*/;
/**
* Return new formatted dependency string.
* @param dspfx formatted dependency string prefix
* @param ds dependency set
* @return new formatted dependency (malloc'ed)
*/
/*@only@*/
char * dsDNEVR(const char * dspfx, const rpmDepSet ds)
/*@*/;
/**
* Return current formatted dependency string.
* @param ds dependency set
* @return current dependency DNEVR, NULL on invalid
*/
/*@null@*/
const char * dsiGetDNEVR(/*@null@*/ rpmDepSet ds)
/*@*/;
/**
* Return current dependency name.
* @param ds dependency set
* @return current dependency name, NULL on invalid
*/
/*@null@*/
const char * dsiGetN(/*@null@*/ rpmDepSet ds)
/*@*/;
/**
* Return current dependency epoch-version-release.
* @param ds dependency set
* @return current dependency EVR, NULL on invalid
*/
/*@null@*/
const char * dsiGetEVR(/*@null@*/ rpmDepSet ds)
/*@*/;
/**
* Return current dependency Flags.
* @param ds dependency set
* @return current dependency EVR, 0 on invalid
*/
int_32 dsiGetFlags(/*@null@*/ rpmDepSet ds)
/*@*/;
/**
* Notify of results of dependency match;
* @param ds dependency set
* @param where where dependency was resolved (or NULL)
* @param rc 0 == YES, otherwise NO
*/
/*@-globuse@*/ /* FIX: rpmMessage annotation is a lie */
void dsiNotify(/*@null@*/ rpmDepSet ds, /*@null@*/ const char * where, int rc)
/*@globals fileSystem @*/
/*@modifies fileSystem @*/;
/*@=globuse@*/
/**
* Return next dependency set iterator index.
* @param ds dependency set
* @return dependency set iterator index, -1 on termination
*/
int dsiNext(/*@null@*/ rpmDepSet ds)
/*@modifies ds @*/;
/**
* Initialize dependency set iterator.
* @param ds dependency set
* @return dependency set
*/
/*@null@*/
rpmDepSet dsiInit(/*@returned@*/ /*@null@*/ rpmDepSet ds)
/*@modifies ds @*/;
/**
* Compare two versioned dependency ranges, looking for overlap.
* @param A 1st dependency
* @param B 2nd dependency
* @return 1 if dependencies overlap, 0 otherwise
*/
int dsCompare(const rpmDepSet A, const rpmDepSet B)
/*@*/;
/**
* Report a Requires: or Conflicts: dependency problem.
*/
void dsProblem(problemsSet psp, Header h, const rpmDepSet ds,
/*@only@*/ /*@null@*/ const alKey * suggestedPkgs)
/*@modifies psp, h @*/;
/**
* Compare package provides dependencies from header with a single dependency.
* @param h header
* @param ds dependency set
*/
int rangeMatchesDepFlags (Header h, const rpmDepSet req)
/*@modifies h @*/;
/**
* Compare package name-version-release from header with a single dependency.
* @deprecated Remove from API when obsoletes is correctly implemented.
* @param h header
* @param req dependency
* @return 1 if dependency overlaps, 0 otherwise
*/
int headerMatchesDepFlags(Header h, const rpmDepSet req)
/*@*/;
#ifdef __cplusplus
}
#endif
#endif /* H_RPMDS */
|
