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
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
|
#ifndef H_RPMTS
#define H_RPMTS
/** \ingroup rpmts
* \file lib/rpmts.h
* Structures and prototypes used for an "rpmts" transaction set.
*/
#include <sys/types.h>
#include <rpm/rpmtypes.h>
#include <rpm/rpmte.h>
#include <rpm/rpmps.h>
#include <rpm/rpmsw.h>
#include <rpm/rpmpgp.h>
#include <rpm/rpmfi.h>
#include <rpm/rpmcallback.h>
#ifdef __cplusplus
extern "C" {
#endif
extern int _rpmts_stats;
/** \ingroup rpmts
* Bit(s) to control rpmtsRun() operation.
*/
enum rpmtransFlags_e {
RPMTRANS_FLAG_NONE = 0,
RPMTRANS_FLAG_TEST = (1 << 0), /*!< from --test */
RPMTRANS_FLAG_BUILD_PROBS = (1 << 1), /*!< don't process payload */
RPMTRANS_FLAG_NOSCRIPTS = (1 << 2), /*!< from --noscripts */
RPMTRANS_FLAG_JUSTDB = (1 << 3), /*!< from --justdb */
RPMTRANS_FLAG_NOTRIGGERS = (1 << 4), /*!< from --notriggers */
RPMTRANS_FLAG_NODOCS = (1 << 5), /*!< from --excludedocs */
RPMTRANS_FLAG_ALLFILES = (1 << 6), /*!< from --allfiles */
RPMTRANS_FLAG_NOPLUGINS = (1 << 7), /*!< from --noplugins */
RPMTRANS_FLAG_NOCONTEXTS = (1 << 8), /*!< from --nocontexts */
RPMTRANS_FLAG_NOCAPS = (1 << 9), /*!< from --nocaps */
/* bits 10-15 unused */
RPMTRANS_FLAG_NOTRIGGERPREIN= (1 << 16), /*!< from --notriggerprein */
RPMTRANS_FLAG_NOPRE = (1 << 17), /*!< from --nopre */
RPMTRANS_FLAG_NOPOST = (1 << 18), /*!< from --nopost */
RPMTRANS_FLAG_NOTRIGGERIN = (1 << 19), /*!< from --notriggerin */
RPMTRANS_FLAG_NOTRIGGERUN = (1 << 20), /*!< from --notriggerun */
RPMTRANS_FLAG_NOPREUN = (1 << 21), /*!< from --nopreun */
RPMTRANS_FLAG_NOPOSTUN = (1 << 22), /*!< from --nopostun */
RPMTRANS_FLAG_NOTRIGGERPOSTUN = (1 << 23), /*!< from --notriggerpostun */
RPMTRANS_FLAG_NOPRETRANS = (1 << 24), /*!< from --nopretrans */
RPMTRANS_FLAG_NOPOSTTRANS = (1 << 25), /*!< from --noposttrans */
/* bit 26 unused */
RPMTRANS_FLAG_NOMD5 = (1 << 27), /*!< from --nomd5 */
RPMTRANS_FLAG_NOFILEDIGEST = (1 << 27), /*!< from --nofiledigest (alias to --nomd5) */
/* bit 28 unused */
RPMTRANS_FLAG_NOARTIFACTS = (1 << 29), /*!< from --noartifacts */
RPMTRANS_FLAG_NOCONFIGS = (1 << 30), /*!< from --noconfigs */
RPMTRANS_FLAG_DEPLOOPS = (1 << 31) /*!< from --deploops */
};
typedef rpmFlags rpmtransFlags;
#define _noTransScripts \
( RPMTRANS_FLAG_NOPRE | \
RPMTRANS_FLAG_NOPOST | \
RPMTRANS_FLAG_NOPREUN | \
RPMTRANS_FLAG_NOPOSTUN | \
RPMTRANS_FLAG_NOPRETRANS | \
RPMTRANS_FLAG_NOPOSTTRANS \
)
#define _noTransTriggers \
( RPMTRANS_FLAG_NOTRIGGERPREIN | \
RPMTRANS_FLAG_NOTRIGGERIN | \
RPMTRANS_FLAG_NOTRIGGERUN | \
RPMTRANS_FLAG_NOTRIGGERPOSTUN \
)
/* Avoid unnecessary breakage for stuff referring to these unused flags */
#define RPMTRANS_FLAG_NOPAYLOAD 0
#define RPMTRANS_FLAG_APPLYONLY 0
#define RPMTRANS_FLAG_KEEPOBSOLETE 0
#define RPMTRANS_FLAG_DIRSTASH 0
#define RPMTRANS_FLAG_REPACKAGE 0
#define RPMTRANS_FLAG_PKGCOMMIT 0
#define RPMTRANS_FLAG_PKGUNDO 0
#define RPMTRANS_FLAG_COMMIT 0
#define RPMTRANS_FLAG_UNDO 0
#define RPMTRANS_FLAG_REVERSE 0
#define RPMTRANS_FLAG_NOSUGGEST 0
#define RPMTRANS_FLAG_ADDINDEPS 0
/** \ingroup rpmts
* Bit(s) to control digest and signature verification.
*/
enum rpmVSFlags_e {
RPMVSF_DEFAULT = 0,
RPMVSF_NOHDRCHK = (1 << 0),
RPMVSF_NEEDPAYLOAD = (1 << 1),
/* bit(s) 2-7 unused */
RPMVSF_NOSHA1HEADER = (1 << 8),
RPMVSF_NOSHA256HEADER = (1 << 9),
RPMVSF_NODSAHEADER = (1 << 10),
RPMVSF_NORSAHEADER = (1 << 11),
/* bit(s) 12-15 unused */
RPMVSF_NOPAYLOAD = (1 << 16),
RPMVSF_NOMD5 = (1 << 17),
RPMVSF_NODSA = (1 << 18),
RPMVSF_NORSA = (1 << 19)
/* bit(s) 16-31 unused */
};
typedef rpmFlags rpmVSFlags;
#define RPMVSF_MASK_NODIGESTS \
( RPMVSF_NOSHA1HEADER | \
RPMVSF_NOSHA256HEADER | \
RPMVSF_NOPAYLOAD | \
RPMVSF_NOMD5 )
#define _RPMVSF_NODIGESTS RPMVSF_MASK_NODIGESTS
#define RPMVSF_MASK_NOSIGNATURES \
( RPMVSF_NODSAHEADER | \
RPMVSF_NORSAHEADER | \
RPMVSF_NODSA | \
RPMVSF_NORSA )
#define _RPMVSF_NOSIGNATURES RPMVSF_MASK_NOSIGNATURES
#define RPMVSF_MASK_NOHEADER \
( RPMVSF_NOSHA1HEADER | \
RPMVSF_NOSHA256HEADER | \
RPMVSF_NODSAHEADER | \
RPMVSF_NORSAHEADER )
#define _RPMVSF_NOHEADER RPMVSF_MASK_NOHEADER
#define RPMVSF_MASK_NOPAYLOAD \
( RPMVSF_NOMD5 | \
RPMVSF_NOPAYLOAD | \
RPMVSF_NODSA | \
RPMVSF_NORSA )
#define _RPMVSF_NOPAYLOAD RPMVSF_MASK_NOPAYLOAD
enum {
RPMSIG_NONE_TYPE = 0,
RPMSIG_DIGEST_TYPE = (1 << 0),
RPMSIG_SIGNATURE_TYPE = (1 << 1),
RPMSIG_OTHER_TYPE = (1 << 2),
};
#define RPMSIG_VERIFIABLE_TYPE (RPMSIG_DIGEST_TYPE|RPMSIG_SIGNATURE_TYPE)
#define RPMSIG_UNVERIFIED_TYPE (1 << 30)
/** \ingroup rpmts
* Indices for timestamps.
*/
typedef enum rpmtsOpX_e {
RPMTS_OP_TOTAL = 0,
RPMTS_OP_CHECK = 1,
RPMTS_OP_ORDER = 2,
RPMTS_OP_FINGERPRINT = 3,
RPMTS_OP_INSTALL = 5,
RPMTS_OP_ERASE = 6,
RPMTS_OP_SCRIPTLETS = 7,
RPMTS_OP_COMPRESS = 8,
RPMTS_OP_UNCOMPRESS = 9,
RPMTS_OP_DIGEST = 10,
RPMTS_OP_SIGNATURE = 11,
RPMTS_OP_DBADD = 12,
RPMTS_OP_DBREMOVE = 13,
RPMTS_OP_DBGET = 14,
RPMTS_OP_DBPUT = 15,
RPMTS_OP_DBDEL = 16,
RPMTS_OP_VERIFY = 17,
RPMTS_OP_MAX = 18
} rpmtsOpX;
enum rpmtxnFlags_e {
RPMTXN_READ = (1 << 0),
RPMTXN_WRITE = (1 << 1),
};
typedef rpmFlags rpmtxnFlags;
typedef enum rpmtsEvent_e {
RPMTS_EVENT_ADD = 1,
RPMTS_EVENT_DEL = 2,
} rpmtsEvent;
/** \ingroup rpmts
* Transaction change callback type.
*
* On explicit install/erase add events, "other" is NULL, on implicit
* add events (erasures due to obsolete/upgrade, replaced by newer)
* it points to the replacing package.
*
* @param event Change event (see rpmtsEvent enum)
* @param te Transaction element
* @param other Related transaction element (or NULL)
* @param data Application private data from rpmtsSetChangeCallback()
*/
typedef int (*rpmtsChangeFunction)
(int event, rpmte te, rpmte other, void *data);
/** \ingroup rpmts
* Perform dependency resolution on the transaction set.
*
* Any problems found by rpmtsCheck() can be examined by retrieving the
* problem set with rpmtsProblems(), success here only means that
* the resolution was successfully attempted for all packages in the set.
*
* @param ts transaction set
* @return 0 on success
*/
int rpmtsCheck(rpmts ts);
/** \ingroup rpmts
* Determine package order in a transaction set according to dependencies.
*
* Order packages, returning error if circular dependencies cannot be
* eliminated by removing Requires's from the loop(s). Only dependencies from
* added or removed packages are used to determine ordering using a
* topological sort (Knuth vol. 1, p. 262). Use rpmtsCheck() to verify
* that all dependencies can be resolved.
*
* The final order ends up as installed packages followed by removed packages,
* with packages removed for upgrades immediately following the new package
* to be installed.
*
* @param ts transaction set
* @return no. of (added) packages that could not be ordered
*/
int rpmtsOrder(rpmts ts);
/** \ingroup rpmts
* Process all package elements in a transaction set. Before calling
* rpmtsRun be sure to have:
*
* - setup the rpm root dir via rpmtsSetRoot().
* - setup the rpm notify callback via rpmtsSetNotifyCallback().
* - setup the rpm transaction flags via rpmtsSetFlags().
*
* Additionally, though not required you may want to:
*
* - setup the rpm verify signature flags via rpmtsSetVSFlags().
*
* @param ts transaction set
* @param okProbs unused
* @param ignoreSet bits to filter problem types
* @return 0 on success, -1 on error, >0 with newProbs set
*/
int rpmtsRun(rpmts ts, rpmps okProbs, rpmprobFilterFlags ignoreSet);
/** \ingroup rpmts
* Reference a transaction set instance.
* @param ts transaction set
* @return new transaction set reference
*/
rpmts rpmtsLink (rpmts ts);
/** \ingroup rpmts
* Close the database used by the transaction.
* @param ts transaction set
* @return 0 on success
*/
int rpmtsCloseDB(rpmts ts);
/** \ingroup rpmts
* Open the database used by the transaction.
* @param ts transaction set
* @param dbmode O_RDONLY or O_RDWR
* @return 0 on success
*/
int rpmtsOpenDB(rpmts ts, int dbmode);
/** \ingroup rpmts
* Initialize the database used by the transaction.
* @param ts transaction set
* @param perms database permissions (ie mode bits)
* @return 0 on success
*/
int rpmtsInitDB(rpmts ts, int perms);
/** \ingroup rpmts
* Return the transaction database mode
* @param ts transaction set
* @return O_RDONLY, O_RDWR or -1 (lazy opens disabled)
*/
int rpmtsGetDBMode(rpmts ts);
/** \ingroup rpmts
* Set the transaction database mode. Only permitted when when backing
* database hasn't been opened yet (ie rpmtsGetRdb(ts) == NULL)
* @param ts transaction set
* @param dbmode O_RDONLY, O_RDWR or -1 (disable lazy opens)
* @return 0 on success, 1 on error
*/
int rpmtsSetDBMode(rpmts ts, int dbmode);
/** \ingroup rpmts
* Rebuild the database used by the transaction.
* @param ts transaction set
* @return 0 on success
*/
int rpmtsRebuildDB(rpmts ts);
/** \ingroup rpmts
* Verify the database used by the transaction.
* @param ts transaction set
* @return 0 on success
*/
int rpmtsVerifyDB(rpmts ts);
/** \ingroup rpmts
* Return transaction database iterator.
* @param ts transaction set
* @param rpmtag database index tag
* @param keyp key data (NULL for sequential access)
* @param keylen key data length (0 will use strlen(keyp))
* @return NULL on failure
*/
rpmdbMatchIterator rpmtsInitIterator(const rpmts ts, rpmDbiTagVal rpmtag,
const void * keyp, size_t keylen);
/** \ingroup rpmts
* Import a header into the rpmdb
* @param txn transaction handle
* @param h header
* @param flags (unused)
* @return RPMRC_OK/RPMRC_FAIL
*/
rpmRC rpmtsImportHeader(rpmtxn txn, Header h, rpmFlags flags);
/** \ingroup rpmts
* Import public key packet(s).
* @todo Implicit --update policy for gpg-pubkey headers.
* @param ts transaction set
* @param pkt pgp pubkey packet(s)
* @param pktlen pgp pubkey length
* @return RPMRC_OK/RPMRC_FAIL
*/
rpmRC rpmtsImportPubkey(rpmts ts, const unsigned char * pkt, size_t pktlen);
/** \ingroup rpmts
* Retrieve handle for keyring used for this transaction set
* @param ts transaction set
* @param autoload load default keyring if keyring is not set
* @return keyring handle (or NULL)
*/
rpmKeyring rpmtsGetKeyring(rpmts ts, int autoload);
/** \ingroup rpmts
* Set keyring to use for this transaction set.
* Keyring can be only changed while the underlying rpm database is not
* yet open.
* @param ts transaction set
* @param keyring keyring handle (NULL to free current keyring)
* @return 0 on success, -1 on error
*/
int rpmtsSetKeyring(rpmts ts, rpmKeyring keyring);
/** \ingroup rpmts
* Set dependency solver callback.
* @param ts transaction set
* @param (*solve) dependency solver callback
* @param solveData dependency solver callback data (opaque)
* @return 0 on success
*/
int rpmtsSetSolveCallback(rpmts ts,
int (*solve) (rpmts ts, rpmds ds, const void * data),
const void * solveData);
/** \ingroup rpmts
* Return current transaction set problems.
* @param ts transaction set
* @return current problem set (or NULL if no problems)
*/
rpmps rpmtsProblems(rpmts ts);
/** \ingroup rpmts
* Clean current transaction problem set.
* @param ts transaction set
*/
void rpmtsCleanProblems(rpmts ts);
/** \ingroup rpmts
* Free memory needed only for dependency checks and ordering.
* @param ts transaction set
*/
void rpmtsClean(rpmts ts);
/** \ingroup rpmts
* Re-create an empty transaction set.
* @param ts transaction set
*/
void rpmtsEmpty(rpmts ts);
/** \ingroup rpmts
* Destroy transaction set, closing the database as well.
* @param ts transaction set
* @return NULL always
*/
rpmts rpmtsFree(rpmts ts);
/** \ingroup rpmts
* Get verify signatures flag(s).
* @param ts transaction set
* @return verify signatures flags
*/
rpmVSFlags rpmtsVSFlags(rpmts ts);
/** \ingroup rpmts
* Set verify signatures flag(s).
* @param ts transaction set
* @param vsflags new verify signatures flags
* @return previous value
*/
rpmVSFlags rpmtsSetVSFlags(rpmts ts, rpmVSFlags vsflags);
/** \ingroup rpmts
* Get package verify flag(s).
* @param ts transaction set
* @return verify signatures flags
*/
rpmVSFlags rpmtsVfyFlags(rpmts ts);
/** \ingroup rpmts
* Set package verify flag(s).
* @param ts transaction set
* @param vfyflags new package verify flags
* @return old package verify flags
*/
rpmVSFlags rpmtsSetVfyFlags(rpmts ts, rpmVSFlags vfyflags);
/** \ingroup rpmts
* Get enforced package verify level
* @param ts transaction set
* @return package verify level
*/
int rpmtsVfyLevel(rpmts ts);
/** \ingroup rpmts
* Set enforced package verify level
* @param ts transaction set
* @param vfylevel new package verify level
* @return old package verify level
*/
int rpmtsSetVfyLevel(rpmts ts, int vfylevel);
/** \ingroup rpmts
* Get transaction rootDir, i.e. path to chroot(2).
* @param ts transaction set
* @return transaction rootDir
*/
const char * rpmtsRootDir(rpmts ts);
/** \ingroup rpmts
* Set transaction rootDir, i.e. path to chroot(2).
*
* Note that rpm assumes the environment inside the root is set up by
* the caller, such as any mounts needed for the operation inside the
* root directory.
*
* @param ts transaction set
* @param rootDir new transaction rootDir (or NULL)
* @return 0 on success, -1 on error (invalid rootDir)
*/
int rpmtsSetRootDir(rpmts ts, const char * rootDir);
/** \ingroup rpmts
* Get transaction script file handle, i.e. stdout/stderr on scriptlet execution
* @param ts transaction set
* @return transaction script file handle
*/
FD_t rpmtsScriptFd(rpmts ts);
/** \ingroup rpmts
* Set transaction script file handle, i.e. stdout/stderr on scriptlet execution
* @param ts transaction set
* @param scriptFd new script file handle (or NULL)
*/
void rpmtsSetScriptFd(rpmts ts, FD_t scriptFd);
/** \ingroup rpmts
* Get transaction id, i.e. transaction time stamp.
* @param ts transaction set
* @return transaction id
*/
rpm_tid_t rpmtsGetTid(rpmts ts);
/** \ingroup rpmts
* Set transaction id, i.e. transaction time stamp.
* @param ts transaction set
* @param tid new transaction id
* @return previous transaction id
*/
rpm_tid_t rpmtsSetTid(rpmts ts, rpm_tid_t tid);
/** \ingroup rpmts
* Get transaction set database handle.
* @param ts transaction set
* @return transaction database handle
*/
rpmdb rpmtsGetRdb(rpmts ts);
/** \ingroup rpmts
* Perform transaction progress notify callback.
* @param ts transaction set
* @param te current transaction element
* @param what type of call back
* @param amount current value
* @param total final value
* @return callback dependent pointer
*/
void * rpmtsNotify(rpmts ts, rpmte te,
rpmCallbackType what, rpm_loff_t amount, rpm_loff_t total);
/** \ingroup rpmts
* Return number of (ordered) transaction set elements.
* @param ts transaction set
* @return no. of transaction set elements
*/
int rpmtsNElements(rpmts ts);
/** \ingroup rpmts
* Return (ordered) transaction set element.
* @param ts transaction set
* @param ix transaction element index
* @return transaction element (or NULL)
*/
rpmte rpmtsElement(rpmts ts, int ix);
/** \ingroup rpmts
* Get problem ignore bit mask, i.e. bits to filter encountered problems.
* @param ts transaction set
* @return ignore bit mask
*/
rpmprobFilterFlags rpmtsFilterFlags(rpmts ts);
/** \ingroup rpmts
* Get transaction flags, i.e. bits that control rpmtsRun().
* @param ts transaction set
* @return transaction flags
*/
rpmtransFlags rpmtsFlags(rpmts ts);
/** \ingroup rpmts
* Set transaction flags, i.e. bits that control rpmtsRun().
* @param ts transaction set
* @param transFlags new transaction flags
* @return previous transaction flags
*/
rpmtransFlags rpmtsSetFlags(rpmts ts, rpmtransFlags transFlags);
/** \ingroup rpmts
* Retrieve color bits of transaction set.
* @param ts transaction set
* @return color bits
*/
rpm_color_t rpmtsColor(rpmts ts);
/** \ingroup rpmts
* Retrieve preferred file color
* @param ts transaction set
* @return color bits
*/
rpm_color_t rpmtsPrefColor(rpmts ts);
/** \ingroup rpmts
* Set color bits of transaction set.
* @param ts transaction set
* @param color new color bits
* @return previous color bits
*/
rpm_color_t rpmtsSetColor(rpmts ts, rpm_color_t color);
/** \ingroup rpmts
* Set preferred file color
* @param ts transaction set
* @param color new color bits
* @return previous color bits
*/
rpm_color_t rpmtsSetPrefColor(rpmts ts, rpm_color_t color);
/** \ingroup rpmts
* Retrieve operation timestamp from a transaction set.
* @param ts transaction set
* @param opx operation timestamp index
* @return pointer to operation timestamp.
*/
rpmop rpmtsOp(rpmts ts, rpmtsOpX opx);
/** \ingroup rpmts
* Get the plugins associated with a transaction set
* @param ts transaction set
* @return plugins
*/
rpmPlugins rpmtsPlugins(rpmts ts);
/** \ingroup rpmts
* Set transaction notify callback function and argument.
*
* @warning This call must be made before rpmtsRun() for
* install/upgrade/freshen to function correctly.
*
* @param ts transaction set
* @param notify progress callback
* @param notifyData progress callback private data
* @return 0 on success
*/
int rpmtsSetNotifyCallback(rpmts ts,
rpmCallbackFunction notify,
rpmCallbackData notifyData);
/** \ingroup rpmts
* Set transaction notify callback style.
*
* @param ts transaction set
* @param style 0 (default) for header, 1 for transaction element
* as the first argument
* @return 0 on success
*/
int rpmtsSetNotifyStyle(rpmts ts, int style);
/** \ingroup rpmts
* Get transaction notify callback style.
*
* @param ts transaction set
* @return current callback style (see above)
*/
int rpmtsGetNotifyStyle(rpmts ts);
/** \ingroup rpmts
* Set transaction change callback function and argument.
*
* The change callback gets called when transaction elements are added,
* replaced or removed from a transaction set.
*
* @param ts transaction set
* @param notify element change callback
* @param data element change callback private data
* @return 0 on success
*/
int rpmtsSetChangeCallback(rpmts ts, rpmtsChangeFunction notify, void *data);
/** \ingroup rpmts
* Create an empty transaction set.
* @return new transaction set
*/
rpmts rpmtsCreate(void);
/** \ingroup rpmts
* Add package to be installed to transaction set.
*
* The transaction set is checked for duplicate package names.
* If found, the package with the "newest" EVR will be replaced.
*
* @param ts transaction set
* @param h header
* @param key package retrieval key (e.g. file name)
* @param upgrade is package being upgraded?
* @param relocs package file relocations
* @return 0 on success, 1 on I/O error, 2 needs capabilities
*/
int rpmtsAddInstallElement(rpmts ts, Header h,
const fnpyKey key, int upgrade,
rpmRelocation * relocs);
/** \ingroup rpmts
* Add package to be reinstalled to transaction set.
*
* @param ts transaction set
* @param h header
* @param key package retrieval key (e.g. file name)
* @return 0 on success
*/
int rpmtsAddReinstallElement(rpmts ts, Header h, const fnpyKey key);
/** \ingroup rpmts
* Add package to be erased to transaction set.
* @param ts transaction set
* @param h header
* @param dboffset ununsed
* @return 0 on success, 1 on error (not installed)
*/
int rpmtsAddEraseElement(rpmts ts, Header h, int dboffset);
/** \ingroup rpmts
* Create a transaction (lock) handle
* @param ts transaction set
* @param flags flags
* @return transaction handle
*/
rpmtxn rpmtxnBegin(rpmts ts, rpmtxnFlags flags);
/** \ingroup rpmts
* Destroy transaction (lock) handle
* @param txn transaction handle
* @return NULL always
*/
rpmtxn rpmtxnEnd(rpmtxn txn);
/** \ingroup rpmte
* Destroy transaction element iterator.
* @param tsi transaction element iterator
* @return NULL always
*/
rpmtsi rpmtsiFree(rpmtsi tsi);
/** \ingroup rpmte
* Create transaction element iterator.
* @param ts transaction set
* @return transaction element iterator
*/
rpmtsi rpmtsiInit(rpmts ts);
/** \ingroup rpmte
* Return next transaction element of type.
* @param tsi transaction element iterator
* @param types transaction element type selector (0 for any)
* @return next transaction element of type, NULL on termination
*/
rpmte rpmtsiNext(rpmtsi tsi, rpmElementTypes types);
#ifdef __cplusplus
}
#endif
#endif /* H_RPMTS */
|