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
|
#ifndef _DBI_H
#define _DBI_H
#include "dbiset.h"
/* XXX: make this backend-specific, eliminate or something... */
#define _USE_COPY_LOAD
enum rpmdbFlags {
RPMDB_FLAG_JUSTCHECK = (1 << 0),
RPMDB_FLAG_REBUILD = (1 << 1),
RPMDB_FLAG_VERIFYONLY = (1 << 2),
};
typedef struct dbiIndex_s * dbiIndex;
typedef struct dbiCursor_s * dbiCursor;
struct dbConfig_s {
int db_mmapsize; /*!< (10Mb) */
int db_cachesize; /*!< (128Kb) */
int db_verbose;
int db_no_fsync; /*!< no-op fsync for db */
};
/** \ingroup rpmdb
* Describes the collection of index databases used by rpm.
*/
struct rpmdb_s {
char * db_root;/*!< path prefix */
char * db_home;/*!< directory path */
char * db_fullpath; /*!< full db path including prefix */
int db_flags;
int db_mode; /*!< open mode */
int db_perms; /*!< open permissions */
char * db_descr; /*!< db backend description (for error msgs) */
struct dbChk_s * db_checked;/*!< headerCheck()'ed package instances */
rpmdb db_next;
int db_opens;
dbiIndex db_pkgs; /*!< Package db */
const rpmDbiTag * db_tags;
int db_ndbi; /*!< No. of tag indices. */
dbiIndex * db_indexes; /*!< Tag indices. */
int db_buildindex; /*!< Index rebuild indicator */
/* dbenv and related parameters */
void * db_dbenv; /*!< Backend private handle */
struct dbConfig_s cfg;
int db_remove_env;
struct rpmop_s db_getops;
struct rpmop_s db_putops;
struct rpmop_s db_delops;
int nrefs; /*!< Reference count. */
};
/* Type of the dbi, also serves as the join key size */
typedef enum dbiIndexType_e {
DBI_PRIMARY = (1 * sizeof(int32_t)),
DBI_SECONDARY = (2 * sizeof(int32_t)),
} dbiIndexType;
enum dbiFlags_e {
DBI_NONE = 0,
DBI_CREATED = (1 << 0),
DBI_RDONLY = (1 << 1),
};
enum dbcFlags_e {
DBC_READ = 0,
DBC_WRITE = (1 << 0),
};
enum dbcSearchType_e {
DBC_NORMAL_SEARCH = 0,
DBC_PREFIX_SEARCH = (1 << 0),
};
/** \ingroup dbi
* Describes an index database (implemented on Berkeley db functionality).
*/
struct dbiIndex_s {
const char * dbi_file; /*!< file component of path */
int dbi_oflags; /*!< db->open flags */
int dbi_no_dbsync; /*!< don't call dbiSync */
int dbi_lockdbfd; /*!< do fcntl lock on db fd */
int dbi_byteswapped;
rpmdb dbi_rpmdb; /*!< the parent rpm database */
dbiIndexType dbi_type; /*! Type of dbi (primary / index) */
void * dbi_db; /*!< Backend private handle */
};
#ifdef __cplusplus
extern "C" {
#endif
RPM_GNUC_INTERNAL
/* Globally enable/disable fsync in the backend */
void dbSetFSync(void *dbenv, int enable);
/** \ingroup dbi
* Return new configured index database handle instance.
* @param rdb rpm database
* @param rpmtag database index tag
* @return index database handle
*/
RPM_GNUC_INTERNAL
dbiIndex dbiNew(rpmdb rdb, rpmDbiTagVal rpmtag);
/** \ingroup dbi
* Destroy index database handle instance.
* @param dbi index database handle
* @return NULL always
*/
RPM_GNUC_INTERNAL
dbiIndex dbiFree( dbiIndex dbi);
/** \ingroup dbi
* Format dbi open flags for debugging print.
* @param dbflags db open flags
* @param print_dbenv_flags format db env flags instead?
* @return formatted flags (malloced)
*/
RPM_GNUC_INTERNAL
char * prDbiOpenFlags(int dbflags, int print_dbenv_flags);
/** \ingroup dbi
* Actually open the database of the index.
* @param db rpm database
* @param rpmtag database index tag
* @param dbiIndex address of index database handle
* @param flags
* @return 0 on success
*/
RPM_GNUC_INTERNAL
int dbiOpen(rpmdb rdb, rpmDbiTagVal rpmtag, dbiIndex * dbip, int flags);
/** \ingroup dbi
* Close index database.
* @param dbi index database handle
* @param flags (unused)
* @return 0 on success
*/
RPM_GNUC_INTERNAL
int dbiClose(dbiIndex dbi, unsigned int flags);
/** \ingroup dbi
* Verify (and close) index database.
* @param dbi index database handle
* @param flags (unused)
* @return 0 on success
*/
RPM_GNUC_INTERNAL
int dbiVerify(dbiIndex dbi, unsigned int flags);
/** \ingroup dbi
* Type of dbi (primary data / index)
* @param dbi index database handle
* @return type of dbi
*/
RPM_GNUC_INTERNAL
dbiIndexType dbiType(dbiIndex dbi);
/** \ingroup dbi
* Retrieve index control flags (new/existing, read-only etc)
* @param dbi index database handle
* @return dbi control flags
*/
RPM_GNUC_INTERNAL
int dbiFlags(dbiIndex dbi);
/** \ingroup dbi
* Retrieve index name (same as the backing file name)
* @param dbi index database handle
* @return dbi name
*/
RPM_GNUC_INTERNAL
const char * dbiName(dbiIndex dbi);
/** \ingroup dbi
* Open a database cursor.
* @param dbi index database handle
* @param flags DBC_WRITE if writing, or 0 (DBC_READ) for reading
* @return database cursor handle
*/
RPM_GNUC_INTERNAL
dbiCursor dbiCursorInit(dbiIndex dbi, unsigned int flags);
/** \ingroup dbi
* Destroy a database cursor handle
* @param dbc database cursor handle
* @return NULL always
*/
RPM_GNUC_INTERNAL
dbiCursor dbiCursorFree(dbiCursor dbc);
RPM_GNUC_INTERNAL
int pkgdbPut(dbiIndex dbi, dbiCursor dbc, unsigned int hdrNum,
unsigned char *hdrBlob, unsigned int hdrLen);
RPM_GNUC_INTERNAL
int pkgdbDel(dbiIndex dbi, dbiCursor dbc, unsigned int hdrNum);
RPM_GNUC_INTERNAL
int pkgdbGet(dbiIndex dbi, dbiCursor dbc, unsigned int hdrNum,
unsigned char **hdrBlob, unsigned int *hdrLen,
unsigned int *hdrOffset);
RPM_GNUC_INTERNAL
int pkgdbNew(dbiIndex dbi, dbiCursor dbc, unsigned int *hdrNum);
RPM_GNUC_INTERNAL
rpmRC idxdbGet(dbiCursor dbc, const char *keyp, size_t keylen,
dbiIndexSet *set, int curFlags);
RPM_GNUC_INTERNAL
rpmRC idxdbPut(dbiCursor dbc, const char *keyp, size_t keylen,
dbiIndexItem rec);
RPM_GNUC_INTERNAL
rpmRC idxdbDel(dbiCursor dbc, const char *keyp, size_t keylen,
dbiIndexItem rec);
RPM_GNUC_INTERNAL
const void * idxdbKey(dbiCursor dbc, unsigned int *keylen);
#ifdef __cplusplus
}
#endif
#endif /* _DBI_H */
|
