Transaction Element API.
(un)Installing packages:

How to retrieve information from a transaction element. More...

Collaboration diagram for Transaction Element API.:

## Files

file | rpmte.h

## Typedefs

typedef enum rpmElementType_e | rpmElementType

## Enumerations

enum | rpmElementType_e { TR_ADDED = (1 << 0), TR_REMOVED = (1 << 1), TR_RPMDB = (1 << 2) }

## Functions

Header | rpmteHeader (rpmte te)
Header | rpmteSetHeader (rpmte te, Header h)
rpmElementType | rpmteType (rpmte te)
const char * | rpmteN (rpmte te)
const char * | rpmteE (rpmte te)
const char * | rpmteV (rpmte te)
const char * | rpmteR (rpmte te)
const char * | rpmteA (rpmte te)
const char * | rpmteO (rpmte te)
int | rpmteIsSource (rpmte te)
rpm_color_t | rpmteColor (rpmte te)
rpm_color_t | rpmteSetColor (rpmte te, rpm_color_t color)
unsigned int | rpmteDBInstance (rpmte te)
void | rpmteSetDBInstance (rpmte te, unsigned int instance)
rpm_loff_t | rpmtePkgFileSize (rpmte te)
rpmte | rpmteParent (rpmte te)
rpmte | rpmteSetParent (rpmte te, rpmte pte)
rpmps | rpmteProblems (rpmte te)
void | rpmteCleanProblems (rpmte te)
void | rpmteCleanDS (rpmte te)
void | rpmteSetDependsOn (rpmte te, rpmte depends)
rpmte | rpmteDependsOn (rpmte te)
int | rpmteDBOffset (rpmte te)
const char * | rpmteEVR (rpmte te)
const char * | rpmteNEVR (rpmte te)
const char * | rpmteNEVRA (rpmte te)
fnpyKey | rpmteKey (rpmte te)
int | rpmteFailed (rpmte te)
rpmds | rpmteDS (rpmte te, rpmTagVal tag)
rpmfiles | rpmteFiles (rpmte te)
rpmfi | rpmteFI (rpmte te)
int | rpmteVerified (rpmte te)
rpmtsi | rpmtsiFree (rpmtsi tsi)
rpmtsi | rpmtsiInit (rpmts ts)
rpmte | rpmtsiNext (rpmtsi tsi, rpmElementTypes types)

## Detailed Description

How to retrieve information from a transaction element.

## Typedef Documentation

## rpmElementType

typedef enum rpmElementType_e rpmElementType

Transaction element type.

## Enumeration Type Documentation

## rpmElementType_e

enum rpmElementType_e

Transaction element type.

Enumerator
TR_ADDED | Package will be installed.
TR_REMOVED | Package will be removed.
TR_RPMDB | Package from the rpmdb.

Definition at line 19 of file rpmte.h.

## Function Documentation

## rpmteA()

const char* rpmteA | ( | rpmte | te | ) |

Retrieve arch string of transaction element.

Parameters

  te | transaction element

Returns
  arch string

## rpmteCleanDS()

void rpmteCleanDS | ( | rpmte | te | ) |

Destroy dependency set info of transaction element.

Parameters

  te | transaction element

## rpmteCleanProblems()

void rpmteCleanProblems | ( | rpmte | te | ) |

Destroy problem set info of transaction element.

Parameters

  te | transaction element

## rpmteColor()

rpm_color_t rpmteColor | ( | rpmte | te | ) |

Retrieve color bits of transaction element.

Parameters

  te | transaction element

Returns
  color bits

## rpmteDBInstance()

unsigned int rpmteDBInstance | ( | rpmte | te | ) |

Retrieve last instance installed to the database.

Parameters

  te | transaction element

Returns
  last install instance.

## rpmteDBOffset()

int rpmteDBOffset | ( | rpmte | te | ) |

Retrieve rpmdb instance of transaction element.

Parameters

  te | transaction element

Returns
  rpmdb instance (0 if not installed))

## rpmteDependsOn()

rpmte rpmteDependsOn | ( | rpmte | te | ) |

Retrieve dependent element of transaction element.

Parameters

  te | transaction element

Returns
  dependent transaction element

## rpmteDS()

rpmds rpmteDS | ( | rpmte | te,
|  | rpmTagVal | tag
| ) |  |

Retrieve dependency tag set from transaction element.

Parameters

  te | transaction element
  tag | dependency tag

Returns
  dependency tag set

## rpmteE()

const char* rpmteE | ( | rpmte | te | ) |

Retrieve epoch string of transaction element.

Parameters

  te | transaction element

Returns
  epoch string

## rpmteEVR()

const char* rpmteEVR | ( | rpmte | te | ) |

Retrieve [epoch:]version-release string from transaction element.

Parameters

  te | transaction element

Returns
  [epoch:]version-release string

## rpmteFailed()

int rpmteFailed | ( | rpmte | te | ) |

Return failure status of transaction element. If the element itself failed, this is 1, larger count means one of it's parents failed.

Parameters

  te | transaction element

Returns
  number of failures for this transaction element

## rpmteFI()

rpmfi rpmteFI | ( | rpmte | te | ) |

Retrieve file info iterator from transaction element.

Deprecated:
  use rpmteFiles() instead

Parameters

  te | transaction element

Returns
  file info tag set

## rpmteFiles()

rpmfiles rpmteFiles | ( | rpmte | te | ) |

Retrieve file info set from transaction element.

Parameters

  te | transaction element

Returns
  file info set (refcounted)

## rpmteHeader()

Header rpmteHeader | ( | rpmte | te | ) |

Retrieve header from transaction element.

Parameters

  te | transaction element

Returns
  header (new reference)

## rpmteIsSource()

int rpmteIsSource | ( | rpmte | te | ) |

Retrieve isSource attribute of transaction element.

Parameters

  te | transaction element

Returns
  isSource attribute

## rpmteKey()

fnpyKey rpmteKey | ( | rpmte | te | ) |

Retrieve key from transaction element.

Parameters

  te | transaction element

Returns
  key

## rpmteN()

const char* rpmteN | ( | rpmte | te | ) |

Retrieve name string of transaction element.

Parameters

  te | transaction element

Returns
  name string

## rpmteNEVR()

const char* rpmteNEVR | ( | rpmte | te | ) |

Retrieve name-[epoch:]version-release string from transaction element.

Parameters

  te | transaction element

Returns
  name-[epoch:]version-release string

## rpmteNEVRA()

const char* rpmteNEVRA | ( | rpmte | te | ) |

Retrieve name-[epoch:]version-release.arch string from transaction element.

Parameters

  te | transaction element

Returns
  name-[epoch:]version-release.arch string

## rpmteO()

const char* rpmteO | ( | rpmte | te | ) |

Retrieve os string of transaction element.

Parameters

  te | transaction element

Returns
  os string

## rpmteParent()

rpmte rpmteParent | ( | rpmte | te | ) |

Retrieve parent transaction element.

Parameters

  te | transaction element

Returns
  parent transaction element

## rpmtePkgFileSize()

rpm_loff_t rpmtePkgFileSize | ( | rpmte | te | ) |

Retrieve size in bytes of package file.

Todo:
  Signature header is estimated at 256b.

Parameters

  te | transaction element

Returns
  size in bytes of package file.

## rpmteProblems()

rpmps rpmteProblems | ( | rpmte | te | ) |

Return problem set info of transaction element.

Parameters

  te | transaction element

Returns
  problem set (or NULL if none)

## rpmteR()

const char* rpmteR | ( | rpmte | te | ) |

Retrieve release string of transaction element.

Parameters

  te | transaction element

Returns
  release string

## rpmteSetColor()

rpm_color_t rpmteSetColor | ( | rpmte | te,
|  | rpm_color_t | color
| ) |  |

Set color bits of transaction element.

Parameters

  te | transaction element
  color | new color bits

Returns
  previous color bits

## rpmteSetDBInstance()

void rpmteSetDBInstance | ( | rpmte | te,
|  | unsigned int | instance
| ) |  |

Set last instance installed to the database.

Parameters

  te | transaction element
  instance | Database instance of last install element.

Returns
  last install instance.

## rpmteSetDependsOn()

void rpmteSetDependsOn | ( | rpmte | te,
|  | rpmte | depends
| ) |  |

Set dependent element of transaction element.

Parameters

  te | transaction element
  depends | dependent transaction element

## rpmteSetHeader()

Header rpmteSetHeader | ( | rpmte | te,
|  | Header | h
| ) |  |

Save header into transaction element.

Parameters

  te | transaction element
  h | header

Returns
  NULL always

## rpmteSetParent()

rpmte rpmteSetParent | ( | rpmte | te,
|  | rpmte | pte
| ) |  |

Set parent transaction element.

Parameters

  te | transaction element
  pte | new parent transaction element

Returns
  previous parent transaction element

## rpmteType()

rpmElementType rpmteType | ( | rpmte | te | ) |

Retrieve type of transaction element.

Parameters

  te | transaction element

Returns
  type

## rpmteV()

const char* rpmteV | ( | rpmte | te | ) |

Retrieve version string of transaction element.

Parameters

  te | transaction element

Returns
  version string

## rpmteVerified()

int rpmteVerified | ( | rpmte | te | ) |

Retrieve verification status from transaction element. Returns RPMSIG_UNVERIFIED_TYPE if no verify has been attempted, otherwise RPMSIG_SIGNATURE_TYPE and RPMSIG_DIGEST_TYPE bits will be set if that type of verification was successfully performed.

Parameters

  te | transaction element

Returns
  verification status

## rpmtsiFree()

rpmtsi rpmtsiFree | ( | rpmtsi | tsi | ) |

Destroy transaction element iterator.

Parameters

  tsi | transaction element iterator

Returns
  NULL always

## rpmtsiInit()

rpmtsi rpmtsiInit | ( | rpmts | ts | ) |

Create transaction element iterator.

Parameters

  ts | transaction set

Returns
  transaction element iterator

## rpmtsiNext()

rpmte rpmtsiNext | ( | rpmtsi | tsi,
|  | rpmElementTypes | types
| ) |  |

Return next transaction element of type.

Parameters

  tsi | transaction element iterator
  types | transaction element type selector (0 for any)

Returns
  next transaction element of type, NULL on termination