/* * Copyright (C) 2008 Kristian Høgsberg * Copyright (C) 2008 Red Hat, Inc * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License along * with this program; if not, write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. */ #ifndef _RAZOR_H_ #define _RAZOR_H_ #define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0])) struct razor_set; struct razor_package; struct razor_property; enum razor_property_type { RAZOR_PROPERTY_REQUIRES, RAZOR_PROPERTY_PROVIDES, RAZOR_PROPERTY_CONFLICTS, RAZOR_PROPERTY_OBSOLETES }; enum razor_version_relation { RAZOR_VERSION_LESS, RAZOR_VERSION_LESS_OR_EQUAL, RAZOR_VERSION_EQUAL, RAZOR_VERSION_GREATER_OR_EQUAL, RAZOR_VERSION_GREATER }; extern const char * const razor_version_relations[]; struct razor_set *razor_set_create(void); struct razor_set *razor_set_open(const char *filename); void razor_set_destroy(struct razor_set *set); int razor_set_write_to_fd(struct razor_set *set, int fd); int razor_set_write(struct razor_set *set, const char *filename); struct razor_package * razor_set_get_package(struct razor_set *set, const char *package); struct razor_package_iterator; struct razor_package_iterator * razor_package_iterator_create(struct razor_set *set); struct razor_package_iterator * razor_package_iterator_create_for_property(struct razor_set *set, struct razor_property *property); struct razor_package_iterator * razor_package_iterator_create_for_file(struct razor_set *set, const char *filename); int razor_package_iterator_next(struct razor_package_iterator *pi, struct razor_package **package, const char **name, const char **version, const char **arch); void razor_package_iterator_destroy(struct razor_package_iterator *pi); struct razor_package_query * razor_package_query_create(struct razor_set *set); void razor_package_query_add_package(struct razor_package_query *pq, struct razor_package *p); void razor_package_query_add_iterator(struct razor_package_query *pq, struct razor_package_iterator *pi); struct razor_package_iterator * razor_package_query_finish(struct razor_package_query *pq); struct razor_property_iterator; struct razor_property_iterator * razor_property_iterator_create(struct razor_set *set, struct razor_package *package); int razor_property_iterator_next(struct razor_property_iterator *pi, struct razor_property **property, const char **name, enum razor_version_relation *relation, const char **version, enum razor_property_type *type); void razor_property_iterator_destroy(struct razor_property_iterator *pi); void razor_set_list_files(struct razor_set *set, const char *prefix); void razor_set_list_package_files(struct razor_set *set, const char *name); void razor_set_list_unsatisfied(struct razor_set *set); typedef void (*razor_package_callback_t)(const char *name, const char *old_version, const char *new_version, const char *arch, void *data); void razor_set_diff(struct razor_set *set, struct razor_set *upstream, razor_package_callback_t callback, void *data); /* Package transactions */ struct razor_transaction * razor_transaction_create(struct razor_set *system, struct razor_set *upstream); void razor_transaction_install_package(struct razor_transaction *transaction, struct razor_package *package); void razor_transaction_remove_package(struct razor_transaction *transaction, struct razor_package *package); void razor_transaction_update_package(struct razor_transaction *trans, struct razor_package *package); void razor_transaction_update_all(struct razor_transaction *transaction); int razor_transaction_resolve(struct razor_transaction *trans); int razor_transaction_describe(struct razor_transaction *trans); struct razor_set *razor_transaction_finish(struct razor_transaction *trans); void razor_transaction_destroy(struct razor_transaction *trans); /* Temporary helper for test suite. */ int razor_transaction_unsatisfied_property(struct razor_transaction *trans, const char *name, enum razor_version_relation rel, const char *version, enum razor_property_type type); /* Importer interface; for building a razor set from external sources, * like yum, rpmdb or razor package files. */ struct razor_importer; struct razor_rpm; struct razor_importer *razor_importer_new(void); void razor_importer_destroy(struct razor_importer *importer); void razor_importer_begin_package(struct razor_importer *importer, const char *name, const char *version, const char *arch); void razor_importer_add_property(struct razor_importer *importer, const char *name, enum razor_version_relation relation, const char *version, enum razor_property_type type); void razor_importer_add_file(struct razor_importer *importer, const char *name); void razor_importer_finish_package(struct razor_importer *importer); int razor_importer_add_rpm(struct razor_importer *importer, struct razor_rpm *rpm); struct razor_set *razor_importer_finish(struct razor_importer *importer); void razor_build_evr(char *evr_buf, int size, const char *epoch, const char *version, const char *release); struct razor_set *razor_set_create_from_yum(void); struct razor_set *razor_set_create_from_rpmdb(void); /* RPM functions */ struct razor_rpm *razor_rpm_open(const char *filename); int razor_rpm_install(struct razor_rpm *rpm, const char *root); int razor_rpm_close(struct razor_rpm *rpm); /* Razor root functions. The root data struct encapsulates filesystem * conventions and the locking protocol. */ struct razor_root; #define RAZOR_ROOT_OPEN_WRITE 0x01 int razor_root_create(const char *root); struct razor_root *razor_root_open(const char *root, int flags); struct razor_set *razor_root_open_read_only(const char *root); struct razor_transaction * razor_root_create_transaction(struct razor_root *image, struct razor_set *upstream); int razor_root_close(struct razor_root *image); void razor_root_update(struct razor_root *image, struct razor_set *next); int razor_root_commit(struct razor_root *image); void razor_root_diff(struct razor_root *root, razor_package_callback_t callback, void *data); #endif /* _RAZOR_H_ */