rpm: Transaction Element API.

rpm 4.12.0.1

- Main Page
- Related Pages
- Modules
- Data Structures
- Files

Files | Typedefs | Enumerations | Functions
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. More...

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

## Detailed Description

## 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

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 iterator from transaction element.

Deprecated:
  use rpmteFiles() instead
  Parameters

    te | transaction element

  Returns
    file info tag set

rpmfiles rpmteFiles | ( | rpmte | te | ) |

Retrieve file info set from transaction element.

Parameters

  te | transaction element

Returns
  file info set (refcounted)

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