Transaction Element API.
Collaboration diagram for Transaction Element API.:

## Files

file | rpmte.h

| Structures used for an "rpmte" transaction element.

## Typedefs

typedef enum rpmElementType_e | rpmElementType
| Transaction element type.

## Enumerations

enum | rpmElementType_e { TR_ADDED = (1 << 0), TR_REMOVED = (1 << 1) }
| Transaction element type. More...

## Functions

Header | rpmteHeader (rpmte te)
| Retrieve header from transaction element.
Header | rpmteSetHeader (rpmte te, Header h)
| Save header into transaction element.
rpmElementType | rpmteType (rpmte te)
| Retrieve type of transaction element.
const char * | rpmteN (rpmte te)
| Retrieve name string of transaction element.
const char * | rpmteE (rpmte te)
| Retrieve epoch string of transaction element.
const char * | rpmteV (rpmte te)
| Retrieve version string of transaction element.
const char * | rpmteR (rpmte te)
| Retrieve release string of transaction element.
const char * | rpmteA (rpmte te)
| Retrieve arch string of transaction element.
const char * | rpmteO (rpmte te)
| Retrieve os string of transaction element.
int | rpmteIsSource (rpmte te)
| Retrieve isSource attribute of transaction element.
rpm_color_t | rpmteColor (rpmte te)
| Retrieve color bits of transaction element.
rpm_color_t | rpmteSetColor (rpmte te, rpm_color_t color)
| Set color bits of transaction element.
unsigned int | rpmteDBInstance (rpmte te)
| Retrieve last instance installed to the database.
void | rpmteSetDBInstance (rpmte te, unsigned int instance)
| Set last instance installed to the database.
rpm_loff_t | rpmtePkgFileSize (rpmte te)
| Retrieve size in bytes of package file.
rpmte | rpmteParent (rpmte te)
| Retrieve parent transaction element.
rpmte | rpmteSetParent (rpmte te, rpmte pte)
| Set parent transaction element.
rpmps | rpmteProblems (rpmte te)
| Return problem set info of transaction element.
void | rpmteCleanProblems (rpmte te)
| Destroy problem set info of transaction element.
void | rpmteCleanDS (rpmte te)
| Destroy dependency set info of transaction element.
void | rpmteSetDependsOn (rpmte te, rpmte depends)
| Set dependent element of TR_REMOVED transaction element.
rpmte | rpmteDependsOn (rpmte te)
| Retrieve dependent element of TR_REMOVED transaction element.
int | rpmteDBOffset (rpmte te)
| Retrieve rpmdb instance of TR_REMOVED transaction element.
const char * | rpmteEVR (rpmte te)
| Retrieve [epoch:]version-release string from transaction element.
const char * | rpmteNEVR (rpmte te)
| Retrieve name-[epoch:]version-release string from transaction element.
const char * | rpmteNEVRA (rpmte te)
| Retrieve name-[epoch:]version-release.arch string from transaction element.
fnpyKey | rpmteKey (rpmte te)
| Retrieve key from transaction element.
int | rpmteFailed (rpmte te)
| Return failure status of transaction element.
rpmds | rpmteDS (rpmte te, rpmTagVal tag)
| Retrieve dependency tag set from transaction element.
rpmfi | rpmteFI (rpmte te)
| Retrieve file info tag set from transaction element.
ARGV_const_t | rpmteCollections (rpmte te)
| Retrieve list of collections.
int | rpmteHasCollection (rpmte te, const char *collname)
| Determine a transaction element is part of a collection.
rpmtsi | rpmtsiFree (rpmtsi tsi)
| Destroy transaction element iterator.
rpmtsi | rpmtsiInit (rpmts ts)
| Create transaction element iterator.
rpmte | rpmtsiNext (rpmtsi tsi, rpmElementTypes types)
| Return next transaction element of type.

## Typedef Documentation

typedef enum rpmElementType_e rpmElementType

Transaction element type.

## Enumeration Type Documentation

enum rpmElementType_e

Transaction element type.

Enumerator:

  TR_ADDED | Package will be installed.
  TR_REMOVED | Package will be removed.

Definition at line 19 of file rpmte.h.

## Function Documentation

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

Retrieve arch string of transaction element.

Parameters:

  te | transaction element

Returns:
  arch string

void rpmteCleanDS | ( | rpmte | te | ) |

Destroy dependency set info of transaction element.

Parameters:

  te | transaction element

void rpmteCleanProblems | ( | rpmte | te | ) |

Destroy problem set info of transaction element.

Parameters:

  te | transaction element

ARGV_const_t rpmteCollections | ( | rpmte | te | ) |

Retrieve list of collections.

Parameters:

  te | transaction element

Returns:
  list of collections

rpm_color_t rpmteColor | ( | rpmte | te | ) |

Retrieve color bits of transaction element.

Parameters:

  te | transaction element

Returns:
  color bits

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

Retrieve last instance installed to the database.

Parameters:

  te | transaction element

Returns:
  last install instance.

int rpmteDBOffset | ( | rpmte | te | ) |

Retrieve rpmdb instance of TR_REMOVED transaction element.

Parameters:

  te | transaction element

Returns:
  rpmdb instance

rpmte rpmteDependsOn | ( | rpmte | te | ) |

Retrieve dependent element of TR_REMOVED transaction element.

Parameters:

  te | transaction element

Returns:
  dependent transaction element

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

Retrieve dependency tag set from transaction element.

Parameters:

  te | transaction element
  tag | dependency tag

Returns:
  dependency tag set

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

Retrieve epoch string of transaction element.

Parameters:

  te | transaction element

Returns:
  epoch string

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

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

Parameters:

  te | transaction element

Returns:
  [epoch:]version-release string

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

rpmfi rpmteFI | ( | rpmte | te | ) |

Retrieve file info tag set from transaction element.

Parameters:

  te | transaction element

Returns:
  file info tag set

int rpmteHasCollection | ( | rpmte | te,
|  | const char * | collname
| ) |  |

Determine a transaction element is part of a collection.

Parameters:

  te | transaction element
  collname | collection name

Returns:
  1 if collname is part of a collection, 0 if not

Header rpmteHeader | ( | rpmte | te | ) |

Retrieve header from transaction element.

Parameters:

  te | transaction element

Returns:
  header (new reference)

int rpmteIsSource | ( | rpmte | te | ) |

Retrieve isSource attribute of transaction element.

Parameters:

  te | transaction element

Returns:
  isSource attribute

fnpyKey rpmteKey | ( | rpmte | te | ) |

Retrieve key from transaction element.

Parameters:

  te | transaction element

Returns:
  key

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

Retrieve name string of transaction element.

Parameters:

  te | transaction element

Returns:
  name string

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

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

Parameters:

  te | transaction element

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

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

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

Retrieve os string of transaction element.

Parameters:

  te | transaction element

Returns:
  os string

rpmte rpmteParent | ( | rpmte | te | ) |

Retrieve parent transaction element.

Parameters:

  te | transaction element

Returns:
  parent transaction element

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.

rpmps rpmteProblems | ( | rpmte | te | ) |

Return problem set info of transaction element.

Parameters:

  te | transaction element

Returns:
  problem set (or NULL if none)

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

Retrieve release string of transaction element.

Parameters:

  te | transaction element

Returns:
  release string

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

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.

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

Set dependent element of TR_REMOVED transaction element.

Parameters:

  te | transaction element
  depends | dependent transaction element

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

Save header into transaction element.

Parameters:

  te | transaction element
  h | header

Returns:
  NULL always

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

Set parent transaction element.

Parameters:

  te | transaction element
  pte | new parent transaction element

Returns:
  previous parent transaction element

rpmElementType rpmteType | ( | rpmte | te | ) |

Retrieve type of transaction element.

Parameters:

  te | transaction element

Returns:
  type

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

Retrieve version string of transaction element.

Parameters:

  te | transaction element

Returns:
  version string

rpmtsi rpmtsiFree | ( | rpmtsi | tsi | ) |

Destroy transaction element iterator.

Parameters:

  tsi | transaction element iterator

Returns:
  NULL always

rpmtsi rpmtsiInit | ( | rpmts | ts | ) |

Create transaction element iterator.

Parameters:

  ts | transaction set

Returns:
  transaction element iterator

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