#ifndef H_RPMAL
#define H_RPMAL
/** \ingroup rpmdep rpmtrans
* \file lib/rpmal.h
* Structures used for managing added/available package lists.
*/
#include <rpm/rpmtypes.h>
#include <rpm/rpmts.h>
#ifdef __cplusplus
extern "C" {
#endif
typedef struct rpmal_s * rpmal;
/**
* Initialize available packckages, items, and directory list.
* @param pool shared string pool with base, dir and dependency names
* @param delta no. of entries to add on each realloc
* @param tsflags transaction control flags
* @param tscolor transaction color bits
* @param prefcolor preferred color
* @return al new available list
*/
RPM_GNUC_INTERNAL
rpmal rpmalCreate(rpmstrPool pool, int delta, rpmtransFlags tsflags,
rpm_color_t tscolor, rpm_color_t prefcolor);
/**
* Free available packages, items, and directory members.
* @param al available list
* @return NULL always
*/
RPM_GNUC_INTERNAL
rpmal rpmalFree(rpmal al);
/**
* Delete package from available list.
* @param al available list
* @param p package
*/
RPM_GNUC_INTERNAL
void rpmalDel(rpmal al, rpmte p);
/**
* Add package to available list.
* @param al available list
* @param p package
*/
RPM_GNUC_INTERNAL
void rpmalAdd(rpmal al, rpmte p);
/**
* Lookup all obsoleters for a dependency in the available list
* @param al available list
* @param ds dependency set
* @return obsoleting packages for ds, NULL if none
*/
RPM_GNUC_INTERNAL
rpmte * rpmalAllObsoletes(const rpmal al, const rpmds ds);
/**
* Lookup all providers for a dependency in the available list
* @param al available list
* @param ds dependency set
* @return best provider for the dependency, NULL if none
*/
RPM_GNUC_INTERNAL
rpmte * rpmalAllSatisfiesDepend(const rpmal al, const rpmds ds);
/**
* Lookup best provider for a dependency in the available list
* @param al available list
* @param te transaction element
* @param ds dependency set
* @return best provider for the dependency, NULL if none
*/
RPM_GNUC_INTERNAL
rpmte rpmalSatisfiesDepend(const rpmal al, const rpmte te, const rpmds ds);
/**
* Return index of a transaction element in the available list
* @param al available list
* @param te transaction element
* @return index, (unsigned int)-1 if not found
*/
RPM_GNUC_INTERNAL
unsigned int rpmalLookupTE(const rpmal al, const rpmte te);
#ifdef __cplusplus
}
#endif
#endif /* H_RPMAL */